@bradtaylorsf/alpha-loop 1.13.1 → 1.14.1

package/dist/engine/agents.js

@@ -2,15 +2,17 @@
  * Agent Spawn Module
  * ==================
  *
- * Handles spawning different AI CLI agents (Claude, Codex, OpenCode)
+ * Handles spawning different AI CLI agents (Claude, Codex, OpenCode, LM Studio, Ollama)
  * with the correct CLI flags per agent type.
  *
+ * lmstudio and ollama piggy-back on existing CLIs: lmstudio uses the `claude`
+ * CLI pointed at an Anthropic-compatible local endpoint, ollama uses the
+ * `codex` CLI pointed at an OpenAI-compatible local endpoint. Endpoint
+ * selection is done via env vars (see `buildEndpointEnv`).
+ *
  * Adding a new agent: add a case to AGENT_CLI_MAP and buildAgentArgs().
  */
 import { spawn } from 'node:child_process';
-// ============================================================================
-// Agent CLI Mapping
-// ============================================================================
 /**
  * CLI reference for each supported agent.
  * Extend this map to add new agent types.
@@ -23,6 +25,7 @@ export const AGENT_CLI_MAP = {
         permissionFlag: '--dangerously-skip-permissions',
         supportsMaxTurns: true,
         maxTurnsFlag: '--max-turns',
+        isSubcommand: false,
     },
     codex: {
         command: 'codex',
@@ -30,12 +33,37 @@ export const AGENT_CLI_MAP = {
         modelFlag: '--model',
         permissionFlag: '--full-auto',
         supportsMaxTurns: false,
+        isSubcommand: true,
     },
     opencode: {
         command: 'opencode',
         promptFlag: 'run',
         modelFlag: '--model',
         supportsMaxTurns: false,
+        isSubcommand: true,
+    },
+    // lmstudio: LM Studio 0.4.1+ exposes an Anthropic-compatible /v1/messages
+    // endpoint, so we invoke the `claude` CLI and point it at the local server
+    // via ANTHROPIC_BASE_URL / ANTHROPIC_MODEL (see buildEndpointEnv).
+    lmstudio: {
+        command: 'claude',
+        promptFlag: '-p',
+        modelFlag: '--model',
+        permissionFlag: '--dangerously-skip-permissions',
+        supportsMaxTurns: true,
+        maxTurnsFlag: '--max-turns',
+        isSubcommand: false,
+    },
+    // ollama: Ollama exposes an OpenAI-compatible /v1/chat/completions endpoint,
+    // so we invoke the `codex` CLI and point it at the local server via
+    // OPENAI_BASE_URL / OPENAI_MODEL (see buildEndpointEnv).
+    ollama: {
+        command: 'codex',
+        promptFlag: 'exec',
+        modelFlag: '--model',
+        permissionFlag: '--full-auto',
+        supportsMaxTurns: false,
+        isSubcommand: true,
     },
 };
 /**
@@ -48,9 +76,7 @@ export function buildAgentArgs(config, prompt) {
         throw new Error(`Unknown agent type: "${config.agent}". Supported agents: ${Object.keys(AGENT_CLI_MAP).join(', ')}`);
     }
     const args = [];
-    // For agents that use subcommands (codex 'exec', opencode 'run'), add it first
-    const isSubcommand = config.agent === 'codex' || config.agent === 'opencode';
-    if (isSubcommand) {
+    if (agentDef.isSubcommand) {
         args.push(agentDef.promptFlag);
     }
     // Model flag (skip if empty — let agent CLI use its default)
@@ -66,7 +92,7 @@ export function buildAgentArgs(config, prompt) {
         args.push(agentDef.maxTurnsFlag, String(config.maxTurns));
     }
     // Prompt: subcommand agents take it as positional arg; flag agents use promptFlag
-    if (isSubcommand) {
+    if (agentDef.isSubcommand) {
         args.push(prompt);
     }
     else {
@@ -75,18 +101,76 @@ export function buildAgentArgs(config, prompt) {
     return { command: agentDef.command, args };
 }
 // ============================================================================
+// Endpoint Env Vars
+// ============================================================================
+/**
+ * Build the env-var overrides needed to point a child CLI at a specific
+ * routing endpoint. Anthropic-shaped endpoints (`anthropic`, `anthropic_compat`)
+ * set ANTHROPIC_BASE_URL / ANTHROPIC_MODEL; OpenAI-compatible endpoints set
+ * OPENAI_BASE_URL / OPENAI_MODEL.
+ *
+ * Callers MUST compute this per stage and not share envs across stages, so
+ * that a frontier stage does not inherit a local endpoint from a prior stage.
+ */
+export function buildEndpointEnv(endpoint, model) {
+    const env = {};
+    if (!endpoint || !endpoint.base_url)
+        return env;
+    switch (endpoint.type) {
+        case 'anthropic':
+        case 'anthropic_compat':
+            env.ANTHROPIC_BASE_URL = endpoint.base_url;
+            if (model)
+                env.ANTHROPIC_MODEL = model;
+            break;
+        case 'openai_compat':
+            env.OPENAI_BASE_URL = endpoint.base_url;
+            if (model)
+                env.OPENAI_MODEL = model;
+            break;
+    }
+    return env;
+}
+/** Default base URLs for single-agent lmstudio/ollama mode. */
+export const DEFAULT_LMSTUDIO_BASE_URL = 'http://localhost:1234';
+export const DEFAULT_OLLAMA_BASE_URL = 'http://localhost:11434/v1';
+/**
+ * Auto-injected env vars for single-agent `lmstudio` / `ollama` mode, so
+ * `agent: lmstudio` actually targets the local server instead of silently
+ * hitting the real Anthropic API. Respects pre-existing env vars — users who
+ * export `ANTHROPIC_BASE_URL` themselves keep full control.
+ */
+function defaultLocalEnv(agent, model) {
+    const env = {};
+    if (agent === 'lmstudio') {
+        if (!process.env.ANTHROPIC_BASE_URL)
+            env.ANTHROPIC_BASE_URL = DEFAULT_LMSTUDIO_BASE_URL;
+        if (model && !process.env.ANTHROPIC_MODEL)
+            env.ANTHROPIC_MODEL = model;
+    }
+    else if (agent === 'ollama') {
+        if (!process.env.OPENAI_BASE_URL)
+            env.OPENAI_BASE_URL = DEFAULT_OLLAMA_BASE_URL;
+        if (model && !process.env.OPENAI_MODEL)
+            env.OPENAI_MODEL = model;
+    }
+    return env;
+}
+// ============================================================================
 // Spawn Agent
 // ============================================================================
 /**
  * Spawns an agent subprocess with the correct CLI flags.
  * Returns the ChildProcess for the caller to manage (listen to events, pipe stdio, etc.).
  */
