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

package/dist/harnesses/impls/claude-mcp-prediction-apy/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * claude-mcp-prediction-apy — Harness for prediction.apy.v0 that spawns a
+ * single Claude Code session with read_aave_reserve + submit_apy_prediction.
+ *
+ * Selected through SolverNet `harness` config; baseline remains available as a deterministic override.
+ * Isolation gate: test/harnesses/impls/claude-mcp-prediction-apy/isolation.test.ts
+ */
+import type { Harness, HarnessContext, Solution, ReadyStatus, EnableResult, HarnessEnableMetadata } from '../../types.js';
+import type { Task } from '../../../types/task.js';
+import type { ClaudeMcpPredictionApyConfig } from './types.js';
+export declare class ClaudeMcpPredictionApyImpl implements Harness {
+    private readonly config;
+    readonly name = "claude-mcp-prediction-apy";
+    readonly version = "1.0.0";
+    constructor(config?: ClaudeMcpPredictionApyConfig);
+    supports(ctx: {
+        solverType: string;
+        role?: 'restoration' | 'evaluation';
+    }): boolean;
+    isReady(): Promise<ReadyStatus>;
+    enableMetadata(): HarnessEnableMetadata;
+    onEnable(_ctx: {
+        args: Record<string, string | undefined>;
+    }): Promise<EnableResult>;
+    canAttempt(task: Task): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        reason: string;
+    }>;
+    run(ctx: HarnessContext): Promise<Solution>;
+    private _finalize;
+    private _defaultRpcUrl;
+}
+export declare function _writeApyPredictionMcpServerScript(outPath: string): void;
+export default ClaudeMcpPredictionApyImpl;

package/dist/harnesses/impls/claude-mcp-prediction-apy/index.js

