@yolo-labs/core-providers 1.0.0

package/dist/anthropic/index.d.ts

@@ -0,0 +1,34 @@
+import { AIProvider, CreateMessageParams, StreamEvent } from '@yolo-labs/core-types';
+
+/** Configuration options for the Anthropic provider. */
+interface AnthropicProviderOptions {
+    apiKey?: string;
+    baseURL?: string;
+    defaultModel?: string;
+}
+/**
+ * {@link AIProvider} adapter for the Anthropic Claude API.
+ *
+ * @remarks
+ * Translates canonical {@link CreateMessageParams} into Anthropic SDK calls and
+ * maps Anthropic stream events back to canonical {@link StreamEvent} types.
+ * Requires `@anthropic-ai/sdk` as a peer dependency.
+ */
+declare class AnthropicProvider implements AIProvider {
+    private client;
+    private defaultModel;
+    /** Creates a new AnthropicProvider with the given options. */
+    constructor(options?: AnthropicProviderOptions);
+    /**
+     * Creates a streaming message using the Anthropic SDK.
+     *
+     * @param params - Canonical message creation parameters.
+     * @returns An async iterable of canonical {@link StreamEvent} objects.
+     */
+    createMessage(params: CreateMessageParams): AsyncIterable<StreamEvent>;
+    private mapEvent;
+    private toAnthropicTool;
+    private toAnthropicMessage;
+}
+
+export { AnthropicProvider, type AnthropicProviderOptions };

package/dist/anthropic/index.js

@@ -0,0 +1,191 @@
+// src/anthropic/index.ts
+import Anthropic from "@anthropic-ai/sdk";
+var AnthropicProvider = class {
+  client;
+  defaultModel;
+  /** Creates a new AnthropicProvider with the given options. */
+  constructor(options = {}) {
+    this.client = new Anthropic({
+      apiKey: options.apiKey,
+      baseURL: options.baseURL
+    });
+    this.defaultModel = options.defaultModel ?? "claude-sonnet-4-20250514";
+  }
+  /**
+   * Creates a streaming message using the Anthropic SDK.
+   *
+   * @param params - Canonical message creation parameters.
+   * @returns An async iterable of canonical {@link StreamEvent} objects.
+   */
+  async *createMessage(params) {
+    const model = params.model || this.defaultModel;
+    const tools = params.tools?.map((t) => this.toAnthropicTool(t));
+    const messages = params.messages.map((m) => this.toAnthropicMessage(m));
+    const requestParams = {
+      model,
+      messages,
+      max_tokens: params.maxTokens ?? 4096,
+      stream: true
+    };
+    if (params.system) {
+      requestParams.system = params.system;
+    }
+    if (tools && tools.length > 0) {
+      requestParams.tools = tools;
+    }
+    if (params.temperature !== void 0) {
+      requestParams.temperature = params.temperature;
+    }
+    if (params.topP !== void 0) {
+      requestParams.top_p = params.topP;
+    }
+    if (params.stopSequences && params.stopSequences.length > 0) {
+      requestParams.stop_sequences = params.stopSequences;
+    }
+    const stream = this.client.messages.stream(requestParams);
+    for await (const event of stream) {
+      const mapped = this.mapEvent(event);
+      if (mapped) {
+        yield mapped;
+      }
+    }
+  }
+  // 47b: Map Anthropic raw stream events to canonical StreamEvent
+  mapEvent(event) {
+    switch (event.type) {
+      case "message_start":
+        return {
+          type: "message_start",
+          message: {
+            id: event.message.id,
+            model: event.message.model,
+            role: "assistant",
+            usage: event.message.usage ? {
+              input_tokens: event.message.usage.input_tokens,
+              output_tokens: event.message.usage.output_tokens
+            } : void 0
+          }
+        };
+      case "content_block_start":
+        return {
+          type: "content_block_start",
+          index: event.index,
+          contentBlock: {
+            type: event.content_block.type === "tool_use" ? "tool_use" : "text",
+            id: event.content_block.type === "tool_use" ? event.content_block.id : void 0,
+            name: event.content_block.type === "tool_use" ? event.content_block.name : void 0
+          }
+        };
+      case "content_block_delta":
+        if (event.delta.type === "text_delta") {
+          return {
+            type: "content_block_delta",
+            index: event.index,
+            delta: { type: "text_delta", text: event.delta.text }
+          };
+        } else if (event.delta.type === "input_json_delta") {
+          return {
+            type: "content_block_delta",
+            index: event.index,
+            delta: { type: "input_json_delta", partial_json: event.delta.partial_json }
+          };
+        } else if (event.delta.type === "thinking_delta") {
+          return {
+            type: "content_block_delta",
+            index: event.index,
+            delta: { type: "thinking_delta", thinking: event.delta.thinking }
+          };
+        }
+        return null;
+      case "content_block_stop":
+        return {
+          type: "content_block_stop",
+          index: event.index
+        };
+      case "message_delta":
+        return {
+          type: "message_delta",
+          delta: {
+            stop_reason: event.delta.stop_reason ?? null
+          },
+          usage: event.usage ? { output_tokens: event.usage.output_tokens } : void 0
+        };
+      case "message_stop":
+        return { type: "message_stop" };
+      default:
+        return null;
+    }
+  }
+  // 47c: Translate canonical ToolDefinition → Anthropic tool format
+  toAnthropicTool(tool) {
+    return {
+      name: tool.name,
+      description: tool.description,
+      input_schema: tool.inputSchema
+    };
+  }
+  // 47d: Map multimodal content blocks to Anthropic message format
+  toAnthropicMessage(message) {
+    if (typeof message.content === "string") {
+      return { role: message.role, content: message.content };
+    }
+    const contentParts = message.content.map(
+      (block) => {
+        switch (block.type) {
+          case "text":
+            return { type: "text", text: block.text };
+          case "image":
+            if (block.source.type === "base64") {
+              return {
+                type: "image",
+                source: {
+                  type: "base64",
+                  media_type: block.source.media_type,
+                  data: block.source.data
+                }
+              };
+            }
+            return {
+              type: "image",
+              source: {
+                type: "url",
+                url: block.source.url
+              }
+            };
+          case "file":
+            return {
+              type: "document",
+              source: {
+                type: "base64",
+                media_type: block.source.media_type,
+                data: block.source.data
+              }
+            };
+          // Task 98: Map ToolUseBlock → Anthropic native tool_use format
+          case "tool_use":
+            return {
+              type: "tool_use",
+              id: block.id,
+              name: block.name,
+              input: block.input
+            };
+          // Task 98: Map ToolResultBlock → Anthropic native tool_result format
+          case "tool_result":
+            return {
+              type: "tool_result",
+              tool_use_id: block.tool_use_id,
+              content: block.content,
+              ...block.is_error ? { is_error: true } : {}
+            };
+          default:
+            return { type: "text", text: "[unsupported content type]" };
+        }
+      }
+    );
+    return { role: message.role, content: contentParts };
+  }
+};
+export {
+  AnthropicProvider
+};
+//# sourceMappingURL=index.js.map

