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

package/dist/harnesses/impls/claude-mcp-shared/single-session-orchestrator.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Shared single-session orchestrator for the claude-mcp-prediction* impls.
+ *
+ * Both `claude-mcp-prediction` (probability) and `claude-mcp-prediction-apy`
+ * (integer APY bps) follow the same single-session shape:
+ *
+ *   1. Spawn Claude with a prompt + a single allowed MCP tool namespace.
+ *   2. Poll a shared "submitted" flag to detect the submit-tool call.
+ *   3. Terminate after a short grace period so Claude's tool response reaches it.
+ *
+ * The only differences across the two variants are:
+ *   - the `--allowedTools` value (e.g. `mcp__jinn-prediction__*`)
+ *   - log prefixes (e.g. `prediction-session` vs `apy-prediction-session`)
+ *   - the named submit-tool referenced in log lines (cosmetic)
+ *
+ * Hyperliquid uses a different shape (cadence + market-move trigger) and is
+ * intentionally not refactored through this module.
+ *
+ * Slimmed-down version of:
+ *   client/src/harnesses/impls/claude-mcp-hyperliquid/session-orchestrator.ts:97-209
+ */
+import { spawn } from 'node:child_process';
+import type { TrajectoryCollector } from '../../../trajectory/index.js';
+export interface SingleSessionResult {
+    sessionId: string;
+    startedAt: number;
+    endedAt: number;
+    transcriptPath: string;
+    /** True iff the configured submit tool was invoked before timeout/abort. */
+    submitted: boolean;
+    /** Accumulated stdout for post-mortem. */
+    stdout: string;
+    aborted: boolean;
+}
+export interface SingleSessionConfig {
+    /**
+     * Value passed to `--allowedTools`, e.g. `mcp__jinn-prediction__*` or
+     * `mcp__jinn-apy-prediction__*`.
+     */
+    allowedTools: string;
+    /**
+     * Short tag used as the prefix for log lines, e.g. `prediction-session` or
+     * `apy-prediction-session`.
+     */
+    logTag: string;
+    /**
+     * Name of the submit tool, used only in human-readable log messages
+     * (e.g. `submit_prediction`, `submit_apy_prediction`).
+     */
+    submissionToolName: string;
+}
+export interface SingleSessionDeps {
+    claudePath: string;
+    claudeModel?: string;
+    mcpConfigPath: string;
+    workingDir: string;
+    abort: AbortSignal;
+    log: (event: {
+        level: 'info' | 'warn' | 'error';
+        msg: string;
+        data?: unknown;
+    }) => void;
+    /** Poll callback — returns true once the submit tool has been invoked. */
+    isSubmitted: () => boolean;
+    /** Max wall time for the session (ms). Default 3 min. */
+    sessionMaxMs?: number;
+    /** Interval at which we poll isSubmitted (ms). Default 500. */
+    pollIntervalMs?: number;
+    /** Grace period after submission before killing Claude (ms). Default 2s. */
+    submissionGraceMs?: number;
+    /** Injected spawn fn for tests. Defaults to child_process.spawn. */
+    _spawnFn?: typeof spawn;
+    /**
+     * Trajectory collector — when present, each session spawn emits a
+     * jinn.state_transition span covering the subprocess lifetime.
+     * Scope §3.2 traced-I/O boundary.
+     */
+    trajectory?: TrajectoryCollector;
+}
+/**
+ * Spawn a single Claude session, poll for a submit-tool flag, and resolve
+ * with the session result once the child exits.
+ */
+export declare function runSingleSession(sessionId: string, prompt: string, config: SingleSessionConfig, deps: SingleSessionDeps): Promise<SingleSessionResult>;

package/dist/harnesses/impls/claude-mcp-shared/single-session-orchestrator.js

