@zmdb/ai-vercel 1.0.0-beta.1

package/LICENSE

@@ -0,0 +1,10 @@
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+@zmdb/ai-vercel is free software licensed under the GNU General Public License,
+version 3 or (at your option) any later version.
+
+The complete license text is published by the Free Software Foundation at:
+https://www.gnu.org/licenses/gpl-3.0.txt
+
+SPDX-License-Identifier: GPL-3.0-or-later

package/README.md

@@ -0,0 +1,47 @@
+# @zmdb/ai-vercel
+
+`@zmdb/ai-vercel` adapts a provider-neutral zmdb tool document to the Vercel AI SDK's branded `inputSchema` contract. The application supplies its installed SDK's `jsonSchema` factory, so this package
+neither imports the SDK at runtime nor fabricates its schema brand with a cast.
+
+## Install
+
+```bash
+yarn add @zmdb/ai @zmdb/ai-vercel ai@^7.0.93
+```
+
+> **Prerelease** (`1.0.0-beta.1`). Requires **Node.js 26+** and is **ESM-only**. The supported and tested peer floor is exact AI SDK `7.0.93`.
+
+## Usage
+
+```ts
+import { jsonSchema, tool } from 'ai';
+import { aiSdkTool } from '@zmdb/ai-vercel';
+
+const createUser = tool(
+  aiSdkTool('create_user', users, {
+    jsonSchema,
+    description: 'Create a user',
+    validate: input => assert<CreateDTO<User>>(input),
+    execute: async dto => ({ email: dto.email }),
+  }),
+);
+```
+
+`validate` runs before `execute`. Validation failures become bounded, value-free tool-result text that a model can correct; handler and infrastructure errors still throw.
+
+## Public API
+
+- `aiSdkTool`
+- `AiSdkToolFields`
+- `AiSdkToolOptions`
+- `ToolAdapterOptions`
+
+The package depends only on `@zmdb/ai`. `ai` is an optional peer because the package returns a structural tool object and receives the branded factory from the caller.
+
+## Non-goals
+
+This package does not own model clients, provider packages, streaming UI state, persistence, `useChat`, or a runtime schema library.
+
+## License
+
+GNU General Public License v3.0 or later (GPL-3.0-or-later) — see [LICENSE](./LICENSE).

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { type ToolSchema } from '@zmdb/ai';
+import { type ToolAdapterOptions } from '@zmdb/ai/tool-runtime';
+export interface AiSdkToolOptions<T, Output, Schema> extends ToolAdapterOptions<T, Output> {
+    /**
+     * The AI SDK's branded `jsonSchema` factory. Injecting it keeps the brand
+     * owned by the installed peer and avoids a cast or a runtime schema library.
+     */
+    readonly jsonSchema: (schema: unknown) => Schema;
+}
+/** The fields accepted by the AI SDK's `tool(...)` helper. */
+export interface AiSdkToolFields<Schema, Output> {
+    readonly description: string;
+    readonly inputSchema: Schema;
+    readonly execute: (input: unknown) => Promise<Output | string>;
+}
+export declare function aiSdkTool<T, Output, Schema>(name: string, schema: ToolSchema, options: AiSdkToolOptions<T, Output, Schema>): AiSdkToolFields<Schema, Output>;
+export type { ToolAdapterOptions } from '@zmdb/ai/tool-runtime';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,MAAM,WAAW,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAE,SAAQ,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC;IACxF;;;OAGG;IACH,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,MAAM,CAAC;CAClD;AAED,8DAA8D;AAC9D,MAAM,WAAW,eAAe,CAAC,MAAM,EAAE,MAAM;IAC7C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;CAChE;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EACzC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAC3C,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CASjC;AAED,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+import { toolFromSchema } from '@zmdb/ai';
+import { executeToolAdapter } from '@zmdb/ai/tool-runtime';
+export function aiSdkTool(name, schema, options) {
+    const inputSchema = options.jsonSchema(toolFromSchema(name, schema).parameters);
+    return {
+        description: options.description,
+        inputSchema,
+        async execute(input) {
+            return executeToolAdapter(name, input, options);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAmB,MAAM,UAAU,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAA2B,MAAM,uBAAuB,CAAC;AAiBpF,MAAM,UAAU,SAAS,CACvB,IAAY,EACZ,MAAkB,EAClB,OAA4C;IAE5C,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;IAChF,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,WAAW;QACX,KAAK,CAAC,OAAO,CAAC,KAAK;YACjB,OAAO,kBAAkB,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@zmdb/ai-vercel",
+  "version": "1.0.0-beta.1",
+  "description": "Vercel AI SDK tool integration for provider-neutral zmdb AI contracts.",
+  "keywords": [
+    "ai",
+    "function-calling",
+    "typescript",
+    "vercel",
+    "zmdb"
+  ],
+  "homepage": "https://github.com/ambasta/zmdb#readme",
+  "bugs": {
+    "url": "https://github.com/ambasta/zmdb/issues"
+  },
+  "license": "GPL-3.0-or-later",
+  "author": "zmdb contributors",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ambasta/zmdb.git",
+    "directory": "packages/ai-vercel"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "scripts": {
+    "build": "node ../../scripts/build-package.mjs",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@zmdb/ai": "1.0.0-beta.1"
+  },
+  "peerDependencies": {
+    "ai": "^7.0.93"
+  },
+  "peerDependenciesMeta": {
+    "ai": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=26"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts"
+}

package/src/index.ts

@@ -0,0 +1,34 @@
+import { toolFromSchema, type ToolSchema } from '@zmdb/ai';
+import { executeToolAdapter, type ToolAdapterOptions } from '@zmdb/ai/tool-runtime';
+
+export interface AiSdkToolOptions<T, Output, Schema> extends ToolAdapterOptions<T, Output> {
+  /**
+   * The AI SDK's branded `jsonSchema` factory. Injecting it keeps the brand
+   * owned by the installed peer and avoids a cast or a runtime schema library.
+   */
+  readonly jsonSchema: (schema: unknown) => Schema;
+}
+
+/** The fields accepted by the AI SDK's `tool(...)` helper. */
+export interface AiSdkToolFields<Schema, Output> {
+  readonly description: string;
+  readonly inputSchema: Schema;
+  readonly execute: (input: unknown) => Promise<Output | string>;
+}
+
+export function aiSdkTool<T, Output, Schema>(
+  name: string,
+  schema: ToolSchema,
+  options: AiSdkToolOptions<T, Output, Schema>,
+): AiSdkToolFields<Schema, Output> {
+  const inputSchema = options.jsonSchema(toolFromSchema(name, schema).parameters);
+  return {
+    description: options.description,
+    inputSchema,
+    async execute(input) {
+      return executeToolAdapter(name, input, options);
+    },
+  };
+}
+
+export type { ToolAdapterOptions } from '@zmdb/ai/tool-runtime';