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

package/dist/corpus/acquire.js

@@ -0,0 +1,155 @@
+/**
+ * Per-artifact resolution chain: cache → self-store → routeResolver → origin.
+ *
+ * Always hash-verifies before persisting to cache.
+ *
+ * Spec §2.3 step 4-6.
+ */
+import { createHash } from 'node:crypto';
+import { acquireArtifactWithPayment } from '../x402/acquire.js';
+import { AcquireError, HashMismatchError } from './types.js';
+function sha256Hex(buf) {
+    return createHash('sha256').update(buf).digest('hex');
+}
+export async function acquireArtifactContent(args) {
+    const { sha256, artifactType, access, store, selfSafeAddress, privateKey, routeResolver, envelopeCid, ownerSafe, acquireFn = acquireArtifactWithPayment, } = args;
+    const now = () => new Date().toISOString();
+    // 1. Cache hit
+    const cached = store.getNetworkArtifact(sha256);
+    if (cached) {
+        store.touchNetworkArtifactUsage(sha256, now());
+        return {
+            sha256,
+            bytes: cached.content,
+            artifactType: cached.artifactType,
+            source: 'cache',
+            paidAmountUsdc: '0',
+            fetchedAt: cached.fetchedAt,
+            sourceOperator: cached.sourceOperator ?? undefined,
+        };
+    }
+    // 2. Self-store fast path
+    if (ownerSafe && ownerSafe.toLowerCase() === selfSafeAddress.toLowerCase()) {
+        const own = store.getServedArtifact(sha256);
+        if (own) {
+            // Re-verify before mirroring. If served_artifacts has been corrupted
+            // (disk error, manual edit, future migration bug, etc.) we must NOT
+            // propagate the bad bytes into network_artifacts where peers can
+            // fetch them via x402. Throwing closes the cache-poisoning gap; the
+            // self-store path is now hash-equivalent to origin / route-resolver.
+            const actualSha = sha256Hex(own.content);
+            if (actualSha !== sha256) {
+                throw new HashMismatchError(sha256, actualSha, 'self-store', selfSafeAddress);
+            }
+            // Mirror into cache so peer asks for the same content can hit cache (provenance: self-store-mirror).
+            const ts = now();
+            store.saveNetworkArtifact({
+                sha256,
+                artifactType: own.artifactType,
+                envelopeCid: own.envelopeCid,
+                content: own.content,
+                source: 'self-store-mirror',
+                paidAmountUsdc: '0',
+                fetchedAt: ts,
+            });
+            return {
+                sha256,
+                bytes: own.content,
+                artifactType: own.artifactType,
+                source: 'self-store',
+                paidAmountUsdc: '0',
+                fetchedAt: ts,
+            };
+        }
+    }
+    // 3. Route resolver
+    if (routeResolver) {
+        try {
+            const out = await routeResolver.resolve({ sha256, access, requesterSafe: selfSafeAddress });
+            if (out) {
+                const actualSha = sha256Hex(out.bytes);
+                if (actualSha !== sha256) {
+                    throw new HashMismatchError(sha256, actualSha, 'route-resolver', out.sourceOperator);
+                }
+                const ts = now();
+                store.saveNetworkArtifact({
+                    sha256,
+                    artifactType,
+                    envelopeCid: envelopeCid ?? null,
+                    content: out.bytes,
+                    source: 'route-resolver',
+                    sourceOperator: out.sourceOperator ?? null,
+                    paidAmountUsdc: out.pricePaidUsdc,
+                    fetchedAt: ts,
+                });
+                return {
+                    sha256,
+                    bytes: out.bytes,
+                    artifactType,
+                    source: 'route-resolver',
+                    paidAmountUsdc: out.pricePaidUsdc,
+                    fetchedAt: ts,
+                    sourceOperator: out.sourceOperator,
+                };
+            }
+        }
+        catch (err) {
+            if (err instanceof HashMismatchError)
+                throw err;
+            throw new AcquireError(sha256, 'routeResolver failed', err);
+        }
+    }
+    // 4. Origin fetch
+    let bytes;
+    try {
+        const raw = await acquireFn(access.endpoint, sha256, privateKey);
+        // Accept both the legacy `Buffer | null` shape and the new discriminated
+        // union from acquireArtifactWithPayment. Buffer.isBuffer guards before
+        // we duck-type into the union.
+        if (raw === null || Buffer.isBuffer(raw)) {
+            bytes = raw;
+        }
+        else if (raw.ok === true) {
+            bytes = raw.content;
+        }
+        else {
+            // ok: false — preserve the reason so the caller / daemon route can
+            // surface it via AcquireError.cause.
+            throw new AcquireError(sha256, `origin fetch failed: ${raw.reason}${raw.message ? ` (${raw.message})` : ''}`, raw);
+        }
+    }
+    catch (err) {
+        if (err instanceof AcquireError)
+            throw err;
+        throw new AcquireError(sha256, 'origin fetch failed', err);
+    }
+    if (!bytes) {
+        throw new AcquireError(sha256, 'origin returned null (404 / payment failed)');
+    }
+    const actualSha = sha256Hex(bytes);
+    if (actualSha !== sha256) {
+        throw new HashMismatchError(sha256, actualSha, 'origin', ownerSafe);
+    }
+    const ts = now();
+    store.saveNetworkArtifact({
+        sha256,
+        artifactType,
+        envelopeCid: envelopeCid ?? null,
+        content: bytes,
+        source: 'origin',
+        sourceOperator: ownerSafe ?? null,
+        sourceEndpoint: access.endpoint,
+        paidAmountUsdc: access.priceUsdc,
+        fetchedAt: ts,
+    });
+    return {
+        sha256,
+        bytes,
+        artifactType,
+        source: 'origin',
+        paidAmountUsdc: access.priceUsdc,
+        fetchedAt: ts,
+        sourceOperator: ownerSafe,
+    };
+}
+//# sourceMappingURL=acquire.js.map

