@agent-compose/sdk 0.8.5 → 0.8.6

package/src/types/workflow-metadata.ts

@@ -234,10 +234,8 @@ export interface WorkflowMetadata {
    *  BUILD — a setup-only workflow whose job is to leave its VM configured and
    *  snapshot it (base-env / agent-env). Environment builds build a platform
    *  IMAGE and never use the shared factory drive, so the server SKIPS mounting
-   *  /factory for them: a live Archil mount baked into the captured snapshot
-   *  fails the NEXT boot's re-mount ("an older Archil process is still running
-   *  for this mountpoint"), degrading /factory for every workflow booting from
-   *  that snapshot. Absent on ordinary workflows — which mount /factory exactly
+   *  /factory for them and no live drive mount bakes into the captured
+   *  snapshot. Absent on ordinary workflows — which mount /factory exactly
    *  as before. Optional + additive: an ABSENT flag contributes nothing to the
    *  canonical metadata hash (frozen-metadata rule), so existing workflows are
    *  not forced to re-register. */

package/src/types/workflow-plan.ts

@@ -5,9 +5,7 @@
  * dispatch time. The CLI/bundler inspects the bundled module in the user's
  * environment and sends this compact plan as metadata.
  *
- * Every workflow has a step plan. Legacy `defineWorkflow({ run })`
- * workflows are wrapped at the SDK boundary as a single-step compiled
- * workflow (step name = "run"); the bundler sees the same shape regardless.
+ * Every workflow has a step plan.
  */
 
 /** One artifact a step promises to produce — mirrors `StepDeliverable`,

package/src/utils/bundler.ts

@@ -34,7 +34,8 @@
  */
 
 import { createHash } from "node:crypto";
-import { dirname } from "node:path";
+import { realpathSync } from "node:fs";
+import { dirname, join, resolve as resolvePath, sep } from "node:path";
 import { parse as babelParse } from "@babel/parser";
 import type { File, ExportDefaultDeclaration, CallExpression, Expression, Statement } from "@babel/types";
 import { importSourceModule } from "./source-loader.js";
@@ -194,38 +195,107 @@ interface BunPluginBuild {
   ): void;
 }
 
