@granular-software/sdk 0.4.2 → 0.4.4

package/dist/adapters/mastra.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/adapters/mastra.ts"],"names":["zodToJsonSchema"],"mappings":";;;;;AAoBO,SAAS,gBAAgB,WAAA,EAA8C;AAC1E,EAAA,OAAO,WAAA,CAAY,GAAA,CAAI,CAAC,IAAA,KAAS;AAC7B,IAAA,MAAM,aAAa,IAAA,CAAK,WAAA,GAAcA,gCAAgB,IAAA,CAAK,WAAW,IAAI,EAAC;AAE3E,IAAA,OAAO;AAAA,MACH,MAAM,IAAA,CAAK,EAAA;AAAA;AAAA,MACX,WAAA,EAAa,KAAK,WAAA,IAAe,EAAA;AAAA,MACjC,WAAA,EAAa,UAAA;AAAA,MACb,OAAA,EAAS,OAAO,KAAA,KAAe;AAC3B,QAAA,IAAI,KAAK,OAAA,EAAS;AACd,UAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,EAAE,OAAA,EAAS,OAAO,CAAA;AAAA,QAC1C;AACA,QAAA,OAAO,EAAC;AAAA,MACZ;AAAA,KACJ;AAAA,EACJ,CAAC,CAAA;AACL","file":"mastra.js","sourcesContent":["import { z } from 'zod';\nimport type { ToolWithHandler } from '../types';\nimport { zodToJsonSchema } from 'zod-to-json-schema';\n\n/**\n * Mastra tool definition interface\n */\nexport interface MastraTool {\n    id: string;\n    description?: string;\n    inputSchema?: z.ZodType<unknown>;\n    execute?: (context: { context: unknown }) => Promise<unknown>;\n}\n\n/**\n * Helper to convert Mastra tools to Granular tools\n * \n * @param mastraTools - Array of Mastra tools\n * @returns Array of Granular ToolWithHandler\n */\nexport function fromMastraTools(mastraTools: MastraTool[]): ToolWithHandler[] {\n    return mastraTools.map((tool) => {\n        const jsonSchema = tool.inputSchema ? zodToJsonSchema(tool.inputSchema) : {};\n\n        return {\n            name: tool.id, // Mastra uses ID as name\n            description: tool.description || '',\n            inputSchema: jsonSchema as Record<string, unknown>,\n            handler: async (input: any) => {\n                if (tool.execute) {\n                    return tool.execute({ context: input });\n                }\n                return {};\n            },\n        };\n    });\n}\n"]}

package/dist/adapters/mastra.mjs

@@ -1,24 +0,0 @@
-import { zodToJsonSchema } from 'zod-to-json-schema';
-
-// src/adapters/mastra.ts
-function fromMastraTools(mastraTools) {
-  return mastraTools.map((tool) => {
-    const jsonSchema = tool.inputSchema ? zodToJsonSchema(tool.inputSchema) : {};
-    return {
-      name: tool.id,
-      // Mastra uses ID as name
-      description: tool.description || "",
-      inputSchema: jsonSchema,
-      handler: async (input) => {
-        if (tool.execute) {
-          return tool.execute({ context: input });
-        }
-        return {};
-      }
-    };
-  });
-}
-
-export { fromMastraTools };
-//# sourceMappingURL=mastra.mjs.map
-//# sourceMappingURL=mastra.mjs.map

package/dist/adapters/mastra.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/adapters/mastra.ts"],"names":[],"mappings":";;;AAoBO,SAAS,gBAAgB,WAAA,EAA8C;AAC1E,EAAA,OAAO,WAAA,CAAY,GAAA,CAAI,CAAC,IAAA,KAAS;AAC7B,IAAA,MAAM,aAAa,IAAA,CAAK,WAAA,GAAc,gBAAgB,IAAA,CAAK,WAAW,IAAI,EAAC;AAE3E,IAAA,OAAO;AAAA,MACH,MAAM,IAAA,CAAK,EAAA;AAAA;AAAA,MACX,WAAA,EAAa,KAAK,WAAA,IAAe,EAAA;AAAA,MACjC,WAAA,EAAa,UAAA;AAAA,MACb,OAAA,EAAS,OAAO,KAAA,KAAe;AAC3B,QAAA,IAAI,KAAK,OAAA,EAAS;AACd,UAAA,OAAO,IAAA,CAAK,OAAA,CAAQ,EAAE,OAAA,EAAS,OAAO,CAAA;AAAA,QAC1C;AACA,QAAA,OAAO,EAAC;AAAA,MACZ;AAAA,KACJ;AAAA,EACJ,CAAC,CAAA;AACL","file":"mastra.mjs","sourcesContent":["import { z } from 'zod';\nimport type { ToolWithHandler } from '../types';\nimport { zodToJsonSchema } from 'zod-to-json-schema';\n\n/**\n * Mastra tool definition interface\n */\nexport interface MastraTool {\n    id: string;\n    description?: string;\n    inputSchema?: z.ZodType<unknown>;\n    execute?: (context: { context: unknown }) => Promise<unknown>;\n}\n\n/**\n * Helper to convert Mastra tools to Granular tools\n * \n * @param mastraTools - Array of Mastra tools\n * @returns Array of Granular ToolWithHandler\n */\nexport function fromMastraTools(mastraTools: MastraTool[]): ToolWithHandler[] {\n    return mastraTools.map((tool) => {\n        const jsonSchema = tool.inputSchema ? zodToJsonSchema(tool.inputSchema) : {};\n\n        return {\n            name: tool.id, // Mastra uses ID as name\n            description: tool.description || '',\n            inputSchema: jsonSchema as Record<string, unknown>,\n            handler: async (input: any) => {\n                if (tool.execute) {\n                    return tool.execute({ context: input });\n                }\n                return {};\n            },\n        };\n    });\n}\n"]}

package/dist/adapters/openai.d.mts

@@ -1,76 +0,0 @@
-import { T as ToolWithHandler } from '../types-C0AVRsVR.mjs';
-
-/**
- * OpenAI tool call from chat completion response
- */
-interface OpenAIToolCall {
-    id: string;
-    type: 'function';
-    function: {
-        name: string;
-        arguments: string;
-    };
-}
-/**
- * OpenAI tool definition type
- */
-interface OpenAIToolDefinition {
-    type: 'function';
-    function: {
-        name: string;
-        description?: string;
-        parameters?: Record<string, unknown>;
-    };
-}
-/**
- * Helper to convert Granular tools to OpenAI tool definitions
- *
- * @param tools - Array of Granular tools
- * @returns Array of OpenAI tool definitions
- */
-declare function toOpenAITools(tools: ToolWithHandler[]): OpenAIToolDefinition[];
-/**
- * Helper to convert OpenAI tool calls to job code for Granular
- *
- * @param toolCalls - Array of tool calls from OpenAI response
- * @param customImports - Optional imports to add to top of job
- * @returns generated job code
- */
-declare function toolCallsToJobCode(toolCalls: OpenAIToolCall[], customImports?: string): string;
-/**
- * Create a single "codegen tool" for LLM consumption.
- *
- * Instead of passing N individual tools to the LLM, this returns a single
- * tool that accepts TypeScript code. The LLM writes code that uses the
- * available tools, and the code is executed in the sandbox.
- *
- * @param domainDocumentation - Documentation of available tools (from environment.getDomainDocumentation())
- * @returns A single OpenAI tool definition
- *
- * @example
- * ```typescript
- * const docs = await environment.getDomainDocumentation();
- * const codegenTool = createCodegenTool(docs);
- *
- * const response = await openai.chat.completions.create({
- *   model: 'gpt-4',
- *   messages: [...],
- *   tools: [codegenTool],
- * });
- * ```
- */
-declare function createCodegenTool(domainDocumentation: string): OpenAIToolDefinition;
-/**
- * Helper to execute a codegen tool call result.
- *
- * @param toolCall - The tool call from the OpenAI response
- * @param environment - The connected Granular environment
- * @returns The job result
- */
-declare function executeCodegenToolCall(toolCall: OpenAIToolCall, environment: {
-    submitJob: (code: string) => Promise<{
-        result: Promise<unknown>;
-    }>;
-}): Promise<unknown>;
-
-export { type OpenAIToolCall, type OpenAIToolDefinition, createCodegenTool, executeCodegenToolCall, toOpenAITools, toolCallsToJobCode };

package/dist/adapters/openai.d.ts

@@ -1,76 +0,0 @@
-import { T as ToolWithHandler } from '../types-C0AVRsVR.js';
-
-/**
- * OpenAI tool call from chat completion response
- */
-interface OpenAIToolCall {
-    id: string;
-    type: 'function';
-    function: {
-        name: string;
-        arguments: string;
-    };
-}
-/**
- * OpenAI tool definition type
- */
-interface OpenAIToolDefinition {
-    type: 'function';
-    function: {
-        name: string;
-        description?: string;
-        parameters?: Record<string, unknown>;
-    };
-}
-/**
- * Helper to convert Granular tools to OpenAI tool definitions
- *
- * @param tools - Array of Granular tools
- * @returns Array of OpenAI tool definitions
- */
-declare function toOpenAITools(tools: ToolWithHandler[]): OpenAIToolDefinition[];
-/**
- * Helper to convert OpenAI tool calls to job code for Granular
- *
- * @param toolCalls - Array of tool calls from OpenAI response
- * @param customImports - Optional imports to add to top of job
- * @returns generated job code
- */
-declare function toolCallsToJobCode(toolCalls: OpenAIToolCall[], customImports?: string): string;
-/**
- * Create a single "codegen tool" for LLM consumption.
- *
- * Instead of passing N individual tools to the LLM, this returns a single
- * tool that accepts TypeScript code. The LLM writes code that uses the
- * available tools, and the code is executed in the sandbox.
- *
- * @param domainDocumentation - Documentation of available tools (from environment.getDomainDocumentation())
- * @returns A single OpenAI tool definition
- *
- * @example
- * ```typescript
- * const docs = await environment.getDomainDocumentation();
- * const codegenTool = createCodegenTool(docs);
- *
- * const response = await openai.chat.completions.create({
- *   model: 'gpt-4',
- *   messages: [...],
- *   tools: [codegenTool],
- * });
- * ```
- */
-declare function createCodegenTool(domainDocumentation: string): OpenAIToolDefinition;
-/**
- * Helper to execute a codegen tool call result.
- *
- * @param toolCall - The tool call from the OpenAI response
- * @param environment - The connected Granular environment
- * @returns The job result
- */
-declare function executeCodegenToolCall(toolCall: OpenAIToolCall, environment: {
-    submitJob: (code: string) => Promise<{
-        result: Promise<unknown>;
-    }>;
-}): Promise<unknown>;
-
-export { type OpenAIToolCall, type OpenAIToolDefinition, createCodegenTool, executeCodegenToolCall, toOpenAITools, toolCallsToJobCode };

package/dist/adapters/openai.js

@@ -1,81 +0,0 @@
-'use strict';
-
-// src/adapters/openai.ts
-function toOpenAITools(tools) {
-  return tools.map((tool) => ({
-    type: "function",
-    function: {
-      name: tool.name,
-      description: tool.description,
-      parameters: tool.inputSchema
-    }
-  }));
-}
-function toolCallsToJobCode(toolCalls, customImports = "") {
-  if (!toolCalls || toolCalls.length === 0) {
-    return "";
-  }
-  let code = `
-        import { tools } from './sandbox-tools';
-        ${customImports}
-        const results = [];
-    `;
-  toolCalls.forEach((call) => {
-    code += `
-        try {
-            const result_${call.id.replace(/-/g, "_")} = await tools.${call.function.name}(${call.function.arguments});
-            results.push({ 
-                toolCallId: "${call.id}", 
-                tool: "${call.function.name}", 
-                result: result_${call.id.replace(/-/g, "_")} 
-            });
-        } catch (error) {
-            results.push({ 
-                toolCallId: "${call.id}", 
-                tool: "${call.function.name}", 
-                error: String(error) 
-            });
-        }
-        `;
-  });
-  code += `return results;`;
-  return code;
-}
-function createCodegenTool(domainDocumentation) {
-  return {
-    type: "function",
-    function: {
-      name: "execute_sandbox_code",
-      description: `Execute TypeScript code in a secure sandbox environment. The code can use the following tools by importing from "./sandbox-tools":
-
-${domainDocumentation}
-
-Write complete, executable TypeScript code. Use async/await for tool calls. Return results at the end.`,
-      parameters: {
-        type: "object",
-        properties: {
-          code: {
-            type: "string",
-            description: 'TypeScript code to execute. Must import tools from "./sandbox-tools" and use await for all tool calls.'
-          }
-        },
-        required: ["code"]
-      }
-    }
-  };
-}
-async function executeCodegenToolCall(toolCall, environment) {
-  if (toolCall.function.name !== "execute_sandbox_code") {
-    throw new Error(`Unknown tool: ${toolCall.function.name}`);
-  }
-  const args = JSON.parse(toolCall.function.arguments);
-  const job = await environment.submitJob(args.code);
-  return job.result;
-}
-
-exports.createCodegenTool = createCodegenTool;
-exports.executeCodegenToolCall = executeCodegenToolCall;
-exports.toOpenAITools = toOpenAITools;
-exports.toolCallsToJobCode = toolCallsToJobCode;
-//# sourceMappingURL=openai.js.map
-//# sourceMappingURL=openai.js.map

package/dist/adapters/openai.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/adapters/openai.ts"],"names":[],"mappings":";;;AAgCO,SAAS,cAAc,KAAA,EAAkD;AAC5E,EAAA,OAAO,KAAA,CAAM,IAAI,CAAA,IAAA,MAAS;AAAA,IACtB,IAAA,EAAM,UAAA;AAAA,IACN,QAAA,EAAU;AAAA,MACN,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,aAAa,IAAA,CAAK,WAAA;AAAA,MAClB,YAAY,IAAA,CAAK;AAAA;AACrB,GACJ,CAAE,CAAA;AACN;AASO,SAAS,kBAAA,CAAmB,SAAA,EAA6B,aAAA,GAAgB,EAAA,EAAY;AACxF,EAAA,IAAI,CAAC,SAAA,IAAa,SAAA,CAAU,MAAA,KAAW,CAAA,EAAG;AACtC,IAAA,OAAO,EAAA;AAAA,EACX;AAEA,EAAA,IAAI,IAAA,GAAO;AAAA;AAAA,QAAA,EAEL,aAAa;AAAA;AAAA,IAAA,CAAA;AAInB,EAAA,SAAA,CAAU,OAAA,CAAQ,CAAC,IAAA,KAAS;AAGxB,IAAA,IAAA,IAAQ;AAAA;AAAA,yBAAA,EAEW,IAAA,CAAK,EAAA,CAAG,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAC,CAAA,eAAA,EAAkB,IAAA,CAAK,QAAA,CAAS,IAAI,CAAA,CAAA,EAAI,IAAA,CAAK,SAAS,SAAS,CAAA;AAAA;AAAA,6BAAA,EAErF,KAAK,EAAE,CAAA;AAAA,uBAAA,EACb,IAAA,CAAK,SAAS,IAAI,CAAA;AAAA,+BAAA,EACV,IAAA,CAAK,EAAA,CAAG,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAC,CAAA;AAAA;AAAA;AAAA;AAAA,6BAAA,EAI5B,KAAK,EAAE,CAAA;AAAA,uBAAA,EACb,IAAA,CAAK,SAAS,IAAI,CAAA;AAAA;AAAA;AAAA;AAAA,QAAA,CAAA;AAAA,EAKvC,CAAC,CAAA;AAED,EAAA,IAAA,IAAQ,CAAA,eAAA,CAAA;AACR,EAAA,OAAO,IAAA;AACX;AAwBO,SAAS,kBAAkB,mBAAA,EAAmD;AACjF,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,UAAA;AAAA,IACN,QAAA,EAAU;AAAA,MACN,IAAA,EAAM,sBAAA;AAAA,MACN,WAAA,EAAa,CAAA;;AAAA,EAEvB,mBAAmB;;AAAA,sGAAA,CAAA;AAAA,MAGT,UAAA,EAAY;AAAA,QACR,IAAA,EAAM,QAAA;AAAA,QACN,UAAA,EAAY;AAAA,UACR,IAAA,EAAM;AAAA,YACF,IAAA,EAAM,QAAA;AAAA,YACN,WAAA,EAAa;AAAA;AACjB,SACJ;AAAA,QACA,QAAA,EAAU,CAAC,MAAM;AAAA;AACrB;AACJ,GACJ;AACJ;AASA,eAAsB,sBAAA,CAClB,UACA,WAAA,EACgB;AAChB,EAAA,IAAI,QAAA,CAAS,QAAA,CAAS,IAAA,KAAS,sBAAA,EAAwB;AACnD,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,cAAA,EAAiB,QAAA,CAAS,QAAA,CAAS,IAAI,CAAA,CAAE,CAAA;AAAA,EAC7D;AAEA,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,QAAA,CAAS,SAAS,SAAS,CAAA;AACnD,EAAA,MAAM,GAAA,GAAM,MAAM,WAAA,CAAY,SAAA,CAAU,KAAK,IAAI,CAAA;AACjD,EAAA,OAAO,GAAA,CAAI,MAAA;AACf","file":"openai.js","sourcesContent":["import type { ToolWithHandler } from '../types';\n\n/**\n * OpenAI tool call from chat completion response\n */\nexport interface OpenAIToolCall {\n    id: string;\n    type: 'function';\n    function: {\n        name: string;\n        arguments: string;\n    };\n}\n\n/**\n * OpenAI tool definition type\n */\nexport interface OpenAIToolDefinition {\n    type: 'function';\n    function: {\n        name: string;\n        description?: string;\n        parameters?: Record<string, unknown>;\n    };\n}\n\n/**\n * Helper to convert Granular tools to OpenAI tool definitions\n * \n * @param tools - Array of Granular tools\n * @returns Array of OpenAI tool definitions\n */\nexport function toOpenAITools(tools: ToolWithHandler[]): OpenAIToolDefinition[] {\n    return tools.map(tool => ({\n        type: 'function',\n        function: {\n            name: tool.name,\n            description: tool.description,\n            parameters: tool.inputSchema,\n        },\n    }));\n}\n\n/**\n * Helper to convert OpenAI tool calls to job code for Granular\n * \n * @param toolCalls - Array of tool calls from OpenAI response\n * @param customImports - Optional imports to add to top of job\n * @returns generated job code\n */\nexport function toolCallsToJobCode(toolCalls: OpenAIToolCall[], customImports = ''): string {\n    if (!toolCalls || toolCalls.length === 0) {\n        return '';\n    }\n\n    let code = `\n        import { tools } from './sandbox-tools';\n        ${customImports}\n        const results = [];\n    `;\n\n    toolCalls.forEach((call) => {\n        // Safe argument parsing\n        // We trust OpenAI arguments are JSON, but we stringify them again for the job\n        code += `\n        try {\n            const result_${call.id.replace(/-/g, '_')} = await tools.${call.function.name}(${call.function.arguments});\n            results.push({ \n                toolCallId: \"${call.id}\", \n                tool: \"${call.function.name}\", \n                result: result_${call.id.replace(/-/g, '_')} \n            });\n        } catch (error) {\n            results.push({ \n                toolCallId: \"${call.id}\", \n                tool: \"${call.function.name}\", \n                error: String(error) \n            });\n        }\n        `;\n    });\n\n    code += `return results;`;\n    return code;\n}\n\n/**\n * Create a single \"codegen tool\" for LLM consumption.\n * \n * Instead of passing N individual tools to the LLM, this returns a single\n * tool that accepts TypeScript code. The LLM writes code that uses the\n * available tools, and the code is executed in the sandbox.\n * \n * @param domainDocumentation - Documentation of available tools (from environment.getDomainDocumentation())\n * @returns A single OpenAI tool definition\n * \n * @example\n * ```typescript\n * const docs = await environment.getDomainDocumentation();\n * const codegenTool = createCodegenTool(docs);\n * \n * const response = await openai.chat.completions.create({\n *   model: 'gpt-4',\n *   messages: [...],\n *   tools: [codegenTool],\n * });\n * ```\n */\nexport function createCodegenTool(domainDocumentation: string): OpenAIToolDefinition {\n    return {\n        type: 'function',\n        function: {\n            name: 'execute_sandbox_code',\n            description: `Execute TypeScript code in a secure sandbox environment. The code can use the following tools by importing from \"./sandbox-tools\":\n\n${domainDocumentation}\n\nWrite complete, executable TypeScript code. Use async/await for tool calls. Return results at the end.`,\n            parameters: {\n                type: 'object',\n                properties: {\n                    code: {\n                        type: 'string',\n                        description: 'TypeScript code to execute. Must import tools from \"./sandbox-tools\" and use await for all tool calls.',\n                    },\n                },\n                required: ['code'],\n            },\n        },\n    };\n}\n\n/**\n * Helper to execute a codegen tool call result.\n * \n * @param toolCall - The tool call from the OpenAI response\n * @param environment - The connected Granular environment\n * @returns The job result\n */\nexport async function executeCodegenToolCall(\n    toolCall: OpenAIToolCall,\n    environment: { submitJob: (code: string) => Promise<{ result: Promise<unknown> }> }\n): Promise<unknown> {\n    if (toolCall.function.name !== 'execute_sandbox_code') {\n        throw new Error(`Unknown tool: ${toolCall.function.name}`);\n    }\n\n    const args = JSON.parse(toolCall.function.arguments) as { code: string };\n    const job = await environment.submitJob(args.code);\n    return job.result;\n}\n"]}

package/dist/adapters/openai.mjs

@@ -1,76 +0,0 @@
-// src/adapters/openai.ts
-function toOpenAITools(tools) {
-  return tools.map((tool) => ({
-    type: "function",
-    function: {
-      name: tool.name,
-      description: tool.description,
-      parameters: tool.inputSchema
-    }
-  }));
-}
-function toolCallsToJobCode(toolCalls, customImports = "") {
-  if (!toolCalls || toolCalls.length === 0) {
-    return "";
-  }
-  let code = `
-        import { tools } from './sandbox-tools';
-        ${customImports}
-        const results = [];
-    `;
-  toolCalls.forEach((call) => {
-    code += `
-        try {
-            const result_${call.id.replace(/-/g, "_")} = await tools.${call.function.name}(${call.function.arguments});
-            results.push({ 
-                toolCallId: "${call.id}", 
-                tool: "${call.function.name}", 
-                result: result_${call.id.replace(/-/g, "_")} 
-            });
-        } catch (error) {
-            results.push({ 
-                toolCallId: "${call.id}", 
-                tool: "${call.function.name}", 
-                error: String(error) 
-            });
-        }
-        `;
-  });
-  code += `return results;`;
-  return code;
-}
-function createCodegenTool(domainDocumentation) {
-  return {
-    type: "function",
-    function: {
-      name: "execute_sandbox_code",
-      description: `Execute TypeScript code in a secure sandbox environment. The code can use the following tools by importing from "./sandbox-tools":
-
-${domainDocumentation}
-
-Write complete, executable TypeScript code. Use async/await for tool calls. Return results at the end.`,
-      parameters: {
-        type: "object",
-        properties: {
-          code: {
-            type: "string",
-            description: 'TypeScript code to execute. Must import tools from "./sandbox-tools" and use await for all tool calls.'
-          }
-        },
-        required: ["code"]
-      }
-    }
-  };
-}
-async function executeCodegenToolCall(toolCall, environment) {
-  if (toolCall.function.name !== "execute_sandbox_code") {
-    throw new Error(`Unknown tool: ${toolCall.function.name}`);
-  }
-  const args = JSON.parse(toolCall.function.arguments);
-  const job = await environment.submitJob(args.code);
-  return job.result;
-}
-
-export { createCodegenTool, executeCodegenToolCall, toOpenAITools, toolCallsToJobCode };
-//# sourceMappingURL=openai.mjs.map
-//# sourceMappingURL=openai.mjs.map

package/dist/adapters/openai.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../../src/adapters/openai.ts"],"names":[],"mappings":";AAgCO,SAAS,cAAc,KAAA,EAAkD;AAC5E,EAAA,OAAO,KAAA,CAAM,IAAI,CAAA,IAAA,MAAS;AAAA,IACtB,IAAA,EAAM,UAAA;AAAA,IACN,QAAA,EAAU;AAAA,MACN,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,aAAa,IAAA,CAAK,WAAA;AAAA,MAClB,YAAY,IAAA,CAAK;AAAA;AACrB,GACJ,CAAE,CAAA;AACN;AASO,SAAS,kBAAA,CAAmB,SAAA,EAA6B,aAAA,GAAgB,EAAA,EAAY;AACxF,EAAA,IAAI,CAAC,SAAA,IAAa,SAAA,CAAU,MAAA,KAAW,CAAA,EAAG;AACtC,IAAA,OAAO,EAAA;AAAA,EACX;AAEA,EAAA,IAAI,IAAA,GAAO;AAAA;AAAA,QAAA,EAEL,aAAa;AAAA;AAAA,IAAA,CAAA;AAInB,EAAA,SAAA,CAAU,OAAA,CAAQ,CAAC,IAAA,KAAS;AAGxB,IAAA,IAAA,IAAQ;AAAA;AAAA,yBAAA,EAEW,IAAA,CAAK,EAAA,CAAG,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAC,CAAA,eAAA,EAAkB,IAAA,CAAK,QAAA,CAAS,IAAI,CAAA,CAAA,EAAI,IAAA,CAAK,SAAS,SAAS,CAAA;AAAA;AAAA,6BAAA,EAErF,KAAK,EAAE,CAAA;AAAA,uBAAA,EACb,IAAA,CAAK,SAAS,IAAI,CAAA;AAAA,+BAAA,EACV,IAAA,CAAK,EAAA,CAAG,OAAA,CAAQ,IAAA,EAAM,GAAG,CAAC,CAAA;AAAA;AAAA;AAAA;AAAA,6BAAA,EAI5B,KAAK,EAAE,CAAA;AAAA,uBAAA,EACb,IAAA,CAAK,SAAS,IAAI,CAAA;AAAA;AAAA;AAAA;AAAA,QAAA,CAAA;AAAA,EAKvC,CAAC,CAAA;AAED,EAAA,IAAA,IAAQ,CAAA,eAAA,CAAA;AACR,EAAA,OAAO,IAAA;AACX;AAwBO,SAAS,kBAAkB,mBAAA,EAAmD;AACjF,EAAA,OAAO;AAAA,IACH,IAAA,EAAM,UAAA;AAAA,IACN,QAAA,EAAU;AAAA,MACN,IAAA,EAAM,sBAAA;AAAA,MACN,WAAA,EAAa,CAAA;;AAAA,EAEvB,mBAAmB;;AAAA,sGAAA,CAAA;AAAA,MAGT,UAAA,EAAY;AAAA,QACR,IAAA,EAAM,QAAA;AAAA,QACN,UAAA,EAAY;AAAA,UACR,IAAA,EAAM;AAAA,YACF,IAAA,EAAM,QAAA;AAAA,YACN,WAAA,EAAa;AAAA;AACjB,SACJ;AAAA,QACA,QAAA,EAAU,CAAC,MAAM;AAAA;AACrB;AACJ,GACJ;AACJ;AASA,eAAsB,sBAAA,CAClB,UACA,WAAA,EACgB;AAChB,EAAA,IAAI,QAAA,CAAS,QAAA,CAAS,IAAA,KAAS,sBAAA,EAAwB;AACnD,IAAA,MAAM,IAAI,KAAA,CAAM,CAAA,cAAA,EAAiB,QAAA,CAAS,QAAA,CAAS,IAAI,CAAA,CAAE,CAAA;AAAA,EAC7D;AAEA,EAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,QAAA,CAAS,SAAS,SAAS,CAAA;AACnD,EAAA,MAAM,GAAA,GAAM,MAAM,WAAA,CAAY,SAAA,CAAU,KAAK,IAAI,CAAA;AACjD,EAAA,OAAO,GAAA,CAAI,MAAA;AACf","file":"openai.mjs","sourcesContent":["import type { ToolWithHandler } from '../types';\n\n/**\n * OpenAI tool call from chat completion response\n */\nexport interface OpenAIToolCall {\n    id: string;\n    type: 'function';\n    function: {\n        name: string;\n        arguments: string;\n    };\n}\n\n/**\n * OpenAI tool definition type\n */\nexport interface OpenAIToolDefinition {\n    type: 'function';\n    function: {\n        name: string;\n        description?: string;\n        parameters?: Record<string, unknown>;\n    };\n}\n\n/**\n * Helper to convert Granular tools to OpenAI tool definitions\n * \n * @param tools - Array of Granular tools\n * @returns Array of OpenAI tool definitions\n */\nexport function toOpenAITools(tools: ToolWithHandler[]): OpenAIToolDefinition[] {\n    return tools.map(tool => ({\n        type: 'function',\n        function: {\n            name: tool.name,\n            description: tool.description,\n            parameters: tool.inputSchema,\n        },\n    }));\n}\n\n/**\n * Helper to convert OpenAI tool calls to job code for Granular\n * \n * @param toolCalls - Array of tool calls from OpenAI response\n * @param customImports - Optional imports to add to top of job\n * @returns generated job code\n */\nexport function toolCallsToJobCode(toolCalls: OpenAIToolCall[], customImports = ''): string {\n    if (!toolCalls || toolCalls.length === 0) {\n        return '';\n    }\n\n    let code = `\n        import { tools } from './sandbox-tools';\n        ${customImports}\n        const results = [];\n    `;\n\n    toolCalls.forEach((call) => {\n        // Safe argument parsing\n        // We trust OpenAI arguments are JSON, but we stringify them again for the job\n        code += `\n        try {\n            const result_${call.id.replace(/-/g, '_')} = await tools.${call.function.name}(${call.function.arguments});\n            results.push({ \n                toolCallId: \"${call.id}\", \n                tool: \"${call.function.name}\", \n                result: result_${call.id.replace(/-/g, '_')} \n            });\n        } catch (error) {\n            results.push({ \n                toolCallId: \"${call.id}\", \n                tool: \"${call.function.name}\", \n                error: String(error) \n            });\n        }\n        `;\n    });\n\n    code += `return results;`;\n    return code;\n}\n\n/**\n * Create a single \"codegen tool\" for LLM consumption.\n * \n * Instead of passing N individual tools to the LLM, this returns a single\n * tool that accepts TypeScript code. The LLM writes code that uses the\n * available tools, and the code is executed in the sandbox.\n * \n * @param domainDocumentation - Documentation of available tools (from environment.getDomainDocumentation())\n * @returns A single OpenAI tool definition\n * \n * @example\n * ```typescript\n * const docs = await environment.getDomainDocumentation();\n * const codegenTool = createCodegenTool(docs);\n * \n * const response = await openai.chat.completions.create({\n *   model: 'gpt-4',\n *   messages: [...],\n *   tools: [codegenTool],\n * });\n * ```\n */\nexport function createCodegenTool(domainDocumentation: string): OpenAIToolDefinition {\n    return {\n        type: 'function',\n        function: {\n            name: 'execute_sandbox_code',\n            description: `Execute TypeScript code in a secure sandbox environment. The code can use the following tools by importing from \"./sandbox-tools\":\n\n${domainDocumentation}\n\nWrite complete, executable TypeScript code. Use async/await for tool calls. Return results at the end.`,\n            parameters: {\n                type: 'object',\n                properties: {\n                    code: {\n                        type: 'string',\n                        description: 'TypeScript code to execute. Must import tools from \"./sandbox-tools\" and use await for all tool calls.',\n                    },\n                },\n                required: ['code'],\n            },\n        },\n    };\n}\n\n/**\n * Helper to execute a codegen tool call result.\n * \n * @param toolCall - The tool call from the OpenAI response\n * @param environment - The connected Granular environment\n * @returns The job result\n */\nexport async function executeCodegenToolCall(\n    toolCall: OpenAIToolCall,\n    environment: { submitJob: (code: string) => Promise<{ result: Promise<unknown> }> }\n): Promise<unknown> {\n    if (toolCall.function.name !== 'execute_sandbox_code') {\n        throw new Error(`Unknown tool: ${toolCall.function.name}`);\n    }\n\n    const args = JSON.parse(toolCall.function.arguments) as { code: string };\n    const job = await environment.submitJob(args.code);\n    return job.result;\n}\n"]}