@@ -0,0 +1,206 @@
+/**
+ * Shared single-session orchestrator for the claude-mcp-prediction* impls.
+ *
+ * Both `claude-mcp-prediction` (probability) and `claude-mcp-prediction-apy`
+ * (integer APY bps) follow the same single-session shape:
+ *
+ *   1. Spawn Claude with a prompt + a single allowed MCP tool namespace.
+ *   2. Poll a shared "submitted" flag to detect the submit-tool call.
+ *   3. Terminate after a short grace period so Claude's tool response reaches it.
+ *
+ * The only differences across the two variants are:
+ *   - the `--allowedTools` value (e.g. `mcp__jinn-prediction__*`)
+ *   - log prefixes (e.g. `prediction-session` vs `apy-prediction-session`)
+ *   - the named submit-tool referenced in log lines (cosmetic)
+ *
+ * Hyperliquid uses a different shape (cadence + market-move trigger) and is
+ * intentionally not refactored through this module.
+ *
+ * Slimmed-down version of:
+ *   client/src/harnesses/impls/claude-mcp-hyperliquid/session-orchestrator.ts:97-209
+ */
+import { appendFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { spawn } from 'node:child_process';
+const DEFAULT_SESSION_MAX_MS = 180_000;
+const DEFAULT_POLL_INTERVAL_MS = 500;
+const DEFAULT_SUBMISSION_GRACE_MS = 2_000;
+/**
+ * Spawn a single Claude session, poll for a submit-tool flag, and resolve
+ * with the session result once the child exits.
+ */
+export async function runSingleSession(sessionId, prompt, config, deps) {
+    const sessionMaxMs = deps.sessionMaxMs ?? DEFAULT_SESSION_MAX_MS;
+    const pollIntervalMs = deps.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    const submissionGraceMs = deps.submissionGraceMs ?? DEFAULT_SUBMISSION_GRACE_MS;
+    const sessionDir = join(deps.workingDir, 'sessions', sessionId);
+    mkdirSync(sessionDir, { recursive: true });
+    const transcriptPath = join(sessionDir, 'transcript.txt');
+    const startedAt = Date.now();
+    const startNs = `${BigInt(startedAt) * 1000000n}`;
+    writeFileSync(transcriptPath, `=== Session ${sessionId} started at ${new Date(startedAt).toISOString()} ===\n\n`);
+    const args = [
+        '-p', prompt,
+        '--mcp-config', deps.mcpConfigPath,
+        '--strict-mcp-config',
+        '--allowedTools', config.allowedTools,
+    ];
+    if (deps.claudeModel)
+        args.push('--model', deps.claudeModel);
+    // Minimal env allowlist — same set as the HL orchestrator.
+    const agentEnv = {};
+    for (const key of [
+        'PATH', 'HOME', 'USER', 'SHELL', 'LANG', 'TERM', 'TMPDIR',
+        'XDG_CONFIG_HOME', 'XDG_DATA_HOME', 'XDG_CACHE_HOME',
+        'NODE_PATH', 'NODE_OPTIONS', 'NPM_CONFIG_PREFIX',
+        // Anthropic auth — required for Claude Code to reach the model.
+        'CLAUDE_CODE_OAUTH_TOKEN', 'ANTHROPIC_API_KEY',
+    ]) {
+        if (process.env[key])
+            agentEnv[key] = process.env[key];
+    }
+    deps.log({
+        level: 'info',
+        msg: `${config.logTag}: spawning ${sessionId}`,
+        data: { claudePath: deps.claudePath },
+    });
+    const spawnFn = deps._spawnFn ?? spawn;
+    return new Promise((resolve) => {
+        const child = spawnFn(deps.claudePath, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: agentEnv,
+        });
+        let stdout = '';
+        let aborted = false;
+        let terminatedEarly = false;
+        child.stdout?.on('data', (d) => {
+            const chunk = d.toString();
+            stdout += chunk;
+            appendFileSync(transcriptPath, chunk);
+        });
+        child.stderr?.on('data', (d) => {
+            appendFileSync(transcriptPath, `[stderr] ${d.toString()}`);
+        });
+        const sessionTimeout = setTimeout(() => {
+            if (!child.killed) {
+                deps.log({
+                    level: 'warn',
+                    msg: `${config.logTag}: ${sessionId} reached sessionMaxMs; killing`,
+                    data: { sessionMaxMs },
+                });
+                child.kill('SIGTERM');
+            }
+        }, sessionMaxMs);
+        // Poll for the submit tool: once the flag flips, give Claude a short grace
+        // window to receive the tool response + close the connection, then SIGTERM.
+        let graceTimer = null;
+        const pollTimer = setInterval(() => {
+            if (graceTimer || child.killed)
+                return;
+            if (deps.isSubmitted()) {
+                deps.log({
+                    level: 'info',
+                    msg: `${config.logTag}: ${sessionId} ${config.submissionToolName} invoked; scheduling graceful termination`,
+                });
+                terminatedEarly = true;
+                graceTimer = setTimeout(() => {
+                    if (!child.killed)
+                        child.kill('SIGTERM');
+                }, submissionGraceMs);
+            }
+        }, pollIntervalMs);
+        const onAbort = () => {
+            if (aborted)
+                return;
+            aborted = true;
+            deps.log({ level: 'info', msg: `${config.logTag}: ${sessionId} window abort; killing` });
+            child.kill('SIGTERM');
+        };
+        deps.abort.addEventListener('abort', onAbort);
+        const cleanup = () => {
+            clearTimeout(sessionTimeout);
+            if (graceTimer)
+                clearTimeout(graceTimer);
+            clearInterval(pollTimer);
+            deps.abort.removeEventListener('abort', onAbort);
+        };
+        child.on('exit', (code, signal) => {
+            cleanup();
+            const endedAt = Date.now();
+            const endNs = `${BigInt(endedAt) * 1000000n}`;
+            appendFileSync(transcriptPath, `\n\n=== Session ended at ${new Date(endedAt).toISOString()} (code=${code} signal=${signal} submitted=${deps.isSubmitted()} terminatedEarly=${terminatedEarly} aborted=${aborted}) ===\n`);
+            deps.log({
+                level: 'info',
+                msg: `${config.logTag}: ${sessionId} exited`,
+                data: { code, signal, durationMs: endedAt - startedAt, submitted: deps.isSubmitted(), aborted },
+            });
+            const exitCode = code ?? -1;
+            deps.trajectory?.addSpan({
+                name: `subprocess.${deps.claudePath}`,
+                kind: 'INTERNAL',
+                startTimeUnixNano: startNs,
+                endTimeUnixNano: endNs,
+                attributes: {
+                    'jinn.span.kind': 'jinn.state_transition',
+                    'jinn.state.from': 'PREPARED',
+                    'jinn.state.to': 'RAN_CLAUDE',
+                    'subprocess.cmd': deps.claudePath,
+                    'subprocess.args': args,
+                    'subprocess.exit_code': exitCode,
+                    'session.id': sessionId,
+                    'prediction.submitted': deps.isSubmitted(),
+                },
+                events: [],
+                status: exitCode === 0 || signal ? { code: 'OK' } : { code: 'ERROR', message: `exit ${exitCode}` },
+            });
+            resolve({
+                sessionId,
+                startedAt,
+                endedAt,
+                transcriptPath,
+                submitted: deps.isSubmitted(),
+                stdout,
+                aborted: aborted || deps.abort.aborted,
+            });
+        });
+        child.on('error', (err) => {
+            cleanup();
+            const endedAt = Date.now();
+            const endNs = `${BigInt(endedAt) * 1000000n}`;
+            appendFileSync(transcriptPath, `\n\n=== Session spawn error: ${err.message} ===\n`);
+            deps.log({
+                level: 'error',
+                msg: `${config.logTag}: ${sessionId} spawn error`,
+                data: { err: err.message },
+            });
+            deps.trajectory?.addSpan({
+                name: `subprocess.${deps.claudePath}`,
+                kind: 'INTERNAL',
+                startTimeUnixNano: startNs,
+                endTimeUnixNano: endNs,
+                attributes: {
+                    'jinn.span.kind': 'jinn.state_transition',
+                    'jinn.state.from': 'PREPARED',
+                    'jinn.state.to': 'RAN_CLAUDE',
+                    'subprocess.cmd': deps.claudePath,
+                    'subprocess.args': args,
+                    'subprocess.exit_code': -1,
+                    'session.id': sessionId,
+                    'prediction.submitted': deps.isSubmitted(),
+                },
+                events: [{ timeUnixNano: endNs, name: 'exception', attributes: { 'exception.message': err.message } }],
+                status: { code: 'ERROR', message: err.message },
+            });
+            resolve({
+                sessionId,
+                startedAt,
+                endedAt,
+                transcriptPath,
+                submitted: deps.isSubmitted(),
+                stdout,
+                aborted: deps.abort.aborted,
+            });
+        });
+    });
+}
+//# sourceMappingURL=single-session-orchestrator.js.map

