@jinn-network/client 0.1.0

package/dist/mcp/server.js

@@ -0,0 +1,205 @@
+/**
+ * MCP server for jinn-client — exposes tools to agent subprocesses.
+ *
+ * Spawned by ClaudeRunner as a subprocess via StdioServerTransport.
+ * Receives context via env vars:
+ *   DESIRED_STATE_ID          — ID of the current desired state
+ *   DESIRED_STATE_DESCRIPTION — Human-readable description
+ *   DESIRED_STATE_CONTEXT     — JSON context (optional)
+ *   REQUEST_ID                — On-chain request ID
+ *   RESTORATION_DELIVERY_DATA — JSON delivery data (evaluation requests only)
+ *
+ * Usage: yarn exec tsx src/mcp/server.ts
+ */
+import { randomUUID } from 'node:crypto';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { Store } from '../store/store.js';
+const server = new McpServer({
+    name: 'jinn-client',
+    version: '0.1.0',
+});
+// Read desired state from env vars (passed by ClaudeRunner)
+const desiredState = {
+    id: process.env['DESIRED_STATE_ID'] ?? '',
+    description: process.env['DESIRED_STATE_DESCRIPTION'] ?? '',
+    context: process.env['DESIRED_STATE_CONTEXT']
+        ? JSON.parse(process.env['DESIRED_STATE_CONTEXT'])
+        : undefined,
+    type: process.env['DESIRED_STATE_TYPE'] ?? '',
+    restorationRequestId: process.env['RESTORATION_REQUEST_ID'] ?? '',
+};
+const requestId = process.env['REQUEST_ID'] ?? '';
+const storePath = process.env['STORE_PATH'] ?? '';
+const store = storePath ? new Store(storePath) : null;
+const daemonApiUrl = process.env['DAEMON_API_URL'] ?? '';
+// ── Tools ────────────────────────────────────────────────────────────────────
+server.tool('get_desired_state', 'Get the current desired state that needs to be restored', {}, async () => ({
+    content: [{
+            type: 'text',
+            text: JSON.stringify({
+                id: desiredState.id,
+                description: desiredState.description,
+                context: desiredState.context,
+                type: desiredState.type || undefined,
+                restorationRequestId: desiredState.restorationRequestId || undefined,
+                requestId,
+            }),
+        }],
+}));
+server.tool('report_progress', 'Report progress on the restoration', { message: z.string().describe('Progress message') }, async ({ message }) => {
+    console.error(`[mcp] Progress: ${message}`);
+    return {
+        content: [{ type: 'text', text: 'Progress reported' }],
+    };
+});
+server.tool('submit_restoration_result', 'Submit the result of a restoration attempt', {
+    success: z.boolean().describe('Whether the restoration was successful'),
+    description: z.string().describe('Description of what was done'),
+    data: z.string().optional().describe('Result data or artifact content'),
+}, async ({ success, description, data }) => {
+    const isEvaluation = desiredState.type === 'evaluation';
+    const resultTag = isEvaluation ? 'evaluation-verdict' : 'restoration-result';
+    const id = randomUUID();
+    const artifact = {
+        id,
+        desiredStateId: desiredState.id,
+        requestId,
+        title: `${resultTag}: ${description.slice(0, 80)}`,
+        content: data ?? description,
+        tags: [resultTag, success ? 'success' : 'failure'],
+        outcome: (success ? 'SUCCESS' : 'FAILURE'),
+    };
+    // Publish via daemon API if available, otherwise direct store write
+    if (daemonApiUrl) {
+        try {
+            const response = await fetch(`${daemonApiUrl}/artifacts`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify(artifact),
+            });
+            if (!response.ok) {
+                console.error(`[mcp] Failed to POST artifact to daemon: ${response.status}`);
+            }
+        }
+        catch (err) {
+            console.error(`[mcp] Failed to POST artifact to daemon:`, err);
+        }
+    }
+    else if (store) {
+        store.insertArtifact(artifact);
+    }
+    console.error(`[mcp] Result published as artifact: ${id} [${resultTag}]`);
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ submitted: true, id, tag: resultTag }) }],
+    };
+});
+server.tool('get_restoration_delivery', 'Get the restoration result that needs to be evaluated (only available for evaluation requests)', {}, async () => {
+    const raw = process.env['RESTORATION_DELIVERY_DATA'];
+    if (!raw) {
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ error: 'Not an evaluation request or no delivery data available' }),
+                }],
+        };
+    }
+    return {
+        content: [{
+                type: 'text',
+                text: JSON.stringify({
+                    restorationRequestId: desiredState.restorationRequestId,
+                    deliveryData: JSON.parse(raw),
+                }),
+            }],
+    };
+});
+server.tool('publish_artifact', 'Publish a knowledge artifact for future agents to reference', {
+    title: z.string().describe('Short title for the artifact'),
+    content: z.string().describe('The artifact content (text, JSON, etc)'),
+    tags: z.array(z.string()).optional().describe('Tags for categorization'),
+    outcome: z.enum(['SUCCESS', 'FAILURE', 'UNKNOWN']).optional().describe('Outcome of the work this artifact relates to'),
+}, async ({ title, content, tags, outcome }) => {
+    const id = randomUUID();
+    if (store) {
+        store.insertArtifact({
+            id,
+            desiredStateId: desiredState.id,
+            requestId,
+            title,
+            content,
+            tags: tags ?? [],
+            outcome: outcome ?? 'UNKNOWN',
+        });
+    }
+    console.error(`[mcp] Artifact published: ${id} — ${title}`);
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ published: true, id, title }) }],
+    };
+});
+server.tool('search_artifacts', 'Search previously published knowledge artifacts', {
+    tags: z.array(z.string()).optional().describe('Filter by tags (e.g. ["restoration-result", "success"])'),
+    outcome: z.enum(['SUCCESS', 'FAILURE', 'UNKNOWN']).optional().describe('Filter by outcome'),
+    requestId: z.string().optional().describe('Filter by on-chain request ID'),
+    desiredStateId: z.string().optional().describe('Filter by desired state ID'),
+    after: z.string().optional().describe('Only return artifacts created after this ISO timestamp'),
+    before: z.string().optional().describe('Only return artifacts created before this ISO timestamp'),
+    limit: z.number().optional().describe('Max results (default 50)'),
+}, async ({ tags, outcome, requestId, desiredStateId, after, before, limit }) => {
+    if (!store) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: 'No store configured', results: [] }) }],
+        };
+    }
+    const results = store.searchArtifacts({ tags, outcome, requestId, desiredStateId, after, before, limit });
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ results }) }],
+    };
+});
+server.tool('acquire_artifact', 'Fetch the content of a remote artifact from a peer node', {
+    id: z.string().describe('Artifact ID to acquire'),
+}, async ({ id }) => {
+    if (!store) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: 'No store configured' }) }],
+        };
+    }
+    // Check if content is already cached locally
+    const cached = store.getArtifactContent(id);
+    if (cached) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ id, content: cached, cached: true }) }],
+        };
+    }
+    // Check if we know where to fetch it
+    const remoteInfo = store.getRemoteArtifactInfo(id);
+    if (!remoteInfo) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: `Artifact ${id} not found (no remote info)` }) }],
+        };
+    }
+    // Fetch from peer
+    try {
+        const response = await fetch(`${remoteInfo.endpoint}/artifacts/${id}/content`);
+        if (!response.ok) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: `Fetch failed: ${response.status}` }) }],
+            };
+        }
+        const data = await response.json();
+        store.cacheRemoteContent(id, data.content);
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ id, content: data.content, cached: false }) }],
+        };
+    }
+    catch (err) {
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: `Fetch error: ${err instanceof Error ? err.message : String(err)}` }) }],
+        };
+    }
+});
+// ── Start ────────────────────────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE1C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,aAAa;IACnB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,4DAA4D;AAC5D,MAAM,YAAY,GAAG;IACnB,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,EAAE;IACzC,WAAW,EAAE,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,IAAI,EAAE;IAC3D,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAC3C,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAA4B;QAC7E,CAAC,CAAC,SAAS;IACb,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,EAAE;IAC7C,oBAAoB,EAAE,OAAO,CAAC,GAAG,CAAC,wBAAwB,CAAC,IAAI,EAAE;CAClE,CAAC;AAEF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;AAClD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;AAClD,MAAM,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACtD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;AAEzD,gFAAgF;AAEhF,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,yDAAyD,EACzD,EAAE,EACF,KAAK,IAAI,EAAE,CAAC,CAAC;IACX,OAAO,EAAE,CAAC;YACR,IAAI,EAAE,MAAe;YACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,EAAE,EAAE,YAAY,CAAC,EAAE;gBACnB,WAAW,EAAE,YAAY,CAAC,WAAW;gBACrC,OAAO,EAAE,YAAY,CAAC,OAAO;gBAC7B,IAAI,EAAE,YAAY,CAAC,IAAI,IAAI,SAAS;gBACpC,oBAAoB,EAAE,YAAY,CAAC,oBAAoB,IAAI,SAAS;gBACpE,SAAS;aACV,CAAC;SACH,CAAC;CACH,CAAC,CACH,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,oCAAoC,EACpC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,EACpD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;IACpB,OAAO,CAAC,KAAK,CAAC,mBAAmB,OAAO,EAAE,CAAC,CAAC;IAC5C,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;KAChE,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,2BAA2B,EAC3B,4CAA4C,EAC5C;IACE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACvE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAChE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;CACxE,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,EAAE;IACvC,MAAM,YAAY,GAAG,YAAY,CAAC,IAAI,KAAK,YAAY,CAAC;IACxD,MAAM,SAAS,GAAG,YAAY,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAC7E,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IAExB,MAAM,QAAQ,GAAG;QACf,EAAE;QACF,cAAc,EAAE,YAAY,CAAC,EAAE;QAC/B,SAAS;QACT,KAAK,EAAE,GAAG,SAAS,KAAK,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;QAClD,OAAO,EAAE,IAAI,IAAI,WAAW;QAC5B,IAAI,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAClD,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAsC;KAChF,CAAC;IAEF,oEAAoE;IACpE,IAAI,YAAY,EAAE,CAAC;QACjB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,YAAY,YAAY,EAAE;gBACxD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;aAC/B,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,CAAC,KAAK,CAAC,4CAA4C,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,GAAG,CAAC,CAAC;QACjE,CAAC;IACH,CAAC;SAAM,IAAI,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,SAAS,GAAG,CAAC,CAAC;IAC1E,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;KACpG,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,0BAA0B,EAC1B,gGAAgG,EAChG,EAAE,EACF,KAAK,IAAI,EAAE;IACT,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;IACrD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;YACL,OAAO,EAAE,CAAC;oBACR,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,yDAAyD,EAAE,CAAC;iBAC3F,CAAC;SACH,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC;gBACR,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,oBAAoB,EAAE,YAAY,CAAC,oBAAoB;oBACvD,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;iBAC9B,CAAC;aACH,CAAC;KACH,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,6DAA6D,EAC7D;IACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;IAC1D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACtE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;IACxE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACvH,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE;IAC1C,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACxB,IAAI,KAAK,EAAE,CAAC;QACV,KAAK,CAAC,cAAc,CAAC;YACnB,EAAE;YACF,cAAc,EAAE,YAAY,CAAC,EAAE;YAC/B,SAAS;YACT,KAAK;YACL,OAAO;YACP,IAAI,EAAE,IAAI,IAAI,EAAE;YAChB,OAAO,EAAE,OAAO,IAAI,SAAS;SAC9B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,6BAA6B,EAAE,MAAM,KAAK,EAAE,CAAC,CAAC;IAC5D,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;KAC3F,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,iDAAiD,EACjD;IACE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IACxG,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC3F,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+BAA+B,CAAC;IAC1E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4BAA4B,CAAC;IAC5E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IAC/F,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yDAAyD,CAAC;IACjG,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;CAClE,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE;IAC3E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;SAC1G,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1G,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;KACxE,CAAC;AACJ,CAAC,CACF,CAAC;AAEF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,yDAAyD,EACzD;IACE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;CAClD,EACD,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;IACf,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC;SAC7F,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,MAAM,MAAM,GAAG,KAAK,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;IAC5C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;SAClG,CAAC;IACJ,CAAC;IAED,qCAAqC;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,6BAA6B,EAAE,CAAC,EAAE,CAAC;SACnH,CAAC;IACJ,CAAC;IAED,kBAAkB;IAClB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,UAAU,CAAC,QAAQ,cAAc,EAAE,UAAU,CAAC,CAAC;QAC/E,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iBAAiB,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;aAC1G,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAyB,CAAC;QAC1D,KAAK,CAAC,kBAAkB,CAAC,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;SACzG,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,gBAAgB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;SAC1I,CAAC;IACJ,CAAC;AACH,CAAC,CACF,CAAC;AAEF,gFAAgF;AAEhF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/operator-errors.d.ts

