@aerostack/sdk-openai 0.10.1

package/dist/commonjs/executor.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeToolCall = executeToolCall;
+exports.executeToolCalls = executeToolCalls;
+exports.formatToolResult = formatToolResult;
+const core_1 = require("@aerostack/core");
+/**
+ * Execute a single OpenAI tool call against the Aerostack workspace.
+ *
+ * Returns a ChatCompletionToolMessageParam ready to append to messages.
+ * Errors from the workspace are returned as tool error messages (not thrown),
+ * because OpenAI expects a tool message back even when tools fail.
+ *
+ * @param nameMap - Optional reverse map from sanitized→original tool names
+ */
+async function executeToolCall(client, toolCall, nameMap) {
+    const originalName = nameMap?.get(toolCall.function.name) ?? toolCall.function.name;
+    let args;
+    try {
+        args = JSON.parse(toolCall.function.arguments || '{}');
+    }
+    catch {
+        return {
+            role: 'tool',
+            tool_call_id: toolCall.id,
+            content: `Error: Failed to parse tool arguments as JSON`,
+        };
+    }
+    try {
+        const result = await client.callTool(originalName, args);
+        return {
+            role: 'tool',
+            tool_call_id: toolCall.id,
+            content: formatToolResult(result),
+        };
+    }
+    catch (err) {
+        const message = err instanceof core_1.AerostackError
+            ? `Error (${err.rpcCode}): ${err.message}`
+            : err instanceof Error
+                ? `Error: ${err.message}`
+                : 'Error: Unknown error executing tool';
+        return {
+            role: 'tool',
+            tool_call_id: toolCall.id,
+            content: message,
+        };
+    }
+}
+/**
+ * Execute multiple tool calls in parallel.
+ *
+ * Returns an array of ChatCompletionToolMessageParam in the same order as input.
+ */
+async function executeToolCalls(client, toolCalls, nameMap) {
+    return Promise.all(toolCalls.map(tc => executeToolCall(client, tc, nameMap)));
+}
+/**
+ * Flatten McpToolResult content array into a single string for OpenAI.
+ *
+ * McpToolResult.content is an array of content blocks (text, base64 data, etc.).
+ * OpenAI tool messages expect a single string. We concatenate text blocks and
+ * JSON-serialize any non-text content.
+ */
+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=executor.js.map

package/dist/commonjs/executor.js.map

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

package/dist/commonjs/index.d.ts

