@jinn-network/client 0.1.2 → 0.1.3-canary.262e5cda

package/dist/runner/claude.js

@@ -4,6 +4,7 @@ import { dirname, join } from 'node:path';
 import { tmpdir } from 'node:os';
 import { fileURLToPath } from 'node:url';
 import { Store } from '../store/store.js';
+import { tracedSpawn } from '../trajectory/index.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) {
@@ -30,8 +31,8 @@ export class ClaudeRunner {
         this.model = config.model;
         this.mcpLauncher = resolveJinnMcpLauncher(config.mcpServerPath);
     }
-    async run(desiredState, context) {
-        const prompt = buildPrompt(desiredState);
+    async run(restorationJob, context) {
+        const prompt = buildPrompt(restorationJob);
         // Write MCP config to temp dir
         const tmpDir = mkdtempSync(join(tmpdir(), 'jinn-runner-'));
         const mcpConfigPath = join(tmpDir, 'mcp-config.json');
@@ -41,28 +42,59 @@ export class ClaudeRunner {
                     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 ?? '',
+                        DESIRED_STATE_ID: restorationJob.id,
+                        DESIRED_STATE_DESCRIPTION: restorationJob.description,
+                        DESIRED_STATE_CONTEXT: restorationJob.context ? JSON.stringify(restorationJob.context) : '',
+                        DESIRED_STATE_TYPE: restorationJob.type ?? '',
+                        RESTORATION_REQUEST_ID: restorationJob.restorationRequestId ?? '',
                         REQUEST_ID: context.requestId,
-                        RESTORATION_DELIVERY_DATA: desiredState.type === 'evaluation' && desiredState.context?.restorationResult
-                            ? JSON.stringify(desiredState.context.restorationResult)
+                        RESTORATION_DELIVERY_DATA: restorationJob.type === 'evaluation' && restorationJob.context?.restorationResult
+                            ? JSON.stringify(restorationJob.context.restorationResult)
                             : '',
                         STORE_PATH: context.storePath ?? '',
                         DAEMON_API_URL: context.daemonApiUrl ?? '',
+                        // Bearer token for the daemon's cost-mutating routes. MCP
+                        // subprocess attaches this as `Authorization: Bearer <token>`
+                        // on fetches to `POST /v1/artifacts/acquire` and
+                        // `POST /artifacts`. Empty string when unset → daemon returns 401.
+                        DAEMON_API_TOKEN: context.daemonApiToken ?? '',
+                        // Subgraph + IPFS gateway only — both keyless. The agent EOA
+                        // private key NEVER leaves the daemon process; acquire_artifact
+                        // proxies through DAEMON_API_URL instead.
+                        JINN_CORPUS_SUBGRAPH_URL: context.corpusEnv?.subgraphUrl ?? '',
+                        JINN_CORPUS_IPFS_GATEWAY_URL: context.corpusEnv?.ipfsGatewayUrl ?? '',
                     },
                 },
             },
         }));
         try {
-            await spawnAgent(this.claudePath, prompt, mcpConfigPath, this.model, context.timeoutMs);
+            if (context.trajectory) {
+                // Traced path — wrap spawn with tracedSpawn so the subprocess lifetime
+                // surfaces as a jinn.state_transition span in the run's trajectory.
+                const agentEnv = buildAgentEnv();
+                const args = buildAgentArgs(prompt, mcpConfigPath, this.model);
+                console.log(`[runner] Spawning agent (traced): ${this.claudePath} ${args.slice(0, 3).join(' ')} ... (timeout: ${context.timeoutMs}ms)`);
+                const result = await tracedSpawn({
+                    collector: context.trajectory,
+                    cmd: this.claudePath,
+                    args,
+                    env: agentEnv,
+                    stateFrom: 'PREPARED',
+                    stateTo: 'RAN_CLAUDE',
+                });
+                console.log(`[runner] Agent process exited (exitCode: ${result.exitCode})`);
+                if (result.exitCode !== 0) {
+                    throw new Error(`Agent exited with code ${result.exitCode}: ${result.stderr.slice(0, 500)}`);
+                }
+            }
+            else {
+                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 isEvaluation = restorationJob.type === 'evaluation';
                     const tag = isEvaluation ? 'evaluation-verdict' : 'restoration-result';
                     const artifact = store.getArtifactByRequestId(context.requestId, tag);
                     if (artifact) {
@@ -80,12 +112,12 @@ export class ClaudeRunner {
         }
     }
 }
-export function buildPrompt(desiredState) {
+export function buildPrompt(restorationJob) {
     let contextSection = '';
-    if (desiredState.context && Object.keys(desiredState.context).length > 0) {
-        contextSection = `\n## Context\n${JSON.stringify(desiredState.context, null, 2)}\n`;
+    if (restorationJob.context && Object.keys(restorationJob.context).length > 0) {
+        contextSection = `\n## Context\n${JSON.stringify(restorationJob.context, null, 2)}\n`;
     }
-    const isEvaluation = desiredState.type === 'evaluation';
+    const isEvaluation = restorationJob.type === 'evaluation';
     const instructions = isEvaluation
         ? `## Instructions
 1. Use get_desired_state to understand what was requested
@@ -103,8 +135,8 @@ export function buildPrompt(desiredState) {
     return `You are ${isEvaluation ? 'evaluating a restoration' : 'restoring a desired state'}.
 
 ## Desired State
-ID: ${desiredState.id}
-Description: ${desiredState.description}
+ID: ${restorationJob.id}
+Description: ${restorationJob.description}
 ${contextSection}
 ${instructions}
 
@@ -161,12 +193,16 @@ function buildAgentEnv() {
     }
     return env;
 }
+function buildAgentArgs(prompt, mcpConfigPath, model) {
+    const args = ['-p', prompt, '--mcp-config', mcpConfigPath, '--strict-mcp-config'];
+    if (model)
+        args.push('--model', model);
+    args.push('--allowedTools', 'mcp__jinn-client__*');
+    return args;
+}
 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__*');
+        const args = buildAgentArgs(prompt, mcpConfigPath, model);
         console.log(`[runner] Spawning agent: ${claudePath} ${args.slice(0, 3).join(' ')} ... (timeout: ${timeoutMs}ms)`);
         const agentEnv = buildAgentEnv();
         const child = spawn(claudePath, args, {

package/dist/runner/claude.js.map

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

package/dist/runner/runner.d.ts

@@ -1,11 +1,38 @@
-import type { DesiredState, RestorationResult, RequestId } from '../types/index.js';
+import type { RestorationJob, RestorationResult, RequestId } from '../types/index.js';
+import type { TrajectoryCollector } from '../trajectory/index.js';
 export interface RunnerContext {
     requestId: RequestId;
     workingDirectory: string;
     timeoutMs: number;
     storePath?: string;
     daemonApiUrl?: string;
+    /**
+     * Bearer token required by the daemon's cost-mutating API routes
+     * (`POST /artifacts`, `POST /v1/artifacts/acquire`). Forwarded into the
+     * MCP subprocess via `DAEMON_API_TOKEN` and attached to fetch headers.
+     * When omitted, MCP calls those routes without an Authorization header
+     * and the daemon will respond 401.
+     */
+    daemonApiToken?: string;
+    /**
+     * Optional corpus configuration forwarded to the MCP subprocess so its
+     * `search_artifacts` tool can hit the keyless subgraph + IPFS gateway.
+     * `acquire_artifact` no longer needs anything from this block — it
+     * proxies to the daemon at `daemonApiUrl` and the daemon owns the agent
+     * EOA private key. When omitted, both tools fall back to local-only
+     * behavior. Spec: spec/2026-04-30-phase-a-umbrella.md §4.
+     */
+    corpusEnv?: {
+        subgraphUrl?: string;
+        ipfsGatewayUrl?: string;
+    };
+    /**
+     * In-run trajectory collector. When provided, the runner emits a
+     * jinn.state_transition span wrapping the Claude subprocess lifetime.
+     * Scope §3.2 traced-I/O boundary.
+     */
+    trajectory?: TrajectoryCollector;
 }
 export interface Runner {
-    run(desiredState: DesiredState, context: RunnerContext): Promise<RestorationResult>;
+    run(restorationJob: RestorationJob, context: RunnerContext): Promise<RestorationResult>;
 }

package/dist/runner/simple.d.ts

@@ -1,8 +1,8 @@
-import type { DesiredState, RestorationResult } from '../types/index.js';
+import type { RestorationJob, 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>;
+    run(restorationJob: RestorationJob, _context: RunnerContext): Promise<RestorationResult>;
 }

package/dist/runner/simple.js

@@ -3,8 +3,8 @@ export class SimpleRunner {
     constructor(fn) {
         this.fn = fn;
     }
-    async run(desiredState, _context) {
-        const data = await this.fn(desiredState.description, desiredState.context);
+    async run(restorationJob, _context) {
+        const data = await this.fn(restorationJob.description, restorationJob.context);
         return { data };
     }
 }

package/dist/runner/simple.js.map

@@ -1 +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"}
+{"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,cAA8B,EAAE,QAAuB;QAC/D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,cAAc,CAAC,WAAW,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;QAC/E,OAAO,EAAE,IAAI,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/scripts/fix-node-pty.mjs

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+/**
+ * Fix node-pty spawn-helper permissions on macOS.
+ *
+ * node-pty's prebuilt darwin-{arm64,x64} packages ship the `spawn-helper`
+ * binary with mode 644 instead of 755. posix_spawnp can't exec it, so the
+ * first pty.spawn() call throws with "posix_spawnp failed". The fix is a
+ * 1-line chmod; without it the agent panel's claude subprocess fails to
+ * start with a misleading "no stdin data received" error.
+ *
+ * Pattern lifted from siteboon/claudecodeui (scripts/fix-node-pty.js).
+ * Upstream issue: https://github.com/microsoft/node-pty/issues/850
+ */
+
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+async function fixSpawnHelper() {
+  if (process.platform !== 'darwin') return;
+
+  // The script ships in two places depending on context:
+  //   - dev: client/scripts/fix-node-pty.mjs    (uses ../node_modules)
+  //   - published: client/dist/scripts/         (uses ../../node_modules)
+  // Try both upward paths.
+  const candidateRoots = [
+    path.join(__dirname, '..'),
+    path.join(__dirname, '..', '..'),
+  ];
+
+  let prebuildsDir = null;
+  for (const root of candidateRoots) {
+    const candidate = path.join(root, 'node_modules', 'node-pty', 'prebuilds');
+    try {
+      await fs.access(candidate);
+      prebuildsDir = candidate;
+      break;
+    } catch {
+      // try next
+    }
+  }
+  if (!prebuildsDir) return; // node-pty not installed; nothing to fix
+
+  for (const dir of ['darwin-arm64', 'darwin-x64']) {
+    const helper = path.join(prebuildsDir, dir, 'spawn-helper');
+    try {
+      await fs.access(helper);
+      await fs.chmod(helper, 0o755);
+      console.log(`[postinstall] chmod 755 ${helper}`);
+    } catch (err) {
+      if (err && err.code !== 'ENOENT') {
+        console.warn(`[postinstall] could not fix ${helper}: ${err.message}`);
+      }
+    }
+  }
+}
+
+fixSpawnHelper().catch((err) => {
+  console.warn('[postinstall] fix-node-pty failed (non-fatal):', err.message);
+});

package/dist/setup-mode.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Setup-mode controller for the daemon.
+ *
+ * The daemon process can be in two states:
+ * - 'setup'   — Hono API + operator MCP are up, but the daemon loops
+ *               (creator, engine-watcher, delivery-watcher, ...) are gated.
+ *               Used when the keystore is missing or bootstrap is incomplete.
+ * - 'running' — All loops are active.
+ *
+ * `computeDaemonMode` is a pure function from inputs to mode.
+ * `createSetupModeController` wraps it with a small state machine that supports
+ * `refresh()` on input changes and `waitUntilRunning()` for callers that need
+ * to gate their start-up on the running transition.
+ */
+export type DaemonMode = 'setup' | 'running';
+export interface DaemonModeInputs {
+    /** True when the master keystore exists on disk. */
+    keystoreExists: boolean;
+    /** True when every service in the fleet is operational (`complete` or `safe_binding_pending`). */
+    allComplete: boolean;
+}
+export declare function computeDaemonMode(inputs: DaemonModeInputs): DaemonMode;
+export interface SetupModeController {
+    /** Current mode. */
+    mode(): DaemonMode;
+    /**
+     * Resolves once the mode is or becomes 'running'. If already running,
+     * resolves on next microtask.
+     */
+    waitUntilRunning(): Promise<void>;
+    /** Re-evaluate the mode based on the input thunks. */
+    refresh(inputs: DaemonModeInputs): void;
+}
+export declare function createSetupModeController(initial: DaemonModeInputs): SetupModeController;

package/dist/setup-mode.js

@@ -0,0 +1,49 @@
+/**
+ * Setup-mode controller for the daemon.
+ *
+ * The daemon process can be in two states:
+ * - 'setup'   — Hono API + operator MCP are up, but the daemon loops
+ *               (creator, engine-watcher, delivery-watcher, ...) are gated.
+ *               Used when the keystore is missing or bootstrap is incomplete.
+ * - 'running' — All loops are active.
+ *
+ * `computeDaemonMode` is a pure function from inputs to mode.
+ * `createSetupModeController` wraps it with a small state machine that supports
+ * `refresh()` on input changes and `waitUntilRunning()` for callers that need
+ * to gate their start-up on the running transition.
+ */
+export function computeDaemonMode(inputs) {
+    if (!inputs.keystoreExists)
+        return 'setup';
+    if (!inputs.allComplete)
+        return 'setup';
+    return 'running';
+}
+export function createSetupModeController(initial) {
+    let current = computeDaemonMode(initial);
+    const waiters = [];
+    return {
+        mode: () => current,
+        waitUntilRunning: () => {
+            if (current === 'running')
+                return Promise.resolve();
+            return new Promise((resolve) => waiters.push(resolve));
+        },
+        refresh: (inputs) => {
+            const next = computeDaemonMode(inputs);
+            if (next === current)
+                return;
+            current = next;
+            if (next === 'running') {
+                while (waiters.length > 0) {
+                    const w = waiters.shift();
+                    try {
+                        w?.();
+                    }
+                    catch { /* swallow waiter errors */ }
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=setup-mode.js.map

package/dist/setup-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-mode.js","sourceRoot":"","sources":["../src/setup-mode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,MAAM,UAAU,iBAAiB,CAAC,MAAwB;IACxD,IAAI,CAAC,MAAM,CAAC,cAAc;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,CAAC,MAAM,CAAC,WAAW;QAAE,OAAO,OAAO,CAAC;IACxC,OAAO,SAAS,CAAC;AACnB,CAAC;AAcD,MAAM,UAAU,yBAAyB,CAAC,OAAyB;IACjE,IAAI,OAAO,GAAe,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,OAAO,GAAsB,EAAE,CAAC;IAEtC,OAAO;QACL,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO;QAEnB,gBAAgB,EAAE,GAAG,EAAE;YACrB,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;YACpD,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;YAClB,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACvC,IAAI,IAAI,KAAK,OAAO;gBAAE,OAAO;YAC7B,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC1B,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBAAC,CAAC,EAAE,EAAE,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAC,2BAA2B,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/store/store.d.ts

@@ -39,6 +39,53 @@ export interface BalanceCacheEntry {
     fetchedAt: string;
     error?: string | null;
 }
+export interface ServedArtifactInput {
+    sha256: string;
+    artifactType: string;
+    requestId?: string | null;
+    envelopeCid?: string | null;
+    content: Buffer;
+    priceUsdc: string;
+    createdAt: string;
+}
+export interface ServedArtifactRow {
+    sha256: string;
+    artifactType: string;
+    requestId: string | null;
+    envelopeCid: string | null;
+    content: Buffer;
+    contentSize: number;
+    priceUsdc: string;
+    createdAt: string;
+}
+export type NetworkArtifactSource = 'origin' | 'route-resolver' | 'self-store-mirror';
+export interface NetworkArtifactInput {
+    sha256: string;
+    artifactType: string;
+    envelopeCid?: string | null;
+    content: Buffer;
+    source: NetworkArtifactSource;
+    sourceOperator?: string | null;
+    sourceEndpoint?: string | null;
+    paidAmountUsdc: string;
+    fetchedAt: string;
+    /** When set, links this blob to a row from the HTTP catalog / peer sync `artifacts.id`. */
+    peerCatalogId?: string | null;
+}
+export interface NetworkArtifactRow {
+    sha256: string;
+    artifactType: string;
+    envelopeCid: string | null;
+    content: Buffer;
+    contentSize: number;
+    source: NetworkArtifactSource;
+    sourceOperator: string | null;
+    sourceEndpoint: string | null;
+    paidAmountUsdc: string;
+    fetchedAt: string;
+    lastUsedAt: string;
+    peerCatalogId: string | null;
+}
 export type IntentPostingPolicyType = 'once_per_safe' | 'once_per_bucket' | 'interval';
 export interface IntentPostRecord {
     creatorSafeAddress: string;
@@ -56,6 +103,8 @@ export declare class Store {
     readonly db: Database.Database;
     readonly path: string;
     constructor(dbPath: string);
+    /** Older on-disk DBs predate `peer_catalog_id` on network_artifacts. */
+    private ensureNetworkArtifactsPeerCatalogId;
     /** Idempotent: older DBs before idx_reward_claims_tx may lack the unique index. */
     private ensureRewardClaimsTxIndex;
     recordOwnActivity(requestId: string, role: 'created' | 'claimed' | 'delivered' | 'evaluated'): void;
@@ -116,6 +165,7 @@ export declare class Store {
     upsertBalanceCache(entry: BalanceCacheEntry): void;
     getBalanceCache(): BalanceCacheEntry[];
     private backfillActivityEvents;
+    getIntentEvidenceHash(requestId: string): string | null;
     getLastProcessedBlock(): bigint | null;
     setLastProcessedBlock(block: bigint): void;
     insertArtifact(artifact: {
@@ -156,8 +206,13 @@ export declare class Store {
         endpoint: string;
         price?: string;
     }): void;
-    getArtifactContent(id: string): string | null;
-    getRemoteArtifactInfo(id: string): {
+    /**
+     * Text body for a catalog artifact id: local `artifacts.content`, else a peer-cached
+     * blob in `network_artifacts` (via `peer_catalog_id`).
+     */
+    resolveCatalogArtifactContent(id: string): string | null;
+    /** Endpoint / owner for a remote (peer-synced) catalog row in `artifacts`. */
+    getRemoteDiscoveryMetadata(id: string): {
         endpoint: string;
         ownerAddress: string;
         price?: string;
@@ -169,6 +224,27 @@ export declare class Store {
         tags: string[];
         outcome: string;
     } | null;
-    cacheRemoteContent(id: string, content: string): void;
+    saveServedArtifact(input: ServedArtifactInput): void;
+    getServedArtifact(sha256: string): ServedArtifactRow | null;
+    setServedArtifactEnvelopeCid(sha256: string, envelopeCid: string): void;
+    getServedArtifactsByRequestId(requestId: string): ServedArtifactRow[];
+    saveNetworkArtifact(input: NetworkArtifactInput): void;
+    getNetworkArtifact(sha256: string): NetworkArtifactRow | null;
+    touchNetworkArtifactUsage(sha256: string, ts: string): void;
+    /**
+     * Local fast-path search across own (served) artifacts and cached (network)
+     * artifacts. Used by the MCP `search_artifacts` tool to prepend local
+     * matches to corpus query results.
+     */
+    searchOwnAndCached(filter: {
+        artifactType?: string;
+        limit: number;
+    }): Array<{
+        sha256: string;
+        artifactType: string;
+        source: 'served' | 'network';
+        envelopeCid: string | null;
+        createdAt: string;
+    }>;
     close(): void;
 }