@bastani/atomic 0.5.34-0 → 0.6.0-0

package/dist/commands/cli/session.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Session CLI commands — shared between `atomic chat session` and
+ * `atomic workflow session`, and the top-level `atomic session` picker.
+ *
+ * Wraps tmux -L atomic list-sessions / attach-session so users can
+ * inspect and reconnect to running atomic sessions without touching
+ * tmux directly.
+ */
+import { select, confirm, isCancel } from "@clack/prompts";
+import type { TmuxSession } from "../../sdk/runtime/tmux.ts";
+import type { Subprocess } from "bun";
+/** Scope controls which session types a command shows. */
+export type SessionScope = "chat" | "workflow" | "all";
+/** Injectable tmux dependencies for command functions. */
+export interface SessionDeps {
+    isTmuxInstalled: () => boolean;
+    sessionExists: (name: string) => boolean;
+    listSessions: () => TmuxSession[];
+    isInsideAtomicSocket: () => boolean;
+    isInsideTmux: () => boolean;
+    switchClient: (name: string) => void;
+    spawnMuxAttach: (name: string) => Subprocess;
+    detachAndAttachAtomic: (name: string) => void;
+    killSession: (name: string) => void;
+    /** Prompt function for the session picker — defaults to @clack/prompts select. */
+    select: typeof select;
+    /** Prompt function for yes/no confirmations — defaults to @clack/prompts confirm. */
+    confirm: typeof confirm;
+    isCancel: typeof isCancel;
+}
+/**
+ * Render the session list as a printable string.
+ *
+ * Layout mirrors the workflow list style — data-first count header,
+ * session rows with metadata, dim footer hint.
+ */
+export declare function renderSessionList(sessions: TmuxSession[]): string;
+/** Filter sessions by scope (chat-only, workflow-only, or all). */
+export declare function filterByScope(sessions: TmuxSession[], scope: SessionScope): TmuxSession[];
+/** Filter sessions to only those matching at least one of the given agents. */
+export declare function filterByAgent(sessions: TmuxSession[], agents: string[]): TmuxSession[];
+export declare function sessionListCommand(agents?: string[], scope?: SessionScope, deps?: SessionDeps): Promise<number>;
+/**
+ * Connect to a named session. Handles the three tmux contexts:
+ * already on atomic socket → switch-client, inside other tmux → detach+attach,
+ * outside tmux → spawn attach.
+ */
+export declare function sessionConnectCommand(sessionName: string, deps?: SessionDeps): Promise<number>;
+/**
+ * Show an fzf-style interactive picker for all running atomic sessions.
+ * Used by `atomic session connect` (no args).
+ */
+export declare function sessionPickerCommand(agents?: string[], scope?: SessionScope, deps?: SessionDeps): Promise<number>;
+/**
+ * Kill a named session or all sessions matching the given scope and agents.
+ *
+ * - If `sessionId` is provided: confirm and kill that one session.
+ * - If `sessionId` is omitted: confirm and kill all sessions in scope.
+ *
+ * Pass `yes: true` (the `-y/--yes` flag on the CLI) to skip the
+ * confirmation prompt — useful for orchestrating agents that need to
+ * tear down a workflow session non-interactively.
+ */
+export declare function sessionKillCommand(sessionId: string | undefined, agents?: string[], scope?: SessionScope, deps?: SessionDeps, options?: {
+    yes?: boolean;
+}): Promise<number>;
+//# sourceMappingURL=session.d.ts.map

package/dist/commands/cli/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/commands/cli/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAU,MAAM,gBAAgB,CAAC;AAcnE,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,2BAA2B,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEtC,0DAA0D;AAC1D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,CAAC;AAEvD,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,YAAY,EAAE,MAAM,WAAW,EAAE,CAAC;IAClC,oBAAoB,EAAE,MAAM,OAAO,CAAC;IACpC,YAAY,EAAE,MAAM,OAAO,CAAC;IAC5B,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,cAAc,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,UAAU,CAAC;IAC7C,qBAAqB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,WAAW,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,kFAAkF;IAClF,MAAM,EAAE,OAAO,MAAM,CAAC;IACtB,qFAAqF;IACrF,OAAO,EAAE,OAAO,OAAO,CAAC;IACxB,QAAQ,EAAE,OAAO,QAAQ,CAAC;CAC3B;AAoBD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CA6CjE;AA+BD,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,YAAY,GAAG,WAAW,EAAE,CAIzF;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,WAAW,EAAE,CAItF;AAID,wBAAsB,kBAAkB,CAAC,MAAM,GAAE,MAAM,EAAO,EAAE,KAAK,GAAE,YAAoB,EAAE,IAAI,GAAE,WAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAa7I;AAID;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,WAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyCjH;AAID;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,GAAE,MAAM,EAAO,EAAE,KAAK,GAAE,YAAoB,EAAE,IAAI,GAAE,WAAyB,GAAG,OAAO,CAAC,MAAM,CAAC,CAoC/I;AAID;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,MAAM,GAAE,MAAM,EAAO,EACrB,KAAK,GAAE,YAAoB,EAC3B,IAAI,GAAE,WAAyB,EAC/B,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAC9B,OAAO,CAAC,MAAM,CAAC,CAoGjB"}

