@aerostack/sdk-openai 0.10.1

package/dist/esm/converter.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Converts Aerostack McpTool definitions to OpenAI ChatCompletionTool format.
+ */
+import type { ChatCompletionTool } from 'openai/resources/chat/completions';
+import type { McpTool } from '@aerostack/core';
+/**
+ * Convert an array of McpTool definitions to OpenAI ChatCompletionTool format.
+ *
+ * Handles edge cases:
+ * - Undefined inputSchema → empty object schema
+ * - Tool names exceeding 64 chars → truncated with hash suffix
+ * - Invalid characters in tool names → sanitized
+ */
+export declare function convertTools(mcpTools: McpTool[]): ChatCompletionTool[];
+/**
+ * Convert a single McpTool to OpenAI ChatCompletionTool format.
+ */
+export declare function convertTool(tool: McpTool): ChatCompletionTool;
+/**
+ * Sanitize a tool name to comply with OpenAI's function name constraints.
+ * - Replace invalid characters with underscores
+ * - Truncate to 64 characters (keeping a short hash suffix for uniqueness)
+ */
+export declare function sanitizeToolName(name: string): string;
+/**
+ * Build a reverse mapping from sanitized OpenAI tool names back to original MCP tool names.
+ * Needed when tool names are truncated/sanitized.
+ *
+ * Throws if two distinct MCP tool names sanitize to the same OpenAI name,
+ * since that would cause silent wrong-dispatch.
+ */
+export declare function buildNameMap(mcpTools: McpTool[]): Map<string, string>;
+/** Check if a tool name is valid for OpenAI without modification. */
+export declare function isValidOpenAIName(name: string): boolean;
+//# 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":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAK/C;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,kBAAkB,EAAE,CAEtE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAc7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAerD;AAYD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAcrE;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEvD"}

package/dist/esm/converter.js

@@ -0,0 +1,82 @@
+/** OpenAI function names must match: ^[a-zA-Z0-9_-]{1,64}$ */
+const OPENAI_FUNCTION_NAME_RE = /^[a-zA-Z0-9_-]{1,64}$/;
+/**
+ * Convert an array of McpTool definitions to OpenAI ChatCompletionTool format.
+ *
+ * Handles edge cases:
+ * - Undefined inputSchema → empty object schema
+ * - Tool names exceeding 64 chars → truncated with hash suffix
+ * - Invalid characters in tool names → sanitized
+ */
+export function convertTools(mcpTools) {
+    return mcpTools.map(convertTool);
+}
+/**
+ * Convert a single McpTool to OpenAI ChatCompletionTool format.
+ */
+export function convertTool(tool) {
+    const name = sanitizeToolName(tool.name);
+    const parameters = tool.inputSchema
+        ? tool.inputSchema
+        : { type: 'object', properties: {} };
+    return {
+        type: 'function',
+        function: {
+            name,
+            ...(tool.description ? { description: tool.description } : {}),
+            parameters,
+        },
+    };
+}
+/**
+ * Sanitize a tool name to comply with OpenAI's function name constraints.
+ * - Replace invalid characters with underscores
+ * - Truncate to 64 characters (keeping a short hash suffix for uniqueness)
+ */
+export function sanitizeToolName(name) {
+    if (!name) {
+        throw new Error('Tool name cannot be empty');
+    }
+    // Replace any character not in [a-zA-Z0-9_-] with underscore
+    let sanitized = name.replace(/[^a-zA-Z0-9_-]/g, '_');
+    // Truncate if over 64 chars — use last 8 chars as hash-like suffix
+    if (sanitized.length > 64) {
+        const hash = simpleHash(name);
+        sanitized = sanitized.slice(0, 55) + '_' + hash;
+    }
+    return sanitized;
+}
+/** Simple string hash producing an 8-char hex string. */
+function simpleHash(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash + char) | 0;
+    }
+    return Math.abs(hash).toString(16).padStart(8, '0').slice(0, 8);
+}
+/**
+ * Build a reverse mapping from sanitized OpenAI tool names back to original MCP tool names.
+ * Needed when tool names are truncated/sanitized.
+ *
+ * Throws if two distinct MCP tool names sanitize to the same OpenAI name,
+ * since that would cause silent wrong-dispatch.
+ */
+export function buildNameMap(mcpTools) {
+    const map = new Map();
+    for (const tool of mcpTools) {
+        const sanitized = sanitizeToolName(tool.name);
+        const existing = map.get(sanitized);
+        if (existing && existing !== tool.name) {
+            throw new Error(`Tool name collision: "${tool.name}" and "${existing}" both sanitize to "${sanitized}". ` +
+                `Rename one of the tools in your workspace to avoid ambiguity.`);
+        }
+        map.set(sanitized, tool.name);
+    }
+    return map;
+}
+/** Check if a tool name is valid for OpenAI without modification. */
+export function isValidOpenAIName(name) {
+    return OPENAI_FUNCTION_NAME_RE.test(name);
+}
+//# 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":"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"}

