@orangecheck/agent-vercel 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 OrangeCheck
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# @orangecheck/agent-vercel
+
+Wrap [Vercel AI SDK](https://sdk.vercel.ai/) `tool()` invocations with [OC Agent](https://github.com/orangecheck/oc-agent-protocol) scope enforcement and emit a signed `agent-action` envelope per tool execution. Provider-agnostic — works under Anthropic, OpenAI, Cohere, or any other model the AI SDK speaks.
+
+## Why
+
+The Vercel AI SDK has converged on a clean `tool({description, parameters, execute})` primitive that serializes naturally across providers. A single adapter at this layer covers a large fraction of teams shipping production agents.
+
+This module wraps `execute` so every successful call produces a signed `agent-action` envelope citing the active delegation:
+
+- Pre-call: scope check (`vercel:tool(verb=<verb>)` against the delegation; refuses if not admissible).
+- Canonicalize the `(verb, args, callId)` tuple, BIP-322 sign as the agent address, emit envelope.
+- Run the real handler.
+- Return both the result (back to the model via the SDK) and the envelope (for your audit pipeline).
+
+## Status
+
+**v0.0.1 · in design.** API shape is stable; the canonicalization layout (`{args, call_id, verb}` lexicographic, RFC 8785 canonical JSON, trailing LF) is locked. Production wiring with specific AI-SDK releases is intentionally not baked in — `ocTool()` is provider/SDK-agnostic so you can call it from any release of `ai` you're already on.
+
+## Install
+
+```bash
+npm i @orangecheck/agent-vercel
+# peer deps:
+npm i @orangecheck/agent-core @orangecheck/agent-signer
+```
+
+## Quickstart
+
+```ts
+import { tool } from 'ai';
+import { ocTool } from '@orangecheck/agent-vercel';
+
+const invoiceCreate = ocTool({
+    verb:        'invoice.create',
+    description: 'create a new invoice',
+    parameters:  invoiceSchema,
+    execute:     async (args) => myInvoiceCreateImpl(args),
+});
+
+const tools = {
+    'invoice.create': tool({
+        description: invoiceCreate.description,
+        parameters:  invoiceCreate.parameters as never,
+        execute: async (args, { toolCallId }) => {
+            const { result, action } = await invoiceCreate.execute(args, {
+                agent, delegation, callId: toolCallId,
+            });
+            await yourAuditPipeline.append(action);
+            return result;
+        },
+    }),
+};
+
+const { text } = await generateText({
+    model: anthropic('claude-sonnet-4-6'),
+    tools,
+    prompt: 'invoice acme for $14.20',
+});
+```
+
+The pattern: `ocTool` defines the OC-Agent-shaped wrapper; the AI SDK's `tool()` calls into that wrapper plus your audit pipeline.
+
+## What gets stamped
+
+Stamp's `content.hash` is a SHA-256 of:
+
+```json
+{
+  "args":    <canonical JSON of args>,
+  "call_id": "<sdk-assigned tool call id>",
+  "verb":    "<verb>"
+}
+```
+
+Default `scope_exercised` is `vercel:tool(verb=<verb>)`. Override via `scopeExercised`.
+
+## API
+
+- `canonicalizeToolCall(call)` — RFC 8785 canonical bytes.
+- `toolCallHash(call)` — `sha256:<64-hex>`.
+- `stampToolCall(input)` — sign without executing.
+- `ocTool({verb, parameters, description, execute})` — provider-agnostic wrapped tool.
+
+## License
+
+MIT.
+
+## Related
+
+- [oc-agent-protocol](https://github.com/orangecheck/oc-agent-protocol) — normative wire format.
+- [@orangecheck/agent-core](https://www.npmjs.com/package/@orangecheck/agent-core) — verifier library.
+- [@orangecheck/agent-mcp](https://www.npmjs.com/package/@orangecheck/agent-mcp) / [-anthropic](https://www.npmjs.com/package/@orangecheck/agent-anthropic) / [-openai](https://www.npmjs.com/package/@orangecheck/agent-openai) — sibling adapters.
+- [console.ochk.io/integrations/vercel-ai](https://console.ochk.io/integrations/vercel-ai) — managed-tier story.

package/dist/index.d.mts

@@ -0,0 +1,55 @@
+import { DelegationEnvelope } from '@orangecheck/agent-core';
+import { SignerRef, ActionEnvelope } from '@orangecheck/agent-signer';
+
+interface VercelToolCall {
+    callId: string;
+    verb: string;
+    args: Record<string, unknown>;
+}
+declare function canonicalizeToolCall(c: VercelToolCall): Uint8Array;
+declare function toolCallHash(c: VercelToolCall): string;
+declare function toolCallActionId(agentAddress: string, signedAt: string, delegationId: string, scopeExercised: string, c: VercelToolCall): string;
+interface AgentContext {
+    agent: SignerRef;
+    delegation: DelegationEnvelope;
+}
+interface StampToolCallInput extends AgentContext {
+    call: VercelToolCall;
+    scopeExercised?: string;
+    signedAt?: Date;
+}
+declare function stampToolCall(input: StampToolCallInput): Promise<ActionEnvelope>;
+interface OcToolInput<TArgs extends Record<string, unknown>, TResult> {
+    verb: string;
+    parameters?: unknown;
+    description?: string;
+    execute: (args: TArgs) => Promise<TResult>;
+}
+interface OcToolWrapped<TArgs extends Record<string, unknown>, TResult> {
+    verb: string;
+    parameters?: unknown;
+    description?: string;
+    execute: (args: TArgs, ctx: AgentContext & {
+        callId: string;
+        console?: ConsoleClient;
+    }) => Promise<{
+        result: TResult;
+        action: ActionEnvelope;
+        posted: PostActionResult | null;
+    }>;
+}
+declare function ocTool<TArgs extends Record<string, unknown>, TResult>(input: OcToolInput<TArgs, TResult>): OcToolWrapped<TArgs, TResult>;
+interface ConsoleClient {
+    baseUrl?: string;
+    apiToken: string;
+    projectId: string;
+    fetch?: typeof fetch;
+}
+interface PostActionResult {
+    id: string;
+    project_id: string;
+    delegation_id: string;
+}
+declare function postActionToConsole(action: ActionEnvelope, client: ConsoleClient): Promise<PostActionResult>;
+
+export { type AgentContext, type ConsoleClient, type OcToolInput, type OcToolWrapped, type PostActionResult, type StampToolCallInput, type VercelToolCall, canonicalizeToolCall, ocTool, postActionToConsole, stampToolCall, toolCallActionId, toolCallHash };

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+import { DelegationEnvelope } from '@orangecheck/agent-core';
+import { SignerRef, ActionEnvelope } from '@orangecheck/agent-signer';
+
+interface VercelToolCall {
+    callId: string;
+    verb: string;
+    args: Record<string, unknown>;
+}
+declare function canonicalizeToolCall(c: VercelToolCall): Uint8Array;
+declare function toolCallHash(c: VercelToolCall): string;
+declare function toolCallActionId(agentAddress: string, signedAt: string, delegationId: string, scopeExercised: string, c: VercelToolCall): string;
+interface AgentContext {
+    agent: SignerRef;
+    delegation: DelegationEnvelope;
+}
+interface StampToolCallInput extends AgentContext {
+    call: VercelToolCall;
+    scopeExercised?: string;
+    signedAt?: Date;
+}
+declare function stampToolCall(input: StampToolCallInput): Promise<ActionEnvelope>;
+interface OcToolInput<TArgs extends Record<string, unknown>, TResult> {
+    verb: string;
+    parameters?: unknown;
+    description?: string;
+    execute: (args: TArgs) => Promise<TResult>;
+}
+interface OcToolWrapped<TArgs extends Record<string, unknown>, TResult> {
+    verb: string;
+    parameters?: unknown;
+    description?: string;
+    execute: (args: TArgs, ctx: AgentContext & {
+        callId: string;
+        console?: ConsoleClient;
+    }) => Promise<{
+        result: TResult;
+        action: ActionEnvelope;
+        posted: PostActionResult | null;
+    }>;
+}
+declare function ocTool<TArgs extends Record<string, unknown>, TResult>(input: OcToolInput<TArgs, TResult>): OcToolWrapped<TArgs, TResult>;
+interface ConsoleClient {
+    baseUrl?: string;
+    apiToken: string;
+    projectId: string;
+    fetch?: typeof fetch;
+}
+interface PostActionResult {
+    id: string;
+    project_id: string;
+    delegation_id: string;
+}
+declare function postActionToConsole(action: ActionEnvelope, client: ConsoleClient): Promise<PostActionResult>;
+
+export { type AgentContext, type ConsoleClient, type OcToolInput, type OcToolWrapped, type PostActionResult, type StampToolCallInput, type VercelToolCall, canonicalizeToolCall, ocTool, postActionToConsole, stampToolCall, toolCallActionId, toolCallHash };

package/dist/index.js

@@ -0,0 +1,122 @@
+'use strict';
+
+var sha256 = require('@noble/hashes/sha256');
+var agentCore = require('@orangecheck/agent-core');
+var agentSigner = require('@orangecheck/agent-signer');
+
+// src/index.ts
+function canonicalizeToolCall(c) {
+  const canon = {
+    args: c.args,
+    call_id: c.callId,
+    verb: c.verb
+  };
+  const str = agentCore.canonicalize(canon);
+  return new TextEncoder().encode(str + "\n");
+}
+function toolCallHash(c) {
+  return "sha256:" + agentCore.hexEncode(sha256.sha256(canonicalizeToolCall(c)));
+}
+function toolCallActionId(agentAddress, signedAt, delegationId, scopeExercised, c) {
+  return agentCore.computeActionId({
+    address: agentAddress,
+    content_hash: toolCallHash(c),
+    content_length: canonicalizeToolCall(c).byteLength,
+    content_mime: "application/vnd.oc-agent.vercel-tool-call+json",
+    signed_at: signedAt,
+    delegation_id: delegationId,
+    scope_exercised: scopeExercised
+  });
+}
+async function stampToolCall(input) {
+  const scopeExercised = input.scopeExercised ?? `vercel:tool(verb=${input.call.verb})`;
+  const granted = (input.delegation.scopes ?? []).map(agentCore.parseScope);
+  const exercisedParsed = agentCore.parseScope(scopeExercised);
+  if (!granted.some((g) => agentCore.isSubScope(exercisedParsed, g))) {
+    throw new Error(
+      `stampToolCall: scope_exercised (${scopeExercised}) is not a sub-scope of any granted scope`
+    );
+  }
+  const bytes = canonicalizeToolCall(input.call);
+  return agentSigner.signAsAgent({
+    agent: input.agent,
+    delegation: input.delegation,
+    content: { hash: toolCallHash(input.call), length: bytes.byteLength },
+    mime: "application/vnd.oc-agent.vercel-tool-call+json",
+    scopeExercised,
+    signedAt: input.signedAt
+  });
+}
+function ocTool(input) {
+  return {
+    verb: input.verb,
+    parameters: input.parameters,
+    description: input.description,
+    execute: async (args, ctx) => {
+      const call = {
+        callId: ctx.callId,
+        verb: input.verb,
+        args
+      };
+      const action = await stampToolCall({
+        agent: ctx.agent,
+        delegation: ctx.delegation,
+        call
+      });
+      const result = await input.execute(args);
+      let posted = null;
+      if (ctx.console) {
+        try {
+          posted = await postActionToConsole(action, ctx.console);
+        } catch (err) {
+          console.error("[oc-agent-vercel] postActionToConsole failed:", err);
+        }
+      }
+      return { result, action, posted };
+    }
+  };
+}
+async function postActionToConsole(action, client) {
+  const baseUrl = client.baseUrl ?? "https://console.ochk.io";
+  const f = client.fetch ?? fetch;
+  const body = {
+    project_id: client.projectId,
+    delegation_id: action.delegation_id,
+    agent_address: action.signer.address,
+    scope_exercised: action.scope_exercised,
+    content_hash: action.content.hash,
+    content_length: action.content.length,
+    content_mime: action.content.mime,
+    signed_at: action.signed_at,
+    signature: action.sig.value,
+    id: action.id
+  };
+  const r = await f(`${baseUrl}/api/actions`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${client.apiToken}`
+    },
+    body: JSON.stringify(body)
+  });
+  if (!r.ok) {
+    let reason = `http_${r.status}`;
+    try {
+      const j2 = await r.json();
+      if (j2.reason) reason = j2.reason;
+    } catch {
+    }
+    throw new Error(`postActionToConsole failed: ${reason}`);
+  }
+  const j = await r.json();
+  return j.action;
+}
+
+exports.canonicalizeToolCall = canonicalizeToolCall;
+exports.ocTool = ocTool;
+exports.postActionToConsole = postActionToConsole;
+exports.stampToolCall = stampToolCall;
+exports.toolCallActionId = toolCallActionId;
+exports.toolCallHash = toolCallHash;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["canonicalize","hexEncode","sha256","computeActionId","parseScope","isSubScope","signAsAgent","j"],"mappings":";;;;;;;AA8DO,SAAS,qBAAqB,CAAA,EAA+B;AAChE,EAAA,MAAM,KAAA,GAAQ;AAAA,IACV,MAAM,CAAA,CAAE,IAAA;AAAA,IACR,SAAS,CAAA,CAAE,MAAA;AAAA,IACX,MAAM,CAAA,CAAE;AAAA,GACZ;AACA,EAAA,MAAM,GAAA,GAAMA,uBAAa,KAAsD,CAAA;AAC/E,EAAA,OAAO,IAAI,WAAA,EAAY,CAAE,MAAA,CAAO,MAAM,IAAI,CAAA;AAC9C;AAEO,SAAS,aAAa,CAAA,EAA2B;AACpD,EAAA,OAAO,YAAYC,mBAAA,CAAUC,aAAA,CAAO,oBAAA,CAAqB,CAAC,CAAC,CAAC,CAAA;AAChE;AAEO,SAAS,gBAAA,CACZ,YAAA,EACA,QAAA,EACA,YAAA,EACA,gBACA,CAAA,EACM;AACN,EAAA,OAAOC,yBAAA,CAAgB;AAAA,IACnB,OAAA,EAAS,YAAA;AAAA,IACT,YAAA,EAAc,aAAa,CAAC,CAAA;AAAA,IAC5B,cAAA,EAAgB,oBAAA,CAAqB,CAAC,CAAA,CAAE,UAAA;AAAA,IACxC,YAAA,EAAc,gDAAA;AAAA,IACd,SAAA,EAAW,QAAA;AAAA,IACX,aAAA,EAAe,YAAA;AAAA,IACf,eAAA,EAAiB;AAAA,GACpB,CAAA;AACL;AAkBA,eAAsB,cAAc,KAAA,EAAoD;AACpF,EAAA,MAAM,iBACF,KAAA,CAAM,cAAA,IAAkB,CAAA,iBAAA,EAAoB,KAAA,CAAM,KAAK,IAAI,CAAA,CAAA,CAAA;AAE/D,EAAA,MAAM,WAAW,KAAA,CAAM,UAAA,CAAW,UAAU,EAAC,EAAG,IAAIC,oBAAU,CAAA;AAC9D,EAAA,MAAM,eAAA,GAAkBA,qBAAW,cAAc,CAAA;AACjD,EAAA,IAAI,CAAC,QAAQ,IAAA,CAAK,CAAC,MAAMC,oBAAA,CAAW,eAAA,EAAiB,CAAC,CAAC,CAAA,EAAG;AACtD,IAAA,MAAM,IAAI,KAAA;AAAA,MACN,mCAAmC,cAAc,CAAA,yCAAA;AAAA,KACrD;AAAA,EACJ;AAEA,EAAA,MAAM,KAAA,GAAQ,oBAAA,CAAqB,KAAA,CAAM,IAAI,CAAA;AAC7C,EAAA,OAAOC,uBAAA,CAAY;AAAA,IACf,OAAO,KAAA,CAAM,KAAA;AAAA,IACb,YAAY,KAAA,CAAM,UAAA;AAAA,IAClB,OAAA,EAAS,EAAE,IAAA,EAAM,YAAA,CAAa,MAAM,IAAI,CAAA,EAAG,MAAA,EAAQ,KAAA,CAAM,UAAA,EAAW;AAAA,IACpE,IAAA,EAAM,gDAAA;AAAA,IACN,cAAA;AAAA,IACA,UAAU,KAAA,CAAM;AAAA,GACnB,CAAA;AACL;AAmEO,SAAS,OACZ,KAAA,EAC6B;AAC7B,EAAA,OAAO;AAAA,IACH,MAAM,KAAA,CAAM,IAAA;AAAA,IACZ,YAAY,KAAA,CAAM,UAAA;AAAA,IAClB,aAAa,KAAA,CAAM,WAAA;AAAA,IACnB,OAAA,EAAS,OAAO,IAAA,EAAM,GAAA,KAAQ;AAC1B,MAAA,MAAM,IAAA,GAAuB;AAAA,QACzB,QAAQ,GAAA,CAAI,MAAA;AAAA,QACZ,MAAM,KAAA,CAAM,IAAA;AAAA,QACZ;AAAA,OACJ;AACA,MAAA,MAAM,MAAA,GAAS,MAAM,aAAA,CAAc;AAAA,QAC/B,OAAO,GAAA,CAAI,KAAA;AAAA,QACX,YAAY,GAAA,CAAI,UAAA;AAAA,QAChB;AAAA,OACH,CAAA;AACD,MAAA,MAAM,MAAA,GAAS,MAAM,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA;AACvC,MAAA,IAAI,MAAA,GAAkC,IAAA;AACtC,MAAA,IAAI,IAAI,OAAA,EAAS;AACb,QAAA,IAAI;AACA,UAAA,MAAA,GAAS,MAAM,mBAAA,CAAoB,MAAA,EAAQ,GAAA,CAAI,OAAO,CAAA;AAAA,QAC1D,SAAS,GAAA,EAAK;AAEV,UAAA,OAAA,CAAQ,KAAA,CAAM,iDAAiD,GAAG,CAAA;AAAA,QACtE;AAAA,MACJ;AACA,MAAA,OAAO,EAAE,MAAA,EAAQ,MAAA,EAAQ,MAAA,EAAO;AAAA,IACpC;AAAA,GACJ;AACJ;AA8BA,eAAsB,mBAAA,CAClB,QACA,MAAA,EACyB;AACzB,EAAA,MAAM,OAAA,GAAU,OAAO,OAAA,IAAW,yBAAA;AAClC,EAAA,MAAM,CAAA,GAAI,OAAO,KAAA,IAAS,KAAA;AAC1B,EAAA,MAAM,IAAA,GAAO;AAAA,IACT,YAAY,MAAA,CAAO,SAAA;AAAA,IACnB,eAAe,MAAA,CAAO,aAAA;AAAA,IACtB,aAAA,EAAe,OAAO,MAAA,CAAO,OAAA;AAAA,IAC7B,iBAAiB,MAAA,CAAO,eAAA;AAAA,IACxB,YAAA,EAAc,OAAO,OAAA,CAAQ,IAAA;AAAA,IAC7B,cAAA,EAAgB,OAAO,OAAA,CAAQ,MAAA;AAAA,IAC/B,YAAA,EAAc,OAAO,OAAA,CAAQ,IAAA;AAAA,IAC7B,WAAW,MAAA,CAAO,SAAA;AAAA,IAClB,SAAA,EAAW,OAAO,GAAA,CAAI,KAAA;AAAA,IACtB,IAAI,MAAA,CAAO;AAAA,GACf;AACA,EAAA,MAAM,CAAA,GAAI,MAAM,CAAA,CAAE,CAAA,EAAG,OAAO,CAAA,YAAA,CAAA,EAAgB;AAAA,IACxC,MAAA,EAAQ,MAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACL,cAAA,EAAgB,kBAAA;AAAA,MAChB,aAAA,EAAe,CAAA,OAAA,EAAU,MAAA,CAAO,QAAQ,CAAA;AAAA,KAC5C;AAAA,IACA,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,GAC5B,CAAA;AACD,EAAA,IAAI,CAAC,EAAE,EAAA,EAAI;AACP,IAAA,IAAI,MAAA,GAAS,CAAA,KAAA,EAAQ,CAAA,CAAE,MAAM,CAAA,CAAA;AAC7B,IAAA,IAAI;AACA,MAAA,MAAMC,EAAAA,GAAK,MAAM,CAAA,CAAE,IAAA,EAAK;AACxB,MAAA,IAAIA,EAAAA,CAAE,MAAA,EAAQ,MAAA,GAASA,EAAAA,CAAE,MAAA;AAAA,IAC7B,CAAA,CAAA,MAAQ;AAAA,IAER;AACA,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,4BAAA,EAA+B,MAAM,CAAA,CAAE,CAAA;AAAA,EAC3D;AACA,EAAA,MAAM,CAAA,GAAK,MAAM,CAAA,CAAE,IAAA,EAAK;AACxB,EAAA,OAAO,CAAA,CAAE,MAAA;AACb","file":"index.js","sourcesContent":["// @orangecheck/agent-vercel — wrap Vercel AI SDK `tool()` invocations in\n// OC Agent action envelopes.\n//\n// Provider-agnostic: the AI SDK is the abstraction layer. Whatever model\n// you use underneath (Anthropic, OpenAI, Cohere, …) the tool primitive is\n// the same {description, parameters, execute} shape. This adapter wraps\n// `execute` so every successful call produces a signed agent-action\n// envelope citing the active delegation.\n//\n// Two integration shapes:\n//\n//   1. ocTool({verb, parameters, execute})\n//      A drop-in replacement for `tool()`. The wrapped execute runs the\n//      scope check, signs the canonical (verb, args, callId) tuple,\n//      then runs your real handler.\n//\n//   2. stampToolCall(input)\n//      Lower-level stamping helper for cases where you have your own\n//      tool-execution loop and want to emit envelopes manually.\n//\n// The agent + delegation are passed via a per-request context object\n// (or threaded through closures) — we don't depend on AsyncLocalStorage\n// to keep edge-runtime compatibility maximal.\n\nimport { sha256 } from '@noble/hashes/sha256';\nimport {\n    canonicalize,\n    computeActionId,\n    hexEncode,\n    isSubScope,\n    parseScope,\n    type DelegationEnvelope,\n} from '@orangecheck/agent-core';\nimport {\n    signAsAgent,\n    type ActionEnvelope,\n    type SignerRef,\n} from '@orangecheck/agent-signer';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Canonicalization of a tool call\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface VercelToolCall {\n    /** Unique id assigned by the AI SDK for this tool invocation. */\n    callId: string;\n    /** Tool verb / name — passed in via ocTool() or set per-call by your wrapper. */\n    verb: string;\n    /** JSON-serializable arguments produced by the model. */\n    args: Record<string, unknown>;\n}\n\n/**\n * Produce the canonical bytes for a Vercel AI SDK tool call.\n *\n * Shape (RFC 8785 canonical JSON, then trailing LF):\n *   {\n *     \"args\":    <canonical JSON of args>,\n *     \"call_id\": <callId>,\n *     \"verb\":    <verb>\n *   }\n */\nexport function canonicalizeToolCall(c: VercelToolCall): Uint8Array {\n    const canon = {\n        args: c.args,\n        call_id: c.callId,\n        verb: c.verb,\n    };\n    const str = canonicalize(canon as unknown as Parameters<typeof canonicalize>[0]);\n    return new TextEncoder().encode(str + '\\n');\n}\n\nexport function toolCallHash(c: VercelToolCall): string {\n    return 'sha256:' + hexEncode(sha256(canonicalizeToolCall(c)));\n}\n\nexport function toolCallActionId(\n    agentAddress: string,\n    signedAt: string,\n    delegationId: string,\n    scopeExercised: string,\n    c: VercelToolCall\n): string {\n    return computeActionId({\n        address: agentAddress,\n        content_hash: toolCallHash(c),\n        content_length: canonicalizeToolCall(c).byteLength,\n        content_mime: 'application/vnd.oc-agent.vercel-tool-call+json',\n        signed_at: signedAt,\n        delegation_id: delegationId,\n        scope_exercised: scopeExercised,\n    });\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Stamping primitive\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface AgentContext {\n    agent: SignerRef;\n    delegation: DelegationEnvelope;\n}\n\nexport interface StampToolCallInput extends AgentContext {\n    call: VercelToolCall;\n    /** Defaults to `vercel:tool(verb=<verb>)` — the tightest admissible sub-scope. */\n    scopeExercised?: string;\n    signedAt?: Date;\n}\n\nexport async function stampToolCall(input: StampToolCallInput): Promise<ActionEnvelope> {\n    const scopeExercised =\n        input.scopeExercised ?? `vercel:tool(verb=${input.call.verb})`;\n\n    const granted = (input.delegation.scopes ?? []).map(parseScope);\n    const exercisedParsed = parseScope(scopeExercised);\n    if (!granted.some((g) => isSubScope(exercisedParsed, g))) {\n        throw new Error(\n            `stampToolCall: scope_exercised (${scopeExercised}) is not a sub-scope of any granted scope`\n        );\n    }\n\n    const bytes = canonicalizeToolCall(input.call);\n    return signAsAgent({\n        agent: input.agent,\n        delegation: input.delegation as never,\n        content: { hash: toolCallHash(input.call), length: bytes.byteLength },\n        mime: 'application/vnd.oc-agent.vercel-tool-call+json',\n        scopeExercised,\n        signedAt: input.signedAt,\n    });\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ocTool — drop-in tool() replacement\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface OcToolInput<TArgs extends Record<string, unknown>, TResult> {\n    /** OC Agent verb under which this tool is exercised. */\n    verb: string;\n    /** Pass-through to AI SDK's `tool()` — the JSON Schema for inputs. */\n    parameters?: unknown;\n    /** Pass-through description shown to the model. */\n    description?: string;\n    /** Your real handler. Returns whatever the tool returns. */\n    execute: (args: TArgs) => Promise<TResult>;\n}\n\nexport interface OcToolWrapped<TArgs extends Record<string, unknown>, TResult> {\n    verb: string;\n    parameters?: unknown;\n    description?: string;\n    /**\n     * The execute fn the AI SDK calls. Receives args + a callId (the AI\n     * SDK passes its own callId through — adapter glue passes it via\n     * context). Optional `console` field on the context tells the\n     * wrapper to fire-and-forget POST the stamped action to console.\n     * ochk.io/api/actions after the underlying execute() returns.\n     */\n    execute: (\n        args: TArgs,\n        ctx: AgentContext & { callId: string; console?: ConsoleClient }\n    ) => Promise<{\n        result: TResult;\n        action: ActionEnvelope;\n        posted: PostActionResult | null;\n    }>;\n}\n\n/**\n * Wrap a tool() definition so its execute path is scope-checked and\n * envelope-emitting. The exact glue depends on which AI-SDK release you're\n * on — the typical pattern is:\n *\n *   const tools = {\n *     'invoice.create': tool({\n *       description: '…',\n *       parameters:  schema,\n *       execute:     async (args, { toolCallId }) => {\n *         const { result, action } = await invoiceCreate.execute(args, {\n *           agent, delegation, callId: toolCallId,\n *         });\n *         await yourAuditPipeline.append(action);\n *         return result;\n *       },\n *     }),\n *   };\n *\n *   const invoiceCreate = ocTool({\n *     verb: 'invoice.create',\n *     parameters: schema,\n *     execute: async (args) => myInvoiceCreateImpl(args),\n *   });\n *\n * The `ocTool` value is provider/SDK-agnostic — bring your own glue around\n * it. v1 of the adapter intentionally does not import `ai` so it works on\n * any release.\n */\nexport function ocTool<TArgs extends Record<string, unknown>, TResult>(\n    input: OcToolInput<TArgs, TResult>\n): OcToolWrapped<TArgs, TResult> {\n    return {\n        verb: input.verb,\n        parameters: input.parameters,\n        description: input.description,\n        execute: async (args, ctx) => {\n            const call: VercelToolCall = {\n                callId: ctx.callId,\n                verb: input.verb,\n                args,\n            };\n            const action = await stampToolCall({\n                agent: ctx.agent,\n                delegation: ctx.delegation,\n                call,\n            });\n            const result = await input.execute(args);\n            let posted: PostActionResult | null = null;\n            if (ctx.console) {\n                try {\n                    posted = await postActionToConsole(action, ctx.console);\n                } catch (err) {\n                    // eslint-disable-next-line no-console\n                    console.error('[oc-agent-vercel] postActionToConsole failed:', err);\n                }\n            }\n            return { result, action, posted };\n        },\n    };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Console integration: POST stamped actions to console.ochk.io/api/actions\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface ConsoleClient {\n    /** Defaults to https://console.ochk.io. */\n    baseUrl?: string;\n    /** Bearer token from /settings § 03 (`ock_<hex>`). */\n    apiToken: string;\n    /** Project the action belongs to (proj_*). */\n    projectId: string;\n    /** Optional fetch override for runtimes that need it. */\n    fetch?: typeof fetch;\n}\n\nexport interface PostActionResult {\n    id: string;\n    project_id: string;\n    delegation_id: string;\n}\n\n/**\n * POST a stamped action envelope to console.ochk.io/api/actions. The\n * console re-derives the action id, validates agent-must-match-\n * delegation, persists, fans out to Nostr (kind 30084), submits to\n * OC Stamp, and triggers any subscribed webhooks. Throws on non-2xx\n * with the server's reason string.\n */\nexport async function postActionToConsole(\n    action: ActionEnvelope,\n    client: ConsoleClient\n): Promise<PostActionResult> {\n    const baseUrl = client.baseUrl ?? 'https://console.ochk.io';\n    const f = client.fetch ?? fetch;\n    const body = {\n        project_id: client.projectId,\n        delegation_id: action.delegation_id,\n        agent_address: action.signer.address,\n        scope_exercised: action.scope_exercised,\n        content_hash: action.content.hash,\n        content_length: action.content.length,\n        content_mime: action.content.mime,\n        signed_at: action.signed_at,\n        signature: action.sig.value,\n        id: action.id,\n    };\n    const r = await f(`${baseUrl}/api/actions`, {\n        method: 'POST',\n        headers: {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${client.apiToken}`,\n        },\n        body: JSON.stringify(body),\n    });\n    if (!r.ok) {\n        let reason = `http_${r.status}`;\n        try {\n            const j = (await r.json()) as { reason?: string };\n            if (j.reason) reason = j.reason;\n        } catch {\n            // body wasn't json\n        }\n        throw new Error(`postActionToConsole failed: ${reason}`);\n    }\n    const j = (await r.json()) as { ok: true; action: PostActionResult };\n    return j.action;\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,115 @@
+import { sha256 } from '@noble/hashes/sha256';
+import { canonicalize, hexEncode, computeActionId, parseScope, isSubScope } from '@orangecheck/agent-core';
+import { signAsAgent } from '@orangecheck/agent-signer';
+
+// src/index.ts
+function canonicalizeToolCall(c) {
+  const canon = {
+    args: c.args,
+    call_id: c.callId,
+    verb: c.verb
+  };
+  const str = canonicalize(canon);
+  return new TextEncoder().encode(str + "\n");
+}
+function toolCallHash(c) {
+  return "sha256:" + hexEncode(sha256(canonicalizeToolCall(c)));
+}
+function toolCallActionId(agentAddress, signedAt, delegationId, scopeExercised, c) {
+  return computeActionId({
+    address: agentAddress,
+    content_hash: toolCallHash(c),
+    content_length: canonicalizeToolCall(c).byteLength,
+    content_mime: "application/vnd.oc-agent.vercel-tool-call+json",
+    signed_at: signedAt,
+    delegation_id: delegationId,
+    scope_exercised: scopeExercised
+  });
+}
+async function stampToolCall(input) {
+  const scopeExercised = input.scopeExercised ?? `vercel:tool(verb=${input.call.verb})`;
+  const granted = (input.delegation.scopes ?? []).map(parseScope);
+  const exercisedParsed = parseScope(scopeExercised);
+  if (!granted.some((g) => isSubScope(exercisedParsed, g))) {
+    throw new Error(
+      `stampToolCall: scope_exercised (${scopeExercised}) is not a sub-scope of any granted scope`
+    );
+  }
+  const bytes = canonicalizeToolCall(input.call);
+  return signAsAgent({
+    agent: input.agent,
+    delegation: input.delegation,
+    content: { hash: toolCallHash(input.call), length: bytes.byteLength },
+    mime: "application/vnd.oc-agent.vercel-tool-call+json",
+    scopeExercised,
+    signedAt: input.signedAt
+  });
+}
+function ocTool(input) {
+  return {
+    verb: input.verb,
+    parameters: input.parameters,
+    description: input.description,
+    execute: async (args, ctx) => {
+      const call = {
+        callId: ctx.callId,
+        verb: input.verb,
+        args
+      };
+      const action = await stampToolCall({
+        agent: ctx.agent,
+        delegation: ctx.delegation,
+        call
+      });
+      const result = await input.execute(args);
+      let posted = null;
+      if (ctx.console) {
+        try {
+          posted = await postActionToConsole(action, ctx.console);
+        } catch (err) {
+          console.error("[oc-agent-vercel] postActionToConsole failed:", err);
+        }
+      }
+      return { result, action, posted };
+    }
+  };
+}
+async function postActionToConsole(action, client) {
+  const baseUrl = client.baseUrl ?? "https://console.ochk.io";
+  const f = client.fetch ?? fetch;
+  const body = {
+    project_id: client.projectId,
+    delegation_id: action.delegation_id,
+    agent_address: action.signer.address,
+    scope_exercised: action.scope_exercised,
+    content_hash: action.content.hash,
+    content_length: action.content.length,
+    content_mime: action.content.mime,
+    signed_at: action.signed_at,
+    signature: action.sig.value,
+    id: action.id
+  };
+  const r = await f(`${baseUrl}/api/actions`, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      Authorization: `Bearer ${client.apiToken}`
+    },
+    body: JSON.stringify(body)
+  });
+  if (!r.ok) {
+    let reason = `http_${r.status}`;
+    try {
+      const j2 = await r.json();
+      if (j2.reason) reason = j2.reason;
+    } catch {
+    }
+    throw new Error(`postActionToConsole failed: ${reason}`);
+  }
+  const j = await r.json();
+  return j.action;
+}
+
+export { canonicalizeToolCall, ocTool, postActionToConsole, stampToolCall, toolCallActionId, toolCallHash };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["j"],"mappings":"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","file":"index.mjs","sourcesContent":["// @orangecheck/agent-vercel — wrap Vercel AI SDK `tool()` invocations in\n// OC Agent action envelopes.\n//\n// Provider-agnostic: the AI SDK is the abstraction layer. Whatever model\n// you use underneath (Anthropic, OpenAI, Cohere, …) the tool primitive is\n// the same {description, parameters, execute} shape. This adapter wraps\n// `execute` so every successful call produces a signed agent-action\n// envelope citing the active delegation.\n//\n// Two integration shapes:\n//\n//   1. ocTool({verb, parameters, execute})\n//      A drop-in replacement for `tool()`. The wrapped execute runs the\n//      scope check, signs the canonical (verb, args, callId) tuple,\n//      then runs your real handler.\n//\n//   2. stampToolCall(input)\n//      Lower-level stamping helper for cases where you have your own\n//      tool-execution loop and want to emit envelopes manually.\n//\n// The agent + delegation are passed via a per-request context object\n// (or threaded through closures) — we don't depend on AsyncLocalStorage\n// to keep edge-runtime compatibility maximal.\n\nimport { sha256 } from '@noble/hashes/sha256';\nimport {\n    canonicalize,\n    computeActionId,\n    hexEncode,\n    isSubScope,\n    parseScope,\n    type DelegationEnvelope,\n} from '@orangecheck/agent-core';\nimport {\n    signAsAgent,\n    type ActionEnvelope,\n    type SignerRef,\n} from '@orangecheck/agent-signer';\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Canonicalization of a tool call\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface VercelToolCall {\n    /** Unique id assigned by the AI SDK for this tool invocation. */\n    callId: string;\n    /** Tool verb / name — passed in via ocTool() or set per-call by your wrapper. */\n    verb: string;\n    /** JSON-serializable arguments produced by the model. */\n    args: Record<string, unknown>;\n}\n\n/**\n * Produce the canonical bytes for a Vercel AI SDK tool call.\n *\n * Shape (RFC 8785 canonical JSON, then trailing LF):\n *   {\n *     \"args\":    <canonical JSON of args>,\n *     \"call_id\": <callId>,\n *     \"verb\":    <verb>\n *   }\n */\nexport function canonicalizeToolCall(c: VercelToolCall): Uint8Array {\n    const canon = {\n        args: c.args,\n        call_id: c.callId,\n        verb: c.verb,\n    };\n    const str = canonicalize(canon as unknown as Parameters<typeof canonicalize>[0]);\n    return new TextEncoder().encode(str + '\\n');\n}\n\nexport function toolCallHash(c: VercelToolCall): string {\n    return 'sha256:' + hexEncode(sha256(canonicalizeToolCall(c)));\n}\n\nexport function toolCallActionId(\n    agentAddress: string,\n    signedAt: string,\n    delegationId: string,\n    scopeExercised: string,\n    c: VercelToolCall\n): string {\n    return computeActionId({\n        address: agentAddress,\n        content_hash: toolCallHash(c),\n        content_length: canonicalizeToolCall(c).byteLength,\n        content_mime: 'application/vnd.oc-agent.vercel-tool-call+json',\n        signed_at: signedAt,\n        delegation_id: delegationId,\n        scope_exercised: scopeExercised,\n    });\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Stamping primitive\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface AgentContext {\n    agent: SignerRef;\n    delegation: DelegationEnvelope;\n}\n\nexport interface StampToolCallInput extends AgentContext {\n    call: VercelToolCall;\n    /** Defaults to `vercel:tool(verb=<verb>)` — the tightest admissible sub-scope. */\n    scopeExercised?: string;\n    signedAt?: Date;\n}\n\nexport async function stampToolCall(input: StampToolCallInput): Promise<ActionEnvelope> {\n    const scopeExercised =\n        input.scopeExercised ?? `vercel:tool(verb=${input.call.verb})`;\n\n    const granted = (input.delegation.scopes ?? []).map(parseScope);\n    const exercisedParsed = parseScope(scopeExercised);\n    if (!granted.some((g) => isSubScope(exercisedParsed, g))) {\n        throw new Error(\n            `stampToolCall: scope_exercised (${scopeExercised}) is not a sub-scope of any granted scope`\n        );\n    }\n\n    const bytes = canonicalizeToolCall(input.call);\n    return signAsAgent({\n        agent: input.agent,\n        delegation: input.delegation as never,\n        content: { hash: toolCallHash(input.call), length: bytes.byteLength },\n        mime: 'application/vnd.oc-agent.vercel-tool-call+json',\n        scopeExercised,\n        signedAt: input.signedAt,\n    });\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// ocTool — drop-in tool() replacement\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface OcToolInput<TArgs extends Record<string, unknown>, TResult> {\n    /** OC Agent verb under which this tool is exercised. */\n    verb: string;\n    /** Pass-through to AI SDK's `tool()` — the JSON Schema for inputs. */\n    parameters?: unknown;\n    /** Pass-through description shown to the model. */\n    description?: string;\n    /** Your real handler. Returns whatever the tool returns. */\n    execute: (args: TArgs) => Promise<TResult>;\n}\n\nexport interface OcToolWrapped<TArgs extends Record<string, unknown>, TResult> {\n    verb: string;\n    parameters?: unknown;\n    description?: string;\n    /**\n     * The execute fn the AI SDK calls. Receives args + a callId (the AI\n     * SDK passes its own callId through — adapter glue passes it via\n     * context). Optional `console` field on the context tells the\n     * wrapper to fire-and-forget POST the stamped action to console.\n     * ochk.io/api/actions after the underlying execute() returns.\n     */\n    execute: (\n        args: TArgs,\n        ctx: AgentContext & { callId: string; console?: ConsoleClient }\n    ) => Promise<{\n        result: TResult;\n        action: ActionEnvelope;\n        posted: PostActionResult | null;\n    }>;\n}\n\n/**\n * Wrap a tool() definition so its execute path is scope-checked and\n * envelope-emitting. The exact glue depends on which AI-SDK release you're\n * on — the typical pattern is:\n *\n *   const tools = {\n *     'invoice.create': tool({\n *       description: '…',\n *       parameters:  schema,\n *       execute:     async (args, { toolCallId }) => {\n *         const { result, action } = await invoiceCreate.execute(args, {\n *           agent, delegation, callId: toolCallId,\n *         });\n *         await yourAuditPipeline.append(action);\n *         return result;\n *       },\n *     }),\n *   };\n *\n *   const invoiceCreate = ocTool({\n *     verb: 'invoice.create',\n *     parameters: schema,\n *     execute: async (args) => myInvoiceCreateImpl(args),\n *   });\n *\n * The `ocTool` value is provider/SDK-agnostic — bring your own glue around\n * it. v1 of the adapter intentionally does not import `ai` so it works on\n * any release.\n */\nexport function ocTool<TArgs extends Record<string, unknown>, TResult>(\n    input: OcToolInput<TArgs, TResult>\n): OcToolWrapped<TArgs, TResult> {\n    return {\n        verb: input.verb,\n        parameters: input.parameters,\n        description: input.description,\n        execute: async (args, ctx) => {\n            const call: VercelToolCall = {\n                callId: ctx.callId,\n                verb: input.verb,\n                args,\n            };\n            const action = await stampToolCall({\n                agent: ctx.agent,\n                delegation: ctx.delegation,\n                call,\n            });\n            const result = await input.execute(args);\n            let posted: PostActionResult | null = null;\n            if (ctx.console) {\n                try {\n                    posted = await postActionToConsole(action, ctx.console);\n                } catch (err) {\n                    // eslint-disable-next-line no-console\n                    console.error('[oc-agent-vercel] postActionToConsole failed:', err);\n                }\n            }\n            return { result, action, posted };\n        },\n    };\n}\n\n// ─────────────────────────────────────────────────────────────────────────────\n// Console integration: POST stamped actions to console.ochk.io/api/actions\n// ─────────────────────────────────────────────────────────────────────────────\n\nexport interface ConsoleClient {\n    /** Defaults to https://console.ochk.io. */\n    baseUrl?: string;\n    /** Bearer token from /settings § 03 (`ock_<hex>`). */\n    apiToken: string;\n    /** Project the action belongs to (proj_*). */\n    projectId: string;\n    /** Optional fetch override for runtimes that need it. */\n    fetch?: typeof fetch;\n}\n\nexport interface PostActionResult {\n    id: string;\n    project_id: string;\n    delegation_id: string;\n}\n\n/**\n * POST a stamped action envelope to console.ochk.io/api/actions. The\n * console re-derives the action id, validates agent-must-match-\n * delegation, persists, fans out to Nostr (kind 30084), submits to\n * OC Stamp, and triggers any subscribed webhooks. Throws on non-2xx\n * with the server's reason string.\n */\nexport async function postActionToConsole(\n    action: ActionEnvelope,\n    client: ConsoleClient\n): Promise<PostActionResult> {\n    const baseUrl = client.baseUrl ?? 'https://console.ochk.io';\n    const f = client.fetch ?? fetch;\n    const body = {\n        project_id: client.projectId,\n        delegation_id: action.delegation_id,\n        agent_address: action.signer.address,\n        scope_exercised: action.scope_exercised,\n        content_hash: action.content.hash,\n        content_length: action.content.length,\n        content_mime: action.content.mime,\n        signed_at: action.signed_at,\n        signature: action.sig.value,\n        id: action.id,\n    };\n    const r = await f(`${baseUrl}/api/actions`, {\n        method: 'POST',\n        headers: {\n            'Content-Type': 'application/json',\n            Authorization: `Bearer ${client.apiToken}`,\n        },\n        body: JSON.stringify(body),\n    });\n    if (!r.ok) {\n        let reason = `http_${r.status}`;\n        try {\n            const j = (await r.json()) as { reason?: string };\n            if (j.reason) reason = j.reason;\n        } catch {\n            // body wasn't json\n        }\n        throw new Error(`postActionToConsole failed: ${reason}`);\n    }\n    const j = (await r.json()) as { ok: true; action: PostActionResult };\n    return j.action;\n}\n"]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@orangecheck/agent-vercel",
+  "version": "0.1.0",
+  "description": "Wrap Vercel AI SDK tool() invocations with OC Agent scope enforcement and emit a signed agent-action envelope per tool execution. Provider-agnostic — works under Anthropic, OpenAI, Cohere, etc.",
+  "keywords": [
+    "bitcoin",
+    "agent",
+    "authority",
+    "vercel",
+    "ai-sdk",
+    "tool-calls",
+    "bip322",
+    "oc-agent",
+    "orangecheck"
+  ],
+  "author": "OrangeCheck",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/orangecheck/oc-packages.git",
+    "directory": "agent-vercel"
+  },
+  "homepage": "https://github.com/orangecheck/oc-agent-protocol",
+  "bugs": {
+    "url": "https://github.com/orangecheck/oc-agent-protocol/issues"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@noble/hashes": "^1.5.0",
+    "@orangecheck/agent-core": "^0.3.0",
+    "@orangecheck/agent-signer": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.test.ts

@@ -0,0 +1,44 @@
+import { describe, expect, it } from 'vitest';
+
+import { canonicalizeToolCall, toolCallHash, ocTool } from './index.js';
+
+describe('canonicalizeToolCall', () => {
+    it('produces byte-identical output for identical inputs (key reorder)', () => {
+        const a = canonicalizeToolCall({
+            callId: 'tc_1',
+            verb: 'invoice.create',
+            args: { customer: 'acme', amount: 14.2 },
+        });
+        const b = canonicalizeToolCall({
+            verb: 'invoice.create',
+            callId: 'tc_1',
+            args: { amount: 14.2, customer: 'acme' },
+        });
+        expect(a).toEqual(b);
+    });
+
+    it('changes when verb changes', () => {
+        const a = toolCallHash({ callId: 't', verb: 'a', args: {} });
+        const b = toolCallHash({ callId: 't', verb: 'b', args: {} });
+        expect(a).not.toBe(b);
+    });
+
+    it('changes when call id changes', () => {
+        const a = toolCallHash({ callId: 'a', verb: 'x', args: {} });
+        const b = toolCallHash({ callId: 'b', verb: 'x', args: {} });
+        expect(a).not.toBe(b);
+    });
+});
+
+describe('ocTool', () => {
+    it('returns a wrapped tool with the right metadata', () => {
+        const t = ocTool({
+            verb: 'invoice.create',
+            description: 'create',
+            parameters: {} as unknown,
+            execute: async () => 'ok',
+        });
+        expect(t.verb).toBe('invoice.create');
+        expect(t.description).toBe('create');
+    });
+});

package/src/index.ts

@@ -0,0 +1,298 @@
+// @orangecheck/agent-vercel — wrap Vercel AI SDK `tool()` invocations in
+// OC Agent action envelopes.
+//
+// Provider-agnostic: the AI SDK is the abstraction layer. Whatever model
+// you use underneath (Anthropic, OpenAI, Cohere, …) the tool primitive is
+// the same {description, parameters, execute} shape. This adapter wraps
+// `execute` so every successful call produces a signed agent-action
+// envelope citing the active delegation.
+//
+// Two integration shapes:
+//
+//   1. ocTool({verb, parameters, execute})
+//      A drop-in replacement for `tool()`. The wrapped execute runs the
+//      scope check, signs the canonical (verb, args, callId) tuple,
+//      then runs your real handler.
+//
+//   2. stampToolCall(input)
+//      Lower-level stamping helper for cases where you have your own
+//      tool-execution loop and want to emit envelopes manually.
+//
+// The agent + delegation are passed via a per-request context object
+// (or threaded through closures) — we don't depend on AsyncLocalStorage
+// to keep edge-runtime compatibility maximal.
+
+import { sha256 } from '@noble/hashes/sha256';
+import {
+    canonicalize,
+    computeActionId,
+    hexEncode,
+    isSubScope,
+    parseScope,
+    type DelegationEnvelope,
+} from '@orangecheck/agent-core';
+import {
+    signAsAgent,
+    type ActionEnvelope,
+    type SignerRef,
+} from '@orangecheck/agent-signer';
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Canonicalization of a tool call
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface VercelToolCall {
+    /** Unique id assigned by the AI SDK for this tool invocation. */
+    callId: string;
+    /** Tool verb / name — passed in via ocTool() or set per-call by your wrapper. */
+    verb: string;
+    /** JSON-serializable arguments produced by the model. */
+    args: Record<string, unknown>;
+}
+
+/**
+ * Produce the canonical bytes for a Vercel AI SDK tool call.
+ *
+ * Shape (RFC 8785 canonical JSON, then trailing LF):
+ *   {
+ *     "args":    <canonical JSON of args>,
+ *     "call_id": <callId>,
+ *     "verb":    <verb>
+ *   }
+ */
+export function canonicalizeToolCall(c: VercelToolCall): Uint8Array {
+    const canon = {
+        args: c.args,
+        call_id: c.callId,
+        verb: c.verb,
+    };
+    const str = canonicalize(canon as unknown as Parameters<typeof canonicalize>[0]);
+    return new TextEncoder().encode(str + '\n');
+}
+
+export function toolCallHash(c: VercelToolCall): string {
+    return 'sha256:' + hexEncode(sha256(canonicalizeToolCall(c)));
+}
+
+export function toolCallActionId(
+    agentAddress: string,
+    signedAt: string,
+    delegationId: string,
+    scopeExercised: string,
+    c: VercelToolCall
+): string {
+    return computeActionId({
+        address: agentAddress,
+        content_hash: toolCallHash(c),
+        content_length: canonicalizeToolCall(c).byteLength,
+        content_mime: 'application/vnd.oc-agent.vercel-tool-call+json',
+        signed_at: signedAt,
+        delegation_id: delegationId,
+        scope_exercised: scopeExercised,
+    });
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Stamping primitive
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface AgentContext {
+    agent: SignerRef;
+    delegation: DelegationEnvelope;
+}
+
+export interface StampToolCallInput extends AgentContext {
+    call: VercelToolCall;
+    /** Defaults to `vercel:tool(verb=<verb>)` — the tightest admissible sub-scope. */
+    scopeExercised?: string;
+    signedAt?: Date;
+}
+
+export async function stampToolCall(input: StampToolCallInput): Promise<ActionEnvelope> {
+    const scopeExercised =
+        input.scopeExercised ?? `vercel:tool(verb=${input.call.verb})`;
+
+    const granted = (input.delegation.scopes ?? []).map(parseScope);
+    const exercisedParsed = parseScope(scopeExercised);
+    if (!granted.some((g) => isSubScope(exercisedParsed, g))) {
+        throw new Error(
+            `stampToolCall: scope_exercised (${scopeExercised}) is not a sub-scope of any granted scope`
+        );
+    }
+
+    const bytes = canonicalizeToolCall(input.call);
+    return signAsAgent({
+        agent: input.agent,
+        delegation: input.delegation as never,
+        content: { hash: toolCallHash(input.call), length: bytes.byteLength },
+        mime: 'application/vnd.oc-agent.vercel-tool-call+json',
+        scopeExercised,
+        signedAt: input.signedAt,
+    });
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// ocTool — drop-in tool() replacement
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface OcToolInput<TArgs extends Record<string, unknown>, TResult> {
+    /** OC Agent verb under which this tool is exercised. */
+    verb: string;
+    /** Pass-through to AI SDK's `tool()` — the JSON Schema for inputs. */
+    parameters?: unknown;
+    /** Pass-through description shown to the model. */
+    description?: string;
+    /** Your real handler. Returns whatever the tool returns. */
+    execute: (args: TArgs) => Promise<TResult>;
+}
+
+export interface OcToolWrapped<TArgs extends Record<string, unknown>, TResult> {
+    verb: string;
+    parameters?: unknown;
+    description?: string;
+    /**
+     * The execute fn the AI SDK calls. Receives args + a callId (the AI
+     * SDK passes its own callId through — adapter glue passes it via
+     * context). Optional `console` field on the context tells the
+     * wrapper to fire-and-forget POST the stamped action to console.
+     * ochk.io/api/actions after the underlying execute() returns.
+     */
+    execute: (
+        args: TArgs,
+        ctx: AgentContext & { callId: string; console?: ConsoleClient }
+    ) => Promise<{
+        result: TResult;
+        action: ActionEnvelope;
+        posted: PostActionResult | null;
+    }>;
+}
+
+/**
+ * Wrap a tool() definition so its execute path is scope-checked and
+ * envelope-emitting. The exact glue depends on which AI-SDK release you're
+ * on — the typical pattern is:
+ *
+ *   const tools = {
+ *     'invoice.create': tool({
+ *       description: '…',
+ *       parameters:  schema,
+ *       execute:     async (args, { toolCallId }) => {
+ *         const { result, action } = await invoiceCreate.execute(args, {
+ *           agent, delegation, callId: toolCallId,
+ *         });
+ *         await yourAuditPipeline.append(action);
+ *         return result;
+ *       },
+ *     }),
+ *   };
+ *
+ *   const invoiceCreate = ocTool({
+ *     verb: 'invoice.create',
+ *     parameters: schema,
+ *     execute: async (args) => myInvoiceCreateImpl(args),
+ *   });
+ *
+ * The `ocTool` value is provider/SDK-agnostic — bring your own glue around
+ * it. v1 of the adapter intentionally does not import `ai` so it works on
+ * any release.
+ */
+export function ocTool<TArgs extends Record<string, unknown>, TResult>(
+    input: OcToolInput<TArgs, TResult>
+): OcToolWrapped<TArgs, TResult> {
+    return {
+        verb: input.verb,
+        parameters: input.parameters,
+        description: input.description,
+        execute: async (args, ctx) => {
+            const call: VercelToolCall = {
+                callId: ctx.callId,
+                verb: input.verb,
+                args,
+            };
+            const action = await stampToolCall({
+                agent: ctx.agent,
+                delegation: ctx.delegation,
+                call,
+            });
+            const result = await input.execute(args);
+            let posted: PostActionResult | null = null;
+            if (ctx.console) {
+                try {
+                    posted = await postActionToConsole(action, ctx.console);
+                } catch (err) {
+                    // eslint-disable-next-line no-console
+                    console.error('[oc-agent-vercel] postActionToConsole failed:', err);
+                }
+            }
+            return { result, action, posted };
+        },
+    };
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Console integration: POST stamped actions to console.ochk.io/api/actions
+// ─────────────────────────────────────────────────────────────────────────────
+
+export interface ConsoleClient {
+    /** Defaults to https://console.ochk.io. */
+    baseUrl?: string;
+    /** Bearer token from /settings § 03 (`ock_<hex>`). */
+    apiToken: string;
+    /** Project the action belongs to (proj_*). */
+    projectId: string;
+    /** Optional fetch override for runtimes that need it. */
+    fetch?: typeof fetch;
+}
+
+export interface PostActionResult {
+    id: string;
+    project_id: string;
+    delegation_id: string;
+}
+
+/**
+ * POST a stamped action envelope to console.ochk.io/api/actions. The
+ * console re-derives the action id, validates agent-must-match-
+ * delegation, persists, fans out to Nostr (kind 30084), submits to
+ * OC Stamp, and triggers any subscribed webhooks. Throws on non-2xx
+ * with the server's reason string.
+ */
+export async function postActionToConsole(
+    action: ActionEnvelope,
+    client: ConsoleClient
+): Promise<PostActionResult> {
+    const baseUrl = client.baseUrl ?? 'https://console.ochk.io';
+    const f = client.fetch ?? fetch;
+    const body = {
+        project_id: client.projectId,
+        delegation_id: action.delegation_id,
+        agent_address: action.signer.address,
+        scope_exercised: action.scope_exercised,
+        content_hash: action.content.hash,
+        content_length: action.content.length,
+        content_mime: action.content.mime,
+        signed_at: action.signed_at,
+        signature: action.sig.value,
+        id: action.id,
+    };
+    const r = await f(`${baseUrl}/api/actions`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${client.apiToken}`,
+        },
+        body: JSON.stringify(body),
+    });
+    if (!r.ok) {
+        let reason = `http_${r.status}`;
+        try {
+            const j = (await r.json()) as { reason?: string };
+            if (j.reason) reason = j.reason;
+        } catch {
+            // body wasn't json
+        }
+        throw new Error(`postActionToConsole failed: ${reason}`);
+    }
+    const j = (await r.json()) as { ok: true; action: PostActionResult };
+    return j.action;
+}