package/dist/commands/cli/workflow-status.d.ts

@@ -0,0 +1,63 @@
+/**
+ * `atomic workflow status [<id>]` — query the current state of one or
+ * all running workflows so an orchestrating agent can decide whether
+ * to keep waiting, surface a HIL prompt to the user, or move on.
+ *
+ * Status sources, in priority order:
+ *   1. <sessionDir>/status.json — written by the orchestrator on every
+ *      panel-store mutation. Provides per-stage detail and the
+ *      derived overall state (in_progress | error | completed |
+ *      needs_review).
+ *   2. tmux liveness fallback — when status.json is missing or stale
+ *      we still report whether the tmux session is alive so
+ *      script-driven workflows aren't blind during the brief window
+ *      before the orchestrator first writes its snapshot.
+ */
+import { readSnapshot, type WorkflowOverallStatus, type WorkflowStatusSnapshot } from "../../sdk/runtime/status-writer.ts";
+import type { TmuxSession } from "../../sdk/runtime/tmux.ts";
+export type StatusFormat = "json" | "text";
+/** A single workflow's resolved status, as returned to the caller. */
+export interface WorkflowStatusReport {
+    /** Tmux session name (e.g. `atomic-wf-claude-ralph-a1b2c3d4`). */
+    id: string;
+    /** Workflow run id (the trailing 8-hex segment of the tmux name). */
+    workflowRunId: string;
+    /** Workflow name pulled from the snapshot. Empty when no snapshot exists. */
+    workflowName: string;
+    /** Agent backend (claude / copilot / opencode). */
+    agent: string;
+    overall: WorkflowOverallStatus;
+    /** True when the tmux session is currently alive on the atomic socket. */
+    alive: boolean;
+    /** ISO timestamp of the last snapshot, or null when none exists. */
+    updatedAt: string | null;
+    /** Sessions/stages, mirrored from the snapshot. Empty when no snapshot exists. */
+    sessions: WorkflowStatusSnapshot["sessions"];
+    /** Fatal-error message, if any. */
+    fatalError: string | null;
+}
+export interface StatusDeps {
+    isTmuxInstalled: () => boolean;
+    sessionExists: (name: string) => boolean;
+    listSessions: () => TmuxSession[];
+    /**
+     * Read a snapshot from disk. Defaults to the real reader; tests
+     * inject a fake to control the snapshot data without touching the
+     * filesystem.
+     */
+    readSnapshot: typeof readSnapshot;
+    /** Base directory for session dirs. Defaults to `~/.atomic/sessions`. */
+    sessionsBaseDir: string;
+}
+export interface WorkflowStatusOptions {
+    /** Filter to a specific workflow by tmux session name. */
+    id?: string;
+    format?: StatusFormat;
+}
+/**
+ * Top-level command. Prints either a single report (when `id` is
+ * provided) or the list of all workflow sessions on the atomic
+ * socket. Returns 1 when a requested id can't be found, 0 otherwise.
+ */
+export declare function workflowStatusCommand(options: WorkflowStatusOptions, deps?: StatusDeps): Promise<number>;
+//# sourceMappingURL=workflow-status.d.ts.map