package/dist/corpus/acquire.js.map

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

package/dist/corpus/cache.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Corpus cache helpers.
+ *
+ * The corpus library reuses the existing `network_artifacts` and `served_artifacts`
+ * tables on the daemon's `Store`. There is no separate corpus cache layer — the
+ * acquire chain in `acquire.ts` is the only writer/reader. This module exposes
+ * thin convenience helpers for higher-level code that wants to inspect or
+ * pre-populate the cache without going through `acquireArtifactContent`.
+ *
+ * Spec: spec/2026-04-30-phase-a-umbrella.md §2.4 (caching semantics).
+ */
+import type { Store, NetworkArtifactRow } from '../store/store.js';
+export declare function getCachedArtifact(store: Store, sha256: string): NetworkArtifactRow | null;
+export declare function hasCachedArtifact(store: Store, sha256: string): boolean;

package/dist/corpus/cache.js

@@ -0,0 +1,18 @@
+/**
+ * Corpus cache helpers.
+ *
+ * The corpus library reuses the existing `network_artifacts` and `served_artifacts`
+ * tables on the daemon's `Store`. There is no separate corpus cache layer — the
+ * acquire chain in `acquire.ts` is the only writer/reader. This module exposes
+ * thin convenience helpers for higher-level code that wants to inspect or
+ * pre-populate the cache without going through `acquireArtifactContent`.
+ *
+ * Spec: spec/2026-04-30-phase-a-umbrella.md §2.4 (caching semantics).
+ */
+export function getCachedArtifact(store, sha256) {
+    return store.getNetworkArtifact(sha256);
+}
+export function hasCachedArtifact(store, sha256) {
+    return store.getNetworkArtifact(sha256) !== null;
+}
+//# sourceMappingURL=cache.js.map

package/dist/corpus/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/corpus/cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,UAAU,iBAAiB,CAAC,KAAY,EAAE,MAAc;IAC5D,OAAO,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAY,EAAE,MAAc;IAC5D,OAAO,KAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;AACnD,CAAC"}

package/dist/corpus/fetch.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Fetch a manifest envelope from IPFS by CID and parse it under the v1 schema.
+ *
+ * Spec §2.3 step 2.
+ */
+import type { EnvelopeRef, ManifestPreview } from './types.js';
+type FetchFromIpfs = (gatewayUrl: string, cid: string) => Promise<unknown>;
+export declare function fetchManifest(ref: EnvelopeRef, ipfsGatewayUrl: string, fetchImpl?: FetchFromIpfs): Promise<ManifestPreview>;
+export {};

