@jinn-network/client 0.1.0

package/dist/runner/claude.js

@@ -0,0 +1,193 @@
+import { spawn } from 'node:child_process';
+import { existsSync, writeFileSync, mkdtempSync, rmSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { Store } from '../store/store.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** MCP subprocess: compiled `server.js` when present, else `node --import tsx server.ts` (dev / yarn e2e). */
+function resolveJinnMcpLauncher(explicitPath) {
+    if (explicitPath) {
+        return { command: process.execPath, args: [explicitPath] };
+    }
+    const mcpDir = join(__dirname, '..', 'mcp');
+    const js = join(mcpDir, 'server.js');
+    const ts = join(mcpDir, 'server.ts');
+    if (existsSync(js)) {
+        return { command: process.execPath, args: [js] };
+    }
+    if (existsSync(ts)) {
+        return { command: process.execPath, args: ['--import', 'tsx', ts] };
+    }
+    return { command: process.execPath, args: [js] };
+}
+export class ClaudeRunner {
+    claudePath;
+    model;
+    mcpLauncher;
+    constructor(config = {}) {
+        this.claudePath = config.claudePath ?? 'claude';
+        this.model = config.model;
+        this.mcpLauncher = resolveJinnMcpLauncher(config.mcpServerPath);
+    }
+    async run(desiredState, context) {
+        const prompt = buildPrompt(desiredState);
+        // Write MCP config to temp dir
+        const tmpDir = mkdtempSync(join(tmpdir(), 'jinn-runner-'));
+        const mcpConfigPath = join(tmpDir, 'mcp-config.json');
+        writeFileSync(mcpConfigPath, JSON.stringify({
+            mcpServers: {
+                'jinn-client': {
+                    command: this.mcpLauncher.command,
+                    args: this.mcpLauncher.args,
+                    env: {
+                        DESIRED_STATE_ID: desiredState.id,
+                        DESIRED_STATE_DESCRIPTION: desiredState.description,
+                        DESIRED_STATE_CONTEXT: desiredState.context ? JSON.stringify(desiredState.context) : '',
+                        DESIRED_STATE_TYPE: desiredState.type ?? '',
+                        RESTORATION_REQUEST_ID: desiredState.restorationRequestId ?? '',
+                        REQUEST_ID: context.requestId,
+                        RESTORATION_DELIVERY_DATA: desiredState.type === 'evaluation' && desiredState.context?.restorationResult
+                            ? JSON.stringify(desiredState.context.restorationResult)
+                            : '',
+                        STORE_PATH: context.storePath ?? '',
+                        DAEMON_API_URL: context.daemonApiUrl ?? '',
+                    },
+                },
+            },
+        }));
+        try {
+            await spawnAgent(this.claudePath, prompt, mcpConfigPath, this.model, context.timeoutMs);
+            // Read result from store — the MCP tool published it as an artifact
+            if (context.storePath) {
+                const store = new Store(context.storePath);
+                try {
+                    const isEvaluation = desiredState.type === 'evaluation';
+                    const tag = isEvaluation ? 'evaluation-verdict' : 'restoration-result';
+                    const artifact = store.getArtifactByRequestId(context.requestId, tag);
+                    if (artifact) {
+                        return { data: artifact.content };
+                    }
+                }
+                finally {
+                    store.close();
+                }
+            }
+            return { data: '' };
+        }
+        finally {
+            rmSync(tmpDir, { recursive: true, force: true });
+        }
+    }
+}
+export function buildPrompt(desiredState) {
+    let contextSection = '';
+    if (desiredState.context && Object.keys(desiredState.context).length > 0) {
+        contextSection = `\n## Context\n${JSON.stringify(desiredState.context, null, 2)}\n`;
+    }
+    const isEvaluation = desiredState.type === 'evaluation';
+    const instructions = isEvaluation
+        ? `## Instructions
+1. Use get_desired_state to understand what was requested
+2. Use get_restoration_delivery to fetch the restoration result
+3. Evaluate whether the restoration achieved the desired state
+4. Use submit_restoration_result to report your verdict
+5. Use report_progress to log progress along the way
+6. Optionally use publish_artifact to record any insights`
+        : `## Instructions
+1. Use get_desired_state to understand what needs to be restored
+2. Take the necessary actions to restore it
+3. Use submit_restoration_result to report what you did
+4. Use report_progress to log progress along the way
+5. Optionally use publish_artifact to record any insights`;
+    return `You are ${isEvaluation ? 'evaluating a restoration' : 'restoring a desired state'}.
+
+## Desired State
+ID: ${desiredState.id}
+Description: ${desiredState.description}
+${contextSection}
+${instructions}
+
+Work autonomously. Do not ask questions.`;
+}
+// Environment allowlist for agent subprocess — only pass what's needed.
+// The agent must never see private keys, operator passwords, or secrets.
+const ENV_ALLOWLIST = [
+    'PATH',
+    'HOME',
+    'USER',
+    'SHELL',
+    'LANG',
+    'TERM',
+    'TMPDIR',
+    'XDG_CONFIG_HOME',
+    'XDG_DATA_HOME',
+    'XDG_CACHE_HOME',
+    'NODE_PATH',
+    'NODE_OPTIONS',
+    'NPM_CONFIG_PREFIX',
+];
+const ENV_BLOCKLIST = [
+    'PRIVATE_KEY',
+    'SECRET',
+    'PASSWORD',
+    'OPERATOR',
+    'MNEMONIC',
+    'KEYSTORE',
+    'API_KEY',
+    'AUTH_TOKEN',
+    'SERVICE_ROLE',
+];
+function buildAgentEnv() {
+    const env = {};
+    for (const key of ENV_ALLOWLIST) {
+        if (process.env[key])
+            env[key] = process.env[key];
+    }
+    return env;
+}
+function spawnAgent(claudePath, prompt, mcpConfigPath, model, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const args = ['-p', prompt, '--mcp-config', mcpConfigPath, '--strict-mcp-config'];
+        if (model)
+            args.push('--model', model);
+        args.push('--allowedTools', 'mcp__jinn-client__*');
+        console.log(`[runner] Spawning agent: ${claudePath} ${args.slice(0, 3).join(' ')} ... (timeout: ${timeoutMs}ms)`);
+        const agentEnv = buildAgentEnv();
+        const child = spawn(claudePath, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: agentEnv,
+            timeout: timeoutMs,
+        });
+        console.log(`[runner] Agent process spawned (pid: ${child.pid})`);
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.on('data', (d) => {
+            stdout += d.toString();
+            // Stream output as it arrives
+            const lines = d.toString().trim();
+            if (lines)
+                console.log(`[runner:stdout] ${lines.slice(0, 200)}`);
+        });
+        child.stderr?.on('data', (d) => {
+            stderr += d.toString();
+            const lines = d.toString().trim();
+            if (lines)
+                console.error(`[runner:stderr] ${lines.slice(0, 200)}`);
+        });
+        child.on('exit', (code, signal) => {
+            console.log(`[runner] Agent process exited (code: ${code}, signal: ${signal})`);
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`Agent exited with code ${code}, signal ${signal}: ${stderr.slice(0, 500)}`));
+            }
+        });
+        child.on('error', (err) => {
+            console.error(`[runner] Agent spawn error:`, err.message);
+            reject(err);
+        });
+    });
+}
+//# sourceMappingURL=claude.js.map