@@ -0,0 +1,88 @@
+/**
+ * @aerostack/sdk-openai — Use Aerostack workspace tools as OpenAI function-calling tools.
+ *
+ * @example Standalone functions
+ * ```ts
+ * import { getTools, handleToolCall, handleToolCalls } from '@aerostack/sdk-openai';
+ * import OpenAI from 'openai';
+ *
+ * const openai = new OpenAI();
+ * const config = { workspace: 'my-workspace', token: 'mwt_...' };
+ *
+ * const tools = await getTools(config);
+ * const response = await openai.chat.completions.create({
+ *     model: 'gpt-4o',
+ *     messages: [{ role: 'user', content: 'Create a GitHub issue for the login bug' }],
+ *     tools,
+ * });
+ *
+ * const toolCalls = response.choices[0]?.message.tool_calls;
+ * if (toolCalls) {
+ *     const results = await handleToolCalls(toolCalls, config);
+ *     // results are ChatCompletionToolMessageParam[] — append to messages and continue
+ * }
+ * ```
+ *
+ * @example Factory pattern
+ * ```ts
+ * const client = createAerostackOpenAI({ workspace: 'my-workspace', token: 'mwt_...' });
+ * const tools = await client.tools();
+ * const results = await client.handleToolCalls(toolCalls);
+ * ```
+ */
+import type { ChatCompletionTool, ChatCompletionMessageToolCall, ChatCompletionToolMessageParam } from 'openai/resources/chat/completions';
+import { WorkspaceClient } from '@aerostack/core';
+import type { McpTool } from '@aerostack/core';
+import type { WorkspaceConfig } from './executor.js';
+export type { WorkspaceConfig } from './executor.js';
+export { convertTools, convertTool, sanitizeToolName, isValidOpenAIName } from './converter.js';
+export { formatToolResult } from './executor.js';
+/** Result from getTools — includes both the OpenAI tools and the name map for execution. */
+export interface ToolSet {
+    /** OpenAI-formatted tools, ready for chat.completions.create({ tools }) */
+    tools: ChatCompletionTool[];
+    /** Reverse map from sanitized names to original MCP tool names (used internally by handleToolCall) */
+    nameMap: Map<string, string>;
+    /** Raw MCP tools from the workspace */
+    raw: McpTool[];
+}
+/**
+ * Fetch tools from an Aerostack workspace and convert to OpenAI format.
+ *
+ * Returns a ToolSet containing the formatted tools, a name map for execution,
+ * and the raw MCP tools for inspection.
+ */
+export declare function getTools(config: WorkspaceConfig): Promise<ToolSet>;
+/**
+ * Execute a single OpenAI tool call against the workspace.
+ *
+ * @param toolCall - A tool call from response.choices[0].message.tool_calls
+ * @param config - Workspace connection config
+ * @param nameMap - Optional name map from getTools() (pass if tools were renamed)
+ */
+export declare function handleToolCall(toolCall: ChatCompletionMessageToolCall, config: WorkspaceConfig, nameMap?: Map<string, string>): Promise<ChatCompletionToolMessageParam>;
+/**
+ * Execute multiple OpenAI tool calls in parallel against the workspace.
+ *
+ * Returns ChatCompletionToolMessageParam[] in the same order as input —
+ * ready to append to your messages array.
+ */
+export declare function handleToolCalls(toolCalls: ChatCompletionMessageToolCall[], config: WorkspaceConfig, nameMap?: Map<string, string>): Promise<ChatCompletionToolMessageParam[]>;
+export interface AerostackOpenAIClient {
+    /** Fetch and convert workspace tools to OpenAI format. */
+    tools(): Promise<ToolSet>;
+    /** Execute a single tool call. */
+    handleToolCall(toolCall: ChatCompletionMessageToolCall): Promise<ChatCompletionToolMessageParam>;
+    /** Execute multiple tool calls in parallel. */
+    handleToolCalls(toolCalls: ChatCompletionMessageToolCall[]): Promise<ChatCompletionToolMessageParam[]>;
+    /** Access the underlying WorkspaceClient for advanced use. */
+    readonly workspaceClient: WorkspaceClient;
+}
+/**
+ * Create a reusable Aerostack OpenAI client.
+ *
+ * Reuses a single WorkspaceClient instance and caches the name map
+ * after the first tools() call for consistent tool name resolution.
+ */
+export declare function createAerostackOpenAI(config: WorkspaceConfig): AerostackOpenAIClient;
+//# 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,kBAAkB,EAAE,6BAA6B,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AAC3I,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGrD,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD,4FAA4F;AAC5F,MAAM,WAAW,OAAO;IACpB,2EAA2E;IAC3E,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,sGAAsG;IACtG,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,uCAAuC;IACvC,GAAG,EAAE,OAAO,EAAE,CAAC;CAClB;AAcD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAMxE;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAChC,QAAQ,EAAE,6BAA6B,EACvC,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,8BAA8B,CAAC,CAGzC;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACjC,SAAS,EAAE,6BAA6B,EAAE,EAC1C,MAAM,EAAE,eAAe,EACvB,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,8BAA8B,EAAE,CAAC,CAG3C;AAMD,MAAM,WAAW,qBAAqB;IAClC,0DAA0D;IAC1D,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,kCAAkC;IAClC,cAAc,CAAC,QAAQ,EAAE,6BAA6B,GAAG,OAAO,CAAC,8BAA8B,CAAC,CAAC;IACjG,+CAA+C;IAC/C,eAAe,CAAC,SAAS,EAAE,6BAA6B,EAAE,GAAG,OAAO,CAAC,8BAA8B,EAAE,CAAC,CAAC;IACvG,8DAA8D;IAC9D,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,qBAAqB,CAoCpF"}