package/dist/harnesses/impls/claude-mcp-shared/single-session-orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"single-session-orchestrator.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-mcp-shared/single-session-orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/harnesses/impls/evaluation-context.d.ts

@@ -0,0 +1,23 @@
+import type { Task } from '../../types/task.js';
+/** Eval `Task.context` key for the restoration job's intended-state IPFS CID (not the eval job's). */
+export declare const RESTORATION_TASK_CID_CONTEXT_KEY: "restorationTaskCid";
+/**
+ * Eval `Task.context` key for the restoration envelope's IPFS CID.
+ * Set by the daemon when creating evaluation jobs so evaluators can populate the
+ * `restorationEnvelope.cid` back-reference in the verdict payload without a
+ * synchronous IPFS round-trip at verdict time.
+ */
+export declare const RESTORATION_ENVELOPE_CID_CONTEXT_KEY: "restorationEnvelopeCid";
+/**
+ * Resolve the expected restoration task CID for `integrity.signedTask_ref`.
+ * Test-only overrides win; otherwise the value must be present in `context`.
+ * There is no fallback to the evaluation job's `taskCid` (wrong reference).
+ */
+export declare function resolveExpectedRestorationTaskCid(task: Task, testDeps?: {
+    expectedTaskCid?: string;
+}): {
+    kind: 'resolved';
+    cid: string;
+} | {
+    kind: 'missing';
+};