package/dist/runner/claude.js.map

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

package/dist/runner/runner.d.ts

@@ -0,0 +1,11 @@
+import type { DesiredState, RestorationResult, RequestId } from '../types/index.js';
+export interface RunnerContext {
+    requestId: RequestId;
+    workingDirectory: string;
+    timeoutMs: number;
+    storePath?: string;
+    daemonApiUrl?: string;
+}
+export interface Runner {
+    run(desiredState: DesiredState, context: RunnerContext): Promise<RestorationResult>;
+}

package/dist/runner/runner.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runner.js.map

package/dist/runner/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/runner/runner.ts"],"names":[],"mappings":""}

package/dist/runner/simple.d.ts

@@ -0,0 +1,8 @@
+import type { DesiredState, RestorationResult } from '../types/index.js';
+import type { Runner, RunnerContext } from './runner.js';
+export type RestorationFn = (description: string, context?: Record<string, unknown>) => Promise<string>;
+export declare class SimpleRunner implements Runner {
+    private readonly fn;
+    constructor(fn: RestorationFn);
+    run(desiredState: DesiredState, _context: RunnerContext): Promise<RestorationResult>;
+}

package/dist/runner/simple.js

@@ -0,0 +1,11 @@
+export class SimpleRunner {
+    fn;
+    constructor(fn) {
+        this.fn = fn;
+    }
+    async run(desiredState, _context) {
+        const data = await this.fn(desiredState.description, desiredState.context);
+        return { data };
+    }
+}
+//# sourceMappingURL=simple.js.map

