@zeroroot-ai/zerocool 0.10.0 → 0.11.1

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";
@@ -81,8 +81,13 @@ export interface CallbackGrant {
     callbackToken: string;
     /** Dial the callback listener without TLS. Only for a local or kind daemon. */
     insecure?: boolean;
+    /**
+     * The mission run. Required: the mission ID is the same for every run of a
+     * record, so a callback with no run cannot be told from a callback of another
+     * run, and the daemon refuses it (gibson#1235).
+     */
+    missionRunId: string;
     /** Provenance the platform correlates the run by. Empty when the caller set none. */
-    missionRunId?: string;
     agentRunId?: string;
     traceId?: string;
 }
@@ -315,3 +320,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";
@@ -79,11 +79,14 @@ import { formatSourceAnalysis, harnessTriageModel, runSourceAnalysis, } from "./
  * same environment.
  */
 export function dispatchChildEnv(g) {
+    if (!g.missionRunId) {
+        throw new Error("dispatch carries no mission run id: the child's callbacks would be refused");
+    }
     return {
         ...(g.callbackEndpoint ? { GIBSON_CALLBACK_ENDPOINT: g.callbackEndpoint } : {}),
         ...(g.callbackToken ? { GIBSON_CALLBACK_TOKEN: g.callbackToken } : {}),
         ...(g.insecure ? { GIBSON_CALLBACK_INSECURE: "1" } : {}),
-        ...(g.missionRunId ? { GIBSON_MISSION_RUN_ID: g.missionRunId } : {}),
+        GIBSON_MISSION_RUN_ID: g.missionRunId,
         ...(g.agentRunId ? { GIBSON_AGENT_RUN_ID: g.agentRunId } : {}),
         ...(g.traceId ? { GIBSON_TRACE_ID: g.traceId } : {}),
     };
@@ -543,7 +546,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 +590,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/dist/mcp-config.d.ts

@@ -20,7 +20,7 @@
  * time from tools/opencode/package-lock.json, hash pinned, and
  * `ZEROCOOL_MCP_BIN` names it, the same knob the Claude member driver reads.
  */
-export declare const GIBSON_MCP_PACKAGE = "@zeroroot-ai/gibson-mcp@0.3.0";
+export declare const GIBSON_MCP_PACKAGE = "@zeroroot-ai/gibson-mcp@0.7.1";
 /** The command opencode spawns: the installed bin when the image names one, else the pinned package through npx. */
 export declare function gibsonMcpCommand(env?: NodeJS.ProcessEnv): string[];
 export interface OpencodeMcpLocal {

package/dist/mcp-config.js

@@ -22,7 +22,7 @@
  * time from tools/opencode/package-lock.json, hash pinned, and
  * `ZEROCOOL_MCP_BIN` names it, the same knob the Claude member driver reads.
  */
-export const GIBSON_MCP_PACKAGE = "@zeroroot-ai/gibson-mcp@0.3.0";
+export const GIBSON_MCP_PACKAGE = "@zeroroot-ai/gibson-mcp@0.7.1";
 /** The command opencode spawns: the installed bin when the image names one, else the pinned package through npx. */
 export function gibsonMcpCommand(env = process.env) {
     const bin = env.ZEROCOOL_MCP_BIN;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeroroot-ai/zerocool",
-  "version": "0.10.0",
+  "version": "0.11.1",
   "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,13 +23,13 @@
     "test": "tsc -p tsconfig.test.json && node --test \"dist-test/**/*.test.js\""
   },
   "dependencies": {
-    "@zeroroot-ai/sdk": "^0.13.0"
+    "@zeroroot-ai/sdk": "^0.18.1"
   },
   "peerDependencies": {
     "@opencode-ai/plugin": "*"
   },
   "devDependencies": {
-    "@opencode-ai/plugin": "^1.18.34"
+    "@opencode-ai/plugin": "^1.19.2"
   },
   "bin": {
     "zerocool-serve": "dist/serve.js",