@zeroroot-ai/zerocool 0.10.0 → 0.11.0

package/dist/dispatch.d.ts

@@ -59,7 +59,7 @@
  * {@link dispatchChildEnv} — that is the opencode plugin's own contract, fed from
  * the grant the SDK read.
  */
-import { type AgentOutcome, type SandboxDispatch, type TaskHarness } from "@zeroroot-ai/sdk";
+import { parkAfterResult, Watcher, type AgentOutcome, type SandboxDispatch, type TaskHarness } from "@zeroroot-ai/sdk";
 import { type FindingsBackend } from "./findings.js";
 import { type FindingSource, type FindingStatusWriter, type FixPlanner, type Workspace } from "./fix.js";
 import { type GitLabClient, type GitLabWriter } from "./gitlab.js";
@@ -315,3 +315,21 @@ export declare function harnessCredential(harness: TaskHarness): (name: string)
  * carries it.
  */
 export declare function formatTerminalResult(outcome: AgentOutcome): string;
+/** Seams of {@link runForkableDispatch}. */
+export interface ForkableDispatchDeps extends DispatchDeps {
+    /** Made at process start, before a fork can happen. */
+    watcher: Watcher;
+    /** Called with the outcome of each run, before a park. */
+    onOutcome?: (outcome: AgentOutcome) => void;
+    /** Test seams. */
+    runOnce?: typeof runDispatch;
+    park?: typeof parkAfterResult;
+}
+/**
+ * Run the dispatch, and run the task of a fork when this run is forked (D74).
+ * A fork source (`GIBSON_FORKABLE=1`) parks after a passing result. The
+ * parent returns at the end of the park. A fork claims its own dispatch once
+ * and runs that task, and the outcome of the fork is returned. A failed run
+ * does not park.
+ */
+export declare function runForkableDispatch(ctx: DispatchContext, env: NodeJS.ProcessEnv, deps: ForkableDispatchDeps): Promise<AgentOutcome>;

package/dist/dispatch.js

@@ -61,7 +61,7 @@
  * {@link dispatchChildEnv} — that is the opencode plugin's own contract, fed from
  * the grant the SDK read.
  */
-import { observe, readSandboxDispatch, sandboxHarness, taskKnowledge, } from "@zeroroot-ai/sdk";
+import { observe, parkAfterResult, readSandboxDispatch, sandboxHarness, Watcher, taskKnowledge, } from "@zeroroot-ai/sdk";
 import { join } from "node:path";
 import { taskFindingsBackend } from "./findings.js";
 import { harnessFindingSource, harnessFindingStatus, runFix, } from "./fix.js";
@@ -543,7 +543,34 @@ export function formatTerminalResult(outcome) {
         metadata: outcome.metadata ?? {},
     });
 }
+/**
+ * Run the dispatch, and run the task of a fork when this run is forked (D74).
+ * A fork source (`GIBSON_FORKABLE=1`) parks after a passing result. The
+ * parent returns at the end of the park. A fork claims its own dispatch once
+ * and runs that task, and the outcome of the fork is returned. A failed run
+ * does not park.
+ */
+export async function runForkableDispatch(ctx, env, deps) {
+    const runOnce = deps.runOnce ?? runDispatch;
+    const parkFor = deps.park ?? parkAfterResult;
+    let current = ctx;
+    let launch = env;
+    for (;;) {
+        const outcome = await runOnce(current, deps);
+        deps.onOutcome?.(outcome);
+        if (outcome.success === false)
+            return outcome;
+        const next = await parkFor(launch, deps.watcher, { insecure: current.insecure });
+        if (!next)
+            return outcome;
+        console.error("[zerocool-dispatch] this process is a fork: running the task of the fork");
+        launch = next;
+        current = readDispatchContext(next);
+    }
+}
 async function main() {
+    // Made before any run, so a fork of this process sees its new sandbox id (D74).
+    const watcher = Watcher.create();
     let ctx;
     try {
         ctx = readDispatchContext(process.env);
@@ -560,13 +587,16 @@ async function main() {
     console.error(`[zerocool-dispatch] run mission=${ctx.missionRunId || "-"} agent=${ctx.agentRunId || "-"} ` +
         `workspace=${ctx.workspace}; callbacks use the per-dispatch grant`);
     try {
-        const outcome = await runDispatch(ctx, {
+        await runForkableDispatch(ctx, process.env, {
+            watcher,
             // Forward every opencode event to our stdout, live, for the console stream.
             onEvent: (line) => process.stdout.write(`${line}\n`),
+            onOutcome: (outcome) => {
+                process.stdout.write(`${formatTerminalResult(outcome)}\n`);
+                console.error(`[zerocool-dispatch] done reason=${outcome.metadata?.finish_reason ?? "-"} ` +
+                    `tokens=${outcome.metadata?.tokens_total ?? "-"}`);
+            },
         });
-        process.stdout.write(`${formatTerminalResult(outcome)}\n`);
-        console.error(`[zerocool-dispatch] done reason=${outcome.metadata?.finish_reason ?? "-"} ` +
-            `tokens=${outcome.metadata?.tokens_total ?? "-"}`);
         process.exit(0);
     }
     catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeroroot-ai/zerocool",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "opencode host adapter for Gibson (zerocool): zero-config LLM through the harness, ambient knowledge, and the Gibson MCP server registered for you. The tools come from @zeroroot-ai/gibson-mcp.",
   "license": "Elastic-2.0",
   "repository": {
@@ -23,7 +23,7 @@
     "test": "tsc -p tsconfig.test.json && node --test \"dist-test/**/*.test.js\""
   },
   "dependencies": {
-    "@zeroroot-ai/sdk": "^0.13.0"
+    "@zeroroot-ai/sdk": "^0.16.0"
   },
   "peerDependencies": {
     "@opencode-ai/plugin": "*"