@jinn-network/client 0.1.2 → 0.1.3-canary.216cf7e6

package/dist/corpus/prediction-brier-scoreboard.js

@@ -0,0 +1,269 @@
+export const DEFAULT_PREDICTION_BRIER_SCOREBOARD_WINDOW_DAYS = 84;
+export function aggregatePredictionBrierScoreboard(projections, options = {}) {
+    const trailingWindowDays = options.trailingWindowDays
+        ?? DEFAULT_PREDICTION_BRIER_SCOREBOARD_WINDOW_DAYS;
+    const excluded = {
+        totalInputRows: projections.length,
+        includedRows: 0,
+        nonPredictionVerdictRows: 0,
+        nonScoredVerdictRows: 0,
+        missingScoreRows: 0,
+        nonNumericScoreRows: 0,
+        outsideWindowRows: 0,
+    };
+    const candidates = [];
+    const solutionProjectionByRef = indexSolutionProjections(projections);
+    for (const projection of projections) {
+        const parsed = parseScoreableProjection(projection, solutionProjectionByRef, excluded);
+        if (parsed)
+            candidates.push(parsed);
+    }
+    const asOfGeneratedAt = options.asOfGeneratedAt ?? maxGeneratedAt(candidates.map((row) => row.projection));
+    const windowStartGeneratedAt = asOfGeneratedAt === null
+        ? null
+        : asOfGeneratedAt - generatedAtSpanForDays(asOfGeneratedAt, trailingWindowDays);
+    const included = windowStartGeneratedAt === null || asOfGeneratedAt === null
+        ? []
+        : candidates.filter((row) => {
+            const insideWindow = row.projection.generatedAt >= windowStartGeneratedAt
+                && row.projection.generatedAt <= asOfGeneratedAt;
+            if (!insideWindow)
+                excluded.outsideWindowRows += 1;
+            return insideWindow;
+        });
+    excluded.includedRows = included.length;
+    return {
+        asOfGeneratedAt,
+        windowStartGeneratedAt,
+        trailingWindowDays,
+        overall: summarizeOverall(included),
+        weeklyTrend: summarizeWeeklyTrend(included),
+        perOperator: summarizeByOperator(included),
+        perHarness: summarizeByHarness(included),
+        perPlugin: summarizeByPlugin(included),
+        excluded,
+    };
+}
+function parseScoreableProjection(projection, solutionProjectionByRef, excluded) {
+    if (projection.solverType !== 'prediction.v1' || projection.role !== 'verdict') {
+        excluded.nonPredictionVerdictRows += 1;
+        return null;
+    }
+    if (projection.metadata['verdict'] !== 'SCORED') {
+        excluded.nonScoredVerdictRows += 1;
+        return null;
+    }
+    const solverBrier = parseRequiredFiniteNumber(projection.metadata['scores.solverBrier']);
+    const consensusBrier = parseRequiredFiniteNumber(projection.metadata['scores.consensusBrier']);
+    const brierSpread = parseRequiredFiniteNumber(projection.metadata['scores.brierSpread']);
+    if (solverBrier.kind === 'missing' || consensusBrier.kind === 'missing' || brierSpread.kind === 'missing') {
+        excluded.missingScoreRows += 1;
+        return null;
+    }
+    if (solverBrier.kind === 'non-numeric' || consensusBrier.kind === 'non-numeric' || brierSpread.kind === 'non-numeric') {
+        excluded.nonNumericScoreRows += 1;
+        return null;
+    }
+    const attributionProjection = solutionAttributionProjection(projection, solutionProjectionByRef);
+    return {
+        projection,
+        attributionProjection,
+        solverBrier: solverBrier.value,
+        consensusBrier: consensusBrier.value,
+        brierSpread: brierSpread.value,
+        taskKey: taskKey(projection),
+        operatorKey: operatorKey(attributionProjection),
+        harnessKey: harnessKey(attributionProjection),
+    };
+}
+function summarizeOverall(rows) {
+    return {
+        ...summarizeMetrics(rows),
+        activeOperatorCount: new Set(rows.map((row) => row.operatorKey)).size,
+    };
+}
+function summarizeMetrics(rows) {
+    return {
+        scoredVerdictCount: rows.length,
+        distinctTaskCount: new Set(rows.map((row) => row.taskKey)).size,
+        meanBrierSpread: mean(rows.map((row) => row.brierSpread)),
+        meanSolverBrier: mean(rows.map((row) => row.solverBrier)),
+        meanConsensusBrier: mean(rows.map((row) => row.consensusBrier)),
+    };
+}
+function summarizeWeeklyTrend(rows) {
+    const byWeek = new Map();
+    for (const row of rows) {
+        const bucket = weekBucket(row.projection.generatedAt);
+        const existing = byWeek.get(bucket.key) ?? [];
+        existing.push(row);
+        byWeek.set(bucket.key, existing);
+    }
+    return [...byWeek.entries()]
+        .map(([key, bucketRows]) => {
+        const generatedAt = Number(key);
+        return {
+            weekStartGeneratedAt: generatedAt,
+            weekStartIso: generatedAtIso(generatedAt),
+            ...summarizeOverall(bucketRows),
+        };
+    })
+        .sort((a, b) => a.weekStartGeneratedAt - b.weekStartGeneratedAt);
+}
+function summarizeByOperator(rows) {
+    return summarizeGroups(rows, (row) => row.operatorKey, (key, groupRows) => ({
+        key,
+        participantSafeAddress: firstPresent(groupRows.map((row) => row.attributionProjection.participantSafeAddress)),
+        participantAgentEoa: firstPresent(groupRows.map((row) => row.attributionProjection.participantAgentEoa)),
+    }));
+}
+function summarizeByHarness(rows) {
+    return summarizeGroups(rows, (row) => row.harnessKey, (key, groupRows) => ({
+        key,
+        implName: firstPresent(groupRows.map((row) => row.attributionProjection.executorImplName)),
+        implVersion: firstPresent(groupRows.map((row) => row.attributionProjection.executorImplVersion)),
+        runtimeBundleDigest: firstPresent(groupRows.map((row) => row.attributionProjection.executorRuntimeBundleDigest)),
+    }));
+}
+function summarizeByPlugin(rows) {
+    const expanded = [];
+    for (const row of rows) {
+        for (const plugin of new Set(row.attributionProjection.executorPlugins)) {
+            expanded.push({ row, plugin });
+        }
+    }
+    return summarizeGroups(expanded, (entry) => entry.plugin, (key) => ({ key, plugin: key }), (entry) => entry.row);
+}
+function summarizeGroups(entries, keyOf, metadataOf, rowOf = (entry) => entry) {
+    const groups = new Map();
+    for (const entry of entries) {
+        const key = keyOf(entry);
+        const existing = groups.get(key) ?? [];
+        existing.push(rowOf(entry));
+        groups.set(key, existing);
+    }
+    return [...groups.entries()]
+        .map(([key, groupRows]) => ({
+        key,
+        ...metadataOf(key, groupRows),
+        ...summarizeMetrics(groupRows),
+    }))
+        .sort(groupSummarySort);
+}
+function groupSummarySort(a, b) {
+    if (b.scoredVerdictCount !== a.scoredVerdictCount)
+        return b.scoredVerdictCount - a.scoredVerdictCount;
+    const aSpread = a.meanBrierSpread ?? Number.POSITIVE_INFINITY;
+    const bSpread = b.meanBrierSpread ?? Number.POSITIVE_INFINITY;
+    if (aSpread !== bSpread)
+        return aSpread - bSpread;
+    return a.key.localeCompare(b.key);
+}
+function parseRequiredFiniteNumber(value) {
+    if (value === undefined || value === null || value === '')
+        return { kind: 'missing' };
+    const parsed = typeof value === 'number' ? value : Number(value);
+    if (!Number.isFinite(parsed))
+        return { kind: 'non-numeric' };
+    return { kind: 'ok', value: parsed };
+}
+function indexSolutionProjections(projections) {
+    const byRef = new Map();
+    for (const projection of projections) {
+        if (projection.solverType !== 'prediction.v1' || projection.role !== 'restoration')
+            continue;
+        for (const ref of solutionProjectionRefs(projection)) {
+            if (!byRef.has(ref))
+                byRef.set(ref, projection);
+        }
+    }
+    return byRef;
+}
+function solutionAttributionProjection(verdictProjection, solutionProjectionByRef) {
+    for (const ref of verdictSolutionRefs(verdictProjection)) {
+        const solutionProjection = solutionProjectionByRef.get(ref);
+        if (solutionProjection)
+            return solutionProjection;
+    }
+    return verdictProjection;
+}
+function solutionProjectionRefs(projection) {
+    return compactRefs([
+        projection.envelopeCid,
+        projection.envelopeSha256,
+        projection.envelopeId,
+        projection.signatureHash,
+    ]);
+}
+function verdictSolutionRefs(projection) {
+    return compactRefs([
+        projection.solutionEnvelopeCid,
+        projection.solutionEnvelopeSha256,
+        projection.solutionEnvelopeRef,
+        projection.metadata['solutionEnvelope.cid'],
+        projection.metadata['solutionEnvelope.sha256'],
+    ]);
+}
+function compactRefs(values) {
+    return values.filter((value) => typeof value === 'string' && value.length > 0);
+}
+function mean(values) {
+    if (values.length === 0)
+        return null;
+    return values.reduce((sum, value) => sum + value, 0) / values.length;
+}
+function taskKey(projection) {
+    if (projection.taskCid)
+        return `taskCid:${projection.taskCid}`;
+    if (projection.taskId)
+        return `taskId:${projection.taskId}`;
+    return `unknown-task:${projection.envelopeId}`;
+}
+function operatorKey(projection) {
+    if (projection.participantSafeAddress)
+        return `safe:${projection.participantSafeAddress.toLowerCase()}`;
+    if (projection.participantAgentEoa)
+        return `agent:${projection.participantAgentEoa.toLowerCase()}`;
+    return 'unknown-operator';
+}
+function harnessKey(projection) {
+    return [
+        projection.executorImplName ?? 'unknown-harness',
+        projection.executorImplVersion ?? 'unknown-version',
+        projection.executorRuntimeBundleDigest ?? 'unknown-runtime',
+    ].join('@');
+}
+function firstPresent(values) {
+    return values.find((value) => typeof value === 'string' && value.length > 0) ?? null;
+}
+function maxGeneratedAt(projections) {
+    if (projections.length === 0)
+        return null;
+    return Math.max(...projections.map((projection) => projection.generatedAt));
+}
+function generatedAtSpanForDays(asOfGeneratedAt, days) {
+    const unit = timestampUnit(asOfGeneratedAt);
+    const daySpan = unit === 'milliseconds' ? 86_400_000 : 86_400;
+    return days * daySpan;
+}
+function weekBucket(generatedAt) {
+    const unit = timestampUnit(generatedAt);
+    const date = generatedAtDate(generatedAt);
+    const daysSinceMonday = (date.getUTCDay() + 6) % 7;
+    date.setUTCDate(date.getUTCDate() - daysSinceMonday);
+    date.setUTCHours(0, 0, 0, 0);
+    const weekStart = unit === 'milliseconds' ? date.getTime() : Math.floor(date.getTime() / 1000);
+    return { key: String(weekStart) };
+}
+function generatedAtIso(generatedAt) {
+    return generatedAtDate(generatedAt).toISOString();
+}
+function generatedAtDate(generatedAt) {
+    return timestampUnit(generatedAt) === 'milliseconds'
+        ? new Date(generatedAt)
+        : new Date(generatedAt * 1000);
+}
+function timestampUnit(generatedAt) {
+    return Math.abs(generatedAt) >= 10_000_000_000 ? 'milliseconds' : 'seconds';
+}
+//# sourceMappingURL=prediction-brier-scoreboard.js.map