package/dist/harnesses/impls/evaluation-context.js

@@ -0,0 +1,25 @@
+/** Eval `Task.context` key for the restoration job's intended-state IPFS CID (not the eval job's). */
+export const RESTORATION_TASK_CID_CONTEXT_KEY = 'restorationTaskCid';
+/**
+ * Eval `Task.context` key for the restoration envelope's IPFS CID.
+ * Set by the daemon when creating evaluation jobs so evaluators can populate the
+ * `restorationEnvelope.cid` back-reference in the verdict payload without a
+ * synchronous IPFS round-trip at verdict time.
+ */
+export const RESTORATION_ENVELOPE_CID_CONTEXT_KEY = 'restorationEnvelopeCid';
+/**
+ * Resolve the expected restoration task CID for `integrity.signedTask_ref`.
+ * Test-only overrides win; otherwise the value must be present in `context`.
+ * There is no fallback to the evaluation job's `taskCid` (wrong reference).
+ */
+export function resolveExpectedRestorationTaskCid(task, testDeps) {
+    if (testDeps?.expectedTaskCid) {
+        return { kind: 'resolved', cid: testDeps.expectedTaskCid };
+    }
+    const v = task.context?.[RESTORATION_TASK_CID_CONTEXT_KEY];
+    if (typeof v === 'string' && v.length > 0) {
+        return { kind: 'resolved', cid: v };
+    }
+    return { kind: 'missing' };
+}
+//# sourceMappingURL=evaluation-context.js.map

package/dist/harnesses/impls/evaluation-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation-context.js","sourceRoot":"","sources":["../../../src/harnesses/impls/evaluation-context.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,MAAM,CAAC,MAAM,gCAAgC,GAAG,oBAA6B,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oCAAoC,GAAG,wBAAiC,CAAC;AAEtF;;;;GAIG;AACH,MAAM,UAAU,iCAAiC,CAC/C,IAAU,EACV,QAAuC;IAEvC,IAAI,QAAQ,EAAE,eAAe,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,CAAC,eAAe,EAAE,CAAC;IAC7D,CAAC;IACD,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC,gCAAgC,CAAC,CAAC;IAC3D,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;IACtC,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC"}

