@farmslot/agent-runtime 0.8.1 → 0.10.0

package/dist/native/worker-relocation.test.js

@@ -0,0 +1,110 @@
+import assert from 'node:assert/strict';
+import { execFileSync } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
+import { chmodSync, mkdtempSync, rmSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import test from 'node:test';
+import { NativeSessionClient } from './client.js';
+import { decodeRequest } from './ipc.js';
+import { NativeSessionManager } from './manager.js';
+import { NATIVE_WORKER_RESUME } from './worker-launch.js';
+const executable = `#!/usr/bin/env node
+if(process.argv.includes('--version')) { console.log('fixture 1'); process.exit(0); }
+const send=m=>process.stdout.write(JSON.stringify(m)+'\\n');
+require('node:readline').createInterface({input:process.stdin}).on('line',line=>{
+ const m=JSON.parse(line);
+ if(m.method==='initialize')send({id:m.id,result:{}});
+ if(m.method==='thread/start'||m.method==='thread/resume')send({id:m.id,result:{thread:{id:m.params.threadId||'saved-conversation'}}});
+});
+`;
+test('worker relocation preserves lease/account and requires an explicit sibling-worktree move', async () => {
+    const root = mkdtempSync(join(tmpdir(), 'native-relocation-'));
+    const source = join(root, 'source');
+    const target = join(root, 'target');
+    const unrelated = join(root, 'unrelated');
+    const binary = join(root, 'codex');
+    writeFileSync(binary, executable);
+    chmodSync(binary, 0o700);
+    const git = (args, cwd = root) => execFileSync('git', args, { cwd, stdio: 'pipe' });
+    git(['init', source]);
+    git([
+        '-c',
+        'user.name=Fixture',
+        '-c',
+        'user.email=fixture@example.invalid',
+        'commit',
+        '--allow-empty',
+        '-m',
+        'test: initialize fixture',
+    ], source);
+    git(['worktree', 'add', '-b', 'target', target], source);
+    git(['init', unrelated]);
+    const manager = new NativeSessionManager(join(root, 'state'));
+    const launch = {
+        leaseId: randomUUID(),
+        executable: binary,
+        accountLabel: 'original',
+        safetyTier: 'full-auto',
+        environment: { set: { CODEX_HOME: join(root, 'account') }, unset: [] },
+    };
+    let sessionId;
+    try {
+        const before = await manager.ensure('owner', { sessionId: randomUUID(), runner: 'codex', cwd: source }, launch);
+        sessionId = before.id;
+        const params = {
+            sessionId: before.id,
+            resumeSessionId: before.nativeSessionId,
+            runner: 'codex',
+            cwd: target,
+            generation: before.generation,
+            commandId: randomUUID(),
+        };
+        await assert.rejects(manager.resumeWorker('owner', { ...params, relocation: { fromCwd: source } }, launch), /Close the current/);
+        await manager.closeWorker('owner', before.id, before.generation, launch.leaseId);
+        await assert.rejects(manager.resumeWorker('owner', params, launch), /working directory/);
+        await assert.rejects(manager.resumeWorker('owner', { ...params, relocation: { fromCwd: unrelated } }, launch), /exact previous workspace/);
+        await assert.rejects(manager.resumeWorker('owner', { ...params, cwd: unrelated, relocation: { fromCwd: source } }, launch), /sibling worktrees/);
+        await assert.rejects(manager.resumeWorker('owner', { ...params, relocation: { fromCwd: source } }, { ...launch, accountLabel: 'other' }), /account execution context/);
+        const cancelledCommand = randomUUID();
+        await manager.cancelWorker('owner', before.id, launch.leaseId, before.generation, undefined, cancelledCommand);
+        await assert.rejects(manager.resumeWorker('owner', { ...params, commandId: cancelledCommand, relocation: { fromCwd: source } }, launch), /cancelled before launch/);
+        const next = await manager.resumeWorker('owner', { ...params, relocation: { fromCwd: source } }, launch);
+        assert.equal(next.id, before.id);
+        assert.equal(next.nativeSessionId, before.nativeSessionId);
+        assert.equal(next.workerLeaseId, launch.leaseId);
+        assert.equal(next.cwd, target);
+        assert.notEqual(next.generation, before.generation);
+        await assert.rejects(manager.resumeWorker('owner', { ...params, relocation: { fromCwd: source } }, launch), /generation|lease/i);
+    }
+    finally {
+        if (sessionId)
+            await manager.close('owner', sessionId);
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+test('private state routing separates owners and IPC preserves explicit relocation', () => {
+    const client = new NativeSessionClient('/private/native-state');
+    const sessionId = randomUUID();
+    assert.notEqual(client.workerStateDirectory('one', sessionId), client.workerStateDirectory('two', sessionId));
+    assert.ok(client.workerStateDirectory('one', sessionId).startsWith('/private/native-state/workers/'));
+    const request = decodeRequest({
+        method: NATIVE_WORKER_RESUME,
+        owner: 'owner',
+        params: {
+            sessionId,
+            runner: 'codex',
+            cwd: '/target',
+            generation: 'generation',
+            commandId: 'command',
+            resumeSessionId: 'saved',
+            relocation: { fromCwd: '/source' },
+        },
+        launch: { leaseId: randomUUID(), safetyTier: 'full-auto', environment: { set: {}, unset: [] } },
+    });
+    assert.equal(request.method, NATIVE_WORKER_RESUME);
+    if (request.method !== NATIVE_WORKER_RESUME)
+        throw new Error('Wrong request');
+    assert.deepEqual(request.params.relocation, { fromCwd: '/source' });
+});
+//# sourceMappingURL=worker-relocation.test.js.map

package/dist/native/worker-relocation.test.js.map

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

package/dist/native/worker-service.d.ts

@@ -0,0 +1,4 @@
+import type { NativeSessionClient } from './client.js';
+/** Private execution-node operation. The gateway derives launch settings from its run/slot config. */
+export declare function routeNativeWorkerSession(client: NativeSessionClient, owner: string, method: string, value: unknown): Promise<unknown>;
+//# sourceMappingURL=worker-service.d.ts.map

package/dist/native/worker-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-service.d.ts","sourceRoot":"","sources":["../../src/native/worker-service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAgBvD,sGAAsG;AACtG,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,mBAAmB,EAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CA8FlB"}

package/dist/native/worker-service.js

@@ -0,0 +1,85 @@
+import { decodeRequest } from './ipc.js';
+import { NativeSessionMethodError } from './service.js';
+import { NATIVE_WORKER_CANCEL, NATIVE_WORKER_CLOSE, NATIVE_WORKER_ENSURE, NATIVE_WORKER_INTERRUPT, NATIVE_WORKER_READ, NATIVE_WORKER_RESPOND, NATIVE_WORKER_RESUME, NATIVE_WORKER_SEND, NATIVE_WORKER_STATE, NATIVE_WORKER_TRANSFER, } from './worker-launch.js';
+/** Private execution-node operation. The gateway derives launch settings from its run/slot config. */
+export async function routeNativeWorkerSession(client, owner, method, value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new NativeSessionMethodError('INVALID_PARAMS', 'Expected native worker parameters');
+    const params = value;
+    if (params.executionNodeId !== undefined && params.executionNodeId !== client.executionNodeId)
+        throw new NativeSessionMethodError('INVALID_PARAMS', 'Native worker targets another execution node');
+    if (method === NATIVE_WORKER_STATE) {
+        if (typeof params.sessionId !== 'string' ||
+            !/^[0-9a-f]{8}(?:-[0-9a-f]{4}){3}-[0-9a-f]{12}$/.test(params.sessionId))
+            throw new NativeSessionMethodError('INVALID_PARAMS', 'Expected a reserved worker session ID');
+        return { stateDirectory: client.prepareWorkerState(owner, params.sessionId) };
+    }
+    let request;
+    try {
+        request = decodeRequest({
+            method,
+            owner,
+            params,
+            launch: params.launch,
+            id: params.sessionId,
+            generation: params.generation,
+            leaseId: params.leaseId,
+            sourceLeaseId: params.sourceLeaseId,
+            resumeCommandId: params.resumeCommandId,
+            commandId: params.commandId,
+            text: params.text,
+            requestId: params.requestId,
+            response: params.response,
+            after: params.after,
+            limit: params.limit,
+        });
+    }
+    catch (error) {
+        throw new NativeSessionMethodError('INVALID_PARAMS', error.message);
+    }
+    try {
+        if (request.method === NATIVE_WORKER_READ)
+            return await client.readWorker(owner, request.id, request.leaseId, request.after, request.limit);
+        if (request.method === NATIVE_WORKER_RESPOND) {
+            await client.respondWorker(owner, { sessionId: request.id, generation: request.generation, leaseId: request.leaseId }, request.requestId, request.response);
+            return { responded: true };
+        }
+        if (request.method === NATIVE_WORKER_CANCEL)
+            return await client.cancelWorker(owner, {
+                sessionId: request.id,
+                generation: request.generation,
+                leaseId: request.leaseId,
+                sourceLeaseId: request.sourceLeaseId,
+                resumeCommandId: request.resumeCommandId,
+            });
+        if (request.method === NATIVE_WORKER_ENSURE)
+            return { session: await client.ensureWorker(owner, request.params, request.launch) };
+        if (request.method === NATIVE_WORKER_RESUME)
+            return { session: await client.resumeWorker(owner, request.params, request.launch) };
+        if (request.method === NATIVE_WORKER_SEND ||
+            request.method === NATIVE_WORKER_CLOSE ||
+            request.method === NATIVE_WORKER_INTERRUPT ||
+            request.method === NATIVE_WORKER_TRANSFER) {
+            const target = {
+                sessionId: request.id,
+                generation: request.generation,
+                leaseId: request.leaseId,
+            };
+            if (request.method === NATIVE_WORKER_SEND)
+                return await client.sendWorker(owner, target, request.commandId, request.text);
+            if (request.method === NATIVE_WORKER_CLOSE)
+                return { closed: true, session: await client.closeWorker(owner, target) };
+            if (request.method === NATIVE_WORKER_TRANSFER)
+                return { session: await client.transferWorker(owner, target, request.launch) };
+            await client.interruptWorker(owner, target);
+            return { interrupted: true };
+        }
+        throw new NativeSessionMethodError('INVALID_PARAMS', 'Unknown native worker operation');
+    }
+    catch (error) {
+        if (error instanceof NativeSessionMethodError)
+            throw error;
+        throw new NativeSessionMethodError('NATIVE_SESSION_ERROR', error.message);
+    }
+}
+//# sourceMappingURL=worker-service.js.map

package/dist/native/worker-service.js.map

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

package/dist/native/workspace-files.d.ts

@@ -0,0 +1,6 @@
+export declare const WORKSPACE_TEXT_LIMIT: number;
+/** Native workspace readers share lexical and symlink checks. Node lacks openat2;
+ * whole-path races against an agent with equivalent local OS access remain possible. */
+export declare function workspacePath(root: string, relative: string, missing?: boolean): Promise<string>;
+export declare function readWorkspaceText(root: string, relative: string): Promise<string>;
+//# sourceMappingURL=workspace-files.d.ts.map

package/dist/native/workspace-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-files.d.ts","sourceRoot":"","sources":["../../src/native/workspace-files.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,QAAc,CAAC;AAEhD;wFACwF;AACxF,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,UAAQ,GACd,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBvF"}

package/dist/native/workspace-files.js

@@ -0,0 +1,62 @@
+import { constants } from 'node:fs';
+import { lstat, open, realpath } from 'node:fs/promises';
+import path from 'node:path';
+export const WORKSPACE_TEXT_LIMIT = 1024 * 1024;
+/** Native workspace readers share lexical and symlink checks. Node lacks openat2;
+ * whole-path races against an agent with equivalent local OS access remain possible. */
+export async function workspacePath(root, relative, missing = false) {
+    // Reject even legal POSIX backslash filenames to avoid separator ambiguity across clients.
+    if (path.isAbsolute(relative) || relative.includes('\\') || relative.includes('\0'))
+        throw new Error('Use a relative workspace path');
+    const parts = relative.split('/').filter((part) => part && part !== '.');
+    if (parts.some((part) => part === '..' || part.toLowerCase() === '.git'))
+        throw new Error('Path outside workspace is not allowed');
+    const base = await realpath(root);
+    const target = path.resolve(base, ...parts);
+    const within = path.relative(base, target);
+    if (within === '..' || within.startsWith(`..${path.sep}`) || path.isAbsolute(within))
+        throw new Error('Path outside workspace is not allowed');
+    let current = base;
+    for (const part of parts) {
+        current = path.join(current, part);
+        try {
+            if ((await lstat(current)).isSymbolicLink())
+                throw new Error('Workspace symlinks are not readable');
+        }
+        catch (error) {
+            if (missing && error.code === 'ENOENT')
+                break;
+            throw error;
+        }
+    }
+    return target;
+}
+export async function readWorkspaceText(root, relative) {
+    const target = await workspacePath(root, relative);
+    const handle = await open(target, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
+    try {
+        const info = await handle.stat();
+        if (!info.isFile())
+            throw new Error('Select a regular file');
+        if (info.size > WORKSPACE_TEXT_LIMIT)
+            throw new Error('File exceeds the 1 MiB viewer limit');
+        const buffer = Buffer.alloc(WORKSPACE_TEXT_LIMIT + 1);
+        let length = 0;
+        while (length < buffer.length) {
+            const { bytesRead } = await handle.read(buffer, length, buffer.length - length, length);
+            if (!bytesRead)
+                break;
+            length += bytesRead;
+        }
+        if (length > WORKSPACE_TEXT_LIMIT)
+            throw new Error('File exceeds the 1 MiB viewer limit');
+        const bytes = buffer.subarray(0, length);
+        if (bytes.includes(0))
+            throw new Error('Binary files cannot be displayed');
+        return new TextDecoder('utf-8', { fatal: true }).decode(bytes);
+    }
+    finally {
+        await handle.close();
+    }
+}
+//# sourceMappingURL=workspace-files.js.map

package/dist/native/workspace-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-files.js","sourceRoot":"","sources":["../../src/native/workspace-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,GAAG,IAAI,CAAC;AAEhD;wFACwF;AACxF,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAAY,EACZ,QAAgB,EAChB,OAAO,GAAG,KAAK;IAEf,2FAA2F;IAC3F,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;QACjF,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,CAAC,CAAC;IACzE,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;QACtE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,KAAK,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;QAClF,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,cAAc,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC3D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM;YACzE,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY,EAAE,QAAgB;IACpE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CACvB,MAAM,EACN,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,UAAU,GAAG,SAAS,CAAC,UAAU,CACjE,CAAC;IACF,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC7D,IAAI,IAAI,CAAC,IAAI,GAAG,oBAAoB;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC7F,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,oBAAoB,GAAG,CAAC,CAAC,CAAC;QACtD,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;YACxF,IAAI,CAAC,SAAS;gBAAE,MAAM;YACtB,MAAM,IAAI,SAAS,CAAC;QACtB,CAAC;QACD,IAAI,MAAM,GAAG,oBAAoB;YAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QAC1F,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QACzC,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC3E,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjE,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/native/workspace.d.ts

@@ -0,0 +1,5 @@
+import type { NativeWorkspaceChangesResult, NativeWorkspaceListResult } from '@farmslot/protocol';
+export declare function nativeWorkspaceList(cwd: string, relative: string): Promise<NativeWorkspaceListResult>;
+export declare function nativeWorkspaceChanges(cwd: string, relative?: string): Promise<NativeWorkspaceChangesResult>;
+export declare function nativeWorkspaceDiff(cwd: string, relative: string): Promise<string>;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/native/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../src/native/workspace.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,4BAA4B,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AA6ClG,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,yBAAyB,CAAC,CAkBpC;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,QAAQ,SAAM,GACb,OAAO,CAAC,4BAA4B,CAAC,CA0BvC;AAED,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCxF"}

package/dist/native/workspace.js

@@ -0,0 +1,120 @@
+import { execFile as execFileCallback } from 'node:child_process';
+import { opendir, realpath } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { readWorkspaceText, WORKSPACE_TEXT_LIMIT, workspacePath } from './workspace-files.js';
+const execFile = promisify(execFileCallback);
+const STATUS_OUTPUT_LIMIT = 8 * WORKSPACE_TEXT_LIMIT;
+const DIFF_TOO_LARGE = 'Diff exceeds the 1 MiB viewer limit.';
+async function git(cwd, args, maxBuffer = WORKSPACE_TEXT_LIMIT) {
+    try {
+        const { stdout } = await execFile('git', [
+            '--literal-pathspecs',
+            '--no-optional-locks',
+            '-c',
+            'core.quotePath=false',
+            '-c',
+            'core.fsmonitor=false',
+            ...args,
+        ], {
+            cwd,
+            maxBuffer,
+            timeout: 15_000,
+            // Explicit directory arguments cannot be redirected by inherited Git plumbing variables.
+            env: Object.fromEntries(Object.entries(process.env).filter(([key]) => !key.startsWith('GIT_'))),
+        });
+        return stdout;
+    }
+    catch (error) {
+        // Output limits are expected for large workspaces; preserve other Git errors.
+        if (error.code === 'ERR_CHILD_PROCESS_STDIO_MAXBUFFER')
+            throw new Error(args[0] === 'status'
+                ? 'Changes list exceeds the 8 MiB limit. Use Files to inspect individual paths.'
+                : DIFF_TOO_LARGE, { cause: error });
+        throw error;
+    }
+}
+export async function nativeWorkspaceList(cwd, relative) {
+    const directory = await opendir(await workspacePath(cwd, relative));
+    const entries = [];
+    let truncated = false;
+    for await (const entry of directory) {
+        if (entry.name.toLowerCase() === '.git' || (!entry.isFile() && !entry.isDirectory()))
+            continue;
+        if (entries.length === 500) {
+            truncated = true;
+            break;
+        }
+        entries.push({
+            path: [relative === '.' ? '' : relative, entry.name].filter(Boolean).join('/'),
+            name: entry.name,
+            directory: entry.isDirectory(),
+        });
+    }
+    entries.sort((a, b) => Number(b.directory) - Number(a.directory) || a.name.localeCompare(b.name));
+    return { entries, truncated };
+}
+export async function nativeWorkspaceChanges(cwd, relative = '.') {
+    cwd = await realpath(cwd);
+    if (relative !== '.')
+        await workspacePath(cwd, relative, true);
+    const raw = await git(cwd, ['status', '--porcelain=v1', '-z', '--untracked-files=all', '--', relative], STATUS_OUTPUT_LIMIT);
+    const repository = (await git(cwd, ['rev-parse', '--show-toplevel'])).replace(/\n$/, '');
+    const records = raw.split('\0');
+    const files = [];
+    let truncated = false;
+    for (let i = 0; i < records.length; i++) {
+        if (!records[i])
+            continue;
+        if (files.length === 500) {
+            truncated = true;
+            break;
+        }
+        const status = records[i].slice(0, 2);
+        const file = path.relative(cwd, path.join(repository, records[i].slice(3)));
+        if (file === '..' || file.startsWith('../') || path.isAbsolute(file))
+            throw new Error('Git returned a path outside the session workspace');
+        if (status.includes('R') || status.includes('C'))
+            i++;
+        files.push({ path: file, status });
+    }
+    return { files, truncated };
+}
+export async function nativeWorkspaceDiff(cwd, relative) {
+    await workspacePath(cwd, relative, true);
+    const changes = await nativeWorkspaceChanges(cwd, relative);
+    const file = changes.files.find((candidate) => candidate.path === relative);
+    if (!file)
+        return '';
+    if (file.status === '??') {
+        const text = await readWorkspaceText(cwd, relative);
+        if (!text)
+            return '';
+        const lines = text.split('\n');
+        if (lines.at(-1) === '')
+            lines.pop();
+        const name = JSON.stringify(`b/${relative}`);
+        const diff = `diff --git ${JSON.stringify(`a/${relative}`)} ${name}\nnew file mode 100644\n--- /dev/null\n+++ ${name}\n@@ -0,0 +1,${lines.length} @@\n${lines.map((line) => `+${line}\n`).join('')}${text.endsWith('\n') ? '' : '\\n'}`;
+        if (Buffer.byteLength(diff) > WORKSPACE_TEXT_LIMIT)
+            throw new Error(DIFF_TOO_LARGE);
+        return diff;
+    }
+    // HEAD shows both staged and unstaged workspace changes. On an unborn branch,
+    // staged additions have no HEAD, so use the empty tree produced by Git itself.
+    const head = await git(cwd, ['rev-parse', '--verify', '--quiet', 'HEAD']).catch(async (error) => {
+        if (error.code !== 1)
+            throw error;
+        return git(cwd, ['hash-object', '-t', 'tree', '/dev/null']);
+    });
+    return git(cwd, [
+        'diff',
+        '--no-ext-diff',
+        '--no-textconv',
+        '--no-renames',
+        '--relative',
+        head.trim(),
+        '--',
+        relative,
+    ]);
+}
+//# sourceMappingURL=workspace.js.map

package/dist/native/workspace.js.map

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

package/dist/task-init/index.d.ts

@@ -0,0 +1,70 @@
+import { type ExecutionTemplateReference, type ExecutionTemplateRunMode, type TemplateProvenance, type WorkerTerminalContractDocument } from '@farmslot/protocol';
+import type { ExecutionTemplateSource } from '../execution-template/types.js';
+import { type HandoffExecutionTemplate, type HandoffMetadata, type HandoffSourceKind } from './task-document.js';
+import { type WrittenTaskDir } from './write.js';
+export * from './task-document.js';
+export * from './write.js';
+export { renderTemplatePlaceholders } from '@farmslot/protocol';
+/** Built-in terminal contract for a flow, as the gateway resolves it without project overrides. */
+export declare function builtinTerminalContract(flow: string, options?: {
+    mode?: string;
+    now?: string;
+}): WorkerTerminalContractDocument;
+export interface TaskInitTemplateSelection {
+    sources: ExecutionTemplateSource[];
+    explicitId?: string;
+}
+export interface TaskInitSpec {
+    /** Task directory, absolute or relative to cwd; created when missing. */
+    taskDir: string;
+    /** How the worker should refer to the task dir (`TASK_DIR` placeholder); defaults to `taskDir` as given. */
+    taskDirLabel?: string;
+    flow: string;
+    /**
+     * Run mode of this run. Templates carry none; it selects project default
+     * rules (`when.runMode`), fills `{{MODE}}`, and picks the terminal contract.
+     */
+    runMode?: ExecutionTemplateRunMode;
+    platform: string;
+    domain?: string;
+    template: TaskInitTemplateSelection;
+    task: {
+        title: string;
+        description?: string;
+        acceptanceCriteria?: ReadonlyArray<string>;
+        sourceKind: HandoffSourceKind;
+        ticket?: string;
+        sourceRef?: string;
+    };
+    handoff: {
+        surface: string;
+        project: string;
+        attemptId?: string;
+        repo?: string;
+        startedAt?: string;
+    };
+    /** Extra `{{PLACEHOLDER}}` values for the checklist and task block. */
+    vars?: Record<string, string>;
+    modePreamble?: string;
+    /** Addendum template inserted before the checklist pointer; rendered with the same vars as the checklist. */
+    addendum?: string | null;
+    markCommand?: string;
+    terminalContract?: WorkerTerminalContractDocument;
+    bugInput?: unknown;
+}
+export interface TaskInitResult extends WrittenTaskDir {
+    executionTemplate: HandoffExecutionTemplate;
+    handoffMetadata: HandoffMetadata;
+}
+export declare function taskInit(spec: TaskInitSpec): Promise<TaskInitResult>;
+export interface TaskProvenance {
+    executionTemplate?: HandoffExecutionTemplate | ExecutionTemplateReference;
+    templateProvenance?: Omit<TemplateProvenance, 'executionTemplate'>;
+}
+/**
+ * Selected-template provenance for a task dir. Reads `inputs/handoff.json`;
+ * falls back to the pre-0.9 `inputs/template-provenance.json` for task dirs
+ * written before the merge. Drop the fallback next release.
+ */
+export declare function readTaskProvenance(taskDir: string): TaskProvenance | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/task-init/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task-init/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,0BAA0B,EAC/B,KAAK,wBAAwB,EAE7B,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACpC,MAAM,oBAAoB,CAAC;AAO5B,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,gCAAgC,CAAC;AAE9E,OAAO,EAIL,KAAK,wBAAwB,EAC7B,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAE/D,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAUhE,mGAAmG;AACnG,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC5C,8BAA8B,CAMhC;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,uBAAuB,EAAE,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,OAAO,CAAC,EAAE,wBAAwB,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,yBAAyB,CAAC;IACpC,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAC3C,UAAU,EAAE,iBAAiB,CAAC;QAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6GAA6G;IAC7G,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,8BAA8B,CAAC;IAClD,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,cAAe,SAAQ,cAAc;IACpD,iBAAiB,EAAE,wBAAwB,CAAC;IAC5C,eAAe,EAAE,eAAe,CAAC;CAClC;AAED,wBAAsB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAmF1E;AAED,MAAM,WAAW,cAAc;IAC7B,iBAAiB,CAAC,EAAE,wBAAwB,GAAG,0BAA0B,CAAC;IAC1E,kBAAkB,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,mBAAmB,CAAC,CAAC;CACpE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAgBzE"}