package/dist/anthropic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/anthropic/index.ts"],"sourcesContent":["// Task 47: AnthropicProvider — adapter for @anthropic-ai/sdk\n\nimport Anthropic from '@anthropic-ai/sdk';\nimport type {\n  AIProvider,\n  CreateMessageParams,\n  StreamEvent,\n  ToolDefinition,\n  ContentBlock,\n  Message,\n} from '@yolo-labs/core-types';\n\n/** Configuration options for the Anthropic provider. */\nexport interface AnthropicProviderOptions {\n  apiKey?: string;\n  baseURL?: string;\n  defaultModel?: string;\n}\n\n/**\n * {@link AIProvider} adapter for the Anthropic Claude API.\n *\n * @remarks\n * Translates canonical {@link CreateMessageParams} into Anthropic SDK calls and\n * maps Anthropic stream events back to canonical {@link StreamEvent} types.\n * Requires `@anthropic-ai/sdk` as a peer dependency.\n */\nexport class AnthropicProvider implements AIProvider {\n  private client: Anthropic;\n  private defaultModel: string;\n\n  /** Creates a new AnthropicProvider with the given options. */\n  constructor(options: AnthropicProviderOptions = {}) {\n    this.client = new Anthropic({\n      apiKey: options.apiKey,\n      baseURL: options.baseURL,\n    });\n    this.defaultModel = options.defaultModel ?? 'claude-sonnet-4-20250514';\n  }\n\n  /**\n   * Creates a streaming message using the Anthropic SDK.\n   *\n   * @param params - Canonical message creation parameters.\n   * @returns An async iterable of canonical {@link StreamEvent} objects.\n   */\n  async *createMessage(params: CreateMessageParams): AsyncIterable<StreamEvent> {\n    const model = params.model || this.defaultModel;\n\n    // 47c: Translate canonical ToolDefinition → Anthropic tools with input_schema\n    const tools = params.tools?.map((t) => this.toAnthropicTool(t));\n\n    // 47d: Map multimodal content blocks to Anthropic format\n    const messages = params.messages.map((m) => this.toAnthropicMessage(m));\n\n    const requestParams: Anthropic.MessageCreateParamsStreaming = {\n      model,\n      messages,\n      max_tokens: params.maxTokens ?? 4096,\n      stream: true,\n    };\n\n    if (params.system) {\n      requestParams.system = params.system;\n    }\n    if (tools && tools.length > 0) {\n      requestParams.tools = tools;\n    }\n    if (params.temperature !== undefined) {\n      requestParams.temperature = params.temperature;\n    }\n    if (params.topP !== undefined) {\n      requestParams.top_p = params.topP;\n    }\n    if (params.stopSequences && params.stopSequences.length > 0) {\n      requestParams.stop_sequences = params.stopSequences;\n    }\n\n    // 47b: Map Anthropic stream events to canonical StreamEvent types\n    const stream = this.client.messages.stream(requestParams);\n\n    for await (const event of stream) {\n      const mapped = this.mapEvent(event);\n      if (mapped) {\n        yield mapped;\n      }\n    }\n  }\n\n  // 47b: Map Anthropic raw stream events to canonical StreamEvent\n  private mapEvent(event: Anthropic.MessageStreamEvent): StreamEvent | null {\n    switch (event.type) {\n      case 'message_start':\n        return {\n          type: 'message_start',\n          message: {\n            id: event.message.id,\n            model: event.message.model,\n            role: 'assistant',\n            usage: event.message.usage\n              ? {\n                  input_tokens: event.message.usage.input_tokens,\n                  output_tokens: event.message.usage.output_tokens,\n                }\n              : undefined,\n          },\n        };\n\n      case 'content_block_start':\n        return {\n          type: 'content_block_start',\n          index: event.index,\n          contentBlock: {\n            type: event.content_block.type === 'tool_use' ? 'tool_use' : 'text',\n            id: event.content_block.type === 'tool_use' ? event.content_block.id : undefined,\n            name: event.content_block.type === 'tool_use' ? event.content_block.name : undefined,\n          },\n        };\n\n      case 'content_block_delta':\n        if (event.delta.type === 'text_delta') {\n          return {\n            type: 'content_block_delta',\n            index: event.index,\n            delta: { type: 'text_delta', text: event.delta.text },\n          };\n        } else if (event.delta.type === 'input_json_delta') {\n          return {\n            type: 'content_block_delta',\n            index: event.index,\n            delta: { type: 'input_json_delta', partial_json: event.delta.partial_json },\n          };\n        } else if (event.delta.type === 'thinking_delta') {\n          return {\n            type: 'content_block_delta',\n            index: event.index,\n            delta: { type: 'thinking_delta', thinking: (event.delta as { thinking: string }).thinking },\n          };\n        }\n        return null;\n\n      case 'content_block_stop':\n        return {\n          type: 'content_block_stop',\n          index: event.index,\n        };\n\n      case 'message_delta':\n        return {\n          type: 'message_delta',\n          delta: {\n            stop_reason: event.delta.stop_reason ?? null,\n          },\n          usage: event.usage\n            ? { output_tokens: event.usage.output_tokens }\n            : undefined,\n        };\n\n      case 'message_stop':\n        return { type: 'message_stop' };\n\n      default:\n        return null;\n    }\n  }\n\n  // 47c: Translate canonical ToolDefinition → Anthropic tool format\n  private toAnthropicTool(tool: ToolDefinition): Anthropic.Tool {\n    return {\n      name: tool.name,\n      description: tool.description,\n      input_schema: tool.inputSchema as Anthropic.Tool.InputSchema,\n    };\n  }\n\n  // 47d: Map multimodal content blocks to Anthropic message format\n  private toAnthropicMessage(\n    message: Message,\n  ): Anthropic.MessageParam {\n    if (typeof message.content === 'string') {\n      return { role: message.role, content: message.content };\n    }\n\n    const contentParts: Anthropic.ContentBlockParam[] = message.content.map(\n      (block: ContentBlock) => {\n        switch (block.type) {\n          case 'text':\n            return { type: 'text' as const, text: block.text };\n          case 'image':\n            if (block.source.type === 'base64') {\n              return {\n                type: 'image' as const,\n                source: {\n                  type: 'base64' as const,\n                  media_type: block.source.media_type as\n                    | 'image/jpeg'\n                    | 'image/png'\n                    | 'image/gif'\n                    | 'image/webp',\n                  data: block.source.data,\n                },\n              };\n            }\n            // URL images — use url source\n            return {\n              type: 'image' as const,\n              source: {\n                type: 'url' as const,\n                url: block.source.url,\n              },\n            };\n          case 'file':\n            // Anthropic supports document content as base64\n            return {\n              type: 'document' as const,\n              source: {\n                type: 'base64' as const,\n                media_type: block.source.media_type,\n                data: block.source.data,\n              },\n            } as unknown as Anthropic.ContentBlockParam;\n          // Task 98: Map ToolUseBlock → Anthropic native tool_use format\n          case 'tool_use':\n            return {\n              type: 'tool_use' as const,\n              id: block.id,\n              name: block.name,\n              input: block.input,\n            } as unknown as Anthropic.ContentBlockParam;\n          // Task 98: Map ToolResultBlock → Anthropic native tool_result format\n          case 'tool_result':\n            return {\n              type: 'tool_result' as const,\n              tool_use_id: block.tool_use_id,\n              content: block.content,\n              ...(block.is_error ? { is_error: true } : {}),\n            } as unknown as Anthropic.ContentBlockParam;\n          default:\n            return { type: 'text' as const, text: '[unsupported content type]' };\n        }\n      },\n    );\n\n    return { role: message.role, content: contentParts };\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/google/index.d.ts

@@ -0,0 +1,38 @@
+import { AIProvider, CreateMessageParams, StreamEvent } from '@yolo-labs/core-types';
+
+/** Configuration options for the Google Gemini provider. */
+interface GoogleProviderOptions {
+    apiKey: string;
+    defaultModel?: string;
+}
+/**
+ * {@link AIProvider} adapter for the Google Gemini generative AI API.
+ *
+ * @remarks
+ * Translates canonical {@link CreateMessageParams} into Google `generateContentStream`
+ * calls and maps response chunks back to canonical {@link StreamEvent} types.
+ * Google returns function call arguments in full (not streamed), so tool use
+ * blocks emit a single `input_json_delta` with the complete JSON.
+ * Requires `@google/generative-ai` as a peer dependency.
+ */
+declare class GoogleProvider implements AIProvider {
+    private genAI;
+    private defaultModel;
+    /** Creates a new GoogleProvider with the given options. */
+    constructor(options: GoogleProviderOptions);
+    /**
+     * Creates a streaming message using the Google Generative AI SDK.
+     *
+     * @param params - Canonical message creation parameters.
+     * @returns An async iterable of canonical {@link StreamEvent} objects.
+     */
+    createMessage(params: CreateMessageParams): AsyncIterable<StreamEvent>;
+    private mapFinishReason;
+    private toGoogleTools;
+    private mapSchemaType;
+    private toGoogleSchema;
+    private toGoogleContents;
+    private toGoogleParts;
+}
+
+export { GoogleProvider, type GoogleProviderOptions };

package/dist/google/index.js