package/dist/harnesses/impls/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Single construction site for all first-party {@link Harness} instances.
+ * Used by the daemon entrypoint and `jinn solver-nets` CLI (stub mode).
+ */
+import type { Runner, RunnerContext } from '../../runner/runner.js';
+import type { Harness } from '../types.js';
+/**
+ * Environment passed to {@link buildHarnesses} — same shape for daemon
+ * (live creds) and CLI introspection (stub: true, optional runner).
+ */
+export interface HarnessEnv {
+    /** When true, CLI path — impls report `requires live daemon` from `isReady()`. */
+    stub?: boolean;
+    /** Agent EOA private key (daemon). */
+    pk?: `0x${string}`;
+    /** Service Safe address (daemon). */
+    safe?: `0x${string}`;
+    rpcUrl: string;
+    archiveRpcUrl?: string;
+    claudePath: string;
+    claudeModel: string;
+    /**
+     * Required for production registry when `legacy-claude` is included.
+     * Omitted in stub CLI registries.
+     */
+    runner?: Runner;
+    /** e.g. `http://127.0.0.1:${apiPort}` for {@link LegacyClaudeImpl} */
+    daemonApiUrl?: string;
+    /**
+     * Bearer token for daemon API cost-mutating routes (forwarded to the MCP
+     * subprocess via env). Mirrors `daemonApiUrl` exactly.
+     */
+    daemonApiToken?: string;
+    /** SQLite store path for MCP artifact handoff in {@link LegacyClaudeImpl}. */
+    storePath?: string;
+    /**
+     * Legacy-claude runner working directory (defaults to /tmp if unset).
+     */
+    legacyClaudeWorkingDirectory?: string;
+    /**
+     * Corpus env for {@link LegacyClaudeImpl} / MCP `jinn-client` record lookup
+     * and artifact acquisition tools.
+     */
+    corpusEnv?: RunnerContext['corpusEnv'];
+    /** Path to the `codex` executable. Defaults to `codex`. */
+    codexPath?: string;
+    /** Default Codex model when a SolverNet does not specify one. */
+    codexModel?: string;
+    /**
+     * Root for impl-scoped state dirs (e.g. hyperliquid api-wallet). Defaults under
+     * `~/.jinn-client/engine/impl-state` when unset — wired from `config.engine` in main.
+     */
+    implStateDirRoot?: string;
+    /**
+     * IPFS registry URL used by Harnesses that need to pin verdict-side
+     * artifacts (e.g. swe-rebench-v2 test logs). Optional — Harnesses that
+     * don't need IPFS leave this unused.
+     */
+    ipfsRegistryUrl?: string;
+    /**
+     * Pre-loaded external (operator-supplied) Harnesses — produced by
+     * `loadExternalImpl()` in `client/src/harnesses/external-impls/`. Appended to
+     * the in-repo construction list. See plan
+     * `docs/superpowers/plans/2026-04-30-plug-in-surface-path-2-foundation.md`
+     * step 5.7.
+     */
+    externalImpls?: readonly Harness[];
+    /**
+     * Impl names to filter out of the returned list entirely (different from
+     * `HarnessRegistry.disabled`, which only suppresses dispatch). Useful
+     * when a fleet wants to construct without paying the cost of an in-repo
+     * impl that has external deps.
+     */
+    disabledNames?: readonly string[];
+}
+/**
+ * Build the canonical ordered list of first-party restoration/evaluation Harnesses.
+ * Registration order is stable: it matches historical `main.ts` first-match
+ * behavior for `HarnessRegistry`.
+ *
+ * The claude-code Harness is registered as the default peer Harness;
+ * it no longer wraps specialists.
+ */
+export declare function buildHarnesses(env: HarnessEnv): Harness[];

package/dist/harnesses/impls/index.js