package/dist/runner/simple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.js","sourceRoot":"","sources":["../../src/runner/simple.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,EAAiB;QAAjB,OAAE,GAAF,EAAE,CAAe;IAAG,CAAC;IAElD,KAAK,CAAC,GAAG,CAAC,YAA0B,EAAE,QAAuB;QAC3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,YAAY,CAAC,OAAO,CAAC,CAAC;QAC3E,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/store/store.d.ts

@@ -0,0 +1,74 @@
+export declare class Store {
+    private db;
+    readonly path: string;
+    constructor(dbPath: string);
+    recordOwnActivity(requestId: string, role: 'created' | 'claimed' | 'delivered' | 'evaluated'): void;
+    isOwnActivity(requestId: string): boolean;
+    setShutdownState(state: 'clean' | 'running'): void;
+    getShutdownState(): string | null;
+    /** Generic config row (e.g. last_reward_claim_tick_at). */
+    getConfigValue(key: string): string | null;
+    setConfigValue(key: string, value: string): void;
+    /** Counts of protocol roles recorded for this node (best-effort activity hints). */
+    getOwnActivityCounts(): Record<string, number>;
+    /** Latest own_activity rows by insertion order (approximate). */
+    getRecentOwnActivity(limit: number): Array<{
+        requestId: string;
+        role: string;
+    }>;
+    getLastProcessedBlock(): bigint | null;
+    setLastProcessedBlock(block: bigint): void;
+    insertArtifact(artifact: {
+        id: string;
+        desiredStateId: string;
+        requestId: string;
+        title: string;
+        content: string;
+        tags: string[];
+        outcome: 'SUCCESS' | 'FAILURE' | 'UNKNOWN';
+    }): void;
+    searchArtifacts(query: {
+        tags?: string[];
+        outcome?: string;
+        requestId?: string;
+        desiredStateId?: string;
+        after?: string;
+        before?: string;
+        limit?: number;
+    }): Array<{
+        id: string;
+        title: string;
+        content: string;
+        tags: string[];
+        outcome: string;
+        request_id: string;
+        desired_state_id: string;
+        created_at: string;
+    }>;
+    insertRemoteArtifact(artifact: {
+        id: string;
+        desiredStateId: string;
+        requestId: string;
+        title: string;
+        tags: string[];
+        outcome: 'SUCCESS' | 'FAILURE' | 'UNKNOWN';
+        ownerAddress: string;
+        endpoint: string;
+        price?: string;
+    }): void;
+    getArtifactContent(id: string): string | null;
+    getRemoteArtifactInfo(id: string): {
+        endpoint: string;
+        ownerAddress: string;
+        price?: string;
+    } | null;
+    getArtifactByRequestId(requestId: string, tag: string): {
+        id: string;
+        title: string;
+        content: string;
+        tags: string[];
+        outcome: string;
+    } | null;
+    cacheRemoteContent(id: string, content: string): void;
+    close(): void;
+}

package/dist/store/store.js