@@ -0,0 +1,223 @@
+// src/google/index.ts
+import {
+  GoogleGenerativeAI,
+  SchemaType
+} from "@google/generative-ai";
+var GoogleProvider = class {
+  genAI;
+  defaultModel;
+  /** Creates a new GoogleProvider with the given options. */
+  constructor(options) {
+    this.genAI = new GoogleGenerativeAI(options.apiKey);
+    this.defaultModel = options.defaultModel ?? "gemini-2.0-flash";
+  }
+  /**
+   * Creates a streaming message using the Google Generative AI SDK.
+   *
+   * @param params - Canonical message creation parameters.
+   * @returns An async iterable of canonical {@link StreamEvent} objects.
+   */
+  async *createMessage(params) {
+    const modelName = params.model || this.defaultModel;
+    const tools = params.tools?.length ? [this.toGoogleTools(params.tools)] : void 0;
+    const model = this.genAI.getGenerativeModel({
+      model: modelName,
+      systemInstruction: params.system ? { role: "user", parts: [{ text: params.system }] } : void 0,
+      tools,
+      generationConfig: {
+        maxOutputTokens: params.maxTokens,
+        temperature: params.temperature,
+        topP: params.topP,
+        stopSequences: params.stopSequences
+      }
+    });
+    const contents = this.toGoogleContents(params.messages);
+    const messageId = `msg_${Date.now()}`;
+    yield {
+      type: "message_start",
+      message: {
+        id: messageId,
+        model: modelName,
+        role: "assistant"
+      }
+    };
+    const result = await model.generateContentStream({
+      contents
+    });
+    let contentBlockIndex = 0;
+    let hasToolCalls = false;
+    for await (const chunk of result.stream) {
+      const candidates = chunk.candidates;
+      if (!candidates?.length) continue;
+      const candidate = candidates[0];
+      const parts = candidate.content?.parts;
+      if (!parts) continue;
+      for (const part of parts) {
+        if ("text" in part && part.text) {
+          yield {
+            type: "content_block_start",
+            index: contentBlockIndex,
+            contentBlock: { type: "text" }
+          };
+          yield {
+            type: "content_block_delta",
+            index: contentBlockIndex,
+            delta: { type: "text_delta", text: part.text }
+          };
+          yield { type: "content_block_stop", index: contentBlockIndex };
+          contentBlockIndex++;
+        }
+        if ("functionCall" in part && part.functionCall) {
+          hasToolCalls = true;
+          const toolCallId = `call_${Date.now()}_${contentBlockIndex}`;
+          yield {
+            type: "content_block_start",
+            index: contentBlockIndex,
+            contentBlock: {
+              type: "tool_use",
+              id: toolCallId,
+              name: part.functionCall.name
+            }
+          };
+          const argsJson = JSON.stringify(part.functionCall.args ?? {});
+          yield {
+            type: "content_block_delta",
+            index: contentBlockIndex,
+            delta: { type: "input_json_delta", partial_json: argsJson }
+          };
+          yield { type: "content_block_stop", index: contentBlockIndex };
+          contentBlockIndex++;
+        }
+      }
+      if (candidate.finishReason) {
+        const stopReason = this.mapFinishReason(candidate.finishReason, hasToolCalls);
+        yield {
+          type: "message_delta",
+          delta: { stop_reason: stopReason },
+          usage: chunk.usageMetadata ? { output_tokens: chunk.usageMetadata.candidatesTokenCount ?? 0 } : void 0
+        };
+      }
+    }
+    yield { type: "message_stop" };
+  }
+  mapFinishReason(reason, hasToolCalls) {
+    switch (reason) {
+      case "STOP":
+        return hasToolCalls ? "tool_use" : "end_turn";
+      case "MAX_TOKENS":
+        return "max_tokens";
+      case "SAFETY":
+        return "content_filter";
+      case "RECITATION":
+        return "content_filter";
+      default:
+        return "end_turn";
+    }
+  }
+  // 49c: Translate canonical ToolDefinition → Google functionDeclarations
+  toGoogleTools(tools) {
+    return {
+      functionDeclarations: tools.map((t) => ({
+        name: t.name,
+        description: t.description,
+        parameters: this.toGoogleSchema(t.inputSchema)
+      }))
+    };
+  }
+  mapSchemaType(type) {
+    switch (type.toLowerCase()) {
+      case "string":
+        return SchemaType.STRING;
+      case "number":
+        return SchemaType.NUMBER;
+      case "integer":
+        return SchemaType.INTEGER;
+      case "boolean":
+        return SchemaType.BOOLEAN;
+      case "array":
+        return SchemaType.ARRAY;
+      case "object":
+        return SchemaType.OBJECT;
+      default:
+        return SchemaType.STRING;
+    }
+  }
+  toGoogleSchema(schema) {
+    const result = {};
+    result.type = this.mapSchemaType(schema.type ?? "object");
+    if (schema.description) result.description = schema.description;
+    if (schema.properties) {
+      const props = {};
+      for (const [key, value] of Object.entries(schema.properties)) {
+        props[key] = this.toGoogleSchema(value);
+      }
+      result.properties = props;
+    }
+    if (schema.required) result.required = schema.required;
+    if (schema.items) result.items = this.toGoogleSchema(schema.items);
+    if (schema.enum) result.enum = schema.enum;
+    return result;
+  }
+  // 49e: Map multimodal content blocks to Google Content/Part types
+  toGoogleContents(messages) {
+    return messages.map((msg) => ({
+      role: msg.role === "assistant" ? "model" : "user",
+      parts: this.toGoogleParts(msg.content)
+    }));
+  }
+  toGoogleParts(content) {
+    if (typeof content === "string") {
+      return [{ text: content }];
+    }
+    return content.map((block) => {
+      switch (block.type) {
+        case "text":
+          return { text: block.text };
+        case "image":
+          if (block.source.type === "base64") {
+            return {
+              inlineData: {
+                mimeType: block.source.media_type,
+                data: block.source.data
+              }
+            };
+          }
+          return {
+            fileData: {
+              mimeType: "image/jpeg",
+              fileUri: block.source.url
+            }
+          };
+        case "file":
+          return {
+            inlineData: {
+              mimeType: block.source.media_type,
+              data: block.source.data
+            }
+          };
+        // Task 100: Map ToolUseBlock → Google functionCall part
+        case "tool_use":
+          return {
+            functionCall: {
+              name: block.name,
+              args: block.input
+            }
+          };
+        // Task 100: Map ToolResultBlock → Google functionResponse part
+        case "tool_result":
+          return {
+            functionResponse: {
+              name: block.tool_use_id,
+              response: { content: block.content }
+            }
+          };
+        default:
+          return { text: "[unsupported content type]" };
+      }
+    });
+  }
+};
+export {
+  GoogleProvider
+};
+//# sourceMappingURL=index.js.map

