@joynt/foundry 0.0.0-stage → 0.1.50

package/dist/lib/webhook.d.ts

@@ -0,0 +1,39 @@
+/**
+ * GitHub event mapping — converts a GitHub event payload (as delivered to a
+ * GitHub Actions job in $GITHUB_EVENT_PATH) into FoundryEvent instances.
+ *
+ * What starts work is deliberately small:
+ *   - an `@foundry go|restart|stop` comment on an issue (not on a PR),
+ *   - a review requesting changes or approving,
+ *   - a merge,
+ *   - a `workflow_dispatch` carrying one of the three commands.
+ * Labels never start anything and plain comments never start anything.
+ */
+import type { FoundryEvent, FoundryCommand } from './events.js';
+import type { FoundryConfig } from '../types.js';
+/**
+ * Map a GitHub webhook event + payload into zero or more FoundryEvents.
+ *
+ * Returns an empty array when the event is irrelevant to Foundry.
+ */
+export declare function webhookToEvents(eventName: string, payload: Record<string, any>, config: FoundryConfig): FoundryEvent[];
+export interface ParsedFoundryCommand {
+    name: FoundryCommand;
+    message?: string;
+}
+/**
+ * Recognise a command at the very start of a comment. `go` takes a message
+ * (same line or following lines); `restart` and `stop` are the first line on
+ * their own. A mention anywhere else in a comment is just text.
+ */
+export declare function parseFoundryCommand(body: string, config: FoundryConfig): ParsedFoundryCommand | null;
+/**
+ * The part of a comment that is not the command: the message after `go`, or
+ * whatever followed a `restart`/`stop` line. Null when the comment is not a
+ * command at all. Used to keep command comments in the agent's thread
+ * without the command text itself.
+ */
+export declare function commandRemainder(body: string, config: FoundryConfig): string | null;
+/** Comments by GitHub Apps, Actions, and Foundry itself are never commands or context. */
+export declare function isBotLogin(login: string): boolean;
+//# sourceMappingURL=webhook.d.ts.map

package/dist/lib/webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.d.ts","sourceRoot":"","sources":["../../src/lib/webhook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,MAAM,EAAE,aAAa,GACpB,YAAY,EAAE,CAoBhB;AAID,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,cAAc,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,oBAAoB,GAAG,IAAI,CAYpG;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAMnF;AAED,0FAA0F;AAC1F,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/lib/webhook.js

