@bastani/atomic 0.6.8-0 → 0.7.0-1

package/dist/sdk/types.d.ts

@@ -1,435 +0,0 @@
-/**
- * Workflow SDK Types
- *
- * Uses native SDK types directly — no re-definitions.
- */
-import type { SessionEvent } from "@github/copilot-sdk";
-import type { SessionPromptResponse } from "@opencode-ai/sdk/v2";
-import type { SessionMessage } from "@anthropic-ai/claude-agent-sdk";
-import type { CopilotClient, CopilotClientOptions, CopilotSession, SessionConfig as CopilotSessionConfig } from "@github/copilot-sdk";
-import type { OpencodeClient, Session as OpencodeSession } from "@opencode-ai/sdk/v2";
-import type { ClaudeClientWrapper, ClaudeSessionWrapper } from "./providers/claude.ts";
-/** Supported agent types */
-export type AgentType = "copilot" | "opencode" | "claude";
-/**
- * Maps each agent to the client init options the user passes to `ctx.stage()`.
- * Auto-injected fields (`cliUrl`, `baseUrl`, `paneId`) are omitted.
- */
-type ClientOptionsMap = {
-    opencode: {
-        directory?: string;
-        experimental_workspaceID?: string;
-    };
-    copilot: Omit<CopilotClientOptions, "cliUrl">;
-    claude: {
-        chatFlags?: string[];
-    };
-};
-/**
- * Maps each agent to the session create options the user passes to `ctx.stage()`.
- * - OpenCode: `client.session.create()` body params
- * - Copilot: `client.createSession()` config (onPermissionRequest defaults to approveAll)
- * - Claude: no per-session options — delivery is driven entirely by Stop hooks.
- */
-type SessionOptionsMap = {
-    opencode: {
-        parentID?: string;
-        title?: string;
-        workspaceID?: string;
-        permission?: import("@opencode-ai/sdk/v2").PermissionRuleset;
-    };
-    copilot: Partial<CopilotSessionConfig>;
-    claude: Record<string, never>;
-};
-/** Maps each agent to the `s.client` type provided in the stage callback. */
-type ClientMap = {
-    opencode: OpencodeClient;
-    copilot: CopilotClient;
-    claude: ClaudeClientWrapper;
-};
-/** Maps each agent to the `s.session` type provided in the stage callback. */
-type SessionMap = {
-    opencode: OpencodeSession;
-    copilot: CopilotSession;
-    claude: ClaudeSessionWrapper;
-};
-/** Client init options for `ctx.stage()`, resolved by agent type. */
-export type StageClientOptions<A extends AgentType> = ClientOptionsMap[A];
-/** Session create options for `ctx.stage()`, resolved by agent type. */
-export type StageSessionOptions<A extends AgentType> = SessionOptionsMap[A];
-/** The `s.client` type in a stage callback, resolved by agent type. */
-export type ProviderClient<A extends AgentType> = ClientMap[A];
-/** The `s.session` type in a stage callback, resolved by agent type. */
-export type ProviderSession<A extends AgentType> = SessionMap[A];
-export type { CopilotClient, CopilotClientOptions, CopilotSession, CopilotSessionConfig, OpencodeClient, OpencodeSession, ClaudeClientWrapper, ClaudeSessionWrapper, };
-/** A source validation warning emitted by provider-specific workflow validators. */
-export interface ValidationWarning {
-    rule: string;
-    message: string;
-}
-/** A declarative validation rule: pattern to match + warning to emit. */
-export interface ValidationRule {
-    pattern: RegExp;
-    rule: string;
-    message: string;
-}
-/**
- * Run a set of regex-based validation rules against workflow source code.
- * Returns a warning for each matching pattern.
- */
-export declare function validateWorkflowSource(source: string, rules: readonly ValidationRule[]): ValidationWarning[];
-/**
- * Create a provider-specific workflow validator from a set of rules.
- * Eliminates boilerplate — each provider file only needs to declare its rules.
- */
-export declare function createProviderValidator(rules: readonly ValidationRule[]): (source: string) => ValidationWarning[];
-/**
- * Supported field types for a workflow's declared inputs.
- *
- * - `"string"`  — single-line free-form input (short values, identifiers, paths)
- * - `"text"`    — multi-line free-form input (long prose, prompts, specs)
- * - `"enum"`    — one of a fixed list of allowed `values`
- * - `"integer"` — whole number; parsed to `number` in `ctx.inputs`
- */
-export type WorkflowInputType = "string" | "text" | "enum" | "integer";
-/**
- * A declared input for a workflow. When a workflow provides an `inputs`
- * array, the CLI materialises one `--<name>` flag per input (and the
- * interactive picker renders one field per input) so users can pass
- * structured values rather than a single free-form prompt.
- *
- * Leaving `inputs` unset (or empty) signals that the workflow consumes a
- * single free-form prompt instead — the legacy
- * `atomic workflow -n <name> -a <agent> "prompt"` form.
- */
-export interface WorkflowInput {
-    /** Field name — also the CLI flag (`--<name>`) and form field identifier. */
-    name: string;
-    /** Input kind — see {@link WorkflowInputType}. */
-    type: WorkflowInputType;
-    /** Whether the field must be non-empty before the workflow can run. */
-    required?: boolean;
-    /** Short human description shown as the field caption. */
-    description?: string;
-    /** Placeholder text shown when the field is empty. */
-    placeholder?: string;
-    /**
-     * Default value pre-filled into the field. Enums use this to pick
-     * their initial value. Integer inputs accept either a `number` or its
-     * decimal string representation.
-     */
-    default?: string | number;
-    /** Allowed values — required when `type` is `"enum"`. */
-    values?: readonly string[];
-}
-/**
- * Map a {@link WorkflowInputType} to the runtime value type observed in
- * `ctx.inputs`. Integer inputs are parsed to `number` at the executor
- * boundary; everything else stays a `string`.
- */
-export type WorkflowInputValue<T extends WorkflowInputType> = T extends "integer" ? number : string;
-/**
- * Compute the typed `ctx.inputs` shape from a workflow's declared input
- * schema. Each declared field becomes an optional key whose value type
- * is determined by {@link WorkflowInputValue}.
- *
- * Free-form workflows (no declared schema) fall back to a loose
- * string-keyed record so authors can still read `ctx.inputs.prompt`.
- */
-export type InputsOf<I extends readonly WorkflowInput[]> = WorkflowInput extends I[number] ? Record<string, string | undefined> : I[number] extends never ? Record<string, string | undefined> : {
-    [K in I[number]["name"]]?: WorkflowInputValue<Extract<I[number], {
-        name: K;
-    }>["type"]>;
-};
-/**
- * A transcript from a completed session.
- * Provides both the file path and rendered text content.
- */
-export interface Transcript {
-    /** Absolute path to the transcript file on disk */
-    path: string;
-    /** The transcript content (assistant text extracted from messages) */
-    content: string;
-}
-/**
- * A saved message from any provider, stored as JSON.
- * Uses native SDK types directly.
- */
-export type SavedMessage = {
-    provider: "copilot";
-    data: SessionEvent;
-} | {
-    provider: "opencode";
-    data: SessionPromptResponse;
-} | {
-    provider: "claude";
-    data: SessionMessage;
-};
-/**
- * Save native message objects from the provider SDK.
- *
- * - **Copilot**: `s.save(await s.session.getMessages())`
- * - **OpenCode**: `s.save(result.data)` — the full `{ info, parts }` response
- * - **Claude**: `s.save(sessionId)` — auto-reads via `getSessionMessages()`
- */
-export interface SaveTranscript {
-    /** Save Copilot SessionEvent[] from session.getMessages() */
-    (messages: SessionEvent[]): Promise<void>;
-    /** Save OpenCode prompt response `{ info, parts }` from session.prompt().data */
-    (response: SessionPromptResponse): Promise<void>;
-    /** Save Claude messages — pass the session ID to auto-read transcript */
-    (claudeSessionId: string): Promise<void>;
-}
-/** A reference to a completed session — either a handle or a session name string. */
-export type SessionRef = string | SessionHandle<unknown>;
-/**
- * Handle returned by `ctx.stage()`. Used for type-safe transcript references
- * and carries the callback's return value.
- */
-export interface SessionHandle<T = void> {
-    /** The session's unique name */
-    readonly name: string;
-    /** The session's generated UUID */
-    readonly id: string;
-    /** The value returned by the session callback */
-    readonly result: T;
-}
-/**
- * Options for spawning a session via `ctx.stage()`.
- */
-export interface SessionRunOptions {
-    /** Unique name for this session (used for transcript references and graph display) */
-    name: string;
-    /** Human-readable description */
-    description?: string;
-    /**
-     * When true, spawn the CLI server as a background child process (Bun.spawn)
-     * instead of creating a tmux window. The provider client/session are still
-     * auto-created but the stage is invisible in the graph. Useful for
-     * Copilot/OpenCode SDKs that need a server but don't need a visible TUI.
-     */
-    headless?: boolean;
-}
-/**
- * Context provided to each session's callback.
- * Created by `ctx.stage(opts, clientOpts, sessionOpts, fn)` — the callback
- * receives this as its argument with pre-initialized `client` and `session`.
- */
-export interface SessionContext<A extends AgentType = AgentType, I extends readonly WorkflowInput[] = readonly WorkflowInput[]> {
-    /** Provider-specific SDK client (auto-created by runtime) */
-    client: ProviderClient<A>;
-    /** Provider-specific session (auto-created by runtime) */
-    session: ProviderSession<A>;
-    /**
-     * Structured inputs for this workflow run. Populated from CLI flags
-     * (`--<name>=<value>`) or the interactive picker.
-     *
-     * When the workflow declares an `inputs` schema, only the declared
-     * field names are valid keys — accessing undeclared fields is a
-     * compile-time error. Each field's value type is determined by its
-     * declared `type` (integer inputs surface as `number`). Free-form
-     * workflows (no declared schema) allow any key.
-     */
-    inputs: InputsOf<I>;
-    /** Which agent is running */
-    agent: A;
-    /**
-     * Get a completed session's transcript as rendered text.
-     * Accepts a SessionHandle (recommended) or session name string.
-     */
-    transcript(ref: SessionRef): Promise<Transcript>;
-    /**
-     * Get a completed session's raw native messages.
-     * Accepts a SessionHandle (recommended) or session name string.
-     */
-    getMessages(ref: SessionRef): Promise<SavedMessage[]>;
-    /**
-     * Save this session's output for subsequent sessions.
-     * Accepts native SDK message objects only.
-     */
-    save: SaveTranscript;
-    /** Path to this session's storage directory on disk */
-    sessionDir: string;
-    /** tmux pane ID for this session */
-    paneId: string;
-    /** Session UUID */
-    sessionId: string;
-    /**
-     * Spawn a nested sub-session with its own tmux window and graph node.
-     * The sub-session is a child of this session in the graph.
-     * The callback's return value is available as `handle.result`.
-     */
-    stage<T = void>(options: SessionRunOptions, clientOpts: StageClientOptions<A>, sessionOpts: StageSessionOptions<A>, run: (ctx: SessionContext<A, I>) => Promise<T>): Promise<SessionHandle<T>>;
-}
-/**
- * Top-level context provided to the workflow's `.run()` callback.
- * Does not have session-specific fields (paneId, save, etc.).
- */
-export interface WorkflowContext<A extends AgentType = AgentType, I extends readonly WorkflowInput[] = readonly WorkflowInput[]> {
-    /**
-     * Structured inputs for this workflow run. Populated from CLI flags
-     * (`--<name>=<value>`) or the interactive picker.
-     *
-     * When the workflow declares an `inputs` schema, only the declared
-     * field names are valid keys — accessing undeclared fields is a
-     * compile-time error. Each field's value type is determined by its
-     * declared `type` (integer inputs surface as `number`). Free-form
-     * workflows (no declared schema) allow any key.
-     */
-    inputs: InputsOf<I>;
-    /** Which agent is running */
-    agent: A;
-    /**
-     * Spawn a session with its own tmux window and graph node.
-     * The runtime manages the full lifecycle: create client → create session →
-     * run callback → cleanup. The callback's return value is available as
-     * `handle.result`.
-     */
-    stage<T = void>(options: SessionRunOptions, clientOpts: StageClientOptions<A>, sessionOpts: StageSessionOptions<A>, run: (ctx: SessionContext<A, I>) => Promise<T>): Promise<SessionHandle<T>>;
-    /**
-     * Get a completed session's transcript as rendered text.
-     * Accepts a SessionHandle (recommended) or session name string.
-     */
-    transcript(ref: SessionRef): Promise<Transcript>;
-    /**
-     * Get a completed session's raw native messages.
-     * Accepts a SessionHandle (recommended) or session name string.
-     */
-    getMessages(ref: SessionRef): Promise<SavedMessage[]>;
-}
-/**
- * Options for defining a workflow.
- */
-export interface WorkflowOptions<I extends readonly WorkflowInput[] = readonly WorkflowInput[]> {
-    /** Unique workflow name */
-    name: string;
-    /** Human-readable description */
-    description?: string;
-    /**
-     * Absolute path of the workflow source file. Pass `import.meta.path` —
-     * the SDK uses this to import the workflow module inside the
-     * orchestrator child process. Required: a workflow without `source`
-     * cannot be re-imported by the orchestrator and `defineWorkflow`
-     * throws at compile time.
-     *
-     * @example
-     * ```typescript
-     * defineWorkflow({
-     *   name: "hello",
-     *   source: import.meta.path, // ← required
-     * }).for("claude").run(...).compile();
-     * ```
-     */
-    source: string;
-    /**
-     * Optional declared inputs. When provided, the CLI materialises one
-     * `--<name>` flag per entry and the interactive picker renders one form
-     * field per entry. Leave unset to keep the workflow free-form (a single
-     * positional prompt argument).
-     *
-     * Write the array inline so TypeScript can infer literal input names
-     * and enforce them on `ctx.inputs`.
-     */
-    inputs?: I;
-    /**
-     * Minimum Atomic CLI version this workflow is known to work with.
-     *
-     * When set, the CLI refuses to load the workflow on an older install
-     * and surfaces an actionable "update required" entry in the picker
-     * and `atomic workflow list` output instead of silently dropping it.
-     *
-     * Leave unset (the default) to opt out entirely — the workflow will
-     * be treated as compatible with every CLI version. Use this when you
-     * consume a new SDK feature (new provider API, a new field on the
-     * stage options, etc.) that older installs can't honour.
-     *
-     * Accepts `MAJOR.MINOR.PATCH` with an optional numeric prerelease
-     * (`0.6.0`, `0.6.0-0`). Invalid strings are ignored.
-     */
-    minSDKVersion?: string;
-}
-/**
- * Structural constraint for workflows accepted by `Registry.register()`.
- *
- * Uses `run: (...args: never[]) => Promise<void>` instead of the full
- * `WorkflowDefinition<A, I>` constraint to avoid contravariance failures.
- * A narrowly-typed `run(ctx: WorkflowContext<"claude">) => void` is not
- * assignable to `run(ctx: WorkflowContext<AgentType>) => void` under
- * `--strictFunctionTypes` (contravariant parameter position). Using
- * `(...args: never[]) => Promise<void>` sidesteps this: any callable is
- * assignable to a function that takes `never` args. Type narrowing on the
- * accumulating `T` generic is still preserved via `W["agent"]`/`W["name"]`.
- */
-export type RegistrableWorkflow = {
-    readonly __brand: "WorkflowDefinition";
-    readonly agent: AgentType;
-    readonly name: string;
-    readonly description: string;
-    readonly inputs: readonly WorkflowInput[];
-    readonly minSDKVersion: string | null;
-    readonly source: string;
-    readonly run: (...args: never[]) => Promise<void>;
-};
-/**
- * Immutable, chainable registry of compiled workflow definitions.
- *
- * The generic parameter `T` accumulates the registered set as a
- * `Record<"${agent}/${name}", WorkflowDefinition>` intersection, giving
- * `get()` a typed return without casting.
- */
-export type Registry<T extends Record<string, WorkflowDefinition> = Record<string, WorkflowDefinition>> = {
-    /**
-     * Register a workflow definition. Returns a new Registry with the
-     * definition added. Throws if the same `${agent}/${name}` key is
-     * already registered.
-     */
-    register<W extends RegistrableWorkflow>(wf: W): Registry<T & Record<`${W["agent"]}/${W["name"]}`, W>>;
-    /**
-     * Retrieve a registered definition by its composite key.
-     * Compile-time typed based on the accumulated registry type.
-     */
-    get<K extends keyof T>(key: K): T[K];
-    /** Return true if a workflow with the given composite key is registered. */
-    has(key: string): boolean;
-    /** Return all registered definitions as a readonly array. */
-    list(): readonly WorkflowDefinition[];
-    /**
-     * Resolve a workflow by name + agent. Composes the composite key
-     * internally. Returns `undefined` when not found.
-     */
-    resolve(name: string, agent: AgentType): WorkflowDefinition | undefined;
-};
-/**
- * A compiled workflow definition — the sealed output of defineWorkflow().compile().
- */
-export interface WorkflowDefinition<A extends AgentType = AgentType, I extends readonly WorkflowInput[] = readonly WorkflowInput[]> {
-    readonly __brand: "WorkflowDefinition";
-    readonly name: string;
-    /** The agent this workflow targets. Set via `.for(agent)` in the builder. */
-    readonly agent: A;
-    readonly description: string;
-    /**
-     * Absolute path of the workflow source file (the value of
-     * `import.meta.path` at the `defineWorkflow()` call site).
-     *
-     * The SDK's orchestrator entry script `import()`s this path inside
-     * the child process to recover the compiled definition without any
-     * reliance on environment variables or the parent CLI's argv.
-     */
-    readonly source: string;
-    /**
-     * Declared input schema — empty tuple for free-form workflows.
-     * Typed as the builder-supplied `I` so consumers (e.g.
-     * `createWorkflowCli(def)`) can derive the narrow `InputsOf<I>` shape
-     * without carrying a second generic parameter.
-     */
-    readonly inputs: I;
-    /**
-     * Minimum Atomic SDK version required. `null` when the workflow
-     * declared no requirement — treated as compatible with every CLI.
-     */
-    readonly minSDKVersion: string | null;
-    /** The workflow's entry point. Called by the executor with a WorkflowContext. */
-    run(ctx: WorkflowContext<A, I>): Promise<void>;
-}
-//# sourceMappingURL=types.d.ts.map

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

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

