llm-messages 0.1.0 → 0.3.0

package/dist/index.d.cts

@@ -10,7 +10,7 @@
 /** A supported provider. */
 type Provider = 'openai' | 'anthropic' | 'gemini';
 /** A stable, machine readable code describing a non fatal conversion event. */
-type WarningCode = 'generated-id' | 'unmapped-tool-result' | 'merged-role' | 'dropped-content' | 'invalid-json-arguments' | 'system-midstream';
+type WarningCode = 'generated-id' | 'unmapped-tool-result' | 'merged-role' | 'dropped-content' | 'invalid-json-arguments' | 'system-midstream' | 'gemini-url-image';
 /** A non fatal event raised during conversion. */
 interface Warning {
     code: WarningCode;
@@ -25,8 +25,16 @@ interface OpenAITextPart {
     type: 'text';
     text: string;
 }
-/** A content part. Non text parts (images, audio) are preserved verbatim. */
-type OpenAIContentPart = OpenAITextPart | {
+interface OpenAIImagePart {
+    type: 'image_url';
+    /** `url` is a remote https URL or a `data:<mediaType>;base64,<data>` data URL. */
+    image_url: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high' | 'original';
+    };
+}
+/** A content part. Unknown part types (audio, files) are preserved verbatim. */
+type OpenAIContentPart = OpenAITextPart | OpenAIImagePart | {
     type: string;
     [key: string]: unknown;
 };
@@ -80,7 +88,18 @@ interface AnthropicToolResultBlock {
     content: string | AnthropicTextBlock[];
     is_error?: boolean;
 }
-type AnthropicContentBlock = AnthropicTextBlock | AnthropicToolUseBlock | AnthropicToolResultBlock | {
+interface AnthropicImageBlock {
+    type: 'image';
+    source: {
+        type: 'base64';
+        media_type: string;
+        data: string;
+    } | {
+        type: 'url';
+        url: string;
+    };
+}
+type AnthropicContentBlock = AnthropicTextBlock | AnthropicToolUseBlock | AnthropicToolResultBlock | AnthropicImageBlock | {
     type: string;
     [key: string]: unknown;
 };
@@ -112,7 +131,19 @@ interface GeminiFunctionResponsePart {
         response: Record<string, unknown>;
     };
 }
-type GeminiPart = GeminiTextPart | GeminiFunctionCallPart | GeminiFunctionResponsePart | Record<string, unknown>;
+interface GeminiInlineDataPart {
+    inlineData: {
+        mimeType: string;
+        data: string;
+    };
+}
+interface GeminiFileDataPart {
+    fileData: {
+        mimeType?: string;
+        fileUri: string;
+    };
+}
+type GeminiPart = GeminiTextPart | GeminiFunctionCallPart | GeminiFunctionResponsePart | GeminiInlineDataPart | GeminiFileDataPart | Record<string, unknown>;
 interface GeminiContent {
     /** `model` is Gemini's name for the assistant role. */
     role?: 'user' | 'model';
@@ -176,4 +207,49 @@ declare function convert<From extends Provider, To extends Provider>(conversatio
     to: To;
 }, options?: ConvertOptions): ConversationOf<To>;
 
-export { type AnthropicContentBlock, type AnthropicConversation, type AnthropicMessage, type AnthropicTextBlock, type AnthropicToolResultBlock, type AnthropicToolUseBlock, type ConversationOf, type ConvertOptions, type GeminiContent, type GeminiConversation, type GeminiFunctionCallPart, type GeminiFunctionResponsePart, type GeminiPart, type GeminiTextPart, type OpenAIAssistantMessage, type OpenAIContentPart, type OpenAIMessage, type OpenAISystemMessage, type OpenAITextPart, type OpenAIToolCall, type OpenAIToolMessage, type OpenAIUserMessage, type Provider, type Warning, type WarningCode, convert, fromAnthropic, fromGemini, toAnthropic, toGemini };
+/**
+ * A provider-neutral image. `base64` carries the raw bytes plus media type
+ * (mapping to a data URL, an Anthropic base64 source or a Gemini `inlineData`
+ * part); `url` carries a remote reference.
+ */
+type NormalizedImage = {
+    kind: 'base64';
+    mediaType: string;
+    data: string;
+} | {
+    kind: 'url';
+    url: string;
+};
+/** Decomposes a `data:<mediaType>;base64,<data>` URL. Returns null otherwise. */
+declare function parseDataUrl(url: string): {
+    mediaType: string;
+    data: string;
+} | null;
+/** Reassembles a base64 data URL. The inverse of {@link parseDataUrl}. */
+declare function toDataUrl(mediaType: string, data: string): string;
+
+/** A provider-neutral finish reason. */
+type FinishReason = 'stop' | 'tool_calls' | 'length' | 'content_filter' | 'unknown';
+/** Provider-neutral token usage. */
+interface Usage {
+    inputTokens: number;
+    outputTokens: number;
+}
+/** A provider response normalized to the canonical OpenAI assistant shape. */
+interface NormalizedResponse {
+    message: OpenAIAssistantMessage;
+    finishReason: FinishReason;
+    usage: Usage;
+}
+/** Normalizes an OpenAI Chat Completions response body. */
+declare function responseFromOpenAI(body: unknown): NormalizedResponse;
+/** Normalizes an Anthropic Messages response body. */
+declare function responseFromAnthropic(body: unknown): NormalizedResponse;
+/** Normalizes a Gemini generateContent response body. */
+declare function responseFromGemini(body: unknown, options?: ConvertOptions): NormalizedResponse;
+/** Normalizes a provider response body into the canonical shape. */
+declare function normalizeResponse(body: unknown, route: {
+    from: Provider;
+}, options?: ConvertOptions): NormalizedResponse;
+
+export { type AnthropicContentBlock, type AnthropicConversation, type AnthropicImageBlock, type AnthropicMessage, type AnthropicTextBlock, type AnthropicToolResultBlock, type AnthropicToolUseBlock, type ConversationOf, type ConvertOptions, type FinishReason, type GeminiContent, type GeminiConversation, type GeminiFileDataPart, type GeminiFunctionCallPart, type GeminiFunctionResponsePart, type GeminiInlineDataPart, type GeminiPart, type GeminiTextPart, type NormalizedImage, type NormalizedResponse, type OpenAIAssistantMessage, type OpenAIContentPart, type OpenAIImagePart, type OpenAIMessage, type OpenAISystemMessage, type OpenAITextPart, type OpenAIToolCall, type OpenAIToolMessage, type OpenAIUserMessage, type Provider, type Usage, type Warning, type WarningCode, convert, fromAnthropic, fromGemini, normalizeResponse, parseDataUrl, responseFromAnthropic, responseFromGemini, responseFromOpenAI, toAnthropic, toDataUrl, toGemini };

package/dist/index.d.ts

@@ -10,7 +10,7 @@
 /** A supported provider. */
 type Provider = 'openai' | 'anthropic' | 'gemini';
 /** A stable, machine readable code describing a non fatal conversion event. */
-type WarningCode = 'generated-id' | 'unmapped-tool-result' | 'merged-role' | 'dropped-content' | 'invalid-json-arguments' | 'system-midstream';
+type WarningCode = 'generated-id' | 'unmapped-tool-result' | 'merged-role' | 'dropped-content' | 'invalid-json-arguments' | 'system-midstream' | 'gemini-url-image';
 /** A non fatal event raised during conversion. */
 interface Warning {
     code: WarningCode;
@@ -25,8 +25,16 @@ interface OpenAITextPart {
     type: 'text';
     text: string;
 }
-/** A content part. Non text parts (images, audio) are preserved verbatim. */
-type OpenAIContentPart = OpenAITextPart | {
+interface OpenAIImagePart {
+    type: 'image_url';
+    /** `url` is a remote https URL or a `data:<mediaType>;base64,<data>` data URL. */
+    image_url: {
+        url: string;
+        detail?: 'auto' | 'low' | 'high' | 'original';
+    };
+}
+/** A content part. Unknown part types (audio, files) are preserved verbatim. */
+type OpenAIContentPart = OpenAITextPart | OpenAIImagePart | {
     type: string;
     [key: string]: unknown;
 };
@@ -80,7 +88,18 @@ interface AnthropicToolResultBlock {
     content: string | AnthropicTextBlock[];
     is_error?: boolean;
 }
-type AnthropicContentBlock = AnthropicTextBlock | AnthropicToolUseBlock | AnthropicToolResultBlock | {
+interface AnthropicImageBlock {
+    type: 'image';
+    source: {
+        type: 'base64';
+        media_type: string;
+        data: string;
+    } | {
+        type: 'url';
+        url: string;
+    };
+}
+type AnthropicContentBlock = AnthropicTextBlock | AnthropicToolUseBlock | AnthropicToolResultBlock | AnthropicImageBlock | {
     type: string;
     [key: string]: unknown;
 };
@@ -112,7 +131,19 @@ interface GeminiFunctionResponsePart {
         response: Record<string, unknown>;
     };
 }
-type GeminiPart = GeminiTextPart | GeminiFunctionCallPart | GeminiFunctionResponsePart | Record<string, unknown>;
+interface GeminiInlineDataPart {
+    inlineData: {
+        mimeType: string;
+        data: string;
+    };
+}
+interface GeminiFileDataPart {
+    fileData: {
+        mimeType?: string;
+        fileUri: string;
+    };
+}
+type GeminiPart = GeminiTextPart | GeminiFunctionCallPart | GeminiFunctionResponsePart | GeminiInlineDataPart | GeminiFileDataPart | Record<string, unknown>;
 interface GeminiContent {
     /** `model` is Gemini's name for the assistant role. */
     role?: 'user' | 'model';
@@ -176,4 +207,49 @@ declare function convert<From extends Provider, To extends Provider>(conversatio
     to: To;
 }, options?: ConvertOptions): ConversationOf<To>;
 
-export { type AnthropicContentBlock, type AnthropicConversation, type AnthropicMessage, type AnthropicTextBlock, type AnthropicToolResultBlock, type AnthropicToolUseBlock, type ConversationOf, type ConvertOptions, type GeminiContent, type GeminiConversation, type GeminiFunctionCallPart, type GeminiFunctionResponsePart, type GeminiPart, type GeminiTextPart, type OpenAIAssistantMessage, type OpenAIContentPart, type OpenAIMessage, type OpenAISystemMessage, type OpenAITextPart, type OpenAIToolCall, type OpenAIToolMessage, type OpenAIUserMessage, type Provider, type Warning, type WarningCode, convert, fromAnthropic, fromGemini, toAnthropic, toGemini };
+/**
+ * A provider-neutral image. `base64` carries the raw bytes plus media type
+ * (mapping to a data URL, an Anthropic base64 source or a Gemini `inlineData`
+ * part); `url` carries a remote reference.
+ */
+type NormalizedImage = {
+    kind: 'base64';
+    mediaType: string;
+    data: string;
+} | {
+    kind: 'url';
+    url: string;
+};
+/** Decomposes a `data:<mediaType>;base64,<data>` URL. Returns null otherwise. */
+declare function parseDataUrl(url: string): {
+    mediaType: string;
+    data: string;
+} | null;
+/** Reassembles a base64 data URL. The inverse of {@link parseDataUrl}. */
+declare function toDataUrl(mediaType: string, data: string): string;
+
+/** A provider-neutral finish reason. */
+type FinishReason = 'stop' | 'tool_calls' | 'length' | 'content_filter' | 'unknown';
+/** Provider-neutral token usage. */
+interface Usage {
+    inputTokens: number;
+    outputTokens: number;
+}
+/** A provider response normalized to the canonical OpenAI assistant shape. */
+interface NormalizedResponse {
+    message: OpenAIAssistantMessage;
+    finishReason: FinishReason;
+    usage: Usage;
+}
+/** Normalizes an OpenAI Chat Completions response body. */
+declare function responseFromOpenAI(body: unknown): NormalizedResponse;
+/** Normalizes an Anthropic Messages response body. */
+declare function responseFromAnthropic(body: unknown): NormalizedResponse;
+/** Normalizes a Gemini generateContent response body. */
+declare function responseFromGemini(body: unknown, options?: ConvertOptions): NormalizedResponse;
+/** Normalizes a provider response body into the canonical shape. */
+declare function normalizeResponse(body: unknown, route: {
+    from: Provider;
+}, options?: ConvertOptions): NormalizedResponse;
+
+export { type AnthropicContentBlock, type AnthropicConversation, type AnthropicImageBlock, type AnthropicMessage, type AnthropicTextBlock, type AnthropicToolResultBlock, type AnthropicToolUseBlock, type ConversationOf, type ConvertOptions, type FinishReason, type GeminiContent, type GeminiConversation, type GeminiFileDataPart, type GeminiFunctionCallPart, type GeminiFunctionResponsePart, type GeminiInlineDataPart, type GeminiPart, type GeminiTextPart, type NormalizedImage, type NormalizedResponse, type OpenAIAssistantMessage, type OpenAIContentPart, type OpenAIImagePart, type OpenAIMessage, type OpenAISystemMessage, type OpenAITextPart, type OpenAIToolCall, type OpenAIToolMessage, type OpenAIUserMessage, type Provider, type Usage, type Warning, type WarningCode, convert, fromAnthropic, fromGemini, normalizeResponse, parseDataUrl, responseFromAnthropic, responseFromGemini, responseFromOpenAI, toAnthropic, toDataUrl, toGemini };

package/dist/index.js

@@ -51,6 +51,68 @@ function unwrapResponse(response) {
   return JSON.stringify(response);
 }
 
+// src/image.ts
+var DATA_URL = /^data:([^;,]+);base64,(.*)$/s;
+function parseDataUrl(url) {
+  const match = DATA_URL.exec(url);
+  if (!match) return null;
+  return { mediaType: match[1], data: match[2] };
+}
+function toDataUrl(mediaType, data) {
+  return `data:${mediaType};base64,${data}`;
+}
+function imageFromOpenAI(part) {
+  if (!isRecord(part) || part.type !== "image_url" || !isRecord(part.image_url)) return null;
+  const url = part.image_url.url;
+  if (typeof url !== "string") return null;
+  const parsed = parseDataUrl(url);
+  return parsed ? { kind: "base64", ...parsed } : { kind: "url", url };
+}
+function imageToOpenAI(image) {
+  const url = image.kind === "base64" ? toDataUrl(image.mediaType, image.data) : image.url;
+  return { type: "image_url", image_url: { url } };
+}
+function imageFromAnthropic(block) {
+  if (!isRecord(block) || block.type !== "image" || !isRecord(block.source)) return null;
+  const source = block.source;
+  if (source.type === "base64" && typeof source.media_type === "string" && typeof source.data === "string") {
+    return { kind: "base64", mediaType: source.media_type, data: source.data };
+  }
+  if (source.type === "url" && typeof source.url === "string") {
+    return { kind: "url", url: source.url };
+  }
+  return null;
+}
+function imageToAnthropic(image) {
+  if (image.kind === "base64") {
+    return { type: "image", source: { type: "base64", media_type: image.mediaType, data: image.data } };
+  }
+  return { type: "image", source: { type: "url", url: image.url } };
+}
+function imageFromGemini(part) {
+  if (isRecord(part) && isRecord(part.inlineData)) {
+    const data = part.inlineData;
+    if (typeof data.mimeType === "string" && typeof data.data === "string") {
+      return { kind: "base64", mediaType: data.mimeType, data: data.data };
+    }
+  }
+  if (isRecord(part) && isRecord(part.fileData)) {
+    const data = part.fileData;
+    if (typeof data.fileUri === "string") return { kind: "url", url: data.fileUri };
+  }
+  return null;
+}
+function imageToGemini(image, reporter) {
+  if (image.kind === "base64") {
+    return { inlineData: { mimeType: image.mediaType, data: image.data } };
+  }
+  reporter.warn(
+    "gemini-url-image",
+    "A remote image URL was emitted as Gemini fileData.fileUri; Gemini may require the Files API for non-Google URIs."
+  );
+  return { fileData: { fileUri: image.url } };
+}
+
 // src/providers/openai.ts
 function isSystem(message) {
   return message.role === "system" || message.role === "developer";
@@ -112,9 +174,14 @@ function userContent(content, reporter) {
   for (const part of content) {
     if (isRecord(part) && part.type === "text" && typeof part.text === "string") {
       blocks.push({ type: "text", text: part.text });
-    } else {
-      reporter.warn("dropped-content", "Dropped a non-text user content part not supported by this converter.");
+      continue;
+    }
+    const image = imageFromOpenAI(part);
+    if (image) {
+      blocks.push(imageToAnthropic(image));
+      continue;
     }
+    reporter.warn("dropped-content", "Dropped an unsupported user content part.");
   }
   return blocks;
 }
@@ -164,7 +231,7 @@ function fromAnthropic(conversation, options = {}) {
     const blocks = asBlocks(message.content);
     if (message.role === "user") {
       const toolResults = blocks.filter((b) => b.type === "tool_result");
-      const textBlocks = blocks.filter((b) => b.type !== "tool_result");
+      const contentBlocks = blocks.filter((b) => b.type !== "tool_result");
       for (const block of toolResults) {
         out.push({
           role: "tool",
@@ -172,8 +239,8 @@ function fromAnthropic(conversation, options = {}) {
           content: textOf(block.content)
         });
       }
-      if (textBlocks.length > 0) {
-        out.push({ role: "user", content: textOf(textBlocks) });
+      if (contentBlocks.length > 0) {
+        out.push({ role: "user", content: userContentToOpenAI(contentBlocks) });
       }
       continue;
     }
@@ -190,6 +257,20 @@ function fromAnthropic(conversation, options = {}) {
   }
   return out;
 }
+function userContentToOpenAI(blocks) {
+  const hasImage = blocks.some((block) => imageFromAnthropic(block) !== null);
+  if (!hasImage) return textOf(blocks);
+  const parts = [];
+  for (const block of blocks) {
+    const image = imageFromAnthropic(block);
+    if (image) {
+      parts.push(imageToOpenAI(image));
+    } else if (isRecord(block) && block.type === "text" && typeof block.text === "string") {
+      parts.push({ type: "text", text: block.text });
+    }
+  }
+  return parts;
+}
 
 // src/providers/gemini.ts
 function toGemini(messages, options = {}) {
@@ -244,9 +325,14 @@ function userParts(content, reporter) {
   for (const part of content) {
     if (isRecord(part) && part.type === "text" && typeof part.text === "string") {
       parts.push({ text: part.text });
-    } else {
-      reporter.warn("dropped-content", "Dropped a non-text user content part not supported by this converter.");
+      continue;
     }
+    const image = imageFromOpenAI(part);
+    if (image) {
+      parts.push(imageToGemini(image, reporter));
+      continue;
+    }
+    reporter.warn("dropped-content", "Dropped an unsupported user content part.");
   }
   return parts.length > 0 ? parts : [{ text: "" }];
 }
@@ -291,7 +377,7 @@ function fromGemini(conversation, options = {}) {
   for (const content of conversation.contents) {
     const parts = Array.isArray(content.parts) ? content.parts : [];
     if (content.role === "model") {
-      const textPieces2 = [];
+      const textPieces = [];
       const toolCalls = [];
       for (const part of parts) {
         if (isRecord(part) && isRecord(part.functionCall)) {
@@ -305,27 +391,42 @@ function fromGemini(conversation, options = {}) {
           });
           pending.push({ id, name: fc.name });
         } else if (isRecord(part) && typeof part.text === "string") {
-          textPieces2.push(part.text);
+          textPieces.push(part.text);
         }
       }
-      const text2 = textPieces2.join("");
-      const assistant = { role: "assistant", content: text2 || null };
+      const text = textPieces.join("");
+      const assistant = { role: "assistant", content: text || null };
       if (toolCalls.length > 0) assistant.tool_calls = toolCalls;
       out.push(assistant);
       continue;
     }
-    const textPieces = [];
+    const contentParts = [];
+    let hasImage = false;
     for (const part of parts) {
       if (isRecord(part) && isRecord(part.functionResponse)) {
         const fr = part.functionResponse;
         const id = resolveResponseId(fr, pending, reporter, generateId);
         out.push({ role: "tool", tool_call_id: id, content: unwrapResponse(fr.response ?? {}) });
-      } else if (isRecord(part) && typeof part.text === "string") {
-        textPieces.push(part.text);
+        continue;
+      }
+      const image = imageFromGemini(part);
+      if (image) {
+        contentParts.push(imageToOpenAI(image));
+        hasImage = true;
+        continue;
+      }
+      if (isRecord(part) && typeof part.text === "string") {
+        contentParts.push({ type: "text", text: part.text });
+      }
+    }
+    if (contentParts.length > 0) {
+      if (hasImage) {
+        out.push({ role: "user", content: contentParts });
+      } else {
+        const text = textOf(contentParts);
+        if (text) out.push({ role: "user", content: text });
       }
     }
-    const text = textPieces.join("");
-    if (text) out.push({ role: "user", content: text });
   }
   return out;
 }
@@ -378,11 +479,130 @@ function fromCanonical(canonical, to, options) {
       throw new Error(`Unknown target provider: ${String(to)}`);
   }
 }
+
+// src/response.ts
+var num = (value) => typeof value === "number" ? value : 0;
+function buildMessage(text, toolCalls) {
+  const message = { role: "assistant", content: text ? text : null };
+  if (toolCalls.length > 0) message.tool_calls = toolCalls;
+  return message;
+}
+function finalReason(mapped, toolCalls) {
+  return toolCalls.length > 0 ? "tool_calls" : mapped;
+}
+var OPENAI_FINISH = {
+  stop: "stop",
+  length: "length",
+  tool_calls: "tool_calls",
+  content_filter: "content_filter",
+  function_call: "tool_calls"
+};
+function responseFromOpenAI(body) {
+  const root = isRecord(body) ? body : {};
+  const choice = Array.isArray(root.choices) && isRecord(root.choices[0]) ? root.choices[0] : {};
+  const message = isRecord(choice.message) ? choice.message : {};
+  const text = typeof message.content === "string" ? message.content : textOf(message.content);
+  const toolCalls = Array.isArray(message.tool_calls) ? message.tool_calls : [];
+  const usage = isRecord(root.usage) ? root.usage : {};
+  return {
+    message: buildMessage(text, toolCalls),
+    finishReason: finalReason(OPENAI_FINISH[String(choice.finish_reason)] ?? "unknown", toolCalls),
+    usage: { inputTokens: num(usage.prompt_tokens), outputTokens: num(usage.completion_tokens) }
+  };
+}
+var ANTHROPIC_FINISH = {
+  end_turn: "stop",
+  stop_sequence: "stop",
+  tool_use: "tool_calls",
+  max_tokens: "length",
+  refusal: "content_filter",
+  pause_turn: "unknown"
+};
+function responseFromAnthropic(body) {
+  const root = isRecord(body) ? body : {};
+  const blocks = Array.isArray(root.content) ? root.content : [];
+  const textPieces = [];
+  const toolCalls = [];
+  for (const block of blocks) {
+    if (!isRecord(block)) continue;
+    if (block.type === "text" && typeof block.text === "string") {
+      textPieces.push(block.text);
+    } else if (block.type === "tool_use" && typeof block.name === "string") {
+      toolCalls.push({
+        id: typeof block.id === "string" ? block.id : "",
+        type: "function",
+        function: { name: block.name, arguments: JSON.stringify(block.input ?? {}) }
+      });
+    }
+  }
+  const usage = isRecord(root.usage) ? root.usage : {};
+  return {
+    message: buildMessage(textPieces.join(""), toolCalls),
+    finishReason: finalReason(ANTHROPIC_FINISH[String(root.stop_reason)] ?? "unknown", toolCalls),
+    usage: { inputTokens: num(usage.input_tokens), outputTokens: num(usage.output_tokens) }
+  };
+}
+var GEMINI_FINISH = {
+  STOP: "stop",
+  MAX_TOKENS: "length",
+  SAFETY: "content_filter",
+  RECITATION: "content_filter",
+  MALFORMED_FUNCTION_CALL: "content_filter"
+};
+function responseFromGemini(body, options = {}) {
+  const reporter = new Reporter(options);
+  const root = isRecord(body) ? body : {};
+  const candidate = Array.isArray(root.candidates) && isRecord(root.candidates[0]) ? root.candidates[0] : {};
+  const content = isRecord(candidate.content) ? candidate.content : {};
+  const parts = Array.isArray(content.parts) ? content.parts : [];
+  const textPieces = [];
+  const toolCalls = [];
+  let counter = 0;
+  for (const part of parts) {
+    if (!isRecord(part)) continue;
+    if (isRecord(part.functionCall)) {
+      const call = part.functionCall;
+      const name = typeof call.name === "string" ? call.name : "function";
+      let id = call.id;
+      if (!id) {
+        id = `call_${name.replace(/[^a-zA-Z0-9_-]/g, "_")}_${counter++}`;
+        reporter.warn("generated-id", `Gemini functionCall '${name}' had no id; generated '${id}'.`);
+      }
+      toolCalls.push({ id, type: "function", function: { name, arguments: JSON.stringify(call.args ?? {}) } });
+    } else if (typeof part.text === "string") {
+      textPieces.push(part.text);
+    }
+  }
+  const usage = isRecord(root.usageMetadata) ? root.usageMetadata : {};
+  return {
+    message: buildMessage(textPieces.join(""), toolCalls),
+    finishReason: finalReason(GEMINI_FINISH[String(candidate.finishReason)] ?? "unknown", toolCalls),
+    usage: { inputTokens: num(usage.promptTokenCount), outputTokens: num(usage.candidatesTokenCount) }
+  };
+}
+function normalizeResponse(body, route, options = {}) {
+  switch (route.from) {
+    case "openai":
+      return responseFromOpenAI(body);
+    case "anthropic":
+      return responseFromAnthropic(body);
+    case "gemini":
+      return responseFromGemini(body, options);
+    default:
+      throw new Error(`Unknown source provider: ${String(route.from)}`);
+  }
+}
 export {
   convert,
   fromAnthropic,
   fromGemini,
+  normalizeResponse,
+  parseDataUrl,
+  responseFromAnthropic,
+  responseFromGemini,
+  responseFromOpenAI,
   toAnthropic,
+  toDataUrl,
   toGemini
 };
 //# sourceMappingURL=index.js.map