package/dist/corpus/prediction-brier-scoreboard.js.map

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

package/dist/corpus/prediction-scoreable-verdicts.d.ts

@@ -0,0 +1,4 @@
+import type { Store } from '../store/store.js';
+import type { EnvelopeProjection, EnvelopeProjectionQuery } from './types.js';
+export type ScoreablePredictionBrierVerdictQuery = Omit<EnvelopeProjectionQuery, 'solverType' | 'role' | 'metadata'>;
+export declare function queryScoreablePredictionBrierVerdicts(store: Pick<Store, 'queryEnvelopeProjections'>, query?: ScoreablePredictionBrierVerdictQuery): EnvelopeProjection[];

package/dist/corpus/prediction-scoreable-verdicts.js

@@ -0,0 +1,23 @@
+export function queryScoreablePredictionBrierVerdicts(store, query = {}) {
+    const { limit, ...projectionQuery } = query;
+    const scoreable = store.queryEnvelopeProjections({
+        ...projectionQuery,
+        limit: 1000,
+        solverType: 'prediction.v1',
+        role: 'verdict',
+        metadata: { verdict: 'SCORED' },
+    }).filter(hasBrierScoreMetadata);
+    if (limit === undefined)
+        return scoreable;
+    return scoreable.slice(0, Math.max(0, limit));
+}
+function hasBrierScoreMetadata(projection) {
+    return hasStringMetadata(projection, 'scores.solverBrier')
+        && hasStringMetadata(projection, 'scores.consensusBrier')
+        && hasStringMetadata(projection, 'scores.brierSpread');
+}
+function hasStringMetadata(projection, key) {
+    const value = projection.metadata[key];
+    return typeof value === 'string' && value.length > 0;
+}
+//# sourceMappingURL=prediction-scoreable-verdicts.js.map