@@ -0,0 +1,16 @@
+/**
+ * User-facing error formatting for operators.
+ * Full stack traces and raw RPC errors are reserved for JINN_DEBUG mode.
+ */
+/** True when JINN_DEBUG is set (also mirrored in loadConfig as `debug`). */
+export declare function isJinnDebug(): boolean;
+export interface OperatorErrorParts {
+    /** Primary operator-facing line */
+    summary: string;
+    /** Optional follow-up guidance */
+    hint?: string;
+}
+/**
+ * Map common Safe / RPC failures to short messages. Falls back to a trimmed raw line.
+ */
+export declare function formatBootstrapOperatorMessage(error: unknown): OperatorErrorParts;

package/dist/operator-errors.js

@@ -0,0 +1,88 @@
+/**
+ * User-facing error formatting for operators.
+ * Full stack traces and raw RPC errors are reserved for JINN_DEBUG mode.
+ */
+function envDebugTruthy(value) {
+    if (value === undefined)
+        return false;
+    const v = value.trim().toLowerCase();
+    return v === '1' || v === 'true' || v === 'yes';
+}
+/** True when JINN_DEBUG is set (also mirrored in loadConfig as `debug`). */
+export function isJinnDebug() {
+    return envDebugTruthy(process.env['JINN_DEBUG']);
+}
+function stringifyUnknown(error) {
+    if (error === null || error === undefined)
+        return String(error);
+    if (typeof error === 'string')
+        return error;
+    if (error instanceof Error) {
+        let s = error.message;
+        const withCause = error;
+        if (withCause.cause !== undefined && withCause.cause !== null) {
+            s += ' | ' + stringifyUnknown(withCause.cause);
+        }
+        return s;
+    }
+    if (typeof error === 'object') {
+        const o = error;
+        const parts = [];
+        if (typeof o.shortMessage === 'string')
+            parts.push(o.shortMessage);
+        if (typeof o.details === 'string')
+            parts.push(o.details);
+        if (typeof o.message === 'string' && !parts.includes(o.message))
+            parts.push(o.message);
+        if (parts.length > 0)
+            return parts.join(' | ');
+        try {
+            return JSON.stringify(error);
+        }
+        catch {
+            return String(error);
+        }
+    }
+    return String(error);
+}
+/**
+ * Map common Safe / RPC failures to short messages. Falls back to a trimmed raw line.
+ */
+export function formatBootstrapOperatorMessage(error) {
+    const msg = stringifyUnknown(error);
+    const lower = msg.toLowerCase();
+    if (msg.includes('GS013')) {
+        return {
+            summary: 'Gnosis Safe could not execute or estimate this transaction (GS013: inner call may have reverted or gas estimation failed).',
+            hint: 'Retry after a few blocks or switch RPC. Full cause chain is in the error envelope details.',
+        };
+    }
+    if (msg.includes('GS026')) {
+        return {
+            summary: 'Gnosis Safe rejected the transaction (GS026: invalid owner address or signature).',
+            hint: 'Confirm the signing key is a Safe owner and the Safe address matches your fleet state.',
+        };
+    }
+    if (lower.includes('replacement transaction underpriced') ||
+        lower.includes('replacement fee too low') ||
+        lower.includes('fee cap less than block base fee')) {
+        return {
+            summary: 'A transaction with the same nonce is already pending, and the new gas price is too low.',
+            hint: 'Wait for confirmation, cancel/replace with a higher maxFeePerGas, or clear the stuck nonce.',
+        };
+    }
+    if (lower.includes('insufficient funds') ||
+        msg.includes('INSUFFICIENT_FUNDS') ||
+        lower.includes('exceeds the balance of the account')) {
+        return {
+            summary: 'Not enough ETH on the paying account to cover gas (and value, if any).',
+            hint: 'Send ETH to the master wallet, agent EOA, or Safe depending on which step failed.',
+        };
+    }
+    const firstLine = msg.split('\n')[0]?.trim() ?? msg;
+    if (firstLine.length > 220) {
+        return { summary: `${firstLine.slice(0, 220)}…` };
+    }
+    return { summary: firstLine };
+}
+//# sourceMappingURL=operator-errors.js.map

