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

package/dist/erc8004/abis.js

@@ -0,0 +1,238 @@
+/**
+ * Shared ABI table for the three ERC-8004 registries Jinn touches.
+ *
+ * Minimal slices of the deployed contract ABIs — only the surfaces the
+ * consolidated clients actually call. Cross-checked against:
+ *   - `/tmp/erc8004-ref/IdentityRegistryUpgradeable.sol`
+ *   - `/tmp/erc8004-ref/ReputationRegistryUpgradeable.sol`
+ *   - `/tmp/erc8004-ref/ValidationRegistryUpgradeable.sol`
+ *   - `subgraph/abis/{Identity,Reputation,Validation}Registry.json`
+ *
+ * Keep the slices tight: typed-ABI inference from viem/abitype is what makes
+ * the client surface stay sharp, and full ABIs widen the inferred types
+ * unnecessarily.
+ */
+// ── IdentityRegistry ──────────────────────────────────────────────────────────
+/** Canonical v1 ABI tuple for per-execution payloads. See payload-schema §3.1. */
+export const PAYLOAD_TUPLE = [
+    { name: 'version', type: 'uint8' },
+    { name: 'tier', type: 'uint8' },
+    { name: 'manifestHash', type: 'bytes32' },
+    { name: 'attestationQuoteCid', type: 'bytes' },
+    { name: 'sourceMeasurement', type: 'bytes32' },
+];
+/** ERC-8004 IdentityRegistry — only the function the publisher calls. */
+export const IDENTITY_REGISTRY_SET_METADATA_ABI = [
+    {
+        type: 'function',
+        name: 'setMetadata',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'metadataKey', type: 'string' },
+            { name: 'metadataValue', type: 'bytes' },
+        ],
+        outputs: [],
+    },
+];
+// ── ReputationRegistry ────────────────────────────────────────────────────────
+//
+// `giveFeedback` takes `value: int128, valueDecimals: uint8` (signed
+// fixed-point), not `score: uint8`. The higher-level surface exposes a
+// numeric-friendly `score` parameter.
+export const REPUTATION_REGISTRY_ABI = [
+    {
+        type: 'function',
+        name: 'giveFeedback',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'value', type: 'int128' },
+            { name: 'valueDecimals', type: 'uint8' },
+            { name: 'tag1', type: 'string' },
+            { name: 'tag2', type: 'string' },
+            { name: 'endpoint', type: 'string' },
+            { name: 'feedbackURI', type: 'string' },
+            { name: 'feedbackHash', type: 'bytes32' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'revokeFeedback',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'feedbackIndex', type: 'uint64' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'appendResponse',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'clientAddress', type: 'address' },
+            { name: 'feedbackIndex', type: 'uint64' },
+            { name: 'responseURI', type: 'string' },
+            { name: 'responseHash', type: 'bytes32' },
+        ],
+        outputs: [],
+    },
+    {
+        type: 'function',
+        name: 'readFeedback',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'clientAddress', type: 'address' },
+            { name: 'feedbackIndex', type: 'uint64' },
+        ],
+        outputs: [
+            { name: 'value', type: 'int128' },
+            { name: 'valueDecimals', type: 'uint8' },
+            { name: 'tag1', type: 'string' },
+            { name: 'tag2', type: 'string' },
+            { name: 'isRevoked', type: 'bool' },
+        ],
+    },
+    {
+        type: 'function',
+        name: 'readAllFeedback',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'clientAddresses', type: 'address[]' },
+            { name: 'tag1', type: 'string' },
+            { name: 'tag2', type: 'string' },
+            { name: 'includeRevoked', type: 'bool' },
+        ],
+        outputs: [
+            { name: 'clients', type: 'address[]' },
+            { name: 'feedbackIndexes', type: 'uint64[]' },
+            { name: 'values', type: 'int128[]' },
+            { name: 'valueDecimals', type: 'uint8[]' },
+            { name: 'tag1s', type: 'string[]' },
+            { name: 'tag2s', type: 'string[]' },
+            { name: 'revokedStatuses', type: 'bool[]' },
+        ],
+    },
+    {
+        type: 'function',
+        name: 'getSummary',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'clientAddresses', type: 'address[]' },
+            { name: 'tag1', type: 'string' },
+            { name: 'tag2', type: 'string' },
+        ],
+        outputs: [
+            { name: 'count', type: 'uint64' },
+            { name: 'summaryValue', type: 'int128' },
+            { name: 'summaryValueDecimals', type: 'uint8' },
+        ],
+    },
+    {
+        type: 'function',
+        name: 'getClients',
+        stateMutability: 'view',
+        inputs: [{ name: 'agentId', type: 'uint256' }],
+        outputs: [{ name: '', type: 'address[]' }],
+    },
+    {
+        type: 'function',
+        name: 'getLastIndex',
+        stateMutability: 'view',
+        inputs: [
+            { name: 'agentId', type: 'uint256' },
+            { name: 'clientAddress', type: 'address' },
+        ],
+        outputs: [{ name: '', type: 'uint64' }],
+    },
+];
+// ── ValidationRegistry ────────────────────────────────────────────────────────
+export const VALIDATION_REGISTRY_ABI = [
+    // ── Write functions ──────────────────────────────────────────────────────────
+    {
+        name: 'validationRequest',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'validatorAddress', type: 'address' },
+            { name: 'agentId', type: 'uint256' },
+            { name: 'requestURI', type: 'string' },
+            { name: 'requestHash', type: 'bytes32' },
+        ],
+        outputs: [],
+    },
+    {
+        name: 'validationResponse',
+        type: 'function',
+        stateMutability: 'nonpayable',
+        inputs: [
+            { name: 'requestHash', type: 'bytes32' },
+            { name: 'response', type: 'uint8' },
+            { name: 'responseURI', type: 'string' },
+            { name: 'responseHash', type: 'bytes32' },
+            { name: 'tag', type: 'string' },
+        ],
+        outputs: [],
+    },
+    // ── Read functions ──────────────────────────────────────────────────────────
+    {
+        name: 'getValidationStatus',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'requestHash', type: 'bytes32' }],
+        outputs: [
+            { name: 'validatorAddress', type: 'address' },
+            { name: 'agentId', type: 'uint256' },
+            { name: 'response', type: 'uint8' },
+            { name: 'responseHash', type: 'bytes32' },
+            { name: 'tag', type: 'string' },
+            { name: 'lastUpdate', type: 'uint256' },
+        ],
+    },
+    {
+        name: 'getAgentValidations',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'agentId', type: 'uint256' }],
+        outputs: [{ name: '', type: 'bytes32[]' }],
+    },
+    {
+        name: 'getValidatorRequests',
+        type: 'function',
+        stateMutability: 'view',
+        inputs: [{ name: 'validatorAddress', type: 'address' }],
+        outputs: [{ name: '', type: 'bytes32[]' }],
+    },
+    // ── Events (kept for parity with the deployed ABI; consumers may decode
+    //   logs directly with this fragment). ───────────────────────────────────────
+    {
+        type: 'event',
+        name: 'ValidationRequest',
+        inputs: [
+            { name: 'validatorAddress', type: 'address', indexed: true },
+            { name: 'agentId', type: 'uint256', indexed: true },
+            { name: 'requestURI', type: 'string', indexed: false },
+            { name: 'requestHash', type: 'bytes32', indexed: true },
+        ],
+    },
+    {
+        type: 'event',
+        name: 'ValidationResponse',
+        inputs: [
+            { name: 'validatorAddress', type: 'address', indexed: true },
+            { name: 'agentId', type: 'uint256', indexed: true },
+            { name: 'requestHash', type: 'bytes32', indexed: true },
+            { name: 'response', type: 'uint8', indexed: false },
+            { name: 'responseURI', type: 'string', indexed: false },
+            { name: 'responseHash', type: 'bytes32', indexed: false },
+            { name: 'tag', type: 'string', indexed: false },
+        ],
+    },
+];
+//# sourceMappingURL=abis.js.map

