@aerostack/sdk-vercel-ai 0.10.1

package/README.md

@@ -0,0 +1,69 @@
+# @aerostack/sdk-vercel-ai
+
+Use [Aerostack](https://aerostack.dev) workspace tools with the [Vercel AI SDK](https://sdk.vercel.ai/).
+
+## Install
+
+```bash
+npm install @aerostack/sdk-vercel-ai ai
+```
+
+## Quick Start
+
+```typescript
+import { openai } from '@ai-sdk/openai';
+import { generateText } from 'ai';
+import { getTools } from '@aerostack/sdk-vercel-ai';
+
+const { tools } = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+
+const { text } = await generateText({
+    model: openai('gpt-4o'),
+    tools,
+    maxSteps: 5,
+    prompt: 'Create a GitHub issue for the login bug',
+});
+```
+
+## Streaming
+
+```typescript
+import { streamText } from 'ai';
+
+const { tools } = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+
+const result = streamText({
+    model: openai('gpt-4o'),
+    tools,
+    maxSteps: 10,
+    prompt: 'Summarize Notion pages and post to Slack',
+});
+
+for await (const chunk of result.textStream) {
+    process.stdout.write(chunk);
+}
+```
+
+## Factory Pattern
+
+```typescript
+import { createAerostackVercelAI } from '@aerostack/sdk-vercel-ai';
+
+const aero = createAerostackVercelAI({ workspace: 'my-workspace', token: 'mwt_...' });
+const { tools } = await aero.tools();
+```
+
+## API
+
+### `getTools(config)` → `Promise<ToolSetResult>`
+
+Fetches tools from the workspace. Each tool includes an `execute` function that calls the workspace gateway. Returns `{ tools, raw }`.
+
+### `createAerostackVercelAI(config)` → `AerostackVercelAIClient`
+
+Creates a reusable client that shares a single WorkspaceClient instance.
+
+## Requirements
+
+- `ai` >= 3.0.0
+- An Aerostack workspace with a token (`mwt_...`)

package/dist/commonjs/__tests__/converter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=converter.test.d.ts.map

package/dist/commonjs/__tests__/converter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/converter.test.ts"],"names":[],"mappings":""}

package/dist/commonjs/__tests__/converter.test.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const converter_js_1 = require("../converter.js");
+function mockClient(callToolResult, shouldThrow = false) {
+    return {
+        callTool: shouldThrow
+            ? vitest_1.vi.fn().mockRejectedValue(callToolResult)
+            : vitest_1.vi.fn().mockResolvedValue(callToolResult),
+    };
+}
+(0, vitest_1.describe)('convertTools', () => {
+    (0, vitest_1.it)('converts MCP tools to Vercel AI SDK ToolSet', () => {
+        const mcpTools = [
+            {
+                name: 'github__create_issue',
+                description: 'Create a GitHub issue',
+                inputSchema: {
+                    type: 'object',
+                    properties: { title: { type: 'string' } },
+                    required: ['title'],
+                },
+            },
+            {
+                name: 'slack__post_message',
+                description: 'Post to Slack',
+                inputSchema: {
+                    type: 'object',
+                    properties: { channel: { type: 'string' }, text: { type: 'string' } },
+                },
+            },
+        ];
+        const client = mockClient({});
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        (0, vitest_1.expect)(Object.keys(tools)).toEqual(['github__create_issue', 'slack__post_message']);
+        (0, vitest_1.expect)(tools['github__create_issue']).toBeDefined();
+        (0, vitest_1.expect)(tools['slack__post_message']).toBeDefined();
+    });
+    (0, vitest_1.it)('handles tools with no inputSchema', () => {
+        const mcpTools = [
+            { name: 'ping', description: 'Ping the server' },
+        ];
+        const client = mockClient({});
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        (0, vitest_1.expect)(tools['ping']).toBeDefined();
+    });
+    (0, vitest_1.it)('handles tools with no description', () => {
+        const mcpTools = [
+            { name: 'my_tool', inputSchema: { type: 'object', properties: {} } },
+        ];
+        const client = mockClient({});
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        (0, vitest_1.expect)(tools['my_tool']).toBeDefined();
+    });
+    (0, vitest_1.it)('skips tools with empty names', () => {
+        const mcpTools = [
+            { name: '', description: 'Bad tool' },
+            { name: 'good_tool', description: 'Good tool' },
+        ];
+        const client = mockClient({});
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        (0, vitest_1.expect)(Object.keys(tools)).toEqual(['good_tool']);
+    });
+    (0, vitest_1.it)('handles empty tools array', () => {
+        const client = mockClient({});
+        const tools = (0, converter_js_1.convertTools)([], client);
+        (0, vitest_1.expect)(Object.keys(tools)).toEqual([]);
+    });
+    (0, vitest_1.it)('execute function calls WorkspaceClient.callTool', async () => {
+        const mcpTools = [
+            {
+                name: 'test_tool',
+                description: 'Test',
+                inputSchema: { type: 'object', properties: { x: { type: 'number' } } },
+            },
+        ];
+        const client = mockClient({
+            content: [{ type: 'text', text: 'result123' }],
+        });
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        const result = await tools['test_tool'].execute({ x: 42 }, { toolCallId: 'tc_1', messages: [], abortSignal: new AbortController().signal });
+        (0, vitest_1.expect)(client.callTool).toHaveBeenCalledWith('test_tool', { x: 42 });
+        (0, vitest_1.expect)(result).toBe('result123');
+    });
+    (0, vitest_1.it)('execute function handles AerostackError gracefully', async () => {
+        const { AerostackError } = await import('@aerostack/core');
+        const err = new AerostackError('Server down', 503, -32603, 'req-1');
+        const client = mockClient(err, true);
+        const mcpTools = [
+            { name: 'failing_tool', description: 'Fails' },
+        ];
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        const result = await tools['failing_tool'].execute({}, { toolCallId: 'tc_1', messages: [], abortSignal: new AbortController().signal });
+        (0, vitest_1.expect)(result).toContain('Error (-32603)');
+        (0, vitest_1.expect)(result).toContain('Server down');
+    });
+    (0, vitest_1.it)('execute function handles generic errors', async () => {
+        const client = mockClient(new Error('Network timeout'), true);
+        const mcpTools = [
+            { name: 'timeout_tool', description: 'Timeouts' },
+        ];
+        const tools = (0, converter_js_1.convertTools)(mcpTools, client);
+        const result = await tools['timeout_tool'].execute({}, { toolCallId: 'tc_1', messages: [], abortSignal: new AbortController().signal });
+        (0, vitest_1.expect)(result).toBe('Error: Network timeout');
+    });
+});
+(0, vitest_1.describe)('formatToolResult', () => {
+    (0, vitest_1.it)('formats single text content', () => {
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({
+            content: [{ type: 'text', text: 'Hello' }],
+        })).toBe('Hello');
+    });
+    (0, vitest_1.it)('concatenates multiple text blocks', () => {
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({
+            content: [
+                { type: 'text', text: 'Line 1' },
+                { type: 'text', text: 'Line 2' },
+            ],
+        })).toBe('Line 1\nLine 2');
+    });
+    (0, vitest_1.it)('handles binary data blocks', () => {
+        const result = (0, converter_js_1.formatToolResult)({
+            content: [{ type: 'image', data: 'abc123', mimeType: 'image/png' }],
+        });
+        (0, vitest_1.expect)(result).toContain('image/png');
+    });
+    (0, vitest_1.it)('prefixes error results', () => {
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({
+            content: [{ type: 'text', text: 'Something failed' }],
+            isError: true,
+        })).toBe('Error: Something failed');
+    });
+    (0, vitest_1.it)('handles empty content', () => {
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({ content: [] })).toBe('Success (no output)');
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({})).toBe('Success (no output)');
+    });
+    (0, vitest_1.it)('handles empty content with isError', () => {
+        (0, vitest_1.expect)((0, converter_js_1.formatToolResult)({ content: [], isError: true })).toBe('Error: Tool returned no content');
+    });
+});
+//# sourceMappingURL=converter.test.js.map