package/dist/commands/cli/workflow-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-status.d.ts","sourceRoot":"","sources":["../../../src/commands/cli/workflow-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAUH,OAAO,EACL,YAAY,EAEZ,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC5B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,qBAAqB,CAAC;IAC/B,0EAA0E;IAC1E,KAAK,EAAE,OAAO,CAAC;IACf,oEAAoE;IACpE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kFAAkF;IAClF,QAAQ,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC7C,mCAAmC;IACnC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,MAAM,OAAO,CAAC;IAC/B,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACzC,YAAY,EAAE,MAAM,WAAW,EAAE,CAAC;IAClC;;;;OAIG;IACH,YAAY,EAAE,OAAO,YAAY,CAAC;IAClC,yEAAyE;IACzE,eAAe,EAAE,MAAM,CAAC;CACzB;AAiED,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,qBAAqB,EAC9B,IAAI,GAAE,UAAwB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAiDjB"}

package/dist/sdk/commander.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Commander adapter for embedding a WorkflowCli under a parent Commander CLI.
+ *
+ * ```ts
+ * import { createWorkflowCli } from "@bastani/atomic/workflows";
+ * import { toCommand, runCli } from "@bastani/atomic/workflows/commander";
+ *
+ * const cli = createWorkflowCli(workflow);
+ * const program = new Command("my-app");
+ * program.addCommand(toCommand(cli, "workflow"));
+ *
+ * await runCli(cli, () => program.parseAsync());
+ * ```
+ *
+ * `WorkflowCli` itself is framework-agnostic — this module is the only place
+ * that imports Commander on the adapter side of the API. A future
+ * yargs/citty adapter would be a sibling module with the same shape.
+ *
+ * `runCli` handles orchestrator re-entry transparently — parent CLIs never
+ * see env vars or guards. PyTorch-distributed style: the framework owns
+ * rank-zero dispatch; the developer writes one line.
+ */
+import type { Command } from "@commander-js/extra-typings";
+import type { WorkflowCli, WorkflowDefinition } from "./types.ts";
+/**
+ * Build a Commander `Command` bound to a WorkflowCli for embedding under
+ * a parent CLI. The returned Command declares `-n/--name`, `-a/--agent`,
+ * `-d/--detach`, plus the per-input union across the registry. Picker
+ * behaviour (agent without name in a TTY) is preserved.
+ *
+ * @param cli - WorkflowCli returned by `createWorkflowCli()`.
+ * @param name - Mount name (default: `"workflow"`).
+ */
+export declare function toCommand<T extends Record<string, WorkflowDefinition>>(cli: WorkflowCli<T>, name?: string): Command;
+/**
+ * Bootstrap an embedded Commander CLI. Use this in place of
+ * `program.parseAsync()` when you've mounted an atomic WorkflowCli under
+ * a parent program.
+ *
+ * Inspired by PyTorch's `init_process_group()`: the framework handles
+ * rank-zero dispatch (here: orchestrator vs CLI) transparently, so the
+ * developer writes the same code whether this process is a fresh CLI
+ * invocation or a tmux-spawned orchestrator re-exec.
+ *
+ * - On a fresh invocation, invokes `cliFn()` (your `program.parseAsync()`
+ *   call, plus any bootstrap you want before it).
+ * - When the process is a detached orchestrator re-exec
+ *   (`ATOMIC_ORCHESTRATOR_MODE=1` is set by the runtime), resolves the
+ *   workflow identified by `ATOMIC_WF_KEY` against the supplied CLI
+ *   (or the first match across CLIs) and drives it via
+ *   `runOrchestrator`. `cliFn` is not called.
+ *
+ * Accepts a single WorkflowCli or an array — use an array when your
+ * parent CLI embeds multiple atomic WorkflowClis (rare, but supported).
+ *
+ * @example
+ * ```ts
+ * const program = new Command("my-app");
+ * program.addCommand(toCommand(cli));
+ *
+ * await runCli(cli, () => program.parseAsync());
+ * ```
+ *
+ * @example With pre-parse bootstrap:
+ * ```ts
+ * await runCli(builtinCli, async () => {
+ *   await ensureGlobalAtomicSettings();
+ *   await autoSyncIfStale();
+ *   await program.parseAsync();
+ * });
+ * ```
+ */
+export declare function runCli(target: WorkflowCli | ReadonlyArray<WorkflowCli>, cliFn: () => void | Promise<void>): Promise<void>;
+//# sourceMappingURL=commander.d.ts.map

package/dist/sdk/commander.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commander.d.ts","sourceRoot":"","sources":["../../src/sdk/commander.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAEV,WAAW,EACX,kBAAkB,EACnB,MAAM,YAAY,CAAC;AASpB;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACpE,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,EACnB,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAyCT;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,MAAM,CAC1B,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC,WAAW,CAAC,EAChD,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC,CAyBf"}