@@ -0,0 +1,241 @@
+/**
+ * claude-mcp-prediction-apy — Harness for prediction.apy.v0 that spawns a
+ * single Claude Code session with read_aave_reserve + submit_apy_prediction.
+ *
+ * Selected through SolverNet `harness` config; baseline remains available as a deterministic override.
+ * Isolation gate: test/harnesses/impls/claude-mcp-prediction-apy/isolation.test.ts
+ */
+import { writeFileSync, mkdirSync, existsSync, readFileSync, chmodSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createPublicClient, http } from 'viem';
+import { base, baseSepolia, mainnet } from 'viem/chains';
+import { REQUIRES_LIVE_DAEMON_READINESS } from '../../types.js';
+import { PredictionApyV0TaskSchema } from '../../../types/prediction-apy.js';
+import { buildSessionPrompt } from './prompt.js';
+import { spawnSession } from './session-orchestrator.js';
+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 class ClaudeMcpPredictionApyImpl {
+    config;
+    name = 'claude-mcp-prediction-apy';
+    version = '1.0.0';
+    constructor(config = {}) {
+        this.config = config;
+    }
+    supports(ctx) {
+        return ctx.solverType === 'prediction.apy.v0' && ctx.role !== 'evaluation';
+    }
+    async isReady() {
+        if (this.config.stub)
+            return { ...REQUIRES_LIVE_DAEMON_READINESS };
+        return { ready: true };
+    }
+    enableMetadata() {
+        return {
+            description: 'prediction.apy.v0 — Claude + MCP reads Aave reserve APY and submits predicted bps.',
+        };
+    }
+    async onEnable(_ctx) {
+        return { status: 'ready' };
+    }
+    async canAttempt(task) {
+        const parsed = PredictionApyV0TaskSchema.safeParse(task);
+        if (!parsed.success)
+            return { ok: false, reason: `Invalid prediction.apy.v0 task: ${parsed.error.message}` };
+        if (Date.now() > parsed.data.window.endTs)
+            return { ok: false, reason: 'window already closed' };
+        return { ok: true };
+    }
+    async run(ctx) {
+        if (this.config.stub) {
+            throw new Error('claude-mcp-prediction-apy: stub registry cannot run (requires live daemon)');
+        }
+        const { task: task, workingDir, log } = ctx;
+        const parsed = PredictionApyV0TaskSchema.parse(task);
+        const testDeps = this.config._testDeps;
+        const submissionState = {
+            predictedBps: null,
+            rationale: null,
+            submittedAt: null,
+        };
+        const signalSubmit = (predictedBps, rationale) => {
+            submissionState.predictedBps = predictedBps;
+            submissionState.rationale = rationale;
+            submissionState.submittedAt = Date.now();
+        };
+        const sessionId = `apy-pred-${Date.now()}`;
+        const prompt = buildSessionPrompt(parsed, sessionId);
+        const claudeModel = ctx.solverNet?.model ?? this.config.claudeModel;
+        if (testDeps?.runSession) {
+            const session = await testDeps.runSession({
+                sessionId,
+                prompt,
+                mcpConfigPath: '<test>',
+                workingDir,
+                implStateDir: ctx.implStateDir,
+                timeoutMs: this.config.sessionMaxMs ?? 180_000,
+                signalSubmit,
+            });
+            return this._finalize(parsed, sessionId, session.transcriptPath, submissionState, session.startedAt, session.endedAt, claudeModel);
+        }
+        const { venue, pool, reserve, reserveSymbol } = parsed.spec.oracle;
+        const { chain, chainId } = chainForVenue(venue);
+        const rpcUrl = this.config.archiveRpcUrl ?? this.config.rpcUrl ?? this._defaultRpcUrl(venue);
+        const publicClient = createPublicClient({ chain, transport: http(rpcUrl) });
+        const actual = await publicClient.getChainId();
+        if (actual !== chainId) {
+            throw new Error(`oracle venue mismatch: ${venue} expects chain ${chainId}, got ${actual}`);
+        }
+        const mcpDir = join(workingDir, 'mcp');
+        mkdirSync(mcpDir, { recursive: true });
+        const submissionLogPath = join(mcpDir, 'submissions.jsonl');
+        writeFileSync(submissionLogPath, '', { encoding: 'utf-8', mode: 0o600 });
+        chmodSync(submissionLogPath, 0o600);
+        const wrapperPath = join(mcpDir, 'apy-prediction-server.mjs');
+        const wrapperConfigPath = join(mcpDir, 'apy-prediction-server-config.json');
+        const wrapperConfig = {
+            venue,
+            pool,
+            reserve,
+            reserveSymbol,
+            rpcUrl,
+            submissionLogPath,
+        };
+        writeFileSync(wrapperConfigPath, JSON.stringify(wrapperConfig), { encoding: 'utf-8', mode: 0o600 });
+        chmodSync(wrapperConfigPath, 0o600);
+        _writeApyPredictionMcpServerScript(wrapperPath);
+        const mcpConfigPath = join(mcpDir, 'mcp-config.json');
+        writeFileSync(mcpConfigPath, JSON.stringify({
+            mcpServers: {
+                'jinn-apy-prediction': {
+                    command: process.execPath,
+                    args: [wrapperPath, wrapperConfigPath],
+                },
+            },
+        }, null, 2));
+        const isSubmitted = () => {
+            try {
+                const contents = readFileSync(submissionLogPath, 'utf-8');
+                const lastLine = contents.trim().split('\n').pop() ?? '';
+                if (!lastLine)
+                    return false;
+                const record = JSON.parse(lastLine);
+                if (record && typeof record.predictedBps === 'string' && typeof record.rationale === 'string') {
+                    signalSubmit(record.predictedBps, record.rationale);
+                    return true;
+                }
+            }
+            catch {
+                return false;
+            }
+            return false;
+        };
+        log({ level: 'info', msg: 'claude-mcp-prediction-apy: spawning session', data: { sessionId } });
+        const session = await spawnSession(sessionId, prompt, {
+            claudePath: this.config.claudePath ?? 'claude',
+            ...(claudeModel ? { claudeModel } : {}),
+            mcpConfigPath,
+            workingDir,
+            abort: ctx.abort,
+            log,
+            isSubmitted,
+            ...(this.config.sessionMaxMs !== undefined ? { sessionMaxMs: this.config.sessionMaxMs } : {}),
+        });
+        if (!submissionState.predictedBps)
+            isSubmitted();
+        return this._finalize(parsed, sessionId, session.transcriptPath, submissionState, session.startedAt, session.endedAt, claudeModel);
+    }
+    _finalize(task, sessionId, transcriptPath, submission, startedAt, endedAt, claudeModel) {
+        if (!submission.predictedBps || !submission.rationale) {
+            throw new Error(`claude-mcp-prediction-apy: session ${sessionId} ended without a valid submit_apy_prediction call`);
+        }
+        const submittedAt = submission.submittedAt ?? Date.now();
+        const modelId = `claude-mcp-prediction-apy.${claudeModel ?? 'default'}.v1`;
+        const predictionPath = join(dirname(transcriptPath), '..', '..', 'prediction-apy.json');
+        writeFileSync(predictionPath, JSON.stringify({
+            predictedBps: submission.predictedBps,
+            submittedAt,
+            modelId,
+            rationale: submission.rationale,
+        }, null, 2), { encoding: 'utf-8' });
+        const { venue, pool, reserve, reserveSymbol } = task.spec.oracle;
+        return {
+            venueRef: { name: 'aave-v3' },
+            gating: {
+                predictedBps: submission.predictedBps,
+                submittedAt: String(submittedAt),
+                modelId,
+            },
+            informational: {
+                rationale: submission.rationale,
+                sessionId,
+                transcriptPath,
+                venue,
+                pool,
+                reserve,
+                reserveSymbol,
+                sessionDurationMs: endedAt - startedAt,
+            },
+            solutionPayload: {
+                prediction: {
+                    predictedBps: submission.predictedBps,
+                    submittedAt,
+                    modelId,
+                },
+            },
+            artifacts: [
+                { path: 'prediction-apy.json', artifactType: 'prediction_submission' },
+                {
+                    path: transcriptPath,
+                    artifactType: 'session_transcript',
+                    metadata: { sessionId, startedAt, endedAt },
+                },
+            ],
+        };
+    }
+    _defaultRpcUrl(venue) {
+        if (venue === 'aave-v3-base-sepolia')
+            return 'https://sepolia.base.org';
+        if (venue === 'aave-v3-base')
+            return 'https://mainnet.base.org';
+        return 'https://eth.llamarpc.com';
+    }
+}
+export function _writeApyPredictionMcpServerScript(outPath) {
+    const __filename = fileURLToPath(import.meta.url);
+    let mcpToolsPath = join(dirname(__filename), 'mcp-tools.js');
+    if (!existsSync(mcpToolsPath) && __filename.includes(`${'/'}src${'/'}`)) {
+        mcpToolsPath = __filename
+            .replace(`${'/'}src${'/'}`, `${'/'}dist${'/'}`)
+            .replace(/index\.(ts|js)$/, 'mcp-tools.js');
+    }
+    if (!existsSync(mcpToolsPath)) {
+        throw new Error(`E_DAEMON_MUST_RUN_FROM_DIST: ${mcpToolsPath} does not exist. ` +
+            `The claude-mcp-prediction-apy wrapper subprocess loads this compiled artifact. ` +
+            `Run \`yarn build\` before starting the daemon or isolation test.`);
+    }
+    const script = `#!/usr/bin/env node
+// Auto-generated jinn-apy-prediction MCP wrapper — do not edit.
+import { readFileSync } from 'node:fs';
+import { startMcpServer } from ${JSON.stringify(mcpToolsPath)};
+
+const configPath = process.argv[2];
+if (!configPath) {
+  process.stderr.write('Usage: apy-prediction-server.mjs <config-file-path>\\n');
+  process.exit(1);
+}
+
+const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+await startMcpServer(config);
+`.trim();
+    writeFileSync(outPath, script, { encoding: 'utf-8', mode: 0o600 });
+    chmodSync(outPath, 0o600);
+}
+export default ClaudeMcpPredictionApyImpl;
+//# sourceMappingURL=index.js.map