package/dist/commonjs/__tests__/converter.test.js.map

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

package/dist/commonjs/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/commonjs/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/commonjs/__tests__/index.test.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const vitest_1 = require("vitest");
+const index_js_1 = require("../index.js");
+// We can't easily mock WorkspaceClient in the module, so test the factory structure
+(0, vitest_1.describe)('createAerostackVercelAI', () => {
+    (0, vitest_1.it)('returns an object with tools() and workspaceClient', () => {
+        const client = (0, index_js_1.createAerostackVercelAI)({
+            workspace: 'test-ws',
+            token: 'mwt_test',
+        });
+        (0, vitest_1.expect)(client.tools).toBeTypeOf('function');
+        (0, vitest_1.expect)(client.workspaceClient).toBeDefined();
+    });
+    (0, vitest_1.it)('workspaceClient is configured with the correct slug', () => {
+        const client = (0, index_js_1.createAerostackVercelAI)({
+            workspace: 'my-ws',
+            token: 'mwt_abc',
+            baseUrl: 'https://custom.gateway.dev',
+        });
+        (0, vitest_1.expect)(client.workspaceClient).toBeDefined();
+    });
+});
+(0, vitest_1.describe)('getTools', () => {
+    (0, vitest_1.it)('is exported as a function', () => {
+        (0, vitest_1.expect)(index_js_1.getTools).toBeTypeOf('function');
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/commonjs/__tests__/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/__tests__/index.test.ts"],"names":[],"mappings":";;AAAA,mCAAkD;AAClD,0CAAgE;AAEhE,oFAAoF;AACpF,IAAA,iBAAQ,EAAC,yBAAyB,EAAE,GAAG,EAAE;IACrC,IAAA,WAAE,EAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,IAAA,kCAAuB,EAAC;YACnC,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,UAAU;SACpB,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAA,eAAM,EAAC,MAAM,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,IAAA,WAAE,EAAC,qDAAqD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,IAAA,kCAAuB,EAAC;YACnC,SAAS,EAAE,OAAO;YAClB,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,4BAA4B;SACxC,CAAC,CAAC;QAEH,IAAA,eAAM,EAAC,MAAM,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,IAAA,iBAAQ,EAAC,UAAU,EAAE,GAAG,EAAE;IACtB,IAAA,WAAE,EAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,IAAA,eAAM,EAAC,mBAAQ,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/commonjs/converter.d.ts

@@ -0,0 +1,18 @@
+import type { ToolSet as VercelToolSet } from 'ai';
+import { WorkspaceClient } from '@aerostack/core';
+import type { McpTool, McpToolResult } from '@aerostack/core';
+/**
+ * Convert McpTool array to Vercel AI SDK ToolSet.
+ *
+ * Each tool gets an `execute` function that proxies through WorkspaceClient.callTool().
+ * Tool names are used as-is (Vercel AI SDK has no name restrictions like OpenAI).
+ *
+ * @param mcpTools - Tools from WorkspaceClient.listTools()
+ * @param client - WorkspaceClient instance for executing tool calls
+ */
+export declare function convertTools(mcpTools: McpTool[], client: WorkspaceClient): VercelToolSet;
+/**
+ * Flatten McpToolResult content array into a single string.
+ */
+export declare function formatToolResult(result: McpToolResult): string;
+//# sourceMappingURL=converter.d.ts.map

package/dist/commonjs/converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../src/converter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,eAAe,EAAkB,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,aAAa,CA8BxF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAkB9D"}

package/dist/commonjs/converter.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertTools = convertTools;
+exports.formatToolResult = formatToolResult;
+/**
+ * Converts Aerostack McpTool definitions to Vercel AI SDK tool format.
+ */
+const ai_1 = require("ai");
+const core_1 = require("@aerostack/core");
+/**
+ * Convert McpTool array to Vercel AI SDK ToolSet.
+ *
+ * Each tool gets an `execute` function that proxies through WorkspaceClient.callTool().
+ * Tool names are used as-is (Vercel AI SDK has no name restrictions like OpenAI).
+ *
+ * @param mcpTools - Tools from WorkspaceClient.listTools()
+ * @param client - WorkspaceClient instance for executing tool calls
+ */
+function convertTools(mcpTools, client) {
+    const tools = {};
+    for (const mcpTool of mcpTools) {
+        if (!mcpTool.name)
+            continue;
+        const parameters = mcpTool.inputSchema
+            ? (0, ai_1.jsonSchema)(mcpTool.inputSchema)
+            : (0, ai_1.jsonSchema)({ type: 'object', properties: {} });
+        tools[mcpTool.name] = (0, ai_1.tool)({
+            description: mcpTool.description ?? '',
+            parameters,
+            execute: async (args) => {
+                try {
+                    const result = await client.callTool(mcpTool.name, args);
+                    return formatToolResult(result);
+                }
+                catch (err) {
+                    if (err instanceof core_1.AerostackError) {
+                        return `Error (${err.rpcCode}): ${err.message}`;
+                    }
+                    return err instanceof Error
+                        ? `Error: ${err.message}`
+                        : 'Error: Unknown error executing tool';
+                }
+            },
+        });
+    }
+    return tools;
+}
+/**
+ * Flatten McpToolResult content array into a single string.
+ */
+function formatToolResult(result) {
+    if (!result.content || result.content.length === 0) {
+        return result.isError ? 'Error: Tool returned no content' : 'Success (no output)';
+    }
+    const parts = [];
+    for (const block of result.content) {
+        if (block.text) {
+            parts.push(block.text);
+        }
+        else if (block.data) {
+            parts.push(`[${block.mimeType ?? 'binary'} data: ${block.data.length} chars base64]`);
+        }
+        else {
+            parts.push(JSON.stringify(block));
+        }
+    }
+    const text = parts.join('\n');
+    return result.isError ? `Error: ${text}` : text;
+}
+//# sourceMappingURL=converter.js.map

package/dist/commonjs/converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.js","sourceRoot":"","sources":["../../src/converter.ts"],"names":[],"mappings":";;AAiBA,oCA8BC;AAKD,4CAkBC;AAtED;;GAEG;AACH,2BAAsC;AAEtC,0CAAkE;AAGlE;;;;;;;;GAQG;AACH,SAAgB,YAAY,CAAC,QAAmB,EAAE,MAAuB;IACrE,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,SAAS;QAE5B,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW;YAClC,CAAC,CAAC,IAAA,eAAU,EAAC,OAAO,CAAC,WAA+C,CAAC;YACrE,CAAC,CAAC,IAAA,eAAU,EAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAE9D,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAA,SAAI,EAAC;YACvB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;YACtC,UAAU;YACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACpB,IAAI,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAA+B,CAAC,CAAC;oBACpF,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACX,IAAI,GAAG,YAAY,qBAAc,EAAE,CAAC;wBAChC,OAAO,UAAU,GAAG,CAAC,OAAO,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;oBACpD,CAAC;oBACD,OAAO,GAAG,YAAY,KAAK;wBACvB,CAAC,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE;wBACzB,CAAC,CAAC,qCAAqC,CAAC;gBAChD,CAAC;YACL,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,SAAgB,gBAAgB,CAAC,MAAqB;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACtF,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,QAAQ,UAAU,KAAK,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACJ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC"}

package/dist/commonjs/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @aerostack/sdk-vercel-ai — Use Aerostack workspace tools with the Vercel AI SDK.
+ *
+ * @example
+ * ```ts
+ * import { openai } from '@ai-sdk/openai';
+ * import { generateText } from 'ai';
+ * import { getTools } from '@aerostack/sdk-vercel-ai';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ *
+ * const { text } = await generateText({
+ *     model: openai('gpt-4o'),
+ *     tools,
+ *     maxSteps: 5,
+ *     prompt: 'Create a GitHub issue for the login bug',
+ * });
+ * ```
+ *
+ * @example Factory pattern
+ * ```ts
+ * const client = createAerostackVercelAI({ workspace: 'my-workspace', token: 'mwt_...' });
+ * const tools = await client.tools();
+ *
+ * const { text } = await streamText({
+ *     model: anthropic('claude-sonnet-4-20250514'),
+ *     tools,
+ *     maxSteps: 10,
+ *     prompt: 'Summarize the latest Notion pages and post to Slack',
+ * });
+ * ```
+ */
+import type { ToolSet as VercelToolSet } from 'ai';
+import { WorkspaceClient } from '@aerostack/core';
+import type { McpTool } from '@aerostack/core';
+export { formatToolResult } from './converter.js';
+export interface WorkspaceConfig {
+    /** Workspace slug */
+    workspace: string;
+    /** Workspace token (mwt_...) */
+    token: string;
+    /** Override gateway base URL */
+    baseUrl?: string;
+}
+/** Result from getTools — includes both the Vercel AI tools and the raw MCP tools. */
+export interface ToolSetResult {
+    /** Vercel AI SDK ToolSet — drop into generateText/streamText({ tools }) */
+    tools: VercelToolSet;
+    /** Raw MCP tools from the workspace for inspection */
+    raw: McpTool[];
+}
+/**
+ * Fetch tools from an Aerostack workspace and convert to Vercel AI SDK format.
+ *
+ * Each tool includes an `execute` function that calls the workspace gateway,
+ * so you just pass the tools to `generateText` / `streamText` and it works.
+ */
+export declare function getTools(config: WorkspaceConfig): Promise<ToolSetResult>;
+export interface AerostackVercelAIClient {
+    /** Fetch and convert workspace tools to Vercel AI SDK format. */
+    tools(): Promise<ToolSetResult>;
+    /** Access the underlying WorkspaceClient for advanced use. */
+    readonly workspaceClient: WorkspaceClient;
+}
+/**
+ * Create a reusable Aerostack Vercel AI client.
+ *
+ * Reuses a single WorkspaceClient instance across tool calls.
+ */
+export declare function createAerostackVercelAI(config: WorkspaceConfig): AerostackVercelAIClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/commonjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC5B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC1B,2EAA2E;IAC3E,KAAK,EAAE,aAAa,CAAC;IACrB,sDAAsD;IACtD,GAAG,EAAE,OAAO,EAAE,CAAC;CAClB;AAcD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAK9E;AAMD,MAAM,WAAW,uBAAuB;IACpC,iEAAiE;IACjE,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,uBAAuB,CAcxF"}

package/dist/commonjs/index.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * @aerostack/sdk-vercel-ai — Use Aerostack workspace tools with the Vercel AI SDK.
+ *
+ * @example
+ * ```ts
+ * import { openai } from '@ai-sdk/openai';
+ * import { generateText } from 'ai';
+ * import { getTools } from '@aerostack/sdk-vercel-ai';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ *
+ * const { text } = await generateText({
+ *     model: openai('gpt-4o'),
+ *     tools,
+ *     maxSteps: 5,
+ *     prompt: 'Create a GitHub issue for the login bug',
+ * });
+ * ```
+ *
+ * @example Factory pattern
+ * ```ts
+ * const client = createAerostackVercelAI({ workspace: 'my-workspace', token: 'mwt_...' });
+ * const tools = await client.tools();
+ *
+ * const { text } = await streamText({
+ *     model: anthropic('claude-sonnet-4-20250514'),
+ *     tools,
+ *     maxSteps: 10,
+ *     prompt: 'Summarize the latest Notion pages and post to Slack',
+ * });
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatToolResult = void 0;
+exports.getTools = getTools;
+exports.createAerostackVercelAI = createAerostackVercelAI;
+const core_1 = require("@aerostack/core");
+const converter_js_1 = require("./converter.js");
+var converter_js_2 = require("./converter.js");
+Object.defineProperty(exports, "formatToolResult", { enumerable: true, get: function () { return converter_js_2.formatToolResult; } });
+function createWorkspaceClient(config) {
+    return new core_1.WorkspaceClient({
+        slug: config.workspace,
+        token: config.token,
+        baseUrl: config.baseUrl,
+    });
+}
+// ---------------------------------------------------------------------------
+// Standalone function
+// ---------------------------------------------------------------------------
+/**
+ * Fetch tools from an Aerostack workspace and convert to Vercel AI SDK format.
+ *
+ * Each tool includes an `execute` function that calls the workspace gateway,
+ * so you just pass the tools to `generateText` / `streamText` and it works.
+ */
+async function getTools(config) {
+    const client = createWorkspaceClient(config);
+    const raw = await client.listTools();
+    const tools = (0, converter_js_1.convertTools)(raw, client);
+    return { tools, raw };
+}
+/**
+ * Create a reusable Aerostack Vercel AI client.
+ *
+ * Reuses a single WorkspaceClient instance across tool calls.
+ */
+function createAerostackVercelAI(config) {
+    const wsClient = createWorkspaceClient(config);
+    return {
+        async tools() {
+            const raw = await wsClient.listTools();
+            const tools = (0, converter_js_1.convertTools)(raw, wsClient);
+            return { tools, raw };
+        },
+        get workspaceClient() {
+            return wsClient;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/commonjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;;;AA4CH,4BAKC;AAkBD,0DAcC;AA9ED,0CAAkD;AAElD,iDAA8C;AAE9C,+CAAkD;AAAzC,gHAAA,gBAAgB,OAAA;AAmBzB,SAAS,qBAAqB,CAAC,MAAuB;IAClD,OAAO,IAAI,sBAAe,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC,SAAS;QACtB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;KAC1B,CAAC,CAAC;AACP,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;GAKG;AACI,KAAK,UAAU,QAAQ,CAAC,MAAuB;IAClD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,IAAA,2BAAY,EAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAC1B,CAAC;AAaD;;;;GAIG;AACH,SAAgB,uBAAuB,CAAC,MAAuB;IAC3D,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE/C,OAAO;QACH,KAAK,CAAC,KAAK;YACP,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,IAAA,2BAAY,EAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC1C,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,eAAe;YACf,OAAO,QAAQ,CAAC;QACpB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/commonjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/esm/__tests__/converter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=converter.test.d.ts.map

package/dist/esm/__tests__/converter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/converter.test.ts"],"names":[],"mappings":""}

package/dist/esm/__tests__/converter.test.js

@@ -0,0 +1,139 @@
+import { describe, it, expect, vi } from 'vitest';
+import { convertTools, formatToolResult } from '../converter.js';
+function mockClient(callToolResult, shouldThrow = false) {
+    return {
+        callTool: shouldThrow
+            ? vi.fn().mockRejectedValue(callToolResult)
+            : vi.fn().mockResolvedValue(callToolResult),
+    };
+}
+describe('convertTools', () => {
+    it('converts MCP tools to Vercel AI SDK ToolSet', () => {
+        const mcpTools = [
+            {
+                name: 'github__create_issue',
+                description: 'Create a GitHub issue',
+                inputSchema: {
+                    type: 'object',
+                    properties: { title: { type: 'string' } },
+                    required: ['title'],
+                },
+            },
+            {
+                name: 'slack__post_message',
+                description: 'Post to Slack',
+                inputSchema: {
+                    type: 'object',
+                    properties: { channel: { type: 'string' }, text: { type: 'string' } },
+                },
+            },
+        ];
+        const client = mockClient({});
+        const tools = convertTools(mcpTools, client);
+        expect(Object.keys(tools)).toEqual(['github__create_issue', 'slack__post_message']);
+        expect(tools['github__create_issue']).toBeDefined();
+        expect(tools['slack__post_message']).toBeDefined();
+    });
+    it('handles tools with no inputSchema', () => {
+        const mcpTools = [
+            { name: 'ping', description: 'Ping the server' },
+        ];
+        const client = mockClient({});
+        const tools = convertTools(mcpTools, client);
+        expect(tools['ping']).toBeDefined();
+    });
+    it('handles tools with no description', () => {
+        const mcpTools = [
+            { name: 'my_tool', inputSchema: { type: 'object', properties: {} } },
+        ];
+        const client = mockClient({});
+        const tools = convertTools(mcpTools, client);
+        expect(tools['my_tool']).toBeDefined();
+    });
+    it('skips tools with empty names', () => {
+        const mcpTools = [
+            { name: '', description: 'Bad tool' },
+            { name: 'good_tool', description: 'Good tool' },
+        ];
+        const client = mockClient({});
+        const tools = convertTools(mcpTools, client);
+        expect(Object.keys(tools)).toEqual(['good_tool']);
+    });
+    it('handles empty tools array', () => {
+        const client = mockClient({});
+        const tools = convertTools([], client);
+        expect(Object.keys(tools)).toEqual([]);
+    });
+    it('execute function calls WorkspaceClient.callTool', async () => {
+        const mcpTools = [
+            {
+                name: 'test_tool',
+                description: 'Test',
+                inputSchema: { type: 'object', properties: { x: { type: 'number' } } },
+            },
+        ];
+        const client = mockClient({
+            content: [{ type: 'text', text: 'result123' }],
+        });
+        const tools = convertTools(mcpTools, client);
+        const result = await tools['test_tool'].execute({ x: 42 }, { toolCallId: 'tc_1', messages: [], abortSignal: new AbortController().signal });
+        expect(client.callTool).toHaveBeenCalledWith('test_tool', { x: 42 });
+        expect(result).toBe('result123');
+    });
+    it('execute function handles AerostackError gracefully', async () => {
+        const { AerostackError } = await import('@aerostack/core');
+        const err = new AerostackError('Server down', 503, -32603, 'req-1');
+        const client = mockClient(err, true);
+        const mcpTools = [
+            { name: 'failing_tool', description: 'Fails' },
+        ];
+        const tools = convertTools(mcpTools, client);
+        const result = await tools['failing_tool'].execute({}, { toolCallId: 'tc_1', messages: [], abortSignal: new AbortController().signal });
+        expect(result).toContain('Error (-32603)');
+        expect(result).toContain('Server down');
+    });
+    it('execute function handles generic errors', async () => {
+        const client = mockClient(new Error('Network timeout'), true);
+        const mcpTools = [
+            { name: 'timeout_tool', description: 'Timeouts' },
+        ];
+        const tools = convertTools(mcpTools, client);
+        const result = await tools['timeout_tool'].execute({}, { toolCallId: 'tc_1', messages: [], abortSignal: new AbortController().signal });
+        expect(result).toBe('Error: Network timeout');
+    });
+});
+describe('formatToolResult', () => {
+    it('formats single text content', () => {
+        expect(formatToolResult({
+            content: [{ type: 'text', text: 'Hello' }],
+        })).toBe('Hello');
+    });
+    it('concatenates multiple text blocks', () => {
+        expect(formatToolResult({
+            content: [
+                { type: 'text', text: 'Line 1' },
+                { type: 'text', text: 'Line 2' },
+            ],
+        })).toBe('Line 1\nLine 2');
+    });
+    it('handles binary data blocks', () => {
+        const result = formatToolResult({
+            content: [{ type: 'image', data: 'abc123', mimeType: 'image/png' }],
+        });
+        expect(result).toContain('image/png');
+    });
+    it('prefixes error results', () => {
+        expect(formatToolResult({
+            content: [{ type: 'text', text: 'Something failed' }],
+            isError: true,
+        })).toBe('Error: Something failed');
+    });
+    it('handles empty content', () => {
+        expect(formatToolResult({ content: [] })).toBe('Success (no output)');
+        expect(formatToolResult({})).toBe('Success (no output)');
+    });
+    it('handles empty content with isError', () => {
+        expect(formatToolResult({ content: [], isError: true })).toBe('Error: Tool returned no content');
+    });
+});
+//# sourceMappingURL=converter.test.js.map

package/dist/esm/__tests__/converter.test.js.map

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

package/dist/esm/__tests__/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist/esm/__tests__/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/index.test.ts"],"names":[],"mappings":""}

package/dist/esm/__tests__/index.test.js

@@ -0,0 +1,27 @@
+import { describe, it, expect } from 'vitest';
+import { getTools, createAerostackVercelAI } from '../index.js';
+// We can't easily mock WorkspaceClient in the module, so test the factory structure
+describe('createAerostackVercelAI', () => {
+    it('returns an object with tools() and workspaceClient', () => {
+        const client = createAerostackVercelAI({
+            workspace: 'test-ws',
+            token: 'mwt_test',
+        });
+        expect(client.tools).toBeTypeOf('function');
+        expect(client.workspaceClient).toBeDefined();
+    });
+    it('workspaceClient is configured with the correct slug', () => {
+        const client = createAerostackVercelAI({
+            workspace: 'my-ws',
+            token: 'mwt_abc',
+            baseUrl: 'https://custom.gateway.dev',
+        });
+        expect(client.workspaceClient).toBeDefined();
+    });
+});
+describe('getTools', () => {
+    it('is exported as a function', () => {
+        expect(getTools).toBeTypeOf('function');
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/dist/esm/__tests__/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../../../src/__tests__/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAM,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,QAAQ,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAEhE,oFAAoF;AACpF,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACrC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,MAAM,MAAM,GAAG,uBAAuB,CAAC;YACnC,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,UAAU;SACpB,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC5C,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC3D,MAAM,MAAM,GAAG,uBAAuB,CAAC;YACnC,SAAS,EAAE,OAAO;YAClB,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,4BAA4B;SACxC,CAAC,CAAC;QAEH,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACtB,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/dist/esm/converter.d.ts

@@ -0,0 +1,18 @@
+import type { ToolSet as VercelToolSet } from 'ai';
+import { WorkspaceClient } from '@aerostack/core';
+import type { McpTool, McpToolResult } from '@aerostack/core';
+/**
+ * Convert McpTool array to Vercel AI SDK ToolSet.
+ *
+ * Each tool gets an `execute` function that proxies through WorkspaceClient.callTool().
+ * Tool names are used as-is (Vercel AI SDK has no name restrictions like OpenAI).
+ *
+ * @param mcpTools - Tools from WorkspaceClient.listTools()
+ * @param client - WorkspaceClient instance for executing tool calls
+ */
+export declare function convertTools(mcpTools: McpTool[], client: WorkspaceClient): VercelToolSet;
+/**
+ * Flatten McpToolResult content array into a single string.
+ */
+export declare function formatToolResult(result: McpToolResult): string;
+//# sourceMappingURL=converter.d.ts.map

package/dist/esm/converter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.d.ts","sourceRoot":"","sources":["../../src/converter.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,eAAe,EAAkB,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,aAAa,CA8BxF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAkB9D"}

package/dist/esm/converter.js

@@ -0,0 +1,66 @@
+/**
+ * Converts Aerostack McpTool definitions to Vercel AI SDK tool format.
+ */
+import { tool, jsonSchema } from 'ai';
+import { AerostackError } from '@aerostack/core';
+/**
+ * Convert McpTool array to Vercel AI SDK ToolSet.
+ *
+ * Each tool gets an `execute` function that proxies through WorkspaceClient.callTool().
+ * Tool names are used as-is (Vercel AI SDK has no name restrictions like OpenAI).
+ *
+ * @param mcpTools - Tools from WorkspaceClient.listTools()
+ * @param client - WorkspaceClient instance for executing tool calls
+ */
+export function convertTools(mcpTools, client) {
+    const tools = {};
+    for (const mcpTool of mcpTools) {
+        if (!mcpTool.name)
+            continue;
+        const parameters = mcpTool.inputSchema
+            ? jsonSchema(mcpTool.inputSchema)
+            : jsonSchema({ type: 'object', properties: {} });
+        tools[mcpTool.name] = tool({
+            description: mcpTool.description ?? '',
+            parameters,
+            execute: async (args) => {
+                try {
+                    const result = await client.callTool(mcpTool.name, args);
+                    return formatToolResult(result);
+                }
+                catch (err) {
+                    if (err instanceof AerostackError) {
+                        return `Error (${err.rpcCode}): ${err.message}`;
+                    }
+                    return err instanceof Error
+                        ? `Error: ${err.message}`
+                        : 'Error: Unknown error executing tool';
+                }
+            },
+        });
+    }
+    return tools;
+}
+/**
+ * Flatten McpToolResult content array into a single string.
+ */
+export function formatToolResult(result) {
+    if (!result.content || result.content.length === 0) {
+        return result.isError ? 'Error: Tool returned no content' : 'Success (no output)';
+    }
+    const parts = [];
+    for (const block of result.content) {
+        if (block.text) {
+            parts.push(block.text);
+        }
+        else if (block.data) {
+            parts.push(`[${block.mimeType ?? 'binary'} data: ${block.data.length} chars base64]`);
+        }
+        else {
+            parts.push(JSON.stringify(block));
+        }
+    }
+    const text = parts.join('\n');
+    return result.isError ? `Error: ${text}` : text;
+}
+//# sourceMappingURL=converter.js.map

package/dist/esm/converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"converter.js","sourceRoot":"","sources":["../../src/converter.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAEtC,OAAO,EAAmB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGlE;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,QAAmB,EAAE,MAAuB;IACrE,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO,CAAC,IAAI;YAAE,SAAS;QAE5B,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW;YAClC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,WAA+C,CAAC;YACrE,CAAC,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC,CAAC;QAE9D,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;YACvB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,EAAE;YACtC,UAAU;YACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;gBACpB,IAAI,CAAC;oBACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,IAA+B,CAAC,CAAC;oBACpF,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACpC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACX,IAAI,GAAG,YAAY,cAAc,EAAE,CAAC;wBAChC,OAAO,UAAU,GAAG,CAAC,OAAO,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;oBACpD,CAAC;oBACD,OAAO,GAAG,YAAY,KAAK;wBACvB,CAAC,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE;wBACzB,CAAC,CAAC,qCAAqC,CAAC;gBAChD,CAAC;YACL,CAAC;SACJ,CAAC,CAAC;IACP,CAAC;IAED,OAAO,KAAK,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,qBAAqB,CAAC;IACtF,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACb,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,IAAI,QAAQ,UAAU,KAAK,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,CAAC;QAC1F,CAAC;aAAM,CAAC;YACJ,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC"}

package/dist/esm/index.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @aerostack/sdk-vercel-ai — Use Aerostack workspace tools with the Vercel AI SDK.
+ *
+ * @example
+ * ```ts
+ * import { openai } from '@ai-sdk/openai';
+ * import { generateText } from 'ai';
+ * import { getTools } from '@aerostack/sdk-vercel-ai';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ *
+ * const { text } = await generateText({
+ *     model: openai('gpt-4o'),
+ *     tools,
+ *     maxSteps: 5,
+ *     prompt: 'Create a GitHub issue for the login bug',
+ * });
+ * ```
+ *
+ * @example Factory pattern
+ * ```ts
+ * const client = createAerostackVercelAI({ workspace: 'my-workspace', token: 'mwt_...' });
+ * const tools = await client.tools();
+ *
+ * const { text } = await streamText({
+ *     model: anthropic('claude-sonnet-4-20250514'),
+ *     tools,
+ *     maxSteps: 10,
+ *     prompt: 'Summarize the latest Notion pages and post to Slack',
+ * });
+ * ```
+ */
+import type { ToolSet as VercelToolSet } from 'ai';
+import { WorkspaceClient } from '@aerostack/core';
+import type { McpTool } from '@aerostack/core';
+export { formatToolResult } from './converter.js';
+export interface WorkspaceConfig {
+    /** Workspace slug */
+    workspace: string;
+    /** Workspace token (mwt_...) */
+    token: string;
+    /** Override gateway base URL */
+    baseUrl?: string;
+}
+/** Result from getTools — includes both the Vercel AI tools and the raw MCP tools. */
+export interface ToolSetResult {
+    /** Vercel AI SDK ToolSet — drop into generateText/streamText({ tools }) */
+    tools: VercelToolSet;
+    /** Raw MCP tools from the workspace for inspection */
+    raw: McpTool[];
+}
+/**
+ * Fetch tools from an Aerostack workspace and convert to Vercel AI SDK format.
+ *
+ * Each tool includes an `execute` function that calls the workspace gateway,
+ * so you just pass the tools to `generateText` / `streamText` and it works.
+ */
+export declare function getTools(config: WorkspaceConfig): Promise<ToolSetResult>;
+export interface AerostackVercelAIClient {
+    /** Fetch and convert workspace tools to Vercel AI SDK format. */
+    tools(): Promise<ToolSetResult>;
+    /** Access the underlying WorkspaceClient for advanced use. */
+    readonly workspaceClient: WorkspaceClient;
+}
+/**
+ * Create a reusable Aerostack Vercel AI client.
+ *
+ * Reuses a single WorkspaceClient instance across tool calls.
+ */
+export declare function createAerostackVercelAI(config: WorkspaceConfig): AerostackVercelAIClient;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,IAAI,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,WAAW,eAAe;IAC5B,qBAAqB;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sFAAsF;AACtF,MAAM,WAAW,aAAa;IAC1B,2EAA2E;IAC3E,KAAK,EAAE,aAAa,CAAC;IACrB,sDAAsD;IACtD,GAAG,EAAE,OAAO,EAAE,CAAC;CAClB;AAcD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC,CAK9E;AAMD,MAAM,WAAW,uBAAuB;IACpC,iEAAiE;IACjE,KAAK,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAChC,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC7C;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,eAAe,GAAG,uBAAuB,CAcxF"}

package/dist/esm/index.js

@@ -0,0 +1,76 @@
+/**
+ * @aerostack/sdk-vercel-ai — Use Aerostack workspace tools with the Vercel AI SDK.
+ *
+ * @example
+ * ```ts
+ * import { openai } from '@ai-sdk/openai';
+ * import { generateText } from 'ai';
+ * import { getTools } from '@aerostack/sdk-vercel-ai';
+ *
+ * const tools = await getTools({ workspace: 'my-workspace', token: 'mwt_...' });
+ *
+ * const { text } = await generateText({
+ *     model: openai('gpt-4o'),
+ *     tools,
+ *     maxSteps: 5,
+ *     prompt: 'Create a GitHub issue for the login bug',
+ * });
+ * ```
+ *
+ * @example Factory pattern
+ * ```ts
+ * const client = createAerostackVercelAI({ workspace: 'my-workspace', token: 'mwt_...' });
+ * const tools = await client.tools();
+ *
+ * const { text } = await streamText({
+ *     model: anthropic('claude-sonnet-4-20250514'),
+ *     tools,
+ *     maxSteps: 10,
+ *     prompt: 'Summarize the latest Notion pages and post to Slack',
+ * });
+ * ```
+ */
+import { WorkspaceClient } from '@aerostack/core';
+import { convertTools } from './converter.js';
+export { formatToolResult } from './converter.js';
+function createWorkspaceClient(config) {
+    return new WorkspaceClient({
+        slug: config.workspace,
+        token: config.token,
+        baseUrl: config.baseUrl,
+    });
+}
+// ---------------------------------------------------------------------------
+// Standalone function
+// ---------------------------------------------------------------------------
+/**
+ * Fetch tools from an Aerostack workspace and convert to Vercel AI SDK format.
+ *
+ * Each tool includes an `execute` function that calls the workspace gateway,
+ * so you just pass the tools to `generateText` / `streamText` and it works.
+ */
+export async function getTools(config) {
+    const client = createWorkspaceClient(config);
+    const raw = await client.listTools();
+    const tools = convertTools(raw, client);
+    return { tools, raw };
+}
+/**
+ * Create a reusable Aerostack Vercel AI client.
+ *
+ * Reuses a single WorkspaceClient instance across tool calls.
+ */
+export function createAerostackVercelAI(config) {
+    const wsClient = createWorkspaceClient(config);
+    return {
+        async tools() {
+            const raw = await wsClient.listTools();
+            const tools = convertTools(raw, wsClient);
+            return { tools, raw };
+        },
+        get workspaceClient() {
+            return wsClient;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAmBlD,SAAS,qBAAqB,CAAC,MAAuB;IAClD,OAAO,IAAI,eAAe,CAAC;QACvB,IAAI,EAAE,MAAM,CAAC,SAAS;QACtB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;KAC1B,CAAC,CAAC;AACP,CAAC;AAED,8EAA8E;AAC9E,sBAAsB;AACtB,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAuB;IAClD,MAAM,MAAM,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;AAC1B,CAAC;AAaD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAuB;IAC3D,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAE/C,OAAO;QACH,KAAK,CAAC,KAAK;YACP,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC1C,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC1B,CAAC;QAED,IAAI,eAAe;YACf,OAAO,QAAQ,CAAC;QACpB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@aerostack/sdk-vercel-ai",
+  "version": "0.10.1",
+  "description": "Use Aerostack workspace tools with the Vercel AI SDK",
+  "author": "Aerostack",
+  "license": "MIT",
+  "type": "module",
+  "tshy": {
+    "sourceDialects": [
+      "@aerostack/sdk-vercel-ai/source"
+    ],
+    "exports": {
+      ".": "./src/index.ts",
+      "./package.json": "./package.json"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "lint": "eslint --cache --max-warnings=0 src",
+    "build": "tshy",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@aerostack/core": "^0.10.1"
+  },
+  "peerDependencies": {
+    "ai": "^3.0.0 || ^4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "ai": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "ai": "^4.3.0",
+    "tshy": "^2.0.0",
+    "typescript": "~5.8.3",
+    "vitest": "^3.2.1",
+    "zod": "^3.25.0"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "@aerostack/sdk-vercel-ai/source": "./src/index.ts",
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/commonjs/index.d.ts",
+        "default": "./dist/commonjs/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "./dist/commonjs/index.js",
+  "types": "./dist/commonjs/index.d.ts",
+  "module": "./dist/esm/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}