@jinn-network/client 0.1.2 → 0.1.3-canary.24b69ea4

package/dist/runner/claude.d.ts

@@ -1,4 +1,4 @@
-import type { DesiredState, RestorationResult } from '../types/index.js';
+import type { Task, TaskResult } from '../types/index.js';
 import type { Runner, RunnerContext } from './runner.js';
 export interface ClaudeRunnerConfig {
     claudePath?: string;
@@ -10,6 +10,6 @@ export declare class ClaudeRunner implements Runner {
     private model?;
     private readonly mcpLauncher;
     constructor(config?: ClaudeRunnerConfig);
-    run(desiredState: DesiredState, context: RunnerContext): Promise<RestorationResult>;
+    run(task: Task, context: RunnerContext): Promise<TaskResult>;
 }
-export declare function buildPrompt(desiredState: DesiredState): string;
+export declare function buildPrompt(task: Task): string;

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":"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"}
+{"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/donation-consumption-acceptance.d.ts

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+/**
+ * Release-blocking two-operator donation consumption gate.
+ *
+ * This is intentionally not a mocked corpus test. It expects real testnet
+ * subgraph/IPFS discovery, a producer daemon with fresh donated SWE execution
+ * data, and a separate consumer operator home/db that can consume that data
+ * through the same MCP tools exposed to the learner runtime.
+ */
+type JsonRecord = Record<string, unknown>;
+interface LocalConfig {
+    network?: string;
+    rpcUrl?: string;
+    apiPort?: number;
+    dbPath?: string;
+    earningDir?: string;
+    subgraphUrl?: string;
+    ipfsGatewayUrl?: string;
+    ipfsRegistryUrl?: string;
+    pollIntervalMs?: number;
+    operator?: JsonRecord;
+    engine?: JsonRecord;
+    harnesses?: JsonRecord;
+    [key: string]: unknown;
+}
+interface ProducerArtifact {
+    sha256: string;
+    artifactType: string;
+    requestId: string | null;
+    envelopeCid: string;
+    createdAt: string;
+}
+interface VerifiedDonation {
+    artifact: ProducerArtifact;
+    sourceCid: string;
+    trajectorySourceCid: string;
+    envelope: JsonRecord;
+    redactedEnvelope: JsonRecord;
+    subgraphExecution: JsonRecord;
+}
+export declare function buildConsumerConfig(opts: {
+    producerConfig: LocalConfig;
+    consumerHome: string;
+    consumerPort: number;
+    subgraphUrl: string;
+    ipfsGatewayUrl: string;
+}): LocalConfig;
+export declare function ensureConsumerSweEvaluatorState(opts: {
+    producerConfig: LocalConfig;
+    producerHome: string;
+    consumerConfig: LocalConfig;
+    consumerHome: string;
+    evidenceDir?: string;
+}): string;
+export declare function resolveConsumerCodexHome(raw?: string): string | undefined;
+export declare function buildConsumerChildEnv(home: string, apiToken: string, codexHome?: string): NodeJS.ProcessEnv;
+export declare function waitForConsumerSolveAndEvaluatorProof(opts: {
+    storePath: string;
+    proof: VerifiedDonation;
+    startedAt: Date;
+    acquisitionStartedAt: Date;
+    acquisitionFinishedAt: Date;
+    reuseExisting: boolean;
+    deadline: number;
+    pollMs: number;
+}): Promise<{
+    networkRow: JsonRecord;
+    solution: JsonRecord;
+    verdict: JsonRecord;
+}>;
+export {};