agent-bober 0.12.0 → 0.17.0

package/dist/orchestrator/worktree.js

@@ -0,0 +1,129 @@
+// ── worktree.ts ───────────────────────────────────────────────────────
+//
+// runInWorktree(task, projectRoot, config, opts) creates a git worktree
+// under <projectRoot>/<pipeline.worktreeRoot>/<runId>, kicks off the
+// pipeline INSIDE that worktree (passing worktreePath as the new projectRoot),
+// then cleans up per policy on success or retains on failure.
+//
+// Sprint 4 (cockpit-integration)
+import { randomUUID } from "node:crypto";
+import { join, isAbsolute } from "node:path";
+import { readFile } from "node:fs/promises";
+import { runPipeline } from "./pipeline.js";
+import { runManager } from "../mcp/run-manager.js";
+import { addWorktree, removeWorktree, isClean, getCurrentBranch } from "../utils/git.js";
+import { logger } from "../utils/logger.js";
+// ── Slug derivation ────────────────────────────────────────────────────
+//
+// Matches the generator.branchPattern '{feature-name}' substitution.
+// Takes first 60 chars of the task, lowercases, replaces non-alphanumeric
+// runs with '-', strips leading/trailing dashes.
+// If the resulting slug is empty (e.g. all-emoji task), falls back to a
+// short prefix so branch names are always valid.
+export function deriveWorktreeSlug(task) {
+    const slug = task
+        .slice(0, 60)
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "run";
+}
+// ── .gitignore check ──────────────────────────────────────────────────
+async function isBoberGitignored(projectRoot) {
+    try {
+        const gitignore = await readFile(join(projectRoot, ".gitignore"), "utf-8");
+        // Check if any line matches .bober or .bober/
+        return gitignore.split("\n").some((line) => {
+            const trimmed = line.trim();
+            return trimmed === ".bober" || trimmed === ".bober/" || trimmed === "/.bober" || trimmed === "/.bober/";
+        });
+    }
+    catch {
+        return false;
+    }
+}
+// ── Main entry point ───────────────────────────────────────────────────
+export async function runInWorktree(task, projectRoot, config, opts = {}) {
+    // 1. Dirty-tree guard
+    if (!opts.allowDirty) {
+        const { clean, dirtyFiles } = await isClean(projectRoot);
+        if (!clean) {
+            throw new Error(`Working tree has uncommitted changes:\n  ${dirtyFiles.join("\n  ")}\n` +
+                `Pass --allow-dirty (CLI) or allowDirty=true (MCP) to override.`);
+        }
+    }
+    // 2. Determine baseline branch (current HEAD or 'main' fallback)
+    let baseBranch;
+    let isDetached = false;
+    try {
+        const cur = await getCurrentBranch(projectRoot);
+        if (cur === "HEAD") {
+            // Detached HEAD
+            isDetached = true;
+            baseBranch = "main";
+        }
+        else {
+            baseBranch = cur;
+        }
+    }
+    catch {
+        isDetached = true;
+        baseBranch = "main";
+    }
+    if (isDetached) {
+        process.stderr.write(`[runInWorktree] Detached HEAD detected — falling back to baseline 'main'.\n`);
+    }
+    // Warn if .bober/ is not gitignored (soft check, not a hard error)
+    const gitignored = await isBoberGitignored(projectRoot);
+    if (!gitignored) {
+        process.stderr.write(`[runInWorktree] Warning: .bober/ is not in .gitignore — ` +
+            `the worktree directory will appear as a tracked path. ` +
+            `Consider adding '.bober/' to .gitignore.\n`);
+    }
+    // 3. Derive runId, branch name, worktree path
+    const runId = randomUUID();
+    const slug = deriveWorktreeSlug(task);
+    const branchPattern = config.generator.branchPattern ?? "bober/{feature-name}";
+    const branch = branchPattern.replace("{feature-name}", slug);
+    const worktreeRootRel = config.pipeline.worktreeRoot ?? ".bober/worktrees";
+    const worktreeRootAbs = isAbsolute(worktreeRootRel)
+        ? worktreeRootRel
+        : join(projectRoot, worktreeRootRel);
+    const worktreePath = join(worktreeRootAbs, runId);
+    // 4. Create worktree via git CLI
+    await addWorktree(projectRoot, worktreePath, branch, baseBranch);
+    // 5. Kick off pipeline INSIDE the worktree (worktreePath becomes the new projectRoot)
+    const cleanupOnSuccess = !opts.keepOnSuccess && config.pipeline.cleanupWorktreeOnSuccess !== false;
+    const pipelineFn = opts.pipelineFn ?? runPipeline;
+    // Wrap pipelineFn so we can intercept resolution and run cleanup.
+    // CRITICAL: pipelineFn is called with worktreePath as projectRoot, NOT the original.
+    const wrapped = async (t, _root, c) => {
+        try {
+            const result = await pipelineFn(t, worktreePath, c);
+            if (result.success && cleanupOnSuccess) {
+                try {
+                    await removeWorktree(projectRoot, worktreePath);
+                }
+                catch (e) {
+                    logger.warn(`[runInWorktree] worktree cleanup failed: ${e instanceof Error ? e.message : String(e)}`);
+                }
+            }
+            else if (!result.success) {
+                process.stderr.write(`[runInWorktree] Pipeline failed — worktree retained for debugging: ${worktreePath}\n`);
+            }
+            return result;
+        }
+        catch (err) {
+            // On throw, ALWAYS retain
+            process.stderr.write(`[runInWorktree] Pipeline crashed — worktree retained for debugging: ${worktreePath}\n`);
+            throw err;
+        }
+    };
+    await runManager.startRun(task, projectRoot, config, wrapped, {
+        runId,
+        worktreePath,
+        branch,
+    });
+    return { runId, branch, worktreePath };
+}
+//# sourceMappingURL=worktree.js.map