package/dist/sdk/worker-shared.d.ts

@@ -1,42 +0,0 @@
-/**
- * Shared helpers for the single-definition worker (`./worker.ts`) and
- * the multi-workflow dispatcher (`./workflow-cli.ts`). These were all
- * inlined in the original `worker.ts` before the split.
- */
-import type { WorkflowInput } from "./types.ts";
-/**
- * Convert a hyphenated option name to the camelCase key Commander uses
- * when storing options in `opts()`. Commander applies this transform
- * automatically: `--output-type` → `opts.outputType`.
- *
- * @example toCamelCase("output-type")  // → "outputType"
- * @example toCamelCase("max-loops")    // → "maxLoops"
- * @example toCamelCase("simple")       // → "simple"
- */
-export declare function toCamelCase(name: string): string;
-/**
- * Validate and resolve inputs against a workflow's declared schema.
- * Throws on unknown flags, missing required fields, invalid enum values,
- * and non-integer values for integer fields.
- */
-export declare function validateAndResolve(inputs: Record<string, string>, schema: readonly WorkflowInput[]): Record<string, string>;
-/**
- * Coerce a typed defaults map (InputsOf shape — string | number values)
- * into the string-valued map the executor and CLI flag layer consume.
- * Returns `undefined` when `defaults` is `undefined` so callers can
- * skip merging entirely.
- */
-export declare function stringifyDefaults(defaults: Record<string, string | number | undefined> | undefined): Record<string, string> | undefined;
-/**
- * Inspect every workflow in a registry snapshot and build a
- * union-of-inputs map. Throws on reserved-name use and on same-name /
- * different-type collisions. Returns the deduplicated union map
- * (name → WorkflowInput). Used by the multi-workflow dispatcher to
- * expose a single set of flags across heterogeneous registry entries.
- */
-export declare function buildInputUnion(workflows: readonly {
-    readonly agent: string;
-    readonly name: string;
-    readonly inputs: readonly WorkflowInput[];
-}[]): Map<string, WorkflowInput>;
-//# sourceMappingURL=worker-shared.d.ts.map