package/dist/erc8004/abis.js.map

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

package/dist/erc8004/addresses.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Canonical ERC-8004 registry addresses, keyed by chainId.
+ *
+ * Single source of truth for the three deployed registries Jinn touches:
+ *
+ *   - IdentityRegistry  — minted operator agent NFTs + per-execution `setMetadata`.
+ *   - ReputationRegistry — evaluator → restorer feedback (DR §4.3).
+ *   - ValidationRegistry — Phase 1b challenge mechanism (DR §4.4).
+ *
+ * Cross-checked against `subgraph/networks.json` and the canonical
+ * `erc-8004/erc-8004-contracts` reference. Mainnets and their respective
+ * testnets share vanity prefixes (0x8004…); the chains 1/8453 vs 11155111/84532
+ * pair accordingly.
+ *
+ * IdentityRegistry addresses live alongside the staking contract config in
+ * `client/src/earning/contracts.ts` (since the bootstrap reads them at mint
+ * time); we duplicate the lookup here for the consolidated ERC-8004 surface.
+ *
+ * If you add a chain, update all three maps + `subgraph/networks.json`.
+ */
+import type { Address } from 'viem';
+/**
+ * Canonical 0x8004… ReputationRegistry deployments.
+ */
+export declare const REPUTATION_REGISTRY_ADDRESSES: Record<number, Address>;
+/**
+ * Resolve the ReputationRegistry address for a chainId, or `null` if the
+ * chain is not known.
+ */
+export declare function getReputationRegistryAddress(chainId: number): Address | null;
+/**
+ * Canonical 0x8004… ValidationRegistry deployments. Source of truth:
+ * `subgraph/networks.json` (populated by `jinn-mono-fud`).
+ */
+export declare const VALIDATION_REGISTRY_ADDRESSES: Record<number, Address>;
+/**
+ * Resolve the ValidationRegistry address for a chainId, or `null` if the
+ * chain is not known.
+ */
+export declare function getValidationRegistryAddress(chainId: number): Address | null;