package/dist/orchestrator/worktree.js.map

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

package/dist/providers/anthropic.d.ts

@@ -6,10 +6,17 @@ import type { LLMClient, ChatParams, ChatResponse } from "./types.js";
  * converts provider-agnostic Message[] (including tool call/result variants)
  * to Anthropic MessageParam[], and normalizes Anthropic responses to
  * ChatResponse after each call.
+ *
+ * When promptCaching is enabled (the default), attaches ephemeral
+ * cache_control breakpoints to the system prompt and up to the last 3
+ * messages (system-and-last-3 strategy, capped at 4 breakpoints total).
  */
 export declare class AnthropicAdapter implements LLMClient {
     private readonly client;
-    constructor(apiKey?: string);
+    private readonly promptCaching;
+    constructor(apiKey?: string, opts?: {
+        promptCaching?: boolean;
+    });
     chat(params: ChatParams): Promise<ChatResponse>;
 }
 //# sourceMappingURL=anthropic.d.ts.map

package/dist/providers/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAKb,MAAM,YAAY,CAAC;AAkHpB;;;;;;;GAOG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;gBAEvB,MAAM,CAAC,EAAE,MAAM;IAIrB,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CA+BtD"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAKb,MAAM,YAAY,CAAC;AA6LpB;;;;;;;;;;;GAWG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAE5B,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE;IAKzD,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CA8FtD"}

package/dist/providers/anthropic.js

@@ -51,10 +51,11 @@ function normalizeContent(content) {
 /**
  * Convert a provider-agnostic Message to an Anthropic MessageParam.
  *
- * Handles three message variants:
+ * Handles four message variants:
  * - TextMessage: plain string content for user or assistant
  * - AssistantMessage: assistant turn with optional text + tool_use blocks
  * - ToolResultMessage: user turn carrying tool_result blocks
+ * - SystemUpdateMessage: user turn carrying a mid_conv_system content block
  */
 function toAnthropicMessage(message) {
     // ToolResultMessage: user turn with tool results
@@ -85,12 +86,74 @@ function toAnthropicMessage(message) {
         }
         return { role: "assistant", content };
     }
+    // SystemUpdateMessage: render as a mid_conv_system content block inside a user turn
+    if ("systemUpdate" in message) {
+        const block = {
+            type: "mid_conv_system",
+            content: [{ type: "text", text: message.systemUpdate }],
+            ...(message.cacheTtl
+                ? { cache_control: { type: "ephemeral", ttl: message.cacheTtl } }
+                : {}),
+        };
+        return { role: "user", content: [block] };
+    }
     // TextMessage: plain string content
     return {
         role: message.role,
         content: message.content,
     };
 }