-export function spawnAgent(config, prompt, cwd) {
+export function spawnAgent(config, prompt, cwd, envOverrides) {
     const { command, args } = buildAgentArgs(config, prompt);
+    // Caller overrides win > agent-default local base URLs > process.env
+    const localDefaults = defaultLocalEnv(config.agent, config.model);
     return spawn(command, args, {
         cwd,
         stdio: ['pipe', 'pipe', 'pipe'],
-        env: { ...process.env },
+        env: { ...process.env, ...localDefaults, ...envOverrides },
     });
 }
 //# sourceMappingURL=agents.js.map

package/dist/engine/agents.js.map

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

package/dist/engine/prerequisites.d.ts

@@ -4,7 +4,7 @@
  *
  * Verifies that the configured AI CLI agent is installed before starting the pipeline.
  */
-import type { Config } from '../lib/config.js';
+import type { Config, RoutingStageName } from '../lib/config.js';
 export interface AgentCheckResult {
     agent: string;
     installed: boolean;
@@ -18,7 +18,9 @@ export interface PrerequisiteResult {
  */
 export declare function isCommandAvailable(command: string): boolean;
 /**
- * Checks that the configured agent CLI is installed.
+ * Checks that the configured agent CLI is installed. lmstudio/ollama
+ * piggy-back on the claude/codex CLIs, so we probe those instead of looking
+ * for a literal "lmstudio" / "ollama" binary on PATH.
  */
 export declare function checkAgents(config: Config): PrerequisiteResult;
 /**
@@ -29,3 +31,39 @@ export declare function formatCheckResults(result: PrerequisiteResult): string;
  * Formats the pipeline startup summary.
  */
 export declare function formatPipelineSummary(config: Config): string;
+export interface LocalModelCheckResult {
+    ok: boolean;
+    /** List of model ids reported by the endpoint's /v1/models response. */
+    loaded: string[];
+    error?: string;
+}
+/**
+ * Return true when the endpoint's base_url looks like a local/loopback server
+ * — i.e. a check against it should be cheap and safe to run on every stage
+ * start. Remote endpoints (api.anthropic.com etc.) aren't probed here.
+ */
+export declare function isLocalEndpoint(baseUrl: string): boolean;
+/**
+ * Verify that a local model server (LM Studio, Ollama, vLLM, etc.) is reachable
+ * at `baseUrl` and is currently serving `model`. Uses the OpenAI-compatible
+ * `/v1/models` response shape, which both LM Studio and Ollama expose even for
+ * their Anthropic-compatible endpoints.
+ *
+ * Returns `{ ok: true }` iff the model id appears in the response. Otherwise
+ * returns an actionable error describing what to do next.
+ */
+export declare function checkLocalModel(baseUrl: string, model: string): Promise<LocalModelCheckResult>;
+export interface StagePrerequisiteResult {
+    ok: boolean;
+    /** Undefined when no local endpoint check was needed. */
+    checked?: boolean;
+    error?: string;
+}
+/**
+ * Verify that the configured routing target for a stage is reachable before
+ * the stage runs. No-op when the stage has no routing override or when the
+ * resolved endpoint is remote. Returns an actionable error like
+ * "Start LM Studio and load model <model>" when the local server is down or
+ * the expected model isn't loaded.
+ */
+export declare function checkStagePrerequisites(config: Config, stage: RoutingStageName): Promise<StagePrerequisiteResult>;

package/dist/engine/prerequisites.js

@@ -5,6 +5,7 @@
  * Verifies that the configured AI CLI agent is installed before starting the pipeline.
  */
 import { execSync } from 'node:child_process';
+import { resolveRoutingStage } from '../lib/config.js';
 // ============================================================================
 // Agent Check
 // ============================================================================
@@ -25,12 +26,17 @@ export function isCommandAvailable(command) {
     }
 }
 /**
- * Checks that the configured agent CLI is installed.
+ * Checks that the configured agent CLI is installed. lmstudio/ollama
+ * piggy-back on the claude/codex CLIs, so we probe those instead of looking
+ * for a literal "lmstudio" / "ollama" binary on PATH.
  */
 export function checkAgents(config) {
+    const cliCommand = config.agent === 'lmstudio' ? 'claude'
+        : config.agent === 'ollama' ? 'codex'
+            : config.agent;
     const result = {
         agent: config.agent,
-        installed: isCommandAvailable(config.agent),
+        installed: isCommandAvailable(cliCommand),
     };
     return {
         ok: result.installed,
@@ -63,4 +69,122 @@ export function formatCheckResults(result) {
 export function formatPipelineSummary(config) {
     return `Pipeline: ${config.agent}/${config.model}`;
 }
+/**
+ * Compose the /v1/models URL for an endpoint base URL. Accepts base URLs
+ * with or without a trailing `/v1` segment.
+ */
+function buildModelsUrl(baseUrl) {
+    const base = baseUrl.replace(/\/+$/, '');
+    return /\/v1$/.test(base) ? `${base}/models` : `${base}/v1/models`;
+}
+/**
+ * Return true when the endpoint's base_url looks like a local/loopback server
+ * — i.e. a check against it should be cheap and safe to run on every stage
+ * start. Remote endpoints (api.anthropic.com etc.) aren't probed here.
+ */
+export function isLocalEndpoint(baseUrl) {
+    try {
+        // URL.hostname wraps IPv6 addresses in brackets (e.g. "[::1]") — strip them.
+        const host = new URL(baseUrl).hostname.replace(/^\[|\]$/g, '');
+        return (host === 'localhost' ||
+            host === '127.0.0.1' ||
+            host === '::1' ||
+            host === '0.0.0.0' ||
+            host.endsWith('.local'));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Verify that a local model server (LM Studio, Ollama, vLLM, etc.) is reachable
+ * at `baseUrl` and is currently serving `model`. Uses the OpenAI-compatible
+ * `/v1/models` response shape, which both LM Studio and Ollama expose even for
+ * their Anthropic-compatible endpoints.
+ *
+ * Returns `{ ok: true }` iff the model id appears in the response. Otherwise
+ * returns an actionable error describing what to do next.
+ */
+export async function checkLocalModel(baseUrl, model) {
+    if (!baseUrl) {
+        return { ok: false, loaded: [], error: 'Missing base URL' };
+    }
+    const url = buildModelsUrl(baseUrl);
+    let res;
+    try {
+        res = await fetch(url);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { ok: false, loaded: [], error: `Could not reach ${url}: ${msg}` };
+    }
+    if (!res.ok) {
+        return { ok: false, loaded: [], error: `HTTP ${res.status} from ${url}` };
+    }
+    let body;
+    try {
+        body = await res.json();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { ok: false, loaded: [], error: `Invalid JSON from ${url}: ${msg}` };
+    }
+    const data = body?.data;
+    const loaded = Array.isArray(data)
+        ? data
+            .map((m) => (typeof m?.id === 'string' ? m.id : ''))
+            .filter((s) => s.length > 0)
+        : [];
+    if (!model) {
+        return { ok: false, loaded, error: 'No model specified' };
+    }
+    if (!loaded.includes(model)) {
+        const available = loaded.length > 0 ? loaded.join(', ') : '(none)';
+        return {
+            ok: false,
+            loaded,
+            error: `Model "${model}" is not loaded at ${baseUrl}. Available: ${available}`,
+        };
+    }
+    return { ok: true, loaded };
+}
+/** Friendly label for common local endpoints, for use in error messages. */
+function endpointLabel(endpoint) {
+    try {
+        const port = new URL(endpoint.base_url).port;
+        if (port === '1234')
+            return 'LM Studio';
+        if (port === '11434')
+            return 'Ollama';
+    }
+    catch {
+        // fall through
+    }
+    return 'Local model server';
+}
+/**
+ * Verify that the configured routing target for a stage is reachable before
+ * the stage runs. No-op when the stage has no routing override or when the
+ * resolved endpoint is remote. Returns an actionable error like
+ * "Start LM Studio and load model <model>" when the local server is down or
+ * the expected model isn't loaded.
+ */
+export async function checkStagePrerequisites(config, stage) {
+    const resolved = resolveRoutingStage(config, stage);
+    if (!resolved || !resolved.endpoint)
+        return { ok: true };
+    const endpoint = resolved.endpoint;
+    if (!isLocalEndpoint(endpoint.base_url))
+        return { ok: true };
+    const result = await checkLocalModel(endpoint.base_url, resolved.model);
+    if (result.ok)
+        return { ok: true, checked: true };
+    const label = endpointLabel(endpoint);
+    const actionable = `Start ${label} and load model ${resolved.model}`;
+    return {
+        ok: false,
+        checked: true,
+        error: `${actionable} (${result.error ?? 'server did not respond'})`,
+    };
+}
 //# sourceMappingURL=prerequisites.js.map

package/dist/engine/prerequisites.js.map

@@ -1 +1 @@
-{"version":3,"file":"prerequisites.js","sourceRoot":"","sources":["../../src/engine/prerequisites.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAiB9C,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAe;IAChD,+EAA+E;IAC/E,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACtC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,CAAC;QACH,QAAQ,CAAC,SAAS,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,MAAM,GAAqB;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,SAAS,EAAE,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC;KAC5C,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,SAAS;QACpB,OAAO,EAAE,CAAC,MAAM,CAAC;KAClB,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,MAAM,KAAK,GAAa,CAAC,oBAAoB,CAAC,CAAC;IAE/C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACzD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,KAAK,qBAAqB,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAc;IAClD,OAAO,aAAa,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;AACrD,CAAC"}
+{"version":3,"file":"prerequisites.js","sourceRoot":"","sources":["../../src/engine/prerequisites.ts"],"names":[],"mappings":"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"}

package/dist/lib/agent.d.ts

@@ -1,3 +1,10 @@
+import type { RoutingEndpoint } from './config.js';
+/**
+ * Supported agent CLI shapes. `lmstudio` piggy-backs on the `claude` CLI (since
+ * LM Studio exposes an Anthropic-compatible endpoint); `ollama` piggy-backs on
+ * the `codex` CLI (OpenAI-compatible).
+ */
+export type AgentType = 'claude' | 'codex' | 'opencode' | 'lmstudio' | 'ollama';
 export type AgentResult = {
     exitCode: number;
     output: string;
@@ -10,9 +17,13 @@ export type AgentResult = {
     outputTokens?: number;
     /** Model used for the invocation. */
     model?: string;
+    /** Number of tool_use blocks emitted during the run. */
+    toolCalls?: number;
+    /** Number of tool_result blocks with is_error === true. */
+    toolErrors?: number;
 };
 export type AgentOptions = {
-    agent: 'claude' | 'codex' | 'opencode';
+    agent: AgentType;
     model: string;
     prompt: string;
     cwd: string;
@@ -24,9 +35,19 @@ export type AgentOptions = {
     maxTurns?: number;
     /** Resume the most recent agent session in the CWD instead of starting fresh. */
     resume?: boolean;
+    /**
+     * Env-var overrides merged over `process.env` when spawning the child.
+     * Callers MUST compute this per stage (see `buildEndpointEnv`) so that a
+     * frontier stage does not inherit a local-endpoint env from a prior stage.
+     */
+    env?: Record<string, string>;
 };
 /**
  * Build CLI command and args for a given agent type.
+ *
+ * `lmstudio` delegates to the claude CLI shape (Anthropic-compatible); `ollama`
+ * delegates to the codex CLI shape (OpenAI-compatible). Endpoint selection is
+ * wired via env vars (see `buildEndpointEnv`), not CLI flags.
  */
 export declare function buildAgentArgs(options: AgentOptions): {
     command: string;
@@ -36,7 +57,23 @@ export declare function buildAgentArgs(options: AgentOptions): {
  * Build a shell command string for one-shot agent prompts (scan, vision).
  * Reads prompt from stdin. Returns the command to pipe into.
  */
-export declare function buildOneShotCommand(agent: 'claude' | 'codex' | 'opencode', model: string): string;
+export declare function buildOneShotCommand(agent: AgentType, model: string): string;
+/**
+ * Build the env-var overrides needed to point a child CLI at a specific
+ * routing endpoint. Anthropic-shaped endpoints set ANTHROPIC_BASE_URL /
+ * ANTHROPIC_MODEL; OpenAI-compatible endpoints set OPENAI_BASE_URL /
+ * OPENAI_MODEL.
+ *
+ * Callers MUST compute this per stage and not share envs across stages, so
+ * that a frontier stage does not inherit a local endpoint from a prior stage.
+ */
+export declare function buildEndpointEnv(endpoint: RoutingEndpoint, model: string): Record<string, string>;
+/**
+ * Default local-server base URLs for single-agent `lmstudio` / `ollama` mode.
+ * Exported so tests and callers can reference the same constants.
+ */
+export declare const DEFAULT_LMSTUDIO_BASE_URL = "http://localhost:1234";
+export declare const DEFAULT_OLLAMA_BASE_URL = "http://localhost:11434/v1";
 /**
  * Spawn an AI agent with a prompt.
  * Streams output to terminal in real-time while capturing it.

package/dist/lib/agent.js

@@ -4,6 +4,7 @@
 import { spawn } from 'node:child_process';
 import { createWriteStream } from 'node:fs';
 import { log } from './logger.js';
+import { classifyToolErrors } from './escalation.js';
 /**
  * Parse a Claude stream-json line into a human-readable log line.
  * Returns null for lines that shouldn't be logged.
@@ -69,10 +70,15 @@ function formatStreamJsonLine(line) {
 const DEFAULT_AGENT_TIMEOUT_MS = 30 * 60 * 1000;
 /**
  * Build CLI command and args for a given agent type.
+ *
+ * `lmstudio` delegates to the claude CLI shape (Anthropic-compatible); `ollama`
+ * delegates to the codex CLI shape (OpenAI-compatible). Endpoint selection is
+ * wired via env vars (see `buildEndpointEnv`), not CLI flags.
  */
 export function buildAgentArgs(options) {
     switch (options.agent) {
-        case 'claude': {
+        case 'claude':
+        case 'lmstudio': {
             const args = [];
             if (options.resume)
                 args.push('--continue');
@@ -85,7 +91,8 @@ export function buildAgentArgs(options) {
             }
             return { command: 'claude', args };
         }
-        case 'codex': {
+        case 'codex':
+        case 'ollama': {
             const args = [];
             if (options.resume) {
                 args.push('exec', 'resume', '--last');
@@ -114,14 +121,16 @@ export function buildAgentArgs(options) {
  */
 export function buildOneShotCommand(agent, model) {
     switch (agent) {
-        case 'claude': {
+        case 'claude':
+        case 'lmstudio': {
             const parts = ['claude', '-p'];
             if (model)
                 parts.push('--model', model);
             parts.push('--dangerously-skip-permissions', '--output-format', 'text');
             return parts.join(' ');
         }
-        case 'codex': {
+        case 'codex':
+        case 'ollama': {
             const parts = ['codex', 'exec'];
             if (model)
                 parts.push('--model', model);
@@ -138,6 +147,65 @@ export function buildOneShotCommand(agent, model) {
             throw new Error(`Unknown agent type: ${agent}`);
     }
 }
+/**
+ * Build the env-var overrides needed to point a child CLI at a specific
+ * routing endpoint. Anthropic-shaped endpoints set ANTHROPIC_BASE_URL /
+ * ANTHROPIC_MODEL; OpenAI-compatible endpoints set OPENAI_BASE_URL /
+ * OPENAI_MODEL.
+ *
+ * Callers MUST compute this per stage and not share envs across stages, so
+ * that a frontier stage does not inherit a local endpoint from a prior stage.
+ */
+export function buildEndpointEnv(endpoint, model) {
+    const env = {};
+    if (!endpoint || !endpoint.base_url)
+        return env;
+    switch (endpoint.type) {
+        case 'anthropic':
+        case 'anthropic_compat':
+            env.ANTHROPIC_BASE_URL = endpoint.base_url;
+            if (model)
+                env.ANTHROPIC_MODEL = model;
+            break;
+        case 'openai_compat':
+            env.OPENAI_BASE_URL = endpoint.base_url;
+            if (model)
+                env.OPENAI_MODEL = model;
+            break;
+    }
+    return env;
+}
+/**
+ * Default local-server base URLs for single-agent `lmstudio` / `ollama` mode.
+ * Exported so tests and callers can reference the same constants.
+ */
+export const DEFAULT_LMSTUDIO_BASE_URL = 'http://localhost:1234';
+export const DEFAULT_OLLAMA_BASE_URL = 'http://localhost:11434/v1';
+/**
+ * Auto-injected env vars for single-agent `lmstudio` / `ollama` mode.
+ *
+ * Without this, `agent: lmstudio` would spawn the claude CLI with no base URL
+ * override and silently hit the real Anthropic API. We only inject defaults
+ * when the corresponding env var isn't already set in the parent process, so
+ * users who export `ANTHROPIC_BASE_URL` / `OPENAI_BASE_URL` to point at a
+ * non-default port keep full control.
+ */
+function defaultLocalEnv(agent, model) {
+    const env = {};
+    if (agent === 'lmstudio') {
+        if (!process.env.ANTHROPIC_BASE_URL)
+            env.ANTHROPIC_BASE_URL = DEFAULT_LMSTUDIO_BASE_URL;
+        if (model && !process.env.ANTHROPIC_MODEL)
+            env.ANTHROPIC_MODEL = model;
+    }
+    else if (agent === 'ollama') {
+        if (!process.env.OPENAI_BASE_URL)
+            env.OPENAI_BASE_URL = DEFAULT_OLLAMA_BASE_URL;
+        if (model && !process.env.OPENAI_MODEL)
+            env.OPENAI_MODEL = model;
+    }
+    return env;
+}
 /**
  * Spawn an AI agent with a prompt.
  * Streams output to terminal in real-time while capturing it.
@@ -156,10 +224,18 @@ export async function spawnAgent(options) {
         logStream = createWriteStream(options.logFile, { flags: 'w' });
     }
     const timeoutMs = options.timeout ?? DEFAULT_AGENT_TIMEOUT_MS;
+    // Compose env: caller overrides win > agent-default local base URLs > process.env
+    const localDefaults = defaultLocalEnv(options.agent, options.model);
+    const hasOverrides = options.env && Object.keys(options.env).length > 0;
+    const hasLocalDefaults = Object.keys(localDefaults).length > 0;
+    const spawnEnv = hasOverrides || hasLocalDefaults
+        ? { ...process.env, ...localDefaults, ...(options.env ?? {}) }
+        : process.env;
     return new Promise((resolve) => {
         const child = spawn(command, args, {
             cwd: options.cwd,
             stdio: ['pipe', 'pipe', 'pipe'],
+            env: spawnEnv,
         });
         let resolved = false;
         // For stream-json: accumulate partial lines, extract final result text
@@ -169,6 +245,9 @@ export async function spawnAgent(options) {
         let parsedCostUsd;
         let parsedInputTokens;
         let parsedOutputTokens;
+        // Tool-use telemetry (per-stage metrics aggregation).
+        let toolUseCount = 0;
+        let toolErrorCount = 0;
         // Pipe prompt via stdin (like: echo "$prompt" | claude -p)
         child.stdin.write(options.prompt);
         child.stdin.end();
@@ -228,6 +307,22 @@ export async function spawnAgent(options) {
                                 parsedOutputTokens = usage.output_tokens;
                         }
                     }
+                    else if (obj.type === 'assistant') {
+                        const msg = obj.message;
+                        const content = (msg?.content ?? []);
+                        for (const block of content) {
+                            if (block.type === 'tool_use')
+                                toolUseCount++;
+                        }
+                    }
+                    else if (obj.type === 'user') {
+                        const msg = obj.message;
+                        const content = (msg?.content ?? []);
+                        for (const block of content) {
+                            if (block.type === 'tool_result' && block.is_error === true)
+                                toolErrorCount++;
+                        }
+                    }
                 }
                 catch { /* not valid JSON, ignore */ }
                 const formatted = formatStreamJsonLine(line);
@@ -264,6 +359,11 @@ export async function spawnAgent(options) {
             resolved = true;
             clearTimeout(timer);
             const duration = Date.now() - startTime;
+            // Fall back to output-string classification when we didn't see structured
+            // tool_result error blocks (e.g. non-stream-json agents like codex).
+            const toolErrorsFinal = toolErrorCount > 0
+                ? toolErrorCount
+                : classifyToolErrors(output).length;
             const result = {
                 exitCode,
                 output,
@@ -272,6 +372,8 @@ export async function spawnAgent(options) {
                 costUsd: parsedCostUsd,
                 inputTokens: parsedInputTokens,
                 outputTokens: parsedOutputTokens,
+                toolCalls: toolUseCount,
+                toolErrors: toolErrorsFinal,
             };
             if (logStream) {
                 logStream.end(() => {