package/dist/sdk/worker-shared.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"worker-shared.d.ts","sourceRoot":"","sources":["../../src/sdk/worker-shared.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,MAAM,EAAE,SAAS,aAAa,EAAE,GAC/B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2DxB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,GAChE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAQpC;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,SAAS;IAClB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C,EAAE,GACF,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAgC5B"}

package/dist/sdk/workflows/builtin/deep-research-codebase/claude/index.d.ts

@@ -1,81 +0,0 @@
-/**
- * deep-research-codebase / claude
- *
- * A deterministically-orchestrated, distributed codebase researcher built on
- * the Claude Agent SDK with **batched** Task-tool fan-out. Specialist
- * sub-agents (codebase-locator / codebase-pattern-finder / codebase-analyzer
- * / codebase-online-researcher) run inside batch sessions: each batch is a
- * single `ctx.stage()` whose orchestrator turn dispatches up to
- * MAX_TASKS_PER_BATCH (≈10) specialists in parallel via the Task tool.
- * Research-history specialists (codebase-research-locator /
- * codebase-research-analyzer) remain as their own small pipeline since they
- * have a strict sequential dependency and run only twice per workflow.
- *
- * Why batched Task-tool dispatch instead of one ctx.stage per specialist:
- *
- *   • SDK-level fan-out scales by codebase size — at 5K LOC per partition
- *     and 4 specialists per partition, a 750K-LOC codebase would otherwise
- *     spawn 600 `claude` subprocesses. Batches of 10 cap that at ~60 SDK
- *     sessions, with each session internally fanning out via Task tool.
- *
- *   • ~10 parallel Task tool sub-agents per single message is the practical
- *     ceiling before rate limits, context contention, and degraded
- *     coordination kick in (no documented hard cap; tunable in
- *     helpers/batching.ts).
- *
- *   • Sub-agents still run in ISOLATED contexts — Task tool gives every
- *     sub-agent its own conversation window, so the locator's file index
- *     doesn't pollute the analyzer the way it would inside a shared
- *     conversation. (multi-agent-patterns swarm isolation.)
- *
- *   • The orchestrator's turn does NOT grow linearly with sub-agent count:
- *     each Task sub-agent writes its verbatim findings to a per-task scratch
- *     file and returns just "DONE", so the orchestrator collects N short
- *     confirmations rather than N transcripts (filesystem-context skill).
- *
- *   • Failure isolation is preserved at two levels: (1) Promise.allSettled
- *     around the batches means one failed batch doesn't abort siblings;
- *     (2) inside a batch, the orchestrator is instructed not to retry
- *     failed Task sub-agents — the synthesis step tolerates missing files.
- *
- *   • Synthesis remains plain TypeScript (`renderExplorerMarkdown` in
- *     helpers/scratch.ts) — no extra LLM call just to concatenate sections.
- *
- * Topology:
- *
- *           ┌─→ codebase-scout (visible)
- *   parent ─┤
- *           └─→ history-locator → history-analyzer (headless)
- *                                       │
- *                                       ▼
- *   ┌──────────────────────────────────────────────────────────────────────┐
- *   │  Wave 1 (locator + pattern-finder, no inter-deps):                    │
- *   │     wave1-batch-1  ∥  wave1-batch-2  ∥  ...  (Promise.allSettled)     │
- *   │       └── each batch session: orchestrator dispatches ≤10 Task        │
- *   │           sub-agents in one assistant message; each writes to disk    │
- *   │                                       │                                │
- *   │                                       ▼                                │
- *   │  TS reads locator-i.md files from disk for Layer 2 prompts            │
- *   │                                       │                                │
- *   │                                       ▼                                │
- *   │  Wave 2 (analyzer + online-researcher, embed locator output):         │
- *   │     wave2-batch-1  ∥  wave2-batch-2  ∥  ...  (Promise.allSettled)     │
- *   │                                       │                                │
- *   │                                       ▼                                │
- *   │  Per partition i: TS reads 4 specialist files + writes explorer-i.md  │
- *   └──────────────────────────────────────────────────────────────────────┘
- *                                       │
- *                                       ▼
- *                                  aggregator (visible)
- *
- * Batch sessions are headless (transparent to the workflow graph). Visible
- * nodes: parent → [codebase-scout] → aggregator.
- */
-declare const _default: import("../../../index.ts").WorkflowDefinition<"claude", readonly [{
-    readonly name: "prompt";
-    readonly type: "text";
-    readonly required: true;
-    readonly description: "research question";
-}]>;
-export default _default;
-//# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/deep-research-codebase/claude/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/deep-research-codebase/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwEG;;;;;;;AAuFH,wBAyZa"}