package/dist/operator-errors.js.map

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

package/dist/preflight/claude-binary.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Preflight check: is the `claude` CLI resolvable and executable?
+ *
+ * The daemon spawns Claude Code as a subprocess via `ClaudeRunner`
+ * (client/src/runner/claude.ts). If the binary isn't on PATH (or at
+ * the configured claudePath), the failure surfaces only at the moment
+ * a request is claimed — long after bootstrap. This check moves that
+ * failure to startup with a clear envelope.
+ */
+export interface ClaudeBinaryCheckResult {
+    ok: boolean;
+    resolvedPath?: string;
+    detail: string;
+}
+/**
+ * Resolve and verify a `claude` binary. Accepts either an absolute path or a
+ * bare name to look up on PATH (via `which`/`where`).
+ */
+export declare function checkClaudeBinary(claudePath: string): Promise<ClaudeBinaryCheckResult>;

package/dist/preflight/claude-binary.js

@@ -0,0 +1,44 @@
+/**
+ * Preflight check: is the `claude` CLI resolvable and executable?
+ *
+ * The daemon spawns Claude Code as a subprocess via `ClaudeRunner`
+ * (client/src/runner/claude.ts). If the binary isn't on PATH (or at
+ * the configured claudePath), the failure surfaces only at the moment
+ * a request is claimed — long after bootstrap. This check moves that
+ * failure to startup with a clear envelope.
+ */
+import { promises as fs, constants as fsConstants } from 'node:fs';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { isAbsolute } from 'node:path';
+const execFileAsync = promisify(execFile);
+/**
+ * Resolve and verify a `claude` binary. Accepts either an absolute path or a
+ * bare name to look up on PATH (via `which`/`where`).
+ */
+export async function checkClaudeBinary(claudePath) {
+    // Absolute / relative path: fs.access is authoritative.
+    if (isAbsolute(claudePath) || claudePath.includes('/')) {
+        try {
+            await fs.access(claudePath, fsConstants.X_OK);
+            return { ok: true, resolvedPath: claudePath, detail: `${claudePath} is executable` };
+        }
+        catch {
+            return { ok: false, detail: `claude binary not found at ${claudePath}` };
+        }
+    }
+    // Bare name: shell out to `which` (POSIX) or `where` (Windows). We only
+    // support POSIX here; the production target is macOS/Linux.
+    try {
+        const { stdout } = await execFileAsync('which', [claudePath]);
+        const resolved = stdout.trim().split('\n')[0];
+        if (!resolved) {
+            return { ok: false, detail: `claude binary '${claudePath}' not found on PATH` };
+        }
+        return { ok: true, resolvedPath: resolved, detail: `${resolved} is on PATH` };
+    }
+    catch {
+        return { ok: false, detail: `claude binary '${claudePath}' not found on PATH` };
+    }
+}
+//# sourceMappingURL=claude-binary.js.map

