@agent-compose/sdk 0.8.4 → 0.8.6

package/src/directives.ts

@@ -61,7 +61,15 @@ export type CloudDirective =
   /** Interactive question card gated on a named approver — resolution and
    *  the mentions ping are server-authoritative (`display_ask` shape). The
    *  one write-bearing directive (see the module header). */
-  | { kind: "ask"; prompt: string; approver: string; options?: Array<{ id: string; label: string }> };
+  | { kind: "ask"; prompt: string; approver: string; options?: Array<{ id: string; label: string }> }
+  /** Offer the human the desktop takeover door (`show_computer` handing the
+   *  screen over): the server captures the current screen and posts a card
+   *  with a signed takeover link — "You can take over from here." Grants nothing
+   *  by itself: the link's viewer must still be a signed-in member with
+   *  write access to THIS session (the server re-checks on every resolve).
+   *  ONLY for structurally-human walls (a CAPTCHA, human-only verification)
+   *  or when the user asked to do it themselves. */
+  | { kind: "takeover"; note?: string };
 
 /** `runId` values the run directives accept: a UUID, or the literal
  *  `latest` (resolved server-side against the session's factory, optionally
@@ -85,6 +93,10 @@ export const ASK_DIRECTIVE_OPTION_LABEL_MAX = 60;
 export const ASK_APPROVER_MIN = 3;
 export const ASK_APPROVER_MAX = 320;
 
+/** Takeover-note bound — one line naming what the human must do on the
+ *  screen (mirrors the display-desktop caption cap). */
+export const TAKEOVER_NOTE_MAX_CHARS = 200;
+
 function validDirectivePath(v: unknown): string | null {
   return typeof v === "string" && v.length >= 1 && v.length <= DIRECTIVE_PATH_MAX ? v : null;
 }
@@ -152,6 +164,14 @@ function validDirective(value: unknown): CloudDirective | null {
     }
     return { kind: "ask", prompt, approver, ...(options !== undefined ? { options } : {}) };
   }
+  if (d.kind === "takeover") {
+    const note = d.note;
+    if (note !== undefined
+      && (typeof note !== "string" || note.length < 1 || note.length > TAKEOVER_NOTE_MAX_CHARS)) {
+      return null;
+    }
+    return { kind: "takeover", ...(note !== undefined ? { note } : {}) };
+  }
   return null;
 }
 

package/src/display.ts

@@ -681,6 +681,18 @@ function runIdIn(text: string): { runId: string; parsed: Record<string, unknown>
   return m ? { runId: m[1], parsed: null } : null;
 }
 
+/** Every platform tool name `createDisplayPromoter` can put on a promoted
+ *  `tool_call` — the closed set a local bridge daemon may legitimately post
+ *  under a platform-owned name. The server's part-POST door
+ *  (routes/bridge.ts) refuses every other platform tool name from a daemon,
+ *  so a local agent cannot forge an approval, vault or takeover card. Kept
+ *  beside the promoter so the two cannot drift. */
+export const DISPLAY_PROMOTED_TOOL_NAMES: ReadonlySet<string> = new Set([
+  "display_run", "display_changes", "display_document", "display_plan", "display_image",
+  "display_desktop", "display_preview", "display_table", "display_chart", "display_diff",
+  "display_ask", "dispatch_workflow",
+]);
+
 export function createDisplayPromoter(ctx: DisplayPromoterContext = {}): DisplayPromoter {
   const pending = new Map<string, PendingPromotion>();
 

package/src/errors.ts

@@ -7,6 +7,7 @@ export type AuthzErrorCode =
   | "capability_required"
   | "membership_required"
   | "last_owner"
+  | "creator_cannot_leave"
   | "approver_only";
 
 /** Thrown by AgentComposeClient when the server returns a non-2xx response. */

package/src/generated/agentc-commands.ts

@@ -0,0 +1,571 @@
+/**
+ * GENERATED FILE — DO NOT EDIT.
+ *
+ * Regenerate with `cd cli && bun run generate:commands` (the CLI build chains
+ * it). Source of truth: the commander registry in `cli/src/program.ts`.
+ * Generator: `cli/scripts/generate-command-list.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__/command-list.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 AgentcCommand {
+  name: string;
+  aliases: readonly string[];
+  args: string;
+  description: string;
+  subcommands: readonly string[];
+}
+
+/** Every registered top-level verb, sorted by name. */
+export const AGENTC_COMMANDS: readonly AgentcCommand[] = [
+  {
+    "name": "access",
+    "aliases": [],
+    "args": "",
+    "description": "What this session can reach, by scope (workspace, project, personal):…",
+    "subcommands": []
+  },
+  {
+    "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": "consent",
+    "aliases": [],
+    "args": "<id>",
+    "description": "Verify a consent id the platform named",
+    "subcommands": []
+  },
+  {
+    "name": "conv",
+    "aliases": [],
+    "args": "",
+    "description": "List and read conversations",
+    "subcommands": [
+      "list",
+      "read <conversationId>",
+      "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>",
+      "sent <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 need to your owner: `agentc notify \"Want the…",
+    "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>",
+      "create <name>",
+      "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]",
+      "read",
+      "ask [question]",
+      "post [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": "wait",
+    "aliases": [],
+    "args": "",
+    "description": "Declare what this session is waiting for",
+    "subcommands": [
+      "list",
+      "cancel <id>"
+    ]
+  },
+  {
+    "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",
+      "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_COMMAND_LIST = "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 access — What this session can reach, by scope (workspace, project, personal):…\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 consent <id> — Verify a consent id the platform named\n- agentc conv list, read <conversationId>, 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>, sent <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 need to your owner: `agentc notify \"Want the…\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>, create <name>, 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], read, ask [question], post [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 wait list, cancel <id> — Declare what this session is waiting for\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/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_COMMAND_LIST_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 access — What this session can reach, by scope (workspace, project, personal):…\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 consent <id> — Verify a consent id the platform named\n- agentc conv list, read <conversationId>, 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>, sent <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 need to your owner: `agentc notify \"Want the…\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>, create <name>, 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], read, ask [question], post [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 wait list, cancel <id> — Declare what this session is waiting for\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/release — Hold or release this session's background-work busy lease";