package/dist/sdk/workflows/builtin/deep-research-codebase/copilot/index.d.ts

@@ -1,37 +0,0 @@
-/**
- * deep-research-codebase / copilot
- *
- * Copilot replica of the Claude deep-research-codebase workflow with the
- * same **batched** Task-tool fan-out. Specialist sub-agents run inside batch
- * sessions: each batch is a single `ctx.stage()` whose orchestrator turn
- * dispatches up to MAX_TASKS_PER_BATCH (≈10) specialists in parallel via
- * Copilot's `agent` tool (alias `Task`, see Copilot subagents docs).
- * Research-history specialists remain as their own sequential sub-pipeline.
- *
- * See claude/index.ts for the full design rationale and topology diagram.
- *
- * Copilot-specific concerns baked in (see references/failure-modes.md):
- *
- *   • F1 — Copilot's last assistant turn is often empty when the agent ends
- *     on a tool call. Batch sessions don't read `getAssistantText` for the
- *     orchestrator output (sub-agents write to disk; the orchestrator's text
- *     reply is just a short tally), so this is no longer load-bearing for
- *     Stage 2 — but the history pipeline still depends on it.
- *
- *   • F5 — every `ctx.stage()` is a FRESH session. Batch session prompts
- *     embed everything the orchestrator needs (per-task subagent_type,
- *     output path, and verbatim specialist prompt) in the first turn.
- *
- *   • F6 — orchestrator prompt requires a single-line tally as the trailing
- *     turn so transcripts are never empty.
- *
- *   • F9 — `s.save()` receives `SessionEvent[]` from `s.session.getMessages()`.
- */
-declare const _default: import("../../../index.ts").WorkflowDefinition<"copilot", readonly [{
-    readonly name: "prompt";
-    readonly type: "text";
-    readonly required: true;
-    readonly description: "research question";
-}]>;
-export default _default;
-//# sourceMappingURL=index.d.ts.map

