@jinn-network/client 0.1.1 → 0.1.2-canary.6237288d

package/dist/restorer/impls/claude-mcp-prediction-apy/mcp-tools.js

@@ -0,0 +1,136 @@
+/**
+ * MCP tool definitions for claude-mcp-prediction-apy.
+ *
+ * Two tools:
+ *   - read_aave_reserve: read-only Aave v3 Pool.getReserveData; APY bps from liquidity rate.
+ *   - submit_apy_prediction: terminal tool; records predicted bps + rationale.
+ */
+import { z } from 'zod';
+import { createPublicClient, http } from 'viem';
+import { base, baseSepolia, mainnet } from 'viem/chains';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { AAVE_POOL_ABI, liquidityRateRayToApyBps, } from '../../../venues/aave-v3/client.js';
+function ok(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data, null, 2) }],
+    };
+}
+function toolErr(code, message) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ error: true, code, message }) }],
+    };
+}
+const ReadAaveReserveSchema = z.object({});
+const SubmitApyPredictionSchema = z.object({
+    predictedBps: z
+        .number()
+        .int('predictedBps must be an integer')
+        .min(0, 'predictedBps must be ≥ 0')
+        .max(1_000_000, 'predictedBps must be ≤ 1_000_000'),
+    rationale: z
+        .string()
+        .min(1, 'rationale must not be empty')
+        .max(2000, 'rationale must be ≤ 2000 characters'),
+});
+export function buildApyPredictionTools(deps) {
+    const { pool, reserve, reserveSymbol, venue, publicClient, onSubmit } = deps;
+    const readAaveReserve = {
+        name: 'read_aave_reserve',
+        description: 'Read the current Aave v3 reserve supply APY (basis points) for the pool/reserve in this intent. Returns the converted APY from currentLiquidityRate plus block metadata.',
+        schema: ReadAaveReserveSchema,
+        handler: async () => {
+            try {
+                const reserveData = await publicClient.readContract({
+                    address: pool,
+                    abi: AAVE_POOL_ABI,
+                    functionName: 'getReserveData',
+                    args: [reserve],
+                });
+                const currentLiquidityRateRay = reserveData[2];
+                const lastUpdateTimestamp = reserveData[6];
+                const apyBps = liquidityRateRayToApyBps(currentLiquidityRateRay);
+                const block = await publicClient.getBlock({ blockTag: 'latest' });
+                const chainId = await publicClient.getChainId();
+                return ok({
+                    apyBps,
+                    liquidityRateRay: String(currentLiquidityRateRay),
+                    lastUpdateTimestamp: Number(lastUpdateTimestamp),
+                    pool,
+                    reserve,
+                    reserveSymbol,
+                    venue,
+                    chainId,
+                    blockNumber: String(block.number),
+                });
+            }
+            catch (err) {
+                return toolErr('AAVE_READ_FAILED', err instanceof Error ? err.message : String(err));
+            }
+        },
+    };
+    const submitApyPrediction = {
+        name: 'submit_apy_prediction',
+        description: 'Submit your final APY prediction in basis points (integer). `predictedBps` is the supply APY you predict for the TWA window ending at resolveTs. `rationale` is a brief explanation. Calling this ends the session; do not call any other tool after it.',
+        schema: SubmitApyPredictionSchema,
+        handler: async (rawArgs) => {
+            const parsed = SubmitApyPredictionSchema.safeParse(rawArgs);
+            if (!parsed.success) {
+                return toolErr('INVALID_ARGS', parsed.error.issues.map((i) => i.message).join('; '));
+            }
+            const { predictedBps, rationale } = parsed.data;
+            const predictedBpsStr = String(predictedBps);
+            onSubmit({ predictedBps: predictedBpsStr, rationale });
+            return ok({
+                accepted: true,
+                predictedBps: predictedBpsStr,
+                note: 'Prediction recorded. The session will terminate shortly after this response reaches Claude.',
+            });
+        },
+    };
+    return [readAaveReserve, submitApyPrediction];
+}
+function chainForVenue(venue) {
+    if (venue === 'aave-v3-base-sepolia')
+        return { chain: baseSepolia, chainId: 84532 };
+    if (venue === 'aave-v3-mainnet')
+        return { chain: mainnet, chainId: 1 };
+    return { chain: base, chainId: 8453 };
+}
+export async function startMcpServer(config) {
+    const { chain } = chainForVenue(config.venue);
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(config.rpcUrl),
+    });
+    const { appendFileSync } = await import('node:fs');
+    const onSubmit = (submission) => {
+        appendFileSync(config.submissionLogPath, JSON.stringify({
+            ts: Date.now(),
+            predictedBps: submission.predictedBps,
+            rationale: submission.rationale,
+        }) + '\n', { encoding: 'utf-8' });
+    };
+    const tools = buildApyPredictionTools({
+        pool: config.pool,
+        reserve: config.reserve,
+        reserveSymbol: config.reserveSymbol,
+        venue: config.venue,
+        publicClient,
+        onSubmit,
+    });
+    const server = new McpServer({ name: 'jinn-apy-prediction', version: '1.0.0' });
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const registerTool = server.tool.bind(server);
+    for (const tool of tools) {
+        const shape = tool.schema.shape ?? {};
+        registerTool(tool.name, tool.description, shape, async (args) => tool.handler(args));
+    }
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    await new Promise((resolve) => {
+        process.stdin.on('close', resolve);
+        process.stdin.on('end', resolve);
+    });
+}
+//# sourceMappingURL=mcp-tools.js.map

