@promptwheel/core 0.6.0

package/dist/scout/mcp-batch-server.js

@@ -0,0 +1,144 @@
+/**
+ * MCP Batch Server for persistent Codex sessions
+ *
+ * A lightweight stdio MCP server that exposes batch analysis tools.
+ * Codex connects to this server and loops: get_next_batch → analyze → submit_results.
+ *
+ * Usage:
+ *   node dist/scout/mcp-batch-server.js --data <path-to-json>
+ *
+ * The JSON file contains an array of batch prompt strings.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+/**
+ * MCP server that serves batches to a Codex session.
+ *
+ * Tools exposed:
+ * - get_next_batch: Returns { batchId, prompt } or { done: true }
+ * - submit_results: Accepts { batchId, output }
+ * - signal_done: Confirms all batches processed
+ */
+export class McpBatchServer {
+    batches;
+    cursor = 0;
+    results = new Map();
+    doneResolve;
+    server;
+    constructor(opts) {
+        this.batches = opts.batchPrompts.map((p, i) => ({ id: i, prompt: p }));
+        this.server = new Server({ name: 'promptwheel-batch-server', version: '1.0.0' }, { capabilities: { tools: {} } });
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => ({
+            tools: [
+                {
+                    name: 'get_next_batch',
+                    description: 'Get the next batch of code to analyze. Returns { batchId, prompt } or { done: true } when all batches are consumed.',
+                    inputSchema: { type: 'object', properties: {} },
+                },
+                {
+                    name: 'submit_results',
+                    description: 'Submit analysis results for a batch. Pass the raw JSON output from your analysis.',
+                    inputSchema: {
+                        type: 'object',
+                        properties: {
+                            batchId: { type: 'number', description: 'The batchId from get_next_batch' },
+                            output: { type: 'string', description: 'The analysis output (JSON string with proposals)' },
+                        },
+                        required: ['batchId', 'output'],
+                    },
+                },
+                {
+                    name: 'signal_done',
+                    description: 'Signal that all batches have been processed. Call this after the last submit_results.',
+                    inputSchema: { type: 'object', properties: {} },
+                },
+            ],
+        }));
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            switch (name) {
+                case 'get_next_batch': {
+                    if (this.cursor >= this.batches.length) {
+                        return { content: [{ type: 'text', text: JSON.stringify({ done: true }) }] };
+                    }
+                    const batch = this.batches[this.cursor++];
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify({ batchId: batch.id, prompt: batch.prompt }) }],
+                    };
+                }
+                case 'submit_results': {
+                    const batchId = args?.batchId;
+                    const output = args?.output;
+                    if (batchId === undefined || output === undefined) {
+                        return { content: [{ type: 'text', text: JSON.stringify({ error: 'batchId and output are required' }) }], isError: true };
+                    }
+                    this.results.set(batchId, output);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify({ ok: true, received: this.results.size, total: this.batches.length }) }],
+                    };
+                }
+                case 'signal_done': {
+                    this.doneResolve?.();
+                    return { content: [{ type: 'text', text: JSON.stringify({ ok: true }) }] };
+                }
+                default:
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: `Unknown tool: ${name}` }) }], isError: true };
+            }
+        });
+    }
+    /**
+     * Start the MCP server on stdio.
+     * Returns a promise that resolves with collected results when signal_done is called.
+     */
+    async start() {
+        const donePromise = new Promise((resolve) => {
+            this.doneResolve = resolve;
+        });
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+        await donePromise;
+        await this.server.close();
+        return this.results;
+    }
+}
+/**
+ * CLI entrypoint: node mcp-batch-server.js --data <path>
+ *
+ * The data file is a JSON array of prompt strings.
+ */
+async function main() {
+    const dataIdx = process.argv.indexOf('--data');
+    if (dataIdx === -1 || !process.argv[dataIdx + 1]) {
+        process.stderr.write('Usage: mcp-batch-server --data <path-to-prompts.json>\n');
+        process.exit(1);
+    }
+    const dataPath = process.argv[dataIdx + 1];
+    const prompts = JSON.parse(readFileSync(dataPath, 'utf-8'));
+    const server = new McpBatchServer({ batchPrompts: prompts });
+    const results = await server.start();
+    // Write results to disk so the parent process can read them.
+    // Derive the output directory from --results-dir arg or fall back to the
+    // same directory as the --data file.
+    const resultsDirIdx = process.argv.indexOf('--results-dir');
+    const resultsDir = (resultsDirIdx !== -1 && process.argv[resultsDirIdx + 1])
+        ? process.argv[resultsDirIdx + 1]
+        : dirname(dataPath);
+    const resultsObj = {};
+    for (const [k, v] of results) {
+        resultsObj[String(k)] = v;
+    }
+    writeFileSync(join(resultsDir, 'results.json'), JSON.stringify(resultsObj));
+}
+// Run as CLI if executed directly
+const isMainModule = process.argv[1]?.endsWith('mcp-batch-server.js') ||
+    process.argv[1]?.endsWith('mcp-batch-server.ts');
+if (isMainModule) {
+    main().catch((err) => {
+        process.stderr.write(`MCP batch server error: ${err}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=mcp-batch-server.js.map

package/dist/scout/mcp-batch-server.js.map

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

package/dist/scout/openai-local-runner.d.ts

@@ -0,0 +1,20 @@
+/**
+ * OpenAI-compatible local scout backend
+ *
+ * Uses raw fetch against any OpenAI-compatible API (Ollama, vLLM, SGLang, LM Studio).
+ * Zero new dependencies — uses Node's built-in fetch.
+ */
+import type { ScoutBackend, RunnerOptions, RunnerResult } from './runner.js';
+export declare class OpenAILocalScoutBackend implements ScoutBackend {
+    readonly name = "openai-local";
+    private baseUrl;
+    private model;
+    private apiKey?;
+    constructor(opts: {
+        baseUrl: string;
+        model: string;
+        apiKey?: string;
+    });
+    run(options: RunnerOptions): Promise<RunnerResult>;
+}
+//# sourceMappingURL=openai-local-runner.d.ts.map

package/dist/scout/openai-local-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-local-runner.d.ts","sourceRoot":"","sources":["../../src/scout/openai-local-runner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE7E,qBAAa,uBAAwB,YAAW,YAAY;IAC1D,QAAQ,CAAC,IAAI,kBAAkB;IAC/B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAC,CAAS;gBAEZ,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IAM/D,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAwEzD"}

package/dist/scout/openai-local-runner.js

@@ -0,0 +1,82 @@
+/**
+ * OpenAI-compatible local scout backend
+ *
+ * Uses raw fetch against any OpenAI-compatible API (Ollama, vLLM, SGLang, LM Studio).
+ * Zero new dependencies — uses Node's built-in fetch.
+ */
+export class OpenAILocalScoutBackend {
+    name = 'openai-local';
+    baseUrl;
+    model;
+    apiKey;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, '');
+        this.model = opts.model;
+        this.apiKey = opts.apiKey;
+    }
+    async run(options) {
+        const { prompt, timeoutMs, signal } = options;
+        const start = Date.now();
+        if (signal?.aborted) {
+            return { success: false, output: '', error: 'Aborted before start', durationMs: 0 };
+        }
+        // Combine external signal with timeout
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), timeoutMs);
+        const abortHandler = () => controller.abort();
+        signal?.addEventListener('abort', abortHandler);
+        try {
+            const headers = {
+                'Content-Type': 'application/json',
+            };
+            if (this.apiKey) {
+                headers['Authorization'] = `Bearer ${this.apiKey}`;
+            }
+            const response = await fetch(`${this.baseUrl}/chat/completions`, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({
+                    model: this.model,
+                    messages: [{ role: 'user', content: prompt }],
+                    temperature: 0,
+                }),
+                signal: controller.signal,
+            });
+            const durationMs = Date.now() - start;
+            if (!response.ok) {
+                const body = await response.text().catch(() => '');
+                return {
+                    success: false,
+                    output: '',
+                    error: `HTTP ${response.status}: ${body.slice(0, 500)}`,
+                    durationMs,
+                };
+            }
+            const data = (await response.json());
+            const content = data.choices?.[0]?.message?.content ?? '';
+            return {
+                success: true,
+                output: content,
+                durationMs,
+            };
+        }
+        catch (err) {
+            const durationMs = Date.now() - start;
+            const message = err instanceof Error ? err.message : String(err);
+            const isAbort = message.includes('abort') || message.includes('AbortError');
+            return {
+                success: false,
+                output: '',
+                error: isAbort
+                    ? (signal?.aborted ? 'Aborted by signal' : 'Timeout exceeded')
+                    : message,
+                durationMs,
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+            signal?.removeEventListener('abort', abortHandler);
+        }
+    }
+}
+//# sourceMappingURL=openai-local-runner.js.map

package/dist/scout/openai-local-runner.js.map

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

package/dist/scout/prompt.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Scout prompt template
+ *
+ * This prompt is sent to Claude to analyze code and generate improvement proposals.
+ */
+import type { ProposalCategory } from './types.js';
+/**
+ * Build the scout prompt for analyzing a batch of files
+ */
+export declare function buildScoutPrompt(options: {
+    files: Array<{
+        path: string;
+        content: string;
+    }>;
+    scope: string;
+    types?: ProposalCategory[];
+    excludeTypes?: ProposalCategory[];
+    maxProposals: number;
+    minConfidence: number;
+    recentlyCompletedTitles?: string[];
+    customPrompt?: string;
+    /** Files the scout can read but must NOT propose changes to */
+    protectedFiles?: string[];
+    /** Coverage context injected to give the scout awareness of scan progress */
+    coverageContext?: {
+        sectorPath: string;
+        scannedSectors: number;
+        totalSectors: number;
+        percent: number;
+        sectorPercent: number;
+        classificationConfidence: string;
+        scanCount: number;
+        proposalYield: number;
+        sectorSummary?: string;
+        sectorDifficulty?: 'easy' | 'moderate' | 'hard';
+        sectorCategoryAffinity?: {
+            boost: string[];
+            suppress: string[];
+        };
+    };
+}): string;
+/**
+ * Build a focused prompt for a single category
+ */
+export declare function buildCategoryPrompt(category: ProposalCategory, files: Array<{
+    path: string;
+    content: string;
+}>, maxProposals?: number): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/scout/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/scout/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE;IACxC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,6EAA6E;IAC7E,eAAe,CAAC,EAAE;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,EAAE,MAAM,CAAC;QACtB,wBAAwB,EAAE,MAAM,CAAC;QACjC,SAAS,EAAE,MAAM,CAAC;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,gBAAgB,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;QAChD,sBAAsB,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,EAAE,CAAC;YAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC;KAClE,CAAC;CACH,GAAG,MAAM,CAqJT;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,gBAAgB,EAC1B,KAAK,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/C,YAAY,GAAE,MAAU,GACvB,MAAM,CAQR"}

package/dist/scout/prompt.js

@@ -0,0 +1,153 @@
+/**
+ * Scout prompt template
+ *
+ * This prompt is sent to Claude to analyze code and generate improvement proposals.
+ */
+/**
+ * Build the scout prompt for analyzing a batch of files
+ */
+export function buildScoutPrompt(options) {
+    const { files, scope, types, excludeTypes, maxProposals, minConfidence, recentlyCompletedTitles, customPrompt, protectedFiles, coverageContext, } = options;
+    const protectedNote = protectedFiles?.length
+        ? `\n\n**DO NOT propose changes to these files** (read-only context): ${protectedFiles.join(', ')}\n`
+        : '';
+    const categoryFilter = types?.length
+        ? `Focus ONLY on these categories: ${types.join(', ')}`
+        : excludeTypes?.length
+            ? `EXCLUDE these categories: ${excludeTypes.join(', ')}`
+            : 'Consider all categories';
+    const coverageBlock = coverageContext
+        ? (() => {
+            const { sectorPath, scannedSectors, totalSectors, percent, sectorPercent, classificationConfidence, scanCount, proposalYield, sectorSummary } = coverageContext;
+            const lines = [
+                `\n## Coverage Context\n`,
+                `You are scanning sector "${sectorPath}" (scan #${scanCount + 1}).`,
+                `Classification confidence: ${classificationConfidence}.${classificationConfidence === 'low' ? ' This sector has not been reliably classified — pay attention to whether files are production code, tests, config, or generated.' : ''}`,
+                `Overall codebase coverage: ${scannedSectors}/${totalSectors} sectors scanned (${sectorPercent}% of sectors, ${percent}% of files).`,
+                `This sector's historical proposal density: ${proposalYield.toFixed(1)} proposals/scan.`,
+                '',
+            ];
+            if (coverageContext.sectorDifficulty === 'hard') {
+                lines.push('');
+                lines.push('**WARNING:** This sector has a HIGH failure rate. Propose only HIGH-confidence changes. Prefer simple fixes over complex refactors.');
+            }
+            if (coverageContext.sectorCategoryAffinity) {
+                const { boost, suppress } = coverageContext.sectorCategoryAffinity;
+                if (boost.length > 0) {
+                    lines.push(`Categories that work well in this sector: ${boost.join(', ')}.`);
+                }
+                if (suppress.length > 0) {
+                    lines.push(`Categories ${suppress.join(', ')} have low success in this sector — only propose if HIGH confidence.`);
+                }
+            }
+            if (percent < 50) {
+                lines.push('Many sectors remain unscanned. Focus on high-impact issues rather than minor cleanups.');
+            }
+            if (sectorSummary) {
+                lines.push('');
+                lines.push(sectorSummary);
+            }
+            return lines.join('\n') + '\n';
+        })()
+        : '';
+    const strategicFocus = customPrompt
+        ? `\n## Strategic Focus\n\n${customPrompt}\n`
+        : '';
+    const recentContext = recentlyCompletedTitles?.length
+        ? `\n\nAVOID proposing work similar to these recently completed tickets:\n${recentlyCompletedTitles.map(t => `- ${t}`).join('\n')}`
+        : '';
+    const fileContents = files
+        .map(f => `### ${f.path}\n\`\`\`\n${f.content}\n\`\`\``)
+        .join('\n\n');
+    return `You are a principal engineer reviewing code. Your job is to find improvements that meaningfully move the codebase forward — not cosmetic changes.
+
+Analyze these files from scope "${scope}" and identify the highest-impact improvements.
+
+${categoryFilter}
+${coverageBlock}
+## Categories (ordered by typical impact)
+
+- **security**: Vulnerabilities, SSRF/XSS/injection risks, auth gaps, input validation
+- **fix**: Bugs, incorrect logic, broken edge cases, data loss risks
+- **perf**: Performance issues, N+1 queries, unnecessary allocations, missing indexes
+- **refactor**: Structural issues spanning multiple files, missing abstractions, DRY violations across modules
+- **test**: Missing tests for critical paths, untested error handling, integration gaps
+- **types**: Type safety holes that could cause runtime errors
+- **cleanup**: Dead code removal, unused imports (ONLY if substantial)
+- **docs**: ONLY if documentation is actively misleading or missing for public APIs
+
+## Quality Bar
+
+Proposals must clear a high bar. Do NOT propose:
+- Comment rewording or typo fixes
+- Import reordering or style-only changes
+- Adding docs to internal code
+- Single-line fixes that don't affect behavior
+- Changes that only affect developer experience marginally
+
+Each proposal should make the codebase meaningfully safer, faster, or more correct. Prefer fewer high-impact proposals over many small ones.
+
+
+## Requirements
+
+1. Each proposal MUST be:
+   - Specific and actionable (not vague)
+   - Self-contained (completable in one PR)
+   - Have at least one verification command
+   - Have confidence >= ${minConfidence}
+   - Have impact_score >= 4 (1-10 scale — most proposals should be 5+)
+
+2. Verification commands should be:
+   - Runnable without manual setup
+   - NOT include grep/wc/file-specific test commands
+   - Use the project's actual test/build commands (e.g. npm test, pytest, cargo test, go test ./..., mvn test, mix test)
+   - Match the project's language and tooling — do NOT use npm commands for non-Node projects
+
+3. Generate at most ${maxProposals} proposals, prioritized by impact. Fewer is better if the remaining proposals would be low-impact.
+
+${protectedNote}${strategicFocus}${recentContext}
+
+## Files to Analyze
+
+${fileContents}
+
+## Output Format
+
+Respond with ONLY a JSON object (no markdown, no explanation):
+
+{
+  "proposals": [
+    {
+      "category": "refactor|fix|cleanup|types|perf|security|docs|test",
+      "title": "Short actionable title (imperative mood)",
+      "description": "What needs to be done and why",
+      "acceptance_criteria": ["Criterion 1", "Criterion 2"],
+      "verification_commands": ["<project test command>"],
+      "allowed_paths": ["path/to/file.ts"],
+      "files": ["path/to/file.ts"],
+      "confidence": 75,
+      "impact_score": 5,
+      "rationale": "Why this improvement matters",
+      "estimated_complexity": "trivial|simple|moderate|complex"
+    }
+  ]
+}
+
+If no improvements are needed, return: {"proposals": []}${coverageContext ? `
+
+If this sector appears misclassified (e.g., labeled as production but contains only tests/config/generated code, or vice versa), add to the JSON:
+"sector_reclassification": { "production": true/false, "confidence": "medium"|"high" }` : ''}`;
+}
+/**
+ * Build a focused prompt for a single category
+ */
+export function buildCategoryPrompt(category, files, maxProposals = 5) {
+    return buildScoutPrompt({
+        files,
+        scope: '*',
+        types: [category],
+        maxProposals,
+        minConfidence: 50,
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/scout/prompt.js.map

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

package/dist/scout/runner.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Scout runner - Executes LLM CLI backends for analysis
+ */
+export interface RunnerOptions {
+    /** Prompt to send to the LLM */
+    prompt: string;
+    /** Working directory */
+    cwd: string;
+    /** Timeout in ms (0 = no timeout) */
+    timeoutMs: number;
+    /** Model to use */
+    model?: string;
+    /** Cancellation signal */
+    signal?: AbortSignal;
+    /** Callback for raw stdout/stderr streaming */
+    onRawOutput?: (chunk: string) => void;
+}
+export interface RunnerResult {
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Output from the LLM */
+    output: string;
+    /** Error message if failed */
+    error?: string;
+    /** Duration in ms */
+    durationMs: number;
+}
+/**
+ * Pluggable scout backend interface
+ */
+export interface ScoutBackend {
+    /** Human-readable name for logging */
+    readonly name: string;
+    /** Run a scout prompt and return the result */
+    run(options: RunnerOptions): Promise<RunnerResult>;
+    /** Optional: process all batches in a single session (e.g., persistent MCP) */
+    runAll?(options: RunnerOptions[]): Promise<RunnerResult[]>;
+}
+/**
+ * Run Claude Code CLI with a prompt
+ */
+export declare function runClaude(options: RunnerOptions): Promise<RunnerResult>;
+/**
+ * Claude Code CLI scout backend (default)
+ */
+export declare class ClaudeScoutBackend implements ScoutBackend {
+    readonly name = "claude";
+    run(options: RunnerOptions): Promise<RunnerResult>;
+}
+/**
+ * Codex CLI scout backend
+ *
+ * Spawns `codex exec` in read-only sandbox mode for analysis.
+ * Uses --output-last-message for reliable output extraction.
+ */
+export declare class CodexScoutBackend implements ScoutBackend {
+    readonly name = "codex";
+    private apiKey?;
+    private defaultModel;
+    constructor(opts?: {
+        apiKey?: string;
+        model?: string;
+    });
+    run(options: RunnerOptions): Promise<RunnerResult>;
+}
+/**
+ * Codex MCP scout backend — persistent single session
+ *
+ * Instead of spawning N cold `codex exec` processes, spawns ONE session
+ * that connects to our MCP batch server. Codex calls tools in a loop
+ * to pull batches and submit results. One warm session, zero cold starts.
+ *
+ * Opt-in via --codex-mcp flag.
+ */
+export declare class CodexMcpScoutBackend implements ScoutBackend {
+    readonly name = "codex";
+    private apiKey?;
+    private defaultModel;
+    constructor(opts?: {
+        apiKey?: string;
+        model?: string;
+    });
+    /** Single-batch fallback (not normally used — runAll is preferred) */
+    run(options: RunnerOptions): Promise<RunnerResult>;
+    /**
+     * Process all batches in a single persistent Codex session via MCP.
+     *
+     * 1. Writes batch prompts to a temp JSON file
+     * 2. Spawns `codex exec` with MCP config pointing to our batch server
+     * 3. Codex loops over get_next_batch → analyze → submit_results
+     * 4. Collects results when signal_done fires
+     */
+    runAll(allOptions: RunnerOptions[]): Promise<RunnerResult[]>;
+}
+/**
+ * Parse JSON from Claude's output
+ *
+ * Handles common issues like markdown code blocks
+ */
+export declare function parseClaudeOutput<T>(output: string): T | null;
+//# sourceMappingURL=runner.d.ts.map

package/dist/scout/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/scout/runner.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qBAAqB;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACnD,+EAA+E;IAC/E,MAAM,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CA4G7E;AAED;;GAEG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACrD,QAAQ,CAAC,IAAI,YAAY;IAEzB,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAGnD;AAED;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,YAAY;IACpD,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAKhD,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;CAsIzD;AAED;;;;;;;;GAQG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,YAAY,CAAS;gBAEjB,IAAI,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAKtD,sEAAsE;IAChE,GAAG,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAMxD;;;;;;;OAOG;IACG,MAAM,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CAmMnE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI,CA8C7D"}