package/dist/preflight/claude-binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-binary.js","sourceRoot":"","sources":["../../src/preflight/claude-binary.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,SAAS,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAQ1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,UAAkB;IACxD,wDAAwD;IACxD,IAAI,UAAU,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC;YAC9C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,UAAU,gBAAgB,EAAE,CAAC;QACvF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,8BAA8B,UAAU,EAAE,EAAE,CAAC;QAC3E,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,4DAA4D;IAC5D,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,OAAO,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,UAAU,qBAAqB,EAAE,CAAC;QAClF,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,QAAQ,aAAa,EAAE,CAAC;IAChF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,UAAU,qBAAqB,EAAE,CAAC;IAClF,CAAC;AACH,CAAC"}

package/dist/preflight/claude-invocation-envelope.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Build and emit the `invalid_invocation` envelope when the Claude CLI
+ * preflight fails. Shared by `main.ts` and unit tests so the contract stays
+ * in one place (spec §6 / §6.2 / §7.6).
+ */
+import { type EnvelopeSinks } from '../errors/envelope.js';
+/** §7.6 — omit forbidden absolute paths from envelope `details.attempted`. */
+export declare function sanitizedClaudeAttemptedForEnvelope(claudePath: string): string;
+/** §7.6 — `invalid_invocation.message` must not echo forbidden absolute paths. */
+export declare function sanitizedClaudePreflightMessageForEnvelope(detail: string, claudePath: string): string;
+export declare function emitClaudeBinaryPreflightFailure(detail: string, claudePath: string, sinks?: EnvelopeSinks): never;

