mcp-agent-foundry 1.0.0

package/dist/translation/messages.d.ts

@@ -0,0 +1,295 @@
+/**
+ * Message Format Translation
+ *
+ * Translates messages between AgentRouter's internal format and provider-specific formats.
+ * Handles the differences in how each provider represents:
+ * - System prompts
+ * - Message content (text, tool use, tool results)
+ * - Role naming conventions
+ *
+ * Format Reference:
+ * | Feature      | Anthropic              | OpenAI                 | Gemini              |
+ * |--------------|------------------------|------------------------|---------------------|
+ * | System       | separate param         | role: "system" message | systemInstruction   |
+ * | Content      | content blocks         | string or array        | parts array         |
+ * | Tool use     | tool_use block         | tool_calls array       | functionCall        |
+ * | Tool result  | tool_result block      | role: "tool" message   | functionResponse    |
+ */
+import type { Message, ContentBlock } from '../types.js';
+/**
+ * Anthropic message format
+ */
+export interface AnthropicMessage {
+    role: 'user' | 'assistant';
+    content: string | AnthropicContentBlock[];
+}
+/**
+ * Anthropic content block
+ */
+export interface AnthropicContentBlock {
+    type: 'text' | 'tool_use' | 'tool_result';
+    text?: string;
+    id?: string;
+    name?: string;
+    input?: Record<string, unknown>;
+    tool_use_id?: string;
+    content?: string;
+}
+/**
+ * Anthropic API response format
+ */
+export interface AnthropicResponse {
+    id: string;
+    type: 'message';
+    role: 'assistant';
+    content: AnthropicContentBlock[];
+    model: string;
+    stop_reason: 'end_turn' | 'max_tokens' | 'stop_sequence' | 'tool_use';
+    stop_sequence?: string | null;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+        cache_creation_input_tokens?: number;
+        cache_read_input_tokens?: number;
+    };
+}
+/**
+ * Anthropic request format (for sending to API)
+ */
+export interface AnthropicRequest {
+    model: string;
+    messages: AnthropicMessage[];
+    system?: string;
+    max_tokens: number;
+    temperature?: number;
+    tools?: AnthropicTool[];
+    stream?: boolean;
+}
+export interface AnthropicTool {
+    name: string;
+    description: string;
+    input_schema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * OpenAI message format
+ */
+export interface OpenAIMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | OpenAIContentPart[] | null;
+    tool_calls?: OpenAIToolCall[];
+    tool_call_id?: string;
+    name?: string;
+}
+/**
+ * OpenAI content part for multi-modal messages
+ */
+export interface OpenAIContentPart {
+    type: 'text' | 'image_url';
+    text?: string;
+    image_url?: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high';
+    };
+}
+/**
+ * OpenAI tool call format
+ */
+export interface OpenAIToolCall {
+    id: string;
+    type: 'function';
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+/**
+ * OpenAI API response format
+ */
+export interface OpenAIResponse {
+    id: string;
+    object: 'chat.completion';
+    created: number;
+    model: string;
+    choices: {
+        index: number;
+        message: OpenAIMessage;
+        finish_reason: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    }[];
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+/**
+ * Gemini content format
+ */
+export interface GeminiContent {
+    role: 'user' | 'model';
+    parts: GeminiPart[];
+}
+/**
+ * Gemini part format (can be text, function call, or function response)
+ */
+export interface GeminiPart {
+    text?: string;
+    functionCall?: {
+        name: string;
+        args: Record<string, unknown>;
+    };
+    functionResponse?: {
+        name: string;
+        response: Record<string, unknown>;
+    };
+}
+/**
+ * Gemini API response format
+ */
+export interface GeminiResponse {
+    candidates: {
+        content: GeminiContent;
+        finishReason: 'STOP' | 'MAX_TOKENS' | 'SAFETY' | 'RECITATION' | 'OTHER';
+        safetyRatings?: {
+            category: string;
+            probability: string;
+        }[];
+    }[];
+    promptFeedback?: {
+        safetyRatings?: {
+            category: string;
+            probability: string;
+        }[];
+    };
+    usageMetadata?: {
+        promptTokenCount: number;
+        candidatesTokenCount: number;
+        totalTokenCount: number;
+    };
+}
+/**
+ * Gemini request format
+ */
+export interface GeminiRequest {
+    contents: GeminiContent[];
+    systemInstruction?: {
+        parts: GeminiPart[];
+    };
+    generationConfig?: {
+        temperature?: number;
+        maxOutputTokens?: number;
+        topP?: number;
+        topK?: number;
+    };
+    tools?: GeminiTool[];
+}
+export interface GeminiTool {
+    functionDeclarations: GeminiFunctionDeclaration[];
+}
+export interface GeminiFunctionDeclaration {
+    name: string;
+    description: string;
+    parameters: GeminiSchema;
+}
+export interface GeminiSchema {
+    type: string;
+    description?: string;
+    properties?: Record<string, GeminiSchema>;
+    required?: string[];
+    items?: GeminiSchema;
+    enum?: string[];
+}
+/**
+ * Convert internal messages to Anthropic format
+ *
+ * Anthropic:
+ * - System prompt is a separate top-level parameter
+ * - Messages use 'user' | 'assistant' roles
+ * - Content can be string or ContentBlock[]
+ * - Tool results go in user messages with tool_result blocks
+ *
+ * @param messages - Internal Message array
+ * @param systemPrompt - Optional system prompt (becomes separate param in Anthropic)
+ * @returns Anthropic-formatted messages (system prompt handled separately by caller)
+ */
+export declare function toAnthropicMessages(messages: Message[], systemPrompt?: string): {
+    messages: AnthropicMessage[];
+    system?: string;
+};
+/**
+ * Convert internal messages to OpenAI format
+ *
+ * OpenAI:
+ * - System prompt is a message with role: "system"
+ * - Tool use is in assistant message's tool_calls array
+ * - Tool results are separate messages with role: "tool"
+ *
+ * @param messages - Internal Message array
+ * @param systemPrompt - Optional system prompt (becomes first message)
+ * @returns OpenAI-formatted messages
+ */
+export declare function toOpenAIMessages(messages: Message[], systemPrompt?: string): OpenAIMessage[];
+/**
+ * Convert internal messages to Gemini format
+ *
+ * Gemini:
+ * - System prompt goes in systemInstruction
+ * - Roles are 'user' | 'model' (not 'assistant')
+ * - Content is always an array of parts
+ * - Function calls and responses are specific part types
+ *
+ * @param messages - Internal Message array
+ * @param systemPrompt - Optional system prompt (becomes systemInstruction)
+ * @returns Gemini-formatted contents and system instruction
+ */
+export declare function toGeminiContents(messages: Message[], systemPrompt?: string): {
+    contents: GeminiContent[];
+    systemInstruction?: {
+        parts: GeminiPart[];
+    };
+};
+/**
+ * Convert Anthropic response to internal Message format
+ *
+ * @param response - Anthropic API response
+ * @returns Internal Message
+ */
+export declare function fromAnthropicResponse(response: AnthropicResponse): Message;
+/**
+ * Convert OpenAI response to internal Message format
+ *
+ * @param response - OpenAI API response
+ * @returns Internal Message
+ */
+export declare function fromOpenAIResponse(response: OpenAIResponse): Message;
+/**
+ * Convert Gemini response to internal Message format
+ *
+ * @param response - Gemini API response
+ * @returns Internal Message
+ */
+export declare function fromGeminiResponse(response: GeminiResponse): Message;
+/**
+ * Extract text content from a Message
+ */
+export declare function extractTextContent(message: Message): string;
+/**
+ * Check if a message contains tool use
+ */
+export declare function hasToolUse(message: Message): boolean;
+/**
+ * Check if a message contains tool results
+ */
+export declare function hasToolResult(message: Message): boolean;
+/**
+ * Get all tool use blocks from a message
+ */
+export declare function getToolUseBlocks(message: Message): ContentBlock[];
+/**
+ * Get all tool result blocks from a message
+ */
+export declare function getToolResultBlocks(message: Message): ContentBlock[];
+//# sourceMappingURL=messages.d.ts.map

package/dist/translation/messages.d.ts.map

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