package/dist/sdk/workflows/builtin/deep-research-codebase/copilot/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/sdk/workflows/builtin/deep-research-codebase/copilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;;;;;;;AAiFH,wBAmXa"}

package/dist/sdk/workflows/builtin/deep-research-codebase/helpers/batching.d.ts

@@ -1,43 +0,0 @@
-/**
- * Batching primitives for the deep-research-codebase workflow.
- *
- * The workflow caps SDK-level fan-out by grouping specialist invocations into
- * "batch sessions" — one `ctx.stage()` per batch. Inside each batch session,
- * the default Claude Code agent dispatches up to MAX_TASKS_PER_BATCH
- * sub-agents in parallel via the Task tool. This keeps the parallel SDK
- * subprocess count proportional to (specialists / 10) rather than to
- * specialists itself, which scales linearly with codebase size.
- *
- * The per-message Task fan-out cap is empirical: there's no documented hard
- * limit, but ~10 parallel sub-agents per single message is the reliable
- * ceiling before rate limits, context contention, and degraded coordination
- * kick in. Lower this if you see batch sessions stalling or returning
- * partial completions; raise it only after measuring.
- */
-import type { PartitionUnit } from "./scout.ts";
-/** Maximum Task-tool sub-agent dispatches per single batch session. */
-export declare const MAX_TASKS_PER_BATCH = 10;
-/** Specialist kinds that share Layer 1 (no inter-task dependencies). */
-export type Layer1Kind = "locator" | "pattern-finder";
-/** Specialist kinds that share Layer 2 (depend on Layer 1 locator output). */
-export type Layer2Kind = "analyzer" | "online-researcher";
-/** Maps a specialist kind to the Claude agent name it dispatches as. */
-export declare const SUBAGENT_TYPE: Record<Layer1Kind | Layer2Kind, string>;
-export type Layer1Task = {
-    kind: Layer1Kind;
-    partitionIndex: number;
-    partition: PartitionUnit[];
-    /** Absolute path the sub-agent must write its verbatim findings to. */
-    outputPath: string;
-};
-export type Layer2Task = {
-    kind: Layer2Kind;
-    partitionIndex: number;
-    partition: PartitionUnit[];
-    outputPath: string;
-    /** Verbatim locator text for this partition, embedded into the prompt. */
-    locatorOutput: string;
-};
-/** Split a flat task list into fixed-size chunks (last chunk may be smaller). */
-export declare function chunkBatches<T>(items: T[], size?: number): T[][];
-//# sourceMappingURL=batching.d.ts.map