@farmslot/agent-runtime 0.8.0 → 0.9.0

package/CHANGELOG.md

@@ -4,6 +4,20 @@
 
 - Active-development baseline; add user-facing changes here before release or package publication.
 
+## 0.9.0 - 2026-09-13
+
+- Add `task init` (library `taskInit` + `farmslot-agent task init`): the one producer of a task directory (`TASK.md`, `CHECKLIST.md`, `mark`, `inputs/handoff.json`, `inputs/worker-terminal-contract.json`) for control planes and harnesses alike. `handoff.json` now carries the selected checklist reference (`executionTemplate`) and, for Farmslot, `templateProvenance`; `inputs/execution-template.json` and `inputs/template-provenance.json` are no longer written. `checklist-target.json` is optional: absent means `CHECKLIST.md` + `SIGNAL.json`; `task init` never writes it, role switches do, and a control plane may write the default-valued file during a transition. The `mark` shim is one recorded command with a `FARMSLOT_MARK_CMD` override; `install-mark` is gone. `TASK.md` renders a `## Task` key only when it has a value (no more blank `PR_NUMBER:` / `TICKET_URL:` lines), and its checklist sentence no longer names Farmslot.
+- Worker-template structure lint now rejects a flow template that still carries a `## Task` block or `TASK_DIR:` line (the task writer generates TASK.md); nested-loop role checklists may keep theirs via `lintWorkerTemplateStructure(content, { roleChecklist: true })`.
+- Add idempotent native session creation with caller-reserved IDs, preserving live and terminal reservations across retries.
+- Share native session and bounded workspace operations with execution nodes, with node identity pinned to each host and journal.
+- Preserve native failed-turn diagnostics so clients can show login and provider errors.
+- Add a supervised native session host with private local IPC, durable prompts and command receipts, event replay, and explicit saved-conversation recovery. Disable recovery for older Claude histories affected by documented native history-loss bugs.
+- Include the proposed file changes from native tool events with permission requests so clients can display the action before approval.
+
+## 0.8.1 - 2026-08-14
+
+- fix(mark): generate and retain an opaque identity for each worker signal attempt.
+
 ## 0.8.0 - 2026-08-10
 
 - fix(execution-templates): an explicit template id excluded only by the domain gate now fails naming the enabling source and domains; the participation gate is exported (`executionTemplateSourceParticipates`/`executionTemplateEntryParticipates`) as the single authority (MANUAL-000076).

package/README.md