@@ -0,0 +1,248 @@
+"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.webhookToEvents = webhookToEvents;
+exports.parseFoundryCommand = parseFoundryCommand;
+exports.commandRemainder = commandRemainder;
+exports.isBotLogin = isBotLogin;
+const state = __importStar(require("./state.js"));
+// ── Event mapping ───────────────────────────────────────────────────────
+/**
+ * Map a GitHub webhook event + payload into zero or more FoundryEvents.
+ *
+ * Returns an empty array when the event is irrelevant to Foundry.
+ */
+function webhookToEvents(eventName, payload, config) {
+    const action = payload.action;
+    const fullEvent = action ? `${eventName}.${action}` : eventName;
+    switch (fullEvent) {
+        case 'issue_comment.created':
+            return mapIssueComment(payload, config);
+        case 'pull_request.opened':
+        case 'pull_request.reopened':
+        case 'pull_request.synchronize':
+            return mapPullRequestPreview(payload, config, 'up');
+        case 'pull_request.closed':
+            return mapPullRequestClosed(payload, config);
+        case 'pull_request_review.submitted':
+            return mapPullRequestReview(payload, config);
+        case 'workflow_dispatch':
+            return mapWorkflowDispatch(payload, config);
+        default:
+            return [];
+    }
+}
+function escapeRegExp(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+/**
+ * Recognise a command at the very start of a comment. `go` takes a message
+ * (same line or following lines); `restart` and `stop` are the first line on
+ * their own. A mention anywhere else in a comment is just text.
+ */
+function parseFoundryCommand(body, config) {
+    const t = config.comment_triggers;
+    const trimmed = body.trim();
+    const firstLine = trimmed.split('\n')[0].trim();
+    if (new RegExp('^' + escapeRegExp(t.go) + '(?=\\s|$)').test(trimmed)) {
+        const msg = trimmed.slice(t.go.length).trim();
+        return { name: 'go', message: msg || undefined };
+    }
+    if (firstLine === t.restart)
+        return { name: 'restart' };
+    if (firstLine === t.stop)
+        return { name: 'stop' };
+    return null;
+}
+/**
+ * The part of a comment that is not the command: the message after `go`, or
+ * whatever followed a `restart`/`stop` line. Null when the comment is not a
+ * command at all. Used to keep command comments in the agent's thread
+ * without the command text itself.
+ */
+function commandRemainder(body, config) {
+    const cmd = parseFoundryCommand(body, config);
+    if (!cmd)
+        return null;
+    if (cmd.name === 'go')
+        return cmd.message ?? '';
+    const lines = body.trim().split('\n');
+    return lines.slice(1).join('\n').trim();
+}
+/** Comments by GitHub Apps, Actions, and Foundry itself are never commands or context. */
+function isBotLogin(login) {
+    return login.includes('[bot]') || login === 'github-actions' || login === 'foundry';
+}
+// ── issue_comment.created ───────────────────────────────────────────────
+function mapIssueComment(payload, config) {
+    const comment = payload.comment;
+    const issue = payload.issue;
+    if (!comment || !issue)
+        return [];
+    // A comment on a pull request arrives as an issue_comment whose number is
+    // the PR's. It is not resolved to its issue yet, and must never be mistaken
+    // for the issue with the same number.
+    if (issue.pull_request)
+        return [];
+    const author = comment.user?.login ?? '';
+    if (isBotLogin(author))
+        return [];
+    const command = parseFoundryCommand(comment.body ?? '', config);
+    if (!command)
+        return [];
+    const issueNumber = issue.number;
+    const task = state.getAllTasks(config.repo).find(t => t.issue === issueNumber) ?? null;
+    return [{
+            type: 'command',
+            issue: issueNumber,
+            task,
+            command: command.name,
+            message: command.message,
+            commentId: comment.id,
+            commentAuthor: author,
+            via: 'comment',
+        }];
+}
+// ── workflow_dispatch ───────────────────────────────────────────────────
+/**
+ * A command delivered by `gh workflow run` with inputs {issue, command,
+ * message}. This is how Foundry hands work to itself across jobs, since
+ * workflow_dispatch is delivered even when the job's own token caused it.
+ */
+function mapWorkflowDispatch(payload, config) {
+    const inputs = payload.inputs ?? {};
+    const issueNumber = parseInt(String(inputs.issue ?? ''), 10);
+    if (!Number.isFinite(issueNumber))
+        return [];
+    const name = String(inputs.command ?? '');
+    if (!(name in config.comment_triggers))
+        return [];
+    const trigger = config.comment_triggers[name];
+    const body = inputs.message ? `${trigger}\n${inputs.message}` : trigger;
+    const command = parseFoundryCommand(body, config);
+    if (!command)
+        return [];
+    const task = state.getAllTasks(config.repo).find(t => t.issue === issueNumber) ?? null;
+    return [{
+            type: 'command',
+            issue: issueNumber,
+            task,
+            command: command.name,
+            message: command.message,
+            commentId: 0,
+            commentAuthor: payload.sender?.login ?? 'workflow_dispatch',
+            via: 'dispatch',
+        }];
+}
+// ── pull_request.closed (merged) ────────────────────────────────────────
+function mapPullRequestClosed(payload, config) {
+    const pr = payload.pull_request;
+    if (!pr)
+        return [];
+    const branch = pr.head?.ref ?? '';
+    const repo = config.repo;
+    // A task's PR: completion on merge; a close without merge is a human
+    // decision Foundry leaves alone.
+    const task = state.getAllTasks(repo).find(t => t.branch === branch);
+    if (task)
+        return pr.merged ? [{ type: 'pr_merged', task, base: pr.base?.ref }] : [];
+    // Any other PR with a listed base: its preview comes down, merged or not.
+    return mapPullRequestPreview(payload, config, 'down');
+}
+/**
+ * A pull request that is not a task but whose base is listed in
+ * `preview.pull_request_bases` gets a preview of its own.
+ */
+function mapPullRequestPreview(payload, config, action) {
+    const pr = payload.pull_request;
+    if (!pr)
+        return [];
+    const bases = config.preview?.pull_request_bases ?? [];
+    const base = pr.base?.ref ?? '';
+    if (!bases.includes(base))
+        return [];
+    const branch = pr.head?.ref ?? '';
+    // A task's own PR is previewed through the task lifecycle, never twice.
+    if (state.getAllTasks(config.repo).some(t => t.branch === branch))
+        return [];
+    return [{
+            type: 'pr_preview',
+            action,
+            pr_number: pr.number,
+            branch,
+            base,
+            sha: pr.head?.sha ?? '',
+        }];
+}
+// ── pull_request_review.submitted ───────────────────────────────────────
+function mapPullRequestReview(payload, config) {
+    const review = payload.review;
+    const pr = payload.pull_request;
+    if (!review || !pr)
+        return [];
+    const branch = pr.head?.ref ?? '';
+    const base = pr.base?.ref ?? '';
+    const repo = config.repo;
+    const task = state.getAllTasks(repo).find(t => t.branch === branch);
+    if (review.state === 'changes_requested') {
+        if (!task)
+            return [];
+        return [{ type: 'pr_review', task, feedback: buildReviewFeedback(review) }];
+    }
+    if (review.state === 'approved' && config.review?.merge_on_approval !== false) {
+        const promotion = (config.preview?.pull_request_bases ?? []).includes(base);
+        if (!task && !promotion)
+            return [];
+        return [{
+                type: 'pr_approved',
+                pr_number: pr.number,
+                branch,
+                base,
+                reviewer: review.user?.login ?? 'unknown',
+                ...(task ? { task } : {}),
+            }];
+    }
+    return [];
+}
+function buildReviewFeedback(review) {
+    const parts = ['PR review feedback for your changes:'];
+    const author = review.user?.login ?? 'unknown';
+    parts.push(`\n**Review by ${author} (changes requested):**`);
+    if (review.body)
+        parts.push(review.body);
+    parts.push('\nPlease address the review feedback, commit your changes, and push.');
+    return parts.join('\n');
+}
+//# sourceMappingURL=webhook.js.map

package/dist/lib/webhook.js.map

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

package/dist/lib/worker.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Worker interface — how an agent process is executed.
+ *
+ * Implementation: SubprocessWorker (agent as a child of the job).
+ * The interface is kept so another execution model can be added later.
+ */
+export interface WorkerHandle {
+    /** Unique worker identifier (e.g. `foundry-42`) */
+    id: string;
+    /** Check if the worker process is still running */
+    isRunning(): Promise<boolean>;
+    /** Kill the worker process */
+    kill(): Promise<void>;
+    /** Capture recent output from the worker */
+    getLogs(lines?: number): Promise<string>;
+    /** Interactively attach to the worker (optional — not all backends support it) */
+    attach?(): Promise<void>;
+    /**
+     * Wait for the worker to exit and resolve with its exit code (optional —
+     * only in-process workers can offer this). Null if unknown or killed.
+     */
+    wait?(): Promise<number | null>;
+}
+export interface WorkerSpawnOpts {
+    /** Session/container name */
+    id: string;
+    /** Working directory */
+    cwd: string;
+    /** Command to execute */
+    command: string;
+    /** Environment variables to set before running the command */
+    env?: Record<string, string>;
+}
+export interface Worker {
+    /** Worker backend name (e.g. 'subprocess') */
+    name: string;
+    /** Spawn a new worker process and return a handle to it */
+    spawn(opts: WorkerSpawnOpts): Promise<WorkerHandle>;
+    /** Get a handle for an existing worker by id (e.g. reconnect after restart) */
+    handleFor(id: string): WorkerHandle;
+}
+//# sourceMappingURL=worker.d.ts.map

package/dist/lib/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/lib/worker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IAEX,mDAAmD;IACnD,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9B,8BAA8B;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,4CAA4C;IAC5C,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzC,kFAAkF;IAClF,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;OAGG;IACH,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IAEX,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IAEZ,yBAAyB;IACzB,OAAO,EAAE,MAAM,CAAC;IAEhB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,MAAM;IACrB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IAEb,2DAA2D;IAC3D,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEpD,+EAA+E;IAC/E,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC;CACrC"}

package/dist/lib/worker.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Worker interface — how an agent process is executed.
+ *
+ * Implementation: SubprocessWorker (agent as a child of the job).
+ * The interface is kept so another execution model can be added later.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=worker.js.map

package/dist/lib/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/lib/worker.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/lib/workers/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Worker registry — resolves a worker type to a Worker implementation.
+ *
+ * Only `subprocess` exists: the agent runs as a child of the current process,
+ * which under the GitHub Action means the job is the isolation boundary. The
+ * Worker interface is kept so another execution model can be added without
+ * touching the EventHandler.
+ */
+import type { Worker } from '../worker.js';
+export declare function resolveWorker(type?: string): Worker;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/workers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/workers/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAW3C,wBAAgB,aAAa,CAAC,IAAI,GAAE,MAAqB,GAAG,MAAM,CAQjE"}

package/dist/lib/workers/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveWorker = resolveWorker;
+const subprocess_js_1 = require("./subprocess.js");
+// The subprocess worker tracks children in memory, so it must be a singleton
+// within the process or handleFor() would lose them.
+let subprocessSingleton;
+const workers = {
+    subprocess: () => (subprocessSingleton ??= new subprocess_js_1.SubprocessWorker()),
+};
+function resolveWorker(type = 'subprocess') {
+    const factory = workers[type];
+    if (!factory) {
+        throw new Error(`Unknown worker type "${type}". Available: ${Object.keys(workers).join(', ')}`);
+    }
+    return factory();
+}
+//# sourceMappingURL=index.js.map

package/dist/lib/workers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/workers/index.ts"],"names":[],"mappings":";;AAmBA,sCAQC;AAlBD,mDAAmD;AAEnD,6EAA6E;AAC7E,qDAAqD;AACrD,IAAI,mBAAiD,CAAC;AAEtD,MAAM,OAAO,GAAiC;IAC5C,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC,mBAAmB,KAAK,IAAI,gCAAgB,EAAE,CAAC;CACnE,CAAC;AAEF,SAAgB,aAAa,CAAC,OAAe,YAAY;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,wBAAwB,IAAI,iBAAiB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC/E,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,EAAE,CAAC;AACnB,CAAC"}

package/dist/lib/workers/subprocess.d.ts

@@ -0,0 +1,8 @@
+import type { Worker, WorkerHandle, WorkerSpawnOpts } from '../worker.js';
+export declare class SubprocessWorker implements Worker {
+    readonly name = "subprocess";
+    private readonly tracked;
+    handleFor(id: string): WorkerHandle;
+    spawn(opts: WorkerSpawnOpts): Promise<WorkerHandle>;
+}
+//# sourceMappingURL=subprocess.d.ts.map

package/dist/lib/workers/subprocess.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subprocess.d.ts","sourceRoot":"","sources":["../../../src/lib/workers/subprocess.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AA2C1E,qBAAa,gBAAiB,YAAW,MAAM;IAC7C,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8B;IAEtD,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY;IAI7B,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC;CA8C1D"}

package/dist/lib/workers/subprocess.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubprocessWorker = void 0;
+/**
+ * SubprocessWorker — runs the agent as a child process of the current
+ * Node process, streaming its output to stdout.
+ *
+ * This is the worker for `foundry action`, where the GitHub Actions job is
+ * the isolation boundary and nothing needs to outlive the process. There is
+ * no tmux, no detach, no reattach: the job waits on the child directly.
+ *
+ * Handles are tracked in-memory for the lifetime of the process. `handleFor`
+ * on an id this process never spawned returns a handle that reports
+ * not-running, which is the correct answer inside a fresh job.
+ */
+const node_child_process_1 = require("node:child_process");
+const MAX_BUFFERED_LINES = 2000;
+const KILL_GRACE_MS = 5_000;
+class SubprocessHandle {
+    id;
+    tracked;
+    constructor(id, tracked) {
+        this.id = id;
+        this.tracked = tracked;
+    }
+    async isRunning() {
+        return this.tracked ? !this.tracked.exited : false;
+    }
+    async kill() {
+        const t = this.tracked;
+        if (!t || t.exited)
+            return;
+        t.child.kill('SIGTERM');
+        const timer = setTimeout(() => {
+            if (!t.exited)
+                t.child.kill('SIGKILL');
+        }, KILL_GRACE_MS);
+        await t.done;
+        clearTimeout(timer);
+    }
+    async getLogs(lines = 50) {
+        if (!this.tracked)
+            return '';
+        return this.tracked.lines.slice(-lines).join('\n');
+    }
+    /** Resolve with the exit code once the child exits. Null if killed by signal. */
+    async wait() {
+        if (!this.tracked)
+            return null;
+        return this.tracked.done;
+    }
+}
+class SubprocessWorker {
+    name = 'subprocess';
+    tracked = new Map();
+    handleFor(id) {
+        return new SubprocessHandle(id, this.tracked.get(id));
+    }
+    async spawn(opts) {
+        const existing = this.tracked.get(opts.id);
+        if (existing && !existing.exited) {
+            throw new Error(`Worker "${opts.id}" is already running.`);
+        }
+        const child = (0, node_child_process_1.spawn)('bash', ['-lc', opts.command], {
+            cwd: opts.cwd,
+            env: { ...process.env, ...(opts.env ?? {}) },
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const lines = [];
+        const record = (chunk, sink) => {
+            sink.write(chunk);
+            for (const line of chunk.toString('utf-8').split('\n')) {
+                if (line.length === 0)
+                    continue;
+                lines.push(line);
+                if (lines.length > MAX_BUFFERED_LINES)
+                    lines.shift();
+            }
+        };
+        child.stdout?.on('data', (c) => record(c, process.stdout));
+        child.stderr?.on('data', (c) => record(c, process.stderr));
+        const entry = {
+            child,
+            exited: false,
+            exitCode: null,
+            lines,
+            done: new Promise(resolve => {
+                child.on('error', () => {
+                    entry.exited = true;
+                    entry.exitCode = null;
+                    resolve(null);
+                });
+                child.on('exit', (code) => {
+                    entry.exited = true;
+                    entry.exitCode = code;
+                    resolve(code);
+                });
+            }),
+        };
+        this.tracked.set(opts.id, entry);
+        return new SubprocessHandle(opts.id, entry);
+    }
+}
+exports.SubprocessWorker = SubprocessWorker;
+//# sourceMappingURL=subprocess.js.map

package/dist/lib/workers/subprocess.js.map

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

package/dist/lib/worktree.d.ts

@@ -0,0 +1,21 @@
+import type { FoundryConfig, TaskState } from '../types.js';
+export interface PreserveResult {
+    /** A commit was made for uncommitted changes. */
+    committed: boolean;
+    /** The branch was pushed (it had commits beyond its base). */
+    pushed: boolean;
+}
+/**
+ * Make the agent's work survive the end of this job: commit anything
+ * uncommitted, then push the branch if it has commits beyond its base.
+ * Never throws; a failure is logged and reported in the result so the
+ * status comment can say so.
+ */
+export declare function preserveWork(config: FoundryConfig, task: TaskState, repoDir: string, reason: string): PreserveResult;
+/**
+ * Make sure the task's worktree exists before an agent is launched into it.
+ * In a fresh job it is recreated from the pushed branch; if the branch was
+ * never pushed, from the base branch.
+ */
+export declare function ensureWorktree(config: FoundryConfig, task: TaskState, repoDir: string): void;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/lib/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/lib/worktree.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE5D,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,SAAS,EAAE,OAAO,CAAC;IACnB,8DAA8D;IAC9D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CA2BpH;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAmB5F"}