@signet-auth/vercel-ai 0.4.4

package/README.md

@@ -0,0 +1,39 @@
+# @signet-auth/vercel-ai
+
+Signet signing callbacks for Vercel AI SDK. Signs every tool call with Ed25519 — 3 lines of code, no infrastructure.
+
+[![npm](https://img.shields.io/npm/v/@signet-auth/vercel-ai?style=flat-square)](https://www.npmjs.com/package/@signet-auth/vercel-ai)
+[![GitHub Stars](https://img.shields.io/github/stars/Prismer-AI/signet?style=flat-square&color=yellow)](https://github.com/Prismer-AI/signet)
+
+## Install
+
+```bash
+npm install @signet-auth/vercel-ai @signet-auth/core
+```
+
+## Usage
+
+```typescript
+import { generateText } from "ai";
+import { openai } from "@ai-sdk/openai";
+import { createSignetCallbacks } from "@signet-auth/vercel-ai";
+import { generateKeypair } from "@signet-auth/core";
+
+const { secretKey } = generateKeypair();
+const callbacks = createSignetCallbacks(secretKey, "my-agent");
+
+const result = await generateText({
+  model: openai("gpt-4o"),
+  tools: { myTool },
+  ...callbacks,
+  prompt: "Use the tool to ...",
+});
+
+console.log(callbacks.receipts); // signed receipts for every tool call
+```
+
+## Links
+
+- [Full documentation & all SDKs](https://github.com/Prismer-AI/signet)
+
+If Signet is useful to you, [star us on GitHub](https://github.com/Prismer-AI/signet) — it helps others discover the project.

package/dist/src/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Signet signing callbacks for Vercel AI SDK.
+ *
+ * Usage:
+ *   import { generateText } from "ai";
+ *   import { createSignetCallbacks } from "@signet-auth/vercel-ai";
+ *   import { generateKeypair } from "@signet-auth/core";
+ *
+ *   const { secretKey } = generateKeypair();
+ *   const callbacks = createSignetCallbacks(secretKey, "my-agent");
+ *
+ *   const result = await generateText({
+ *     model: openai("gpt-4"),
+ *     tools: { myTool },
+ *     ...callbacks,
+ *     prompt: "...",
+ *   });
+ *
+ *   console.log(callbacks.receipts);  // all signed receipts
+ */
+import { type SignetReceipt } from "@signet-auth/core";
+/** A signed receipt from a tool call. */
+export interface ToolCallReceipt {
+    toolName: string;
+    toolCallId: string;
+    receipt: SignetReceipt;
+    durationMs?: number;
+}
+/** Options for createSignetCallbacks. */
+export interface SignetCallbackOptions {
+    /** Target URI for receipts (default: "vercel-ai://local"). */
+    target?: string;
+    /** Whether to include tool args hash in the receipt (default: true). */
+    hashArgs?: boolean;
+}
+/**
+ * Create Vercel AI SDK callbacks that sign every tool call with Signet.
+ *
+ * Returns an object with:
+ * - `experimental_onToolCallStart` — signs tool call before execution
+ * - `experimental_onToolCallFinish` — records completion with duration
+ * - `receipts` — array of all signed receipts
+ */
+export declare function createSignetCallbacks(secretKey: string, signerName: string, options?: SignetCallbackOptions & {
+    signerOwner?: string;
+}): {
+    receipts: ToolCallReceipt[];
+    experimental_onToolCallStart({ toolCallId, toolName, args, }: {
+        toolCallId: string;
+        toolName: string;
+        args: unknown;
+    }): void;
+    experimental_onToolCallFinish({ toolCallId, toolName, result, durationMs, }: {
+        toolCallId: string;
+        toolName: string;
+        result: unknown;
+        durationMs?: number;
+    }): void;
+};

package/dist/src/index.js

@@ -0,0 +1,62 @@
+/**
+ * Signet signing callbacks for Vercel AI SDK.
+ *
+ * Usage:
+ *   import { generateText } from "ai";
+ *   import { createSignetCallbacks } from "@signet-auth/vercel-ai";
+ *   import { generateKeypair } from "@signet-auth/core";
+ *
+ *   const { secretKey } = generateKeypair();
+ *   const callbacks = createSignetCallbacks(secretKey, "my-agent");
+ *
+ *   const result = await generateText({
+ *     model: openai("gpt-4"),
+ *     tools: { myTool },
+ *     ...callbacks,
+ *     prompt: "...",
+ *   });
+ *
+ *   console.log(callbacks.receipts);  // all signed receipts
+ */
+import { sign, contentHash } from "@signet-auth/core";
+/**
+ * Create Vercel AI SDK callbacks that sign every tool call with Signet.
+ *
+ * Returns an object with:
+ * - `experimental_onToolCallStart` — signs tool call before execution
+ * - `experimental_onToolCallFinish` — records completion with duration
+ * - `receipts` — array of all signed receipts
+ */
+export function createSignetCallbacks(secretKey, signerName, options = {}) {
+    const signerOwner = options.signerOwner ?? "";
+    const target = options.target ?? "vercel-ai://local";
+    const hashArgs = options.hashArgs ?? true;
+    const receipts = [];
+    return {
+        receipts,
+        experimental_onToolCallStart({ toolCallId, toolName, args, }) {
+            try {
+                const action = {
+                    tool: toolName,
+                    params: args,
+                    params_hash: hashArgs && args != null ? contentHash(args) : contentHash({}),
+                    target,
+                    transport: "vercel-ai",
+                };
+                const receipt = sign(secretKey, action, signerName, signerOwner);
+                receipts.push({ toolName, toolCallId, receipt });
+            }
+            catch (err) {
+                // Never block tool execution, but log for debugging
+                console.warn("[signet] Failed to sign tool call:", err);
+            }
+        },
+        experimental_onToolCallFinish({ toolCallId, toolName, result, durationMs, }) {
+            // Update the matching receipt with duration
+            const entry = receipts.find((r) => r.toolCallId === toolCallId && r.toolName === toolName);
+            if (entry) {
+                entry.durationMs = durationMs;
+            }
+        },
+    };
+}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@signet-auth/vercel-ai",
+  "version": "0.4.4",
+  "description": "Signet signing middleware for Vercel AI SDK",
+  "type": "module",
+  "main": "dist/src/index.js",
+  "types": "dist/src/index.d.ts",
+  "files": ["dist/"],
+  "scripts": {
+    "build": "npx tsc",
+    "test": "npx tsc -p tsconfig.test.json && node --test dist-test/tests/vercel-ai.test.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@signet-auth/core": "^0.4.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "typescript": "^5"
+  },
+  "license": "Apache-2.0 OR MIT"
+}