package/dist/corpus/fetch.js

@@ -0,0 +1,24 @@
+/**
+ * Fetch a manifest envelope from IPFS by CID and parse it under the v1 schema.
+ *
+ * Spec §2.3 step 2.
+ */
+import { SignedEnvelopeSchema } from '../types/envelope.js';
+import { fetchFromIpfs } from '../adapters/mech/ipfs.js';
+import { ManifestFetchError } from './types.js';
+export async function fetchManifest(ref, ipfsGatewayUrl, fetchImpl = fetchFromIpfs) {
+    let raw;
+    try {
+        raw = await fetchImpl(ipfsGatewayUrl, ref.manifestCid);
+    }
+    catch (err) {
+        throw new ManifestFetchError(ref.manifestCid, 'IPFS fetch failed', err);
+    }
+    const parsed = SignedEnvelopeSchema.safeParse(raw);
+    if (!parsed.success) {
+        throw new ManifestFetchError(ref.manifestCid, `schema parse failed: ${parsed.error.issues.map((i) => `${i.path.join('.')}: ${i.message}`).join('; ')}`);
+    }
+    const envelope = parsed.data;
+    return { ref, envelope };
+}
+//# sourceMappingURL=fetch.js.map

package/dist/corpus/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/corpus/fetch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAuB,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIhD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAgB,EAChB,cAAsB,EACtB,YAA2B,aAAa;IAExC,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,SAAS,CAAC,cAAc,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,kBAAkB,CAAC,GAAG,CAAC,WAAW,EAAE,mBAAmB,EAAE,GAAG,CAAC,CAAC;IAC1E,CAAC;IACD,MAAM,MAAM,GAAG,oBAAoB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAC1B,GAAG,CAAC,WAAW,EACf,wBAAwB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACzG,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAmB,MAAM,CAAC,IAAI,CAAC;IAC7C,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC3B,CAAC"}

package/dist/corpus/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Corpus library entry point.
+ *
+ * Spec: spec/2026-04-30-phase-a-umbrella.md §2.
+ */
+import type { Corpus, CorpusOptions } from './types.js';
+export type { Corpus, CorpusOptions, CorpusQuery, EnvelopeRef, ManifestPreview, Envelope, ArtifactContent, ReadArgs, RouteResolver, } from './types.js';
+export { CorpusQueryError, ManifestFetchError, AcquireError, HashMismatchError } from './types.js';
+export { noopRouteResolver } from './route-resolver.js';
+export { getCachedArtifact, hasCachedArtifact } from './cache.js';
+interface InternalDeps {
+    fetch?: typeof globalThis.fetch;
+    fetchFromIpfs?: (gatewayUrl: string, cid: string) => Promise<unknown>;
+    acquireFn?: (endpoint: string, sha256: string, privateKey: string) => Promise<Buffer | null>;
+}
+export declare function createCorpus(opts: CorpusOptions, deps?: InternalDeps): Corpus;

package/dist/corpus/index.js

