@agent-compose/sdk 0.8.4 → 0.8.5

package/src/generated/verb-synopsis.ts

@@ -0,0 +1,544 @@
+/**
+ * GENERATED FILE — DO NOT EDIT.
+ *
+ * Regenerate with `cd cli && bun run generate:verbs` (the CLI build chains
+ * it). Source of truth: the commander registry in `cli/src/program.ts`.
+ * Generator: `cli/scripts/generate-verb-synopsis.ts`.
+ *
+ * This is the complete list of `agentc` verbs, shipped verbatim into every
+ * agent-facing context — the cloud-session system prompt
+ * (server/src/agent/cloud-executor.ts) and the in-sandbox platform manual
+ * (sdk/src/agent/agent-context.ts). It exists because a hand-maintained
+ * subset drifted: an agent told its owner the CLI "has no cancel verb"
+ * while `agentc cancel` had shipped long before. A lockstep test
+ * (cli/src/__tests__/verb-synopsis.test.ts) fails the build if a registered
+ * command is missing here, so the drift cannot recur.
+ */
+
+/** One top-level verb, one subcommand level deep. `args` is a leaf verb's
+ *  typed shape (positional args + mandatory options); subcommand entries
+ *  carry their own signatures inline. */
+export interface AgentcVerbEntry {
+  name: string;
+  aliases: readonly string[];
+  args: string;
+  description: string;
+  subcommands: readonly string[];
+}
+
+/** Every registered top-level verb, sorted by name. */
+export const AGENTC_VERBS: readonly AgentcVerbEntry[] = [
+  {
+    "name": "auth",
+    "aliases": [],
+    "args": "",
+    "description": "Manage authentication",
+    "subcommands": [
+      "login <key>",
+      "logout",
+      "status"
+    ]
+  },
+  {
+    "name": "branch",
+    "aliases": [],
+    "args": "",
+    "description": "Session drive branches: claim/release write authority, rebase on main",
+    "subcommands": [
+      "claim <target>",
+      "rebase [target]",
+      "release [target]",
+      "status"
+    ]
+  },
+  {
+    "name": "bridge",
+    "aliases": [],
+    "args": "",
+    "description": "Connect a local coding agent (Claude Code / OpenCode) to…",
+    "subcommands": [
+      "login --agent <kind>",
+      "status",
+      "logout"
+    ]
+  },
+  {
+    "name": "calendar",
+    "aliases": [],
+    "args": "",
+    "description": "Check your owner's calendar",
+    "subcommands": []
+  },
+  {
+    "name": "cancel",
+    "aliases": [],
+    "args": "<run-id>",
+    "description": "Cancel an in-progress run",
+    "subcommands": []
+  },
+  {
+    "name": "compliance",
+    "aliases": [],
+    "args": "",
+    "description": "Break-glass compliance sessions",
+    "subcommands": [
+      "request --scope <kind> --reason <text> --ttl <duration>",
+      "approve <session-id>",
+      "revoke <session-id>",
+      "list",
+      "accesses <session-id>"
+    ]
+  },
+  {
+    "name": "connect",
+    "aliases": [],
+    "args": "",
+    "description": "Connect this machine: sign in if needed (one browser approval),…",
+    "subcommands": []
+  },
+  {
+    "name": "conv",
+    "aliases": [],
+    "args": "",
+    "description": "List and read conversations",
+    "subcommands": [
+      "list",
+      "read <conversationId>",
+      "post <channelId> [text]",
+      "members <conversationId>",
+      "invite <conversationId> <users...>",
+      "role"
+    ]
+  },
+  {
+    "name": "display",
+    "aliases": [],
+    "args": "",
+    "description": "Render a rich card into the conversation transcript",
+    "subcommands": [
+      "run <runId>",
+      "changes <runId>",
+      "document <drive-path>",
+      "plan --entries <json>",
+      "image <drive-path>",
+      "desktop",
+      "preview <drive-path>",
+      "table",
+      "chart --data <json> --kind <kind>",
+      "diff <drive-path> --from <rev> --to <rev>",
+      "ask --prompt <text>"
+    ]
+  },
+  {
+    "name": "events",
+    "aliases": [],
+    "args": "",
+    "description": "Send or list run events",
+    "subcommands": [
+      "send <run-id> <name>",
+      "list [run-id]"
+    ]
+  },
+  {
+    "name": "factory",
+    "aliases": [],
+    "args": "",
+    "description": "Manage factories",
+    "subcommands": [
+      "list",
+      "create <slug>",
+      "use <slug>",
+      "delete <slug>",
+      "show"
+    ]
+  },
+  {
+    "name": "files",
+    "aliases": [],
+    "args": "",
+    "description": "Read/write documents on a factory's drive",
+    "subcommands": [
+      "conflicts",
+      "mount [dir]",
+      "unmount",
+      "mounts",
+      "merge",
+      "flush",
+      "put <local-file> <drive-path>",
+      "ls [prefix]",
+      "read <drive-path>",
+      "write <drive-path>",
+      "pull <drive-path>",
+      "get <drive-path>"
+    ]
+  },
+  {
+    "name": "import",
+    "aliases": [],
+    "args": "",
+    "description": "Move a local Claude Code session into Agent Compose: history,…",
+    "subcommands": []
+  },
+  {
+    "name": "init",
+    "aliases": [],
+    "args": "",
+    "description": "Install agentc skills",
+    "subcommands": []
+  },
+  {
+    "name": "invoke",
+    "aliases": [],
+    "args": "[template]",
+    "description": "Invoke a registered workflow template or a platform default",
+    "subcommands": []
+  },
+  {
+    "name": "keys",
+    "aliases": [],
+    "args": "",
+    "description": "Manage API keys",
+    "subcommands": [
+      "create <name>",
+      "list"
+    ]
+  },
+  {
+    "name": "list",
+    "aliases": [],
+    "args": "",
+    "description": "List workflow templates you can invoke",
+    "subcommands": []
+  },
+  {
+    "name": "login",
+    "aliases": [],
+    "args": "",
+    "description": "Log in via your browser",
+    "subcommands": []
+  },
+  {
+    "name": "logout",
+    "aliases": [],
+    "args": "",
+    "description": "Clear this machine's browser-login credentials",
+    "subcommands": []
+  },
+  {
+    "name": "logs",
+    "aliases": [],
+    "args": "<run-id>",
+    "description": "Stream logs for a run",
+    "subcommands": []
+  },
+  {
+    "name": "machine",
+    "aliases": [],
+    "args": "",
+    "description": "Resize this session's machine",
+    "subcommands": [
+      "upsize"
+    ]
+  },
+  {
+    "name": "mail",
+    "aliases": [],
+    "args": "",
+    "description": "Check your owner's email",
+    "subcommands": [
+      "search [query...]",
+      "read <message-id>"
+    ]
+  },
+  {
+    "name": "members",
+    "aliases": [],
+    "args": "",
+    "description": "List teammates and flag them for attention",
+    "subcommands": [
+      "list",
+      "notify --user <id-or-email> --text <message>"
+    ]
+  },
+  {
+    "name": "merge",
+    "aliases": [],
+    "args": "",
+    "description": "Merge THIS session's own drive branch into the shared drive's…",
+    "subcommands": []
+  },
+  {
+    "name": "navigate",
+    "aliases": [],
+    "args": "<path>",
+    "description": "Take the user's dashboard to a page",
+    "subcommands": []
+  },
+  {
+    "name": "notify",
+    "aliases": [],
+    "args": "[need...]",
+    "description": "Push a non-blocking need OR FINDING to your owner's queue…",
+    "subcommands": []
+  },
+  {
+    "name": "pause",
+    "aliases": [],
+    "args": "--reason <text>",
+    "description": "Ask the human a question and block until they answer",
+    "subcommands": []
+  },
+  {
+    "name": "preview",
+    "aliases": [],
+    "args": "",
+    "description": "Expose a dev-server port on a hosted, member-gated URL",
+    "subcommands": [
+      "open|announce <port>",
+      "list",
+      "close <port>"
+    ]
+  },
+  {
+    "name": "project",
+    "aliases": [],
+    "args": "",
+    "description": "Create and manage projects",
+    "subcommands": [
+      "create <name>",
+      "list",
+      "show <ref>",
+      "delete <ref>",
+      "members <ref>",
+      "invite <ref>",
+      "role",
+      "remove-member <ref> <user>",
+      "leave <ref>",
+      "objects <ref>",
+      "add <ref> <objectRef>",
+      "refresh <ref> <sessionRef>",
+      "remove <ref> <objectRef>"
+    ]
+  },
+  {
+    "name": "register",
+    "aliases": [],
+    "args": "<workflow>",
+    "description": "Register a workflow with the server",
+    "subcommands": []
+  },
+  {
+    "name": "repos",
+    "aliases": [],
+    "args": "",
+    "description": "Link factory-drive directories to GitHub repositories",
+    "subcommands": [
+      "link <repoFullName> --prefix <dir>",
+      "links",
+      "unlink <linkId>",
+      "clone <link>",
+      "restore",
+      "setup",
+      "gh-token [link]",
+      "git-credential [op]",
+      "mirror <link>"
+    ]
+  },
+  {
+    "name": "review",
+    "aliases": [],
+    "args": "",
+    "description": "In-sandbox toolbelt for a spawned diff-review session",
+    "subcommands": [
+      "findings",
+      "publish --notes <file>",
+      "git-credential <action>",
+      "changes",
+      "file <path>"
+    ]
+  },
+  {
+    "name": "run",
+    "aliases": [],
+    "args": "",
+    "description": "Dispatch workflows and check run status",
+    "subcommands": [
+      "dispatch <templateName> --input <json>",
+      "get <runId>",
+      "watch <runId>",
+      "list",
+      "artifacts <runId> [path]",
+      "latest"
+    ]
+  },
+  {
+    "name": "schedule",
+    "aliases": [],
+    "args": "",
+    "description": "Manage cron schedules attached to registered workflows",
+    "subcommands": [
+      "create <name> --workflow <name> --cron <expr>",
+      "list",
+      "delete <id>"
+    ]
+  },
+  {
+    "name": "search",
+    "aliases": [],
+    "args": "<query>",
+    "description": "Search factory files",
+    "subcommands": []
+  },
+  {
+    "name": "secrets",
+    "aliases": [],
+    "args": "",
+    "description": "Manage secrets",
+    "subcommands": [
+      "set <workflow> <key> <value>",
+      "list <workflow>",
+      "delete <workflow> <key>",
+      "factory",
+      "session"
+    ]
+  },
+  {
+    "name": "services",
+    "aliases": [],
+    "args": "",
+    "description": "Durable services manifest",
+    "subcommands": [
+      "list",
+      "add <name> --command <cmd>",
+      "remove <name>",
+      "restore [names...]"
+    ]
+  },
+  {
+    "name": "session",
+    "aliases": [
+      "chat"
+    ],
+    "args": "",
+    "description": "Interactive terminal chat on a conversation",
+    "subcommands": [
+      "login",
+      "logout",
+      "add",
+      "import",
+      "resume <conversationId>",
+      "terminal <conversationId>",
+      "fork [conversationId]",
+      "share <conversationId>",
+      "unshare <conversationId>",
+      "attach <channelId> [conversationId]",
+      "detach <channelId> [conversationId]",
+      "share-file <conversationId> <path>",
+      "unshare-file <conversationId> <path>",
+      "message <target> [text]"
+    ]
+  },
+  {
+    "name": "setup",
+    "aliases": [],
+    "args": "",
+    "description": "Set this machine up so any agent on it can…",
+    "subcommands": []
+  },
+  {
+    "name": "share",
+    "aliases": [],
+    "args": "<ref>",
+    "description": "Share a drive document or a workflow template",
+    "subcommands": []
+  },
+  {
+    "name": "skills",
+    "aliases": [],
+    "args": "",
+    "description": "Bring your own skills: import local Claude Code skills into…",
+    "subcommands": [
+      "import",
+      "list",
+      "show <name>",
+      "adopt <name>",
+      "rm <name>",
+      "share <name>",
+      "unshare <name>"
+    ]
+  },
+  {
+    "name": "snapshot",
+    "aliases": [],
+    "args": "",
+    "description": "Manage captured sandbox snapshots",
+    "subcommands": [
+      "list",
+      "delete <run-id> [snapshot-id]",
+      "show <run-id>"
+    ]
+  },
+  {
+    "name": "takeover",
+    "aliases": [],
+    "args": "",
+    "description": "Offer the human this desktop",
+    "subcommands": []
+  },
+  {
+    "name": "thread",
+    "aliases": [],
+    "args": "",
+    "description": "Read this session's thread queue on your owner's board",
+    "subcommands": [
+      "progress [note...]"
+    ]
+  },
+  {
+    "name": "upgrade",
+    "aliases": [],
+    "args": "",
+    "description": "Update the agentc CLI to the latest published version",
+    "subcommands": []
+  },
+  {
+    "name": "usage",
+    "aliases": [],
+    "args": "",
+    "description": "Show billable usage",
+    "subcommands": []
+  },
+  {
+    "name": "watch",
+    "aliases": [],
+    "args": "",
+    "description": "Connect the claude-code session already running in this directory to…",
+    "subcommands": []
+  },
+  {
+    "name": "web",
+    "aliases": [],
+    "args": "<query...>",
+    "description": "Search the web",
+    "subcommands": []
+  },
+  {
+    "name": "work",
+    "aliases": [],
+    "args": "",
+    "description": "Hold or release this session's background-work busy lease",
+    "subcommands": [
+      "hold",
+      "watch --cmd <shell>",
+      "release"
+    ]
+  }
+] as const;
+
+/** The rendered block: title, one framing line, then one line per verb.
+ *  Ships verbatim in the server's cloud-session system prompt. */
+export const AGENTC_VERB_SYNOPSIS = "agentc verbs — the complete list:\nGenerated from the CLI's own registry — if a verb is listed here it EXISTS on your PATH; run `agentc <verb> --help` for its flags, and never tell anyone a capability is missing without checking this list first.\n- agentc auth login <key>, logout, status — Manage authentication\n- agentc branch claim <target>, rebase [target], release [target], status — Session drive branches: claim/release write authority, rebase on main\n- agentc bridge login --agent <kind>, status, logout — Connect a local coding agent (Claude Code / OpenCode) to…\n- agentc calendar — Check your owner's calendar\n- agentc cancel <run-id> — Cancel an in-progress run\n- agentc compliance request --scope <kind> --reason <text> --ttl <duration>, approve <session-id>, revoke <session-id>, list, accesses <session-id> — Break-glass compliance sessions\n- agentc connect — Connect this machine: sign in if needed (one browser approval),…\n- agentc conv list, read <conversationId>, post <channelId> [text], members <conversationId>, invite <conversationId> <users...>, role — List and read conversations\n- agentc display run <runId>, changes <runId>, document <drive-path>, plan --entries <json>, image <drive-path>, desktop, preview <drive-path>, table, chart --data <json> --kind <kind>, diff <drive-path> --from <rev> --to <rev>, ask --prompt <text> — Render a rich card into the conversation transcript\n- agentc events send <run-id> <name>, list [run-id] — Send or list run events\n- agentc factory list, create <slug>, use <slug>, delete <slug>, show — Manage factories\n- agentc files conflicts, mount [dir], unmount, mounts, merge, flush, put <local-file> <drive-path>, ls [prefix], read <drive-path>, write <drive-path>, pull <drive-path>, get <drive-path> — Read/write documents on a factory's drive\n- agentc import — Move a local Claude Code session into Agent Compose: history,…\n- agentc init — Install agentc skills\n- agentc invoke [template] — Invoke a registered workflow template or a platform default\n- agentc keys create <name>, list — Manage API keys\n- agentc list — List workflow templates you can invoke\n- agentc login — Log in via your browser\n- agentc logout — Clear this machine's browser-login credentials\n- agentc logs <run-id> — Stream logs for a run\n- agentc machine upsize — Resize this session's machine\n- agentc mail search [query...], read <message-id> — Check your owner's email\n- agentc members list, notify --user <id-or-email> --text <message> — List teammates and flag them for attention\n- agentc merge — Merge THIS session's own drive branch into the shared drive's…\n- agentc navigate <path> — Take the user's dashboard to a page\n- agentc notify [need...] — Push a non-blocking need OR FINDING to your owner's queue…\n- agentc pause --reason <text> — Ask the human a question and block until they answer\n- agentc preview open|announce <port>, list, close <port> — Expose a dev-server port on a hosted, member-gated URL\n- agentc project create <name>, list, show <ref>, delete <ref>, members <ref>, invite <ref>, role, remove-member <ref> <user>, leave <ref>, objects <ref>, add <ref> <objectRef>, refresh <ref> <sessionRef>, remove <ref> <objectRef> — Create and manage projects\n- agentc register <workflow> — Register a workflow with the server\n- agentc repos link <repoFullName> --prefix <dir>, links, unlink <linkId>, clone <link>, restore, setup, gh-token [link], git-credential [op], mirror <link> — Link factory-drive directories to GitHub repositories\n- agentc review findings, publish --notes <file>, git-credential <action>, changes, file <path> — In-sandbox toolbelt for a spawned diff-review session\n- agentc run dispatch <templateName> --input <json>, get <runId>, watch <runId>, list, artifacts <runId> [path], latest — Dispatch workflows and check run status\n- agentc schedule create <name> --workflow <name> --cron <expr>, list, delete <id> — Manage cron schedules attached to registered workflows\n- agentc search <query> — Search factory files\n- agentc secrets set <workflow> <key> <value>, list <workflow>, delete <workflow> <key>, factory, session — Manage secrets\n- agentc services list, add <name> --command <cmd>, remove <name>, restore [names...] — Durable services manifest\n- agentc session|chat login, logout, add, import, resume <conversationId>, terminal <conversationId>, fork [conversationId], share <conversationId>, unshare <conversationId>, attach <channelId> [conversationId], detach <channelId> [conversationId], share-file <conversationId> <path>, unshare-file <conversationId> <path>, message <target> [text] — Interactive terminal chat on a conversation\n- agentc setup — Set this machine up so any agent on it can…\n- agentc share <ref> — Share a drive document or a workflow template\n- agentc skills import, list, show <name>, adopt <name>, rm <name>, share <name>, unshare <name> — Bring your own skills: import local Claude Code skills into…\n- agentc snapshot list, delete <run-id> [snapshot-id], show <run-id> — Manage captured sandbox snapshots\n- agentc takeover — Offer the human this desktop\n- agentc thread progress [note...] — Read this session's thread queue on your owner's board\n- agentc upgrade — Update the agentc CLI to the latest published version\n- agentc usage — Show billable usage\n- agentc watch — Connect the claude-code session already running in this directory to…\n- agentc web <query...> — Search the web\n- agentc work hold, watch --cmd <shell>, release — Hold or release this session's background-work busy lease";
+
+/** The same block as a markdown `##` section — ships verbatim inside the
+ *  in-sandbox platform manual (`AGENT_COMPOSE_MANUAL`). Same verb lines. */
+export const AGENTC_VERB_SYNOPSIS_MD = "## agentc verbs — the complete list\n\nGenerated from the CLI's own registry — if a verb is listed here it EXISTS on your PATH; run `agentc <verb> --help` for its flags, and never tell anyone a capability is missing without checking this list first.\n\n- agentc auth login <key>, logout, status — Manage authentication\n- agentc branch claim <target>, rebase [target], release [target], status — Session drive branches: claim/release write authority, rebase on main\n- agentc bridge login --agent <kind>, status, logout — Connect a local coding agent (Claude Code / OpenCode) to…\n- agentc calendar — Check your owner's calendar\n- agentc cancel <run-id> — Cancel an in-progress run\n- agentc compliance request --scope <kind> --reason <text> --ttl <duration>, approve <session-id>, revoke <session-id>, list, accesses <session-id> — Break-glass compliance sessions\n- agentc connect — Connect this machine: sign in if needed (one browser approval),…\n- agentc conv list, read <conversationId>, post <channelId> [text], members <conversationId>, invite <conversationId> <users...>, role — List and read conversations\n- agentc display run <runId>, changes <runId>, document <drive-path>, plan --entries <json>, image <drive-path>, desktop, preview <drive-path>, table, chart --data <json> --kind <kind>, diff <drive-path> --from <rev> --to <rev>, ask --prompt <text> — Render a rich card into the conversation transcript\n- agentc events send <run-id> <name>, list [run-id] — Send or list run events\n- agentc factory list, create <slug>, use <slug>, delete <slug>, show — Manage factories\n- agentc files conflicts, mount [dir], unmount, mounts, merge, flush, put <local-file> <drive-path>, ls [prefix], read <drive-path>, write <drive-path>, pull <drive-path>, get <drive-path> — Read/write documents on a factory's drive\n- agentc import — Move a local Claude Code session into Agent Compose: history,…\n- agentc init — Install agentc skills\n- agentc invoke [template] — Invoke a registered workflow template or a platform default\n- agentc keys create <name>, list — Manage API keys\n- agentc list — List workflow templates you can invoke\n- agentc login — Log in via your browser\n- agentc logout — Clear this machine's browser-login credentials\n- agentc logs <run-id> — Stream logs for a run\n- agentc machine upsize — Resize this session's machine\n- agentc mail search [query...], read <message-id> — Check your owner's email\n- agentc members list, notify --user <id-or-email> --text <message> — List teammates and flag them for attention\n- agentc merge — Merge THIS session's own drive branch into the shared drive's…\n- agentc navigate <path> — Take the user's dashboard to a page\n- agentc notify [need...] — Push a non-blocking need OR FINDING to your owner's queue…\n- agentc pause --reason <text> — Ask the human a question and block until they answer\n- agentc preview open|announce <port>, list, close <port> — Expose a dev-server port on a hosted, member-gated URL\n- agentc project create <name>, list, show <ref>, delete <ref>, members <ref>, invite <ref>, role, remove-member <ref> <user>, leave <ref>, objects <ref>, add <ref> <objectRef>, refresh <ref> <sessionRef>, remove <ref> <objectRef> — Create and manage projects\n- agentc register <workflow> — Register a workflow with the server\n- agentc repos link <repoFullName> --prefix <dir>, links, unlink <linkId>, clone <link>, restore, setup, gh-token [link], git-credential [op], mirror <link> — Link factory-drive directories to GitHub repositories\n- agentc review findings, publish --notes <file>, git-credential <action>, changes, file <path> — In-sandbox toolbelt for a spawned diff-review session\n- agentc run dispatch <templateName> --input <json>, get <runId>, watch <runId>, list, artifacts <runId> [path], latest — Dispatch workflows and check run status\n- agentc schedule create <name> --workflow <name> --cron <expr>, list, delete <id> — Manage cron schedules attached to registered workflows\n- agentc search <query> — Search factory files\n- agentc secrets set <workflow> <key> <value>, list <workflow>, delete <workflow> <key>, factory, session — Manage secrets\n- agentc services list, add <name> --command <cmd>, remove <name>, restore [names...] — Durable services manifest\n- agentc session|chat login, logout, add, import, resume <conversationId>, terminal <conversationId>, fork [conversationId], share <conversationId>, unshare <conversationId>, attach <channelId> [conversationId], detach <channelId> [conversationId], share-file <conversationId> <path>, unshare-file <conversationId> <path>, message <target> [text] — Interactive terminal chat on a conversation\n- agentc setup — Set this machine up so any agent on it can…\n- agentc share <ref> — Share a drive document or a workflow template\n- agentc skills import, list, show <name>, adopt <name>, rm <name>, share <name>, unshare <name> — Bring your own skills: import local Claude Code skills into…\n- agentc snapshot list, delete <run-id> [snapshot-id], show <run-id> — Manage captured sandbox snapshots\n- agentc takeover — Offer the human this desktop\n- agentc thread progress [note...] — Read this session's thread queue on your owner's board\n- agentc upgrade — Update the agentc CLI to the latest published version\n- agentc usage — Show billable usage\n- agentc watch — Connect the claude-code session already running in this directory to…\n- agentc web <query...> — Search the web\n- agentc work hold, watch --cmd <shell>, release — Hold or release this session's background-work busy lease";