+// ── Prompt caching ──────────────────────────────────────────────────
+/**
+ * Build a cached system block: wraps the plain system string in a
+ * TextBlockParam array with an ephemeral cache_control marker.
+ */
+function buildCachedSystem(system) {
+    return [{ type: "text", text: system, cache_control: { type: "ephemeral" } }];
+}
+/**
+ * Attach ephemeral cache_control breakpoints to the final content block of
+ * up to the last 3 messages (system-and-last-3 strategy, capped at 4 total).
+ *
+ * System counts as 1 breakpoint, so at most 3 message breakpoints are added.
+ * Messages with plain-string content are converted to a one-element
+ * TextBlockParam array so the breakpoint can be attached.
+ */
+function attachMessageBreakpoints(msgs) {
+    const result = msgs.map((m) => ({ ...m }));
+    const maxMsgBreakpoints = 3; // 4 total - 1 for system
+    let placed = 0;
+    // Walk from the end of the array, attaching breakpoints to the last 3.
+    for (let i = result.length - 1; i >= 0 && placed < maxMsgBreakpoints; i--) {
+        const msg = result[i];
+        if (typeof msg.content === "string") {
+            // Convert plain-string content to a TextBlockParam array.
+            result[i] = {
+                ...msg,
+                content: [
+                    {
+                        type: "text",
+                        text: msg.content,
+                        cache_control: { type: "ephemeral" },
+                    },
+                ],
+            };
+        }
+        else if (Array.isArray(msg.content) && msg.content.length > 0) {
+            // Attach to the LAST block of the existing array.
+            const blocks = msg.content.map((b) => ({ ...b }));
+            const last = blocks[blocks.length - 1];
+            last.cache_control = { type: "ephemeral" };
+            result[i] = { ...msg, content: blocks };
+        }
+        else {
+            // Empty content — skip without consuming a breakpoint slot.
+            continue;
+        }
+        placed++;
+    }
+    return result;
+}
 // ── AnthropicAdapter ────────────────────────────────────────────────
 /**
  * LLMClient implementation that wraps the Anthropic SDK.
@@ -99,34 +162,95 @@ function toAnthropicMessage(message) {
  * converts provider-agnostic Message[] (including tool call/result variants)
  * to Anthropic MessageParam[], and normalizes Anthropic responses to
  * ChatResponse after each call.
+ *
+ * When promptCaching is enabled (the default), attaches ephemeral
+ * cache_control breakpoints to the system prompt and up to the last 3
+ * messages (system-and-last-3 strategy, capped at 4 breakpoints total).
  */
 export class AnthropicAdapter {
     client;
-    constructor(apiKey) {
+    promptCaching;
+    constructor(apiKey, opts) {
         this.client = new Anthropic({ apiKey });
+        this.promptCaching = opts?.promptCaching ?? true;
     }
     async chat(params) {
-        const { model, system, messages, tools, maxTokens = 16384 } = params;
+        const { model, system, messages, tools, maxTokens = 16384, effort } = params;
         // Convert provider-agnostic Message[] to Anthropic MessageParam[]
         const anthropicMessages = messages.map(toAnthropicMessage);
-        // Convert ToolDef[] to Anthropic.Messages.Tool[]
-        const anthropicTools = tools && tools.length > 0 ? tools.map(toAnthropicTool) : undefined;
+        // ── Structured output branch ────────────────────────────────────
+        // When responseSchema is set, force a single "structured_output" tool
+        // whose input_schema IS the schema, and do NOT forward the user's tools.
+        // tool_choice forces the model to call it, and we stringify the resulting
+        // tool input into ChatResponse.text (with empty toolCalls).
+        const structured = params.responseSchema !== undefined;
+        const forcedTool = structured
+            ? {
+                name: "structured_output",
+                description: "Return your answer as a single structured JSON object matching the schema.",
+                input_schema: params.responseSchema,
+            }
+            : undefined;
+        // Convert ToolDef[] to Anthropic.Messages.Tool[]. In the structured branch
+        // the user's tools are intentionally suppressed in favour of the forced tool.
+        const anthropicTools = structured
+            ? [forcedTool]
+            : tools && tools.length > 0
+                ? tools.map(toAnthropicTool)
+                : undefined;
+        // ── Prompt caching branch ──────────────────────────────────────
+        // When enabled: system becomes a TextBlockParam[] with cache_control,
+        // and breakpoints are attached to the final block of up to the last 3
+        // messages (total capped at 4 across system + messages).
+        // When disabled: plain-string system and unmodified messages (C3 guard).
+        const cachedSystem = this.promptCaching && system !== undefined
+            ? buildCachedSystem(system)
+            : system;
+        const cachedMessages = this.promptCaching
+            ? attachMessageBreakpoints(anthropicMessages)
+            : anthropicMessages;
         const response = await this.client.messages.create({
             model,
             max_tokens: maxTokens,
-            system,
-            messages: anthropicMessages,
+            system: cachedSystem,
+            messages: cachedMessages,
             tools: anthropicTools,
+            ...(effort !== undefined ? { output_config: { effort } } : {}),
+            ...(structured
+                ? {
+                    tool_choice: {
+                        type: "tool",
+                        name: "structured_output",
+                    },
+                }
+                : {}),
         });
         const { text, toolCalls } = normalizeContent(response.content);
+        const usage = {
+            inputTokens: response.usage.input_tokens,
+            outputTokens: response.usage.output_tokens,
+        };
+        // ── Structured output normalisation ─────────────────────────────
+        // Take the forced tool call's input, stringify it into text, and return
+        // empty toolCalls with a clean "end" stop reason. If the forced tool call
+        // is somehow absent, fall back to the normal normalized result so the
+        // caller's coerce/repair can still try.
+        if (structured) {
+            const forced = toolCalls.find((tc) => tc.name === "structured_output");
+            if (forced !== undefined) {
+                return {
+                    text: JSON.stringify(forced.input),
+                    toolCalls: [],
+                    stopReason: "end",
+                    usage,
+                };
+            }
+        }
         return {
             text,
             toolCalls,
             stopReason: normalizeStopReason(response.stop_reason),
-            usage: {
-                inputTokens: response.usage.input_tokens,
-                outputTokens: response.usage.output_tokens,
-            },
+            usage,
         };
     }
 }

package/dist/providers/anthropic.js.map

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

package/dist/providers/claude-code.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Claude Code subscription provider.
+ *
+ * Backs the LLMClient interface with the local `claude` CLI in headless
+ * print mode (`claude -p --output-format json`), so model calls bill against
+ * the user's Claude Pro/Max SUBSCRIPTION credit instead of an
+ * ANTHROPIC_API_KEY. No API key is read or required by this adapter.
+ *
+ * ─────────────────────────────────────────────────────────────────────────
+ * CAPABILITY BOUNDARY:
+ *
+ * agent-bober drives its OWN agentic loop: chat() is contracted to take MY
+ * tools, return ONE model turn, stop at tool_use, and let the caller execute
+ * the tool. The `claude` CLI does the OPPOSITE — it runs ITS OWN loop with
+ * ITS OWN built-in tools (Read/Write/Bash) and never hands custom tool_use
+ * blocks back. There is no faithful single-turn-with-my-tools mode.
+ *
+ * Therefore this adapter supports ONLY the no-tools case (system + messages
+ * → text). That covers the pure prompt→text roles (planner, researcher
+ * question-gen). If `params.tools` is non-empty it THROWS rather than
+ * silently dropping the tools and corrupting the caller's loop.
+ *
+ * COST CAVEAT: `claude -p` injects Claude Code's full system prompt
+ * (~40k cache-creation tokens) on every call, and post-2026-06-15 these calls
+ * bill at standard API rates against a capped monthly subscription credit
+ * (Max 5×=$100/mo, 20×=$200/mo, no rollover). This path is NOT free-unlimited.
+ *
+ * TERMS: programmatic subscription use via `claude -p` is permitted by
+ * Anthropic as of 2026-06-15, billed from the separate Agent-SDK/CLI credit.
+ * Verify current terms before relying on it at scale.
+ * ─────────────────────────────────────────────────────────────────────────
+ */
+import type { LLMClient, ChatParams, ChatResponse } from "./types.js";
+export declare class ClaudeCodeAdapter implements LLMClient {
+    private readonly binary;
+    private readonly timeoutMs;
+    /**
+     * @param binary    Path/name of the claude CLI (default "claude").
+     * @param timeoutMs Per-call timeout. Default 180s (sprints make long calls).
+     */
+    constructor(binary?: string, timeoutMs?: number);
+    chat(params: ChatParams): Promise<ChatResponse>;
+}
+//# sourceMappingURL=claude-code.d.ts.map

package/dist/providers/claude-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.d.ts","sourceRoot":"","sources":["../../src/providers/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EAEb,MAAM,YAAY,CAAC;AAyDpB,qBAAa,iBAAkB,YAAW,SAAS;IAM/C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAN5B;;;OAGG;gBAEgB,MAAM,GAAE,MAAiB,EACzB,SAAS,GAAE,MAAgB;IAGxC,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;CA0EtD"}

package/dist/providers/claude-code.js

@@ -0,0 +1,143 @@
+/**
+ * Claude Code subscription provider.
+ *
+ * Backs the LLMClient interface with the local `claude` CLI in headless
+ * print mode (`claude -p --output-format json`), so model calls bill against
+ * the user's Claude Pro/Max SUBSCRIPTION credit instead of an
+ * ANTHROPIC_API_KEY. No API key is read or required by this adapter.
+ *
+ * ─────────────────────────────────────────────────────────────────────────
+ * CAPABILITY BOUNDARY:
+ *
+ * agent-bober drives its OWN agentic loop: chat() is contracted to take MY
+ * tools, return ONE model turn, stop at tool_use, and let the caller execute
+ * the tool. The `claude` CLI does the OPPOSITE — it runs ITS OWN loop with
+ * ITS OWN built-in tools (Read/Write/Bash) and never hands custom tool_use
+ * blocks back. There is no faithful single-turn-with-my-tools mode.
+ *
+ * Therefore this adapter supports ONLY the no-tools case (system + messages
+ * → text). That covers the pure prompt→text roles (planner, researcher
+ * question-gen). If `params.tools` is non-empty it THROWS rather than
+ * silently dropping the tools and corrupting the caller's loop.
+ *
+ * COST CAVEAT: `claude -p` injects Claude Code's full system prompt
+ * (~40k cache-creation tokens) on every call, and post-2026-06-15 these calls
+ * bill at standard API rates against a capped monthly subscription credit
+ * (Max 5×=$100/mo, 20×=$200/mo, no rollover). This path is NOT free-unlimited.
+ *
+ * TERMS: programmatic subscription use via `claude -p` is permitted by
+ * Anthropic as of 2026-06-15, billed from the separate Agent-SDK/CLI credit.
+ * Verify current terms before relying on it at scale.
+ * ─────────────────────────────────────────────────────────────────────────
+ */
+import { execa } from "execa";
+/** Map the CLI's stop_reason onto agent-bober's normalized StopReason. */
+function mapStopReason(raw) {
+    switch (raw) {
+        case "end_turn":
+            return "end";
+        case "tool_use":
+            return "tool_use";
+        case "max_tokens":
+            return "max_tokens";
+        default:
+            return raw ?? "end";
+    }
+}
+/**
+ * Flatten the provider-agnostic Message[] into a single prompt string for the
+ * CLI's `-p` argument. The CLI takes one prompt, not a structured transcript,
+ * so we render the conversation as labelled turns. Adequate for the no-tools
+ * roles this adapter targets; NOT a faithful multi-turn tool transcript.
+ */
+function flattenMessages(messages) {
+    const parts = [];
+    for (const m of messages) {
+        if ("systemUpdate" in m) {
+            parts.push(`[system update]\n${m.systemUpdate}`);
+        }
+        else if ("toolResults" in m) {
+            // No-tools adapter: tool results shouldn't occur, but render defensively.
+            for (const r of m.toolResults) {
+                parts.push(`[tool result ${r.toolUseId}]\n${r.content}`);
+            }
+        }
+        else if (m.role === "assistant") {
+            parts.push(`Assistant: ${m.content}`);
+        }
+        else {
+            parts.push(`User: ${m.content}`);
+        }
+    }
+    return parts.join("\n\n");
+}
+export class ClaudeCodeAdapter {
+    binary;
+    timeoutMs;
+    /**
+     * @param binary    Path/name of the claude CLI (default "claude").
+     * @param timeoutMs Per-call timeout. Default 180s (sprints make long calls).
+     */
+    constructor(binary = "claude", timeoutMs = 180_000) {
+        this.binary = binary;
+        this.timeoutMs = timeoutMs;
+    }
+    async chat(params) {
+        const { system, messages, tools, model } = params;
+        // Hard fail on tools — see SPIKE SCOPE. Silent drop would corrupt the
+        // caller's agentic loop (it would wait forever for tool_use that can't come).
+        if (tools && tools.length > 0) {
+            throw new Error("ClaudeCodeAdapter (spike) does not support custom tools: the `claude` " +
+                "CLI runs its own tool loop and cannot return custom tool_use blocks. " +
+                "Use this provider only for prompt→text roles (e.g. planner), or use " +
+                "the anthropic/openai-compat providers for tool-driven roles.");
+        }
+        const prompt = flattenMessages(messages);
+        const args = [
+            "-p",
+            prompt,
+            "--output-format",
+            "json",
+            // Disable Claude Code's built-in tools — we want pure completion, not its loop.
+            "--disallowed-tools",
+            "Read Edit Write Bash Glob Grep WebFetch WebSearch Task",
+            // Don't inherit the project's MCP servers (keeps the call hermetic).
+            "--strict-mcp-config",
+        ];
+        if (system && system.trim().length > 0) {
+            args.push("--append-system-prompt", system);
+        }
+        if (model) {
+            args.push("--model", model);
+        }
+        const result = await execa(this.binary, args, {
+            reject: false,
+            timeout: this.timeoutMs,
+            // No stdin; everything is in args.
+            input: "",
+        });
+        if (result.exitCode !== 0) {
+            throw new Error(`claude CLI exited ${String(result.exitCode)}: ${result.stderr || result.stdout || "no output"}`);
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(result.stdout);
+        }
+        catch {
+            throw new Error(`claude CLI returned non-JSON output: ${result.stdout.slice(0, 200)}`);
+        }
+        if (parsed.is_error) {
+            throw new Error(`claude CLI reported an error: ${parsed.result ?? parsed.subtype ?? "unknown"}`);
+        }
+        return {
+            text: parsed.result ?? "",
+            toolCalls: [],
+            stopReason: mapStopReason(parsed.stop_reason),
+            usage: {
+                inputTokens: parsed.usage?.input_tokens ?? 0,
+                outputTokens: parsed.usage?.output_tokens ?? 0,
+            },
+        };
+    }
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/providers/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../src/providers/claude-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAwB9B,0EAA0E;AAC1E,SAAS,aAAa,CAAC,GAAuB;IAC5C,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,UAAU;YACb,OAAO,KAAK,CAAC;QACf,KAAK,UAAU;YACb,OAAO,UAAU,CAAC;QACpB,KAAK,YAAY;YACf,OAAO,YAAY,CAAC;QACtB;YACE,OAAO,GAAG,IAAI,KAAK,CAAC;IACxB,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,SAAS,eAAe,CAAC,QAAgC;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;QACnD,CAAC;aAAM,IAAI,aAAa,IAAI,CAAC,EAAE,CAAC;YAC9B,0EAA0E;YAC1E,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC9B,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,OAAO,iBAAiB;IAMT;IACA;IANnB;;;OAGG;IACH,YACmB,SAAiB,QAAQ,EACzB,YAAoB,OAAO;QAD3B,WAAM,GAAN,MAAM,CAAmB;QACzB,cAAS,GAAT,SAAS,CAAkB;IAC3C,CAAC;IAEJ,KAAK,CAAC,IAAI,CAAC,MAAkB;QAC3B,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAElD,sEAAsE;QACtE,8EAA8E;QAC9E,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CACb,wEAAwE;gBACtE,uEAAuE;gBACvE,sEAAsE;gBACtE,8DAA8D,CACjE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;QAEzC,MAAM,IAAI,GAAG;YACX,IAAI;YACJ,MAAM;YACN,iBAAiB;YACjB,MAAM;YACN,gFAAgF;YAChF,oBAAoB;YACpB,wDAAwD;YACxD,qEAAqE;YACrE,qBAAqB;SACtB,CAAC;QACF,IAAI,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE;YAC5C,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI,CAAC,SAAS;YACvB,mCAAmC;YACnC,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,qBAAqB,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAC1C,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,IAAI,WACpC,EAAE,CACH,CAAC;QACJ,CAAC;QAED,IAAI,MAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAoB,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,wCAAwC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACtE,CAAC;QACJ,CAAC;QAED,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CACb,iCAAiC,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,SAAS,EAAE,CAChF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YACzB,SAAS,EAAE,EAAE;YACb,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC;YAC7C,KAAK,EAAE;gBACL,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,YAAY,IAAI,CAAC;gBAC5C,YAAY,EAAE,MAAM,CAAC,KAAK,EAAE,aAAa,IAAI,CAAC;aAC/C;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/providers/factory.d.ts

@@ -2,16 +2,30 @@ import type { LLMClient } from "./types.js";
 /**
  * The set of provider names currently supported.
  */
-export type ProviderName = "anthropic" | "openai" | "google" | "openai-compat";
+export type ProviderName = "anthropic" | "openai" | "google" | "openai-compat" | "claude-code";
+/**
+ * Injectable probe function for verifying the claude CLI is on PATH.
+ * Defaults to an execa-based check; override in tests to avoid real CLI calls.
+ */
+export type BinaryProbe = (binary: string) => Promise<boolean>;
+/**
+ * Verify the claude CLI binary is on PATH. Throws an Error naming the binary
+ * when it is absent. Call this before using the claude-code provider.
+ *
+ * @param binary - CLI binary name/path (default "claude").
+ * @param probe - Injectable PATH-check function (default uses execa; override in tests).
+ */
+export declare function preflightClaudeBinary(binary?: string, probe?: BinaryProbe): Promise<void>;
 /**
  * Validate that the required API key environment variable is set for a given provider.
  *
  * @param resolvedProvider - The resolved provider name.
  * @param role - Optional role label (e.g. "Planner", "Generator", "Evaluator") for the error message.
  * @param apiKey - Optional explicit API key from providerConfig (skips env var check if set).
+ * @param endpoint - Optional endpoint URL used to distinguish DeepSeek from other openai-compat servers.
  * @throws If the required environment variable is missing and no explicit apiKey was provided.
  */
-export declare function validateApiKey(resolvedProvider: string, role?: string, apiKey?: string): void;
+export declare function validateApiKey(resolvedProvider: string, role?: string, apiKey?: string, endpoint?: string): void;
 /**
  * Create an LLMClient for the given provider.
  *

package/dist/providers/factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,CAAC;AAE/E;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CA4CN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,CAmEX"}
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/providers/factory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAA4B,MAAM,YAAY,CAAC;AAItE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,GAAG,aAAa,CAAC;AA6B/F;;;GAGG;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAW/D;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,SAAW,EACjB,KAAK,GAAE,WAAgC,GACtC,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,IAAI,CAAC,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,GAChB,IAAI,CA0DN;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EACxB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,KAAK,CAAC,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,MAAM,GACZ,SAAS,CAmGX"}