@bluefly/openstandardagents 0.2.8 → 0.3.0

package/dist/services/runtime/azure.adapter.js

@@ -0,0 +1,515 @@
+/**
+ * Azure OpenAI Runtime Adapter
+ * Runs OSSA agents using Azure OpenAI's function calling API with streaming and tool support
+ *
+ * This adapter extends the OpenAI SDK with Azure-specific configuration:
+ * - Custom endpoint URLs (Azure OpenAI resource endpoints)
+ * - API version headers (Azure requires explicit API versioning)
+ * - Deployment names (Azure uses deployment names instead of model names)
+ *
+ * @example Basic Usage
+ * ```typescript
+ * const manifest: OssaManifest = {
+ *   apiVersion: 'v0.3.0',
+ *   kind: 'Agent',
+ *   metadata: { name: 'my-agent' },
+ *   spec: { role: 'Assistant' },
+ *   extensions: {
+ *     azure: {
+ *       endpoint: 'https://my-resource.openai.azure.com',
+ *       deployment: 'gpt-4o-mini',
+ *       api_version: '2024-02-15-preview'
+ *     }
+ *   }
+ * };
+ *
+ * const adapter = new AzureAdapter(manifest);
+ * adapter.initialize();
+ * const response = await adapter.chat('Hello!');
+ * ```
+ */
+import OpenAI from 'openai';
+/**
+ * Azure OpenAI Runtime Adapter
+ *
+ * This adapter bridges OSSA agent manifests to Azure OpenAI's API, handling:
+ * - Azure-specific authentication and endpoint configuration
+ * - Deployment name mapping (Azure uses deployments instead of model names)
+ * - API version headers required by Azure
+ * - Function calling and tool execution
+ * - Multi-turn conversations with tool support
+ *
+ * Configuration Priority (highest to lowest):
+ * 1. extensions.azure.* (Azure-specific settings)
+ * 2. spec.llm.* (Generic LLM settings)
+ * 3. Hard-coded defaults
+ */
+export class AzureAdapter {
+    client;
+    manifest;
+    tools = new Map();
+    messages = [];
+    deployment;
+    /**
+     * Creates a new Azure OpenAI adapter instance
+     *
+     * @param manifest - OSSA agent manifest with Azure configuration in extensions.azure
+     * @param apiKey - Azure OpenAI API key (optional, falls back to AZURE_OPENAI_API_KEY env var)
+     *
+     * @throws {Error} If Azure endpoint or deployment name is not configured
+     *
+     * @example
+     * ```typescript
+     * const adapter = new AzureAdapter(manifest, process.env.AZURE_OPENAI_API_KEY);
+     * ```
+     */
+    constructor(manifest, apiKey) {
+        this.manifest = manifest;
+        // Extract Azure configuration
+        const azureConfig = this.manifest.extensions?.azure;
+        const endpoint = azureConfig?.endpoint;
+        const apiVersion = azureConfig?.api_version || '2024-02-15-preview';
+        if (!endpoint) {
+            throw new Error('Azure endpoint is required. Set extensions.azure.endpoint in manifest.');
+        }
+        // Get deployment name (required for Azure)
+        this.deployment = this.getDeployment();
+        // Initialize OpenAI client with Azure configuration
+        this.client = new OpenAI({
+            apiKey: apiKey || process.env.AZURE_OPENAI_API_KEY,
+            baseURL: `${endpoint}/openai/deployments/${this.deployment}`,
+            defaultQuery: { 'api-version': apiVersion },
+            defaultHeaders: { 'api-key': apiKey || process.env.AZURE_OPENAI_API_KEY || '' },
+        });
+    }
+    /**
+     * Get the Azure deployment name from manifest
+     *
+     * Deployment names in Azure OpenAI are distinct from model names and must be
+     * configured in the Azure portal. They map to specific model versions.
+     *
+     * Priority:
+     * 1. extensions.azure.deployment (Azure-specific)
+     * 2. spec.llm.model (Generic LLM config, treated as deployment name)
+     * 3. Default: 'gpt-4o-mini' (must exist as deployment in Azure)
+     *
+     * @returns Azure deployment name
+     *
+     * @private
+     */
+    getDeployment() {
+        // Check Azure extension first
+        if (this.manifest.extensions?.azure?.deployment) {
+            return this.manifest.extensions.azure.deployment;
+        }
+        // Fall back to LLM model config (Azure treats this as deployment name)
+        if (this.manifest.spec.llm?.model) {
+            return this.manifest.spec.llm.model;
+        }
+        // Default deployment name
+        return 'gpt-4o-mini';
+    }
+    /**
+     * Get system prompt from manifest
+     *
+     * The system prompt defines the agent's role and behavior. Azure OpenAI uses
+     * the same system message format as standard OpenAI.
+     *
+     * Priority:
+     * 1. extensions.azure.instructions (Azure-specific instructions)
+     * 2. spec.role (Generic role definition)
+     *
+     * @returns System prompt text
+     *
+     * @private
+     */
+    getSystemPrompt() {
+        // Check Azure extension first
+        if (this.manifest.extensions?.azure?.instructions) {
+            return this.manifest.extensions.azure.instructions;
+        }
+        // Fall back to role
+        return this.manifest.spec.role;
+    }
+    /**
+     * Get temperature setting for response generation
+     *
+     * Temperature controls randomness in responses (0.0 = deterministic, 2.0 = very random).
+     * Azure OpenAI supports the same temperature range as OpenAI.
+     *
+     * Priority:
+     * 1. extensions.azure.temperature
+     * 2. spec.llm.temperature
+     * 3. Default: 0.7
+     *
+     * @returns Temperature value (0.0 to 2.0)
+     *
+     * @private
+     */
+    getTemperature() {
+        if (this.manifest.extensions?.azure?.temperature !== undefined) {
+            return this.manifest.extensions.azure.temperature;
+        }
+        if (this.manifest.spec.llm?.temperature !== undefined) {
+            return this.manifest.spec.llm.temperature;
+        }
+        return 0.7;
+    }
+    /**
+     * Get max tokens setting for response generation
+     *
+     * Max tokens limits the length of generated responses. Azure OpenAI has the
+     * same token limits as OpenAI (varies by model).
+     *
+     * Priority:
+     * 1. extensions.azure.max_tokens
+     * 2. spec.llm.maxTokens
+     * 3. Default: undefined (uses model's default)
+     *
+     * @returns Max tokens value or undefined
+     *
+     * @private
+     */
+    getMaxTokens() {
+        if (this.manifest.extensions?.azure?.max_tokens) {
+            return this.manifest.extensions.azure.max_tokens;
+        }
+        if (this.manifest.spec.llm?.maxTokens) {
+            return this.manifest.spec.llm.maxTokens;
+        }
+        return undefined;
+    }
+    /**
+     * Convert OSSA tools to OpenAI function calling format
+     *
+     * This method transforms OSSA tool definitions into Azure OpenAI's function calling
+     * schema. Azure uses the same function calling format as OpenAI.
+     *
+     * Tool sources (in priority order):
+     * 1. extensions.azure.tools_mapping - Azure-specific tool definitions
+     * 2. spec.tools - Generic OSSA tool definitions
+     *
+     * @returns Array of OpenAI ChatCompletionTool objects
+     *
+     * @private
+     */
+    getAzureTools() {
+        const azureTools = [];
+        // Check for tools_mapping in Azure extension
+        const toolsMapping = this.manifest.extensions?.azure?.tools_mapping;
+        if (toolsMapping) {
+            for (const mapping of toolsMapping) {
+                const toolDef = {
+                    name: mapping.azure_tool_name || mapping.ossa_capability,
+                    description: mapping.description || `Execute ${mapping.ossa_capability}`,
+                    parameters: mapping.parameters || {
+                        type: 'object',
+                        properties: {},
+                        required: [],
+                    },
+                };
+                this.tools.set(toolDef.name, toolDef);
+                azureTools.push({
+                    type: 'function',
+                    function: {
+                        name: toolDef.name,
+                        description: toolDef.description,
+                        parameters: toolDef.parameters,
+                    },
+                });
+            }
+        }
+        // Also check spec.tools for basic tool definitions
+        if (this.manifest.spec.tools) {
+            for (const tool of this.manifest.spec.tools) {
+                if (tool.name && !this.tools.has(tool.name)) {
+                    const toolDef = {
+                        name: tool.name,
+                        description: `Execute ${tool.name} (${tool.type})`,
+                        parameters: {
+                            type: 'object',
+                            properties: {},
+                            required: [],
+                        },
+                    };
+                    this.tools.set(tool.name, toolDef);
+                    azureTools.push({
+                        type: 'function',
+                        function: {
+                            name: tool.name,
+                            description: toolDef.description,
+                            parameters: toolDef.parameters,
+                        },
+                    });
+                }
+            }
+        }
+        return azureTools;
+    }
+    /**
+     * Register a tool handler for runtime execution
+     *
+     * Tool handlers are async functions that execute when the LLM calls a tool.
+     * They receive parsed arguments and return string results.
+     *
+     * @param name - Tool name (must match a tool defined in manifest)
+     * @param handler - Async function that executes the tool
+     *
+     * @example
+     * ```typescript
+     * adapter.registerToolHandler('get_weather', async (args) => {
+     *   const { location } = args;
+     *   const weather = await fetchWeather(location);
+     *   return JSON.stringify(weather);
+     * });
+     * ```
+     */
+    registerToolHandler(name, handler) {
+        const tool = this.tools.get(name);
+        if (tool) {
+            tool.handler = handler;
+        }
+    }
+    /**
+     * Execute a tool call from the LLM
+     *
+     * This internal method handles tool execution during conversation turns.
+     * It looks up the registered handler and invokes it with the provided arguments.
+     *
+     * @param name - Tool name
+     * @param args - Parsed tool arguments from LLM
+     * @returns Tool execution result as string
+     *
+     * @private
+     */
+    async executeTool(name, args) {
+        const tool = this.tools.get(name);
+        if (!tool) {
+            return `Error: Tool '${name}' not found`;
+        }
+        if (tool.handler) {
+            try {
+                return await tool.handler(args);
+            }
+            catch (error) {
+                return `Error executing ${name}: ${error instanceof Error ? error.message : String(error)}`;
+            }
+        }
+        // Default: return a placeholder response if no handler registered
+        return `Tool '${name}' executed with args: ${JSON.stringify(args)}`;
+    }
+    /**
+     * Initialize the conversation
+     *
+     * Sets up the conversation history with the system prompt. Must be called
+     * before the first chat() call.
+     *
+     * @example
+     * ```typescript
+     * adapter.initialize();
+     * const response = await adapter.chat('Hello!');
+     * ```
+     */
+    initialize() {
+        this.messages = [
+            {
+                role: 'system',
+                content: this.getSystemPrompt(),
+            },
+        ];
+    }
+    /**
+     * Send a message and get a response
+     *
+     * This is the main method for interacting with the Azure OpenAI agent. It handles:
+     * - Adding user messages to conversation history
+     * - Calling Azure OpenAI API with proper authentication and headers
+     * - Executing tool calls requested by the LLM
+     * - Multi-turn conversations with tool results
+     * - Automatic retry until final text response or max turns reached
+     *
+     * The method automatically handles the tool execution loop:
+     * 1. Send messages to Azure OpenAI
+     * 2. If LLM requests tool calls, execute them
+     * 3. Send tool results back to LLM
+     * 4. Repeat until LLM provides final text response
+     *
+     * @param userMessage - The user's message text
+     * @param options - Optional runtime configuration
+     * @returns Final text response from the LLM
+     *
+     * @throws {Error} If Azure API call fails
+     *
+     * @example Basic usage
+     * ```typescript
+     * const response = await adapter.chat('What is the weather in Paris?');
+     * console.log(response);
+     * ```
+     *
+     * @example With verbose logging
+     * ```typescript
+     * const response = await adapter.chat('Calculate 2+2', { verbose: true });
+     * // Logs: [Calling 1 tool(s)...]
+     * // Logs:   → calculate({"expression":"2+2"})
+     * // Logs:   ← 4
+     * ```
+     */
+    async chat(userMessage, options) {
+        // Add user message
+        this.messages.push({
+            role: 'user',
+            content: userMessage,
+        });
+        const tools = this.getAzureTools();
+        let turnCount = 0;
+        const maxTurns = options?.maxTurns || 10;
+        while (turnCount < maxTurns) {
+            turnCount++;
+            // Call Azure OpenAI
+            const response = await this.client.chat.completions.create({
+                model: this.deployment, // Azure requires deployment name here
+                messages: this.messages,
+                tools: tools.length > 0 ? tools : undefined,
+                temperature: this.getTemperature(),
+                max_tokens: this.getMaxTokens(),
+            });
+            const choice = response.choices[0];
+            const message = choice.message;
+            // Add assistant message to history
+            this.messages.push(message);
+            // Check if we need to call tools
+            if (message.tool_calls && message.tool_calls.length > 0) {
+                if (options?.verbose) {
+                    console.log(`\n[Calling ${message.tool_calls.length} tool(s)...]`);
+                }
+                // Execute each tool call
+                for (const toolCall of message.tool_calls) {
+                    // Type guard for function tool calls
+                    if (toolCall.type !== 'function')
+                        continue;
+                    const funcCall = toolCall;
+                    const args = JSON.parse(funcCall.function.arguments);
+                    if (options?.verbose) {
+                        console.log(`  → ${funcCall.function.name}(${JSON.stringify(args)})`);
+                    }
+                    const result = await this.executeTool(funcCall.function.name, args);
+                    if (options?.verbose) {
+                        console.log(`  ← ${result.substring(0, 100)}${result.length > 100 ? '...' : ''}`);
+                    }
+                    // Add tool result to messages
+                    this.messages.push({
+                        role: 'tool',
+                        tool_call_id: toolCall.id,
+                        content: result,
+                    });
+                }
+                // Continue the loop to get the final response
+                continue;
+            }
+            // No tool calls, return the response
+            return message.content || '';
+        }
+        return 'Max turns reached without completion';
+    }
+    /**
+     * Get agent information
+     *
+     * Returns metadata about the configured agent including deployment name,
+     * available tools, and provider identifier.
+     *
+     * @returns Object containing agent name, deployment, tools array, and provider
+     *
+     * @example
+     * ```typescript
+     * const info = adapter.getAgentInfo();
+     * console.log(`Agent: ${info.name}`);
+     * console.log(`Deployment: ${info.deployment}`);
+     * console.log(`Tools: ${info.tools.join(', ')}`);
+     * console.log(`Provider: ${info.provider}`); // 'azure'
+     * ```
+     */
+    getAgentInfo() {
+        return {
+            name: this.manifest.metadata.name,
+            deployment: this.deployment,
+            tools: Array.from(this.tools.keys()),
+            provider: 'azure',
+        };
+    }
+    /**
+     * Get conversation history
+     *
+     * Returns the full conversation history including system messages, user messages,
+     * assistant responses, and tool calls/results. Useful for debugging or saving
+     * conversation state.
+     *
+     * @returns Array of conversation messages
+     *
+     * @example
+     * ```typescript
+     * const history = adapter.getConversationHistory();
+     * console.log(`Messages: ${history.length}`);
+     * ```
+     */
+    getConversationHistory() {
+        return this.messages;
+    }
+    /**
+     * Clear conversation history
+     *
+     * Resets the conversation to initial state (only system message remains).
+     * Call this to start a fresh conversation without recreating the adapter.
+     *
+     * @example
+     * ```typescript
+     * adapter.clearHistory();
+     * adapter.initialize(); // Re-add system prompt
+     * ```
+     */
+    clearHistory() {
+        this.messages = [];
+    }
+    /**
+     * Get available tools
+     *
+     * Returns all registered tool definitions including their schemas and handlers.
+     *
+     * @returns Array of tool definitions
+     *
+     * @example
+     * ```typescript
+     * const tools = adapter.getTools();
+     * for (const tool of tools) {
+     *   console.log(`${tool.name}: ${tool.description}`);
+     * }
+     * ```
+     */
+    getTools() {
+        return Array.from(this.tools.values());
+    }
+    /**
+     * Get the OpenAI client instance
+     *
+     * Provides direct access to the underlying OpenAI SDK client configured for Azure.
+     * Use this for advanced scenarios not covered by the adapter API.
+     *
+     * @returns Configured OpenAI client instance
+     *
+     * @example Advanced usage with streaming
+     * ```typescript
+     * const client = adapter.getClient();
+     * const stream = await client.chat.completions.create({
+     *   model: adapter.getAgentInfo().deployment,
+     *   messages: adapter.getConversationHistory(),
+     *   stream: true,
+     * });
+     * for await (const chunk of stream) {
+     *   process.stdout.write(chunk.choices[0]?.delta?.content || '');
+     * }
+     * ```
+     */
+    getClient() {
+        return this.client;
+    }
+}
+//# sourceMappingURL=azure.adapter.js.map