package/dist/corpus/prediction-scoreable-verdicts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prediction-scoreable-verdicts.js","sourceRoot":"","sources":["../../src/corpus/prediction-scoreable-verdicts.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,qCAAqC,CACnD,KAA8C,EAC9C,QAA8C,EAAE;IAEhD,MAAM,EAAE,KAAK,EAAE,GAAG,eAAe,EAAE,GAAG,KAAK,CAAC;IAC5C,MAAM,SAAS,GAAG,KAAK,CAAC,wBAAwB,CAAC;QAC/C,GAAG,eAAe;QAClB,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,eAAe;QAC3B,IAAI,EAAE,SAAS;QACf,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE;KAChC,CAAC,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAEjC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,qBAAqB,CAAC,UAA8B;IAC3D,OAAO,iBAAiB,CAAC,UAAU,EAAE,oBAAoB,CAAC;WACrD,iBAAiB,CAAC,UAAU,EAAE,uBAAuB,CAAC;WACtD,iBAAiB,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,iBAAiB,CAAC,UAA8B,EAAE,GAAW;IACpE,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC"}

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 `solverType` post-fetch since the
+ * subgraph's Execution.kind is the router-level ENVELOPE/EVALUATION discriminator,
+ * not the per-SolverType 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,113 @@
+/**
+ * Subgraph GraphQL query for the corpus.
+ *
+ * v0: query Execution rows; filter by evidenceTier, participant, time window
+ * directly on the subgraph; filter by `solverType` post-fetch since the
+ * subgraph's Execution.kind is the router-level ENVELOPE/EVALUATION discriminator,
+ * not the per-SolverType string.
+ *
+ * Spec §2.3 step 1, §10 Q6.
+ */
+import { CorpusQueryError } from './types.js';
+const HARD_LIMIT = 500;
+const DEFAULT_LIMIT = 50;
+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 };
+    const variableDefs = ['$first: Int!'];
+    const where = [];
+    if (q.evidenceTier) {
+        variableDefs.push('$tier: ExecutionTier');
+        variables.tier = TIER_TO_GQL[q.evidenceTier];
+        where.push('tier: $tier');
+    }
+    if (q.generatedAfter !== undefined) {
+        variableDefs.push('$publishedAfter: BigInt');
+        variables.publishedAfter = String(q.generatedAfter);
+        where.push('publishedAt_gte: $publishedAfter');
+    }
+    if (q.generatedBefore !== undefined) {
+        variableDefs.push('$publishedBefore: BigInt');
+        variables.publishedBefore = String(q.generatedBefore);
+        where.push('publishedAt_lte: $publishedBefore');
+    }
+    if (q.participant?.safeAddress) {
+        variableDefs.push('$operatorWallet: Bytes');
+        variables.operatorWallet = q.participant.safeAddress;
+        where.push('operator_: { agentWallet: $operatorWallet }');
+    }
+    const whereClause = where.length > 0 ? `where: { ${where.join(', ')} },` : '';
+    const query = `
+    query CorpusExecutions(${variableDefs.join(', ')}) {
+      executions(
+        first: $first,
+        ${whereClause}
+        orderBy: publishedAt,
+        orderDirection: desc
+      ) {
+        id
+        manifestCid
+        manifestHash
+        tier
+        publishedAt
+        operator {
+          id
+          agentId
+          owner
+          agentWallet
+        }
+      }
+    }
+  `;
+    return { query, 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,153 @@
+/**
+ * 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 { ArtifactSource, EvidenceTier, Role, SignedEnvelope } from '../types/envelope.js';
+export interface CorpusOptions {
+    subgraphUrl?: string;
+    ipfsGatewayUrl: string;
+    store: Store;
+    signer: {
+        privateKey: string;
+    };
+    selfSafeAddress: string;
+    routeResolver?: RouteResolver;
+    onchain?: import('./onchain-query.js').OnchainCorpusQueryOptions;
+}
+export interface CorpusQuery {
+    solverType?: string;
+    artifactType?: string;
+    taskCid?: string;
+    participant?: {
+        safeAddress?: string;
+    };
+    evidenceTier?: 'self-signed' | 'committed' | 'attested';
+    generatedAfter?: number;
+    generatedBefore?: number;
+    limit?: number;
+}
+export type EnvelopeProjectionMetadataValue = string | number | boolean;
+export type EnvelopeProjectionMetadata = Record<string, EnvelopeProjectionMetadataValue>;
+export interface EnvelopeProjection {
+    envelopeId: string;
+    envelopeCid: string | null;
+    envelopeSha256: string | null;
+    signatureHash: string;
+    solverType: string;
+    role: Role;
+    taskCid: string | null;
+    taskId: string | null;
+    requestId: string | null;
+    generatedAt: number;
+    evidenceTier: EvidenceTier;
+    participantSafeAddress: string | null;
+    participantAgentEoa: string | null;
+    executorImplName: string | null;
+    executorImplVersion: string | null;
+    executorRuntimeBundleDigest: string | null;
+    executorPlugins: string[];
+    solutionEnvelopeCid: string | null;
+    solutionEnvelopeSha256: string | null;
+    solutionEnvelopeRef: string | null;
+    metadata: EnvelopeProjectionMetadata;
+}
+export interface EnvelopeProjectionQuery {
+    envelopeRefs?: readonly string[];
+    solverType?: string;
+    role?: Role;
+    taskCid?: string;
+    taskId?: string;
+    requestId?: string;
+    participant?: {
+        safeAddress?: string;
+        agentEoa?: string;
+    };
+    solutionEnvelopeRef?: string;
+    metadata?: EnvelopeProjectionMetadata;
+    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' | 'ipfs';
+    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;
+        sources?: ArtifactSource[];
+        ownerSafe?: 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);
+}