@jinn-network/client 0.1.2-canary.d6e72dfd → 0.1.2

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

@@ -0,0 +1,233 @@
+/**
+ * claude-mcp-prediction-apy — RestorerImpl for prediction.apy.v0 that spawns a
+ * single Claude Code session with read_aave_reserve + submit_apy_prediction.
+ *
+ * Opt-in via config.restorers.byKind['prediction.apy.v0']; baseline remains default.
+ * Isolation gate: test/restorer/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 { PredictionApyV0IntentSchema } 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.kind === 'prediction.apy.v0' && ctx.type !== '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(_args) {
+        return { status: 'ready' };
+    }
+    async canAttempt(intent) {
+        const parsed = PredictionApyV0IntentSchema.safeParse(intent);
+        if (!parsed.success)
+            return { ok: false, reason: `Invalid prediction.apy.v0 intent: ${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 { intent, workingDir, log } = ctx;
+        const parsed = PredictionApyV0IntentSchema.parse(intent);
+        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);
+        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);
+        }
+        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',
+            ...(this.config.claudeModel ? { claudeModel: this.config.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);
+    }
+    _finalize(intent, sessionId, transcriptPath, submission, startedAt, endedAt) {
+        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.${this.config.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 } = intent.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,
+            },
+            artifacts: [
+                { path: 'prediction-apy.json', role: 'prediction_submission' },
+                {
+                    path: transcriptPath,
+                    role: '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/restorer/impls/claude-mcp-prediction-apy/index.js.map

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

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

@@ -0,0 +1,18 @@
+/**
+ * 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 type { ApyPredictionToolDefinition, ApyPredictionToolDeps, AaveV3Venue } from './types.js';
+export declare function buildApyPredictionTools(deps: ApyPredictionToolDeps): ApyPredictionToolDefinition[];
+export interface McpServerConfig {
+    venue: AaveV3Venue;
+    pool: `0x${string}`;
+    reserve: `0x${string}`;
+    reserveSymbol: string;
+    rpcUrl: string;
+    submissionLogPath: string;
+}
+export declare function startMcpServer(config: McpServerConfig): Promise<void>;

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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"}