package/src/index.ts

@@ -101,7 +101,11 @@ export type {
   AgentMessageError,
   AgentMessageUsage,
   AgentMessageTaskNotification,
+  AgentMessageTaskProgress,
+  WorkflowProgressEntry,
   AgentMessageHarnessNotice,
+  AgentMessageCompaction,
+  AgentMessageSubagentUserMessage,
   AgentStatus,
 } from "./types/protocol.js";
 
@@ -121,7 +125,7 @@ export type {
   InlineWorkflowPayload, InvokeInlineOptions, InvokeInlineAndWaitOptions,
   ListSnapshotsOptions, TemplateRow, ListTemplatesOptions,
   CreateFactoryInput, UpdateFactoryInput,
-  SecretOptions, SetSecretResult, SecretListEntry, SessionSecretEntry, SessionSecretInput, SessionSecretRequestCreated, SessionSecretRequestStatus,
+  SecretOptions, SetSecretResult, SecretListEntry, SessionSecretEntry, SessionSecretInput, SessionSecretRequestCreated, SessionSecretRequestStatus, SessionSecretRequestSummary, VaultRequestKind, VaultCatalogEntry,
   CreateApiKeyInput, StreamRunLogsOptions,
   TeamMember, Mention, CreateMentionsInput,
   EventSubjectType, EventRow, ReportEventInput, ListEventsOptions, ListEventsResult,
@@ -138,6 +142,7 @@ export type {
   AnswerSteerOptions,
   ResumePauseOptions, ResumePauseResponse, ResumePauseSuccess, ResumePausePending, ResumePauseActor,
   ConversationMessagePart, ConversationRow, ConversationMessageRow,
+  CreateChatInput, ChannelIvyState, ProjectIvyConnection,
   ConversationsPage, ConversationDetail, ConversationThread,
   ConversationPageContext, SendConversationMessageInput, SendConversationMessageResult,
   UnnotifiedMention,
@@ -145,6 +150,7 @@ export type {
   CreateCloudSessionInput, CloudSessionCreated,
   // Cloud-session developer surface (ADR-0052)
   SessionPreview, PreviewOpened, OpenPreviewInput, SessionForked, BackgroundWorkHeld,
+  BackgroundWorkChildDecl, BackgroundWorkStatus,
   // Session branch proposals (ADR-0053)
   SessionFileChange, SessionChangeSet, SessionChangeStats, SessionDiffReviewBound, ReviewSuggestion,
   ReviewSuggestionInput, ReviewNotesPublished, ReviewGitCredential, SessionReviewDocument,
@@ -161,7 +167,7 @@ export type {
   SessionPerfBucket, SessionPerfHistoryPage, FactoryPerfSummary,
   FactoryFileSearchRow, FactoryFolderSearchRow, SearchFactoryFilesOptions, FactoryFileSearchResult, PublicFileLinkState,
   // Drive file listing (live + browse-at-head)
-  FactoryFileListRow, ListFactoryFilesOptions, FactoryFileListPage,
+  FactoryFileListRow, ListFactoryFilesOptions, FactoryFileListPage, FactoryFileConflict, FactoryFileConflictList, ProjectSecretMeta, ProjectSecretList,
   // Membership-scoped authorization (ADR-0045)
   ConversationMemberRole, ConversationMember,
   DocumentCapability, TemplateCapability, ScopeGrant, ArtifactScope,
@@ -188,7 +194,7 @@ export {
   REVISION_SELECTOR_RE,
   ASK_DIRECTIVE_PROMPT_MAX, ASK_DIRECTIVE_MAX_OPTIONS,
   ASK_DIRECTIVE_OPTION_ID_MAX, ASK_DIRECTIVE_OPTION_LABEL_MAX,
-  ASK_APPROVER_MIN, ASK_APPROVER_MAX,
+  ASK_APPROVER_MIN, ASK_APPROVER_MAX, TAKEOVER_NOTE_MAX_CHARS,
 } from "./directives.js";
 export type { CloudDirective } from "./directives.js";
 
@@ -318,6 +324,7 @@ export type { RunEvent } from "./types/events.js";
 // Sandbox providers
 export { createSandbox, reconnectSandbox, killAllSandboxes, killSandboxById,
   getSandboxQuotas, listOwnedSandboxes, deleteSandboxSnapshot, snapshotResolves,
+  isSandboxSourceNotFoundError,
   makeSandboxProvider, makeDesktopSandboxProvider,
   parseSseExecStream, AGENT_COMPOSE_TAG,
   SANDBOX_SIZES, SANDBOX_MACHINES, SANDBOX_VCPUS, DEFAULT_SANDBOX_SIZE, SESSION_DEFAULT_SANDBOX_SIZE,
@@ -427,6 +434,13 @@ export { agent } from "./agent/run-agent.js";
 export type { AgentOpts } from "./agent/run-agent.js";
 export { AGENT_COMPOSE_MANUAL, buildAgentContextDoc, writeAgentContext, buildAddedSessionBrief } from "./agent/agent-context.js";
 export type { AgentConnectorInfo, AddedSessionBriefParams } from "./agent/agent-context.js";
+// The complete `agentc` verb list, GENERATED from the CLI's commander
+// registry (cli/scripts/generate-verb-synopsis.ts) and checked in. Both
+// agent-facing contexts ship it verbatim — the in-sandbox manual above and
+// the server's cloud-session prompt — so a verb can never drift out of what
+// agents believe the CLI can do. Never hand-edit the generated module.
+export { AGENTC_VERBS, AGENTC_VERB_SYNOPSIS, AGENTC_VERB_SYNOPSIS_MD } from "./generated/verb-synopsis.js";
+export type { AgentcVerbEntry } from "./generated/verb-synopsis.js";
 export {
   AC_OPEN_PATH, AC_OPEN_STATE_DIR, AC_OPEN_SHIM_PATHS, AC_OPEN_SCRIPT, AC_OPEN_SHIM,
   installDesktopOpenCmd,