@agnt-sdk/studio 0.0.1

package/dist/providers/google.js

@@ -0,0 +1,357 @@
+/**
+ * GoogleExecutor - Provider adapter for Google Gemini models
+ *
+ * Uses native @google/generative-ai SDK
+ */
+import { GoogleGenerativeAI } from '@google/generative-ai';
+import BaseExecutor from '../BaseExecutor.js';
+export default class GoogleExecutor extends BaseExecutor {
+    client;
+    constructor(config) {
+        super(config);
+        // Get Google credentials
+        const googleCreds = this.credentials.google;
+        if (!googleCreds) {
+            throw new Error('[GoogleExecutor] credentials.google is required');
+        }
+        if (!googleCreds.apiKey) {
+            throw new Error('[GoogleExecutor] credentials.google.apiKey is required');
+        }
+        // Browser safety check
+        const isBrowser = typeof globalThis !== 'undefined' &&
+            typeof globalThis.window !== 'undefined';
+        if (isBrowser && !googleCreds.dangerouslyAllowBrowser) {
+            throw new Error('[GoogleExecutor] Using API keys in the browser is unsafe. ' +
+                'Set dangerouslyAllowBrowser: true in credentials.google to acknowledge the risk.');
+        }
+        // Initialize Google client
+        this.client = new GoogleGenerativeAI(googleCreds.apiKey);
+        this.log(`[GoogleExecutor] Initialized with model: ${this.model}`);
+    }
+    /**
+     * Invoke Google Gemini API
+     * Returns: { message: { role, content, tool_calls }, usage: { input_tokens, output_tokens } }
+     */
+    async invoke(messages, options = {}) {
+        // Extract provider-specific parameters from model config
+        const providerParams = this.#extractProviderParams();
+        // Format messages for Gemini (separate system from conversation)
+        const { systemInstruction, contents } = this.#formatMessages(messages);
+        // Build model config
+        const modelConfig = {
+            ...providerParams
+        };
+        // Add tools if provided
+        if (options.tools && options.tools.length > 0) {
+            const tools = this.#formatTools(options.tools);
+            modelConfig.tools = tools;
+            // Handle tool_choice
+            if (options.tool_choice === 'required') {
+                // Gemini doesn't have a direct equivalent to "required"
+                // We'll use function calling mode ANY
+                modelConfig.toolConfig = {
+                    functionCallingConfig: {
+                        mode: 'ANY'
+                    }
+                };
+            }
+        }
+        // Get generative model
+        const model = this.client.getGenerativeModel({
+            model: this.model,
+            systemInstruction,
+            ...modelConfig
+        });
+        this.log('[GoogleExecutor] Invoking:', {
+            model: this.model,
+            temperature: providerParams.temperature,
+            topP: providerParams.topP,
+            tools: options.tools?.length || 0
+        });
+        // Call Gemini API
+        const result = await model.generateContent({
+            contents
+        });
+        const response = result.response;
+        const candidate = response.candidates?.[0];
+        if (!candidate) {
+            throw new Error('[GoogleExecutor] No candidate in response');
+        }
+        // Extract content and tool calls
+        const textContent = this.#extractTextContent(candidate.content);
+        const toolCalls = this.#extractToolCalls(candidate.content);
+        // Extract usage
+        // Include thoughtsTokenCount (Gemini 2.5+) in output tokens since it's generated reasoning
+        const metadata = response.usageMetadata;
+        const thoughtsTokens = metadata?.thoughtsTokenCount || 0;
+        const usage = {
+            input_tokens: response.usageMetadata?.promptTokenCount || 0,
+            output_tokens: (response.usageMetadata?.candidatesTokenCount || 0) + thoughtsTokens
+        };
+        // Format response to match expected structure
+        return {
+            message: {
+                role: 'assistant',
+                content: textContent,
+                tool_calls: toolCalls
+            },
+            usage
+        };
+    }
+    /**
+     * Check if message has tool calls
+     */
+    hasToolCalls(message) {
+        return Boolean(message?.tool_calls && message.tool_calls.length > 0);
+    }
+    /**
+     * Format messages for Gemini API
+     * Gemini expects: systemInstruction (string) + contents (Content[])
+     * Content = { role: 'user' | 'model', parts: Part[] }
+     */
+    #formatMessages(messages) {
+        const systemMessages = messages.filter(m => m.role === 'system');
+        const systemInstruction = systemMessages.map(m => m.content).join('\n\n');
+        const contents = [];
+        for (const msg of messages) {
+            // Skip system messages (handled separately)
+            if (msg.role === 'system') {
+                continue;
+            }
+            // Handle tool messages
+            if (msg.role === 'tool') {
+                // For Google, tool_call_id IS the function name (we set id = name in extractToolCalls)
+                const toolName = msg.tool_call_id || msg.name || 'unknown';
+                // Tool results go into a 'function' part with a 'functionResponse'
+                contents.push({
+                    role: 'function',
+                    parts: [
+                        {
+                            functionResponse: {
+                                name: toolName,
+                                response: JSON.parse(msg.content)
+                            }
+                        }
+                    ]
+                });
+                continue;
+            }
+            // Handle assistant messages with tool_calls
+            if (msg.role === 'assistant' && msg.tool_calls && msg.tool_calls.length > 0) {
+                const parts = [];
+                // Add text content if present
+                if (msg.content) {
+                    parts.push({
+                        text: typeof msg.content === 'string' ? msg.content : JSON.stringify(msg.content)
+                    });
+                }
+                // Add function calls
+                for (const toolCall of msg.tool_calls) {
+                    parts.push({
+                        functionCall: {
+                            name: toolCall.name,
+                            args: toolCall.args
+                        }
+                    });
+                }
+                contents.push({
+                    role: 'model',
+                    parts
+                });
+                continue;
+            }
+            // Handle regular user/assistant messages
+            const role = msg.role === 'assistant' ? 'model' : 'user';
+            if (typeof msg.content === 'string') {
+                contents.push({
+                    role,
+                    parts: [{ text: msg.content }]
+                });
+            }
+            else if (Array.isArray(msg.content)) {
+                // Handle multimodal content
+                const parts = this.#formatMultimodalContent(msg.content);
+                contents.push({
+                    role,
+                    parts
+                });
+            }
+        }
+        return {
+            systemInstruction: systemInstruction || undefined,
+            contents
+        };
+    }
+    /**
+     * Format multimodal content (text + images)
+     */
+    #formatMultimodalContent(content) {
+        const parts = [];
+        for (const item of content) {
+            if (item.type === 'text') {
+                parts.push({ text: item.text });
+            }
+            else if (item.type === 'image_url') {
+                // Gemini expects inline data
+                const imageUrl = item.image_url?.url || item.image_url;
+                if (imageUrl.startsWith('data:')) {
+                    // Extract base64 data
+                    const match = imageUrl.match(/^data:([^;]+);base64,(.+)$/);
+                    if (match) {
+                        parts.push({
+                            inlineData: {
+                                mimeType: match[1],
+                                data: match[2]
+                            }
+                        });
+                    }
+                }
+            }
+        }
+        return parts;
+    }
+    /**
+     * Format tools for Gemini
+     * Gemini expects: { functionDeclarations: FunctionDeclaration[] }[]
+     */
+    #formatTools(tools) {
+        const functionDeclarations = [];
+        for (const tool of tools) {
+            let functionDef;
+            // OpenAI format: { type: "function", function: { name, description, parameters } }
+            if (tool.type === 'function' && tool.function) {
+                functionDef = {
+                    name: tool.function.name,
+                    description: tool.function.description || '',
+                    parameters: this.#cleanParametersForGemini(tool.function.parameters)
+                };
+            }
+            // Anthropic format: { name, description, input_schema }
+            else if (tool.input_schema) {
+                functionDef = {
+                    name: tool.name,
+                    description: tool.description || '',
+                    parameters: this.#cleanParametersForGemini(tool.input_schema)
+                };
+            }
+            // Studio format: { name, description, parameters }
+            else if (tool.parameters) {
+                functionDef = {
+                    name: tool.name,
+                    description: tool.description || '',
+                    parameters: this.#cleanParametersForGemini(tool.parameters)
+                };
+            }
+            if (functionDef) {
+                functionDeclarations.push(functionDef);
+            }
+        }
+        return [{ functionDeclarations }];
+    }
+    /**
+     * Clean parameters to only include fields Gemini supports
+     * Uses whitelist approach for standard JSON Schema fields
+     */
+    #cleanParametersForGemini(parameters) {
+        if (!parameters || typeof parameters !== 'object') {
+            return parameters;
+        }
+        // Handle arrays
+        if (Array.isArray(parameters)) {
+            return parameters.map(item => this.#cleanParametersForGemini(item));
+        }
+        // Whitelist of JSON Schema fields that Gemini supports
+        // NOTE: Gemini has strict limits on schema complexity. We only include
+        // the most basic fields to avoid "too many states" errors.
+        // Excluded: format, minimum, maximum, minLength, maxLength, pattern, minItems, maxItems
+        // These create constraints that can exceed Gemini's serving limits.
+        const allowedFields = [
+            'type',
+            'properties',
+            'required',
+            'description',
+            'items',
+            'enum',
+            'default',
+            'nullable',
+            'anyOf',
+            'allOf',
+            'oneOf'
+        ];
+        const cleaned = {};
+        for (const key of allowedFields) {
+            if (key in parameters) {
+                // Recursively clean nested objects (properties, items, etc.)
+                if (key === 'properties' && typeof parameters[key] === 'object') {
+                    cleaned[key] = {};
+                    for (const propKey in parameters[key]) {
+                        const cleanedProp = this.#cleanParametersForGemini(parameters[key][propKey]);
+                        // Only include property if it has at least one field after cleaning
+                        if (cleanedProp && typeof cleanedProp === 'object' && Object.keys(cleanedProp).length > 0) {
+                            cleaned[key][propKey] = cleanedProp;
+                        }
+                    }
+                }
+                else if (key === 'items' && typeof parameters[key] === 'object') {
+                    cleaned[key] = this.#cleanParametersForGemini(parameters[key]);
+                }
+                else if ((key === 'anyOf' || key === 'allOf' || key === 'oneOf') && Array.isArray(parameters[key])) {
+                    cleaned[key] = parameters[key].map((item) => this.#cleanParametersForGemini(item));
+                }
+                else {
+                    cleaned[key] = parameters[key];
+                }
+            }
+        }
+        // Filter the 'required' array to only include properties that exist in cleaned.properties
+        // This prevents Gemini errors when required references non-existent properties
+        if (cleaned.required && Array.isArray(cleaned.required) && cleaned.properties) {
+            cleaned.required = cleaned.required.filter((propName) => propName in cleaned.properties);
+            // Remove required array if it's empty
+            if (cleaned.required.length === 0) {
+                delete cleaned.required;
+            }
+        }
+        return cleaned;
+    }
+    /**
+     * Extract text content from Gemini response
+     */
+    #extractTextContent(content) {
+        if (!content.parts || content.parts.length === 0) {
+            return '';
+        }
+        const textParts = content.parts
+            .filter(part => 'text' in part)
+            .map(part => part.text);
+        return textParts.join('');
+    }
+    /**
+     * Extract tool calls from Gemini response
+     */
+    #extractToolCalls(content) {
+        if (!content.parts || content.parts.length === 0) {
+            return [];
+        }
+        const toolCalls = [];
+        for (const part of content.parts) {
+            if ('functionCall' in part && part.functionCall) {
+                toolCalls.push({
+                    id: part.functionCall.name, // Use function name as ID since Google doesn't provide IDs
+                    name: part.functionCall.name,
+                    args: part.functionCall.args || {}
+                });
+            }
+        }
+        return toolCalls;
+    }
+    /**
+     * Extract provider-specific parameters from model config
+     */
+    #extractProviderParams() {
+        const metadata = this.primaryModelConfig.metadata || {};
+        const { displayName, ...providerParams } = metadata;
+        return providerParams;
+    }
+}
+//# sourceMappingURL=google.js.map