package/dist/services/runtime/azure.adapter.js.map

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

package/dist/services/runtime/bedrock.adapter.d.ts

@@ -0,0 +1,170 @@
+/**
+ * AWS Bedrock Runtime Adapter
+ * Runs OSSA agents using AWS Bedrock with support for Claude and Titan models
+ * Supports streaming via InvokeModelWithResponseStream and tool calling via Converse API
+ */
+import { BedrockRuntimeClient, type Message, type ToolSpecification, type ToolInputSchema } from '@aws-sdk/client-bedrock-runtime';
+import type { OssaAgent } from '../../types/index.js';
+/**
+ * Bedrock extension from OSSA manifest
+ */
+export interface BedrockExtension {
+    enabled?: boolean;
+    region: string;
+    profile?: string;
+    model_id: string;
+    system?: string;
+    temperature?: number;
+    max_tokens?: number;
+    top_p?: number;
+    stop_sequences?: string[];
+    tools?: ToolSpecification[];
+}
+/**
+ * Extended OSSA manifest with Bedrock extension
+ */
+export interface OssaManifestWithBedrock extends OssaAgent {
+    extensions?: {
+        bedrock?: BedrockExtension;
+        [key: string]: unknown;
+    };
+}
+/**
+ * Runtime options for Bedrock adapter
+ */
+export interface BedrockRunOptions {
+    verbose?: boolean;
+    maxTurns?: number;
+    stream?: boolean;
+}
+/**
+ * Tool definition with handler
+ */
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    input_schema: ToolInputSchema;
+    handler?: (args: Record<string, unknown>) => Promise<string>;
+}
+/**
+ * Agent information
+ */
+export interface AgentInfo {
+    name: string;
+    model: string;
+    tools: string[];
+    provider: 'bedrock';
+    region: string;
+}
+/**
+ * AWS Bedrock adapter for executing OSSA agents with Claude and Titan models
+ *
+ * Supported models:
+ * - Claude 3.5 Sonnet: anthropic.claude-3-5-sonnet-20241022-v2:0
+ * - Claude 3 Sonnet: anthropic.claude-3-sonnet-20240229-v1:0
+ * - Claude 3 Haiku: anthropic.claude-3-haiku-20240307-v1:0
+ * - Claude 3 Opus: anthropic.claude-3-opus-20240229-v1:0
+ * - Titan Text G1: amazon.titan-text-express-v1
+ * - Titan Text Premier: amazon.titan-text-premier-v1:0
+ */
+export declare class BedrockAdapter {
+    private client;
+    private manifest;
+    private tools;
+    private conversationHistory;
+    private region;
+    private modelId;
+    constructor(manifest: OssaManifestWithBedrock, config?: {
+        profile?: string;
+    });
+    /**
+     * Get the model ID to use from manifest
+     */
+    private getModelId;
+    /**
+     * Check if model supports Converse API (required for tool calling)
+     * Claude 3+ and Titan models support Converse API
+     */
+    private supportsConverseAPI;
+    /**
+     * Get system prompt from manifest
+     */
+    private getSystemPrompt;
+    /**
+     * Get max tokens configuration
+     */
+    private getMaxTokens;
+    /**
+     * Get temperature configuration
+     */
+    private getTemperature;
+    /**
+     * Get top_p configuration
+     */
+    private getTopP;
+    /**
+     * Get stop sequences
+     */
+    private getStopSequences;
+    /**
+     * Convert OSSA tools to Bedrock tool format
+     */
+    private getBedrockTools;
+    /**
+     * Generate input schema from OSSA tool spec
+     */
+    private generateInputSchema;
+    /**
+     * Register a tool handler
+     */
+    registerToolHandler(name: string, handler: (args: Record<string, unknown>) => Promise<string>): void;
+    /**
+     * Execute a tool call
+     */
+    private executeTool;
+    /**
+     * Initialize the conversation
+     */
+    initialize(): void;
+    /**
+     * Send a message and get a response using Converse API (with tool support)
+     */
+    chat(userMessage: string, options?: BedrockRunOptions): Promise<string>;
+    /**
+     * Basic chat without tool support (for models that don't support Converse API)
+     */
+    private chatBasic;
+    /**
+     * Build prompt for basic models
+     */
+    private buildPrompt;
+    /**
+     * Stream a response with tool support using ConverseStream API
+     */
+    chatStream(userMessage: string, options?: BedrockRunOptions): AsyncGenerator<string, void, unknown>;
+    /**
+     * Basic streaming without tool support
+     */
+    private chatStreamBasic;
+    /**
+     * Get agent info
+     */
+    getAgentInfo(): AgentInfo;
+    /**
+     * Get conversation history
+     */
+    getConversationHistory(): Message[];
+    /**
+     * Clear conversation history
+     */
+    clearHistory(): void;
+    /**
+     * Get available tools
+     */
+    getTools(): ToolDefinition[];
+    /**
+     * Get the Bedrock client (for advanced usage)
+     */
+    getClient(): BedrockRuntimeClient;
+}
+//# sourceMappingURL=bedrock.adapter.d.ts.map