@@ -0,0 +1,168 @@
+import Database from 'better-sqlite3';
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS own_activity (
+  request_id TEXT PRIMARY KEY,
+  role TEXT NOT NULL CHECK (role IN ('created', 'claimed', 'delivered', 'evaluated'))
+);
+
+CREATE TABLE IF NOT EXISTS config (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS artifacts (
+  id TEXT PRIMARY KEY,
+  desired_state_id TEXT NOT NULL,
+  request_id TEXT NOT NULL,
+  title TEXT NOT NULL,
+  content TEXT,
+  tags TEXT NOT NULL DEFAULT '[]',
+  outcome TEXT NOT NULL CHECK (outcome IN ('SUCCESS', 'FAILURE', 'UNKNOWN')),
+  remote INTEGER NOT NULL DEFAULT 0,
+  owner_address TEXT,
+  endpoint TEXT,
+  price TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_artifacts_desired_state ON artifacts (desired_state_id);
+CREATE INDEX IF NOT EXISTS idx_artifacts_outcome ON artifacts (outcome);
+CREATE INDEX IF NOT EXISTS idx_artifacts_remote ON artifacts (remote);
+
+`;
+export class Store {
+    db;
+    path;
+    constructor(dbPath) {
+        this.path = dbPath;
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.db.exec(SCHEMA);
+    }
+    recordOwnActivity(requestId, role) {
+        this.db.prepare(`INSERT OR REPLACE INTO own_activity (request_id, role) VALUES (?, ?)`).run(requestId, role);
+    }
+    isOwnActivity(requestId) {
+        const row = this.db.prepare('SELECT 1 FROM own_activity WHERE request_id = ?').get(requestId);
+        return row !== undefined;
+    }
+    setShutdownState(state) {
+        this.db.prepare('INSERT OR REPLACE INTO config (key, value) VALUES (?, ?)').run('shutdown_state', state);
+    }
+    getShutdownState() {
+        const row = this.db.prepare('SELECT value FROM config WHERE key = ?').get('shutdown_state');
+        return row?.value ?? null;
+    }
+    /** Generic config row (e.g. last_reward_claim_tick_at). */
+    getConfigValue(key) {
+        const row = this.db.prepare('SELECT value FROM config WHERE key = ?').get(key);
+        return row?.value ?? null;
+    }
+    setConfigValue(key, value) {
+        this.db.prepare('INSERT OR REPLACE INTO config (key, value) VALUES (?, ?)').run(key, value);
+    }
+    /** Counts of protocol roles recorded for this node (best-effort activity hints). */
+    getOwnActivityCounts() {
+        const rows = this.db.prepare(`SELECT role, COUNT(*) as c FROM own_activity GROUP BY role`).all();
+        const out = {};
+        for (const r of rows) {
+            out[r.role] = r.c;
+        }
+        return out;
+    }
+    /** Latest own_activity rows by insertion order (approximate). */
+    getRecentOwnActivity(limit) {
+        const rows = this.db.prepare(`SELECT request_id, role FROM own_activity ORDER BY rowid DESC LIMIT ?`).all(Math.max(0, Math.min(limit, 1000)));
+        return rows.map(r => ({ requestId: r.request_id, role: r.role }));
+    }
+    getLastProcessedBlock() {
+        const row = this.db.prepare('SELECT value FROM config WHERE key = ?').get('last_processed_block');
+        return row?.value ? BigInt(row.value) : null;
+    }
+    setLastProcessedBlock(block) {
+        this.db.prepare('INSERT OR REPLACE INTO config (key, value) VALUES (?, ?)').run('last_processed_block', block.toString());
+    }
+    insertArtifact(artifact) {
+        this.db.prepare(`
+      INSERT OR REPLACE INTO artifacts (id, desired_state_id, request_id, title, content, tags, outcome)
+      VALUES (@id, @desiredStateId, @requestId, @title, @content, @tags, @outcome)
+    `).run({
+            ...artifact,
+            tags: JSON.stringify(artifact.tags),
+        });
+    }
+    searchArtifacts(query) {
+        const conditions = [];
+        const params = {};
+        if (query.outcome) {
+            conditions.push('outcome = @outcome');
+            params['outcome'] = query.outcome;
+        }
+        if (query.requestId) {
+            conditions.push('request_id = @requestId');
+            params['requestId'] = query.requestId;
+        }
+        if (query.desiredStateId) {
+            conditions.push('desired_state_id = @desiredStateId');
+            params['desiredStateId'] = query.desiredStateId;
+        }
+        if (query.after) {
+            conditions.push('created_at >= @after');
+            params['after'] = query.after;
+        }
+        if (query.before) {
+            conditions.push('created_at <= @before');
+            params['before'] = query.before;
+        }
+        if (query.tags && query.tags.length > 0) {
+            for (let i = 0; i < query.tags.length; i++) {
+                conditions.push(`tags LIKE @tag${i}`);
+                params[`tag${i}`] = `%${query.tags[i]}%`;
+            }
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limit = query.limit ?? 50;
+        const rows = this.db.prepare(`SELECT id, title, content, tags, outcome, request_id, desired_state_id, created_at FROM artifacts ${where} ORDER BY created_at DESC LIMIT ${limit}`).all(params);
+        return rows.map(row => ({
+            ...row,
+            tags: JSON.parse(row.tags),
+        }));
+    }
+    insertRemoteArtifact(artifact) {
+        this.db.prepare(`
+      INSERT OR REPLACE INTO artifacts (id, desired_state_id, request_id, title, tags, outcome, remote, owner_address, endpoint, price)
+      VALUES (@id, @desiredStateId, @requestId, @title, @tags, @outcome, 1, @ownerAddress, @endpoint, @price)
+    `).run({
+            ...artifact,
+            tags: JSON.stringify(artifact.tags),
+            price: artifact.price ?? null,
+        });
+    }
+    getArtifactContent(id) {
+        const row = this.db.prepare('SELECT content FROM artifacts WHERE id = ?').get(id);
+        return row?.content ?? null;
+    }
+    getRemoteArtifactInfo(id) {
+        const row = this.db.prepare('SELECT endpoint, owner_address, price FROM artifacts WHERE id = ? AND remote = 1').get(id);
+        if (!row)
+            return null;
+        return {
+            endpoint: row.endpoint,
+            ownerAddress: row.owner_address,
+            price: row.price ?? undefined,
+        };
+    }
+    getArtifactByRequestId(requestId, tag) {
+        const row = this.db.prepare(`SELECT id, title, content, tags, outcome FROM artifacts WHERE request_id = ? AND tags LIKE ? ORDER BY created_at DESC LIMIT 1`).get(requestId, `%${tag}%`);
+        if (!row)
+            return null;
+        return { ...row, tags: JSON.parse(row.tags) };
+    }
+    cacheRemoteContent(id, content) {
+        this.db.prepare('UPDATE artifacts SET content = ? WHERE id = ?').run(content, id);
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/store/store.js.map

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

package/dist/tx-retry.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Shared retry policy for transient RPC / transaction submission failures.
+ */
+import type { Address, Hex, PublicClient, TransactionReceipt } from 'viem';
+export declare const TX_RETRY_DEFAULTS: {
+    readonly maxAttempts: 6;
+    readonly baseDelayMs: 400;
+    readonly maxDelayMs: 12000;
+    /** Extra fee bump per retry attempt after the first (basis points, 1500 = +15%) */
+    readonly feeBumpBpsPerAttempt: 1500;
+};
+export declare function flattenErrorMessage(error: unknown): string;
+/**
+ * True when the failure is often fixed by waiting, refreshing nonce/fees, or switching RPC timing.
+ * Intentionally conservative: do not treat insufficient balance or user rejections as recoverable.
+ */
+export declare function isRecoverableTransactionError(error: unknown): boolean;
+export declare function sleep(ms: number): Promise<void>;
+export declare function backoffDelay(attemptIndex: number, baseMs: number, maxMs: number): Promise<void>;
+export interface TxRetryOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    /** If set, invoked before each retry (attempt >= 1) for logging/metrics */
+    onRetry?: (info: {
+        attempt: number;
+        error: unknown;
+        message: string;
+    }) => void;
+}
+export declare function withRecoverableRetry<T>(fn: (attemptIndex: number) => Promise<T>, options?: TxRetryOptions): Promise<T>;
+/** EIP-1559 or legacy gas overrides for viem, increasingly aggressive on later attempts. */
+export declare function viemFeeOverridesForAttempt(publicClient: PublicClient, attemptIndex: number): Promise<{
+    maxFeePerGas: bigint;
+    maxPriorityFeePerGas: bigint;
+} | {
+    gasPrice: bigint;
+} | Record<string, never>>;
+export declare function waitForTransactionReceiptWithRetry(publicClient: PublicClient, hash: Hex, options?: TxRetryOptions & {
+    pollingInterval?: number;
+    confirmations?: number;
+}): Promise<TransactionReceipt>;
+export declare function viemSendTransactionWithRetry(walletClient: {
+    sendTransaction: (tx: any) => Promise<Hex>;
+}, publicClient: PublicClient, txRequest: {
+    account: any;
+    to?: Address;
+    data?: Hex;
+    value?: bigint;
+    gas?: bigint;
+    maxFeePerGas?: bigint;
+    maxPriorityFeePerGas?: bigint;
+    gasPrice?: bigint;
+    [key: string]: any;
+}, options?: TxRetryOptions): Promise<Hex>;