package/dist/providers/google.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"google.js","sourceRoot":"","sources":["../../src/providers/google.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,kBAAkB,EAA4C,MAAM,uBAAuB,CAAC;AACrG,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAG9C,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,YAAY;IAC9C,MAAM,CAAqB;IAEnC,YAAY,MAA0B;QACpC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEd,yBAAyB;QACzB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QAC5C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;QACrE,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;QAC5E,CAAC;QAED,uBAAuB;QACvB,MAAM,SAAS,GAAG,OAAO,UAAU,KAAK,WAAW;YACjC,OAAQ,UAAkB,CAAC,MAAM,KAAK,WAAW,CAAC;QACpE,IAAI,SAAS,IAAI,CAAC,WAAW,CAAC,uBAAuB,EAAE,CAAC;YACtD,MAAM,IAAI,KAAK,CACb,4DAA4D;gBAC5D,kFAAkF,CACnF,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QAEzD,IAAI,CAAC,GAAG,CAAC,4CAA4C,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,QAAmB,EAAE,UAAyB,EAAE;QAC3D,yDAAyD;QACzD,MAAM,cAAc,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QAErD,iEAAiE;QACjE,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAEvE,qBAAqB;QACrB,MAAM,WAAW,GAAQ;YACvB,GAAG,cAAc;SAClB,CAAC;QAEF,wBAAwB;QACxB,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YAC/C,WAAW,CAAC,KAAK,GAAG,KAAK,CAAC;YAE1B,qBAAqB;YACrB,IAAI,OAAO,CAAC,WAAW,KAAK,UAAU,EAAE,CAAC;gBACvC,wDAAwD;gBACxD,sCAAsC;gBACtC,WAAW,CAAC,UAAU,GAAG;oBACvB,qBAAqB,EAAE;wBACrB,IAAI,EAAE,KAAK;qBACZ;iBACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,uBAAuB;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,kBAAkB,CAAC;YAC3C,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,iBAAiB;YACjB,GAAG,WAAW;SACf,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,4BAA4B,EAAE;YACrC,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,WAAW,EAAE,cAAc,CAAC,WAAW;YACvC,IAAI,EAAE,cAAc,CAAC,IAAI;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC;SAClC,CAAC,CAAC;QAEH,kBAAkB;QAClB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC;YACzC,QAAQ;SACT,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;QACjC,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QAE3C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,CAAC;QAED,iCAAiC;QACjC,MAAM,WAAW,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAE5D,gBAAgB;QAChB,2FAA2F;QAC3F,MAAM,QAAQ,GAAG,QAAQ,CAAC,aAAoB,CAAC;QAC/C,MAAM,cAAc,GAAG,QAAQ,EAAE,kBAAkB,IAAI,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG;YACZ,YAAY,EAAE,QAAQ,CAAC,aAAa,EAAE,gBAAgB,IAAI,CAAC;YAC3D,aAAa,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,oBAAoB,IAAI,CAAC,CAAC,GAAG,cAAc;SACpF,CAAC;QAEF,8CAA8C;QAC9C,OAAO;YACL,OAAO,EAAE;gBACP,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,WAAW;gBACpB,UAAU,EAAE,SAAS;aACtB;YACD,KAAK;SACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,OAAgB;QAC3B,OAAO,OAAO,CAAC,OAAO,EAAE,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvE,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,QAAmB;QACjC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;QACjE,MAAM,iBAAiB,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE1E,MAAM,QAAQ,GAAc,EAAE,CAAC;QAE/B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;YAC3B,4CAA4C;YAC5C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1B,SAAS;YACX,CAAC;YAED,uBAAuB;YACvB,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACxB,uFAAuF;gBACvF,MAAM,QAAQ,GAAG,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,IAAI,IAAI,SAAS,CAAC;gBAE3D,mEAAmE;gBACnE,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,UAAU;oBAChB,KAAK,EAAE;wBACL;4BACE,gBAAgB,EAAE;gCAChB,IAAI,EAAE,QAAQ;gCACd,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,OAAiB,CAAC;6BAC5C;yBACF;qBACF;iBACF,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,4CAA4C;YAC5C,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5E,MAAM,KAAK,GAAW,EAAE,CAAC;gBAEzB,8BAA8B;gBAC9B,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;oBAChB,KAAK,CAAC,IAAI,CAAC;wBACT,IAAI,EAAE,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC;qBAClF,CAAC,CAAC;gBACL,CAAC;gBAED,qBAAqB;gBACrB,KAAK,MAAM,QAAQ,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;oBACtC,KAAK,CAAC,IAAI,CAAC;wBACT,YAAY,EAAE;4BACZ,IAAI,EAAE,QAAQ,CAAC,IAAI;4BACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;yBACpB;qBACF,CAAC,CAAC;gBACL,CAAC;gBAED,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,OAAO;oBACb,KAAK;iBACN,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,yCAAyC;YACzC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC;YAEzD,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACpC,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI;oBACJ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;iBAC/B,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACtC,4BAA4B;gBAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACzD,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI;oBACJ,KAAK;iBACN,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO;YACL,iBAAiB,EAAE,iBAAiB,IAAI,SAAS;YACjD,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,wBAAwB,CAAC,OAAc;QACrC,MAAM,KAAK,GAAW,EAAE,CAAC;QAEzB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzB,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAClC,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;gBACrC,6BAA6B;gBAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC;gBACvD,IAAI,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;oBACjC,sBAAsB;oBACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;oBAC3D,IAAI,KAAK,EAAE,CAAC;wBACV,KAAK,CAAC,IAAI,CAAC;4BACT,UAAU,EAAE;gCACV,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC;gCAClB,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;6BACf;yBACF,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAAY;QACvB,MAAM,oBAAoB,GAA0B,EAAE,CAAC;QAEvD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,WAAgB,CAAC;YAErB,mFAAmF;YACnF,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAC9C,WAAW,GAAG;oBACZ,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI;oBACxB,WAAW,EAAE,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE;oBAC5C,UAAU,EAAE,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;iBACrE,CAAC;YACJ,CAAC;YACD,wDAAwD;iBACnD,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC3B,WAAW,GAAG;oBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;oBACnC,UAAU,EAAE,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,YAAY,CAAC;iBAC9D,CAAC;YACJ,CAAC;YACD,mDAAmD;iBAC9C,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBACzB,WAAW,GAAG;oBACZ,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,EAAE;oBACnC,UAAU,EAAE,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC;iBAC5D,CAAC;YACJ,CAAC;YAED,IAAI,WAAW,EAAE,CAAC;gBAChB,oBAAoB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACzC,CAAC;QACH,CAAC;QAED,OAAO,CAAC,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACpC,CAAC;IAED;;;OAGG;IACH,yBAAyB,CAAC,UAAe;QACvC,IAAI,CAAC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;YAClD,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,gBAAgB;QAChB,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,CAAC;QAED,uDAAuD;QACvD,uEAAuE;QACvE,2DAA2D;QAC3D,wFAAwF;QACxF,oEAAoE;QACpE,MAAM,aAAa,GAAG;YACpB,MAAM;YACN,YAAY;YACZ,UAAU;YACV,aAAa;YACb,OAAO;YACP,MAAM;YACN,SAAS;YACT,UAAU;YACV,OAAO;YACP,OAAO;YACP,OAAO;SACR,CAAC;QAEF,MAAM,OAAO,GAAQ,EAAE,CAAC;QAExB,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,GAAG,IAAI,UAAU,EAAE,CAAC;gBACtB,6DAA6D;gBAC7D,IAAI,GAAG,KAAK,YAAY,IAAI,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAChE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;oBAClB,KAAK,MAAM,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;wBACtC,MAAM,WAAW,GAAG,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;wBAC7E,oEAAoE;wBACpE,IAAI,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;4BAC1F,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC;wBACtC,CAAC;oBACH,CAAC;gBACH,CAAC;qBAAM,IAAI,GAAG,KAAK,OAAO,IAAI,OAAO,UAAU,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE,CAAC;oBAClE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,yBAAyB,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;gBACjE,CAAC;qBAAM,IAAI,CAAC,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,OAAO,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;oBACrG,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC1F,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;QACH,CAAC;QAED,0FAA0F;QAC1F,+EAA+E;QAC/E,IAAI,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YAC9E,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAgB,EAAE,EAAE,CAC9D,QAAQ,IAAI,OAAO,CAAC,UAAU,CAC/B,CAAC;YAEF,sCAAsC;YACtC,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,OAAO,OAAO,CAAC,QAAQ,CAAC;YAC1B,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,OAAgB;QAClC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK;aAC5B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,IAAI,IAAI,CAAC;aAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,CAAE,IAAY,CAAC,IAAI,CAAC,CAAC;QAEnC,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,OAAgB;QAChC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACjD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,SAAS,GAAU,EAAE,CAAC;QAE5B,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,IAAI,cAAc,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBAChD,SAAS,CAAC,IAAI,CAAC;oBACb,EAAE,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,2DAA2D;oBACvF,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI;oBAC5B,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,IAAI,IAAI,EAAE;iBACnC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,sBAAsB;QACpB,MAAM,QAAQ,GAAI,IAAI,CAAC,kBAA0B,CAAC,QAAQ,IAAI,EAAE,CAAC;QACjE,MAAM,EAAE,WAAW,EAAE,GAAG,cAAc,EAAE,GAAG,QAAQ,CAAC;QACpD,OAAO,cAAc,CAAC;IACxB,CAAC;CACF"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,22 @@
+/**
+ * OpenAIExecutor - Provider adapter for OpenAI models
+ *
+ * Uses native openai SDK (not LangChain)
+ */
+import BaseExecutor from '../BaseExecutor.js';
+import type { BaseExecutorConfig, Message, InvokeOptions, InvokeResult } from '../types.js';
+export default class OpenAIExecutor extends BaseExecutor {
+    #private;
+    private client;
+    constructor(config: BaseExecutorConfig);
+    /**
+     * Invoke OpenAI API
+     * Returns: { message: { role, content, tool_calls }, usage: { input_tokens, output_tokens } }
+     */
+    invoke(messages: Message[], options?: InvokeOptions): Promise<InvokeResult>;
+    /**
+     * Check if message has tool calls
+     */
+    hasToolCalls(message: Message): boolean;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/providers/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/providers/openai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE5F,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,YAAY;;IACtD,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,kBAAkB;IAqBtC;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IAiDrF;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO;CAoIxC"}

package/dist/providers/openai.js

@@ -0,0 +1,194 @@
+/**
+ * OpenAIExecutor - Provider adapter for OpenAI models
+ *
+ * Uses native openai SDK (not LangChain)
+ */
+import OpenAI from 'openai';
+import BaseExecutor from '../BaseExecutor.js';
+export default class OpenAIExecutor extends BaseExecutor {
+    client;
+    constructor(config) {
+        super(config);
+        // Get OpenAI credentials
+        const openaiCreds = this.credentials.openai;
+        if (!openaiCreds) {
+            throw new Error('[OpenAIExecutor] credentials.openai is required');
+        }
+        if (!openaiCreds.apiKey) {
+            throw new Error('[OpenAIExecutor] credentials.openai.apiKey is required');
+        }
+        // Initialize OpenAI client
+        this.client = new OpenAI({
+            apiKey: openaiCreds.apiKey,
+            dangerouslyAllowBrowser: openaiCreds.dangerouslyAllowBrowser
+        });
+        this.log(`[OpenAIExecutor] Initialized with model: ${this.model}`);
+    }
+    /**
+     * Invoke OpenAI API
+     * Returns: { message: { role, content, tool_calls }, usage: { input_tokens, output_tokens } }
+     */
+    async invoke(messages, options = {}) {
+        // Build request parameters
+        const params = {
+            model: this.model,
+            messages: this.#formatMessages(messages),
+        };
+        // Add all provider-specific parameters from model config
+        // This passes through any OpenAI API params: temperature, top_p, reasoning, etc.
+        const providerParams = this.#extractProviderParams();
+        Object.assign(params, providerParams);
+        // Add tools if provided
+        if (options.tools && options.tools.length > 0) {
+            params.tools = options.tools.map(t => this.#formatTool(t));
+        }
+        // Add tool_choice if specified
+        if (options.tool_choice && options.tool_choice !== 'auto') {
+            params.tool_choice = this.#formatToolChoice(options.tool_choice);
+        }
+        this.log('[OpenAIExecutor] Invoking:', {
+            model: params.model,
+            temperature: params.temperature,
+            top_p: params.top_p,
+            tools: params.tools?.length || 0
+        });
+        // Call OpenAI API
+        const response = await this.client.chat.completions.create(params);
+        const choice = response.choices[0];
+        const message = choice.message;
+        // Format response to match expected structure
+        return {
+            message: {
+                role: message.role,
+                content: message.content || '',
+                tool_calls: this.#extractToolCalls(message.tool_calls)
+            },
+            usage: {
+                input_tokens: response.usage.prompt_tokens,
+                output_tokens: response.usage.completion_tokens
+            }
+        };
+    }
+    /**
+     * Check if message has tool calls
+     */
+    hasToolCalls(message) {
+        return Boolean(message?.tool_calls && message.tool_calls.length > 0);
+    }
+    /**
+     * Format messages for OpenAI API
+     */
+    #formatMessages(messages) {
+        return messages.map(msg => {
+            // Handle tool messages
+            if (msg.role === 'tool') {
+                return {
+                    role: 'tool',
+                    tool_call_id: msg.tool_call_id,
+                    content: msg.content
+                };
+            }
+            // Handle regular messages
+            return {
+                role: msg.role,
+                content: msg.content
+            };
+        });
+    }
+    /**
+     * Format tool definition for OpenAI
+     * OpenAI expects: { type: "function", function: { name, description, parameters } }
+     */
+    #formatTool(tool) {
+        // Already in OpenAI format: { type: "function", function: { name, description, parameters } }
+        if (tool.type === 'function' && tool.function) {
+            return tool;
+        }
+        // If has function field but no type (partial OpenAI format)
+        if (tool.function) {
+            return {
+                type: 'function',
+                function: tool.function
+            };
+        }
+        // Anthropic format: { name, description, input_schema } - convert to OpenAI
+        if (tool.input_schema) {
+            return {
+                type: 'function',
+                function: {
+                    name: tool.name,
+                    description: tool.description || '',
+                    parameters: tool.input_schema
+                }
+            };
+        }
+        // Studio format: { name, description, parameters } - convert to OpenAI format
+        if (tool.parameters) {
+            return {
+                type: 'function',
+                function: {
+                    name: tool.name,
+                    description: tool.description || '',
+                    parameters: tool.parameters
+                }
+            };
+        }
+        // Fallback: wrap in OpenAI format
+        this.log('[OpenAIExecutor] Warning: Unrecognized tool format:', JSON.stringify(tool));
+        return {
+            type: 'function',
+            function: {
+                name: tool.name || 'unknown',
+                description: tool.description || '',
+                parameters: tool.parameters || tool.input_schema || { type: 'object', properties: {} }
+            }
+        };
+    }
+    /**
+     * Format tool_choice for OpenAI
+     */
+    #formatToolChoice(toolChoice) {
+        if (typeof toolChoice === 'string') {
+            // "required" or "any" -> "required"
+            if (toolChoice === 'required' || toolChoice === 'any') {
+                return 'required';
+            }
+            return 'auto';
+        }
+        // If it's a specific tool: { type: "function", function: { name: "..." } }
+        if (toolChoice.type === 'function' || toolChoice.function?.name) {
+            return toolChoice;
+        }
+        // Anthropic format: { type: "tool", name: "..." }
+        if (toolChoice.type === 'tool' && toolChoice.name) {
+            return {
+                type: 'function',
+                function: { name: toolChoice.name }
+            };
+        }
+        return 'auto';
+    }
+    /**
+     * Extract tool calls from OpenAI response
+     */
+    #extractToolCalls(toolCalls) {
+        if (!toolCalls || toolCalls.length === 0) {
+            return [];
+        }
+        return toolCalls.map(tc => ({
+            id: tc.id,
+            name: tc.function.name,
+            args: JSON.parse(tc.function.arguments)
+        }));
+    }
+    /**
+     * Extract provider-specific parameters from model config
+     * Excludes displayName, passes rest to OpenAI API
+     */
+    #extractProviderParams() {
+        const metadata = this.primaryModelConfig.metadata || {};
+        const { displayName, ...providerParams } = metadata;
+        return providerParams;
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/providers/openai.js.map

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