package/dist/google/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/google/index.ts"],"sourcesContent":["// Task 49: GoogleProvider — adapter for Google AI (Gemini)\n\nimport {\n  GoogleGenerativeAI,\n  SchemaType,\n  type GenerativeModel,\n  type Content,\n  type Part,\n  type FunctionDeclarationsTool,\n  type FunctionDeclarationSchema,\n  type FunctionDeclaration,\n  type GenerateContentStreamResult,\n} from '@google/generative-ai';\nimport type {\n  AIProvider,\n  CreateMessageParams,\n  StreamEvent,\n  ToolDefinition,\n  ContentBlock,\n  Message,\n} from '@yolo-labs/core-types';\n\n/** Configuration options for the Google Gemini provider. */\nexport interface GoogleProviderOptions {\n  apiKey: string;\n  defaultModel?: string;\n}\n\n/**\n * {@link AIProvider} adapter for the Google Gemini generative AI API.\n *\n * @remarks\n * Translates canonical {@link CreateMessageParams} into Google `generateContentStream`\n * calls and maps response chunks back to canonical {@link StreamEvent} types.\n * Google returns function call arguments in full (not streamed), so tool use\n * blocks emit a single `input_json_delta` with the complete JSON.\n * Requires `@google/generative-ai` as a peer dependency.\n */\nexport class GoogleProvider implements AIProvider {\n  private genAI: GoogleGenerativeAI;\n  private defaultModel: string;\n\n  /** Creates a new GoogleProvider with the given options. */\n  constructor(options: GoogleProviderOptions) {\n    this.genAI = new GoogleGenerativeAI(options.apiKey);\n    this.defaultModel = options.defaultModel ?? 'gemini-2.0-flash';\n  }\n\n  /**\n   * Creates a streaming message using the Google Generative AI SDK.\n   *\n   * @param params - Canonical message creation parameters.\n   * @returns An async iterable of canonical {@link StreamEvent} objects.\n   */\n  async *createMessage(params: CreateMessageParams): AsyncIterable<StreamEvent> {\n    const modelName = params.model || this.defaultModel;\n\n    // 49c: Translate canonical ToolDefinition → Google functionDeclarations\n    const tools = params.tools?.length\n      ? [this.toGoogleTools(params.tools)]\n      : undefined;\n\n    const model: GenerativeModel = this.genAI.getGenerativeModel({\n      model: modelName,\n      systemInstruction: params.system ? { role: 'user', parts: [{ text: params.system }] } : undefined,\n      tools,\n      generationConfig: {\n        maxOutputTokens: params.maxTokens,\n        temperature: params.temperature,\n        topP: params.topP,\n        stopSequences: params.stopSequences,\n      },\n    });\n\n    // 49e: Map multimodal content blocks to Google Part types\n    const contents = this.toGoogleContents(params.messages);\n\n    // Emit message_start\n    const messageId = `msg_${Date.now()}`;\n    yield {\n      type: 'message_start',\n      message: {\n        id: messageId,\n        model: modelName,\n        role: 'assistant',\n      },\n    };\n\n    // 49b: Map Google stream events to canonical StreamEvent types\n    const result: GenerateContentStreamResult = await model.generateContentStream({\n      contents,\n    });\n\n    let contentBlockIndex = 0;\n    let hasToolCalls = false;\n\n    for await (const chunk of result.stream) {\n      const candidates = chunk.candidates;\n      if (!candidates?.length) continue;\n\n      const candidate = candidates[0];\n      const parts = candidate.content?.parts;\n      if (!parts) continue;\n\n      for (const part of parts) {\n        if ('text' in part && part.text) {\n          // Text content\n          yield {\n            type: 'content_block_start',\n            index: contentBlockIndex,\n            contentBlock: { type: 'text' },\n          };\n          yield {\n            type: 'content_block_delta',\n            index: contentBlockIndex,\n            delta: { type: 'text_delta', text: part.text },\n          };\n          yield { type: 'content_block_stop', index: contentBlockIndex };\n          contentBlockIndex++;\n        }\n\n        // 49d: Handle Google's function call response format\n        if ('functionCall' in part && part.functionCall) {\n          hasToolCalls = true;\n          const toolCallId = `call_${Date.now()}_${contentBlockIndex}`;\n\n          yield {\n            type: 'content_block_start',\n            index: contentBlockIndex,\n            contentBlock: {\n              type: 'tool_use',\n              id: toolCallId,\n              name: part.functionCall.name,\n            },\n          };\n\n          // Google returns the full arguments at once, not streamed\n          const argsJson = JSON.stringify(part.functionCall.args ?? {});\n          yield {\n            type: 'content_block_delta',\n            index: contentBlockIndex,\n            delta: { type: 'input_json_delta', partial_json: argsJson },\n          };\n\n          yield { type: 'content_block_stop', index: contentBlockIndex };\n          contentBlockIndex++;\n        }\n      }\n\n      // Check for finish reason\n      if (candidate.finishReason) {\n        const stopReason = this.mapFinishReason(candidate.finishReason, hasToolCalls);\n        yield {\n          type: 'message_delta',\n          delta: { stop_reason: stopReason },\n          usage: chunk.usageMetadata\n            ? { output_tokens: chunk.usageMetadata.candidatesTokenCount ?? 0 }\n            : undefined,\n        };\n      }\n    }\n\n    yield { type: 'message_stop' };\n  }\n\n  private mapFinishReason(reason: string, hasToolCalls: boolean): string {\n    switch (reason) {\n      case 'STOP':\n        return hasToolCalls ? 'tool_use' : 'end_turn';\n      case 'MAX_TOKENS':\n        return 'max_tokens';\n      case 'SAFETY':\n        return 'content_filter';\n      case 'RECITATION':\n        return 'content_filter';\n      default:\n        return 'end_turn';\n    }\n  }\n\n  // 49c: Translate canonical ToolDefinition → Google functionDeclarations\n  private toGoogleTools(tools: ToolDefinition[]): FunctionDeclarationsTool {\n    return {\n      functionDeclarations: tools.map((t): FunctionDeclaration => ({\n        name: t.name,\n        description: t.description,\n        parameters: this.toGoogleSchema(t.inputSchema),\n      })),\n    };\n  }\n\n  private mapSchemaType(type: string): SchemaType {\n    switch (type.toLowerCase()) {\n      case 'string': return SchemaType.STRING;\n      case 'number': return SchemaType.NUMBER;\n      case 'integer': return SchemaType.INTEGER;\n      case 'boolean': return SchemaType.BOOLEAN;\n      case 'array': return SchemaType.ARRAY;\n      case 'object': return SchemaType.OBJECT;\n      default: return SchemaType.STRING;\n    }\n  }\n\n  private toGoogleSchema(schema: Record<string, unknown>): FunctionDeclarationSchema {\n    const result: Record<string, unknown> = {};\n\n    result.type = this.mapSchemaType((schema.type as string) ?? 'object');\n    if (schema.description) result.description = schema.description;\n    if (schema.properties) {\n      const props: Record<string, unknown> = {};\n      for (const [key, value] of Object.entries(schema.properties as Record<string, unknown>)) {\n        props[key] = this.toGoogleSchema(value as Record<string, unknown>);\n      }\n      result.properties = props;\n    }\n    if (schema.required) result.required = schema.required;\n    if (schema.items) result.items = this.toGoogleSchema(schema.items as Record<string, unknown>);\n    if (schema.enum) result.enum = schema.enum;\n\n    return result as unknown as FunctionDeclarationSchema;\n  }\n\n  // 49e: Map multimodal content blocks to Google Content/Part types\n  private toGoogleContents(messages: Message[]): Content[] {\n    return messages.map((msg) => ({\n      role: msg.role === 'assistant' ? 'model' : 'user',\n      parts: this.toGoogleParts(msg.content),\n    }));\n  }\n\n  private toGoogleParts(content: string | ContentBlock[]): Part[] {\n    if (typeof content === 'string') {\n      return [{ text: content }];\n    }\n\n    return content.map((block: ContentBlock): Part => {\n      switch (block.type) {\n        case 'text':\n          return { text: block.text };\n        case 'image':\n          if (block.source.type === 'base64') {\n            return {\n              inlineData: {\n                mimeType: block.source.media_type,\n                data: block.source.data,\n              },\n            };\n          }\n          // Google supports file URI for URL images\n          return {\n            fileData: {\n              mimeType: 'image/jpeg',\n              fileUri: block.source.url,\n            },\n          };\n        case 'file':\n          return {\n            inlineData: {\n              mimeType: block.source.media_type,\n              data: block.source.data,\n            },\n          };\n        // Task 100: Map ToolUseBlock → Google functionCall part\n        case 'tool_use':\n          return {\n            functionCall: {\n              name: block.name,\n              args: block.input as Record<string, string>,\n            },\n          };\n        // Task 100: Map ToolResultBlock → Google functionResponse part\n        case 'tool_result':\n          return {\n            functionResponse: {\n              name: block.tool_use_id,\n              response: { content: block.content },\n            },\n          };\n        default:\n          return { text: '[unsupported content type]' };\n      }\n    });\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+import { AIProvider, CreateMessageParams, StreamEvent } from '@yolo-labs/core-types';
+
+/** Predicate that decides whether a given error should trigger failover to the next provider. */
+interface FailoverTrigger {
+    (error: unknown): boolean;
+}
+/**
+ * Configuration options for the FailoverRouter.
+ *
+ * @remarks
+ * Providers are tried in order. Each provider is retried up to
+ * `maxRetriesPerProvider` times with exponential backoff before
+ * failing over to the next. Supply `shouldFailover` for custom
+ * error classification; the default triggers on network errors,
+ * rate limits (429), and server errors (5xx).
+ */
+interface FailoverRouterOptions {
+    providers: AIProvider[];
+    maxRetriesPerProvider?: number;
+    backoffMs?: number;
+    backoffMultiplier?: number;
+    shouldFailover?: FailoverTrigger;
+}
+/**
+ * Transparent failover across multiple AI providers with retry and exponential backoff.
+ *
+ * @remarks
+ * Implements {@link AIProvider}, so it can be used as a drop-in replacement
+ * anywhere a single provider is expected. Non-recoverable errors (as
+ * determined by the `shouldFailover` predicate) are thrown immediately
+ * without trying additional providers.
+ *
+ * @example
+ * ```ts
+ * const router = new FailoverRouter({
+ *   providers: [anthropic, openai, google],
+ *   maxRetriesPerProvider: 2,
+ * });
+ * for await (const event of router.createMessage(params)) { ... }
+ * ```
+ */
+declare class FailoverRouter implements AIProvider {
+    private providers;
+    private maxRetriesPerProvider;
+    private backoffMs;
+    private backoffMultiplier;
+    private shouldFailover;
+    /** Creates a new FailoverRouter; requires at least one provider. */
+    constructor(options: FailoverRouterOptions);
+    /**
+     * Streams a message, failing over to the next provider on recoverable errors.
+     *
+     * @param params - Canonical message creation parameters.
+     * @returns An async iterable of canonical {@link StreamEvent} objects.
+     * @throws The last error encountered if all providers and retries are exhausted.
+     */
+    createMessage(params: CreateMessageParams): AsyncIterable<StreamEvent>;
+}
+
+export { FailoverRouter, type FailoverRouterOptions, type FailoverTrigger };

