inamprotocol 0.17.1 → 0.19.0

package/README.md

@@ -100,6 +100,40 @@ const check = await verifyErc8004Feedback(fileText, { feedbackHash, clientAddres
 // { valid, reasons, receiptId, providerDid, providerAddress }
 ```
 
+## Receipts over HTTP
+
+If your agents already call each other over HTTP, one wrapper on each side turns every call into a countersigned receipt (SPEC.md §15):
+
+```ts
+import { InamClient, inamReceipts, inamFetch } from "inamprotocol";
+
+// Worker: wrap the fetch-style handler that answers calls.
+export default { fetch: inamReceipts(handleReview, { client: workerClient, capability: "code-review" }) };
+
+// Requester: call through inamFetch.
+const inam = inamFetch(requesterClient);
+const res = await inam.fetch("https://reviewer.example/review", { method: "POST", body: diff });
+await inam.settle(); // countersigns run in the background; wait before a serverless function exits
+```
+
+The requester only countersigns when the receipt's hashes match the exact request it sent and response it received. That confirms delivery, not quality; pass `accept: (res, receipt) => ...` to `inamFetch` to run your own check first.
+
+## Vercel AI SDK tools
+
+```ts
+import { generateText, isStepCount } from "ai";
+import { inamTools } from "inamprotocol/ai-sdk";
+
+const { text } = await generateText({
+  model: "anthropic/claude-sonnet-5.5",
+  tools: inamTools(),
+  stopWhen: isStepCount(5),
+  prompt: "Find a code-review agent on INAM and tell me whether its record is strong enough to hire it.",
+});
+```
+
+`inamTools()` gives the model three read-only tools against the public registry: `checkReputation`, `searchAgents` and `getReceipt`. Install `ai` (v7+) alongside; it is an optional peer dependency, and the main `inamprotocol` entry point never imports it. Guide: https://inamprotocol.org/blog/vercel-ai-sdk-agent-reputation-tools
+
 ## What's exported
 
 `InamClient`, `generateKeypair`/`keypairFromPrivateKey`/`publicKeyToDid`/`didToPublicKey`/`sign`/`verify`/`verifyRawEd25519`/`sha256Hex`, `generateP256Keypair`/`p256Sign`/`p256Verify` (used for external-identity link-challenge proofs, SPEC.md §2.1), `canonicalize` (the canonical-JSON serializer every INAM signature is computed over), `computeReceiptId`/`buildSignableContent`, `computeVerificationId`/`buildSignableVerificationContent`, and the full set of wire-format types (`AgentRecord`, `ExecutionReceipt`, `JobRecord`, `JobOffer`, `ReputationResult`, `LinkChallenge`, `VerificationRecord`, ...).

package/dist/aiSdk.d.ts

@@ -0,0 +1,735 @@
+export declare function inamTools(options?: {
+    baseUrl?: string;
+}): {
+    checkReputation: ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            agentId: string;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            agentId: string;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                agentId: string;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                agentId: string;
+            };
+            output: NoInfer<import("./types.js").ReputationResult>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<import("./types.js").ReputationResult> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            agentId: string;
+        }, import("./types.js").ReputationResult, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        description?: string | ((options: {
+            context: NoInfer<import("@ai-sdk/provider-utils").Context>;
+            experimental_sandbox?: import("ai").Experimental_SandboxSession;
+        }) => string) | undefined;
+        strict?: boolean;
+        inputExamples?: {
+            input: NoInfer<{
+                agentId: string;
+            }>;
+        }[] | undefined;
+        id?: never;
+        isProviderExecuted?: never;
+        args?: never;
+        supportsDeferredResults?: never;
+    } & {
+        type?: undefined | "function";
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            agentId: string;
+        }, import("./types.js").ReputationResult, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    }) | ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            agentId: string;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            agentId: string;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                agentId: string;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                agentId: string;
+            };
+            output: NoInfer<import("./types.js").ReputationResult>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<import("./types.js").ReputationResult> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            agentId: string;
+        }, import("./types.js").ReputationResult, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        description?: string | ((options: {
+            context: NoInfer<import("@ai-sdk/provider-utils").Context>;
+            experimental_sandbox?: import("ai").Experimental_SandboxSession;
+        }) => string) | undefined;
+        strict?: boolean;
+        inputExamples?: {
+            input: NoInfer<{
+                agentId: string;
+            }>;
+        }[] | undefined;
+        id?: never;
+        isProviderExecuted?: never;
+        args?: never;
+        supportsDeferredResults?: never;
+    } & {
+        type: "dynamic";
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            agentId: string;
+        }, import("./types.js").ReputationResult, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    }) | ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            agentId: string;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            agentId: string;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                agentId: string;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                agentId: string;
+            };
+            output: NoInfer<import("./types.js").ReputationResult>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<import("./types.js").ReputationResult> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            agentId: string;
+        }, import("./types.js").ReputationResult, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        type: "provider";
+        id: `${string}.${string}`;
+        args: Record<string, unknown>;
+        description?: never;
+        strict?: never;
+        inputExamples?: never;
+    } & {
+        isProviderExecuted: false;
+        supportsDeferredResults?: never;
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            agentId: string;
+        }, import("./types.js").ReputationResult, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    }) | ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            agentId: string;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            agentId: string;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                agentId: string;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                agentId: string;
+            };
+            output: NoInfer<import("./types.js").ReputationResult>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<import("./types.js").ReputationResult> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            agentId: string;
+        }, import("./types.js").ReputationResult, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        type: "provider";
+        id: `${string}.${string}`;
+        args: Record<string, unknown>;
+        description?: never;
+        strict?: never;
+        inputExamples?: never;
+    } & {
+        isProviderExecuted: true;
+        supportsDeferredResults?: boolean;
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            agentId: string;
+        }, import("./types.js").ReputationResult, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    });
+    searchAgents: ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                capability?: string | undefined;
+                minReputation?: number | undefined;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                capability?: string | undefined;
+                minReputation?: number | undefined;
+            };
+            output: NoInfer<{
+                agents: import("./types.js").AgentRecord[];
+                hasMore: boolean;
+            }>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<{
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, {
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        description?: string | ((options: {
+            context: NoInfer<import("@ai-sdk/provider-utils").Context>;
+            experimental_sandbox?: import("ai").Experimental_SandboxSession;
+        }) => string) | undefined;
+        strict?: boolean;
+        inputExamples?: {
+            input: NoInfer<{
+                capability?: string | undefined;
+                minReputation?: number | undefined;
+            }>;
+        }[] | undefined;
+        id?: never;
+        isProviderExecuted?: never;
+        args?: never;
+        supportsDeferredResults?: never;
+    } & {
+        type?: undefined | "function";
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, {
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    }) | ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                capability?: string | undefined;
+                minReputation?: number | undefined;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                capability?: string | undefined;
+                minReputation?: number | undefined;
+            };
+            output: NoInfer<{
+                agents: import("./types.js").AgentRecord[];
+                hasMore: boolean;
+            }>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<{
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, {
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        description?: string | ((options: {
+            context: NoInfer<import("@ai-sdk/provider-utils").Context>;
+            experimental_sandbox?: import("ai").Experimental_SandboxSession;
+        }) => string) | undefined;
+        strict?: boolean;
+        inputExamples?: {
+            input: NoInfer<{
+                capability?: string | undefined;
+                minReputation?: number | undefined;
+            }>;
+        }[] | undefined;
+        id?: never;
+        isProviderExecuted?: never;
+        args?: never;
+        supportsDeferredResults?: never;
+    } & {
+        type: "dynamic";
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, {
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    }) | ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                capability?: string | undefined;
+                minReputation?: number | undefined;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                capability?: string | undefined;
+                minReputation?: number | undefined;
+            };
+            output: NoInfer<{
+                agents: import("./types.js").AgentRecord[];
+                hasMore: boolean;
+            }>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<{
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, {
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        type: "provider";
+        id: `${string}.${string}`;
+        args: Record<string, unknown>;
+        description?: never;
+        strict?: never;
+        inputExamples?: never;
+    } & {
+        isProviderExecuted: false;
+        supportsDeferredResults?: never;
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, {
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    }) | ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                capability?: string | undefined;
+                minReputation?: number | undefined;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                capability?: string | undefined;
+                minReputation?: number | undefined;
+            };
+            output: NoInfer<{
+                agents: import("./types.js").AgentRecord[];
+                hasMore: boolean;
+            }>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<{
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, {
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        type: "provider";
+        id: `${string}.${string}`;
+        args: Record<string, unknown>;
+        description?: never;
+        strict?: never;
+        inputExamples?: never;
+    } & {
+        isProviderExecuted: true;
+        supportsDeferredResults?: boolean;
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            capability?: string | undefined;
+            minReputation?: number | undefined;
+        }, {
+            agents: import("./types.js").AgentRecord[];
+            hasMore: boolean;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    });
+    getReceipt: ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            receiptId: string;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            receiptId: string;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                receiptId: string;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                receiptId: string;
+            };
+            output: NoInfer<{
+                receipt: import("./types.js").ExecutionReceipt;
+                verifications: import("./types.js").VerificationRecord[] | never[];
+            }>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<{
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            receiptId: string;
+        }, {
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        description?: string | ((options: {
+            context: NoInfer<import("@ai-sdk/provider-utils").Context>;
+            experimental_sandbox?: import("ai").Experimental_SandboxSession;
+        }) => string) | undefined;
+        strict?: boolean;
+        inputExamples?: {
+            input: NoInfer<{
+                receiptId: string;
+            }>;
+        }[] | undefined;
+        id?: never;
+        isProviderExecuted?: never;
+        args?: never;
+        supportsDeferredResults?: never;
+    } & {
+        type?: undefined | "function";
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            receiptId: string;
+        }, {
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    }) | ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            receiptId: string;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            receiptId: string;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                receiptId: string;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                receiptId: string;
+            };
+            output: NoInfer<{
+                receipt: import("./types.js").ExecutionReceipt;
+                verifications: import("./types.js").VerificationRecord[] | never[];
+            }>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<{
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            receiptId: string;
+        }, {
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        description?: string | ((options: {
+            context: NoInfer<import("@ai-sdk/provider-utils").Context>;
+            experimental_sandbox?: import("ai").Experimental_SandboxSession;
+        }) => string) | undefined;
+        strict?: boolean;
+        inputExamples?: {
+            input: NoInfer<{
+                receiptId: string;
+            }>;
+        }[] | undefined;
+        id?: never;
+        isProviderExecuted?: never;
+        args?: never;
+        supportsDeferredResults?: never;
+    } & {
+        type: "dynamic";
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            receiptId: string;
+        }, {
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    }) | ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            receiptId: string;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            receiptId: string;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                receiptId: string;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                receiptId: string;
+            };
+            output: NoInfer<{
+                receipt: import("./types.js").ExecutionReceipt;
+                verifications: import("./types.js").VerificationRecord[] | never[];
+            }>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<{
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            receiptId: string;
+        }, {
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        type: "provider";
+        id: `${string}.${string}`;
+        args: Record<string, unknown>;
+        description?: never;
+        strict?: never;
+        inputExamples?: never;
+    } & {
+        isProviderExecuted: false;
+        supportsDeferredResults?: never;
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            receiptId: string;
+        }, {
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    }) | ({
+        deferLoading?: boolean;
+        title?: string;
+        providerOptions?: import("@ai-sdk/provider-utils").ProviderOptions;
+        metadata?: import("@ai-sdk/provider").JSONObject;
+        inputSchema: import("ai").FlexibleSchema<{
+            receiptId: string;
+        }>;
+        contextSchema?: import("ai").FlexibleSchema<import("@ai-sdk/provider-utils").Context> | undefined;
+        needsApproval?: boolean | import("@ai-sdk/provider-utils").ToolNeedsApprovalFunction<{
+            receiptId: string;
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>> | undefined;
+        onInputStart?: ((options: import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputDelta?: ((options: {
+            inputTextDelta: string;
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        onInputAvailable?: ((options: {
+            input: {
+                receiptId: string;
+            };
+        } & import("ai").ToolExecutionOptions<NoInfer<import("@ai-sdk/provider-utils").Context>>) => void | PromiseLike<void>) | undefined;
+        toModelOutput?: ((options: {
+            toolCallId: string;
+            input: {
+                receiptId: string;
+            };
+            output: NoInfer<{
+                receipt: import("./types.js").ExecutionReceipt;
+                verifications: import("./types.js").VerificationRecord[] | never[];
+            }>;
+        }) => import("@ai-sdk/provider-utils").ToolResultOutput | PromiseLike<import("@ai-sdk/provider-utils").ToolResultOutput>) | undefined;
+    } & {
+        outputSchema?: import("ai").FlexibleSchema<{
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }> | undefined;
+        execute: import("ai").ToolExecuteFunction<{
+            receiptId: string;
+        }, {
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    } & {
+        type: "provider";
+        id: `${string}.${string}`;
+        args: Record<string, unknown>;
+        description?: never;
+        strict?: never;
+        inputExamples?: never;
+    } & {
+        isProviderExecuted: true;
+        supportsDeferredResults?: boolean;
+    } & {
+        execute: import("ai").ToolExecuteFunction<{
+            receiptId: string;
+        }, {
+            receipt: import("./types.js").ExecutionReceipt;
+            verifications: import("./types.js").VerificationRecord[] | never[];
+        }, NoInfer<import("@ai-sdk/provider-utils").Context>>;
+    });
+};

package/dist/aiSdk.js

@@ -0,0 +1,58 @@
+/**
+ * INAM reputation checks as Vercel AI SDK tools: `inamprotocol/ai-sdk`.
+ *
+ *   npm i inamprotocol ai
+ *
+ *   import { generateText, isStepCount } from "ai";
+ *   import { inamTools } from "inamprotocol/ai-sdk";
+ *
+ *   const { text } = await generateText({
+ *     model: "anthropic/claude-sonnet-5.5",
+ *     tools: inamTools(),
+ *     stopWhen: isStepCount(5),
+ *     prompt: "Find a code-review agent on INAM and tell me whether its record is strong enough to hire it.",
+ *   });
+ *
+ * Read-only: the tools look agents and receipts up in the public registry and
+ * never write anything. Descriptions follow the hosted MCP server's
+ * (mcp/src/readTools.ts), so a model gets the same guidance either way: check
+ * `evidenceLevel`, not just `trustScore`. Kept out of the main entry point so
+ * `ai` stays an optional peer dependency.
+ */
+import { tool } from "ai";
+import { z } from "zod";
+import { InamClient } from "./client.js";
+import { generateKeypair } from "./crypto/keys.js";
+export function inamTools(options = {}) {
+    // Reads are public; the client just needs some keypair to sign with.
+    const inam = new InamClient(options.baseUrl ?? "https://api.inamprotocol.org", generateKeypair());
+    return {
+        checkReputation: tool({
+            description: "Look up an agent's INAM reputation (trust score, finalized-receipt count, success rate, dispute flags) before deciding whether to trust or transact with it. " +
+                "Do not decide on trustScore alone: check evidenceLevel first. 'countersigned' means only the two parties vouched for the work; " +
+                "'independently_verified' means an operator-authorized verifier checked it. Treat any 'attestation_rejected' flag as a strong negative.",
+            inputSchema: z.object({ agentId: z.string().describe("did:key:... id of the agent to check") }),
+            execute: ({ agentId }) => inam.getReputation(agentId),
+        }),
+        searchAgents: tool({
+            description: "Find INAM-registered agents by declared capability and/or minimum reputation, to discover a counterparty for a task and see how trusted it is.",
+            inputSchema: z.object({
+                capability: z.string().optional().describe("e.g. 'translation.tr-en', 'code-review'"),
+                minReputation: z.number().optional().describe("only return agents with at least this trust score"),
+            }),
+            execute: (query) => inam.searchAgents(query),
+        }),
+        getReceipt: tool({
+            description: "Fetch one execution receipt by id, with its verification records, to check a specific claim ('agent X says it did job Y') against the signed, countersigned record.",
+            inputSchema: z.object({ receiptId: z.string().describe("sha256:... receipt id") }),
+            execute: async ({ receiptId }) => {
+                const [receipt, { verifications }] = await Promise.all([
+                    inam.getReceipt(receiptId),
+                    inam.listReceiptVerifications(receiptId).catch(() => ({ verifications: [] })),
+                ]);
+                return { receipt, verifications };
+            },
+        }),
+    };
+}
+//# sourceMappingURL=aiSdk.js.map

package/dist/aiSdk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aiSdk.js","sourceRoot":"","sources":["../src/aiSdk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD,MAAM,UAAU,SAAS,CAAC,UAAgC,EAAE;IAC1D,qEAAqE;IACrE,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,OAAO,CAAC,OAAO,IAAI,8BAA8B,EAAE,eAAe,EAAE,CAAC,CAAC;IAElG,OAAO;QACL,eAAe,EAAE,IAAI,CAAC;YACpB,WAAW,EACT,+JAA+J;gBAC/J,iIAAiI;gBACjI,wIAAwI;YAC1I,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC,EAAE,CAAC;YAC/F,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;SACtD,CAAC;QACF,YAAY,EAAE,IAAI,CAAC;YACjB,WAAW,EACT,gJAAgJ;YAClJ,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;gBACpB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,yCAAyC,CAAC;gBACrF,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;aACnG,CAAC;YACF,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;SAC7C,CAAC;QACF,UAAU,EAAE,IAAI,CAAC;YACf,WAAW,EACT,qKAAqK;YACvK,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;YAClF,OAAO,EAAE,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;gBAC/B,MAAM,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;oBACrD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;oBAC1B,IAAI,CAAC,wBAAwB,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC,CAAC;iBAC9E,CAAC,CAAC;gBACH,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;YACpC,CAAC;SACF,CAAC;KACH,CAAC;AACJ,CAAC"}

package/dist/core/demo.d.ts

@@ -0,0 +1,10 @@
+/** Hosted demo counterparty (SPEC.md §14, v0.40). Receipts whose capability
+ * starts with this prefix are real, signed and logged, but never count toward
+ * reputation or anchoring (§5.2). */
+export declare const DEMO_CAPABILITY_PREFIX = "demo.";
+export declare const DEMO_CAPABILITY = "demo.sha256";
+/** The demo task's spec text, derived from its jobId so the task is stateless. */
+export declare const demoSpec: (jobId: string) => string;
+/** The correct output for a demo task, and the outputHash a receipt must carry. */
+export declare const demoOutput: (jobId: string) => string;
+export declare const demoOutputHash: (jobId: string) => string;

package/dist/core/demo.js

@@ -0,0 +1,12 @@
+import { sha256Hex } from "../crypto/keys.js";
+/** Hosted demo counterparty (SPEC.md §14, v0.40). Receipts whose capability
+ * starts with this prefix are real, signed and logged, but never count toward
+ * reputation or anchoring (§5.2). */
+export const DEMO_CAPABILITY_PREFIX = "demo.";
+export const DEMO_CAPABILITY = "demo.sha256";
+/** The demo task's spec text, derived from its jobId so the task is stateless. */
+export const demoSpec = (jobId) => `INAM demo task ${jobId}: return the sha256 hex of this line.`;
+/** The correct output for a demo task, and the outputHash a receipt must carry. */
+export const demoOutput = (jobId) => sha256Hex(demoSpec(jobId));
+export const demoOutputHash = (jobId) => `sha256:${sha256Hex(demoOutput(jobId))}`;
+//# sourceMappingURL=demo.js.map

package/dist/core/demo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.js","sourceRoot":"","sources":["../../src/core/demo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;qCAEqC;AACrC,MAAM,CAAC,MAAM,sBAAsB,GAAG,OAAO,CAAC;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AAE7C,kFAAkF;AAClF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,kBAAkB,KAAK,uCAAuC,CAAC;AAE1G,mFAAmF;AACnF,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACxE,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,UAAU,SAAS,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC"}

package/dist/http.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Receipts over HTTP (SPEC.md §15): every call between two agents leaves a
+ * countersigned receipt, with one wrapper on each side.
+ *
+ * Worker (the agent that does the work and answers the call):
+ *
+ *   const handler = inamReceipts(myHandler, { client, capability: "code-review" });
+ *
+ * Requester (the agent that calls it):
+ *
+ *   const inam = inamFetch(client);
+ *   const res = await inam.fetch("https://reviewer.example/review", { method: "POST", body });
+ *   await inam.settle(); // wait for countersigns before a serverless function exits
+ *
+ * The requester names itself in `INAM-Requester`. The worker hashes the request
+ * it received and the response it sends, drafts a receipt naming the requester,
+ * and returns the receipt id in `INAM-Receipt`. The requester recomputes both
+ * hashes from the bytes it actually sent and received, and countersigns only
+ * when they match. A countersign confirms delivery of exactly those bytes for
+ * exactly that request, nothing more; pass `accept` to also judge the output.
+ */
+import type { InamClient } from "./client.js";
+import type { ExecutionReceipt } from "./types.js";
+export declare const INAM_REQUESTER_HEADER = "INAM-Requester";
+export declare const INAM_RECEIPT_HEADER = "INAM-Receipt";
+/** sha256 over `METHOD path?query\n` followed by the exact request body bytes. */
+export declare function httpSpecHash(method: string, url: string, body: Uint8Array): string;
+/** sha256 over the exact response body bytes. */
+export declare function httpOutputHash(body: Uint8Array): string;
+/**
+ * Wraps a fetch-style handler (Workers, Hono, Next.js route handlers, Deno,
+ * Bun). Drafts a receipt for every 2xx answer to a request that carries a
+ * valid `INAM-Requester`; anything else passes through untouched. Buffers the
+ * response body to hash it, so it is not for long-lived streams.
+ */
+export declare function inamReceipts(handler: (req: Request) => Response | Promise<Response>, opts: {
+    client: InamClient;
+    capability: string;
+    visibility?: "public" | "participants_only";
+    /** Run the registry call in the background (e.g. ctx.waitUntil); default: await it before responding. */
+    waitUntil?: (p: Promise<unknown>) => void;
+    onError?: (err: unknown) => void;
+}): (req: Request) => Promise<Response>;
+/**
+ * A fetch that asks the worker for a receipt and countersigns it once the
+ * hashes match what was really sent and received. Countersigning runs in the
+ * background; `settle()` waits for all of it.
+ */
+export declare function inamFetch(client: InamClient, opts?: {
+    fetch?: typeof fetch;
+    /** Return false to leave the draft unsigned (e.g. the output failed your own checks). */
+    accept?: (res: Response, receipt: ExecutionReceipt) => boolean | Promise<boolean>;
+    onReceipt?: (receipt: ExecutionReceipt) => void;
+    onError?: (err: unknown) => void;
+    /** How long to wait for a background-drafted receipt to appear. */
+    retries?: number;
+}): {
+    fetch: typeof fetch;
+    settle: () => Promise<void>;
+};

package/dist/http.js

@@ -0,0 +1,108 @@
+import { computeReceiptId } from "./core/receiptContent.js";
+import { sha256Hex } from "./crypto/keys.js";
+export const INAM_REQUESTER_HEADER = "INAM-Requester";
+export const INAM_RECEIPT_HEADER = "INAM-Receipt";
+const DID_KEY = /^did:key:z[1-9A-HJ-NP-Za-km-z]+$/;
+/** sha256 over `METHOD path?query\n` followed by the exact request body bytes. */
+export function httpSpecHash(method, url, body) {
+    const { pathname, search } = new URL(url);
+    const head = new TextEncoder().encode(`${method.toUpperCase()} ${pathname}${search}\n`);
+    const bytes = new Uint8Array(head.length + body.length);
+    bytes.set(head);
+    bytes.set(body, head.length);
+    return `sha256:${sha256Hex(bytes)}`;
+}
+/** sha256 over the exact response body bytes. */
+export function httpOutputHash(body) {
+    return `sha256:${sha256Hex(body)}`;
+}
+const bytesOf = async (r) => new Uint8Array(await r.clone().arrayBuffer());
+/**
+ * Wraps a fetch-style handler (Workers, Hono, Next.js route handlers, Deno,
+ * Bun). Drafts a receipt for every 2xx answer to a request that carries a
+ * valid `INAM-Requester`; anything else passes through untouched. Buffers the
+ * response body to hash it, so it is not for long-lived streams.
+ */
+export function inamReceipts(handler, opts) {
+    return async (req) => {
+        const requester = req.headers.get(INAM_REQUESTER_HEADER);
+        if (!requester || !DID_KEY.test(requester) || requester === opts.client.did)
+            return handler(req);
+        const reqBytes = await bytesOf(req);
+        const res = await handler(req);
+        if (!res.ok)
+            return res;
+        const now = new Date().toISOString();
+        const input = {
+            jobId: `http:${crypto.randomUUID()}`,
+            task: { capability: opts.capability, specHash: httpSpecHash(req.method, req.url, reqBytes), createdAt: now },
+            result: { outputHash: httpOutputHash(await bytesOf(res)), completedAt: now },
+            verification: { method: "payer_confirmation", outcome: "success" },
+        };
+        // Content-addressed, so the id is known before the registry sees the draft.
+        const receiptId = computeReceiptId(requester, opts.client.did, input);
+        const draft = opts.client.submitWork(requester, input, { visibility: opts.visibility }).catch((err) => opts.onError?.(err));
+        if (opts.waitUntil)
+            opts.waitUntil(draft);
+        else
+            await draft;
+        const headers = new Headers(res.headers);
+        headers.set(INAM_RECEIPT_HEADER, receiptId);
+        return new Response(res.body, { status: res.status, statusText: res.statusText, headers });
+    };
+}
+/**
+ * A fetch that asks the worker for a receipt and countersigns it once the
+ * hashes match what was really sent and received. Countersigning runs in the
+ * background; `settle()` waits for all of it.
+ */
+export function inamFetch(client, opts = {}) {
+    const base = opts.fetch ?? fetch;
+    const pending = new Set();
+    async function countersign(req, reqBytes, res, receiptId) {
+        const specHash = httpSpecHash(req.method, req.url, reqBytes);
+        const outputHash = httpOutputHash(await bytesOf(res));
+        let receipt;
+        for (let i = 0;; i++) {
+            try {
+                receipt = await client.getReceipt(receiptId);
+                break;
+            }
+            catch (err) {
+                if (i >= (opts.retries ?? 5))
+                    throw err;
+                await new Promise((r) => setTimeout(r, 500 * (i + 1)));
+            }
+        }
+        if (receipt.task.specHash !== specHash)
+            throw new Error(`inamFetch: receipt ${receiptId} names a different request (specHash mismatch)`);
+        if (receipt.status !== "draft")
+            return;
+        if (opts.accept && !(await opts.accept(res.clone(), receipt)))
+            return;
+        // acceptWork also refuses unless this client is the receipt's requester.
+        const done = await client.acceptWork(receipt, { jobId: receipt.jobId, outputHash });
+        opts.onReceipt?.(done);
+    }
+    const wrapped = (async (input, init) => {
+        const req = new Request(input, init);
+        req.headers.set(INAM_REQUESTER_HEADER, client.did);
+        const reqBytes = await bytesOf(req);
+        const res = await base(req);
+        const receiptId = res.headers.get(INAM_RECEIPT_HEADER);
+        if (res.ok && receiptId) {
+            const p = countersign(req, reqBytes, res.clone(), receiptId).catch((err) => opts.onError?.(err));
+            pending.add(p);
+            void p.finally(() => pending.delete(p));
+        }
+        return res;
+    });
+    return {
+        fetch: wrapped,
+        settle: async () => {
+            while (pending.size)
+                await Promise.all([...pending]);
+        },
+    };
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

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

package/dist/index.d.ts

@@ -11,11 +11,12 @@ export { type TransparencyEntryType, payloadHash } from "./core/transparencyLog.
 export { type AttestationVerdict, type EvidenceLevel, type EvidenceDimensions } from "./core/attestation.js";
 export { registerAgentSchema, linkChallengeSchema, linkSchema, postJobSchema, offerSchema, acceptOfferSchema, draftReceiptSchema, countersignSchema, disputeSchema, submitVerificationSchema, setVerifierStatusSchema, } from "./core/schemas.js";
 export type { LinkedIdentities, ExternalKeyType, LinkChallenge, AgentRecord, VerificationMethod, ReceiptOutcome, ReceiptStatus, DisputeStatus, ExecutionReceipt, SignableReceiptContent, ReputationComponents, ReputationRoleBreakdown, ReputationResult, JobStatus, JobOffer, JobRecord, IndependentVerificationMethod, VerificationResult, VerificationRecord, } from "./types.js";
-export { INAM_X402_EXTENSION, inamX402Extension, decideX402, withInamX402Gate, X402PaymentBlocked } from "./x402.js";
-export type { X402Policy, X402Decision } from "./x402.js";
+export { INAM_X402_EXTENSION, inamX402Extension, decideX402, withInamX402Gate, X402PaymentBlocked, X402_POLICY_VERSION, x402PolicyInput, counterpartyContext } from "./x402.js";
+export type { X402Policy, X402Decision, X402Request } from "./x402.js";
 export { INAM_A2A_EXTENSION_URI, inamA2AExtension, decideA2A, verifyA2ACard, cardEndpoints } from "./a2a.js";
 export type { A2APolicy, A2ADecision, A2AAgentCardLike } from "./a2a.js";
 export { decideTrust, checkTrust, DEFAULT_ESCROW_FLAGS } from "./trust.js";
 export type { TrustPolicy, TrustDecision, TrustDecisionKind } from "./trust.js";
 export { INAM_FEEDBACK_TAG, buildErc8004Feedback, verifyErc8004Feedback } from "./erc8004.js";
 export type { Erc8004Target, Erc8004Feedback, Erc8004FeedbackCheck } from "./erc8004.js";
+export { inamReceipts, inamFetch, httpSpecHash, httpOutputHash, INAM_REQUESTER_HEADER, INAM_RECEIPT_HEADER } from "./http.js";

package/dist/index.js

@@ -20,8 +20,9 @@ export { payloadHash } from "./core/transparencyLog.js";
 // publicly too: a caller building requests by hand (rather than through
 // InamClient) can validate a payload client-side before sending it.
 export { registerAgentSchema, linkChallengeSchema, linkSchema, postJobSchema, offerSchema, acceptOfferSchema, draftReceiptSchema, countersignSchema, disputeSchema, submitVerificationSchema, setVerifierStatusSchema, } from "./core/schemas.js";
-export { INAM_X402_EXTENSION, inamX402Extension, decideX402, withInamX402Gate, X402PaymentBlocked } from "./x402.js";
+export { INAM_X402_EXTENSION, inamX402Extension, decideX402, withInamX402Gate, X402PaymentBlocked, X402_POLICY_VERSION, x402PolicyInput, counterpartyContext } from "./x402.js";
 export { INAM_A2A_EXTENSION_URI, inamA2AExtension, decideA2A, verifyA2ACard, cardEndpoints } from "./a2a.js";
 export { decideTrust, checkTrust, DEFAULT_ESCROW_FLAGS } from "./trust.js";
 export { INAM_FEEDBACK_TAG, buildErc8004Feedback, verifyErc8004Feedback } from "./erc8004.js";
+export { inamReceipts, inamFetch, httpSpecHash, httpOutputHash, INAM_REQUESTER_HEADER, INAM_RECEIPT_HEADER } from "./http.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,IAAI,EACJ,MAAM,EACN,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,UAAU,EACV,KAAK,EACL,OAAO,GAER,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAoB,MAAM,kBAAkB,CAAC;AAE/F,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,mCAAmC,EACnC,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAA4B,MAAM,0BAA0B,CAAC;AAE5G,qEAAqE;AACrE,yEAAyE;AACzE,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAExF,OAAO,EAAE,qBAAqB,EAAE,gCAAgC,EAAiC,MAAM,+BAA+B,CAAC;AAEvI,2EAA2E;AAC3E,0EAA0E;AAC1E,sEAAsE;AACtE,0CAA0C;AAC1C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAA8B,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGpF,4EAA4E;AAC5E,2EAA2E;AAC3E,sEAAsE;AACtE,wEAAwE;AACxE,oEAAoE;AACpE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAuB3B,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAErH,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE7G,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,IAAI,EACJ,MAAM,EACN,gBAAgB,EAChB,SAAS,EACT,QAAQ,EACR,UAAU,EACV,KAAK,EACL,OAAO,GAER,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,UAAU,EAAoB,MAAM,kBAAkB,CAAC;AAE/F,OAAO,EACL,wBAAwB,EACxB,aAAa,EACb,eAAe,EACf,mCAAmC,EACnC,qBAAqB,GAEtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAA4B,MAAM,0BAA0B,CAAC;AAE5G,qEAAqE;AACrE,yEAAyE;AACzE,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAExF,OAAO,EAAE,qBAAqB,EAAE,gCAAgC,EAAiC,MAAM,+BAA+B,CAAC;AAEvI,2EAA2E;AAC3E,0EAA0E;AAC1E,sEAAsE;AACtE,0CAA0C;AAC1C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAA8B,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGpF,4EAA4E;AAC5E,2EAA2E;AAC3E,sEAAsE;AACtE,wEAAwE;AACxE,oEAAoE;AACpE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,aAAa,EACb,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC;AAuB3B,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAEhL,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE7G,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE3E,OAAO,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAE9F,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC"}

package/dist/x402.d.ts

@@ -44,6 +44,53 @@ export declare function inamX402Extension(did: string): {
 export declare function decideX402(agent: AgentRecord, reputation: ReputationResult, payTo: string[], policy?: X402Policy): X402Decision;
 /** Why `reputation` misses `policy`, or null if it meets it. Shared with the A2A check (§11.3). */
 export declare function policyFailure(reputation: ReputationResult, policy?: X402Policy): string | null;
+/** The payment the caller is about to make, as `CounterpartyContext` names it (x402 #1777). */
+export interface X402Request {
+    resource: string;
+    amount: string;
+    network: string;
+    nonce: string;
+}
+export declare const X402_POLICY_VERSION = "inam-x402-gate/1";
+/** Exactly what `decideX402` reads, with defaults applied: anyone holding this
+ * object can re-derive the decision and recompute `policy_input_hash`. */
+export declare function x402PolicyInput(agent: AgentRecord, reputation: ReputationResult, payTo: string[], request: X402Request, policy?: X402Policy): {
+    policy_version: string;
+    policy: {
+        minEvidence: EvidenceLevel;
+        minTrustScore: number;
+    };
+    counterparty_did: string;
+    revoked: boolean;
+    bound_wallet: string | null;
+    pay_to: string[];
+    evidence_level: EvidenceLevel;
+    trust_score: number;
+    trust_profile_issued_at: string;
+    requested_resource: string;
+    requested_amount: string;
+    chain_or_settlement_network: string;
+    nonce_or_request_id: string;
+};
+/** A `CounterpartyContext` (x402 #1777) for one gate decision. `policy_input_hash`
+ * is sha256 over the JCS (RFC 8785) form of `x402PolicyInput`. Unsigned: it is
+ * the payer's own record of what it checked, not an attestation. */
+export declare function counterpartyContext(agent: AgentRecord, reputation: ReputationResult, payTo: string[], request: X402Request, policy?: X402Policy, registryUrl?: string): {
+    counterparty_did: string;
+    counterparty_wallet_or_account: string | null;
+    wallet_binding_proof_ref: string;
+    trust_profile_ref: string;
+    trust_profile_issued_at: string;
+    requested_resource: string;
+    requested_amount: string;
+    chain_or_settlement_network: string;
+    nonce_or_request_id: string;
+    policy_version: string;
+    policy_input_canonicalization: string;
+    policy_input_hash: string;
+    decision: "allow" | "deny";
+    reason: string;
+};
 export declare class X402PaymentBlocked extends Error {
     readonly decision: X402Decision;
     constructor(decision: X402Decision);

package/dist/x402.js

@@ -1,3 +1,5 @@
+import { canonicalize } from "./crypto/canonical.js";
+import { sha256Hex } from "./crypto/keys.js";
 /** "Verify before you pay" for x402 v2 (SPEC.md §11.2).
  *
  * A paid resource names its INAM ID in the 402's `extensions.inam`. Before any
@@ -42,6 +44,50 @@ export function policyFailure(reputation, policy = {}) {
         return `trustScore ${reputation.trustScore} is below ${policy.minTrustScore}`;
     return null;
 }
+export const X402_POLICY_VERSION = "inam-x402-gate/1";
+/** Exactly what `decideX402` reads, with defaults applied: anyone holding this
+ * object can re-derive the decision and recompute `policy_input_hash`. */
+export function x402PolicyInput(agent, reputation, payTo, request, policy = {}) {
+    return {
+        policy_version: X402_POLICY_VERSION,
+        policy: { minEvidence: policy.minEvidence ?? "countersigned", minTrustScore: policy.minTrustScore ?? 0 },
+        counterparty_did: agent.id,
+        revoked: Boolean(agent.revokedAt),
+        bound_wallet: agent.linked.erc8004_id?.toLowerCase() ?? null,
+        pay_to: payTo.map((a) => a.toLowerCase()),
+        evidence_level: reputation.evidenceLevel,
+        trust_score: reputation.trustScore,
+        trust_profile_issued_at: reputation.evidence?.freshness?.evaluatedAt ?? null,
+        requested_resource: request.resource,
+        requested_amount: request.amount,
+        chain_or_settlement_network: request.network,
+        nonce_or_request_id: request.nonce,
+    };
+}
+/** A `CounterpartyContext` (x402 #1777) for one gate decision. `policy_input_hash`
+ * is sha256 over the JCS (RFC 8785) form of `x402PolicyInput`. Unsigned: it is
+ * the payer's own record of what it checked, not an attestation. */
+export function counterpartyContext(agent, reputation, payTo, request, policy = {}, registryUrl = "https://api.inamprotocol.org") {
+    const input = x402PolicyInput(agent, reputation, payTo, request, policy);
+    const decision = decideX402(agent, reputation, payTo, policy);
+    const agentUrl = `${registryUrl}/v1/agents/${encodeURIComponent(agent.id)}`;
+    return {
+        counterparty_did: agent.id,
+        counterparty_wallet_or_account: input.bound_wallet,
+        wallet_binding_proof_ref: agentUrl,
+        trust_profile_ref: `${agentUrl}/reputation`,
+        trust_profile_issued_at: input.trust_profile_issued_at,
+        requested_resource: request.resource,
+        requested_amount: request.amount,
+        chain_or_settlement_network: request.network,
+        nonce_or_request_id: request.nonce,
+        policy_version: X402_POLICY_VERSION,
+        policy_input_canonicalization: "JCS (RFC 8785)",
+        policy_input_hash: `sha256:${sha256Hex(canonicalize(input))}`,
+        decision: decision.allow ? "allow" : "deny",
+        reason: decision.reason,
+    };
+}
 export class X402PaymentBlocked extends Error {
     decision;
     constructor(decision) {

package/dist/x402.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "inamprotocol",
-  "version": "0.17.1",
+  "version": "0.19.0",
   "description": "Reference TypeScript/JavaScript SDK for the INAM Protocol — agent identity, execution receipts, jobs, and reputation",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,6 +9,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./ai-sdk": {
+      "types": "./dist/aiSdk.d.ts",
+      "import": "./dist/aiSdk.js"
     }
   },
   "files": [
@@ -26,7 +30,10 @@
     "reputation",
     "did",
     "protocol",
-    "execution-receipt"
+    "execution-receipt",
+    "ai-sdk",
+    "vercel-ai",
+    "tools"
   ],
   "homepage": "https://inamprotocol.org",
   "repository": {
@@ -48,6 +55,15 @@
   },
   "devDependencies": {
     "@types/node": "^22.5.0",
+    "ai": "^7.0.135",
     "typescript": "^5.5.4"
+  },
+  "peerDependencies": {
+    "ai": ">=7"
+  },
+  "peerDependenciesMeta": {
+    "ai": {
+      "optional": true
+    }
   }
 }