package/dist/commonjs/index.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * @aerostack/sdk-openai — Use Aerostack workspace tools as OpenAI function-calling tools.
+ *
+ * @example Standalone functions
+ * ```ts
+ * import { getTools, handleToolCall, handleToolCalls } from '@aerostack/sdk-openai';
+ * import OpenAI from 'openai';
+ *
+ * const openai = new OpenAI();
+ * const config = { workspace: 'my-workspace', token: 'mwt_...' };
+ *
+ * const tools = await getTools(config);
+ * const response = await openai.chat.completions.create({
+ *     model: 'gpt-4o',
+ *     messages: [{ role: 'user', content: 'Create a GitHub issue for the login bug' }],
+ *     tools,
+ * });
+ *
+ * const toolCalls = response.choices[0]?.message.tool_calls;
+ * if (toolCalls) {
+ *     const results = await handleToolCalls(toolCalls, config);
+ *     // results are ChatCompletionToolMessageParam[] — append to messages and continue
+ * }
+ * ```
+ *
+ * @example Factory pattern
+ * ```ts
+ * const client = createAerostackOpenAI({ workspace: 'my-workspace', token: 'mwt_...' });
+ * const tools = await client.tools();
+ * const results = await client.handleToolCalls(toolCalls);
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatToolResult = exports.isValidOpenAIName = exports.sanitizeToolName = exports.convertTool = exports.convertTools = void 0;
+exports.getTools = getTools;
+exports.handleToolCall = handleToolCall;
+exports.handleToolCalls = handleToolCalls;
+exports.createAerostackOpenAI = createAerostackOpenAI;
+const core_1 = require("@aerostack/core");
+const converter_js_1 = require("./converter.js");
+const executor_js_1 = require("./executor.js");
+var converter_js_2 = require("./converter.js");
+Object.defineProperty(exports, "convertTools", { enumerable: true, get: function () { return converter_js_2.convertTools; } });
+Object.defineProperty(exports, "convertTool", { enumerable: true, get: function () { return converter_js_2.convertTool; } });
+Object.defineProperty(exports, "sanitizeToolName", { enumerable: true, get: function () { return converter_js_2.sanitizeToolName; } });
+Object.defineProperty(exports, "isValidOpenAIName", { enumerable: true, get: function () { return converter_js_2.isValidOpenAIName; } });
+var executor_js_2 = require("./executor.js");
+Object.defineProperty(exports, "formatToolResult", { enumerable: true, get: function () { return executor_js_2.formatToolResult; } });
+function createWorkspaceClient(config) {
+    return new core_1.WorkspaceClient({
+        slug: config.workspace,
+        token: config.token,
+        baseUrl: config.baseUrl,
+    });
+}
+// ---------------------------------------------------------------------------
+// Standalone functions
+// ---------------------------------------------------------------------------
+/**
+ * Fetch tools from an Aerostack workspace and convert to OpenAI format.
+ *
+ * Returns a ToolSet containing the formatted tools, a name map for execution,
+ * and the raw MCP tools for inspection.
+ */
+async function getTools(config) {
+    const client = createWorkspaceClient(config);
+    const raw = await client.listTools();
+    const tools = (0, converter_js_1.convertTools)(raw);
+    const nameMap = (0, converter_js_1.buildNameMap)(raw);
+    return { tools, nameMap, raw };
+}
+/**
+ * Execute a single OpenAI tool call against the workspace.
+ *
+ * @param toolCall - A tool call from response.choices[0].message.tool_calls
+ * @param config - Workspace connection config
+ * @param nameMap - Optional name map from getTools() (pass if tools were renamed)
+ */
+async function handleToolCall(toolCall, config, nameMap) {
+    const client = createWorkspaceClient(config);
+    return (0, executor_js_1.executeToolCall)(client, toolCall, nameMap);
+}
+/**
+ * Execute multiple OpenAI tool calls in parallel against the workspace.
+ *
+ * Returns ChatCompletionToolMessageParam[] in the same order as input —
+ * ready to append to your messages array.
+ */
+async function handleToolCalls(toolCalls, config, nameMap) {
+    const client = createWorkspaceClient(config);
+    return (0, executor_js_1.executeToolCalls)(client, toolCalls, nameMap);
+}
+/**
+ * Create a reusable Aerostack OpenAI client.
+ *
+ * Reuses a single WorkspaceClient instance and caches the name map
+ * after the first tools() call for consistent tool name resolution.
+ */
+function createAerostackOpenAI(config) {
+    const wsClient = createWorkspaceClient(config);
+    let cachedNameMap;
+    /** Ensure name map is populated — fetches tools on first call. */
+    async function ensureNameMap() {
+        if (!cachedNameMap) {
+            const raw = await wsClient.listTools();
+            cachedNameMap = (0, converter_js_1.buildNameMap)(raw);
+        }
+        return cachedNameMap;
+    }
+    return {
+        async tools() {
+            const raw = await wsClient.listTools();
+            const tools = (0, converter_js_1.convertTools)(raw);
+            const nameMap = (0, converter_js_1.buildNameMap)(raw);
+            cachedNameMap = nameMap;
+            return { tools, nameMap, raw };
+        },
+        async handleToolCall(toolCall) {
+            const nameMap = await ensureNameMap();
+            return (0, executor_js_1.executeToolCall)(wsClient, toolCall, nameMap);
+        },
+        async handleToolCalls(toolCalls) {
+            const nameMap = await ensureNameMap();
+            return (0, executor_js_1.executeToolCalls)(wsClient, toolCalls, nameMap);
+        },
+        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":"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"}

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,147 @@
+import { describe, it, expect } from 'vitest';
+import { convertTool, convertTools, sanitizeToolName, buildNameMap, isValidOpenAIName } from '../converter.js';
+describe('convertTool', () => {
+    it('converts a standard MCP tool to OpenAI format', () => {
+        const mcpTool = {
+            name: 'github__create_issue',
+            description: 'Create a GitHub issue',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    title: { type: 'string' },
+                    body: { type: 'string' },
+                },
+                required: ['title'],
+            },
+        };
+        const result = convertTool(mcpTool);
+        expect(result).toEqual({
+            type: 'function',
+            function: {
+                name: 'github__create_issue',
+                description: 'Create a GitHub issue',
+                parameters: {
+                    type: 'object',
+                    properties: {
+                        title: { type: 'string' },
+                        body: { type: 'string' },
+                    },
+                    required: ['title'],
+                },
+            },
+        });
+    });
+    it('handles undefined inputSchema with empty object schema', () => {
+        const mcpTool = {
+            name: 'slack__ping',
+            description: 'Ping Slack',
+        };
+        const result = convertTool(mcpTool);
+        expect(result.function.parameters).toEqual({
+            type: 'object',
+            properties: {},
+        });
+    });
+    it('handles undefined description', () => {
+        const mcpTool = {
+            name: 'my_tool',
+            inputSchema: { type: 'object', properties: {} },
+        };
+        const result = convertTool(mcpTool);
+        expect(result.function.description).toBeUndefined();
+        expect(result.function.name).toBe('my_tool');
+    });
+    it('handles tool with empty description', () => {
+        const mcpTool = {
+            name: 'my_tool',
+            description: '',
+            inputSchema: { type: 'object', properties: {} },
+        };
+        const result = convertTool(mcpTool);
+        // Empty string is falsy, so description should be omitted
+        expect(result.function).not.toHaveProperty('description');
+    });
+});
+describe('convertTools', () => {
+    it('converts an array of tools', () => {
+        const tools = [
+            { name: 'tool_a', description: 'A' },
+            { name: 'tool_b', description: 'B' },
+        ];
+        const result = convertTools(tools);
+        expect(result).toHaveLength(2);
+        expect(result[0].function.name).toBe('tool_a');
+        expect(result[1].function.name).toBe('tool_b');
+    });
+    it('handles empty array', () => {
+        expect(convertTools([])).toEqual([]);
+    });
+});
+describe('sanitizeToolName', () => {
+    it('passes through valid names unchanged', () => {
+        expect(sanitizeToolName('github__create_issue')).toBe('github__create_issue');
+        expect(sanitizeToolName('my-tool-123')).toBe('my-tool-123');
+    });
+    it('replaces invalid characters with underscores', () => {
+        expect(sanitizeToolName('my.tool.name')).toBe('my_tool_name');
+        expect(sanitizeToolName('tool with spaces')).toBe('tool_with_spaces');
+    });
+    it('throws on empty name', () => {
+        expect(() => sanitizeToolName('')).toThrow(/empty/i);
+    });
+    it('truncates names over 64 characters', () => {
+        const longName = 'a'.repeat(100);
+        const result = sanitizeToolName(longName);
+        expect(result.length).toBeLessThanOrEqual(64);
+    });
+    it('produces different truncated names for different long inputs', () => {
+        const name1 = 'server_one__' + 'a'.repeat(100);
+        const name2 = 'server_two__' + 'b'.repeat(100);
+        const result1 = sanitizeToolName(name1);
+        const result2 = sanitizeToolName(name2);
+        expect(result1).not.toBe(result2);
+    });
+});
+describe('buildNameMap', () => {
+    it('maps sanitized names back to originals', () => {
+        const tools = [
+            { name: 'github__create_issue' },
+            { name: 'slack.post.message' },
+        ];
+        const map = buildNameMap(tools);
+        expect(map.get('github__create_issue')).toBe('github__create_issue');
+        expect(map.get('slack_post_message')).toBe('slack.post.message');
+    });
+    it('throws on name collision', () => {
+        const tools = [
+            { name: 'server.create' },
+            { name: 'server_create' },
+        ];
+        expect(() => buildNameMap(tools)).toThrow(/collision/i);
+    });
+    it('allows duplicate identical names', () => {
+        const tools = [
+            { name: 'my_tool' },
+            { name: 'my_tool' },
+        ];
+        expect(() => buildNameMap(tools)).not.toThrow();
+    });
+});
+describe('isValidOpenAIName', () => {
+    it('accepts valid names', () => {
+        expect(isValidOpenAIName('my_tool')).toBe(true);
+        expect(isValidOpenAIName('github__create_issue')).toBe(true);
+        expect(isValidOpenAIName('a-b-c')).toBe(true);
+    });
+    it('rejects names with invalid characters', () => {
+        expect(isValidOpenAIName('my.tool')).toBe(false);
+        expect(isValidOpenAIName('tool name')).toBe(false);
+    });
+    it('rejects names over 64 characters', () => {
+        expect(isValidOpenAIName('a'.repeat(65))).toBe(false);
+    });
+    it('rejects empty string', () => {
+        expect(isValidOpenAIName('')).toBe(false);
+    });
+});
+//# 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__/executor.test.d.ts

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

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

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

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

@@ -0,0 +1,139 @@
+import { describe, it, expect, vi } from 'vitest';
+import { executeToolCall, executeToolCalls, formatToolResult } from '../executor.js';
+import { AerostackError } from '@aerostack/core';
+function mockClient(callToolResult, shouldThrow = false) {
+    return {
+        callTool: shouldThrow
+            ? vi.fn().mockRejectedValue(callToolResult)
+            : vi.fn().mockResolvedValue(callToolResult),
+    };
+}
+function makeToolCall(overrides = {}) {
+    return {
+        id: 'call_abc123',
+        type: 'function',
+        function: {
+            name: 'github__create_issue',
+            arguments: JSON.stringify({ title: 'Bug fix' }),
+        },
+        ...overrides,
+    };
+}
+describe('executeToolCall', () => {
+    it('executes a tool call and returns a tool message', async () => {
+        const client = mockClient({
+            content: [{ type: 'text', text: 'Issue #42 created' }],
+        });
+        const result = await executeToolCall(client, makeToolCall());
+        expect(result).toEqual({
+            role: 'tool',
+            tool_call_id: 'call_abc123',
+            content: 'Issue #42 created',
+        });
+        expect(client.callTool).toHaveBeenCalledWith('github__create_issue', { title: 'Bug fix' });
+    });
+    it('uses nameMap to resolve sanitized names', async () => {
+        const client = mockClient({
+            content: [{ type: 'text', text: 'done' }],
+        });
+        const nameMap = new Map([['slack_post_message', 'slack.post.message']]);
+        const tc = makeToolCall({
+            function: { name: 'slack_post_message', arguments: '{}' },
+        });
+        await executeToolCall(client, tc, nameMap);
+        expect(client.callTool).toHaveBeenCalledWith('slack.post.message', {});
+    });
+    it('returns error message when AerostackError is thrown', async () => {
+        const err = new AerostackError('MCP server down', 503, -32603, 'req-123');
+        const client = mockClient(err, true);
+        const result = await executeToolCall(client, makeToolCall());
+        expect(result.role).toBe('tool');
+        expect(result.content).toContain('Error (-32603)');
+        expect(result.content).toContain('MCP server down');
+    });
+    it('returns error message for generic errors', async () => {
+        const err = new Error('Network timeout');
+        const client = mockClient(err, true);
+        const result = await executeToolCall(client, makeToolCall());
+        expect(result.content).toBe('Error: Network timeout');
+    });
+    it('returns error for malformed JSON arguments', async () => {
+        const client = mockClient({});
+        const tc = makeToolCall({
+            function: { name: 'test', arguments: 'not json{' },
+        });
+        const result = await executeToolCall(client, tc);
+        expect(result.content).toContain('Failed to parse tool arguments');
+    });
+    it('handles empty arguments string', async () => {
+        const client = mockClient({
+            content: [{ type: 'text', text: 'ok' }],
+        });
+        const tc = makeToolCall({
+            function: { name: 'test', arguments: '' },
+        });
+        await executeToolCall(client, tc);
+        expect(client.callTool).toHaveBeenCalledWith('test', {});
+    });
+});
+describe('executeToolCalls', () => {
+    it('executes multiple tool calls in parallel', async () => {
+        const client = mockClient({
+            content: [{ type: 'text', text: 'done' }],
+        });
+        const toolCalls = [
+            makeToolCall({ id: 'call_1' }),
+            makeToolCall({ id: 'call_2' }),
+        ];
+        const results = await executeToolCalls(client, toolCalls);
+        expect(results).toHaveLength(2);
+        expect(results[0].tool_call_id).toBe('call_1');
+        expect(results[1].tool_call_id).toBe('call_2');
+    });
+    it('handles empty array', async () => {
+        const client = mockClient({});
+        const results = await executeToolCalls(client, []);
+        expect(results).toEqual([]);
+    });
+});
+describe('formatToolResult', () => {
+    it('formats single text content', () => {
+        const result = formatToolResult({
+            content: [{ type: 'text', text: 'Hello world' }],
+        });
+        expect(result).toBe('Hello world');
+    });
+    it('concatenates multiple text blocks', () => {
+        const result = formatToolResult({
+            content: [
+                { type: 'text', text: 'Line 1' },
+                { type: 'text', text: 'Line 2' },
+            ],
+        });
+        expect(result).toBe('Line 1\nLine 2');
+    });
+    it('handles binary data blocks', () => {
+        const result = formatToolResult({
+            content: [{ type: 'image', data: 'base64data...', mimeType: 'image/png' }],
+        });
+        expect(result).toContain('image/png');
+        expect(result).toContain('base64');
+    });
+    it('prefixes error results', () => {
+        const result = formatToolResult({
+            content: [{ type: 'text', text: 'Something failed' }],
+            isError: true,
+        });
+        expect(result).toBe('Error: Something failed');
+    });
+    it('handles empty content array', () => {
+        expect(formatToolResult({ content: [] })).toBe('Success (no output)');
+    });
+    it('handles undefined content', () => {
+        expect(formatToolResult({})).toBe('Success (no output)');
+    });
+    it('handles empty content with isError', () => {
+        expect(formatToolResult({ content: [], isError: true })).toBe('Error: Tool returned no content');
+    });
+});
+//# sourceMappingURL=executor.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.test.js","sourceRoot":"","sources":["../../../src/__tests__/executor.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAmB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGlE,SAAS,UAAU,CAAC,cAAuB,EAAE,WAAW,GAAG,KAAK;IAC5D,OAAO;QACH,QAAQ,EAAE,WAAW;YACjB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC;YAC3C,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,cAAc,CAAC;KACpB,CAAC;AACpC,CAAC;AAED,SAAS,YAAY,CAAC,YAAoD,EAAE;IACxE,OAAO;QACH,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,sBAAsB;YAC5B,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAClD;QACD,GAAG,SAAS;KACf,CAAC;AACN,CAAC;AAED,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,MAAM,GAAG,UAAU,CAAC;YACtB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAAC;SACzD,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QAE7D,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACnB,IAAI,EAAE,MAAM;YACZ,YAAY,EAAE,aAAa;YAC3B,OAAO,EAAE,mBAAmB;SAC/B,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,sBAAsB,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,MAAM,GAAG,UAAU,CAAC;YACtB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SAC5C,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,oBAAoB,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;QAExE,MAAM,EAAE,GAAG,YAAY,CAAC;YACpB,QAAQ,EAAE,EAAE,IAAI,EAAE,oBAAoB,EAAE,SAAS,EAAE,IAAI,EAAE;SAC5D,CAAC,CAAC;QAEH,MAAM,eAAe,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;QAE3C,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qDAAqD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,GAAG,GAAG,IAAI,cAAc,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAErC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QAE7D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QACnD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,iBAAiB,CAAC,CAAC;IACxD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAErC,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;QAE7D,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,EAAE,GAAG,YAAY,CAAC;YACpB,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE;SACrD,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAEjD,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,gCAAgC,CAAC,CAAC;IACvE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gCAAgC,EAAE,KAAK,IAAI,EAAE;QAC5C,MAAM,MAAM,GAAG,UAAU,CAAC;YACtB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;SAC1C,CAAC,CAAC;QACH,MAAM,EAAE,GAAG,YAAY,CAAC;YACpB,QAAQ,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE;SAC5C,CAAC,CAAC;QAEH,MAAM,eAAe,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAElC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,MAAM,GAAG,UAAU,CAAC;YACtB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;SAC5C,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG;YACd,YAAY,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;YAC9B,YAAY,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;SACjC,CAAC;QAEF,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAE1D,MAAM,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,CAAC,OAAO,CAAC,CAAC,CAAE,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;QACjC,MAAM,MAAM,GAAG,UAAU,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACnD,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAChC,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACnC,MAAM,MAAM,GAAG,gBAAgB,CAAC;YAC5B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;SACnD,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,GAAG,EAAE;QACzC,MAAM,MAAM,GAAG,gBAAgB,CAAC;YAC5B,OAAO,EAAE;gBACL,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;gBAChC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE;aACnC;SACJ,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4BAA4B,EAAE,GAAG,EAAE;QAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC;YAC5B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;SAC7E,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACtC,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;QAC9B,MAAM,MAAM,GAAG,gBAAgB,CAAC;YAC5B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC;YACrD,OAAO,EAAE,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;QACnC,MAAM,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2BAA2B,EAAE,GAAG,EAAE;QACjC,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC1C,MAAM,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACrG,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}