package/dist/index.js

@@ -0,0 +1,81 @@
+// src/failover-router.ts
+var defaultFailoverTrigger = (error) => {
+  if (error instanceof Error) {
+    const msg = error.message.toLowerCase();
+    if (msg.includes("econnrefused") || msg.includes("enotfound") || msg.includes("timeout")) {
+      return true;
+    }
+    if (msg.includes("429") || msg.includes("rate limit")) return true;
+    if (msg.includes("500") || msg.includes("502") || msg.includes("503") || msg.includes("504")) {
+      return true;
+    }
+    if (msg.includes("internal server error") || msg.includes("service unavailable")) {
+      return true;
+    }
+  }
+  const statusError = error;
+  if (statusError.status && (statusError.status === 429 || statusError.status >= 500)) {
+    return true;
+  }
+  return false;
+};
+var FailoverRouter = class {
+  providers;
+  maxRetriesPerProvider;
+  backoffMs;
+  backoffMultiplier;
+  shouldFailover;
+  /** Creates a new FailoverRouter; requires at least one provider. */
+  constructor(options) {
+    if (options.providers.length === 0) {
+      throw new Error("FailoverRouter requires at least one provider");
+    }
+    this.providers = options.providers;
+    this.maxRetriesPerProvider = options.maxRetriesPerProvider ?? 1;
+    this.backoffMs = options.backoffMs ?? 1e3;
+    this.backoffMultiplier = options.backoffMultiplier ?? 2;
+    this.shouldFailover = options.shouldFailover ?? defaultFailoverTrigger;
+  }
+  /**
+   * Streams a message, failing over to the next provider on recoverable errors.
+   *
+   * @param params - Canonical message creation parameters.
+   * @returns An async iterable of canonical {@link StreamEvent} objects.
+   * @throws The last error encountered if all providers and retries are exhausted.
+   */
+  async *createMessage(params) {
+    let lastError;
+    for (let providerIndex = 0; providerIndex < this.providers.length; providerIndex++) {
+      const provider = this.providers[providerIndex];
+      let retries = 0;
+      while (retries <= this.maxRetriesPerProvider) {
+        try {
+          const stream = provider.createMessage(params);
+          const events = [];
+          for await (const event of stream) {
+            yield event;
+          }
+          return;
+        } catch (err) {
+          lastError = err;
+          if (!this.shouldFailover(err)) {
+            throw err;
+          }
+          retries++;
+          if (retries <= this.maxRetriesPerProvider) {
+            const delay = this.backoffMs * Math.pow(this.backoffMultiplier, retries - 1);
+            await sleep(delay);
+          }
+        }
+      }
+    }
+    throw lastError ?? new Error("All providers failed");
+  }
+};
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export {
+  FailoverRouter
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/failover-router.ts"],"sourcesContent":["// Task 50: FailoverRouter — transparent provider failover\n\nimport type {\n  AIProvider,\n  CreateMessageParams,\n  StreamEvent,\n} from '@yolo-labs/core-types';\n\n/** Predicate that decides whether a given error should trigger failover to the next provider. */\nexport interface FailoverTrigger {\n  (error: unknown): boolean;\n}\n\n/**\n * Configuration options for the FailoverRouter.\n *\n * @remarks\n * Providers are tried in order. Each provider is retried up to\n * `maxRetriesPerProvider` times with exponential backoff before\n * failing over to the next. Supply `shouldFailover` for custom\n * error classification; the default triggers on network errors,\n * rate limits (429), and server errors (5xx).\n */\nexport interface FailoverRouterOptions {\n  providers: AIProvider[];\n  maxRetriesPerProvider?: number;\n  backoffMs?: number;\n  backoffMultiplier?: number;\n  shouldFailover?: FailoverTrigger;\n}\n\n// 50d: Default failover trigger — network errors, rate limits, 5xx\nconst defaultFailoverTrigger: FailoverTrigger = (error: unknown): boolean => {\n  if (error instanceof Error) {\n    const msg = error.message.toLowerCase();\n    // Network errors\n    if (msg.includes('econnrefused') || msg.includes('enotfound') || msg.includes('timeout')) {\n      return true;\n    }\n    // Rate limit or server errors (check for status code patterns)\n    if (msg.includes('429') || msg.includes('rate limit')) return true;\n    if (msg.includes('500') || msg.includes('502') || msg.includes('503') || msg.includes('504')) {\n      return true;\n    }\n    if (msg.includes('internal server error') || msg.includes('service unavailable')) {\n      return true;\n    }\n  }\n  // Check for status property on error objects\n  const statusError = error as { status?: number };\n  if (statusError.status && (statusError.status === 429 || statusError.status >= 500)) {\n    return true;\n  }\n  return false;\n};\n\n/**\n * Transparent failover across multiple AI providers with retry and exponential backoff.\n *\n * @remarks\n * Implements {@link AIProvider}, so it can be used as a drop-in replacement\n * anywhere a single provider is expected. Non-recoverable errors (as\n * determined by the `shouldFailover` predicate) are thrown immediately\n * without trying additional providers.\n *\n * @example\n * ```ts\n * const router = new FailoverRouter({\n *   providers: [anthropic, openai, google],\n *   maxRetriesPerProvider: 2,\n * });\n * for await (const event of router.createMessage(params)) { ... }\n * ```\n */\nexport class FailoverRouter implements AIProvider {\n  private providers: AIProvider[];\n  private maxRetriesPerProvider: number;\n  private backoffMs: number;\n  private backoffMultiplier: number;\n  private shouldFailover: FailoverTrigger;\n\n  /** Creates a new FailoverRouter; requires at least one provider. */\n  constructor(options: FailoverRouterOptions) {\n    if (options.providers.length === 0) {\n      throw new Error('FailoverRouter requires at least one provider');\n    }\n    this.providers = options.providers;\n    this.maxRetriesPerProvider = options.maxRetriesPerProvider ?? 1;\n    this.backoffMs = options.backoffMs ?? 1000;\n    this.backoffMultiplier = options.backoffMultiplier ?? 2;\n    this.shouldFailover = options.shouldFailover ?? defaultFailoverTrigger;\n  }\n\n  /**\n   * Streams a message, failing over to the next provider on recoverable errors.\n   *\n   * @param params - Canonical message creation parameters.\n   * @returns An async iterable of canonical {@link StreamEvent} objects.\n   * @throws The last error encountered if all providers and retries are exhausted.\n   */\n  async *createMessage(params: CreateMessageParams): AsyncIterable<StreamEvent> {\n    let lastError: unknown;\n\n    for (let providerIndex = 0; providerIndex < this.providers.length; providerIndex++) {\n      const provider = this.providers[providerIndex];\n      let retries = 0;\n\n      while (retries <= this.maxRetriesPerProvider) {\n        try {\n          // Try to create the stream and yield from it\n          const stream = provider.createMessage(params);\n          const events: StreamEvent[] = [];\n\n          // Buffer events to detect errors before yielding\n          // We yield immediately for streaming, but catch errors mid-stream\n          for await (const event of stream) {\n            yield event;\n          }\n\n          // If we got here, the stream completed successfully\n          return;\n        } catch (err) {\n          lastError = err;\n\n          // 50b/50c: Check if we should failover\n          if (!this.shouldFailover(err)) {\n            // Non-recoverable error, don't failover\n            throw err;\n          }\n\n          retries++;\n\n          if (retries <= this.maxRetriesPerProvider) {\n            // 50c: Backoff before retry on same provider\n            const delay = this.backoffMs * Math.pow(this.backoffMultiplier, retries - 1);\n            await sleep(delay);\n          }\n        }\n      }\n\n      // All retries exhausted for this provider, try next\n    }\n\n    // All providers failed\n    throw lastError ?? new Error('All providers failed');\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"],"mappings":";AAgCA,IAAM,yBAA0C,CAAC,UAA4B;AAC3E,MAAI,iBAAiB,OAAO;AAC1B,UAAM,MAAM,MAAM,QAAQ,YAAY;AAEtC,QAAI,IAAI,SAAS,cAAc,KAAK,IAAI,SAAS,WAAW,KAAK,IAAI,SAAS,SAAS,GAAG;AACxF,aAAO;AAAA,IACT;AAEA,QAAI,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,YAAY,EAAG,QAAO;AAC9D,QAAI,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,GAAG;AAC5F,aAAO;AAAA,IACT;AACA,QAAI,IAAI,SAAS,uBAAuB,KAAK,IAAI,SAAS,qBAAqB,GAAG;AAChF,aAAO;AAAA,IACT;AAAA,EACF;AAEA,QAAM,cAAc;AACpB,MAAI,YAAY,WAAW,YAAY,WAAW,OAAO,YAAY,UAAU,MAAM;AACnF,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAoBO,IAAM,iBAAN,MAA2C;AAAA,EACxC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAGR,YAAY,SAAgC;AAC1C,QAAI,QAAQ,UAAU,WAAW,GAAG;AAClC,YAAM,IAAI,MAAM,+CAA+C;AAAA,IACjE;AACA,SAAK,YAAY,QAAQ;AACzB,SAAK,wBAAwB,QAAQ,yBAAyB;AAC9D,SAAK,YAAY,QAAQ,aAAa;AACtC,SAAK,oBAAoB,QAAQ,qBAAqB;AACtD,SAAK,iBAAiB,QAAQ,kBAAkB;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAO,cAAc,QAAyD;AAC5E,QAAI;AAEJ,aAAS,gBAAgB,GAAG,gBAAgB,KAAK,UAAU,QAAQ,iBAAiB;AAClF,YAAM,WAAW,KAAK,UAAU,aAAa;AAC7C,UAAI,UAAU;AAEd,aAAO,WAAW,KAAK,uBAAuB;AAC5C,YAAI;AAEF,gBAAM,SAAS,SAAS,cAAc,MAAM;AAC5C,gBAAM,SAAwB,CAAC;AAI/B,2BAAiB,SAAS,QAAQ;AAChC,kBAAM;AAAA,UACR;AAGA;AAAA,QACF,SAAS,KAAK;AACZ,sBAAY;AAGZ,cAAI,CAAC,KAAK,eAAe,GAAG,GAAG;AAE7B,kBAAM;AAAA,UACR;AAEA;AAEA,cAAI,WAAW,KAAK,uBAAuB;AAEzC,kBAAM,QAAQ,KAAK,YAAY,KAAK,IAAI,KAAK,mBAAmB,UAAU,CAAC;AAC3E,kBAAM,MAAM,KAAK;AAAA,UACnB;AAAA,QACF;AAAA,MACF;AAAA,IAGF;AAGA,UAAM,aAAa,IAAI,MAAM,sBAAsB;AAAA,EACrD;AACF;AAEA,SAAS,MAAM,IAA2B;AACxC,SAAO,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,EAAE,CAAC;AACzD;","names":[]}

package/dist/openai/index.d.ts

@@ -0,0 +1,36 @@
+import { AIProvider, CreateMessageParams, StreamEvent } from '@yolo-labs/core-types';
+
+/** Configuration options for the OpenAI provider. */
+interface OpenAIProviderOptions {
+    apiKey?: string;
+    baseURL?: string;
+    organization?: string;
+    defaultModel?: string;
+}
+/**
+ * {@link AIProvider} adapter for the OpenAI chat completions API.
+ *
+ * @remarks
+ * Translates canonical {@link CreateMessageParams} into OpenAI chat completion
+ * calls and maps streaming chunks back to canonical {@link StreamEvent} types.
+ * Handles OpenAI's `tool_calls` response format and finish reason mapping.
+ * Requires `openai` as a peer dependency.
+ */
+declare class OpenAIProvider implements AIProvider {
+    private client;
+    private defaultModel;
+    /** Creates a new OpenAIProvider with the given options. */
+    constructor(options?: OpenAIProviderOptions);
+    /**
+     * Creates a streaming message using the OpenAI SDK.
+     *
+     * @param params - Canonical message creation parameters.
+     * @returns An async iterable of canonical {@link StreamEvent} objects.
+     */
+    createMessage(params: CreateMessageParams): AsyncIterable<StreamEvent>;
+    private mapFinishReason;
+    private toOpenAITool;
+    private toOpenAIMessages;
+}
+
+export { OpenAIProvider, type OpenAIProviderOptions };

package/dist/openai/index.js

@@ -0,0 +1,252 @@
+// src/openai/index.ts
+import OpenAI from "openai";
+var OpenAIProvider = class {
+  client;
+  defaultModel;
+  /** Creates a new OpenAIProvider with the given options. */
+  constructor(options = {}) {
+    this.client = new OpenAI({
+      apiKey: options.apiKey,
+      baseURL: options.baseURL,
+      organization: options.organization
+    });
+    this.defaultModel = options.defaultModel ?? "gpt-4o";
+  }
+  /**
+   * Creates a streaming message using the OpenAI SDK.
+   *
+   * @param params - Canonical message creation parameters.
+   * @returns An async iterable of canonical {@link StreamEvent} objects.
+   */
+  async *createMessage(params) {
+    const model = params.model || this.defaultModel;
+    const messages = [];
+    if (params.system) {
+      messages.push({ role: "system", content: params.system });
+    }
+    for (const msg of params.messages) {
+      messages.push(...this.toOpenAIMessages(msg));
+    }
+    const tools = params.tools?.map((t) => this.toOpenAITool(t));
+    const requestParams = {
+      model,
+      messages,
+      stream: true,
+      stream_options: { include_usage: true }
+    };
+    if (params.maxTokens) {
+      requestParams.max_tokens = params.maxTokens;
+    }
+    if (tools && tools.length > 0) {
+      requestParams.tools = tools;
+    }
+    if (params.temperature !== void 0) {
+      requestParams.temperature = params.temperature;
+    }
+    if (params.topP !== void 0) {
+      requestParams.top_p = params.topP;
+    }
+    if (params.stopSequences && params.stopSequences.length > 0) {
+      requestParams.stop = params.stopSequences;
+    }
+    const messageId = `msg_${Date.now()}`;
+    yield {
+      type: "message_start",
+      message: {
+        id: messageId,
+        model,
+        role: "assistant"
+      }
+    };
+    const stream = await this.client.chat.completions.create(requestParams);
+    let contentBlockIndex = 0;
+    let textBlockStarted = false;
+    const toolCallBlocks = /* @__PURE__ */ new Map();
+    let finishReason = null;
+    for await (const chunk of stream) {
+      const choice = chunk.choices?.[0];
+      if (!choice) {
+        if (chunk.usage) {
+          yield {
+            type: "message_delta",
+            delta: { stop_reason: finishReason },
+            usage: { output_tokens: chunk.usage.completion_tokens }
+          };
+        }
+        continue;
+      }
+      const delta = choice.delta;
+      if (delta?.content) {
+        if (!textBlockStarted) {
+          yield {
+            type: "content_block_start",
+            index: contentBlockIndex,
+            contentBlock: { type: "text" }
+          };
+          textBlockStarted = true;
+        }
+        yield {
+          type: "content_block_delta",
+          index: contentBlockIndex,
+          delta: { type: "text_delta", text: delta.content }
+        };
+      }
+      if (delta?.tool_calls) {
+        for (const tc of delta.tool_calls) {
+          const tcIndex = tc.index;
+          if (!toolCallBlocks.has(tcIndex)) {
+            if (textBlockStarted) {
+              yield { type: "content_block_stop", index: contentBlockIndex };
+              contentBlockIndex++;
+              textBlockStarted = false;
+            }
+            toolCallBlocks.set(tcIndex, {
+              id: tc.id ?? "",
+              name: tc.function?.name ?? "",
+              started: false
+            });
+          }
+          const block = toolCallBlocks.get(tcIndex);
+          if (tc.id) block.id = tc.id;
+          if (tc.function?.name) block.name = tc.function.name;
+          if (!block.started && block.id && block.name) {
+            yield {
+              type: "content_block_start",
+              index: contentBlockIndex + tcIndex,
+              contentBlock: {
+                type: "tool_use",
+                id: block.id,
+                name: block.name
+              }
+            };
+            block.started = true;
+          }
+          if (tc.function?.arguments) {
+            yield {
+              type: "content_block_delta",
+              index: contentBlockIndex + tcIndex,
+              delta: {
+                type: "input_json_delta",
+                partial_json: tc.function.arguments
+              }
+            };
+          }
+        }
+      }
+      if (choice.finish_reason) {
+        finishReason = this.mapFinishReason(choice.finish_reason);
+        if (textBlockStarted) {
+          yield { type: "content_block_stop", index: contentBlockIndex };
+          contentBlockIndex++;
+          textBlockStarted = false;
+        }
+        for (const [tcIdx, block] of toolCallBlocks) {
+          if (block.started) {
+            yield { type: "content_block_stop", index: contentBlockIndex + tcIdx };
+          }
+        }
+      }
+    }
+    if (finishReason) {
+      yield {
+        type: "message_delta",
+        delta: { stop_reason: finishReason }
+      };
+    }
+    yield { type: "message_stop" };
+  }
+  mapFinishReason(reason) {
+    switch (reason) {
+      case "stop":
+        return "end_turn";
+      case "tool_calls":
+        return "tool_use";
+      case "length":
+        return "max_tokens";
+      case "content_filter":
+        return "content_filter";
+      default:
+        return reason;
+    }
+  }
+  // 48c: Translate canonical ToolDefinition → OpenAI tool format
+  toOpenAITool(tool) {
+    return {
+      type: "function",
+      function: {
+        name: tool.name,
+        description: tool.description,
+        parameters: tool.inputSchema
+      }
+    };
+  }
+  // 48e: Map multimodal content blocks to OpenAI message format
+  // Task 99: Returns an array because ToolResultBlocks expand into multiple 'tool' role messages
+  toOpenAIMessages(message) {
+    if (typeof message.content === "string") {
+      return [{ role: message.role === "user" ? "user" : "assistant", content: message.content }];
+    }
+    if (message.role === "assistant") {
+      const textBlocks = message.content.filter((b) => b.type === "text");
+      const toolUseBlocks = message.content.filter((b) => b.type === "tool_use");
+      const text = textBlocks.filter((b) => b.type === "text").map((b) => b.text).join("");
+      if (toolUseBlocks.length > 0) {
+        const toolCalls = toolUseBlocks.filter((b) => b.type === "tool_use").map((b) => ({
+          id: b.id,
+          type: "function",
+          function: {
+            name: b.name,
+            arguments: JSON.stringify(b.input)
+          }
+        }));
+        return [{
+          role: "assistant",
+          content: text || null,
+          tool_calls: toolCalls
+        }];
+      }
+      return [{ role: "assistant", content: text }];
+    }
+    const toolResultBlocks = message.content.filter((b) => b.type === "tool_result");
+    if (toolResultBlocks.length > 0) {
+      return toolResultBlocks.filter((b) => b.type === "tool_result").map((b) => ({
+        role: "tool",
+        tool_call_id: b.tool_use_id,
+        content: b.content
+      }));
+    }
+    const parts = message.content.map(
+      (block) => {
+        switch (block.type) {
+          case "text":
+            return { type: "text", text: block.text };
+          case "image":
+            if (block.source.type === "base64") {
+              return {
+                type: "image_url",
+                image_url: {
+                  url: `data:${block.source.media_type};base64,${block.source.data}`
+                }
+              };
+            }
+            return {
+              type: "image_url",
+              image_url: { url: block.source.url }
+            };
+          case "file":
+            return {
+              type: "text",
+              text: `[File: ${block.source.name ?? "attachment"} (${block.source.media_type})]`
+            };
+          default:
+            return { type: "text", text: "[unsupported content type]" };
+        }
+      }
+    );
+    return [{ role: "user", content: parts }];
+  }
+};
+export {
+  OpenAIProvider
+};
+//# sourceMappingURL=index.js.map

package/dist/openai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/openai/index.ts"],"sourcesContent":["// Task 48: OpenAIProvider — adapter for openai SDK\n\nimport OpenAI from 'openai';\nimport type {\n  AIProvider,\n  CreateMessageParams,\n  StreamEvent,\n  ToolDefinition,\n  ContentBlock,\n  Message,\n} from '@yolo-labs/core-types';\n\n/** Configuration options for the OpenAI provider. */\nexport interface OpenAIProviderOptions {\n  apiKey?: string;\n  baseURL?: string;\n  organization?: string;\n  defaultModel?: string;\n}\n\n/**\n * {@link AIProvider} adapter for the OpenAI chat completions API.\n *\n * @remarks\n * Translates canonical {@link CreateMessageParams} into OpenAI chat completion\n * calls and maps streaming chunks back to canonical {@link StreamEvent} types.\n * Handles OpenAI's `tool_calls` response format and finish reason mapping.\n * Requires `openai` as a peer dependency.\n */\nexport class OpenAIProvider implements AIProvider {\n  private client: OpenAI;\n  private defaultModel: string;\n\n  /** Creates a new OpenAIProvider with the given options. */\n  constructor(options: OpenAIProviderOptions = {}) {\n    this.client = new OpenAI({\n      apiKey: options.apiKey,\n      baseURL: options.baseURL,\n      organization: options.organization,\n    });\n    this.defaultModel = options.defaultModel ?? 'gpt-4o';\n  }\n\n  /**\n   * Creates a streaming message using the OpenAI SDK.\n   *\n   * @param params - Canonical message creation parameters.\n   * @returns An async iterable of canonical {@link StreamEvent} objects.\n   */\n  async *createMessage(params: CreateMessageParams): AsyncIterable<StreamEvent> {\n    const model = params.model || this.defaultModel;\n\n    // Build OpenAI messages array\n    const messages: OpenAI.ChatCompletionMessageParam[] = [];\n\n    // System message\n    if (params.system) {\n      messages.push({ role: 'system', content: params.system });\n    }\n\n    // 48e: Map multimodal content blocks to OpenAI content array format\n    // Task 99: toOpenAIMessages returns an array (ToolResultBlocks expand to multiple messages)\n    for (const msg of params.messages) {\n      messages.push(...this.toOpenAIMessages(msg));\n    }\n\n    // 48c: Translate canonical ToolDefinition → OpenAI tools with function.parameters\n    const tools = params.tools?.map((t) => this.toOpenAITool(t));\n\n    const requestParams: OpenAI.ChatCompletionCreateParamsStreaming = {\n      model,\n      messages,\n      stream: true,\n      stream_options: { include_usage: true },\n    };\n\n    if (params.maxTokens) {\n      requestParams.max_tokens = params.maxTokens;\n    }\n    if (tools && tools.length > 0) {\n      requestParams.tools = tools;\n    }\n    if (params.temperature !== undefined) {\n      requestParams.temperature = params.temperature;\n    }\n    if (params.topP !== undefined) {\n      requestParams.top_p = params.topP;\n    }\n    if (params.stopSequences && params.stopSequences.length > 0) {\n      requestParams.stop = params.stopSequences;\n    }\n\n    // Emit message_start\n    const messageId = `msg_${Date.now()}`;\n    yield {\n      type: 'message_start',\n      message: {\n        id: messageId,\n        model,\n        role: 'assistant',\n      },\n    };\n\n    // 48b: Map OpenAI stream chunks to canonical StreamEvent types\n    const stream = await this.client.chat.completions.create(requestParams);\n\n    let contentBlockIndex = 0;\n    let textBlockStarted = false;\n    // 48d: Track tool calls by index\n    const toolCallBlocks = new Map<number, { id: string; name: string; started: boolean }>();\n    let finishReason: string | null = null;\n\n    for await (const chunk of stream) {\n      const choice = chunk.choices?.[0];\n      if (!choice) {\n        // Usage-only chunk at the end\n        if (chunk.usage) {\n          yield {\n            type: 'message_delta',\n            delta: { stop_reason: finishReason },\n            usage: { output_tokens: chunk.usage.completion_tokens },\n          };\n        }\n        continue;\n      }\n\n      const delta = choice.delta;\n\n      // Handle text content\n      if (delta?.content) {\n        if (!textBlockStarted) {\n          yield {\n            type: 'content_block_start',\n            index: contentBlockIndex,\n            contentBlock: { type: 'text' },\n          };\n          textBlockStarted = true;\n        }\n        yield {\n          type: 'content_block_delta',\n          index: contentBlockIndex,\n          delta: { type: 'text_delta', text: delta.content },\n        };\n      }\n\n      // 48d: Handle OpenAI's tool_calls response format\n      if (delta?.tool_calls) {\n        for (const tc of delta.tool_calls) {\n          const tcIndex = tc.index;\n\n          if (!toolCallBlocks.has(tcIndex)) {\n            // Close text block if it was open\n            if (textBlockStarted) {\n              yield { type: 'content_block_stop', index: contentBlockIndex };\n              contentBlockIndex++;\n              textBlockStarted = false;\n            }\n\n            toolCallBlocks.set(tcIndex, {\n              id: tc.id ?? '',\n              name: tc.function?.name ?? '',\n              started: false,\n            });\n          }\n\n          const block = toolCallBlocks.get(tcIndex)!;\n\n          // Update id/name if provided in this chunk\n          if (tc.id) block.id = tc.id;\n          if (tc.function?.name) block.name = tc.function.name;\n\n          if (!block.started && block.id && block.name) {\n            yield {\n              type: 'content_block_start',\n              index: contentBlockIndex + tcIndex,\n              contentBlock: {\n                type: 'tool_use',\n                id: block.id,\n                name: block.name,\n              },\n            };\n            block.started = true;\n          }\n\n          // Stream function arguments as input_json_delta\n          if (tc.function?.arguments) {\n            yield {\n              type: 'content_block_delta',\n              index: contentBlockIndex + tcIndex,\n              delta: {\n                type: 'input_json_delta',\n                partial_json: tc.function.arguments,\n              },\n            };\n          }\n        }\n      }\n\n      // Finish reason\n      if (choice.finish_reason) {\n        finishReason = this.mapFinishReason(choice.finish_reason);\n\n        // Close any open blocks\n        if (textBlockStarted) {\n          yield { type: 'content_block_stop', index: contentBlockIndex };\n          contentBlockIndex++;\n          textBlockStarted = false;\n        }\n        for (const [tcIdx, block] of toolCallBlocks) {\n          if (block.started) {\n            yield { type: 'content_block_stop', index: contentBlockIndex + tcIdx };\n          }\n        }\n      }\n    }\n\n    // Emit message_delta with stop reason if not already emitted by usage chunk\n    if (finishReason) {\n      yield {\n        type: 'message_delta',\n        delta: { stop_reason: finishReason },\n      };\n    }\n\n    yield { type: 'message_stop' };\n  }\n\n  private mapFinishReason(reason: string): string {\n    switch (reason) {\n      case 'stop':\n        return 'end_turn';\n      case 'tool_calls':\n        return 'tool_use';\n      case 'length':\n        return 'max_tokens';\n      case 'content_filter':\n        return 'content_filter';\n      default:\n        return reason;\n    }\n  }\n\n  // 48c: Translate canonical ToolDefinition → OpenAI tool format\n  private toOpenAITool(\n    tool: ToolDefinition,\n  ): OpenAI.ChatCompletionTool {\n    return {\n      type: 'function',\n      function: {\n        name: tool.name,\n        description: tool.description,\n        parameters: tool.inputSchema as Record<string, unknown>,\n      },\n    };\n  }\n\n  // 48e: Map multimodal content blocks to OpenAI message format\n  // Task 99: Returns an array because ToolResultBlocks expand into multiple 'tool' role messages\n  private toOpenAIMessages(\n    message: Message,\n  ): OpenAI.ChatCompletionMessageParam[] {\n    if (typeof message.content === 'string') {\n      return [{ role: message.role === 'user' ? 'user' : 'assistant', content: message.content }];\n    }\n\n    if (message.role === 'assistant') {\n      // Task 99: Assistant messages with ToolUseBlock → set tool_calls array\n      const textBlocks = message.content.filter((b) => b.type === 'text');\n      const toolUseBlocks = message.content.filter((b) => b.type === 'tool_use');\n\n      const text = textBlocks\n        .filter((b): b is { type: 'text'; text: string } => b.type === 'text')\n        .map((b) => b.text)\n        .join('');\n\n      if (toolUseBlocks.length > 0) {\n        const toolCalls: OpenAI.ChatCompletionMessageToolCall[] = toolUseBlocks\n          .filter((b): b is import('@yolo-labs/core-types').ToolUseBlock => b.type === 'tool_use')\n          .map((b) => ({\n            id: b.id,\n            type: 'function' as const,\n            function: {\n              name: b.name,\n              arguments: JSON.stringify(b.input),\n            },\n          }));\n        return [{\n          role: 'assistant' as const,\n          content: text || null,\n          tool_calls: toolCalls,\n        }];\n      }\n\n      return [{ role: 'assistant' as const, content: text }];\n    }\n\n    // Task 99: User messages with ToolResultBlock → emit as separate 'tool' role messages\n    const toolResultBlocks = message.content.filter((b) => b.type === 'tool_result');\n    if (toolResultBlocks.length > 0) {\n      return toolResultBlocks\n        .filter((b): b is import('@yolo-labs/core-types').ToolResultBlock => b.type === 'tool_result')\n        .map((b) => ({\n          role: 'tool' as const,\n          tool_call_id: b.tool_use_id,\n          content: b.content,\n        }));\n    }\n\n    // User messages support multimodal content\n    const parts: OpenAI.ChatCompletionContentPart[] = message.content.map(\n      (block: ContentBlock) => {\n        switch (block.type) {\n          case 'text':\n            return { type: 'text' as const, text: block.text };\n          case 'image':\n            if (block.source.type === 'base64') {\n              return {\n                type: 'image_url' as const,\n                image_url: {\n                  url: `data:${block.source.media_type};base64,${block.source.data}`,\n                },\n              };\n            }\n            return {\n              type: 'image_url' as const,\n              image_url: { url: block.source.url },\n            };\n          case 'file':\n            // OpenAI doesn't natively support file blocks, convert to text reference\n            return {\n              type: 'text' as const,\n              text: `[File: ${block.source.name ?? 'attachment'} (${block.source.media_type})]`,\n            };\n          default:\n            return { type: 'text' as const, text: '[unsupported content type]' };\n        }\n      },\n    );\n\n    return [{ role: 'user', content: parts }];\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@yolo-labs/core-providers",
+  "version": "1.0.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./anthropic": {
+      "types": "./dist/anthropic/index.d.ts",
+      "import": "./dist/anthropic/index.js"
+    },
+    "./openai": {
+      "types": "./dist/openai/index.d.ts",
+      "import": "./dist/openai/index.js"
+    },
+    "./google": {
+      "types": "./dist/google/index.d.ts",
+      "import": "./dist/google/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@yolo-labs/core-types": "1.0.0"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/sdk": ">=0.30.0",
+    "@google/generative-ai": ">=0.21.0",
+    "openai": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/sdk": {
+      "optional": true
+    },
+    "openai": {
+      "optional": true
+    },
+    "@google/generative-ai": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@anthropic-ai/sdk": "^0.72.1",
+    "@google/generative-ai": "^0.24.1",
+    "openai": "^6.17.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0"
+  },
+  "description": "AI provider adapters (Anthropic, OpenAI, Google) with failover",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yolo-labs-hq/monorepo.git",
+    "directory": "yolo-core/packages/providers"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "homepage": "https://github.com/yolo-labs-hq/monorepo/tree/main/yolo-core#readme",
+  "bugs": {
+    "url": "https://github.com/yolo-labs-hq/monorepo/issues"
+  },
+  "scripts": {
+    "build": "tsup",
+    "clean": "rm -rf dist *.tsbuildinfo"
+  }
+}