@@ -0,0 +1,136 @@
+/**
+ * Single construction site for all first-party {@link Harness} instances.
+ * Used by the daemon entrypoint and `jinn solver-nets` CLI (stub mode).
+ */
+import { LegacyClaudeImpl } from './legacy-claude/index.js';
+import { ClaudeMcpHyperliquidImpl } from './claude-mcp-hyperliquid/index.js';
+import { PortfolioV0Evaluator } from './portfolio-v0-evaluator/index.js';
+import { PredictionV1BaselineImpl } from './prediction-v1-baseline/index.js';
+import { PredictionV1Evaluator } from './prediction-v1-evaluator/index.js';
+import { ClaudeMcpPredictionImpl } from './claude-mcp-prediction/index.js';
+import { PredictionApyV0BaselineImpl } from './prediction-apy-v0-baseline/index.js';
+import { ClaudeMcpPredictionApyImpl } from './claude-mcp-prediction-apy/index.js';
+import { PredictionApyV0Evaluator } from './prediction-apy-v0-evaluator/index.js';
+import { ClaudeCodeLearnerImpl, } from './claude-code-learner/index.js';
+import { ClaudeCodeHarnessAdapter, CodexCodeHarnessAdapter } from './claude-code-learner/index.js';
+import { SweRebenchV2EvaluatorHarness } from './swe-rebench-v2-evaluator/harness.js';
+import { canonicalHarnessName, canonicalHarnessNameSet, CODEX_HARNESS, } from '../names.js';
+/**
+ * Build the canonical ordered list of first-party restoration/evaluation Harnesses.
+ * Registration order is stable: it matches historical `main.ts` first-match
+ * behavior for `HarnessRegistry`.
+ *
+ * The claude-code Harness is registered as the default peer Harness;
+ * it no longer wraps specialists.
+ */
+export function buildHarnesses(env) {
+    const isStub = Boolean(env.stub);
+    if (!isStub) {
+        if (!env.pk)
+            throw new Error('buildHarnesses: pk is required when stub is not set');
+        if (!env.safe)
+            throw new Error('buildHarnesses: safe is required when stub is not set');
+    }
+    const out = [];
+    if (env.runner) {
+        out.push(new LegacyClaudeImpl({
+            runner: env.runner,
+            workingDirectory: env.legacyClaudeWorkingDirectory ?? '/tmp',
+            timeoutMs: 300_000,
+            storePath: env.storePath,
+            daemonApiUrl: env.daemonApiUrl,
+            daemonApiToken: env.daemonApiToken,
+            corpusEnv: env.corpusEnv,
+            stub: isStub,
+        }));
+    }
+    out.push(new ClaudeMcpHyperliquidImpl({
+        claudePath: env.claudePath,
+        claudeModel: env.claudeModel,
+        implStateDir: env.implStateDirRoot
+            ? `${env.implStateDirRoot}/claude-mcp-hyperliquid`
+            : undefined,
+        stub: isStub,
+    }));
+    out.push(isStub
+        ? new PortfolioV0Evaluator({ stub: true })
+        : new PortfolioV0Evaluator());
+    out.push(new PredictionV1BaselineImpl({
+        stub: isStub,
+    }));
+    out.push(new ClaudeMcpPredictionImpl({
+        claudePath: env.claudePath,
+        claudeModel: env.claudeModel,
+        rpcUrl: env.rpcUrl,
+        stub: isStub,
+    }));
+    out.push(isStub
+        ? new PredictionV1Evaluator({ stub: true })
+        : new PredictionV1Evaluator());
+    out.push(new PredictionApyV0BaselineImpl({
+        rpcUrl: env.rpcUrl,
+        archiveRpcUrl: env.archiveRpcUrl,
+        stub: isStub,
+    }));
+    out.push(new ClaudeMcpPredictionApyImpl({
+        claudePath: env.claudePath,
+        claudeModel: env.claudeModel,
+        rpcUrl: env.rpcUrl,
+        archiveRpcUrl: env.archiveRpcUrl,
+        stub: isStub,
+    }));
+    out.push(isStub
+        ? new PredictionApyV0Evaluator({ stub: true, rpcUrl: env.rpcUrl, archiveRpcUrl: env.archiveRpcUrl })
+        : new PredictionApyV0Evaluator({
+            evaluatorPk: env.pk,
+            evaluatorSafeAddress: env.safe,
+            rpcUrl: env.rpcUrl,
+            archiveRpcUrl: env.archiveRpcUrl,
+        }));
+    out.push(new SweRebenchV2EvaluatorHarness({
+        stub: isStub,
+        implStateDir: env.implStateDirRoot
+            ? `${env.implStateDirRoot}/swe-rebench-v2-evaluator`
+            : undefined,
+        ipfsRegistryUrl: env.ipfsRegistryUrl,
+    }));
+    // Operator-supplied external Harnesses are appended before the default learner
+    // so explicit SolverNet harness settings can select them.
+    if (env.externalImpls && env.externalImpls.length > 0) {
+        out.push(...env.externalImpls);
+    }
+    // Default Harness: handles any non-evaluation Task not claimed by a
+    // SolverNet specialist or evaluator.
+    const learnerAdapter = new ClaudeCodeHarnessAdapter({
+        claudePath: env.claudePath,
+        claudeModel: env.claudeModel,
+        storePath: env.storePath,
+        daemonApiUrl: env.daemonApiUrl,
+        daemonApiToken: env.daemonApiToken,
+        corpusEnv: env.corpusEnv,
+    });
+    out.push(new ClaudeCodeLearnerImpl({
+        adapter: learnerAdapter,
+    }));
+    // Codex-backed peer Harness. It supports the same restoration surface as
+    // claude-code, but is selected only by explicit SolverNet harness config so
+    // historical first-match fallback stays unchanged.
+    const codexLearnerAdapter = new CodexCodeHarnessAdapter({
+        codexPath: env.codexPath,
+        codexModel: env.codexModel,
+        storePath: env.storePath,
+        daemonApiUrl: env.daemonApiUrl,
+        daemonApiToken: env.daemonApiToken,
+        corpusEnv: env.corpusEnv,
+    });
+    out.push(new ClaudeCodeLearnerImpl({
+        name: CODEX_HARNESS,
+        adapter: codexLearnerAdapter,
+    }));
+    if (env.disabledNames && env.disabledNames.length > 0) {
+        const disabled = canonicalHarnessNameSet(env.disabledNames);
+        return out.filter((impl) => !disabled.has(canonicalHarnessName(impl.name)));
+    }
+    return out;
+}
+//# sourceMappingURL=index.js.map

