@agent-compose/sdk 0.8.5 → 0.8.6

package/src/generated/verb-synopsis.ts

@@ -1,544 +0,0 @@
-/**
- * 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";