@@ -18,8 +18,8 @@ It does not execute recipes. Recipe graph execution belongs in
 ## CLI
 
 ```bash
-farmslot-agent install-mark <task-dir> --task TASK.md --signal SIGNAL.json
-farmslot-agent mark <task-md> <signal-json> complete --mark-last
+farmslot-agent task init <task-dir> --flow fix-bug --run-mode autonomous --platform mobile --template fix-bug/autonomous.mobile --package-templates <catalog> --title "…" --task-text "…"
+farmslot-agent mark <task-dir> complete --mark-last
 farmslot-agent artifact-check <task-dir> --require-recipe-quality-if-recipe
 farmslot-agent recipe-quality build --input recipe-quality-input.json --output artifacts/recipe-quality.json
 farmslot-agent contract resolve --flow fix-bug

package/bin/farmslot-agent.mjs

@@ -15,7 +15,7 @@ function usage(exitCode = 0) {
     'Commands:',
     '  mark <task-md> <signal-json> <args...>',
     '  artifact-check <task-dir> [args...]',
-    '  install-mark <task-dir> [--task TASK.md] [--signal SIGNAL.json]',
+    '  task init <task-dir> --flow f --run-mode m --platform p --template id --title t [options]',
     '  recipe-quality build [--input input.json] [--output artifacts/recipe-quality.json]',
     '    (flags override top-level input fields; training fields are merged)',
     '  contract resolve --flow <flow> [--project-config path] [--mode mode]',
@@ -382,46 +382,6 @@ async function buildRecipeQuality(args) {
   }
 }
 
-function parseInstallMarkArgs(args) {
-  const parsed = { taskDir: args[0], task: 'TASK.md', signal: 'SIGNAL.json' };
-  for (let i = 1; i < args.length; i += 1) {
-    const arg = args[i];
-    if (arg === '--task') {
-      parsed.task = args[++i] || parsed.task;
-    } else if (arg.startsWith('--task=')) {
-      parsed.task = arg.slice('--task='.length);
-    } else if (arg === '--signal') {
-      parsed.signal = args[++i] || parsed.signal;
-    } else if (arg.startsWith('--signal=')) {
-      parsed.signal = arg.slice('--signal='.length);
-    } else {
-      usage(2);
-    }
-  }
-  if (!parsed.taskDir) usage(2);
-  return parsed;
-}
-
-function installMark(args) {
-  const parsed = parseInstallMarkArgs(args);
-  const taskDir = path.resolve(parsed.taskDir);
-  mkdirSync(taskDir, { recursive: true });
-  const markPath = path.join(taskDir, 'mark');
-  const binPath = path.join(packageRoot, 'bin', 'farmslot-agent.mjs');
-  writeFileSync(
-    markPath,
-    [
-      '#!/usr/bin/env bash',
-      'set -euo pipefail',
-      'DIR="$(CDPATH= cd -- "$(dirname -- "$0")" && pwd)"',
-      `node ${JSON.stringify(binPath)} mark "$DIR" "$@"`,
-      '',
-    ].join('\n'),
-    { mode: 0o755 },
-  );
-  console.log(`installed ${markPath}`);
-}
-
 function parseContractResolveArgs(args) {
   const parsed = { flow: null, mode: null, projectConfig: null };
   for (let i = 0; i < args.length; i += 1) {
@@ -465,8 +425,8 @@ async function main() {
       path.join(packageRoot, 'scripts', 'check-task-artifact-contract.mjs'),
       [subcommand, ...rest].filter((arg) => arg !== undefined),
     );
-  } else if (command === 'install-mark') {
-    installMark([subcommand, ...rest].filter((arg) => arg !== undefined));
+  } else if (command === 'task' && subcommand === 'init') {
+    runNode(path.join(packageRoot, 'scripts', 'task-init-cli.mjs'), rest);
   } else if (command === 'contract' && subcommand === 'resolve') {
     resolveContract(rest);
   } else if (command === 'recipe-quality' && subcommand === 'build') {

package/dist/index.d.ts

@@ -3,7 +3,9 @@ export declare const AGENT_RUNTIME_SCRIPT_EXPORTS: {
     readonly markChecklistStep: "@farmslot/agent-runtime/scripts/mark-checklist-step.cjs";
     readonly workerTerminalContract: "@farmslot/agent-runtime/scripts/worker-terminal-contract.cjs";
     readonly checkTaskArtifactContract: "@farmslot/agent-runtime/scripts/check-task-artifact-contract.mjs";
+    readonly taskInitCli: "@farmslot/agent-runtime/scripts/task-init-cli.mjs";
 };
 export * from './execution-template/index.js';
 export * from './recipe-quality.js';
+export * from './task-init/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAE/D,eAAO,MAAM,4BAA4B;;;;CAI/B,CAAC;AAEX,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,4BAA4B,CAAC;AAE/D,eAAO,MAAM,4BAA4B;;;;;CAK/B,CAAC;AAEX,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -3,7 +3,9 @@ export const AGENT_RUNTIME_SCRIPT_EXPORTS = {
     markChecklistStep: '@farmslot/agent-runtime/scripts/mark-checklist-step.cjs',
     workerTerminalContract: '@farmslot/agent-runtime/scripts/worker-terminal-contract.cjs',
     checkTaskArtifactContract: '@farmslot/agent-runtime/scripts/check-task-artifact-contract.mjs',
+    taskInitCli: '@farmslot/agent-runtime/scripts/task-init-cli.mjs',
 };
 export * from './execution-template/index.js';
 export * from './recipe-quality.js';
+export * from './task-init/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE/D,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,iBAAiB,EAAE,yDAAyD;IAC5E,sBAAsB,EAAE,8DAA8D;IACtF,yBAAyB,EAAE,kEAAkE;CACrF,CAAC;AAEX,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,yBAAyB,CAAC;AAE/D,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,iBAAiB,EAAE,yDAAyD;IAC5E,sBAAsB,EAAE,8DAA8D;IACtF,yBAAyB,EAAE,kEAAkE;IAC7F,WAAW,EAAE,mDAAmD;CACxD,CAAC;AAEX,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC"}

package/dist/native/affinity.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=affinity.test.d.ts.map

package/dist/native/affinity.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"affinity.test.d.ts","sourceRoot":"","sources":["../../src/native/affinity.test.ts"],"names":[],"mappings":""}

package/dist/native/affinity.test.js

@@ -0,0 +1,30 @@
+import assert from 'node:assert/strict';
+import { 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 { NativeSessionManager } from './manager.js';
+test('native clients refuse state directories and journals from a different execution node', async () => {
+    const root = mkdtempSync(join(tmpdir(), 'native-affinity-'));
+    try {
+        writeFileSync(join(root, 'host.json'), JSON.stringify({
+            executionNodeId: 'node-a',
+            pid: process.pid,
+            socket: join(root, 'socket'),
+            token: 'fixture',
+        }), { mode: 0o600 });
+        await assert.rejects(new NativeSessionClient(root, 'node-b').list('owner'), /another execution node/);
+        writeFileSync(join(root, 'session.journal'), JSON.stringify({ info: { id: 'session', executionNodeId: 'node-a' }, context: {} }) + '\n', { mode: 0o600 });
+        assert.throws(() => new NativeSessionManager(root, 'node-b'), /another execution node/);
+        await assert.rejects(new NativeSessionManager(join(root, 'fresh'), 'node-a').create('owner', {
+            executionNodeId: 'node-b',
+            runner: 'codex',
+            cwd: root,
+        }), /another execution node/);
+    }
+    finally {
+        rmSync(root, { recursive: true, force: true });
+    }
+});
+//# sourceMappingURL=affinity.test.js.map

package/dist/native/affinity.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"affinity.test.js","sourceRoot":"","sources":["../../src/native/affinity.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,IAAI,CAAC,sFAAsF,EAAE,KAAK,IAAI,EAAE;IACtG,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAC7D,IAAI,CAAC;QACH,aAAa,CACX,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,EACvB,IAAI,CAAC,SAAS,CAAC;YACb,eAAe,EAAE,QAAQ;YACzB,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC;YAC5B,KAAK,EAAE,SAAS;SACjB,CAAC,EACF,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;QACF,MAAM,MAAM,CAAC,OAAO,CAClB,IAAI,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EACrD,wBAAwB,CACzB,CAAC;QACF,aAAa,CACX,IAAI,CAAC,IAAI,EAAE,iBAAiB,CAAC,EAC7B,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAC1F,EAAE,IAAI,EAAE,KAAK,EAAE,CAChB,CAAC;QACF,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,wBAAwB,CAAC,CAAC;QACxF,MAAM,MAAM,CAAC,OAAO,CAClB,IAAI,oBAAoB,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE;YACtE,eAAe,EAAE,QAAQ;YACzB,MAAM,EAAE,OAAO;YACf,GAAG,EAAE,IAAI;SACV,CAAC,EACF,wBAAwB,CACzB,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/native/claude.d.ts

@@ -0,0 +1,11 @@
+import type { NativeAdapter } from './types.js';
+/** Upstream fixed hook-history loss in 2.1.83 and interrupted-tool resume in 2.1.265. */
+export declare function claudeResumeUnavailableReason(version: string): string | undefined;
+/**
+ * Claude Code's documented stream-json mode is bidirectional: the host sends
+ * user/control messages over stdin and receives structured events over stdout.
+ * This deliberately runs the installed Claude binary; it does not reproduce
+ * Claude's agent loop or authentication through an SDK.
+ */
+export declare const claudeNativeAdapter: NativeAdapter;
+//# sourceMappingURL=claude.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/native/claude.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAoB,MAAM,YAAY,CAAC;AAIlE,yFAAyF;AACzF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKjF;AAoCD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,EAAE,aA8cjC,CAAC"}