package/dist/restorer/impls/claude-mcp-prediction-apy/mcp-tools.js.map

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

package/dist/restorer/impls/claude-mcp-prediction-apy/prompt.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Prompt template for claude-mcp-prediction-apy sessions.
+ *
+ * Kept intentionally static (no branching) so tests can snapshot deterministically.
+ */
+import type { PredictionApyV0Intent } from '../../../types/prediction-apy.js';
+export declare function buildSessionPrompt(intent: PredictionApyV0Intent, sessionId: string): string;

package/dist/restorer/impls/claude-mcp-prediction-apy/prompt.js

@@ -0,0 +1,46 @@
+/**
+ * Prompt template for claude-mcp-prediction-apy sessions.
+ *
+ * Kept intentionally static (no branching) so tests can snapshot deterministically.
+ */
+export function buildSessionPrompt(intent, sessionId) {
+    const { oracle, metric, question } = intent.spec;
+    const { window } = intent;
+    return [
+        `Session: ${sessionId}`,
+        '',
+        'You are evaluating a Jinn prediction.apy.v0 intent. Predict the time-weighted-average (TWA) supply APY for the reserve, expressed as an integer in basis points (bps), and submit it via submit_apy_prediction.',
+        '',
+        'Ground truth (for scoring) is computed at resolution as follows:',
+        '  - Take sampleCount evenly spaced timestamps in [resolveTs - twaWindowSeconds, resolveTs].',
+        '  - At each timestamp, read Aave Pool.getReserveData(reserve).currentLiquidityRate (ray).',
+        '  - Convert each sample to supply APY and take the arithmetic mean; round to integer bps.',
+        '',
+        `Reserve:        ${oracle.reserveSymbol} (${oracle.reserve})`,
+        `Pool:           ${oracle.pool}`,
+        `Venue:          ${oracle.venue}`,
+        `TWA window:     ${metric.twaWindowSeconds}s with ${metric.sampleCount} samples`,
+        `Tolerance:      ±${metric.toleranceBps} bps (for scoring)`,
+        '',
+        `Intent window:  [${new Date(window.startTs).toISOString()}, ${new Date(window.endTs).toISOString()}]`,
+        `Resolve at:     ${new Date(question.resolveTs).toISOString()}`,
+        '',
+        'You have exactly two tools:',
+        '',
+        '  1. read_aave_reserve — returns the current on-chain supply APY in bps from the reserve (spot, not the full TWA). Call this once.',
+        '  2. submit_apy_prediction — submit your final predicted bps (non-negative integer) with a brief rationale.',
+        '                            Calling this ends the session. Do not call any other tool afterward.',
+        '',
+        'Approach:',
+        '  1. Call read_aave_reserve to see the current supply APY in bps.',
+        '  2. Reason briefly about what TWA APY at resolveTs might be given the spot reading and time to resolution.',
+        '  3. Call submit_apy_prediction with your integer predictedBps and a concise rationale.',
+        '',
+        'Guidelines:',
+        '  - predictedBps must be a whole number (basis points). Example: 350 means 3.50% APY.',
+        '  - Do not call submit_apy_prediction before calling read_aave_reserve.',
+        '  - The rationale should reference the apyBps you read.',
+        '  - Keep the rationale under 2000 characters.',
+    ].join('\n');
+}
+//# sourceMappingURL=prompt.js.map