package/dist/preflight/claude-invocation-envelope.js

@@ -0,0 +1,67 @@
+/**
+ * Build and emit the `invalid_invocation` envelope when the Claude CLI
+ * preflight fails. Shared by `main.ts` and unit tests so the contract stays
+ * in one place (spec §6 / §6.2 / §7.6).
+ */
+import { homedir } from 'node:os';
+import { dirname, isAbsolute, join, normalize, resolve, sep } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { emitEnvelope } from '../errors/envelope.js';
+const THIS_DIR = dirname(fileURLToPath(import.meta.url));
+const ENVELOPE_INSTALL_ROOT = normalize(resolve(THIS_DIR, '..', '..'));
+const ENVELOPE_JINN_CLIENT_HOME = normalize(resolve(join(homedir(), '.jinn-client')));
+function envelopePathUnderRoot(absPath, root) {
+    const p = normalize(resolve(absPath));
+    const r = normalize(resolve(root));
+    if (p === r)
+        return true;
+    const prefix = r.endsWith(sep) ? r : r + sep;
+    return p.startsWith(prefix);
+}
+/** §7.6 — omit forbidden absolute paths from envelope `details.attempted`. */
+export function sanitizedClaudeAttemptedForEnvelope(claudePath) {
+    const t = claudePath.trim();
+    if (!t)
+        return 'configured path';
+    if (isAbsolute(t) &&
+        (envelopePathUnderRoot(t, ENVELOPE_JINN_CLIENT_HOME) || envelopePathUnderRoot(t, ENVELOPE_INSTALL_ROOT))) {
+        return 'configured path';
+    }
+    return t;
+}
+/** §7.6 — `invalid_invocation.message` must not echo forbidden absolute paths. */
+export function sanitizedClaudePreflightMessageForEnvelope(detail, claudePath) {
+    let out = detail;
+    const t = claudePath.trim();
+    const replaceAll = (s, find, rep) => (find ? s.split(find).join(rep) : s);
+    if (isAbsolute(t) &&
+        (envelopePathUnderRoot(t, ENVELOPE_JINN_CLIENT_HOME) || envelopePathUnderRoot(t, ENVELOPE_INSTALL_ROOT))) {
+        const variants = new Set([t, normalize(t)]);
+        try {
+            variants.add(normalize(resolve(t)));
+        }
+        catch {
+            /* ignore */
+        }
+        for (const v of [...variants].filter(Boolean).sort((a, b) => b.length - a.length)) {
+            out = replaceAll(out, v, 'configured path');
+        }
+    }
+    out = replaceAll(out, ENVELOPE_JINN_CLIENT_HOME, 'configured path');
+    out = replaceAll(out, ENVELOPE_INSTALL_ROOT, 'configured path');
+    return out;
+}
+export function emitClaudeBinaryPreflightFailure(detail, claudePath, sinks = {}) {
+    emitEnvelope({
+        code: 'invalid_invocation',
+        message: sanitizedClaudePreflightMessageForEnvelope(detail, claudePath),
+        hint: 'Install Claude Code CLI on your PATH, or set the CLI binary path in your configuration file.',
+        exampleCli: 'command -v claude',
+        details: {
+            field: 'claude_binary',
+            expected: 'executable claude binary',
+            attempted: sanitizedClaudeAttemptedForEnvelope(claudePath),
+        },
+    }, sinks);
+}
+//# sourceMappingURL=claude-invocation-envelope.js.map

package/dist/preflight/claude-invocation-envelope.js.map

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

package/dist/runner/claude.d.ts

@@ -0,0 +1,15 @@
+import type { DesiredState, RestorationResult } from '../types/index.js';
+import type { Runner, RunnerContext } from './runner.js';
+export interface ClaudeRunnerConfig {
+    claudePath?: string;
+    model?: string;
+    mcpServerPath?: string;
+}
+export declare class ClaudeRunner implements Runner {
+    private claudePath;
+    private model?;
+    private readonly mcpLauncher;
+    constructor(config?: ClaudeRunnerConfig);
+    run(desiredState: DesiredState, context: RunnerContext): Promise<RestorationResult>;
+}
+export declare function buildPrompt(desiredState: DesiredState): string;