package/dist/esm/executor.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Executes OpenAI tool calls by proxying them through WorkspaceClient.
+ */
+import type { ChatCompletionMessageToolCall } from 'openai/resources/chat/completions';
+import type { ChatCompletionToolMessageParam } from 'openai/resources/chat/completions';
+import { WorkspaceClient } from '@aerostack/core';
+import type { McpToolResult } from '@aerostack/core';
+export interface WorkspaceConfig {
+    /** Workspace slug */
+    workspace: string;
+    /** Workspace token (mwt_...) */
+    token: string;
+    /** Override gateway base URL */
+    baseUrl?: string;
+}
+/**
+ * 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
+ */
+export declare function executeToolCall(client: WorkspaceClient, toolCall: ChatCompletionMessageToolCall, nameMap?: Map<string, string>): Promise<ChatCompletionToolMessageParam>;
+/**
+ * Execute multiple tool calls in parallel.
+ *
+ * Returns an array of ChatCompletionToolMessageParam in the same order as input.
+ */
+export declare function executeToolCalls(client: WorkspaceClient, toolCalls: ChatCompletionMessageToolCall[], nameMap?: Map<string, string>): Promise<ChatCompletionToolMessageParam[]>;
+/**
+ * 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.
+ */
+export declare function formatToolResult(result: McpToolResult): string;
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AACvF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,mCAAmC,CAAC;AACxF,OAAO,EAAE,eAAe,EAAkB,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD,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;;;;;;;;GAQG;AACH,wBAAsB,eAAe,CACjC,MAAM,EAAE,eAAe,EACvB,QAAQ,EAAE,6BAA6B,EACvC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,8BAA8B,CAAC,CAkCzC;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAClC,MAAM,EAAE,eAAe,EACvB,SAAS,EAAE,6BAA6B,EAAE,EAC1C,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,OAAO,CAAC,8BAA8B,EAAE,CAAC,CAI3C;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAkB9D"}

package/dist/esm/executor.js

@@ -0,0 +1,79 @@
+import { AerostackError } from '@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
+ */
+export 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 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.
+ */
+export 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.
+ */
+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=executor.js.map

package/dist/esm/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/executor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAmB,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAYlE;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACjC,MAAuB,EACvB,QAAuC,EACvC,OAA6B;IAE7B,MAAM,YAAY,GAAG,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;IAEpF,IAAI,IAA6B,CAAC;IAClC,IAAI,CAAC;QACD,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,SAAS,IAAI,IAAI,CAA4B,CAAC;IACtF,CAAC;IAAC,MAAM,CAAC;QACL,OAAO;YACH,IAAI,EAAE,MAAM;YACZ,YAAY,EAAE,QAAQ,CAAC,EAAE;YACzB,OAAO,EAAE,+CAA+C;SAC3D,CAAC;IACN,CAAC;IAED,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACzD,OAAO;YACH,IAAI,EAAE,MAAM;YACZ,YAAY,EAAE,QAAQ,CAAC,EAAE;YACzB,OAAO,EAAE,gBAAgB,CAAC,MAAM,CAAC;SACpC,CAAC;IACN,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,GAAG,YAAY,cAAc;YACzC,CAAC,CAAC,UAAU,GAAG,CAAC,OAAO,MAAM,GAAG,CAAC,OAAO,EAAE;YAC1C,CAAC,CAAC,GAAG,YAAY,KAAK;gBAClB,CAAC,CAAC,UAAU,GAAG,CAAC,OAAO,EAAE;gBACzB,CAAC,CAAC,qCAAqC,CAAC;QAEhD,OAAO;YACH,IAAI,EAAE,MAAM;YACZ,YAAY,EAAE,QAAQ,CAAC,EAAE;YACzB,OAAO,EAAE,OAAO;SACnB,CAAC;IACN,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAClC,MAAuB,EACvB,SAA0C,EAC1C,OAA6B;IAE7B,OAAO,OAAO,CAAC,GAAG,CACd,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC,CAC5D,CAAC;AACN,CAAC;AAED;;;;;;GAMG;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,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/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,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/esm/index.js

@@ -0,0 +1,120 @@
+/**
+ * @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 { WorkspaceClient } from '@aerostack/core';
+import { convertTools, buildNameMap } from './converter.js';
+import { executeToolCall, executeToolCalls } from './executor.js';
+export { convertTools, convertTool, sanitizeToolName, isValidOpenAIName } from './converter.js';
+export { formatToolResult } from './executor.js';
+function createWorkspaceClient(config) {
+    return new 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.
+ */
+export async function getTools(config) {
+    const client = createWorkspaceClient(config);
+    const raw = await client.listTools();
+    const tools = convertTools(raw);
+    const nameMap = 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)
+ */
+export async function handleToolCall(toolCall, config, nameMap) {
+    const client = createWorkspaceClient(config);
+    return 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.
+ */
+export async function handleToolCalls(toolCalls, config, nameMap) {
+    const client = createWorkspaceClient(config);
+    return 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.
+ */
+export 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 = buildNameMap(raw);
+        }
+        return cachedNameMap;
+    }
+    return {
+        async tools() {
+            const raw = await wsClient.listTools();
+            const tools = convertTools(raw);
+            const nameMap = buildNameMap(raw);
+            cachedNameMap = nameMap;
+            return { tools, nameMap, raw };
+        },
+        async handleToolCall(toolCall) {
+            const nameMap = await ensureNameMap();
+            return executeToolCall(wsClient, toolCall, nameMap);
+        },
+        async handleToolCalls(toolCalls) {
+            const nameMap = await ensureNameMap();
+            return executeToolCalls(wsClient, toolCalls, nameMap);
+        },
+        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":"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"}

package/dist/esm/package.json

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

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@aerostack/sdk-openai",
+  "version": "0.10.1",
+  "description": "Use Aerostack workspace tools as OpenAI function-calling tools",
+  "author": "Aerostack",
+  "license": "MIT",
+  "type": "module",
+  "tshy": {
+    "sourceDialects": [
+      "@aerostack/sdk-openai/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": {
+    "openai": "^4.20.0"
+  },
+  "peerDependenciesMeta": {
+    "openai": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "openai": "^4.80.0",
+    "tshy": "^2.0.0",
+    "typescript": "~5.8.3",
+    "vitest": "^3.2.1"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "@aerostack/sdk-openai/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"
+  }
+}