package/dist/restorer/impls/claude-mcp-prediction-apy/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../src/restorer/impls/claude-mcp-prediction-apy/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,kBAAkB,CAAC,MAA6B,EAAE,SAAiB;IACjF,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC;IACjD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;IAE1B,OAAO;QACL,YAAY,SAAS,EAAE;QACvB,EAAE;QACF,iNAAiN;QACjN,EAAE;QACF,kEAAkE;QAClE,6FAA6F;QAC7F,2FAA2F;QAC3F,2FAA2F;QAC3F,EAAE;QACF,mBAAmB,MAAM,CAAC,aAAa,KAAK,MAAM,CAAC,OAAO,GAAG;QAC7D,mBAAmB,MAAM,CAAC,IAAI,EAAE;QAChC,mBAAmB,MAAM,CAAC,KAAK,EAAE;QACjC,mBAAmB,MAAM,CAAC,gBAAgB,UAAU,MAAM,CAAC,WAAW,UAAU;QAChF,oBAAoB,MAAM,CAAC,YAAY,oBAAoB;QAC3D,EAAE;QACF,oBAAoB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,GAAG;QACtG,mBAAmB,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,EAAE;QAC/D,EAAE;QACF,6BAA6B;QAC7B,EAAE;QACF,oIAAoI;QACpI,6GAA6G;QAC7G,kGAAkG;QAClG,EAAE;QACF,WAAW;QACX,mEAAmE;QACnE,6GAA6G;QAC7G,yFAAyF;QACzF,EAAE;QACF,aAAa;QACb,uFAAuF;QACvF,yEAAyE;QACzE,yDAAyD;QACzD,+CAA+C;KAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

package/dist/restorer/impls/claude-mcp-prediction-apy/session-orchestrator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Session orchestrator for claude-mcp-prediction-apy.
+ *
+ * Single-session. Spawns Claude once with the APY prediction MCP + prompt,
+ * polls for submit_apy_prediction, then terminates after a short grace period.
+ */
+import { spawn } from 'node:child_process';
+import type { SessionResult } from './types.js';
+export interface OrchestratorDeps {
+    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 submit_apy_prediction has been invoked. */
+    isSubmitted: () => boolean;
+    sessionMaxMs?: number;
+    pollIntervalMs?: number;
+    submissionGraceMs?: number;
+    _spawnFn?: typeof spawn;
+}
+export declare function spawnSession(sessionId: string, prompt: string, deps: OrchestratorDeps): Promise<SessionResult>;

package/dist/restorer/impls/claude-mcp-prediction-apy/session-orchestrator.js