-/** Anchored regex over the alias table — the plugin filter. Specifiers are
- *  literal package names, but escape anyway so a future entry with a `.`
- *  or `+` can't widen the filter. */
+/**
+ * The packages the PLATFORM provides to every workflow source — the SDK and
+ * its zod peer — which therefore resolve from the platform's own install
+ * roots when the source file's directory has no node_modules of its own.
+ * The live incident (2026-09-20, a claude-code session at the drive root):
+ * `agentc invoke --source /factory/files/wf.ts` died with `Could not
+ * resolve "@agent-compose/sdk", "zod"` because Bun walked up from
+ * /factory/files and found nothing, while the baked SDK sat in
+ * /workspace/node_modules the whole time (infra/e2b-template/template.ts —
+ * "SDK into /workspace/node_modules so any script written under /workspace
+ * can import it"). A workflow's OWN third-party deps still have to be
+ * installed beside the source; only these two are platform-resolved.
+ */
+export const PLATFORM_RESOLVED_PACKAGES: readonly string[] = [SDK_PACKAGE, "zod"];
+
+/** Env override for the fallback roots (colon-separated, tried first) — the
+ *  test seam, and an ops knob for a sandbox image that plants the SDK
+ *  elsewhere. */
+export const SDK_FALLBACK_ROOTS_ENV = "AGENT_COMPOSE_SDK_FALLBACK_ROOTS";
+
+/** Where the platform SDK lives when the source's own walk-up finds nothing:
+ *  the env override's roots, the sandbox's baked /workspace install, then
+ *  the bundling process's cwd (the CLI's own resolution context). Exported
+ *  for the unit test. */
+export function sdkFallbackRoots(env: Record<string, string | undefined> = process.env): string[] {
+  const fromEnv = (env[SDK_FALLBACK_ROOTS_ENV] ?? "")
+    .split(":")
+    .map((s) => s.trim())
+    .filter((s) => s.length > 0);
+  const roots = [...fromEnv, "/workspace", process.cwd()];
+  return roots.filter((r, i) => roots.indexOf(r) === i);
+}
+
+/** Anchored regex over the alias table PLUS the platform-resolved packages
+ *  — the plugin filter. Specifiers are literal package names, but escape
+ *  anyway so a future entry with a `.` or `+` can't widen the filter. */
 function aliasFilter(): RegExp {
-  const alternation = SDK_SPECIFIER_ALIASES
+  const alternation = [...SDK_SPECIFIER_ALIASES, ...PLATFORM_RESOLVED_PACKAGES]
     .map((s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"))
     .join("|");
   return new RegExp(`^(?:${alternation})$`);
 }
 
 /**
- * The TOLERATE layer: a Bun resolve plugin that maps every known near-miss
- * specifier onto the real SDK. Resolution goes through Bun's own resolver
- * from the importing file's directory, so the alias lands on exactly the
+ * The TOLERATE layer: a Bun resolve plugin that (a) maps every known
+ * near-miss specifier onto the real SDK and (b) resolves the platform's own
+ * packages from the platform's install roots when the importing file's
+ * directory can't. Resolution goes through Bun's own resolver from the
+ * importing file's directory FIRST, so the alias lands on exactly the
  * `@agent-compose/sdk` the build would have used had the source spelled it
- * correctly. When the real SDK can't be resolved either, the plugin declines
- * and Bun's failure flows into `explainBundleFailure` below.
+ * correctly and a source that ships its own node_modules is untouched; only
+ * when that fails do the fallback roots (`sdkFallbackRoots`) get a turn, and
+ * `zod` additionally resolves from beside the SDK that was found (its
+ * peer, hoisted or nested). When nothing resolves, the plugin declines and
+ * Bun's failure flows into `explainBundleFailure` below.
  */
 function sdkAliasPlugin(bun: BunSurface): { name: string; setup(build: BunPluginBuild): void } {
+  // A resolution counts ONLY when it lands in a node_modules on `from`'s own
+  // walk-up (through symlinks — a workspace link's realpath is compared
+  // against the link's realpath). Bun's resolver otherwise "succeeds" via
+  // its global install cache (~/.bun/install/cache/<pkg>@<ver>/…), a bare
+  // package whose own dependencies are NOT installed — the build then dies
+  // on the SDK's deps ("Could not resolve @babel/parser, ai, e2b, …"), a
+  // far more confusing failure than the honest fallback below.
+  const tryResolve = (specifier: string, from: string): string | null => {
+    let resolved: string;
+    try { resolved = realpathSync(bun.resolveSync(specifier, from)); } catch { return null; }
+    let dir = resolvePath(from);
+    for (;;) {
+      try {
+        const real = realpathSync(join(dir, "node_modules", specifier));
+        if (resolved === real || resolved.startsWith(real + sep)) return resolved;
+      } catch { /* no node_modules/<specifier> at this level */ }
+      const parent = dirname(dir);
+      if (parent === dir) return null;
+      dir = parent;
+    }
+  };
   return {
     name: "agent-compose-sdk-alias",
     setup(build) {
       build.onResolve({ filter: aliasFilter() }, (args) => {
-        const target = resolveSdkAlias(args.path);
+        const target = resolveSdkAlias(args.path)
+          ?? (PLATFORM_RESOLVED_PACKAGES.includes(args.path) ? args.path : null);
         if (!target) return undefined;
         // `importer` is the importing FILE, `resolveDir` already a directory.
         const from = args.importer ? dirname(args.importer) : args.resolveDir;
-        try {
-          return { path: bun.resolveSync(target, from && from.length > 0 ? from : process.cwd()) };
-        } catch {
-          return undefined;
+        const own = tryResolve(target, from && from.length > 0 ? from : process.cwd());
+        if (own) return { path: own };
+        for (const root of sdkFallbackRoots()) {
+          const hit = tryResolve(target, root);
+          if (hit) return { path: hit };
+          // zod is the SDK's peer: a root that holds the SDK resolves zod
+          // from the SDK's own directory even when it isn't hoisted.
+          if (target !== SDK_PACKAGE) {
+            const sdk = tryResolve(SDK_PACKAGE, root);
+            const beside = sdk ? tryResolve(target, dirname(sdk)) : null;
+            if (beside) return { path: beside };
+          }
         }
+        return undefined;
       });
     },
   };
@@ -557,10 +627,9 @@ export async function bundleWorkflow(
   // schemas → compact JSON-Schema-shaped descriptions carried in
   // template metadata. Used by the dashboard's "Registered" panel to
   // render schema tables and (eventually) client-side validation in
-  // the playground. Run-form workflows stamp `z.unknown()` for both
-  // — `extractIOSchema` filters those down to undefined so the
-  // dashboard renders the "no declared schema" empty state instead
-  // of a meaningless empty table.
+  // the playground. `extractIOSchema` filters a `z.unknown()` schema
+  // down to undefined so the dashboard renders the "no declared
+  // schema" empty state instead of a meaningless empty table.
   const inputSchema  = extractIOSchema(workflow.input);
   const outputSchema = extractIOSchema(workflow.output);
 

package/src/workflow-steps/observability.ts

@@ -78,9 +78,8 @@ const LIVE_EMIT_DRAIN_TIMEOUT_MS = 1_500;
  * this instance. After the step finishes, the engine calls `snapshot()`
  * to extract the bundle for transport.
  *
- * Metadata writes merge (later keys win) — matches the legacy
- * `mergeRunMetadata` semantics so authors don't see a behaviour change
- * across migrations.
+ * Metadata writes merge (later keys win), as the server's run-metadata
+ * merge does.
  */
 export class StepObservabilityCollector {
   private metadata: Record<string, unknown> = {};

package/src/workflow-steps/runner.ts

@@ -6,7 +6,6 @@
  *   2. For each step:
  *      a. Optionally check `getCachedOutput(stepIndex, step.name)` — if a
  *         previous run completed this step, skip and reuse its output.
- *         (Phase 1b uses this for crash recovery.)
  *      b. Validate current input against `step.input`.
  *      c. Call `step.run({ input, ... })`.
  *      d. Validate return value against `step.output`.
@@ -17,9 +16,10 @@
  * Errors during any step bubble through `onStepFailed` and re-throw so the
  * caller can decide whether to mark the run failed.
  *
- * The cache + completion hooks are injection points — a sandbox engine
- * adapter (Phase 1c) wires them to `workflow_step_runs` rows. The default
- * is an in-process map for tests.
+ * The cache + completion hooks are injection points; without a cache every
+ * step runs. The platform's sandbox path does not walk the chain here: the
+ * Temporal `executeStep` activity runs one step per runner subprocess via
+ * `runWorkflowSingleStep` below.
  */
 
 import { z } from "zod";
@@ -76,13 +76,10 @@ export interface RunWorkflowStepsOpts<TInput, TOutput> {
   /**
    * Crash-recovery hook. Called before a step executes. Return the cached
    * output to skip execution; return undefined to run the step.
-   *
-   * Phase 1b implementations will look up `workflow_step_runs` rows for
-   * (runId, stepIndex, stepName) and return completed step outputs here.
    * Default: always undefined (no caching).
    */
   getCachedOutput?(stepIndex: number, stepName: string): unknown | undefined | Promise<unknown | undefined>;
-  /** Fire after a step's `execute` and output validation succeed. */
+  /** Fire after a step's `run` and output validation succeed. */
   onStepCompleted?(stepIndex: number, stepName: string, output: unknown, durationMs: number): void | Promise<void>;
   /** Fire when a step throws or fails validation. The error is re-thrown after this returns. */
   onStepFailed?(stepIndex: number, stepName: string, error: Error, durationMs: number): void | Promise<void>;

package/src/workflow-steps/types.ts

@@ -6,9 +6,8 @@
  *
  * Why: durable suspend/resume requires step boundaries to be addressable as
  * data, not opaque async-function bodies. Each step's input + output is
- * serialisable JSON so engine adapters (in-process, sandbox, future
- * Inngest/Temporal) can record completion and replay from the last
- * completed step.
+ * serialisable JSON so the durable engine (Temporal, one activity per step)
+ * can record completion and replay from the last completed step.
  */
 
 import type { z } from "zod";
@@ -18,7 +17,7 @@ import type { WorkflowMetadata } from "../types/workflow-metadata.js";
 import type { StepObservability } from "./observability.js";
 
 /**
- * Per-step execution context. Threaded into every step's `execute(...)` so
+ * Per-step execution context. Threaded into every step's `run(...)` so
  * the step can read tenant identity and run identity, log progress, and
  * invoke sandbox commands.
  *
@@ -33,9 +32,9 @@ export interface StepContext<TInput = unknown> extends BaseExecutionContext {
   abortSignal: AbortSignal;
   /**
    * Merge key-value metadata onto the run record. Buffered during the
-   * step and flushed when the step completes; the durable engine writes
-   * it via the same `mergeRunMetadata` path the legacy runner used, so
-   * the dashboard sees the same shape. Later keys win.
+   * step and flushed when the step completes; the durable engine merges
+   * it into the run's metadata (`persistStepObservability`). Later keys
+   * win.
    */
   setMetadata(data: Record<string, unknown>): Promise<void>;
   /**
@@ -98,9 +97,8 @@ export interface Step<TInput, TOutput> {
 }
 
 /**
- * The result of running one step. Engine adapters persist these into the
- * `workflow_step_runs` table (Phase 1b) so subsequent runs can skip
- * completed steps. `observability` carries the snapshot of
+ * The result of running one step, as `runWorkflowSteps` reports it per
+ * step. `observability` carries the snapshot of
  * `ctx.setMetadata` / `ctx.step` / `ctx.agentEvents` recorded during
  * the step; undefined when no hooks were used.
  */

package/src/workflow-steps/workflow.ts

@@ -16,7 +16,8 @@
  * matches the final step's `output` schema.
  *
  * Workflows-as-data — the result is consumable by any engine adapter
- * (in-process today; sandbox + Inngest/Temporal in future PRs).
+ * (in-process `runWorkflow`; the sandbox runner one step at a time under
+ * Temporal).
  */
 
 import type { z } from "zod";

package/src/workflows/engine.ts

@@ -6,7 +6,7 @@
  * runner.
  *
  * Errors classified into `WorkflowError` (user code threw) vs `EngineError`
- * (platform problem) for the runner harness to surface upstream.
+ * (platform problem).
  */
 
 import type { WorkflowHooks } from "../types/workflow.js";
@@ -53,7 +53,7 @@ export class EngineError extends Error {
   }
 }
 
-/** Classify any thrown value into the wire-level `kind` expected by `/fail`. */
+/** Classify any thrown value as a `workflow` or an `engine` failure. */
 export function classifyError(err: unknown): "workflow" | "engine" {
   if (err instanceof WorkflowError) return "workflow";
   if (err instanceof EngineError)   return "engine";
@@ -92,9 +92,7 @@ export interface RunWorkflowOptions {
   onStepStarted?:   RunWorkflowStepsOpts<unknown, unknown>["onStepStarted"];
   onStepCompleted?: RunWorkflowStepsOpts<unknown, unknown>["onStepCompleted"];
   onStepFailed?:    RunWorkflowStepsOpts<unknown, unknown>["onStepFailed"];
-  /** Provider-specific child workflow invocation. Temporal/Inngest providers
-   *  inject their native child-workflow primitive; the LocalProvider injects
-   *  the public Agent Compose API client. */
+  /** Child workflow invocation. Unset, a step's `invokeChild` throws. */
   invokeChild?:     InvokeChild;
 }
 

package/src/workflows/invoke-child.ts

@@ -28,8 +28,8 @@ export function deriveInvokeChildIdempotencyKey(parentRunId: string, childName:
 }
 
 /**
- * Build the public-API child workflow invoker used by legacy and sandboxed
- * workflow execution. Provider-backed engines may inject a different
+ * Build the public-API child workflow invoker used by sandboxed workflow
+ * execution (the step runner). Provider-backed engines may inject a different
  * implementation (Temporal child workflow, Inngest invoke, etc.).
  */
 export function buildInvokeChild(

package/dist/generated/verb-synopsis.d.ts

@@ -1,34 +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 declare const AGENTC_VERBS: readonly AgentcVerbEntry[];
-/** The rendered block: title, one framing line, then one line per verb.
- *  Ships verbatim in the server's cloud-session system prompt. */
-export declare const AGENTC_VERB_SYNOPSIS = "agentc verbs \u2014 the complete list:\nGenerated from the CLI's own registry \u2014 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 \u2014 Manage authentication\n- agentc branch claim <target>, rebase [target], release [target], status \u2014 Session drive branches: claim/release write authority, rebase on main\n- agentc bridge login --agent <kind>, status, logout \u2014 Connect a local coding agent (Claude Code / OpenCode) to\u2026\n- agentc calendar \u2014 Check your owner's calendar\n- agentc cancel <run-id> \u2014 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> \u2014 Break-glass compliance sessions\n- agentc connect \u2014 Connect this machine: sign in if needed (one browser approval),\u2026\n- agentc conv list, read <conversationId>, post <channelId> [text], members <conversationId>, invite <conversationId> <users...>, role \u2014 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> \u2014 Render a rich card into the conversation transcript\n- agentc events send <run-id> <name>, list [run-id] \u2014 Send or list run events\n- agentc factory list, create <slug>, use <slug>, delete <slug>, show \u2014 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> \u2014 Read/write documents on a factory's drive\n- agentc import \u2014 Move a local Claude Code session into Agent Compose: history,\u2026\n- agentc init \u2014 Install agentc skills\n- agentc invoke [template] \u2014 Invoke a registered workflow template or a platform default\n- agentc keys create <name>, list \u2014 Manage API keys\n- agentc list \u2014 List workflow templates you can invoke\n- agentc login \u2014 Log in via your browser\n- agentc logout \u2014 Clear this machine's browser-login credentials\n- agentc logs <run-id> \u2014 Stream logs for a run\n- agentc machine upsize \u2014 Resize this session's machine\n- agentc mail search [query...], read <message-id> \u2014 Check your owner's email\n- agentc members list, notify --user <id-or-email> --text <message> \u2014 List teammates and flag them for attention\n- agentc merge \u2014 Merge THIS session's own drive branch into the shared drive's\u2026\n- agentc navigate <path> \u2014 Take the user's dashboard to a page\n- agentc notify [need...] \u2014 Push a non-blocking need OR FINDING to your owner's queue\u2026\n- agentc pause --reason <text> \u2014 Ask the human a question and block until they answer\n- agentc preview open|announce <port>, list, close <port> \u2014 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> \u2014 Create and manage projects\n- agentc register <workflow> \u2014 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> \u2014 Link factory-drive directories to GitHub repositories\n- agentc review findings, publish --notes <file>, git-credential <action>, changes, file <path> \u2014 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 \u2014 Dispatch workflows and check run status\n- agentc schedule create <name> --workflow <name> --cron <expr>, list, delete <id> \u2014 Manage cron schedules attached to registered workflows\n- agentc search <query> \u2014 Search factory files\n- agentc secrets set <workflow> <key> <value>, list <workflow>, delete <workflow> <key>, factory, session \u2014 Manage secrets\n- agentc services list, add <name> --command <cmd>, remove <name>, restore [names...] \u2014 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] \u2014 Interactive terminal chat on a conversation\n- agentc setup \u2014 Set this machine up so any agent on it can\u2026\n- agentc share <ref> \u2014 Share a drive document or a workflow template\n- agentc skills import, list, show <name>, adopt <name>, rm <name>, share <name>, unshare <name> \u2014 Bring your own skills: import local Claude Code skills into\u2026\n- agentc snapshot list, delete <run-id> [snapshot-id], show <run-id> \u2014 Manage captured sandbox snapshots\n- agentc takeover \u2014 Offer the human this desktop\n- agentc thread progress [note...] \u2014 Read this session's thread queue on your owner's board\n- agentc upgrade \u2014 Update the agentc CLI to the latest published version\n- agentc usage \u2014 Show billable usage\n- agentc watch \u2014 Connect the claude-code session already running in this directory to\u2026\n- agentc web <query...> \u2014 Search the web\n- agentc work hold, watch --cmd <shell>, release \u2014 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 declare const AGENTC_VERB_SYNOPSIS_MD = "## agentc verbs \u2014 the complete list\n\nGenerated from the CLI's own registry \u2014 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 \u2014 Manage authentication\n- agentc branch claim <target>, rebase [target], release [target], status \u2014 Session drive branches: claim/release write authority, rebase on main\n- agentc bridge login --agent <kind>, status, logout \u2014 Connect a local coding agent (Claude Code / OpenCode) to\u2026\n- agentc calendar \u2014 Check your owner's calendar\n- agentc cancel <run-id> \u2014 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> \u2014 Break-glass compliance sessions\n- agentc connect \u2014 Connect this machine: sign in if needed (one browser approval),\u2026\n- agentc conv list, read <conversationId>, post <channelId> [text], members <conversationId>, invite <conversationId> <users...>, role \u2014 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> \u2014 Render a rich card into the conversation transcript\n- agentc events send <run-id> <name>, list [run-id] \u2014 Send or list run events\n- agentc factory list, create <slug>, use <slug>, delete <slug>, show \u2014 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> \u2014 Read/write documents on a factory's drive\n- agentc import \u2014 Move a local Claude Code session into Agent Compose: history,\u2026\n- agentc init \u2014 Install agentc skills\n- agentc invoke [template] \u2014 Invoke a registered workflow template or a platform default\n- agentc keys create <name>, list \u2014 Manage API keys\n- agentc list \u2014 List workflow templates you can invoke\n- agentc login \u2014 Log in via your browser\n- agentc logout \u2014 Clear this machine's browser-login credentials\n- agentc logs <run-id> \u2014 Stream logs for a run\n- agentc machine upsize \u2014 Resize this session's machine\n- agentc mail search [query...], read <message-id> \u2014 Check your owner's email\n- agentc members list, notify --user <id-or-email> --text <message> \u2014 List teammates and flag them for attention\n- agentc merge \u2014 Merge THIS session's own drive branch into the shared drive's\u2026\n- agentc navigate <path> \u2014 Take the user's dashboard to a page\n- agentc notify [need...] \u2014 Push a non-blocking need OR FINDING to your owner's queue\u2026\n- agentc pause --reason <text> \u2014 Ask the human a question and block until they answer\n- agentc preview open|announce <port>, list, close <port> \u2014 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> \u2014 Create and manage projects\n- agentc register <workflow> \u2014 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> \u2014 Link factory-drive directories to GitHub repositories\n- agentc review findings, publish --notes <file>, git-credential <action>, changes, file <path> \u2014 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 \u2014 Dispatch workflows and check run status\n- agentc schedule create <name> --workflow <name> --cron <expr>, list, delete <id> \u2014 Manage cron schedules attached to registered workflows\n- agentc search <query> \u2014 Search factory files\n- agentc secrets set <workflow> <key> <value>, list <workflow>, delete <workflow> <key>, factory, session \u2014 Manage secrets\n- agentc services list, add <name> --command <cmd>, remove <name>, restore [names...] \u2014 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] \u2014 Interactive terminal chat on a conversation\n- agentc setup \u2014 Set this machine up so any agent on it can\u2026\n- agentc share <ref> \u2014 Share a drive document or a workflow template\n- agentc skills import, list, show <name>, adopt <name>, rm <name>, share <name>, unshare <name> \u2014 Bring your own skills: import local Claude Code skills into\u2026\n- agentc snapshot list, delete <run-id> [snapshot-id], show <run-id> \u2014 Manage captured sandbox snapshots\n- agentc takeover \u2014 Offer the human this desktop\n- agentc thread progress [note...] \u2014 Read this session's thread queue on your owner's board\n- agentc upgrade \u2014 Update the agentc CLI to the latest published version\n- agentc usage \u2014 Show billable usage\n- agentc watch \u2014 Connect the claude-code session already running in this directory to\u2026\n- agentc web <query...> \u2014 Search the web\n- agentc work hold, watch --cmd <shell>, release \u2014 Hold or release this session's background-work busy lease";

package/dist/pause/__tests__/errors.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/pause/__tests__/wrappers.test.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/step-invocation/__tests__/protocol.test.d.ts

@@ -1 +0,0 @@
-export {};