@joynt/foundry 0.0.0-stage → 0.1.51

package/dist/config.js

@@ -0,0 +1,147 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULTS = exports.CONFIG_FILENAME = void 0;
+exports.findConfigPath = findConfigPath;
+exports.loadConfig = loadConfig;
+exports.loadConfigSafe = loadConfigSafe;
+exports.getConfigDir = getConfigDir;
+/**
+ * Configuration loader for .joynt-foundry.yml
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const yaml_1 = require("yaml");
+const CONFIG_FILENAME = '.joynt-foundry.yml';
+exports.CONFIG_FILENAME = CONFIG_FILENAME;
+const DEFAULTS = {
+    repo: '',
+    labels: {
+        in_progress: 'state:in-progress',
+        done: 'state:done',
+        ready_for_review: 'state:ready-for-human-review',
+        waiting_for_input: 'state:waiting-for-input',
+        failed: 'state:failed',
+        plan_review: 'state:plan-review',
+    },
+    mode_labels: {
+        plan: 'mode:plan',
+        auto: 'mode:auto',
+        default: 'mode:default',
+    },
+    branches: {
+        integration: 'integration',
+        production: 'main',
+    },
+    branch_template: 'feature/{issue}-{slug}',
+    worktree_base: './wts',
+    max_input_rounds: 3,
+    agent_max_turns: 150,
+    reconcile_stale_minutes: 120,
+    verify: [],
+    verify_preview: [],
+    integration_rebuild: '',
+    comment_triggers: {
+        go: '@foundry go',
+        restart: '@foundry restart',
+        stop: '@foundry stop',
+    },
+    version_sources: [],
+    tag_prefix: 'v',
+    default_agent_backend: 'command',
+    agent_backends: {
+        command: {
+            type: 'command',
+            command: 'echo "No agent command configured. Set agent_backends in .joynt-foundry.yml"',
+        },
+    },
+    github_backend: 'octokit',
+};
+exports.DEFAULTS = DEFAULTS;
+/**
+ * Deep merge b into a (a is base, b overrides).
+ */
+function deepMerge(a, b) {
+    const result = { ...a };
+    for (const key of Object.keys(b)) {
+        if (b[key] !== null &&
+            typeof b[key] === 'object' &&
+            !Array.isArray(b[key]) &&
+            typeof a[key] === 'object' &&
+            !Array.isArray(a[key])) {
+            result[key] = deepMerge(a[key], b[key]);
+        }
+        else {
+            result[key] = b[key];
+        }
+    }
+    return result;
+}
+function findConfigPath(startDir) {
+    let dir = startDir ?? process.cwd();
+    while (true) {
+        const candidate = path.join(dir, CONFIG_FILENAME);
+        if (fs.existsSync(candidate))
+            return candidate;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            return null;
+        dir = parent;
+    }
+}
+function loadConfig(startDir) {
+    const configPath = findConfigPath(startDir);
+    if (!configPath) {
+        throw new Error(`No ${CONFIG_FILENAME} found. Run \`foundry init\` to create one.`);
+    }
+    const raw = fs.readFileSync(configPath, 'utf-8');
+    const parsed = (0, yaml_1.parse)(raw) ?? {};
+    return deepMerge(DEFAULTS, parsed);
+}
+function loadConfigSafe(startDir) {
+    try {
+        return loadConfig(startDir);
+    }
+    catch {
+        return null;
+    }
+}
+function getConfigDir(startDir) {
+    const configPath = findConfigPath(startDir);
+    if (!configPath)
+        return process.cwd();
+    return path.dirname(configPath);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Joynt Foundry — public API exports.
+ */
+export type { FoundryConfig, AgentBackendDef, TaskState, RunnerState, AgentBackend, AgentLaunchParams, GitHubIssue, } from './types.js';
+export { loadConfig, loadConfigSafe, findConfigPath } from './config.js';
+export { resolveBackend, resolveBackendForIssue } from './backends/index.js';
+export type { StateStore } from './lib/state-store.js';
+export { resolveStateStore, FileStateStore } from './lib/stores/index.js';
+export type { Worker, WorkerHandle, WorkerSpawnOpts } from './lib/worker.js';
+export { resolveWorker } from './lib/workers/index.js';
+export { SubprocessWorker } from './lib/workers/subprocess.js';
+export { recoverTask, issueNumberFromPayload, issueNumberFromBranch } from './lib/task-recovery.js';
+export { buildAgentCompletedEvent } from './lib/completion.js';
+export { resolveBaseBranch, integrationBranch, productionBranch, MissingBranchError } from './lib/branches.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,YAAY,EACV,aAAa,EACb,eAAe,EACf,SAAS,EACT,WAAW,EACX,YAAY,EACZ,iBAAiB,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC1E,YAAY,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AACpG,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MissingBranchError = exports.productionBranch = exports.integrationBranch = exports.resolveBaseBranch = exports.buildAgentCompletedEvent = exports.issueNumberFromBranch = exports.issueNumberFromPayload = exports.recoverTask = exports.SubprocessWorker = exports.resolveWorker = exports.FileStateStore = exports.resolveStateStore = exports.resolveBackendForIssue = exports.resolveBackend = exports.findConfigPath = exports.loadConfigSafe = exports.loadConfig = void 0;
+var config_js_1 = require("./config.js");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_js_1.loadConfig; } });
+Object.defineProperty(exports, "loadConfigSafe", { enumerable: true, get: function () { return config_js_1.loadConfigSafe; } });
+Object.defineProperty(exports, "findConfigPath", { enumerable: true, get: function () { return config_js_1.findConfigPath; } });
+var index_js_1 = require("./backends/index.js");
+Object.defineProperty(exports, "resolveBackend", { enumerable: true, get: function () { return index_js_1.resolveBackend; } });
+Object.defineProperty(exports, "resolveBackendForIssue", { enumerable: true, get: function () { return index_js_1.resolveBackendForIssue; } });
+var index_js_2 = require("./lib/stores/index.js");
+Object.defineProperty(exports, "resolveStateStore", { enumerable: true, get: function () { return index_js_2.resolveStateStore; } });
+Object.defineProperty(exports, "FileStateStore", { enumerable: true, get: function () { return index_js_2.FileStateStore; } });
+var index_js_3 = require("./lib/workers/index.js");
+Object.defineProperty(exports, "resolveWorker", { enumerable: true, get: function () { return index_js_3.resolveWorker; } });
+var subprocess_js_1 = require("./lib/workers/subprocess.js");
+Object.defineProperty(exports, "SubprocessWorker", { enumerable: true, get: function () { return subprocess_js_1.SubprocessWorker; } });
+var task_recovery_js_1 = require("./lib/task-recovery.js");
+Object.defineProperty(exports, "recoverTask", { enumerable: true, get: function () { return task_recovery_js_1.recoverTask; } });
+Object.defineProperty(exports, "issueNumberFromPayload", { enumerable: true, get: function () { return task_recovery_js_1.issueNumberFromPayload; } });
+Object.defineProperty(exports, "issueNumberFromBranch", { enumerable: true, get: function () { return task_recovery_js_1.issueNumberFromBranch; } });
+var completion_js_1 = require("./lib/completion.js");
+Object.defineProperty(exports, "buildAgentCompletedEvent", { enumerable: true, get: function () { return completion_js_1.buildAgentCompletedEvent; } });
+var branches_js_1 = require("./lib/branches.js");
+Object.defineProperty(exports, "resolveBaseBranch", { enumerable: true, get: function () { return branches_js_1.resolveBaseBranch; } });
+Object.defineProperty(exports, "integrationBranch", { enumerable: true, get: function () { return branches_js_1.integrationBranch; } });
+Object.defineProperty(exports, "productionBranch", { enumerable: true, get: function () { return branches_js_1.productionBranch; } });
+Object.defineProperty(exports, "MissingBranchError", { enumerable: true, get: function () { return branches_js_1.MissingBranchError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAaA,yCAAyE;AAAhE,uGAAA,UAAU,OAAA;AAAE,2GAAA,cAAc,OAAA;AAAE,2GAAA,cAAc,OAAA;AACnD,gDAA6E;AAApE,0GAAA,cAAc,OAAA;AAAE,kHAAA,sBAAsB,OAAA;AAE/C,kDAA0E;AAAjE,6GAAA,iBAAiB,OAAA;AAAE,0GAAA,cAAc,OAAA;AAE1C,mDAAuD;AAA9C,yGAAA,aAAa,OAAA;AACtB,6DAA+D;AAAtD,iHAAA,gBAAgB,OAAA;AACzB,2DAAoG;AAA3F,+GAAA,WAAW,OAAA;AAAE,0HAAA,sBAAsB,OAAA;AAAE,yHAAA,qBAAqB,OAAA;AACnE,qDAA+D;AAAtD,yHAAA,wBAAwB,OAAA;AACjC,iDAA+G;AAAtG,gHAAA,iBAAiB,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAAE,+GAAA,gBAAgB,OAAA;AAAE,iHAAA,kBAAkB,OAAA"}

package/dist/lib/agent-output.d.ts

@@ -0,0 +1,49 @@
+import type { AgentOutcome } from '../types.js';
+interface StreamEvent {
+    type: string;
+    subtype?: string;
+    session_id?: string;
+    /** Non-null on events that belong to a subagent rather than the main conversation. */
+    parent_tool_use_id?: string | null;
+    is_error?: boolean;
+    structured_output?: unknown;
+    message?: {
+        role?: string;
+        content?: Array<{
+            type: string;
+            text?: string;
+            name?: string;
+            input?: Record<string, any>;
+        }>;
+    };
+    [key: string]: any;
+}
+export declare function parseStreamJsonLog(logPath: string): StreamEvent[];
+export declare function extractSessionId(events: StreamEvent[]): string | null;
+/**
+ * The last text the main conversation produced. Subagent events are skipped:
+ * a subagent's closing sentence is not the agent's conclusion. Used for
+ * display and diagnostics only, never for branching.
+ */
+export declare function extractFinalAssistantMessage(events: StreamEvent[]): string | null;
+/** Cost and size of the run, as the agent CLI reports them on its result event. */
+export declare function extractUsage(result: StreamEvent): {
+    cost_usd?: number;
+    turns?: number;
+    duration_ms?: number;
+} | undefined;
+/** The final `result` event of the main conversation, if the run got that far. */
+export declare function findResultEvent(events: StreamEvent[]): StreamEvent | null;
+/** True when the run itself failed (auth, max turns, crash), as the agent CLI reports it. */
+export declare function resultIsError(result: StreamEvent): boolean;
+export interface DetermineOutcomeOptions {
+    permissionMode?: string;
+    /** Exit code of the agent process, when the caller waited on it. Null when killed by a signal. */
+    exitCode?: number | null;
+    /** Where `foundry report` writes; consulted when the transcript carries no structured output. */
+    reportFile?: string;
+}
+export declare function determineOutcome(logPath: string, worktreePath: string, baseBranch: string, options?: DetermineOutcomeOptions): AgentOutcome;
+export declare function formatInputRequestComment(outcome: AgentOutcome, inputRound: number): string;
+export {};
+//# sourceMappingURL=agent-output.d.ts.map

package/dist/lib/agent-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-output.d.ts","sourceRoot":"","sources":["../../src/lib/agent-output.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,YAAY,EAAuB,MAAM,aAAa,CAAC;AAKrE,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sFAAsF;IACtF,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,KAAK,CAAC;YACd,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;SAC7B,CAAC,CAAC;KACJ,CAAC;IACF,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAID,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,CAiBjE;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,GAAG,IAAI,CAOrE;AAED;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,GAAG,IAAI,CAgBjF;AAED,mFAAmF;AACnF,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAMzH;AAED,kFAAkF;AAClF,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,GAAG,IAAI,CAKzE;AAED,6FAA6F;AAC7F,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAG1D;AAmBD,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kGAAkG;IAClG,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAUD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,EACf,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,uBAAuB,GAChC,YAAY,CA6Ed;AAID,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,YAAY,EACrB,UAAU,EAAE,MAAM,GACjB,MAAM,CAgCR"}

package/dist/lib/agent-output.js

@@ -0,0 +1,256 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseStreamJsonLog = parseStreamJsonLog;
+exports.extractSessionId = extractSessionId;
+exports.extractFinalAssistantMessage = extractFinalAssistantMessage;
+exports.extractUsage = extractUsage;
+exports.findResultEvent = findResultEvent;
+exports.resultIsError = resultIsError;
+exports.determineOutcome = determineOutcome;
+exports.formatInputRequestComment = formatInputRequestComment;
+/**
+ * Agent outcome determination.
+ *
+ * What happens after an agent exits is decided from three kinds of evidence,
+ * none of which is the agent's prose:
+ *
+ *   - facts Foundry can check itself: did the run error, are there commits;
+ *   - the agent's typed report (see agent-report.ts): done, needs_input,
+ *     plan_ready, or blocked;
+ *   - contradictions between the two, which fail closed.
+ *
+ * Claude Code in `-p --output-format stream-json` mode emits NDJSON events;
+ * this module reads them for the result event, the session id, and the
+ * structured report. Agents that emit nothing parseable are still supported
+ * through the report file.
+ */
+const fs = __importStar(require("node:fs"));
+const node_child_process_1 = require("node:child_process");
+const agent_report_js_1 = require("./agent-report.js");
+// ── Parsing ──────────────────────────────────────────────────────────────
+function parseStreamJsonLog(logPath) {
+    if (!fs.existsSync(logPath))
+        return [];
+    const raw = fs.readFileSync(logPath, 'utf-8');
+    const events = [];
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            events.push(JSON.parse(trimmed));
+        }
+        catch {
+            // Not every line is an event (stderr is tee'd into the same file).
+        }
+    }
+    return events;
+}
+function extractSessionId(events) {
+    for (const event of events) {
+        if (event.type === 'system' && event.subtype === 'init' && event.session_id) {
+            return event.session_id;
+        }
+    }
+    return null;
+}
+/**
+ * The last text the main conversation produced. Subagent events are skipped:
+ * a subagent's closing sentence is not the agent's conclusion. Used for
+ * display and diagnostics only, never for branching.
+ */
+function extractFinalAssistantMessage(events) {
+    let lastAssistantText = null;
+    for (const event of events) {
+        if (event.parent_tool_use_id)
+            continue;
+        if (event.type === 'assistant' && event.message?.role === 'assistant') {
+            const textParts = (event.message.content ?? [])
+                .filter(c => c.type === 'text' && c.text)
+                .map(c => c.text);
+            if (textParts.length > 0) {
+                lastAssistantText = textParts.join('\n');
+            }
+        }
+    }
+    return lastAssistantText;
+}
+/** Cost and size of the run, as the agent CLI reports them on its result event. */
+function extractUsage(result) {
+    const u = {};
+    if (typeof result.total_cost_usd === 'number')
+        u.cost_usd = result.total_cost_usd;
+    if (typeof result.num_turns === 'number')
+        u.turns = result.num_turns;
+    if (typeof result.duration_ms === 'number')
+        u.duration_ms = result.duration_ms;
+    return Object.keys(u).length > 0 ? u : undefined;
+}
+/** The final `result` event of the main conversation, if the run got that far. */
+function findResultEvent(events) {
+    for (let i = events.length - 1; i >= 0; i--) {
+        if (events[i].type === 'result' && !events[i].parent_tool_use_id)
+            return events[i];
+    }
+    return null;
+}
+/** True when the run itself failed (auth, max turns, crash), as the agent CLI reports it. */
+function resultIsError(result) {
+    if (result.is_error === true)
+        return true;
+    return typeof result.subtype === 'string' && result.subtype !== 'success';
+}
+// ── Facts ────────────────────────────────────────────────────────────────
+function hasCommitsBeyondBase(worktreePath, baseBranch) {
+    try {
+        const count = (0, node_child_process_1.execFileSync)('git', ['rev-list', '--count', `${baseBranch}..HEAD`], {
+            cwd: worktreePath,
+            encoding: 'utf-8',
+            timeout: 10_000,
+        }).trim();
+        return Number(count) > 0;
+    }
+    catch {
+        return false;
+    }
+}
+function toQuestionData(report) {
+    return (report.questions ?? []).map(q => ({
+        question: q.question,
+        options: (q.options ?? []).map(o => ({ label: o.label, description: o.description ?? '' })),
+        multiSelect: q.multi_select === true,
+    }));
+}
+function determineOutcome(logPath, worktreePath, baseBranch, options) {
+    const events = parseStreamJsonLog(logPath);
+    const sessionId = extractSessionId(events);
+    const finalMessage = extractFinalAssistantMessage(events);
+    const result = findResultEvent(events);
+    const usage = result ? extractUsage(result) : undefined;
+    const fail = (reason, report = null) => ({
+        type: 'errored',
+        session_id: sessionId,
+        final_message: finalMessage ? `${reason}\n\nLast agent output:\n${finalMessage}` : reason,
+        ask_user_questions: null,
+        report,
+        reason,
+        usage,
+    });
+    // 1. The run itself failed.
+    if (result && resultIsError(result)) {
+        const detail = typeof result.result === 'string' && result.result ? `: ${result.result}` : '';
+        // The CLI reports some failures (e.g. authentication) with subtype "success"
+        // and is_error set; naming that subtype reads as a contradiction.
+        const subtype = result.subtype && result.subtype !== 'success' ? ` (${result.subtype})` : '';
+        return fail(`The agent run failed${subtype}${detail}`);
+    }
+    // 2. The agent's report: structured output first, then the report file.
+    let parsed = null;
+    if (result && result.structured_output !== undefined && result.structured_output !== null) {
+        parsed = (0, agent_report_js_1.validateReport)(result.structured_output);
+    }
+    else if (options?.reportFile) {
+        parsed = (0, agent_report_js_1.readReportFile)(options.reportFile);
+    }
+    if (!parsed) {
+        const code = options?.exitCode;
+        if (typeof code === 'number' && code !== 0) {
+            return fail(`The agent process exited with code ${code} and submitted no report.`);
+        }
+        if (code === null) {
+            return fail('The agent process was killed by a signal and submitted no report.');
+        }
+        return fail(result
+            ? 'The agent finished without submitting a report. Its backend command must pass `--json-schema "$FOUNDRY_REPORT_SCHEMA"` (Claude Code) or run `foundry report` before exiting.'
+            : 'The agent exited without a result and without a report.');
+    }
+    if (!parsed.ok) {
+        return fail(`The agent's report was invalid: ${parsed.error}.`);
+    }
+    const report = parsed.report;
+    const base = { session_id: sessionId, report, usage };
+    const planMode = options?.permissionMode === '--permission-mode plan';
+    // 3. Branch on the typed status, checked against facts.
+    switch (report.status) {
+        case 'needs_input':
+            return { ...base, type: 'needs-input', final_message: report.summary, ask_user_questions: toQuestionData(report) };
+        case 'blocked':
+            return { ...base, type: 'blocked', final_message: report.summary, ask_user_questions: null, reason: report.summary };
+        case 'plan_ready':
+            return { ...base, type: 'plan-completed', final_message: report.plan ?? report.summary, ask_user_questions: null };
+        case 'done':
+            // In plan mode nothing can have been implemented; "done" means the plan is done.
+            if (planMode) {
+                return { ...base, type: 'plan-completed', final_message: report.plan ?? report.summary, ask_user_questions: null };
+            }
+            if (!hasCommitsBeyondBase(worktreePath, baseBranch)) {
+                return fail('The agent reported the task done, but the branch has no commits beyond its base.', report);
+            }
+            return { ...base, type: 'completed', final_message: report.summary, ask_user_questions: null };
+    }
+}
+// ── Comment formatting ───────────────────────────────────────────────────
+function formatInputRequestComment(outcome, inputRound) {
+    const parts = [
+        '<!-- foundry-input-request -->',
+        `**Foundry Agent — Input Needed** (round ${inputRound})`,
+        '',
+    ];
+    const questions = outcome.ask_user_questions ?? [];
+    const summary = outcome.report?.summary;
+    if (summary && !(questions.length === 1 && questions[0].question === summary)) {
+        parts.push(summary, '');
+    }
+    if (questions.length > 0) {
+        for (let i = 0; i < questions.length; i++) {
+            const q = questions[i];
+            const selectType = q.options.length === 0 ? '' : q.multiSelect ? ' (select multiple)' : ' (select one)';
+            parts.push(`**${i + 1}. ${q.question}**${selectType}`);
+            for (const opt of q.options) {
+                parts.push(opt.description ? `- **${opt.label}** — ${opt.description}` : `- **${opt.label}**`);
+            }
+            parts.push('');
+        }
+    }
+    else if (outcome.final_message) {
+        parts.push(outcome.final_message, '');
+    }
+    parts.push('Comment `@foundry go` with your answer. The agent continues from where it stopped.');
+    parts.push('');
+    parts.push('Or: `@foundry restart` · `@foundry stop`');
+    return parts.join('\n');
+}
+//# sourceMappingURL=agent-output.js.map

package/dist/lib/agent-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-output.js","sourceRoot":"","sources":["../../src/lib/agent-output.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6CA,gDAiBC;AAED,4CAOC;AAOD,oEAgBC;AAGD,oCAMC;AAGD,0CAKC;AAGD,sCAGC;AAmCD,4CAkFC;AAID,8DAmCC;AAjRD;;;;;;;;;;;;;;;GAeG;AACH,4CAA8B;AAC9B,2DAAkD;AAElD,uDAAwG;AAwBxG,4EAA4E;AAE5E,SAAgB,kBAAkB,CAAC,OAAe;IAChD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAkB,EAAE,CAAC;IAEjC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACnC,CAAC;QAAC,MAAM,CAAC;YACP,mEAAmE;QACrE,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAgB,gBAAgB,CAAC,MAAqB;IACpD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;YAC5E,OAAO,KAAK,CAAC,UAAU,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,SAAgB,4BAA4B,CAAC,MAAqB;IAChE,IAAI,iBAAiB,GAAkB,IAAI,CAAC;IAE5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,kBAAkB;YAAE,SAAS;QACvC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,EAAE,IAAI,KAAK,WAAW,EAAE,CAAC;YACtE,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;iBAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC;iBACxC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAK,CAAC,CAAC;YACrB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,iBAAiB,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3C,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,iBAAiB,CAAC;AAC3B,CAAC;AAED,mFAAmF;AACnF,SAAgB,YAAY,CAAC,MAAmB;IAC9C,MAAM,CAAC,GAAgE,EAAE,CAAC;IAC1E,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ;QAAE,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC;IAClF,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;QAAE,CAAC,CAAC,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC;IACrE,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ;QAAE,CAAC,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAC/E,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACnD,CAAC;AAED,kFAAkF;AAClF,SAAgB,eAAe,CAAC,MAAqB;IACnD,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,kBAAkB;YAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6FAA6F;AAC7F,SAAgB,aAAa,CAAC,MAAmB;IAC/C,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC;AAC5E,CAAC;AAED,4EAA4E;AAE5E,SAAS,oBAAoB,CAAC,YAAoB,EAAE,UAAkB;IACpE,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAA,iCAAY,EAAC,KAAK,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,GAAG,UAAU,QAAQ,CAAC,EAAE;YAChF,GAAG,EAAE,YAAY;YACjB,QAAQ,EAAE,OAAO;YACjB,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAYD,SAAS,cAAc,CAAC,MAAmB;IACzC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxC,QAAQ,EAAE,CAAC,CAAC,QAAQ;QACpB,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3F,WAAW,EAAE,CAAC,CAAC,YAAY,KAAK,IAAI;KACrC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAgB,gBAAgB,CAC9B,OAAe,EACf,YAAoB,EACpB,UAAkB,EAClB,OAAiC;IAEjC,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,4BAA4B,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAExD,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,SAA6B,IAAI,EAAgB,EAAE,CAAC,CAAC;QACjF,IAAI,EAAE,SAAS;QACf,UAAU,EAAE,SAAS;QACrB,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,2BAA2B,YAAY,EAAE,CAAC,CAAC,CAAC,MAAM;QACzF,kBAAkB,EAAE,IAAI;QACxB,MAAM;QACN,MAAM;QACN,KAAK;KACN,CAAC,CAAC;IAEH,4BAA4B;IAC5B,IAAI,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9F,6EAA6E;QAC7E,kEAAkE;QAClE,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7F,OAAO,IAAI,CAAC,uBAAuB,OAAO,GAAG,MAAM,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,wEAAwE;IACxE,IAAI,MAAM,GAAwB,IAAI,CAAC;IACvC,IAAI,MAAM,IAAI,MAAM,CAAC,iBAAiB,KAAK,SAAS,IAAI,MAAM,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;QAC1F,MAAM,GAAG,IAAA,gCAAc,EAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACpD,CAAC;SAAM,IAAI,OAAO,EAAE,UAAU,EAAE,CAAC;QAC/B,MAAM,GAAG,IAAA,gCAAc,EAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,OAAO,EAAE,QAAQ,CAAC;QAC/B,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YAC3C,OAAO,IAAI,CAAC,sCAAsC,IAAI,2BAA2B,CAAC,CAAC;QACrF,CAAC;QACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,CAAC,mEAAmE,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,IAAI,CACT,MAAM;YACJ,CAAC,CAAC,8KAA8K;YAChL,CAAC,CAAC,yDAAyD,CAC9D,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,mCAAmC,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,IAAI,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACtD,MAAM,QAAQ,GAAG,OAAO,EAAE,cAAc,KAAK,wBAAwB,CAAC;IAEtE,wDAAwD;IACxD,QAAQ,MAAM,CAAC,MAAM,EAAE,CAAC;QACtB,KAAK,aAAa;YAChB,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;QAErH,KAAK,SAAS;YACZ,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;QAEvH,KAAK,YAAY;YACf,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;QAErH,KAAK,MAAM;YACT,iFAAiF;YACjF,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;YACrH,CAAC;YACD,IAAI,CAAC,oBAAoB,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,CAAC;gBACpD,OAAO,IAAI,CAAC,kFAAkF,EAAE,MAAM,CAAC,CAAC;YAC1G,CAAC;YACD,OAAO,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,CAAC;IACnG,CAAC;AACH,CAAC;AAED,4EAA4E;AAE5E,SAAgB,yBAAyB,CACvC,OAAqB,EACrB,UAAkB;IAElB,MAAM,KAAK,GAAa;QACtB,gCAAgC;QAChC,2CAA2C,UAAU,GAAG;QACxD,EAAE;KACH,CAAC;IAEF,MAAM,SAAS,GAAG,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC;IACnD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC;IACxC,IAAI,OAAO,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,EAAE,CAAC;QAC9E,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1C,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,eAAe,CAAC;YACxG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC,CAAC;YACvD,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,KAAK,QAAQ,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;YACjG,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;SAAM,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,oFAAoF,CAAC,CAAC;IACjG,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,KAAK,CAAC,IAAI,CAAC,0CAA0C,CAAC,CAAC;IAEvD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/lib/agent-report.d.ts

@@ -0,0 +1,107 @@
+export type AgentReportStatus = 'done' | 'needs_input' | 'plan_ready' | 'blocked';
+export interface AgentReportOption {
+    label: string;
+    description?: string;
+}
+export interface AgentReportQuestion {
+    question: string;
+    options?: AgentReportOption[];
+    multi_select?: boolean;
+}
+export interface AgentReport {
+    status: AgentReportStatus;
+    summary: string;
+    assumptions?: string[];
+    questions?: AgentReportQuestion[];
+    plan?: string;
+}
+export declare const REPORT_STATUSES: AgentReportStatus[];
+export declare const REPORT_SCHEMA_ENV = "FOUNDRY_REPORT_SCHEMA";
+export declare const REPORT_FILE_ENV = "FOUNDRY_REPORT_FILE";
+/**
+ * JSON Schema for the report. The descriptions are instructions to the agent;
+ * they are the only place the meaning of each status is defined.
+ */
+export declare const AGENT_REPORT_SCHEMA: {
+    readonly type: "object";
+    readonly properties: {
+        readonly status: {
+            readonly type: "string";
+            readonly enum: AgentReportStatus[];
+            readonly description: string;
+        };
+        readonly summary: {
+            readonly type: "string";
+            readonly description: "What you did, or why you stopped. Written for the person reviewing the pull request. Plain prose, a few sentences.";
+        };
+        readonly assumptions: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "string";
+            };
+            readonly description: "Decisions you made without asking, one per entry, so the reviewer can check them.";
+        };
+        readonly questions: {
+            readonly type: "array";
+            readonly description: "Required when status is needs_input. Ask only what materially changes the work; offer options when you can.";
+            readonly items: {
+                readonly type: "object";
+                readonly properties: {
+                    readonly question: {
+                        readonly type: "string";
+                    };
+                    readonly options: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "object";
+                            readonly properties: {
+                                readonly label: {
+                                    readonly type: "string";
+                                };
+                                readonly description: {
+                                    readonly type: "string";
+                                };
+                            };
+                            readonly required: readonly ["label"];
+                        };
+                    };
+                    readonly multi_select: {
+                        readonly type: "boolean";
+                    };
+                };
+                readonly required: readonly ["question"];
+            };
+        };
+        readonly plan: {
+            readonly type: "string";
+            readonly description: "Required when status is plan_ready. The full plan in Markdown.";
+        };
+    };
+    readonly required: readonly ["status", "summary"];
+};
+export declare function reportSchemaJson(): string;
+export type ReportResult = {
+    ok: true;
+    report: AgentReport;
+} | {
+    ok: false;
+    error: string;
+};
+/**
+ * Validate an untrusted value as an AgentReport. Structural errors are
+ * rejected. Two cross-field gaps are repaired deterministically rather than
+ * rejected, because the status is unambiguous and the content exists:
+ * needs_input with no questions asks the summary; plan_ready with no plan
+ * uses the summary as the plan.
+ */
+export declare function validateReport(value: unknown): ReportResult;
+export declare function reportFilePath(stateDir: string): string;
+/** Read and validate a report file. Null when the file does not exist. */
+export declare function readReportFile(file: string): ReportResult | null;
+export declare function writeReportFile(file: string, report: AgentReport): void;
+/**
+ * Environment for an agent launch, and a clean slate: a report left by a
+ * previous launch of the same task must never be read as this launch's.
+ */
+export declare function prepareLaunch(stateDir: string): Record<string, string>;
+//# sourceMappingURL=agent-report.d.ts.map

package/dist/lib/agent-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-report.d.ts","sourceRoot":"","sources":["../../src/lib/agent-report.ts"],"names":[],"mappings":"AAmBA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,aAAa,GAAG,YAAY,GAAG,SAAS,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC9B,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,eAAe,EAAE,iBAAiB,EAAqD,CAAC;AAErG,eAAO,MAAM,iBAAiB,0BAA0B,CAAC;AACzD,eAAO,MAAM,eAAe,wBAAwB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDtB,CAAC;AAEX,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAID,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GACjC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAMjC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,CAmE3D;AAID,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAOhE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAKvE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOtE"}