@@ -0,0 +1,78 @@
+/**
+ * Corpus library entry point.
+ *
+ * Spec: spec/2026-04-30-phase-a-umbrella.md §2.
+ */
+import { runCorpusQuery } from './query.js';
+import { fetchManifest } from './fetch.js';
+import { acquireArtifactContent } from './acquire.js';
+export { CorpusQueryError, ManifestFetchError, AcquireError, HashMismatchError } from './types.js';
+export { noopRouteResolver } from './route-resolver.js';
+export { getCachedArtifact, hasCachedArtifact } from './cache.js';
+export function createCorpus(opts, deps = {}) {
+    const fetchImpl = deps.fetch ?? globalThis.fetch;
+    const fetchFromIpfsImpl = deps.fetchFromIpfs;
+    const acquireFn = deps.acquireFn;
+    async function query(q) {
+        return runCorpusQuery(opts.subgraphUrl, q, fetchImpl);
+    }
+    async function fetchOne(ref) {
+        return fetchManifest(ref, opts.ipfsGatewayUrl, fetchFromIpfsImpl);
+    }
+    async function acquire(manifest) {
+        const contents = new Map();
+        for (const a of manifest.envelope.artifacts) {
+            const ac = await acquireArtifactContent({
+                sha256: a.sha256,
+                artifactType: a.artifactType,
+                access: a.access,
+                store: opts.store,
+                selfSafeAddress: opts.selfSafeAddress,
+                privateKey: opts.signer.privateKey,
+                routeResolver: opts.routeResolver,
+                envelopeCid: manifest.ref.manifestCid,
+                ownerSafe: manifest.envelope.participant.safeAddress,
+                acquireFn,
+            });
+            contents.set(a.sha256, ac);
+        }
+        return { ref: manifest.ref, envelope: manifest.envelope, artifactContents: contents };
+    }
+    async function acquireBySha256(sha256, access, hint) {
+        return acquireArtifactContent({
+            sha256,
+            artifactType: hint?.artifactType ?? 'unknown',
+            access,
+            store: opts.store,
+            selfSafeAddress: opts.selfSafeAddress,
+            privateKey: opts.signer.privateKey,
+            routeResolver: opts.routeResolver,
+            envelopeCid: hint?.envelopeCid,
+            acquireFn,
+        });
+    }
+    async function read(args) {
+        const refs = await query(args.query);
+        const previews = [];
+        for (const ref of refs) {
+            previews.push(await fetchOne(ref));
+        }
+        // Post-fetch kind filter (subgraph index doesn't expose intent kind; spec §10 Q6).
+        const kindFilter = args.query.kind;
+        const kindFiltered = kindFilter ? previews.filter((p) => p.envelope.kind === kindFilter) : previews;
+        const selected = args.select ? args.select(kindFiltered) : kindFiltered;
+        const envelopes = [];
+        for (const sel of selected) {
+            envelopes.push(await acquire(sel));
+        }
+        return envelopes;
+    }
+    return {
+        read,
+        query,
+        fetchManifest: fetchOne,
+        acquire,
+        acquireBySha256,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/corpus/index.js.map

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

package/dist/corpus/query.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Subgraph GraphQL query for the corpus.
+ *
+ * v0: query Execution rows; filter by evidenceTier, participant, time window
+ * directly on the subgraph; filter by `kind` (intent kind) post-fetch since the
+ * subgraph's Execution.kind is the router-level ENVELOPE/EVALUATION discriminator,
+ * not the per-intent-kind string.
+ *
+ * Spec §2.3 step 1, §10 Q6.
+ */
+import type { CorpusQuery, EnvelopeRef } from './types.js';
+export interface BuiltQuery {
+    query: string;
+    variables: Record<string, unknown>;
+}
+export declare function buildSubgraphQuery(q: CorpusQuery): BuiltQuery;
+export declare function runCorpusQuery(subgraphUrl: string, q: CorpusQuery, fetchImpl?: typeof globalThis.fetch): Promise<EnvelopeRef[]>;

package/dist/corpus/query.js

@@ -0,0 +1,108 @@
+/**
+ * Subgraph GraphQL query for the corpus.
+ *
+ * v0: query Execution rows; filter by evidenceTier, participant, time window
+ * directly on the subgraph; filter by `kind` (intent kind) post-fetch since the
+ * subgraph's Execution.kind is the router-level ENVELOPE/EVALUATION discriminator,
+ * not the per-intent-kind string.
+ *
+ * Spec §2.3 step 1, §10 Q6.
+ */
+import { CorpusQueryError } from './types.js';
+const HARD_LIMIT = 500;
+const DEFAULT_LIMIT = 50;
+const QUERY_GQL = `
+  query CorpusExecutions(
+    $first: Int!,
+    $tier: ExecutionTier,
+    $publishedAfter: BigInt,
+    $publishedBefore: BigInt,
+    $operatorWallet: Bytes,
+  ) {
+    executions(
+      first: $first,
+      where: {
+        tier: $tier,
+        publishedAt_gte: $publishedAfter,
+        publishedAt_lte: $publishedBefore,
+        operator_: { agentWallet: $operatorWallet },
+      },
+      orderBy: publishedAt,
+      orderDirection: desc,
+    ) {
+      id
+      manifestCid
+      manifestHash
+      tier
+      publishedAt
+      operator {
+        id
+        agentId
+        owner
+        agentWallet
+      }
+    }
+  }
+`;
+const TIER_TO_GQL = {
+    'self-signed': 'SELF_SIGNED',
+    'committed': 'COMMITTED',
+    'attested': 'ATTESTED',
+};
+const TIER_FROM_GQL = {
+    SELF_SIGNED: 'self-signed',
+    COMMITTED: 'committed',
+    ATTESTED: 'attested',
+    UNKNOWN: 'unknown',
+};
+export function buildSubgraphQuery(q) {
+    const first = Math.min(Math.max(1, q.limit ?? DEFAULT_LIMIT), HARD_LIMIT);
+    const variables = {
+        first,
+        tier: q.evidenceTier ? TIER_TO_GQL[q.evidenceTier] : null,
+        publishedAfter: q.generatedAfter !== undefined ? String(q.generatedAfter) : null,
+        publishedBefore: q.generatedBefore !== undefined ? String(q.generatedBefore) : null,
+        operatorWallet: q.participant?.safeAddress ?? null,
+        kind: null, // post-fetch filter; spec §10 Q6.
+    };
+    return { query: QUERY_GQL, variables };
+}
+export async function runCorpusQuery(subgraphUrl, q, fetchImpl = globalThis.fetch) {
+    const built = buildSubgraphQuery(q);
+    let response;
+    try {
+        response = await fetchImpl(subgraphUrl, {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(built),
+        });
+    }
+    catch (err) {
+        throw new CorpusQueryError(`subgraph fetch failed`, err);
+    }
+    if (!response.ok) {
+        throw new CorpusQueryError(`subgraph HTTP ${response.status}`);
+    }
+    let body;
+    try {
+        body = (await response.json());
+    }
+    catch (err) {
+        throw new CorpusQueryError(`subgraph returned non-JSON body`, err);
+    }
+    if (body.errors && body.errors.length > 0) {
+        throw new CorpusQueryError(`subgraph errors: ${body.errors.map((e) => e.message).join('; ')}`);
+    }
+    const rows = body.data?.executions ?? [];
+    return rows.map((r) => ({
+        manifestCid: r.manifestCid,
+        manifestHash: r.manifestHash,
+        operator: {
+            agentId: r.operator.agentId,
+            safeAddress: r.operator.agentWallet ?? r.operator.owner,
+        },
+        evidenceTier: TIER_FROM_GQL[r.tier] ?? 'unknown',
+        publishedAt: Number(r.publishedAt),
+    }));
+}
+//# sourceMappingURL=query.js.map

package/dist/corpus/query.js.map

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

package/dist/corpus/route-resolver.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Default RouteResolver — uses the artifact's own access.endpoint directly.
+ *
+ * Phase A.1 doesn't ship a centralized resolver: every artifact descriptor in
+ * the manifest envelope already carries its own `access.endpoint` and
+ * `access.priceUsdc`. The default resolver simply returns null so the acquire
+ * chain falls through to the origin x402 fetch using those fields.
+ *
+ * Future phases may introduce a real resolver (e.g. multi-mirror selection,
+ * DHT lookup, peer routing) by implementing the `RouteResolver` interface from
+ * `./types.js`.
+ *
+ * Spec: spec/2026-04-30-phase-a-umbrella.md §2.5.
+ */
+import type { RouteResolver } from './types.js';
+export declare const noopRouteResolver: RouteResolver;

package/dist/corpus/route-resolver.js

@@ -0,0 +1,20 @@
+/**
+ * Default RouteResolver — uses the artifact's own access.endpoint directly.
+ *
+ * Phase A.1 doesn't ship a centralized resolver: every artifact descriptor in
+ * the manifest envelope already carries its own `access.endpoint` and
+ * `access.priceUsdc`. The default resolver simply returns null so the acquire
+ * chain falls through to the origin x402 fetch using those fields.
+ *
+ * Future phases may introduce a real resolver (e.g. multi-mirror selection,
+ * DHT lookup, peer routing) by implementing the `RouteResolver` interface from
+ * `./types.js`.
+ *
+ * Spec: spec/2026-04-30-phase-a-umbrella.md §2.5.
+ */
+export const noopRouteResolver = {
+    async resolve() {
+        return null;
+    },
+};
+//# sourceMappingURL=route-resolver.js.map

package/dist/corpus/route-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-resolver.js","sourceRoot":"","sources":["../../src/corpus/route-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,KAAK,CAAC,OAAO;QACX,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAC"}

package/dist/corpus/types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Public types for the corpus library.
+ *
+ * See spec/2026-04-30-phase-a-umbrella.md §2.2 for the rationale and the
+ * narrative description of the read pipeline.
+ */
+import type { Store } from '../store/store.js';
+import type { SignedEnvelope } from '../types/envelope.js';
+export interface CorpusOptions {
+    subgraphUrl: string;
+    ipfsGatewayUrl: string;
+    store: Store;
+    signer: {
+        privateKey: string;
+    };
+    selfSafeAddress: string;
+    routeResolver?: RouteResolver;
+}
+export interface CorpusQuery {
+    kind?: string;
+    intentCid?: string;
+    participant?: {
+        safeAddress?: string;
+    };
+    evidenceTier?: 'self-signed' | 'committed' | 'attested';
+    generatedAfter?: number;
+    generatedBefore?: number;
+    limit?: number;
+}
+export interface ReadArgs {
+    query: CorpusQuery;
+    select?: (manifests: ManifestPreview[]) => ManifestPreview[];
+}
+export interface EnvelopeRef {
+    manifestCid: string;
+    manifestHash: string;
+    operator: {
+        agentId: string;
+        safeAddress: string;
+    };
+    evidenceTier: 'self-signed' | 'committed' | 'attested' | 'unknown';
+    publishedAt: number;
+}
+export interface ManifestPreview {
+    ref: EnvelopeRef;
+    envelope: SignedEnvelope;
+}
+export interface ArtifactContent {
+    sha256: string;
+    bytes: Buffer;
+    artifactType: string;
+    source: 'cache' | 'self-store' | 'origin' | 'route-resolver';
+    paidAmountUsdc: string;
+    fetchedAt: string;
+    sourceOperator?: string;
+}
+export interface Envelope extends ManifestPreview {
+    artifactContents: Map<string, ArtifactContent>;
+}
+export interface RouteResolver {
+    resolve(req: {
+        sha256: string;
+        access: {
+            endpoint: string;
+            priceUsdc: string;
+        };
+        requesterSafe: string;
+    }): Promise<{
+        bytes: Buffer;
+        sourceOperator?: string;
+        pricePaidUsdc: string;
+    } | null>;
+}
+export interface Corpus {
+    read(args: ReadArgs): Promise<Envelope[]>;
+    query(q: CorpusQuery): Promise<EnvelopeRef[]>;
+    fetchManifest(ref: EnvelopeRef): Promise<ManifestPreview>;
+    acquire(manifest: ManifestPreview): Promise<Envelope>;
+    acquireBySha256(sha256: string, access: {
+        endpoint: string;
+        priceUsdc: string;
+    }, hint?: {
+        artifactType?: string;
+        envelopeCid?: string;
+    }): Promise<ArtifactContent>;
+}
+export declare class CorpusQueryError extends Error {
+    readonly cause?: unknown | undefined;
+    constructor(message: string, cause?: unknown | undefined);
+}
+export declare class ManifestFetchError extends Error {
+    readonly manifestCid: string;
+    readonly cause?: unknown | undefined;
+    constructor(manifestCid: string, message: string, cause?: unknown | undefined);
+}
+export declare class AcquireError extends Error {
+    readonly sha256: string;
+    readonly cause?: unknown | undefined;
+    constructor(sha256: string, message: string, cause?: unknown | undefined);
+}
+export declare class HashMismatchError extends Error {
+    readonly sha256Expected: string;
+    readonly sha256Actual: string;
+    readonly source: string;
+    readonly sourceOperator?: string | undefined;
+    constructor(sha256Expected: string, sha256Actual: string, source: string, sourceOperator?: string | undefined);
+}