agent:session
agent:session
Section titled “agent:session”Start agent session
Options:
| Flag | Description | Required |
|---|---|---|
--renew <sessionId> | Renew a WU-less role session heartbeat, extending its lease freshness (no other flags needed) | No |
--role-lane <lane> | Ownership-scope lane for a WU-less role session | No |
--initiative <id> | Ownership-scope initiative id for a WU-less role session (e.g. an orchestrator) | No |
--agent-identity <identity> | Explicit stable A2A identity for receipts; format hint: <owner>:<role>:<purpose> | No |
--delegation-id <id> | Parent delegation registry reference (dlg-XXXX) to cross-link this session with delegation:list output | No |
--specialty-profile <profile> | specialty_profile for this session (e.g. delivery, test, general) | No |
--lifecycle-role <role> | lifecycle_role for this session (e.g. orchestrator, executor, reviewer, finisher) | No |
--tls-fingerprint <fingerprint> | Optional TLS fingerprint for the reachable host | No |
--health-endpoint <url> | Optional health endpoint for agent host discovery | No |
--reachability-class <class> | Reachability class (reverse-tunnel, public, lan, unreachable) | No |
--reachable-http-url <url> | Reachable HTTP URL for inbound tool dispatch (overrides env-based detection) | No |
--agent-type <type> | Agent/client identifier associated with this session | No |
--resume | Rotate this WU’s existing session after same-user claim verification | No |
--tier <tier> | Context tier (1, 2, or 3) | Yes |
--wu <id> | WU ID to work on | Yes |