@jinn-network/client 0.1.2 → 0.1.3-canary.12cf8b76

package/dist/runner/claude.js

@@ -4,6 +4,7 @@ import { dirname, join } from 'node:path';
 import { tmpdir } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { Store } from '../store/store.js';
+import { tracedSpawn } from '../trajectory/index.js';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 /** MCP subprocess: compiled `server.js` when present, else `node --import tsx server.ts` (dev / yarn e2e). */
 function resolveJinnMcpLauncher(explicitPath) {
@@ -30,8 +31,8 @@ export class ClaudeRunner {
         this.model = config.model;
         this.mcpLauncher = resolveJinnMcpLauncher(config.mcpServerPath);
     }
-    async run(desiredState, context) {
-        const prompt = buildPrompt(desiredState);
+    async run(task, context) {
+        const prompt = buildPrompt(task);
         // Write MCP config to temp dir
         const tmpDir = mkdtempSync(join(tmpdir(), 'jinn-runner-'));
         const mcpConfigPath = join(tmpDir, 'mcp-config.json');
@@ -41,28 +42,59 @@ export class ClaudeRunner {
                     command: this.mcpLauncher.command,
                     args: this.mcpLauncher.args,
                     env: {
-                        DESIRED_STATE_ID: desiredState.id,
-                        DESIRED_STATE_DESCRIPTION: desiredState.description,
-                        DESIRED_STATE_CONTEXT: desiredState.context ? JSON.stringify(desiredState.context) : '',
-                        DESIRED_STATE_TYPE: desiredState.type ?? '',
-                        RESTORATION_REQUEST_ID: desiredState.restorationRequestId ?? '',
+                        DESIRED_STATE_ID: task.id,
+                        DESIRED_STATE_DESCRIPTION: task.description,
+                        DESIRED_STATE_CONTEXT: task.context ? JSON.stringify(task.context) : '',
+                        DESIRED_STATE_ROLE: task.role ?? '',
+                        RESTORATION_REQUEST_ID: task.restorationRequestId ?? '',
                         REQUEST_ID: context.requestId,
-                        RESTORATION_DELIVERY_DATA: desiredState.type === 'evaluation' && desiredState.context?.restorationResult
-                            ? JSON.stringify(desiredState.context.restorationResult)
+                        RESTORATION_DELIVERY_DATA: task.role === 'evaluation' && task.context?.restorationResult
+                            ? JSON.stringify(task.context.restorationResult)
                             : '',
                         STORE_PATH: context.storePath ?? '',
                         DAEMON_API_URL: context.daemonApiUrl ?? '',
+                        // Bearer token for the daemon's cost-mutating routes. MCP
+                        // subprocess attaches this as `Authorization: Bearer <token>`
+                        // on fetches to `POST /v1/artifacts/acquire` and
+                        // `POST /artifacts`. Empty string when unset → daemon returns 401.
+                        DAEMON_API_TOKEN: context.daemonApiToken ?? '',
+                        // Subgraph + IPFS gateway only — both keyless. The agent EOA
+                        // private key NEVER leaves the daemon process; acquire_artifact
+                        // proxies through DAEMON_API_URL instead.
+                        JINN_CORPUS_SUBGRAPH_URL: context.corpusEnv?.subgraphUrl ?? '',
+                        JINN_CORPUS_IPFS_GATEWAY_URL: context.corpusEnv?.ipfsGatewayUrl ?? '',
                     },
                 },
             },
         }));
         try {
-            await spawnAgent(this.claudePath, prompt, mcpConfigPath, this.model, context.timeoutMs);
+            if (context.trajectory) {
+                // Traced path — wrap spawn with tracedSpawn so the subprocess lifetime
+                // surfaces as a jinn.state_transition span in the run's trajectory.
+                const agentEnv = buildAgentEnv();
+                const args = buildAgentArgs(prompt, mcpConfigPath, this.model);
+                console.log(`[runner] Spawning agent (traced): ${this.claudePath} ${args.slice(0, 3).join(' ')} ... (timeout: ${context.timeoutMs}ms)`);
+                const result = await tracedSpawn({
+                    collector: context.trajectory,
+                    cmd: this.claudePath,
+                    args,
+                    env: agentEnv,
+                    stateFrom: 'PREPARED',
+                    stateTo: 'RAN_CLAUDE',
+                });
+                console.log(`[runner] Agent process exited (exitCode: ${result.exitCode})`);
+                if (result.exitCode !== 0) {
+                    throw new Error(`Agent exited with code ${result.exitCode}: ${result.stderr.slice(0, 500)}`);
+                }
+            }
+            else {
+                await spawnAgent(this.claudePath, prompt, mcpConfigPath, this.model, context.timeoutMs);
+            }
             // Read result from store — the MCP tool published it as an artifact
             if (context.storePath) {
                 const store = new Store(context.storePath);
                 try {
-                    const isEvaluation = desiredState.type === 'evaluation';
+                    const isEvaluation = task.role === 'evaluation';
                     const tag = isEvaluation ? 'evaluation-verdict' : 'restoration-result';
                     const artifact = store.getArtifactByRequestId(context.requestId, tag);
                     if (artifact) {
@@ -80,31 +112,31 @@ export class ClaudeRunner {
         }
     }
 }
-export function buildPrompt(desiredState) {
+export function buildPrompt(task) {
     let contextSection = '';
-    if (desiredState.context && Object.keys(desiredState.context).length > 0) {
-        contextSection = `\n## Context\n${JSON.stringify(desiredState.context, null, 2)}\n`;
+    if (task.context && Object.keys(task.context).length > 0) {
+        contextSection = `\n## Context\n${JSON.stringify(task.context, null, 2)}\n`;
     }
-    const isEvaluation = desiredState.type === 'evaluation';
+    const isEvaluation = task.role === 'evaluation';
     const instructions = isEvaluation
         ? `## Instructions
-1. Use get_desired_state to understand what was requested
+1. Use get_task to understand what was requested
 2. Use get_restoration_delivery to fetch the restoration result
-3. Evaluate whether the restoration achieved the desired state
+3. Evaluate whether the solution satisfied the Task
 4. Use submit_restoration_result to report your verdict
 5. Use report_progress to log progress along the way
 6. Optionally use publish_artifact to record any insights`
         : `## Instructions
-1. Use get_desired_state to understand what needs to be restored
+1. Use get_task to understand what needs to be restored
 2. Take the necessary actions to restore it
 3. Use submit_restoration_result to report what you did
 4. Use report_progress to log progress along the way
 5. Optionally use publish_artifact to record any insights`;
-    return `You are ${isEvaluation ? 'evaluating a restoration' : 'restoring a desired state'}.
+    return `You are ${isEvaluation ? 'evaluating a solution' : 'solving a Task'}.
 
-## Desired State
-ID: ${desiredState.id}
-Description: ${desiredState.description}
+## Task
+ID: ${task.id}
+Description: ${task.description}
 ${contextSection}
 ${instructions}
 
@@ -161,12 +193,16 @@ function buildAgentEnv() {
     }
     return env;
 }
+function buildAgentArgs(prompt, mcpConfigPath, model) {
+    const args = ['-p', prompt, '--mcp-config', mcpConfigPath, '--strict-mcp-config'];
+    if (model)
+        args.push('--model', model);
+    args.push('--allowedTools', 'mcp__jinn-client__*');
+    return args;
+}
 function spawnAgent(claudePath, prompt, mcpConfigPath, model, timeoutMs) {
     return new Promise((resolve, reject) => {
-        const args = ['-p', prompt, '--mcp-config', mcpConfigPath, '--strict-mcp-config'];
-        if (model)
-            args.push('--model', model);
-        args.push('--allowedTools', 'mcp__jinn-client__*');
+        const args = buildAgentArgs(prompt, mcpConfigPath, model);
         console.log(`[runner] Spawning agent: ${claudePath} ${args.slice(0, 3).join(' ')} ... (timeout: ${timeoutMs}ms)`);
         const agentEnv = buildAgentEnv();
         const child = spawn(claudePath, args, {

package/dist/runner/claude.js.map

@@ -1 +1 @@
-{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/runner/claude.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACzE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,8GAA8G;AAC9G,SAAS,sBAAsB,CAAC,YAAqB;IACnD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC;IAC7D,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;IACnD,CAAC;IACD,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;QACnB,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC;IACtE,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AACnD,CAAC;AAQD,MAAM,OAAO,YAAY;IACf,UAAU,CAAS;IACnB,KAAK,CAAU;IACN,WAAW,CAAsC;IAElE,YAAY,SAA6B,EAAE;QACzC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,IAAI,QAAQ,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,sBAAsB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,YAA0B,EAAE,OAAsB;QAC1D,MAAM,MAAM,GAAG,WAAW,CAAC,YAAY,CAAC,CAAC;QAEzC,+BAA+B;QAC/B,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QAEtD,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC;YAC1C,UAAU,EAAE;gBACV,aAAa,EAAE;oBACb,OAAO,EAAE,IAAI,CAAC,WAAW,CAAC,OAAO;oBACjC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI;oBAC3B,GAAG,EAAE;wBACH,gBAAgB,EAAE,YAAY,CAAC,EAAE;wBACjC,yBAAyB,EAAE,YAAY,CAAC,WAAW;wBACnD,qBAAqB,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE;wBACvF,kBAAkB,EAAE,YAAY,CAAC,IAAI,IAAI,EAAE;wBAC3C,sBAAsB,EAAE,YAAY,CAAC,oBAAoB,IAAI,EAAE;wBAC/D,UAAU,EAAE,OAAO,CAAC,SAAS;wBAC7B,yBAAyB,EAAE,YAAY,CAAC,IAAI,KAAK,YAAY,IAAI,YAAY,CAAC,OAAO,EAAE,iBAAiB;4BACtG,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,CAAC,iBAAiB,CAAC;4BACxD,CAAC,CAAC,EAAE;wBACN,UAAU,EAAE,OAAO,CAAC,SAAS,IAAI,EAAE;wBACnC,cAAc,EAAE,OAAO,CAAC,YAAY,IAAI,EAAE;qBAC3C;iBACF;aACF;SACF,CAAC,CAAC,CAAC;QAEJ,IAAI,CAAC;YACH,MAAM,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YAExF,oEAAoE;YACpE,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;gBACtB,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;gBAC3C,IAAI,CAAC;oBACH,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,KAAK,YAAY,CAAC;oBACxD,MAAM,GAAG,GAAG,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAAC;oBACvE,MAAM,QAAQ,GAAG,KAAK,CAAC,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;oBACtE,IAAI,QAAQ,EAAE,CAAC;wBACb,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC;oBACpC,CAAC;gBACH,CAAC;wBAAS,CAAC;oBACT,KAAK,CAAC,KAAK,EAAE,CAAC;gBAChB,CAAC;YACH,CAAC;YAED,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,YAA0B;IACpD,IAAI,cAAc,GAAG,EAAE,CAAC;IACxB,IAAI,YAAY,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzE,cAAc,GAAG,iBAAiB,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IACtF,CAAC;IAED,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,KAAK,YAAY,CAAC;IAExD,MAAM,YAAY,GAAG,YAAY;QAC/B,CAAC,CAAC;;;;;;0DAMoD;QACtD,CAAC,CAAC;;;;;0DAKoD,CAAC;IAEzD,OAAO,WAAW,YAAY,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,2BAA2B;;;MAGrF,YAAY,CAAC,EAAE;eACN,YAAY,CAAC,WAAW;EACrC,cAAc;EACd,YAAY;;yCAE2B,CAAC;AAC1C,CAAC;AAED,wEAAwE;AACxE,yEAAyE;AACzE,EAAE;AACF,4EAA4E;AAC5E,kEAAkE;AAClE,2EAA2E;AAC3E,4EAA4E;AAC5E,sEAAsE;AACtE,eAAe;AACf,MAAM,aAAa,GAAG;IACpB,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,QAAQ;IACR,iBAAiB;IACjB,eAAe;IACf,gBAAgB;IAChB,WAAW;IACX,cAAc;IACd,mBAAmB;IACnB,qEAAqE;IACrE,8EAA8E;IAC9E,gFAAgF;IAChF,2EAA2E;IAC3E,6EAA6E;IAC7E,uCAAuC;IACvC,yBAAyB;IACzB,mBAAmB;CACpB,CAAC;AAEF,MAAM,aAAa,GAAG;IACpB,aAAa;IACb,QAAQ;IACR,UAAU;IACV,UAAU;IACV,UAAU;IACV,UAAU;IACV,SAAS;IACT,YAAY;IACZ,cAAc;CACf,CAAC;AAEF,SAAS,aAAa;IACpB,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;QAChC,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IACrD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,UAAU,CAAC,UAAkB,EAAE,MAAc,EAAE,aAAqB,EAAE,KAAc,EAAE,SAAkB;IAC/G,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,aAAa,EAAE,qBAAqB,CAAC,CAAC;QAClF,IAAI,KAAK;YAAE,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,qBAAqB,CAAC,CAAC;QAEnD,OAAO,CAAC,GAAG,CAAC,4BAA4B,UAAU,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,SAAS,KAAK,CAAC,CAAC;QAElH,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE;YACpC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,GAAG,EAAE,QAAQ;YACb,OAAO,EAAE,SAAS;SACnB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,wCAAwC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;QAElE,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACrC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACvB,8BAA8B;YAC9B,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,KAAK;gBAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACrC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,KAAK;gBAAE,OAAO,CAAC,KAAK,CAAC,mBAAmB,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;YAChC,OAAO,CAAC,GAAG,CAAC,wCAAwC,IAAI,aAAa,MAAM,GAAG,CAAC,CAAC;YAChF,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;gBACf,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,KAAK,CAAC,0BAA0B,IAAI,YAAY,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACjG,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAC1D,MAAM,CAAC,GAAG,CAAC,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/runner/claude.ts"],"names":[],"mappings":"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"}

package/dist/runner/runner.d.ts

@@ -1,11 +1,38 @@
-import type { DesiredState, RestorationResult, RequestId } from '../types/index.js';
+import type { Task, TaskResult, RequestId } from '../types/index.js';
+import type { TrajectoryCollector } from '../trajectory/index.js';
 export interface RunnerContext {
     requestId: RequestId;
     workingDirectory: string;
     timeoutMs: number;
     storePath?: string;
     daemonApiUrl?: string;
+    /**
+     * Bearer token required by the daemon's cost-mutating API routes
+     * (`POST /artifacts`, `POST /v1/artifacts/acquire`). Forwarded into the
+     * MCP subprocess via `DAEMON_API_TOKEN` and attached to fetch headers.
+     * When omitted, MCP calls those routes without an Authorization header
+     * and the daemon will respond 401.
+     */
+    daemonApiToken?: string;
+    /**
+     * Optional corpus configuration forwarded to the MCP subprocess so
+     * `search_records` / `inspect_record` can hit the keyless subgraph + IPFS
+     * gateway. `acquire_artifact` no longer needs anything from this block — it
+     * proxies to the daemon at `daemonApiUrl` and the daemon owns the agent EOA
+     * private key. When omitted, record lookup and artifact acquisition fall
+     * back to local-only behavior. Spec: spec/2026-04-30-phase-a-umbrella.md §4.
+     */
+    corpusEnv?: {
+        subgraphUrl?: string;
+        ipfsGatewayUrl?: string;
+    };
+    /**
+     * In-run trajectory collector. When provided, the runner emits a
+     * jinn.state_transition span wrapping the Claude subprocess lifetime.
+     * Scope §3.2 traced-I/O boundary.
+     */
+    trajectory?: TrajectoryCollector;
 }
 export interface Runner {
-    run(desiredState: DesiredState, context: RunnerContext): Promise<RestorationResult>;
+    run(task: Task, context: RunnerContext): Promise<TaskResult>;
 }

package/dist/runner/simple.d.ts

@@ -1,8 +1,8 @@
-import type { DesiredState, RestorationResult } from '../types/index.js';
+import type { Task, TaskResult } from '../types/index.js';
 import type { Runner, RunnerContext } from './runner.js';
 export type RestorationFn = (description: string, context?: Record<string, unknown>) => Promise<string>;
 export declare class SimpleRunner implements Runner {
     private readonly fn;
     constructor(fn: RestorationFn);
-    run(desiredState: DesiredState, _context: RunnerContext): Promise<RestorationResult>;
+    run(task: Task, _context: RunnerContext): Promise<TaskResult>;
 }

package/dist/runner/simple.js

@@ -3,8 +3,8 @@ export class SimpleRunner {
     constructor(fn) {
         this.fn = fn;
     }
-    async run(desiredState, _context) {
-        const data = await this.fn(desiredState.description, desiredState.context);
+    async run(task, _context) {
+        const data = await this.fn(task.description, task.context);
         return { data };
     }
 }

package/dist/runner/simple.js.map

@@ -1 +1 @@
-{"version":3,"file":"simple.js","sourceRoot":"","sources":["../../src/runner/simple.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,EAAiB;QAAjB,OAAE,GAAF,EAAE,CAAe;IAAG,CAAC;IAElD,KAAK,CAAC,GAAG,CAAC,YAA0B,EAAE,QAAuB;QAC3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAC3E,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;CACF"}
+{"version":3,"file":"simple.js","sourceRoot":"","sources":["../../src/runner/simple.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,EAAiB;QAAjB,OAAE,GAAF,EAAE,CAAe;IAAG,CAAC;IAElD,KAAK,CAAC,GAAG,CAAC,IAAU,EAAE,QAAuB;QAC3C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3D,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/scripts/fix-node-pty.mjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * Fix node-pty spawn-helper permissions on macOS.
+ *
+ * node-pty's prebuilt darwin-{arm64,x64} packages ship the `spawn-helper`
+ * binary with mode 644 instead of 755. posix_spawnp can't exec it, so the
+ * first pty.spawn() call throws with "posix_spawnp failed". The fix is a
+ * 1-line chmod; without it the agent panel's claude subprocess fails to
+ * start with a misleading "no stdin data received" error.
+ *
+ * Pattern lifted from siteboon/claudecodeui (scripts/fix-node-pty.js).
+ * Upstream issue: https://github.com/microsoft/node-pty/issues/850
+ */
+
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+async function fixSpawnHelper() {
+  if (process.platform !== 'darwin') return;
+
+  // The script ships in two places depending on context:
+  //   - dev: client/scripts/fix-node-pty.mjs    (uses ../node_modules)
+  //   - published: client/dist/scripts/         (uses ../../node_modules)
+  // Try both upward paths.
+  const candidateRoots = [
+    path.join(__dirname, '..'),
+    path.join(__dirname, '..', '..'),
+  ];
+
+  let prebuildsDir = null;
+  for (const root of candidateRoots) {
+    const candidate = path.join(root, 'node_modules', 'node-pty', 'prebuilds');
+    try {
+      await fs.access(candidate);
+      prebuildsDir = candidate;
+      break;
+    } catch {
+      // try next
+    }
+  }
+  if (!prebuildsDir) return; // node-pty not installed; nothing to fix
+
+  for (const dir of ['darwin-arm64', 'darwin-x64']) {
+    const helper = path.join(prebuildsDir, dir, 'spawn-helper');
+    try {
+      await fs.access(helper);
+      await fs.chmod(helper, 0o755);
+      console.log(`[postinstall] chmod 755 ${helper}`);
+    } catch (err) {
+      if (err && err.code !== 'ENOENT') {
+        console.warn(`[postinstall] could not fix ${helper}: ${err.message}`);
+      }
+    }
+  }
+}
+
+fixSpawnHelper().catch((err) => {
+  console.warn('[postinstall] fix-node-pty failed (non-fatal):', err.message);
+});

package/dist/setup/claude-code-install.d.ts

@@ -0,0 +1,19 @@
+export interface LocalClaudeCodeInstallResult {
+    ok: boolean;
+    claudePath?: string;
+    detail: string;
+}
+export type ExecFileAsync = (file: string, args: string[], opts: {
+    timeout: number;
+    maxBuffer: number;
+}) => Promise<{
+    stdout: string;
+    stderr: string;
+}>;
+export interface LocalClaudeCodeInstallOptions {
+    installRoot?: string;
+    execFileAsync?: ExecFileAsync;
+}
+export declare function defaultClaudeCodeInstallRoot(): string;
+export declare function claudeBinaryPathForInstallRoot(installRoot: string): string;
+export declare function installClaudeCodeLocally(opts?: LocalClaudeCodeInstallOptions): Promise<LocalClaudeCodeInstallResult>;

package/dist/setup/claude-code-install.js

@@ -0,0 +1,51 @@
+import { constants as fsConstants, promises as fs } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+const execFileAsync = promisify(execFile);
+export function defaultClaudeCodeInstallRoot() {
+    return join(homedir(), '.jinn-client', 'tools', 'claude-code');
+}
+export function claudeBinaryPathForInstallRoot(installRoot) {
+    return join(installRoot, 'node_modules', '.bin', 'claude');
+}
+function compactInstallFailure(err) {
+    const e = err;
+    const raw = e.stderr || e.stdout || e.message || String(err);
+    return raw.split('\n').map((line) => line.trim()).filter(Boolean).slice(0, 4).join(' ');
+}
+export async function installClaudeCodeLocally(opts = {}) {
+    const installRoot = opts.installRoot ?? defaultClaudeCodeInstallRoot();
+    const run = opts.execFileAsync ?? execFileAsync;
+    await fs.mkdir(installRoot, { recursive: true, mode: 0o700 });
+    try {
+        await run('npm', [
+            'install',
+            '--prefix',
+            installRoot,
+            '@anthropic-ai/claude-code@latest',
+            '--omit=dev',
+            '--no-audit',
+            '--no-fund',
+        ], { timeout: 180_000, maxBuffer: 2 * 1024 * 1024 });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            detail: `Claude Code install failed: ${compactInstallFailure(err)}`,
+        };
+    }
+    const claudePath = claudeBinaryPathForInstallRoot(installRoot);
+    try {
+        await fs.access(claudePath, fsConstants.X_OK);
+        return { ok: true, claudePath, detail: 'Claude Code installed' };
+    }
+    catch {
+        return {
+            ok: false,
+            detail: `Claude Code install completed, but no executable was found at ${claudePath}`,
+        };
+    }
+}
+//# sourceMappingURL=claude-code-install.js.map

package/dist/setup/claude-code-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-install.js","sourceRoot":"","sources":["../../src/setup/claude-code-install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,WAAW,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAmB1C,MAAM,UAAU,4BAA4B;IAC1C,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,WAAmB;IAChE,OAAO,IAAI,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,qBAAqB,CAAC,GAAY;IACzC,MAAM,CAAC,GAAG,GAA6D,CAAC;IACxE,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1F,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAsC,EAAE;IAExC,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,4BAA4B,EAAE,CAAC;IACvE,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,IAAI,aAAa,CAAC;IAChD,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAE9D,IAAI,CAAC;QACH,MAAM,GAAG,CACP,KAAK,EACL;YACE,SAAS;YACT,UAAU;YACV,WAAW;YACX,kCAAkC;YAClC,YAAY;YACZ,YAAY;YACZ,WAAW;SACZ,EACD,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI,EAAE,CACjD,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,+BAA+B,qBAAqB,CAAC,GAAG,CAAC,EAAE;SACpE,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,8BAA8B,CAAC,WAAW,CAAC,CAAC;IAC/D,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,iEAAiE,UAAU,EAAE;SACtF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/setup-mode.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Setup-mode controller for the daemon.
+ *
+ * The daemon process can be in two states:
+ * - 'setup'   — Hono API + operator MCP are up, but the daemon loops
+ *               (creator, engine-watcher, delivery-watcher, ...) are gated.
+ *               Used when the keystore is missing or bootstrap is incomplete.
+ * - 'running' — All loops are active.
+ *
+ * `computeDaemonMode` is a pure function from inputs to mode.
+ * `createSetupModeController` wraps it with a small state machine that supports
+ * `refresh()` on input changes and `waitUntilRunning()` for callers that need
+ * to gate their start-up on the running transition.
+ */
+export type DaemonMode = 'setup' | 'running';
+export interface DaemonModeInputs {
+    /** True when the master keystore exists on disk. */
+    keystoreExists: boolean;
+    /** True when every service in the fleet is operational (`complete` or `safe_binding_pending`). */
+    allComplete: boolean;
+}
+export declare function computeDaemonMode(inputs: DaemonModeInputs): DaemonMode;
+export interface SetupModeController {
+    /** Current mode. */
+    mode(): DaemonMode;
+    /**
+     * Resolves once the mode is or becomes 'running'. If already running,
+     * resolves on next microtask.
+     */
+    waitUntilRunning(): Promise<void>;
+    /** Re-evaluate the mode based on the input thunks. */
+    refresh(inputs: DaemonModeInputs): void;
+}
+export declare function createSetupModeController(initial: DaemonModeInputs): SetupModeController;

package/dist/setup-mode.js

@@ -0,0 +1,49 @@
+/**
+ * Setup-mode controller for the daemon.
+ *
+ * The daemon process can be in two states:
+ * - 'setup'   — Hono API + operator MCP are up, but the daemon loops
+ *               (creator, engine-watcher, delivery-watcher, ...) are gated.
+ *               Used when the keystore is missing or bootstrap is incomplete.
+ * - 'running' — All loops are active.
+ *
+ * `computeDaemonMode` is a pure function from inputs to mode.
+ * `createSetupModeController` wraps it with a small state machine that supports
+ * `refresh()` on input changes and `waitUntilRunning()` for callers that need
+ * to gate their start-up on the running transition.
+ */
+export function computeDaemonMode(inputs) {
+    if (!inputs.keystoreExists)
+        return 'setup';
+    if (!inputs.allComplete)
+        return 'setup';
+    return 'running';
+}
+export function createSetupModeController(initial) {
+    let current = computeDaemonMode(initial);
+    const waiters = [];
+    return {
+        mode: () => current,
+        waitUntilRunning: () => {
+            if (current === 'running')
+                return Promise.resolve();
+            return new Promise((resolve) => waiters.push(resolve));
+        },
+        refresh: (inputs) => {
+            const next = computeDaemonMode(inputs);
+            if (next === current)
+                return;
+            current = next;
+            if (next === 'running') {
+                while (waiters.length > 0) {
+                    const w = waiters.shift();
+                    try {
+                        w?.();
+                    }
+                    catch { /* swallow waiter errors */ }
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=setup-mode.js.map

package/dist/setup-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-mode.js","sourceRoot":"","sources":["../src/setup-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,IAAI,CAAC,MAAM,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC;IACxC,OAAO,SAAS,CAAC;AACnB,CAAC;AAcD,MAAM,UAAU,yBAAyB,CAAC,OAAyB;IACjE,IAAI,OAAO,GAAe,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO;QAEnB,gBAAgB,EAAE,GAAG,EAAE;YACrB,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YACpD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;YAClB,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,IAAI,KAAK,OAAO;gBAAE,OAAO;YAC7B,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBAAC,CAAC,EAAE,EAAE,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/solver-nets/contracts.d.ts

@@ -0,0 +1,2 @@
+export { PREDICTION_V1_SOLVER_NET_CONTRACT, SOLVER_NET_CONTRACTS, getSolverNetContract, } from '../vendor/@jinn-network/sdk/dist/solvernets/index.js';
+export type { SolverNetContractRole, CredentialRequirement, SolverNetEvaluationFunction, SolverNetAggregationFunction, SolverNetClaimPolicyDefaults, SolverNetContract, } from '../vendor/@jinn-network/sdk/dist/solvernets/index.js';

package/dist/solver-nets/contracts.js

@@ -0,0 +1,2 @@
+export { PREDICTION_V1_SOLVER_NET_CONTRACT, SOLVER_NET_CONTRACTS, getSolverNetContract, } from '../vendor/@jinn-network/sdk/dist/solvernets/index.js';
+//# sourceMappingURL=contracts.js.map

package/dist/solver-nets/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/solver-nets/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iCAAiC,EACjC,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,8BAA8B,CAAC"}

package/dist/solver-nets/prediction-operator-ux.d.ts

@@ -0,0 +1,112 @@
+import type { JinnConfig } from '../config.js';
+import { loadExternalImpl as defaultLoadExternalImpl } from '../harnesses/external-impls/index.js';
+import { buildHarnesses as defaultBuildHarnesses } from '../harnesses/impls/index.js';
+import { PredictionV1BaselineImpl } from '../harnesses/impls/prediction-v1-baseline/index.js';
+import type { ReadyStatus, RuntimePlugin } from '../harnesses/types.js';
+import { type PredictionV1Task } from '../types/prediction-v1.js';
+import { loadSolverNets as defaultLoadSolverNets, type SolverNetOperatorRole } from './registry.js';
+export type PredictionOperatorDiagnosticSeverity = 'error' | 'warning' | 'info';
+export interface PredictionOperatorDiagnostic {
+    code: string;
+    severity: PredictionOperatorDiagnosticSeverity;
+    message: string;
+    configField?: string;
+    nextAction?: {
+        description: string;
+        cli?: string;
+        url?: string;
+    };
+}
+export interface PredictionOperatorStatus {
+    kind: 'prediction.v1.operatorStatus';
+    ok: boolean;
+    configPath: string;
+    solverNet: {
+        name: string;
+        enabled: boolean;
+        solverType: string;
+        /**
+         * Active operator roles for this SolverNet. Reflects the operator's
+         * current configuration, not the catalog of supported roles. Both
+         * `'solving'` and `'evaluating'` may be present concurrently — the
+         * Overview surface renders them additively.
+         */
+        roles: SolverNetOperatorRole[];
+        harness?: string;
+        taskGeneratorEnabled: boolean;
+    };
+    runtimePlugins: PredictionPluginStatus[];
+    harness?: {
+        name: string;
+        version: string;
+        supportsPredictionV1Restoration: boolean;
+        readiness: ReadyStatus;
+    };
+    diagnostics: PredictionOperatorDiagnostic[];
+    nextAction: {
+        description: string;
+        cli?: string;
+        url?: string;
+    };
+}
+export interface PredictionPluginStatus {
+    provenance: RuntimePlugin['provenance'];
+    source: string | null;
+    name?: string;
+    version?: string;
+    supports?: string[];
+    root?: string;
+    manifestPath?: string;
+    sha256?: string;
+    cid?: string;
+}
+export interface PredictionSampleRun {
+    kind: 'prediction.v1.sampleRun';
+    ok: boolean;
+    task: {
+        id: string;
+        question: string;
+        window: PredictionV1Task['window'];
+    };
+    harness: {
+        name: string;
+        version: string;
+    };
+    solution?: {
+        probabilityYes?: unknown;
+        submittedAt?: unknown;
+        modelId?: unknown;
+        payload: Record<string, unknown>;
+        artifactPath: string;
+        workingDir: string;
+    };
+    diagnostics: PredictionOperatorDiagnostic[];
+}
+type BuildHarnesses = typeof defaultBuildHarnesses;
+type LoadExternalImpl = typeof defaultLoadExternalImpl;
+type LoadSolverNets = typeof defaultLoadSolverNets;
+export interface BuildPredictionOperatorStatusOptions {
+    config: JinnConfig;
+    configPath: string;
+    name?: string;
+    buildHarnesses?: BuildHarnesses;
+    loadExternalImpl?: LoadExternalImpl;
+    loadSolverNets?: LoadSolverNets;
+    /** True when this status is being built for a running daemon. Suppresses
+     *  the vacuous "start the daemon" nextAction copy and replaces it with a
+     *  "waiting for tasks" message. See Issue #86 §1. */
+    daemonRunning?: boolean;
+}
+export interface RunPredictionSampleOptions {
+    now?: number;
+    closedWindow?: boolean;
+    workingRoot?: string;
+    harness?: PredictionV1BaselineImpl;
+}
+export declare function buildPredictionOperatorStatus({ config, configPath, name, buildHarnesses, loadExternalImpl, loadSolverNets, daemonRunning, }: BuildPredictionOperatorStatusOptions): Promise<PredictionOperatorStatus>;
+export declare function buildSamplePredictionV1Task(options?: {
+    now?: number;
+    closedWindow?: boolean;
+}): PredictionV1Task;
+export declare function runPredictionSample({ now, closedWindow, workingRoot, harness, }?: RunPredictionSampleOptions): Promise<PredictionSampleRun>;
+export {};