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

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

@@ -0,0 +1,250 @@
+/**
+ * claude-mcp-prediction — Harness for prediction.v1 that spawns a single
+ * Claude Code session with two MCP tools (read_chainlink_price +
+ * submit_prediction) and harvests the model's probability + rationale.
+ *
+ * Selected through SolverNet `harness` config; baseline
+ * (prediction-v0-baseline) remains available as a deterministic override. Flip once the
+ * isolation test (test/harnesses/impls/claude-mcp-prediction/isolation.test.ts)
+ * is green on ≥3 separate runs.
+ *
+ * Structure mirrors claude-mcp-hyperliquid, minus trading, API wallet, safety
+ * rails, and the session cadence loop. Single-shot only.
+ */
+import { writeFileSync, mkdirSync, existsSync, readFileSync, chmodSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { REQUIRES_LIVE_DAEMON_READINESS } from '../../types.js';
+import { PredictionV1TaskSchema } from '../../../types/prediction.js';
+import { buildSessionPrompt } from './prompt.js';
+import { spawnSession } from './session-orchestrator.js';
+// ── Impl ──────────────────────────────────────────────────────────────────────
+export class ClaudeMcpPredictionImpl {
+    config;
+    name = 'claude-mcp-prediction';
+    version = '1.0.0';
+    constructor(config = {}) {
+        this.config = config;
+    }
+    supports(ctx) {
+        return ctx.solverType === 'prediction.v1' && ctx.role !== 'evaluation';
+    }
+    async isReady() {
+        if (this.config.stub)
+            return { ...REQUIRES_LIVE_DAEMON_READINESS };
+        return { ready: true };
+    }
+    async canAttempt(task) {
+        const parsed = PredictionV1TaskSchema.safeParse(task);
+        if (!parsed.success)
+            return { ok: false, reason: `Invalid prediction.v1 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: stub registry cannot run (requires live daemon)');
+        }
+        const { task: task, workingDir, log } = ctx;
+        const parsed = PredictionV1TaskSchema.parse(task);
+        const testDeps = this.config._testDeps;
+        // Shared submission state. The wrapper-subprocess writes to a JSONL file
+        // (submissionLogPath); the orchestrator's isSubmitted poll + our final
+        // read pull the record off disk. In test mode, _testDeps.runSession
+        // invokes signalSubmit directly to bypass the subprocess.
+        const submissionState = {
+            probability: null,
+            rationale: null,
+            submittedAt: null,
+        };
+        const signalSubmit = (probability, rationale) => {
+            submissionState.probability = probability;
+            submissionState.rationale = rationale;
+            submissionState.submittedAt = Date.now();
+        };
+        const sessionId = `pred-${Date.now()}`;
+        const prompt = buildSessionPrompt(parsed, sessionId);
+        const claudeModel = ctx.solverNet?.model ?? this.config.claudeModel;
+        // ── Test-mode short-circuit ────────────────────────────────────────────────
+        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);
+        }
+        // ── Live path ──────────────────────────────────────────────────────────────
+        const mcpDir = join(workingDir, 'mcp');
+        mkdirSync(mcpDir, { recursive: true });
+        // Per-session submission log. The wrapper appends JSON lines here when
+        // submit_prediction is invoked. We tail it to detect the submission.
+        const submissionLogPath = join(mcpDir, 'submissions.jsonl');
+        writeFileSync(submissionLogPath, '', { encoding: 'utf-8', mode: 0o600 });
+        chmodSync(submissionLogPath, 0o600);
+        // Write the wrapper script + its config.
+        const wrapperPath = join(mcpDir, 'prediction-server.mjs');
+        const wrapperConfigPath = join(mcpDir, 'prediction-server-config.json');
+        const wrapperConfig = {
+            feed: parsed.spec.oracle.feed,
+            feedDescription: parsed.spec.oracle.feedDescription,
+            venue: parsed.spec.oracle.venue,
+            rpcUrl: this.config.rpcUrl ?? this._defaultRpcUrl(parsed.spec.oracle.venue),
+            submissionLogPath,
+        };
+        writeFileSync(wrapperConfigPath, JSON.stringify(wrapperConfig), { encoding: 'utf-8', mode: 0o600 });
+        chmodSync(wrapperConfigPath, 0o600);
+        _writePredictionMcpServerScript(wrapperPath);
+        // MCP config file Claude reads via --mcp-config.
+        const mcpConfigPath = join(mcpDir, 'mcp-config.json');
+        writeFileSync(mcpConfigPath, JSON.stringify({
+            mcpServers: {
+                'jinn-prediction': {
+                    command: process.execPath,
+                    args: [wrapperPath, wrapperConfigPath],
+                },
+            },
+        }, null, 2));
+        // isSubmitted reads the JSONL log; as soon as there's a line, we know
+        // the tool fired. We also pull the probability + rationale from it so
+        // the cross-process boundary is clean.
+        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.probability === 'string' && typeof record.rationale === 'string') {
+                    signalSubmit(record.probability, record.rationale);
+                    return true;
+                }
+            }
+            catch {
+                return false;
+            }
+            return false;
+        };
+        log({ level: 'info', msg: 'claude-mcp-prediction: 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 } : {}),
+        });
+        // One final read in case isSubmitted's poll raced with session exit.
+        if (!submissionState.probability)
+            isSubmitted();
+        return this._finalize(parsed, sessionId, session.transcriptPath, submissionState, session.startedAt, session.endedAt, claudeModel);
+    }
+    // ── Helpers ──────────────────────────────────────────────────────────────────
+    _finalize(task, sessionId, transcriptPath, submission, startedAt, endedAt, claudeModel) {
+        if (!submission.probability || !submission.rationale) {
+            throw new Error(`claude-mcp-prediction: session ${sessionId} ended without a valid submit_prediction call`);
+        }
+        const submittedAt = submission.submittedAt ?? Date.now();
+        const modelId = `claude-mcp-prediction.${claudeModel ?? 'default'}.v1`;
+        const predictionPath = join(dirname(transcriptPath), '..', '..', 'prediction.json');
+        writeFileSync(predictionPath, JSON.stringify({
+            probability: submission.probability,
+            submittedAt,
+            modelId,
+            rationale: submission.rationale,
+        }, null, 2), { encoding: 'utf-8' });
+        return {
+            venueRef: { name: 'chainlink' },
+            gating: {
+                probability: submission.probability,
+                submittedAt: String(submittedAt),
+                modelId,
+            },
+            informational: {
+                rationale: submission.rationale,
+                sessionId,
+                transcriptPath,
+                feed: task.spec.oracle.feed,
+                venue: task.spec.oracle.venue,
+                sessionDurationMs: endedAt - startedAt,
+            },
+            solutionPayload: {
+                prediction: {
+                    probability: submission.probability,
+                    submittedAt,
+                    modelId,
+                },
+                // rationale is a free-form string from the LLM; the schema expects
+                // Array<{ ts: number; note: string }>, so we do not include it here
+                // (it lives in informational only). A future task can parse / wrap it.
+            },
+            artifacts: [
+                { path: 'prediction.json', artifactType: 'prediction_submission' },
+                {
+                    path: transcriptPath,
+                    artifactType: 'session_transcript',
+                    metadata: { sessionId, startedAt, endedAt },
+                },
+            ],
+        };
+    }
+    _defaultRpcUrl(venue) {
+        return venue === 'chainlink-base' ? 'https://mainnet.base.org' : 'https://sepolia.base.org';
+    }
+}
+// ── Wrapper-script writer ─────────────────────────────────────────────────────
+/**
+ * Generate a wrapper script that spawns the jinn-prediction MCP server.
+ * Follows the same "delegate to compiled mcp-tools.js" pattern as
+ * _writeHlMcpServerScript — plain Node loads the wrapper, which imports
+ * startMcpServer from the compiled file.
+ */
+export function _writePredictionMcpServerScript(outPath) {
+    const __filename = fileURLToPath(import.meta.url);
+    // Resolve the COMPILED mcp-tools.js path. The wrapper is spawned by plain
+    // Node (not tsx) via --mcp-config, so it must import a .js file. After
+    // `yarn build` the compiled artifact lives at dist/.../mcp-tools.js.
+    //
+    // - Production (running from dist/): __filename is in /.../dist/... → sibling
+    //   mcp-tools.js exists.
+    // - Dev/test (running source via tsx/vitest): __filename is in /.../src/...
+    //   → rewrite path into /.../dist/... .
+    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 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-prediction MCP wrapper — do not edit.
+// Delegates to the compiled mcp-tools module; no business logic in the wrapper.
+// Config (feed address, RPC url, submissionLogPath) is read from argv[2].
+import { readFileSync } from 'node:fs';
+import { startMcpServer } from ${JSON.stringify(mcpToolsPath)};
+
+const configPath = process.argv[2];
+if (!configPath) {
+  process.stderr.write('Usage: 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 ClaudeMcpPredictionImpl;
+//# sourceMappingURL=index.js.map

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

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

package/dist/harnesses/impls/claude-mcp-prediction/mcp-tools.js

@@ -0,0 +1,135 @@
+/**
+ * MCP tool definitions for claude-mcp-prediction.
+ *
+ * Two tools, minimal by design:
+ *   - read_chainlink_price: read-only oracle query. No auth, no side effects.
+ *   - submit_prediction:    terminal tool. Records Claude's decision + ends session.
+ *
+ * No safety rails, no write-op tracking, no signing. Prediction has no capital
+ * surface; the only "write" is `submit_prediction` which writes to the impl's
+ * in-memory SubmissionState via onSubmit.
+ *
+ * Also exports startMcpServer(config): the wrapper-script entrypoint. Mirrors
+ * the pattern in claude-mcp-hyperliquid/mcp-tools.ts:1030-1079, minus the HL
+ * client + safety setup.
+ */
+import { z } from 'zod';
+import { createPublicClient, http } from 'viem';
+import { base, baseSepolia } from 'viem/chains';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { readChainlinkLatest, scaleToDecimal } from '../../../venues/chainlink/client.js';
+// ── Helpers ────────────────────────────────────────────────────────────────────
+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 }) },
+        ],
+    };
+}
+// ── Tool schemas ──────────────────────────────────────────────────────────────
+const ReadChainlinkPriceSchema = z.object({});
+const SubmitPredictionSchema = z.object({
+    probability: z
+        .number()
+        .min(0, 'probability must be ≥ 0')
+        .max(1, 'probability must be ≤ 1'),
+    rationale: z
+        .string()
+        .min(1, 'rationale must not be empty')
+        .max(2000, 'rationale must be ≤ 2000 characters'),
+});
+// ── Factory ───────────────────────────────────────────────────────────────────
+export function buildPredictionTools(deps) {
+    const { feed, feedDescription, venue, publicClient, onSubmit } = deps;
+    const readChainlinkPrice = {
+        name: 'read_chainlink_price',
+        description: 'Read the current Chainlink price for the feed anchored in this prediction task. Returns the price as a decimal string plus round metadata.',
+        schema: ReadChainlinkPriceSchema,
+        handler: async () => {
+            try {
+                const reading = await readChainlinkLatest(feed, publicClient);
+                const price = scaleToDecimal(reading.answer, reading.decimals);
+                return ok({
+                    price,
+                    roundId: String(reading.roundId),
+                    updatedAt: reading.updatedAt,
+                    feed,
+                    feedDescription,
+                    venue,
+                });
+            }
+            catch (err) {
+                return toolErr('CHAINLINK_READ_FAILED', err instanceof Error ? err.message : String(err));
+            }
+        },
+    };
+    const submitPrediction = {
+        name: 'submit_prediction',
+        description: 'Submit your final prediction. `probability` is your probability (as a decimal number between 0 and 1) that the question resolves YES. `rationale` is a brief one-paragraph explanation of your reasoning. Calling this ends the session; do not call any other tool after it.',
+        schema: SubmitPredictionSchema,
+        handler: async (rawArgs) => {
+            const parsed = SubmitPredictionSchema.safeParse(rawArgs);
+            if (!parsed.success) {
+                return toolErr('INVALID_ARGS', parsed.error.issues.map(i => i.message).join('; '));
+            }
+            const { probability, rationale } = parsed.data;
+            // Fixed-point string to avoid float drift between tool + manifest.
+            const probabilityStr = probability.toFixed(4);
+            onSubmit({ probability: probabilityStr, rationale });
+            return ok({
+                accepted: true,
+                probability: probabilityStr,
+                note: 'Prediction recorded. The session will terminate shortly after this response reaches Claude.',
+            });
+        },
+    };
+    return [readChainlinkPrice, submitPrediction];
+}
+export async function startMcpServer(config) {
+    // Build a publicClient from the chain implied by venue.
+    const chain = config.venue === 'chainlink-base' ? base : baseSepolia;
+    const publicClient = createPublicClient({
+        chain,
+        transport: http(config.rpcUrl),
+    });
+    // The wrapper's onSubmit appends a JSONL record to submissionLogPath.
+    // The daemon's orchestrator tails the file and reads the submission from
+    // disk. This is the only IPC mechanism that survives the process boundary.
+    const { appendFileSync } = await import('node:fs');
+    const onSubmit = (submission) => {
+        appendFileSync(config.submissionLogPath, JSON.stringify({
+            ts: Date.now(),
+            probability: submission.probability,
+            rationale: submission.rationale,
+        }) + '\n', { encoding: 'utf-8' });
+    };
+    const tools = buildPredictionTools({
+        feed: config.feed,
+        feedDescription: config.feedDescription,
+        venue: config.venue,
+        publicClient,
+        onSubmit,
+    });
+    const server = new McpServer({ name: 'jinn-prediction', version: '1.0.0' });
+    // Same cast-around-MCP-index-signature pattern as hyperliquid's startMcpServer.
+    // 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);
+    // Keep alive until stdin closes (Claude closes it at session end).
+    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/mcp-tools.js.map

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

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

@@ -0,0 +1,8 @@
+/**
+ * Prompt template for claude-mcp-prediction sessions.
+ *
+ * Kept intentionally static (no branching) so the isolation test has
+ * deterministic behavior to assert against.
+ */
+import type { PredictionV0Task } from '../../../types/prediction.js';
+export declare function buildSessionPrompt(task: PredictionV0Task, sessionId: string): string;

package/dist/harnesses/impls/claude-mcp-prediction/prompt.js

@@ -0,0 +1,54 @@
+/**
+ * Prompt template for claude-mcp-prediction sessions.
+ *
+ * Kept intentionally static (no branching) so the isolation test has
+ * deterministic behavior to assert against.
+ */
+function fmtOperator(op) {
+    switch (op) {
+        case 'GT': return '>';
+        case 'GTE': return '≥';
+        case 'LT': return '<';
+        case 'LTE': return '≤';
+    }
+}
+export function buildSessionPrompt(task, sessionId) {
+    const { oracle, question } = task.spec;
+    const { window } = task;
+    let questionLine;
+    if (question.kind === 'threshold') {
+        questionLine = `Will ${oracle.feedDescription} be ${fmtOperator(question.operator)} ${question.threshold} at resolveTs (${new Date(question.resolveTs).toISOString()})?`;
+    }
+    else {
+        questionLine = `Will ${oracle.feedDescription} be in [${question.lowerBound}, ${question.upperBound}) at resolveTs (${new Date(question.resolveTs).toISOString()})?`;
+    }
+    return [
+        `Session: ${sessionId}`,
+        '',
+        'You are evaluating a Jinn prediction Task. Decide the probability that the outcome will be YES and submit it via the submit_prediction tool.',
+        '',
+        `Question: ${questionLine}`,
+        '',
+        `Task window:  [${new Date(window.startTs).toISOString()}, ${new Date(window.endTs).toISOString()}]`,
+        `Resolution at:  ${new Date(question.resolveTs).toISOString()}`,
+        `Oracle:         Chainlink ${oracle.feedDescription} on ${oracle.venue}`,
+        '',
+        'You have exactly two tools:',
+        '',
+        '  1. read_chainlink_price — returns the current oracle price and round metadata. Call this once.',
+        '  2. submit_prediction    — submit your final probability in [0, 1] with a brief rationale.',
+        '                            Calling this ends the session. Do not call any other tool afterward.',
+        '',
+        'Approach:',
+        '  1. Call read_chainlink_price to see the current price.',
+        '  2. Reason briefly about whether the outcome (YES/NO) is likely given the current price and time remaining.',
+        '  3. Call submit_prediction with your probability (a decimal between 0 and 1) and a concise rationale.',
+        '',
+        'Guidelines:',
+        '  - Be honest. A probability of 0.5 means genuine uncertainty.',
+        '  - Do not call submit_prediction before calling read_chainlink_price.',
+        '  - The rationale should reference the price you read.',
+        '  - Keep the rationale under 2000 characters.',
+    ].join('\n');
+}
+//# sourceMappingURL=prompt.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-mcp-prediction/prompt.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,SAAS,WAAW,CAAC,EAA+B;IAClD,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,IAAI,CAAC,CAAE,OAAO,GAAG,CAAC;QACvB,KAAK,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC;QACvB,KAAK,IAAI,CAAC,CAAE,OAAO,GAAG,CAAC;QACvB,KAAK,KAAK,CAAC,CAAC,OAAO,GAAG,CAAC;IACzB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAsB,EAAE,SAAiB;IAC1E,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;IACvC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExB,IAAI,YAAoB,CAAC;IACzB,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAClC,YAAY,GAAG,QAAQ,MAAM,CAAC,eAAe,OAAO,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,SAAS,kBAAkB,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC;IAC3K,CAAC;SAAM,CAAC;QACN,YAAY,GAAG,QAAQ,MAAM,CAAC,eAAe,WAAW,QAAQ,CAAC,UAAU,KAAK,QAAQ,CAAC,UAAU,mBAAmB,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC;IACvK,CAAC;IAED,OAAO;QACL,YAAY,SAAS,EAAE;QACvB,EAAE;QACF,8IAA8I;QAC9I,EAAE;QACF,aAAa,YAAY,EAAE;QAC3B,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,6BAA6B,MAAM,CAAC,eAAe,OAAO,MAAM,CAAC,KAAK,EAAE;QACxE,EAAE;QACF,6BAA6B;QAC7B,EAAE;QACF,kGAAkG;QAClG,6FAA6F;QAC7F,kGAAkG;QAClG,EAAE;QACF,WAAW;QACX,0DAA0D;QAC1D,8GAA8G;QAC9G,wGAAwG;QACxG,EAAE;QACF,aAAa;QACb,gEAAgE;QAChE,wEAAwE;QACxE,wDAAwD;QACxD,+CAA+C;KAChD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

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

@@ -0,0 +1,43 @@
+/**
+ * Session orchestrator for claude-mcp-prediction.
+ *
+ * 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.
+ *
+ * Thin wrapper over `claude-mcp-shared/single-session-orchestrator.ts`, which
+ * is shared with `claude-mcp-prediction-apy`.
+ */
+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_prediction 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;
+}
+export declare function spawnSession(sessionId: string, prompt: string, deps: OrchestratorDeps): Promise<SessionResult>;

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-orchestrator.js","sourceRoot":"","sources":["../../../../src/harnesses/impls/claude-mcp-prediction/session-orchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,gBAAgB,GAEjB,MAAM,qDAAqD,CAAC;AA6B7D,MAAM,iBAAiB,GAAwB;IAC7C,YAAY,EAAE,yBAAyB;IACvC,MAAM,EAAE,oBAAoB;IAC5B,kBAAkB,EAAE,mBAAmB;CACxC,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,SAAiB,EACjB,MAAc,EACd,IAAsB;IAEtB,OAAO,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;AACtE,CAAC"}

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

@@ -0,0 +1,84 @@
+/**
+ * Types for claude-mcp-prediction — a Harness that spawns Claude with
+ * two MCP tools to decide a prediction.v1 probability.
+ */
+import type { PublicClient } from 'viem';
+export interface McpToolContent {
+    type: 'text';
+    text: string;
+}
+export interface McpToolResult {
+    content: McpToolContent[];
+}
+/** Discriminated union for the tool registry. Kept open to add future tools. */
+export interface PredictionToolDefinition {
+    name: string;
+    description: string;
+    /** Zod object schema — registered as the MCP input-schema shape. */
+    schema: import('zod').ZodObject<import('zod').ZodRawShape>;
+    handler: (args: unknown) => Promise<McpToolResult>;
+}
+export interface SubmissionState {
+    probability: string | null;
+    rationale: string | null;
+    submittedAt: number | null;
+}
+export interface PredictionToolDeps {
+    /** Chainlink AggregatorV3 proxy address the task is anchored to. */
+    feed: `0x${string}`;
+    /** Human-readable feed description, echoed in tool responses. */
+    feedDescription: string;
+    /** Venue label — used to sanity-check in the tool response. */
+    venue: 'chainlink-base' | 'chainlink-base-sepolia';
+    /** viem public client for reading the feed. */
+    publicClient: PublicClient;
+    /**
+     * Called when Claude invokes `submit_prediction`. The impl mutates its own
+     * SubmissionState via this callback and signals the orchestrator to terminate.
+     */
+    onSubmit: (submission: {
+        probability: string;
+        rationale: string;
+    }) => void;
+}
+export interface ClaudeMcpPredictionConfig {
+    rpcUrl?: string;
+    claudeModel?: string;
+    claudePath?: string;
+    /** Max wall time for the Claude session (ms). Default 3 min. */
+    sessionMaxMs?: number;
+    /** Injected deps for test mode — bypasses the real Claude spawn. */
+    _testDeps?: TestDeps;
+    /** CLI Harness registry without a live daemon */
+    stub?: boolean;
+}
+export interface TestDeps {
+    /**
+     * Replacement for the real session spawn. Given the MCP config path + prompt,
+     * must eventually call the `onSubmit` callback registered on the tools
+     * (via in-process MCP, or by writing to the submission state directly).
+     *
+     * Minimum-viable mock: immediately invoke the submit callback passed in ctx,
+     * then return a stub SessionResult.
+     */
+    runSession?: (args: {
+        sessionId: string;
+        prompt: string;
+        mcpConfigPath: string;
+        workingDir: string;
+        implStateDir: string;
+        timeoutMs: number;
+        signalSubmit: (probability: string, rationale: string) => void;
+    }) => Promise<SessionResult>;
+}
+export interface SessionResult {
+    sessionId: string;
+    startedAt: number;
+    endedAt: number;
+    transcriptPath: string;
+    /** True iff `submit_prediction` was called before timeout/abort. */
+    submitted: boolean;
+    /** Accumulated stdout for post-mortem. */
+    stdout: string;
+    aborted: boolean;
+}

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

@@ -0,0 +1,6 @@
+/**
+ * Types for claude-mcp-prediction — a Harness that spawns Claude with
+ * two MCP tools to decide a prediction.v1 probability.
+ */
+export {};
+//# sourceMappingURL=types.js.map

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

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