package/dist/sdk/components/workflow-picker-panel.d.ts

@@ -16,7 +16,7 @@
  *
  * Lifecycle:
  *
- *   const panel = await WorkflowPickerPanel.create({ agent, workflows });
+ *   const panel = await WorkflowPickerPanel.create({ agent, registry });
  *   const result = await panel.waitForSelection();
  *   panel.destroy();
  *   if (result) await executeWorkflow({ ... });
@@ -27,8 +27,7 @@
  */
 import { type CliRenderer } from "@opentui/core";
 import { type TerminalTheme } from "../runtime/theme.ts";
-import type { AgentType, WorkflowInput } from "../types.ts";
-import type { WorkflowWithMetadata } from "../runtime/discovery.ts";
+import type { AgentType, WorkflowInput, WorkflowDefinition, Registry } from "../types.ts";
 export interface PickerTheme {
     background: string;
     backgroundPanel: string;
@@ -47,11 +46,10 @@ export interface PickerTheme {
     borderActive: string;
 }
 export declare function buildPickerTheme(base: TerminalTheme, isDark: boolean): PickerTheme;
-type Source = "local" | "global" | "builtin";
 /** The payload the picker resolves with on successful submission. */
 export interface WorkflowPickerResult {
     /** The workflow the user committed to running. */
-    workflow: WorkflowWithMetadata;
+    workflow: WorkflowDefinition;
     /** Populated form values, one per declared input (or { prompt } for free-form). */
     inputs: Record<string, string>;
 }
@@ -62,36 +60,35 @@ export interface WorkflowPickerResult {
  */
 export declare function fuzzyMatch(query: string, target: string): number | null;
 interface ListEntry {
-    workflow: WorkflowWithMetadata;
-    section: Source;
+    workflow: WorkflowDefinition;
+    /** Agent the workflow belongs to — used for section grouping. */
+    section: AgentType;
 }
 type ListRow = {
     kind: "section";
-    source: Source;
+    agent: AgentType;
 } | {
     kind: "entry";
     entry: ListEntry;
 };
-/**
- * Deduplicate workflows by name using builtin > local > global precedence.
- * When two workflows share a name, only the higher-precedence entry is kept.
- */
-export declare function deduplicateByName(workflows: WorkflowWithMetadata[]): WorkflowWithMetadata[];
-export declare function buildEntries(query: string, workflows: WorkflowWithMetadata[]): ListEntry[];
+export declare function buildEntries(query: string, workflows: WorkflowDefinition[]): ListEntry[];
 export declare function buildRows(entries: ListEntry[], query: string): ListRow[];
 export declare function isFieldValid(field: WorkflowInput, value: string): boolean;
 interface PickerAppProps {
     theme: PickerTheme;
     agent: AgentType;
-    workflows: WorkflowWithMetadata[];
+    workflows: WorkflowDefinition[];
     onSubmit: (result: WorkflowPickerResult) => void;
     onCancel: () => void;
 }
 export declare function WorkflowPicker({ theme, agent, workflows, onSubmit, onCancel, }: PickerAppProps): import("react").ReactNode;
 export interface WorkflowPickerPanelOptions {
     agent: AgentType;
-    /** Pre-loaded workflows to show. Must already be filtered to `agent`. */
-    workflows: WorkflowWithMetadata[];
+    /**
+     * Registry of compiled workflow definitions. The panel calls
+     * `registry.list()` and filters to the selected `agent`.
+     */
+    registry: Registry<Record<string, WorkflowDefinition>>;
 }
 /**
  * Imperative shell around the React picker tree — mirrors the

package/dist/sdk/components/workflow-picker-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-picker-panel.d.ts","sourceRoot":"","sources":["../../../src/sdk/components/workflow-picker-panel.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-picker-panel.d.ts","sourceRoot":"","sources":["../../../src/sdk/components/workflow-picker-panel.tsx"],"names":[],"mappings":"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"}

package/dist/sdk/define-workflow.d.ts

@@ -3,7 +3,7 @@
  *
  * Usage:
  *   defineWorkflow({ name: "my-workflow", inputs: [...] })
- *     .for<"copilot">()
+ *     .for("copilot")
  *     .run(async (ctx) => {
  *       await ctx.stage({ name: "research" }, {}, {}, async (s) => { ... });
  *       await ctx.stage({ name: "plan" }, {}, {}, async (s) => { ... });
@@ -12,6 +12,15 @@
  */
 import type { AgentType, WorkflowOptions, WorkflowContext, WorkflowDefinition, WorkflowInput } from "./types.ts";
 type AnyInputs = readonly WorkflowInput[];
+/**
+ * Flag and subcommand names reserved by the worker CLI that cannot be used as
+ * workflow input names. The first block (`name` / `agent` / `detach` / `list`
+ * / `help` / `version`) collides with Commander's own flags on the root
+ * command; the second block (`session` / `status`) collides with the auto-
+ * registered management subcommands added by `createWorkflowCli` when
+ * `includeManagementCommands` is left at its default (`true`).
+ */
+export declare const RESERVED_INPUT_NAMES: readonly ["name", "agent", "detach", "list", "help", "version", "session", "status"];
 /**
  * Chainable workflow builder. Records the run callback,
  * then .compile() seals it into a WorkflowDefinition.
@@ -21,14 +30,14 @@ export declare class WorkflowBuilder<A extends AgentType = AgentType, I extends
     readonly __brand: "WorkflowBuilder";
     private readonly options;
     private runFn;
+    private agentValue;
     constructor(options: WorkflowOptions<I>);
     /**
      * Narrow the agent type for this workflow while preserving typed inputs.
      *
-     * Use `.for<"copilot">()` **before** `.run()` instead of passing the
-     * agent as a type parameter to `defineWorkflow`. This allows TypeScript
-     * to infer input names from the `inputs` array AND narrow the agent
-     * type for `stage()` callbacks.
+     * Pass the agent as a runtime string argument so the compiled
+     * {@link WorkflowDefinition} carries the `agent` field required by
+     * the registry.
      *
      * @example
      * ```typescript
@@ -36,7 +45,7 @@ export declare class WorkflowBuilder<A extends AgentType = AgentType, I extends
      *   name: "my-workflow",
      *   inputs: [{ name: "greeting", type: "string" }],
      * })
-     *   .for<"copilot">()
+     *   .for("copilot")
      *   .run(async (ctx) => {
      *     ctx.inputs.greeting; // ✓ typed
      *     ctx.inputs.prompt;   // ✗ compile error
@@ -44,7 +53,7 @@ export declare class WorkflowBuilder<A extends AgentType = AgentType, I extends
      *   .compile();
      * ```
      */
-    for<B extends AgentType>(): WorkflowBuilder<B, I>;
+    for<B extends AgentType>(agent: B): WorkflowBuilder<B, I>;
     /**
      * Set the workflow's entry point.
      *
@@ -66,7 +75,7 @@ export declare class WorkflowBuilder<A extends AgentType = AgentType, I extends
  * Entry point for defining a workflow.
  *
  * Write the `inputs` array inline so TypeScript infers literal field
- * names and enforces them on `ctx.inputs`. Use `.for<Agent>()` to
+ * names and enforces them on `ctx.inputs`. Use `.for(agent)` to
  * narrow the agent type while keeping typed inputs:
  *
  * @example
@@ -80,7 +89,7 @@ export declare class WorkflowBuilder<A extends AgentType = AgentType, I extends
  *     { name: "greeting", type: "string", required: true },
  *   ],
  * })
- *   .for<"copilot">()
+ *   .for("copilot")
  *   .run(async (ctx) => {
  *     ctx.inputs.greeting; // ✓ string | undefined
  *     ctx.inputs.prompt;   // ✗ compile error — not declared

package/dist/sdk/define-workflow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-workflow.d.ts","sourceRoot":"","sources":["../../src/sdk/define-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,KAAK,SAAS,GAAG,SAAS,aAAa,EAAE,CAAC;AA0D1C;;;GAGG;AACH,qBAAa,eAAe,CAC1B,CAAC,SAAS,SAAS,GAAG,SAAS,EAC/B,CAAC,SAAS,SAAS,GAAG,SAAS;IAE/B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAG,iBAAiB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,KAAK,CAAgE;gBAEjE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IAIvC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,GAAG,CAAC,CAAC,SAAS,SAAS,KAAK,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IAIjD;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAW5D;;;;;OAKG;IACH,OAAO,IAAI,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;CAoCpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,CAAC,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,SAAS,aAAa,EAAE,EAEnE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAK/B"}
+{"version":3,"file":"define-workflow.d.ts","sourceRoot":"","sources":["../../src/sdk/define-workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,SAAS,EACT,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,KAAK,SAAS,GAAG,SAAS,aAAa,EAAE,CAAC;AAE1C;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,sFASvB,CAAC;AAgEX;;;GAGG;AACH,qBAAa,eAAe,CAC1B,CAAC,SAAS,SAAS,GAAG,SAAS,EAC/B,CAAC,SAAS,SAAS,GAAG,SAAS;IAE/B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAG,iBAAiB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,KAAK,CAAgE;IAC7E,OAAO,CAAC,UAAU,CAA0B;gBAEhC,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IAIvC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,KAAK,EAAE,CAAC,GAAG,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC;IAOzD;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAW5D;;;;;OAKG;IACH,OAAO,IAAI,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC;CA4CpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAC5B,KAAK,CAAC,CAAC,SAAS,SAAS,aAAa,EAAE,GAAG,SAAS,aAAa,EAAE,EAEnE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAC1B,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,CAK/B"}

package/dist/sdk/index.d.ts

@@ -7,7 +7,8 @@
 export { MissingDependencyError, WorkflowNotCompiledError, InvalidWorkflowError, } from "./errors.ts";
 export type { AgentType, Transcript, SavedMessage, SaveTranscript, SessionContext, SessionRef, SessionHandle, SessionRunOptions, WorkflowContext, WorkflowOptions, WorkflowDefinition, StageClientOptions, StageSessionOptions, ProviderClient, ProviderSession, } from "./types.ts";
 export { defineWorkflow } from "./define-workflow.ts";
-export { discoverWorkflows, findWorkflow, } from "./runtime/discovery.ts";
-export { WorkflowLoader } from "./runtime/loader.ts";
-export { executeWorkflow } from "./runtime/executor.ts";
+export type { Registry } from "./registry.ts";
+export { createRegistry } from "./registry.ts";
+export { createWorkflowCli } from "./workflow-cli.ts";
+export type { WorkflowCli, CreateWorkflowCliOptions } from "./types.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/sdk/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,OAAO,EACL,iBAAiB,EACjB,YAAY,GACb,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,aAAa,CAAC;AAGrB,YAAY,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,EACd,cAAc,EACd,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAGtD,YAAY,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAK/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC"}

package/dist/sdk/management-commands.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Session + status management subcommands for workflow CLIs.
+ *
+ * Shared by the atomic CLI root (`atomic session *`, `atomic workflow status`)
+ * and by SDK-built CLIs (`createWorkflowCli(...)`). Factoring this out means a
+ * user running `bun run src/claude-worker.ts session list` gets the identical
+ * command surface as `atomic session list`, without the SDK embedding its own
+ * diverging implementation. All queries go through the shared atomic tmux
+ * socket, so sessions spawned by SDK-built CLIs and by `atomic workflow -n …`
+ * show up interchangeably.
+ *
+ * Commander options are declared with the same names, descriptions, and
+ * behaviour as the atomic root CLI — keep them in sync when the root CLI
+ * grows a new option.
+ */
+import type { Command } from "@commander-js/extra-typings";
+import type { SessionScope } from "../commands/cli/session.ts";
+/**
+ * Attach the `session` subcommand group (`list` / `connect` / `kill`) to a
+ * parent Commander command. Returns the created `session` group so callers
+ * can attach additional children if they need to.
+ *
+ * @param parent The Commander command to mount `session` under.
+ * @param scope  Which session set the list/kill commands operate on. SDK CLIs
+ *               typically pass `"workflow"` to scope the picker to
+ *               `atomic-wf-*` sessions only; the atomic root uses `"all"`.
+ */
+export declare function addSessionSubcommand(parent: Command, scope?: SessionScope): Command;
+/**
+ * Attach a top-level `status` subcommand for querying workflow status.
+ * Mirrors `atomic workflow status` — same overall-state contract
+ * (`in_progress` / `error` / `completed` / `needs_review`) and same JSON
+ * shape. Omit the id to list every running workflow on the socket.
+ */
+export declare function addStatusSubcommand(parent: Command): void;
+/**
+ * Convenience: attach both `session` and `status` subcommands in the order
+ * the SDK defaults use. Called by `createWorkflowCli` when
+ * `includeManagementCommands` is `true` (the default).
+ */
+export declare function addManagementCommands(parent: Command, scope?: SessionScope): void;
+//# sourceMappingURL=management-commands.d.ts.map

package/dist/sdk/management-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-commands.d.ts","sourceRoot":"","sources":["../../src/sdk/management-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAO/D;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,OAAO,EACf,KAAK,GAAE,YAAoB,GAC1B,OAAO,CA0ET;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAkBzD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,OAAO,EACf,KAAK,GAAE,YAAyB,GAC/B,IAAI,CAGN"}

package/dist/sdk/registry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Workflow Registry — immutable, chainable registry of WorkflowDefinition objects.
+ *
+ * Key scheme: `${agent}/${name}` — each (agent, name) pair is unique.
+ * Registering the same key twice throws — no silent overwrites.
+ * `register()` is immutable: returns a new Registry, original is unchanged.
+ */
+import type { Registry } from "./types.ts";
+import { validateCopilotWorkflow } from "./providers/copilot.ts";
+import { validateOpenCodeWorkflow } from "./providers/opencode.ts";
+import { validateClaudeWorkflow } from "./providers/claude.ts";
+export type { Registry };
+/**
+ * Create an empty workflow registry.
+ *
+ * @example
+ * ```typescript
+ * import { createRegistry } from "@bastani/atomic/workflows";
+ * import { myWorkflow } from "./workflows/my-workflow.workflow";
+ *
+ * const registry = createRegistry()
+ *   .register(myWorkflow);
+ * ```
+ */
+export declare function createRegistry(): Registry<Record<string, never>>;
+export { validateCopilotWorkflow, validateOpenCodeWorkflow, validateClaudeWorkflow };
+//# sourceMappingURL=registry.d.ts.map

package/dist/sdk/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/sdk/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAa,QAAQ,EAA2C,MAAM,YAAY,CAAC;AAC/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAI/D,YAAY,EAAE,QAAQ,EAAE,CAAC;AAmGzB;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAEhE;AAGD,OAAO,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/sdk/runtime/attached-footer.d.ts

@@ -9,7 +9,7 @@
  *
  * Resolves the CLI entrypoint relative to this module (runtime/ lives at
  * src/sdk/runtime/, so ../../cli.ts is the CLI). `process.argv[1]` points
- * at the orchestrator's executor-entry.ts when called from the executor,
+ * at the worker entrypoint when called from the orchestrator,
  * so it can't be used here.
  */
 import type { AgentType } from "../types.ts";

package/dist/sdk/runtime/executor-env.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Orchestrator environment variable validation — extracted into its own
+ * module so test files can import it directly without touching the
+ * executor.ts module (which is mocked in worker.test.ts and
+ * workflow-command.test.ts). Importing from here bypasses those mocks.
+ */
+import type { AgentType } from "../types.ts";
+/**
+ * Read and validate the required orchestrator env vars, throwing on the
+ * first missing or invalid value.
+ *
+ * Required vars: ATOMIC_WF_ID, ATOMIC_WF_TMUX, ATOMIC_WF_AGENT, ATOMIC_WF_CWD.
+ */
+export declare function validateOrchestratorEnv(): {
+    workflowRunId: string;
+    tmuxSessionName: string;
+    agent: AgentType;
+    cwd: string;
+};
+//# sourceMappingURL=executor-env.d.ts.map

package/dist/sdk/runtime/executor-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-env.d.ts","sourceRoot":"","sources":["../../../src/sdk/runtime/executor-env.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C;;;;;GAKG;AACH,wBAAgB,uBAAuB,IAAI;IACzC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;CACb,CAuBA"}

package/dist/sdk/runtime/executor.d.ts

@@ -2,18 +2,18 @@
  * Workflow runtime executor.
  *
  * Architecture:
- * 1. `executeWorkflow()` is called by the CLI command
- * 2. It creates a tmux session with an orchestrator pane that runs
- *    `bun run executor-entry.ts` (a thin wrapper that calls `runOrchestrator()`)
+ * 1. `executeWorkflow()` is called by the CLI command or worker
+ * 2. It creates a tmux session with an orchestrator pane that re-executes
+ *    the user's entrypoint file with `ATOMIC_ORCHESTRATOR_MODE=1`
  * 3. The CLI then attaches to the tmux session (user sees it live)
  * 4. The orchestrator pane calls `definition.run(workflowCtx)` — the
  *    user's callback uses `ctx.stage()` to spawn agent sessions
  *
- * The entry point is in executor-entry.ts (not this file) to avoid Bun's
- * dual-module-identity issue: Bun evaluates a file twice when it is both
- * the entry point and reached through package.json `exports` self-referencing.
+ * In the new model the user's own file (e.g. `src/worker.ts`) is re-executed
+ * with env vars (`ATOMIC_ORCHESTRATOR_MODE`, `ATOMIC_WF_KEY`) that signal
+ * re-entry. The worker detects those vars and calls `runOrchestrator(definition)`.
  */
-import type { WorkflowDefinition, WorkflowInput, AgentType, SavedMessage } from "../types.ts";
+import type { WorkflowDefinition, WorkflowInput, AgentType, SavedMessage, StageClientOptions } from "../types.ts";
 export { errorMessage } from "../errors.ts";
 export interface WorkflowRunOptions {
     /** The compiled workflow definition */
@@ -27,8 +27,19 @@ export interface WorkflowRunOptions {
      * whether the workflow declares a schema. Empty record is valid.
      */
     inputs?: Record<string, string>;
-    /** Absolute path to the workflow's index.ts file (from discovery) */
-    workflowFile: string;
+    /**
+     * Absolute path to the user's entrypoint file (e.g. `src/worker.ts`).
+     * The launcher re-executes this file with `ATOMIC_ORCHESTRATOR_MODE=1`
+     * so the worker can detect re-entry and call `runOrchestrator()`.
+     * Defaults to `process.argv[1]` at the call site.
+     */
+    entrypointFile: string;
+    /**
+     * Registry key identifying this workflow, formatted as `"<agent>/<name>"`.
+     * Passed via `ATOMIC_WF_KEY` so the orchestrator can resolve the
+     * definition from the registry without a file-system scan.
+     */
+    workflowKey: string;
     /** Project root (defaults to cwd) */
     projectRoot?: string;
     /**
@@ -234,5 +245,45 @@ export declare function watchCopilotSessionForElicitation(session: CopilotHILSes
  * entries the caller already supplied. Exported for unit testing.
  */
 export declare function mergeExcludedTools(existing: string[] | undefined, extras: string[]): string[];
-export declare function runOrchestrator(): Promise<void>;
+type ExternalCopilotClientOptions = Omit<StageClientOptions<"copilot">, "gitHubToken" | "useLoggedInUser">;
+interface ExternalCopilotOptions {
+    clientOptions: ExternalCopilotClientOptions;
+    sessionGitHubToken?: string;
+}
+/**
+ * Copilot SDK 0.3.0 rejects client-level auth options when connecting to an
+ * existing `cliUrl`. Visible stages use an already-running TUI server, so move
+ * token auth to the session-level option that 0.3.0 introduced for this case.
+ */
+export declare function normalizeExternalCopilotOptions(clientOptions: StageClientOptions<"copilot">, sessionGitHubToken?: string): ExternalCopilotOptions;
+/**
+ * Run the orchestrator inside a tmux pane.
+ *
+ * Called by the worker entrypoint when `ATOMIC_ORCHESTRATOR_MODE=1` is set.
+ * The `definition` parameter is resolved by the caller (the worker) from the
+ * registry using `ATOMIC_WF_KEY` — this function no longer performs any
+ * file-path import or workflow discovery.
+ *
+ * @param definition - Resolved workflow definition from the registry.
+ */
+export { validateOrchestratorEnv } from "./executor-env.ts";
+/**
+ * Orchestrator re-entry guard.
+ *
+ * When `executeWorkflow()` spawns a detached pane, it re-invokes the
+ * composition root with `ATOMIC_ORCHESTRATOR_MODE=1` +
+ * `ATOMIC_WF_KEY="<agent>/<name>"`. This helper detects that re-entry
+ * and hands off to `runOrchestrator()` with the resolved definition.
+ *
+ * Returns `true` when re-entry was handled (caller should stop normal
+ * CLI flow). Returns `false` when `ATOMIC_ORCHESTRATOR_MODE` is unset
+ * — the caller should proceed with argv parsing.
+ *
+ * The `resolve` callback lets embedded workers pass a trivial lookup
+ * (their single bound definition) while the dispatcher passes its
+ * registry. Throws on malformed or unknown keys so authoring mistakes
+ * surface loudly instead of silently hanging.
+ */
+export declare function handleOrchestratorReEntry(resolve: (name: string, agent: AgentType) => WorkflowDefinition | undefined): Promise<boolean>;
+export declare function runOrchestrator(definition: WorkflowDefinition): Promise<void>;
 //# sourceMappingURL=executor.d.ts.map