package/dist/systemTools.d.ts

@@ -0,0 +1,6 @@
+/**
+ * System tool names — tools that are handled natively by the executor/platform.
+ * Tool calls NOT in this set are considered 'custom' and may trigger pause/resume.
+ */
+export declare const SYSTEM_TOOL_NAMES: Set<string>;
+//# sourceMappingURL=systemTools.d.ts.map

package/dist/systemTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemTools.d.ts","sourceRoot":"","sources":["../src/systemTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAS5B,CAAC"}

package/dist/systemTools.js

@@ -0,0 +1,15 @@
+/**
+ * System tool names — tools that are handled natively by the executor/platform.
+ * Tool calls NOT in this set are considered 'custom' and may trigger pause/resume.
+ */
+export const SYSTEM_TOOL_NAMES = new Set([
+    'finish_agent_run',
+    'output',
+    'web_search',
+    'get_weather',
+    'perform_calculation',
+    // Skill plugin tools — resolved at execution time from mounted skills
+    'fetch_skills',
+    'read_skill',
+]);
+//# sourceMappingURL=systemTools.js.map

package/dist/systemTools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"systemTools.js","sourceRoot":"","sources":["../src/systemTools.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IACvC,kBAAkB;IAClB,QAAQ;IACR,YAAY;IACZ,aAAa;IACb,qBAAqB;IACrB,sEAAsE;IACtE,cAAc;IACd,YAAY;CACb,CAAC,CAAC"}

package/dist/tracing.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Tracing Utilities
+ *
+ * Fire-and-forget trace payloads to the observability API.
+ */
+import type { TracingConfig, Message, PromptManifestV2 } from './types.js';
+export interface TracePayload {
+    promptName: string;
+    manifest: PromptManifestV2;
+    etag: string | null;
+    variables: Record<string, any>;
+    messages: Message[];
+    output: any;
+    inputTokens: number;
+    outputTokens: number;
+    totalTokens: number;
+    cost: number;
+    duration: number;
+    model: {
+        provider: string;
+        name: string;
+        metadata: Record<string, any>;
+    };
+    status: string;
+    metadata: Record<string, any>;
+    tags: string[];
+}
+/**
+ * Send trace to observability API (fire-and-forget — does not block execution)
+ */
+export declare function sendTrace(tracing: TracingConfig, payload: TracePayload, log: (message: string, ...args: any[]) => void): Promise<void>;
+//# sourceMappingURL=tracing.d.ts.map