@jinn-network/client 0.1.2 → 0.1.3-canary.2d6b2676

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/{restorer/impls/claude-mcp-prediction/session-orchestrator.js → harnesses/impls/claude-mcp-shared/single-session-orchestrator.js}

@@ -1,13 +1,23 @@
 /**
- * Session orchestrator for claude-mcp-prediction.
+ * Shared single-session orchestrator for the claude-mcp-prediction* impls.
  *
- * Single-session (no cadence loop, no market-move triggers). Spawns Claude
- * once with the prediction MCP + prompt, polls a shared "submitted" flag to
- * detect `submit_prediction` tool call, and terminates after a short grace
- * period so Claude's tool response reaches it.
+ * 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/restorer/impls/claude-mcp-hyperliquid/session-orchestrator.ts:97-209
+ *   client/src/harnesses/impls/claude-mcp-hyperliquid/session-orchestrator.ts:97-209
  */
 import { appendFileSync, mkdirSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
@@ -15,7 +25,11 @@ 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;
-export async function spawnSession(sessionId, prompt, deps) {
+/**
+ * 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;
@@ -23,12 +37,13 @@ export async function spawnSession(sessionId, prompt, deps) {
     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', 'mcp__jinn-prediction__*',
+        '--allowedTools', config.allowedTools,
     ];
     if (deps.claudeModel)
         args.push('--model', deps.claudeModel);
@@ -44,7 +59,11 @@ export async function spawnSession(sessionId, prompt, deps) {
         if (process.env[key])
             agentEnv[key] = process.env[key];
     }
-    deps.log({ level: 'info', msg: `prediction-session: spawning ${sessionId}`, data: { claudePath: deps.claudePath } });
+    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, {
@@ -64,18 +83,25 @@ export async function spawnSession(sessionId, prompt, deps) {
         });
         const sessionTimeout = setTimeout(() => {
             if (!child.killed) {
-                deps.log({ level: 'warn', msg: `prediction-session: ${sessionId} reached sessionMaxMs; killing`, data: { sessionMaxMs } });
+                deps.log({
+                    level: 'warn',
+                    msg: `${config.logTag}: ${sessionId} reached sessionMaxMs; killing`,
+                    data: { sessionMaxMs },
+                });
                 child.kill('SIGTERM');
             }
         }, sessionMaxMs);
-        // Poll for submit_prediction: once the flag flips, give Claude a short grace
+        // 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: `prediction-session: ${sessionId} submit_prediction invoked; scheduling graceful termination` });
+                deps.log({
+                    level: 'info',
+                    msg: `${config.logTag}: ${sessionId} ${config.submissionToolName} invoked; scheduling graceful termination`,
+                });
                 terminatedEarly = true;
                 graceTimer = setTimeout(() => {
                     if (!child.killed)
@@ -87,7 +113,7 @@ export async function spawnSession(sessionId, prompt, deps) {
             if (aborted)
                 return;
             aborted = true;
-            deps.log({ level: 'info', msg: `prediction-session: ${sessionId} window abort; killing` });
+            deps.log({ level: 'info', msg: `${config.logTag}: ${sessionId} window abort; killing` });
             child.kill('SIGTERM');
         };
         deps.abort.addEventListener('abort', onAbort);
@@ -101,12 +127,32 @@ export async function spawnSession(sessionId, prompt, deps) {
         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: `prediction-session: ${sessionId} exited`,
+                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,
@@ -120,8 +166,31 @@ export async function spawnSession(sessionId, prompt, deps) {
         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: `prediction-session: ${sessionId} spawn error`, data: { err: err.message } });
+            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,
@@ -134,4 +203,4 @@ export async function spawnSession(sessionId, prompt, deps) {
         });
     });
 }
-//# sourceMappingURL=session-orchestrator.js.map
+//# 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,74 @@
+/**
+ * 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` tools
+     * (`search_artifacts`, `acquire_artifact`).
+     */
+    corpusEnv?: RunnerContext['corpusEnv'];
+    /**
+     * 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;
+    /**
+     * 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-learner Harness is registered as the default peer Harness;
+ * it no longer wraps specialists.
+ */
+export declare function buildHarnesses(env: HarnessEnv): Harness[];

package/dist/{restorer → harnesses}/impls/index.js

@@ -1,6 +1,6 @@
 /**
- * Single construction site for all first-party {@link RestorerImpl} instances.
- * Used by the daemon entrypoint and `jinn intents` CLI (stub mode).
+ * 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';
@@ -11,18 +11,23 @@ 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 } from './claude-code-learner/index.js';
 /**
- * Build the canonical ordered list of first-party restorer / evaluator impls.
+ * Build the canonical ordered list of first-party restoration/evaluation Harnesses.
  * Registration order is stable: it matches historical `main.ts` first-match
- * behavior for `RestorerImplRegistry`.
+ * behavior for `HarnessRegistry`.
+ *
+ * The claude-code-learner Harness is registered as the default peer Harness;
+ * it no longer wraps specialists.
  */
-export function buildRestorerImpls(env) {
+export function buildHarnesses(env) {
     const isStub = Boolean(env.stub);
     if (!isStub) {
         if (!env.pk)
-            throw new Error('buildRestorerImpls: pk is required when stub is not set');
+            throw new Error('buildHarnesses: pk is required when stub is not set');
         if (!env.safe)
-            throw new Error('buildRestorerImpls: safe is required when stub is not set');
+            throw new Error('buildHarnesses: safe is required when stub is not set');
     }
     const out = [];
     if (env.runner) {
@@ -32,6 +37,8 @@ export function buildRestorerImpls(env) {
             timeoutMs: 300_000,
             storePath: env.storePath,
             daemonApiUrl: env.daemonApiUrl,
+            daemonApiToken: env.daemonApiToken,
+            corpusEnv: env.corpusEnv,
             stub: isStub,
         }));
     }
@@ -83,6 +90,24 @@ export function buildRestorerImpls(env) {
             rpcUrl: env.rpcUrl,
             archiveRpcUrl: env.archiveRpcUrl,
         }));
+    // 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,
+    });
+    out.push(new ClaudeCodeLearnerImpl({
+        adapter: learnerAdapter,
+    }));
+    if (env.disabledNames && env.disabledNames.length > 0) {
+        const disabled = new Set(env.disabledNames);
+        return out.filter((impl) => !disabled.has(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 the MCP
+     * subprocess `search_artifacts` tool 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;