package/dist/harnesses/impls/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/harnesses/impls/index.ts"],"names":[],"mappings":"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"}

package/dist/harnesses/impls/legacy-claude/index.d.ts

@@ -0,0 +1,66 @@
+/**
+ * legacy-claude — Harness fallback for health-check Tasks with no solverType.
+ *
+ * Wraps the existing ClaudeRunner so that Tasks with no solverType continue to
+ * work via the TaskEngine. Registered as the default fallback in the Harness
+ * registry (supports solverType === '').
+ *
+ * The engine calls findFor({ solverType: '' }) for these Tasks because
+ * PersistedTaskRun.solverType is null → coerced to '' in runImpl().
+ */
+import { type Runner, type RunnerContext } from '../../../runner/runner.js';
+import type { Harness, HarnessContext, Solution, ReadyStatus, EnableResult, HarnessEnableMetadata } from '../../types.js';
+export interface LegacyClaudeConfig {
+    runner: Runner;
+    /** Passed to RunnerContext. Defaults to /tmp */
+    workingDirectory?: string;
+    /** Timeout in ms passed to runner. Defaults to 300000 */
+    timeoutMs?: number;
+    /** Passed to runner for artifact storage */
+    storePath?: string;
+    /** Daemon API URL for MCP server */
+    daemonApiUrl?: string;
+    /**
+     * Bearer token for daemon API cost-mutating routes. Forwarded to the MCP
+     * subprocess via `DAEMON_API_TOKEN` env var.
+     */
+    daemonApiToken?: string;
+    /**
+     * Corpus credentials forwarded to {@link RunnerContext.corpusEnv} so MCP
+     * `search_records` / `inspect_record` can hit the keyless subgraph + IPFS
+     * gateway. The agent EOA private key never crosses into the subprocess —
+     * `acquire_artifact` proxies through `daemonApiUrl` (with `daemonApiToken`).
+     */
+    corpusEnv?: RunnerContext['corpusEnv'];
+    /**
+     * When true (e.g. synthetic registry), `isReady` reports the daemon is required.
+     * Production daemon should omit.
+     */
+    stub?: boolean;
+}
+export declare class LegacyClaudeImpl implements Harness {
+    private readonly config;
+    readonly name = "legacy-claude";
+    readonly version = "1.0.0";
+    constructor(config: LegacyClaudeConfig);
+    /**
+     * Supports the empty-string solverType produced by the engine for Tasks with no solverType.
+     * Legacy release-acceptance jobs use no SolverType for both restoration and evaluation,
+     * so both phases route through the Claude runner.
+     */
+    supports(ctx: {
+        solverType: string;
+        role?: 'restoration' | 'evaluation';
+    }): boolean;
+    canAttempt(): Promise<{
+        ok: true;
+    }>;
+    isReady(): Promise<ReadyStatus>;
+    enableMetadata(): HarnessEnableMetadata;
+    onEnable(_ctx: {
+        args: Record<string, string | undefined>;
+    }): Promise<EnableResult>;
+    run(ctx: HarnessContext): Promise<Solution>;
+    private recoverPublishedArtifact;
+}
+export default LegacyClaudeImpl;