package/dist/harnesses/impls/claude-mcp-prediction-apy/index.js.map

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

package/dist/harnesses/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 task. 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/harnesses/impls/claude-mcp-prediction-apy/mcp-tools.js.map

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

package/dist/harnesses/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 { PredictionApyV0Task } from '../../../types/prediction-apy.js';
+export declare function buildSessionPrompt(task: PredictionApyV0Task, sessionId: string): string;

package/dist/harnesses/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(task, sessionId) {
+    const { oracle, metric, question } = task.spec;
+    const { window } = task;
+    return [
+        `Session: ${sessionId}`,
+        '',
+        'You are evaluating a Jinn prediction.apy.v0 task. 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)`,
+        '',
+        `Task 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/harnesses/impls/claude-mcp-prediction-apy/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-mcp-prediction-apy/prompt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,UAAU,kBAAkB,CAAC,IAAyB,EAAE,SAAiB;IAC7E,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;IAC/C,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExB,OAAO;QACL,YAAY,SAAS,EAAE;QACvB,EAAE;QACF,+MAA+M;QAC/M,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,kBAAkB,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,GAAG;QACpG,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/harnesses/impls/claude-mcp-prediction-apy/session-orchestrator.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 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.
+ *
+ * Thin wrapper over `claude-mcp-shared/single-session-orchestrator.ts`, which
+ * is shared with `claude-mcp-prediction`.
+ */
+import { spawn } from 'node:child_process';
+import type { TrajectoryCollector } from '../../../trajectory/index.js';
+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;
+    /**
+     * 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;
+}
+export declare function spawnSession(sessionId: string, prompt: string, deps: OrchestratorDeps): Promise<SessionResult>;

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

@@ -0,0 +1,19 @@
+/**
+ * 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.
+ *
+ * Thin wrapper over `claude-mcp-shared/single-session-orchestrator.ts`, which
+ * is shared with `claude-mcp-prediction`.
+ */
+import { runSingleSession, } from '../claude-mcp-shared/single-session-orchestrator.js';
+const PREDICTION_APY_CONFIG = {
+    allowedTools: 'mcp__jinn-apy-prediction__*',
+    logTag: 'apy-prediction-session',
+    submissionToolName: 'submit_apy_prediction',
+};
+export async function spawnSession(sessionId, prompt, deps) {
+    return runSingleSession(sessionId, prompt, PREDICTION_APY_CONFIG, deps);
+}
+//# sourceMappingURL=session-orchestrator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-orchestrator.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-mcp-prediction-apy/session-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EACL,gBAAgB,GAEjB,MAAM,qDAAqD,CAAC;AAyB7D,MAAM,qBAAqB,GAAwB;IACjD,YAAY,EAAE,6BAA6B;IAC3C,MAAM,EAAE,wBAAwB;IAChC,kBAAkB,EAAE,uBAAuB;CAC5C,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,MAAc,EACd,IAAsB;IAEtB,OAAO,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,qBAAqB,EAAE,IAAI,CAAC,CAAC;AAC1E,CAAC"}

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

@@ -0,0 +1,64 @@
+/**
+ * Types for claude-mcp-prediction-apy — a Harness 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/harnesses/impls/claude-mcp-prediction-apy/types.js

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

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

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