package/dist/erc8004/addresses.js

@@ -0,0 +1,64 @@
+/**
+ * Canonical ERC-8004 registry addresses, keyed by chainId.
+ *
+ * Single source of truth for the three deployed registries Jinn touches:
+ *
+ *   - IdentityRegistry  — minted operator agent NFTs + per-execution `setMetadata`.
+ *   - ReputationRegistry — evaluator → restorer feedback (DR §4.3).
+ *   - ValidationRegistry — Phase 1b challenge mechanism (DR §4.4).
+ *
+ * Cross-checked against `subgraph/networks.json` and the canonical
+ * `erc-8004/erc-8004-contracts` reference. Mainnets and their respective
+ * testnets share vanity prefixes (0x8004…); the chains 1/8453 vs 11155111/84532
+ * pair accordingly.
+ *
+ * IdentityRegistry addresses live alongside the staking contract config in
+ * `client/src/earning/contracts.ts` (since the bootstrap reads them at mint
+ * time); we duplicate the lookup here for the consolidated ERC-8004 surface.
+ *
+ * If you add a chain, update all three maps + `subgraph/networks.json`.
+ */
+// ── ReputationRegistry ────────────────────────────────────────────────────────
+/**
+ * Canonical 0x8004… ReputationRegistry deployments.
+ */
+export const REPUTATION_REGISTRY_ADDRESSES = {
+    // Base mainnet
+    8453: '0x8004BAa17C55a88189AE136b182e5fdA19dE9b63',
+    // Base Sepolia
+    84532: '0x8004B663056A597Dffe9eCcC1965A193B7388713',
+    // Ethereum mainnet (shares Base mainnet vanity)
+    1: '0x8004BAa17C55a88189AE136b182e5fdA19dE9b63',
+    // Ethereum Sepolia (shares Base Sepolia vanity)
+    11155111: '0x8004B663056A597Dffe9eCcC1965A193B7388713',
+};
+/**
+ * Resolve the ReputationRegistry address for a chainId, or `null` if the
+ * chain is not known.
+ */
+export function getReputationRegistryAddress(chainId) {
+    return REPUTATION_REGISTRY_ADDRESSES[chainId] ?? null;
+}
+// ── ValidationRegistry ────────────────────────────────────────────────────────
+/**
+ * Canonical 0x8004… ValidationRegistry deployments. Source of truth:
+ * `subgraph/networks.json` (populated by `jinn-mono-fud`).
+ */
+export const VALIDATION_REGISTRY_ADDRESSES = {
+    // Base mainnet
+    8453: '0x8004Cc8439f36fd5F9F049D9fF86523Df6dAAB58',
+    // Base Sepolia
+    84532: '0x8004Cb1BF31DAf7788923b405b754f57acEB4272',
+    // Ethereum mainnet (shares Base mainnet vanity)
+    1: '0x8004Cc8439f36fd5F9F049D9fF86523Df6dAAB58',
+    // Sepolia (shares Base Sepolia vanity)
+    11155111: '0x8004Cb1BF31DAf7788923b405b754f57acEB4272',
+};
+/**
+ * Resolve the ValidationRegistry address for a chainId, or `null` if the
+ * chain is not known.
+ */
+export function getValidationRegistryAddress(chainId) {
+    return VALIDATION_REGISTRY_ADDRESSES[chainId] ?? null;
+}
+//# sourceMappingURL=addresses.js.map