@@ -0,0 +1,128 @@
+/**
+ * Session orchestrator for claude-mcp-prediction-apy.
+ *
+ * Single-session. Spawns Claude once with the APY prediction MCP + prompt,
+ * polls for submit_apy_prediction, then terminates after a short grace period.
+ */
+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;
+export async function spawnSession(sessionId, prompt, 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();
+    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-apy-prediction__*',
+    ];
+    if (deps.claudeModel)
+        args.push('--model', deps.claudeModel);
+    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',
+        'CLAUDE_CODE_OAUTH_TOKEN', 'ANTHROPIC_API_KEY',
+    ]) {
+        if (process.env[key])
+            agentEnv[key] = process.env[key];
+    }
+    deps.log({ level: 'info', msg: `apy-prediction-session: 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: `apy-prediction-session: ${sessionId} reached sessionMaxMs; killing`, data: { sessionMaxMs } });
+                child.kill('SIGTERM');
+            }
+        }, sessionMaxMs);
+        let graceTimer = null;
+        const pollTimer = setInterval(() => {
+            if (graceTimer || child.killed)
+                return;
+            if (deps.isSubmitted()) {
+                deps.log({ level: 'info', msg: `apy-prediction-session: ${sessionId} submit_apy_prediction 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: `apy-prediction-session: ${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();
+            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: `apy-prediction-session: ${sessionId} exited`,
+                data: { code, signal, durationMs: endedAt - startedAt, submitted: deps.isSubmitted(), aborted },
+            });
+            resolve({
+                sessionId,
+                startedAt,
+                endedAt,
+                transcriptPath,
+                submitted: deps.isSubmitted(),
+                stdout,
+                aborted: aborted || deps.abort.aborted,
+            });
+        });
+        child.on('error', (err) => {
+            cleanup();
+            const endedAt = Date.now();
+            appendFileSync(transcriptPath, `\n\n=== Session spawn error: ${err.message} ===\n`);
+            deps.log({ level: 'error', msg: `apy-prediction-session: ${sessionId} spawn error`, data: { err: err.message } });
+            resolve({
+                sessionId,
+                startedAt,
+                endedAt,
+                transcriptPath,
+                submitted: deps.isSubmitted(),
+                stdout,
+                aborted: deps.abort.aborted,
+            });
+        });
+    });
+}
+//# sourceMappingURL=session-orchestrator.js.map

package/dist/restorer/impls/claude-mcp-prediction-apy/session-orchestrator.js.map

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

package/dist/restorer/impls/claude-mcp-prediction-apy/types.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Types for claude-mcp-prediction-apy — a RestorerImpl that spawns Claude with
+ * two MCP tools to submit prediction.apy.v0 (integer APY bps).
+ */
+import type { PublicClient } from 'viem';
+export interface McpToolContent {
+    type: 'text';
+    text: string;
+}
+export interface McpToolResult {
+    content: McpToolContent[];
+}
+export interface ApyPredictionToolDefinition {
+    name: string;
+    description: string;
+    schema: import('zod').ZodObject<import('zod').ZodRawShape>;
+    handler: (args: unknown) => Promise<McpToolResult>;
+}
+export interface SubmissionState {
+    predictedBps: string | null;
+    rationale: string | null;
+    submittedAt: number | null;
+}
+export type AaveV3Venue = 'aave-v3-base-sepolia' | 'aave-v3-base' | 'aave-v3-mainnet';
+export interface ApyPredictionToolDeps {
+    pool: `0x${string}`;
+    reserve: `0x${string}`;
+    reserveSymbol: string;
+    venue: AaveV3Venue;
+    publicClient: PublicClient;
+    onSubmit: (submission: {
+        predictedBps: string;
+        rationale: string;
+    }) => void;
+}
+export interface ClaudeMcpPredictionApyConfig {
+    rpcUrl?: string;
+    archiveRpcUrl?: string;
+    claudeModel?: string;
+    claudePath?: string;
+    sessionMaxMs?: number;
+    _testDeps?: TestDeps;
+    stub?: boolean;
+}
+export interface TestDeps {
+    runSession?: (args: {
+        sessionId: string;
+        prompt: string;
+        mcpConfigPath: string;
+        workingDir: string;
+        implStateDir: string;
+        timeoutMs: number;
+        signalSubmit: (predictedBps: string, rationale: string) => void;
+    }) => Promise<SessionResult>;
+}
+export interface SessionResult {
+    sessionId: string;
+    startedAt: number;
+    endedAt: number;
+    transcriptPath: string;
+    submitted: boolean;
+    stdout: string;
+    aborted: boolean;
+}

package/dist/restorer/impls/claude-mcp-prediction-apy/types.js

@@ -0,0 +1,6 @@
+/**
+ * Types for claude-mcp-prediction-apy — a RestorerImpl that spawns Claude with
+ * two MCP tools to submit prediction.apy.v0 (integer APY bps).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/restorer/impls/claude-mcp-prediction-apy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/restorer/impls/claude-mcp-prediction-apy/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

@@ -0,0 +1,16 @@
+import type { DesiredState } from '../../types/desired-state.js';
+/** Eval `DesiredState.context` key for the restoration job’s intended-state IPFS CID (not the eval job’s). */
+export declare const RESTORATION_INTENT_CID_CONTEXT_KEY: "restorationIntentCid";
+/**
+ * Resolve the expected restoration intent CID for `integrity.intent_ref`.
+ * Test-only overrides win; otherwise the value must be present in `context`.
+ * There is no fallback to the evaluation job’s `intentCid` (wrong reference).
+ */
+export declare function resolveExpectedRestorationIntentCid(intent: DesiredState, testDeps?: {
+    expectedIntentCid?: string;
+}): {
+    kind: 'resolved';
+    cid: string;
+} | {
+    kind: 'missing';
+};

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

@@ -0,0 +1,18 @@
+/** Eval `DesiredState.context` key for the restoration job’s intended-state IPFS CID (not the eval job’s). */
+export const RESTORATION_INTENT_CID_CONTEXT_KEY = 'restorationIntentCid';
+/**
+ * Resolve the expected restoration intent CID for `integrity.intent_ref`.
+ * Test-only overrides win; otherwise the value must be present in `context`.
+ * There is no fallback to the evaluation job’s `intentCid` (wrong reference).
+ */
+export function resolveExpectedRestorationIntentCid(intent, testDeps) {
+    if (testDeps?.expectedIntentCid) {
+        return { kind: 'resolved', cid: testDeps.expectedIntentCid };
+    }
+    const v = intent.context?.[RESTORATION_INTENT_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/restorer/impls/evaluation-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluation-context.js","sourceRoot":"","sources":["../../../src/restorer/impls/evaluation-context.ts"],"names":[],"mappings":"AAEA,8GAA8G;AAC9G,MAAM,CAAC,MAAM,kCAAkC,GAAG,sBAA+B,CAAC;AAElF;;;;GAIG;AACH,MAAM,UAAU,mCAAmC,CACjD,MAAoB,EACpB,QAAyC;IAEzC,IAAI,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC/D,CAAC;IACD,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC,kCAAkC,CAAC,CAAC;IAC/D,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/restorer/impls/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Single construction site for all first-party {@link RestorerImpl} instances.
+ * Used by the daemon entrypoint and `jinn intents` CLI (stub mode).
+ */
+import type { Runner } from '../../runner/runner.js';
+import type { RestorerImpl } from '../types.js';
+/**
+ * Environment passed to {@link buildRestorerImpls} — same shape for daemon
+ * (live creds) and CLI introspection (stub: true, optional runner).
+ */
+export interface RestorerEnv {
+    /** 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;
+    /** SQLite store path for MCP artifact handoff in {@link LegacyClaudeImpl}. */
+    storePath?: string;
+    /**
+     * Legacy-claude runner working directory (defaults to /tmp if unset).
+     */
+    legacyClaudeWorkingDirectory?: 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;
+}
+/**
+ * Build the canonical ordered list of first-party restorer / evaluator impls.
+ * Registration order is stable: it matches historical `main.ts` first-match
+ * behavior for `RestorerImplRegistry`.
+ */
+export declare function buildRestorerImpls(env: RestorerEnv): RestorerImpl[];

package/dist/restorer/impls/index.js

@@ -0,0 +1,88 @@
+/**
+ * Single construction site for all first-party {@link RestorerImpl} instances.
+ * Used by the daemon entrypoint and `jinn intents` 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 { PredictionV0BaselineImpl } from './prediction-v0-baseline/index.js';
+import { PredictionV0Evaluator } from './prediction-v0-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';
+/**
+ * Build the canonical ordered list of first-party restorer / evaluator impls.
+ * Registration order is stable: it matches historical `main.ts` first-match
+ * behavior for `RestorerImplRegistry`.
+ */
+export function buildRestorerImpls(env) {
+    const isStub = Boolean(env.stub);
+    if (!isStub) {
+        if (!env.pk)
+            throw new Error('buildRestorerImpls: pk is required when stub is not set');
+        if (!env.safe)
+            throw new Error('buildRestorerImpls: 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,
+            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 PredictionV0BaselineImpl({
+        rpcUrl: env.rpcUrl,
+        stub: isStub,
+    }));
+    out.push(new ClaudeMcpPredictionImpl({
+        claudePath: env.claudePath,
+        claudeModel: env.claudeModel,
+        rpcUrl: env.rpcUrl,
+        stub: isStub,
+    }));
+    out.push(isStub
+        ? new PredictionV0Evaluator({ stub: true, rpcUrl: env.rpcUrl })
+        : new PredictionV0Evaluator({
+            evaluatorPk: env.pk,
+            evaluatorSafeAddress: env.safe,
+            rpcUrl: env.rpcUrl,
+        }));
+    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,
+        }));
+    return out;
+}
+//# sourceMappingURL=index.js.map

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

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