package/dist/erc8004/addresses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"addresses.js","sourceRoot":"","sources":["../../src/erc8004/addresses.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH,iFAAiF;AAEjF;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA4B;IACpE,eAAe;IACf,IAAI,EAAE,4CAA4C;IAClD,eAAe;IACf,KAAK,EAAE,4CAA4C;IACnD,gDAAgD;IAChD,CAAC,EAAE,4CAA4C;IAC/C,gDAAgD;IAChD,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAe;IAC1D,OAAO,6BAA6B,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC;AAED,iFAAiF;AAEjF;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA4B;IACpE,eAAe;IACf,IAAI,EAAE,4CAA4C;IAClD,eAAe;IACf,KAAK,EAAE,4CAA4C;IACnD,gDAAgD;IAChD,CAAC,EAAE,4CAA4C;IAC/C,uCAAuC;IACvC,QAAQ,EAAE,4CAA4C;CACvD,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,4BAA4B,CAAC,OAAe;IAC1D,OAAO,6BAA6B,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;AACxD,CAAC"}

package/dist/erc8004/identity.d.ts

@@ -0,0 +1,202 @@
+/**
+ * ERC-8004 IdentityRegistry surface.
+ *
+ * Two complementary capabilities live here:
+ *
+ *   1. `IdentityPublisher` — per-execution `setMetadata` writes that anchor
+ *      envelope/evaluation commitments under the operator's agent NFT. Implements
+ *      the v1 ABI-encoded payload tuple specified in
+ *      `docs/superpowers/specs/2026-04-27-erc-8004-payload-schema.md` §3.1:
+ *
+ *        abi.encode(
+ *            uint8   version,             // = 1
+ *            uint8   tier,                // 0..4
+ *            bytes32 manifestHash,        // = JinnRouter evidenceHash
+ *            bytes   attestationQuoteCid, // raw multibase-decoded CID bytes; 0x for tier < 3
+ *            bytes32 sourceMeasurement    // 0x00...00 for tier < 3
+ *        )
+ *
+ *      The encoded payload is passed to
+ *          IdentityRegistry.setMetadata(agentId, "<kind>:<cid>", payload)
+ *
+ *      per the entity-model decision in §4.2 of
+ *      `docs/superpowers/specs/2026-04-27-erc-8004-entity-model-design.md` —
+ *      one operator agent NFT per Safe; per-execution commitments anchor under it.
+ *
+ *      This module ONLY publishes — it does not mint the agent NFT (`jinn-mono-j07`),
+ *      call `setAgentWallet` (`jinn-mono-aev`), or write reputation/validation
+ *      registries (`jinn-mono-2ff` / `jinn-mono-9jg`).
+ *
+ *   2. `resolveAgentIdForManifest` — evaluator-side lookup of the restorer's
+ *      `agentId` from a manifest's `evidenceHash`. Per DR §4.3, the evaluator
+ *      must call `ReputationRegistry.giveFeedback(restorerAgentId, ...)` keyed
+ *      on the restorer's ERC-8004 agent NFT id — but the on-chain `claimDelivery`
+ *      payload only carries the `requestId` and `evidenceHash`, not the
+ *      restorer's agentId.
+ *
+ *      Resolution paths:
+ *
+ *        (b) Subgraph: `Execution { operator { agentId } where manifestHash: $h }`
+ *            — the Jinn subgraph already indexes envelope publishes joined to the
+ *            operator. This is the recommended path: O(1) and aligned with the
+ *            rest of the discovery surface.
+ *        (c) On-chain `IdentityRegistry.Registered` event scan filtered by the
+ *            restorer's Safe address — cheaper than a global scan, but still O(n)
+ *            in registered-events. Documented as a fallback only.
+ *
+ *      This module implements (b). The fallback is intentionally **not** wired in
+ *      yet: the resolver returns `null` cleanly when the subgraph URL is undefined
+ *      or the query has no match, and the caller (the feedback hook) treats that
+ *      as a no-op (DR §4.3: "skip but don't fail — claimDelivery is authoritative").
+ */
+import { type Hex, type PublicClient, type WalletClient } from 'viem';
+import { IDENTITY_REGISTRY_SET_METADATA_ABI, PAYLOAD_TUPLE } from './abis.js';
+export { IDENTITY_REGISTRY_SET_METADATA_ABI, PAYLOAD_TUPLE };
+/**
+ * Evidence tier on the canonical ladder.
+ *
+ * V1 admits only `{0=self-signed, 1=committed, 3=attested}` — aligned with
+ * `EvidenceTierSchema` in `client/src/types/envelope.ts` (PR #37 commit
+ * 44cc949b stripped V2+ tiers `consensus`=2 and `proved`=4 from V1). The
+ * gap at 2 and the absent 4 are intentional: future schema-version bumps
+ * re-admit them. See payload-schema §5.
+ */
+export type ExecutionTier = 0 | 1 | 3;
+/** Metadata key prefix. See payload-schema §6.1. */
+export type ContentKind = 'envelope' | 'evaluation';
+/**
+ * v1 payload as caller-friendly hex strings. The encoder validates and
+ * ABI-encodes per §3.1. `version` is fixed at 1 — this is the only schema
+ * version this module emits.
+ */
+export interface ExecutionPayload {
+    version: 1;
+    tier: ExecutionTier;
+    /** 32-byte hex (= JinnRouter evidenceHash). */
+    manifestHash: Hex;
+    /** Raw multibase-decoded CID bytes hex. `"0x"` for tier < 3. */
+    attestationQuoteCid: Hex;
+    /** 32-byte hex enclave measurement. All-zero for tier < 3. */
+    sourceMeasurement: Hex;
+}
+export interface IdentityPublisherConfig {
+    identityRegistryAddress: `0x${string}`;
+    agentId: bigint;
+    walletClient: WalletClient;
+    publicClient: PublicClient;
+}
+export interface PublishContentArgs {
+    kind: ContentKind;
+    /** Textual CID embedded in the metadataKey (`<kind>:<cid>`). */
+    cid: string;
+    payload: ExecutionPayload;
+}
+/** Thrown when an `ExecutionPayload` violates §5 strict-mode validity rules. */
+export declare class PayloadValidationError extends Error {
+    readonly tier: ExecutionTier;
+    readonly reason: string;
+    constructor(tier: ExecutionTier, reason: string);
+}
+/**
+ * Validate `payload` against the strict-mode per-tier rules in payload-schema §5.
+ * Throws `PayloadValidationError` on mismatch; otherwise returns the payload.
+ *
+ * Rules:
+ *   - V1 admits only tiers {0=self-signed, 1=committed, 3=attested}. Tiers 2
+ *     (consensus) and 4 (proved) are V2+ and rejected here.
+ *   - tier ∈ {0,1}: attestationQuoteCid MUST be empty, sourceMeasurement MUST be zero.
+ *   - tier === 3:  attestationQuoteCid MUST be non-empty, sourceMeasurement MUST be non-zero.
+ *   - version MUST equal 1 (this module only emits v1).
+ */
+export declare function validatePayload(payload: ExecutionPayload): ExecutionPayload;
+/**
+ * ABI-encode the v1 payload per payload-schema §3.1.
+ *
+ * Validates first; throws `PayloadValidationError` on mismatch. Never silently
+ * produces malformed bytes.
+ */
+export declare function encodeExecutionPayload(payload: ExecutionPayload): Hex;
+/** Build the `<kind>:<cid>` metadata key per payload-schema §6.1. */
+export declare function buildMetadataKey(kind: ContentKind, cid: string): string;
+/**
+ * Per-execution `setMetadata` client.
+ *
+ * Stateless beyond config. Each `publishContent()` call validates the payload,
+ * ABI-encodes it, and submits a single `setMetadata(agentId, key, value)`
+ * transaction. Returns the on-chain tx hash. Failures are surfaced to the
+ * caller — the engine catches and logs them as non-fatal.
+ */
+export declare class IdentityPublisher {
+    private readonly identityRegistryAddress;
+    private readonly agentId;
+    private readonly walletClient;
+    private readonly publicClient;
+    constructor(config: IdentityPublisherConfig);
+    /** The agentId this publisher anchors metadata under. */
+    get agent(): bigint;
+    /** The IdentityRegistry contract this publisher writes to. */
+    get registry(): `0x${string}`;
+    /**
+     * Publish a per-execution commitment under the operator's agent NFT.
+     *
+     * Calls `IdentityRegistry.setMetadata(agentId, "<kind>:<cid>", encode(payload))`.
+     * Returns the on-chain tx hash. Throws on encode/validation/network failure.
+     */
+    publishContent(args: PublishContentArgs): Promise<Hex>;
+}
+/**
+ * Inputs for `resolveAgentIdForManifest`.
+ *
+ * `manifestHash` is the keccak256 of the restorer's signed manifest — i.e.
+ * the `evidenceHash` JinnRouter records on `claimDelivery`. The subgraph
+ * indexes this as `Execution.manifestHash` (see `subgraph/schema.graphql`
+ * § Execution).
+ *
+ * `subgraphUrl` is optional: when undefined, the resolver returns `null`
+ * without attempting the query. This lets the call site stay terse —
+ * `await resolveAgentIdForManifest({ manifestHash, subgraphUrl: cfg.subgraphUrl })`
+ * — without conditional plumbing.
+ */
+export interface ResolveAgentIdArgs {
+    manifestHash: `0x${string}`;
+    /** GraphQL endpoint URL. When undefined, returns null without querying. */
+    subgraphUrl?: string;
+    /**
+     * Optional override for `fetch`. Production passes nothing (uses global
+     * `fetch`); tests pass a stub that captures the GraphQL query/variables.
+     */
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Resolved record for a manifest hash. The agentId is the primary signal
+ * the feedback hook needs; the optional `manifestCid` is a convenience —
+ * the subgraph already knows it from indexing the operator's envelope
+ * publish, so returning it here saves the caller from re-deriving it.
+ */
+export interface ResolvedAgent {
+    agentId: bigint;
+    /**
+     * The manifest CID indexed alongside this manifestHash, when the
+     * subgraph has it. Useful for the feedback `manifestRef` body without
+     * a second round-trip.
+     */
+    manifestCid: string | null;
+}
+/**
+ * Resolve the operator `agentId` for a given manifest hash.
+ *
+ * Returns `null` when:
+ *   - `subgraphUrl` is undefined (no on-chain fallback wired yet — see
+ *     module-level comment).
+ *   - The subgraph has no `Execution` indexed for this `manifestHash` (the
+ *     restorer hasn't published an envelope yet, or the subgraph is behind
+ *     head).
+ *   - The query fails or returns malformed data. This is intentional: a
+ *     transient subgraph failure must NOT block the evaluator's
+ *     `claimDelivery` settlement, so the resolver fails closed (no
+ *     feedback) rather than throwing.
+ *
+ * Errors are logged via `console.warn` so a flaky subgraph surface is
+ * observable without rerouting through the engine's logger.
+ */
+export declare function resolveAgentIdForManifest(args: ResolveAgentIdArgs): Promise<ResolvedAgent | null>;