@openrouter/sdk 0.3.1 → 0.3.7

package/esm/lib/stream-transformers.js

@@ -40,6 +40,66 @@ export async function* extractToolDeltas(stream) {
         }
     }
 }
+/**
+ * Build incremental message updates from responses stream events
+ * Returns ResponsesOutputMessage (assistant/responses format)
+ */
+export async function* buildResponsesMessageStream(stream) {
+    const consumer = stream.createConsumer();
+    // Track the accumulated text and message info
+    let currentText = '';
+    let currentId = '';
+    let hasStarted = false;
+    for await (const event of consumer) {
+        if (!('type' in event)) {
+            continue;
+        }
+        switch (event.type) {
+            case 'response.output_item.added': {
+                const itemEvent = event;
+                if (itemEvent.item && 'type' in itemEvent.item && itemEvent.item.type === 'message') {
+                    hasStarted = true;
+                    currentText = '';
+                    const msgItem = itemEvent.item;
+                    currentId = msgItem.id;
+                }
+                break;
+            }
+            case 'response.output_text.delta': {
+                const deltaEvent = event;
+                if (hasStarted && deltaEvent.delta) {
+                    currentText += deltaEvent.delta;
+                    // Yield updated message in ResponsesOutputMessage format
+                    yield {
+                        id: currentId,
+                        type: 'message',
+                        role: 'assistant',
+                        status: 'in_progress',
+                        content: [
+                            {
+                                type: 'output_text',
+                                text: currentText,
+                                annotations: [],
+                            },
+                        ],
+                    };
+                }
+                break;
+            }
+            case 'response.output_item.done': {
+                const itemDoneEvent = event;
+                if (itemDoneEvent.item &&
+                    'type' in itemDoneEvent.item &&
+                    itemDoneEvent.item.type === 'message') {
+                    // Yield final complete message in ResponsesOutputMessage format
+                    const outputMessage = itemDoneEvent.item;
+                    yield outputMessage;
+                }
+                break;
+            }
+        }
+    }
+}
 /**
  * Build incremental message updates from responses stream events
  * Returns AssistantMessage (chat format) instead of ResponsesOutputMessage
@@ -129,7 +189,7 @@ function convertToAssistantMessage(outputMessage) {
     };
 }
 /**
- * Extract the first message from a completed response
+ * Extract the first message from a completed response (chat format)
  */
 export function extractMessageFromResponse(response) {
     const messageItem = response.output.find((item) => 'type' in item && item.type === 'message');
@@ -138,6 +198,16 @@ export function extractMessageFromResponse(response) {
     }
     return convertToAssistantMessage(messageItem);
 }
+/**
+ * Extract the first message from a completed response (responses format)
+ */
+export function extractResponsesMessageFromResponse(response) {
+    const messageItem = response.output.find((item) => 'type' in item && item.type === 'message');
+    if (!messageItem) {
+        throw new Error('No message found in response output');
+    }
+    return messageItem;
+}
 /**
  * Extract text from a response, either from outputText or by concatenating message content
  */
@@ -279,4 +349,252 @@ export async function* buildToolCallStream(stream) {
 export function responseHasToolCalls(response) {
     return response.output.some((item) => 'type' in item && item.type === 'function_call');
 }
+/**
+ * Convert OpenRouter annotations to Claude citations
+ */
+function mapAnnotationsToCitations(annotations) {
+    if (!annotations || annotations.length === 0) {
+        return undefined;
+    }
+    const citations = [];
+    for (const annotation of annotations) {
+        if (!('type' in annotation)) {
+            continue;
+        }
+        switch (annotation.type) {
+            case 'file_citation': {
+                const fileCite = annotation;
+                citations.push({
+                    type: 'char_location',
+                    cited_text: '',
+                    document_index: fileCite.index,
+                    document_title: fileCite.filename,
+                    file_id: fileCite.fileId,
+                    start_char_index: 0,
+                    end_char_index: 0,
+                });
+                break;
+            }
+            case 'url_citation': {
+                const urlCite = annotation;
+                citations.push({
+                    type: 'web_search_result_location',
+                    cited_text: '',
+                    title: urlCite.title,
+                    url: urlCite.url,
+                    encrypted_index: '',
+                });
+                break;
+            }
+            case 'file_path': {
+                const pathCite = annotation;
+                citations.push({
+                    type: 'char_location',
+                    cited_text: '',
+                    document_index: pathCite.index,
+                    document_title: '',
+                    file_id: pathCite.fileId,
+                    start_char_index: 0,
+                    end_char_index: 0,
+                });
+                break;
+            }
+            default: {
+                const _exhaustiveCheck = annotation;
+                throw new Error(`Unhandled annotation type: ${_exhaustiveCheck.type}`);
+            }
+        }
+    }
+    return citations.length > 0 ? citations : undefined;
+}
+/**
+ * Map OpenResponses status to Claude stop reason
+ */
+function mapStopReason(response) {
+    // Check if any tool calls exist in the response
+    const hasToolCalls = response.output.some((item) => 'type' in item && item.type === 'function_call');
+    if (hasToolCalls) {
+        return 'tool_use';
+    }
+    // Check the response status
+    if (response.status === 'completed') {
+        return 'end_turn';
+    }
+    if (response.status === 'incomplete') {
+        // Check incomplete reason if available
+        const incompleteReason = response.incompleteDetails?.reason;
+        if (incompleteReason === 'max_output_tokens') {
+            return 'max_tokens';
+        }
+        return 'end_turn';
+    }
+    return 'end_turn';
+}
+/**
+ * Convert OpenResponsesNonStreamingResponse to ClaudeMessage format
+ * Compatible with the Anthropic SDK BetaMessage type
+ */
+export function convertToClaudeMessage(response) {
+    const content = [];
+    const unsupportedContent = [];
+    for (const item of response.output) {
+        if (!('type' in item)) {
+            continue;
+        }
+        switch (item.type) {
+            case 'message': {
+                const msgItem = item;
+                for (const part of msgItem.content) {
+                    if (!('type' in part)) {
+                        continue;
+                    }
+                    if (part.type === 'output_text') {
+                        const textPart = part;
+                        const citations = mapAnnotationsToCitations(textPart.annotations);
+                        content.push({
+                            type: 'text',
+                            text: textPart.text,
+                            ...(citations && { citations }),
+                        });
+                    }
+                    else if (part.type === 'refusal') {
+                        const refusalPart = part;
+                        unsupportedContent.push({
+                            original_type: 'refusal',
+                            data: { refusal: refusalPart.refusal },
+                            reason: 'Claude does not have a native refusal content type',
+                        });
+                    }
+                }
+                break;
+            }
+            case 'function_call': {
+                const fnCall = item;
+                let parsedInput = {};
+                try {
+                    parsedInput = JSON.parse(fnCall.arguments);
+                }
+                catch {
+                    parsedInput = {};
+                }
+                content.push({
+                    type: 'tool_use',
+                    id: fnCall.callId,
+                    name: fnCall.name,
+                    input: parsedInput,
+                });
+                break;
+            }
+            case 'reasoning': {
+                const reasoningItem = item;
+                if (reasoningItem.summary && reasoningItem.summary.length > 0) {
+                    for (const summaryItem of reasoningItem.summary) {
+                        if (summaryItem.type === 'summary_text' && summaryItem.text) {
+                            content.push({
+                                type: 'thinking',
+                                thinking: summaryItem.text,
+                                signature: '',
+                            });
+                        }
+                    }
+                }
+                if (reasoningItem.encryptedContent) {
+                    unsupportedContent.push({
+                        original_type: 'reasoning_encrypted',
+                        data: {
+                            id: reasoningItem.id,
+                            encrypted_content: reasoningItem.encryptedContent,
+                        },
+                        reason: 'Encrypted reasoning content preserved for round-trip',
+                    });
+                }
+                break;
+            }
+            case 'web_search_call': {
+                const webSearchItem = item;
+                content.push({
+                    type: 'server_tool_use',
+                    id: webSearchItem.id,
+                    name: 'web_search',
+                    input: { status: webSearchItem.status },
+                });
+                break;
+            }
+            case 'file_search_call': {
+                const fileSearchItem = item;
+                content.push({
+                    type: 'tool_use',
+                    id: fileSearchItem.id,
+                    name: 'file_search',
+                    input: {
+                        queries: fileSearchItem.queries,
+                        status: fileSearchItem.status,
+                    },
+                });
+                break;
+            }
+            case 'image_generation_call': {
+                const imageGenItem = item;
+                unsupportedContent.push({
+                    original_type: 'image_generation_call',
+                    data: {
+                        id: imageGenItem.id,
+                        result: imageGenItem.result,
+                        status: imageGenItem.status,
+                    },
+                    reason: 'Claude does not support image outputs in assistant messages',
+                });
+                break;
+            }
+            default: {
+                const _exhaustiveCheck = item;
+                throw new Error(`Unhandled output item type: ${_exhaustiveCheck.type}`);
+            }
+        }
+    }
+    return {
+        id: response.id,
+        type: 'message',
+        role: 'assistant',
+        model: response.model ?? 'unknown',
+        content,
+        stop_reason: mapStopReason(response),
+        stop_sequence: null,
+        usage: {
+            input_tokens: response.usage?.inputTokens ?? 0,
+            output_tokens: response.usage?.outputTokens ?? 0,
+            cache_creation_input_tokens: response.usage?.inputTokensDetails?.cachedTokens ?? 0,
+            cache_read_input_tokens: 0,
+        },
+        ...(unsupportedContent.length > 0 && { unsupported_content: unsupportedContent }),
+    };
+}
+/**
+ * Extract unsupported content by original type
+ */
+export function extractUnsupportedContent(message, originalType) {
+    if (!message.unsupported_content) {
+        return [];
+    }
+    return message.unsupported_content.filter(item => item.original_type === originalType);
+}
+/**
+ * Check if message has any unsupported content
+ */
+export function hasUnsupportedContent(message) {
+    return !!(message.unsupported_content && message.unsupported_content.length > 0);
+}
+/**
+ * Get summary of unsupported content types
+ */
+export function getUnsupportedContentSummary(message) {
+    if (!message.unsupported_content) {
+        return {};
+    }
+    const summary = {};
+    for (const item of message.unsupported_content) {
+        summary[item.original_type] = (summary[item.original_type] || 0) + 1;
+    }
+    return summary;
+}
 //# sourceMappingURL=stream-transformers.js.map

package/esm/lib/tool-types.d.ts

@@ -1,7 +1,7 @@
 import type { ZodObject, ZodRawShape, ZodType, z } from 'zod/v4';
 import type * as models from '../models/index.js';
 import type { OpenResponsesStreamEvent } from '../models/index.js';
-import type { ResponseWrapper } from './response-wrapper.js';
+import type { ModelResult } from './model-result.js';
 /**
  * Tool type enum for enhanced tools
  */
@@ -129,8 +129,8 @@ export type MaxToolRounds = number | ((context: TurnContext) => boolean);
  * Result of executeTools operation
  */
 export interface ExecuteToolsResult {
-    finalResponse: ResponseWrapper;
-    allResponses: ResponseWrapper[];
+    finalResponse: ModelResult;
+    allResponses: ModelResult[];
     toolResults: Map<string, {
         result: unknown;
         preliminaryResults?: unknown[];

package/esm/lib/url.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b0057e24ed76
  */
 const hasOwn = Object.prototype.hasOwnProperty;
 export function pathToFunc(pathPattern, options) {

package/esm/models/activityitem.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ee2d86453873
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/assistantmessage.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2147a953e992
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/badgatewayresponseerrordata.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: de317517c298
  */
 import * as z from "zod/v4";
 import { safeParse } from "../lib/schemas.js";

package/esm/models/badrequestresponseerrordata.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 42d173ee6203
  */
 import * as z from "zod/v4";
 import { safeParse } from "../lib/schemas.js";

package/esm/models/chatcompletionfinishreason.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6b06a4d1562d
  */
 import * as openEnums from "../types/enums.js";
 export const ChatCompletionFinishReason = {

package/esm/models/chaterror.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b107ec938dc1
  */
 import * as z from "zod/v4";
 import { safeParse } from "../lib/schemas.js";

package/esm/models/chatgenerationparams.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f98a2a558f3f
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatgenerationtokenusage.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 1d57b0d238b8
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatmessagecontentitem.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: bb7f6b29b93f
  */
 import * as z from "zod/v4";
 import { safeParse } from "../lib/schemas.js";

package/esm/models/chatmessagecontentitemaudio.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 49b1cafcb338
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatmessagecontentitemcachecontrol.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b5c18e04e19c
  */
 import * as z from "zod/v4";
 import { safeParse } from "../lib/schemas.js";

package/esm/models/chatmessagecontentitemimage.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3989cdc41817
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatmessagecontentitemtext.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 27089860fd98
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatmessagecontentitemvideo.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 5a81301cb4a7
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatmessagetokenlogprob.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: eed686a58eb1
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatmessagetokenlogprobs.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 2dbd9fc61ed8
  */
 import * as z from "zod/v4";
 import { safeParse } from "../lib/schemas.js";

package/esm/models/chatmessagetoolcall.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b294b44052da
  */
 import * as z from "zod/v4";
 import { safeParse } from "../lib/schemas.js";

package/esm/models/chatresponse.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 76c3703fa3d5
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatresponsechoice.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7db13c3cc866
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatstreamingchoice.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 15346f0b1bc4
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatstreamingmessagechunk.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 339ee7e4b920
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatstreamingmessagetoolcall.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 74ba154581ba
  */
 import * as z from "zod/v4";
 import { safeParse } from "../lib/schemas.js";

package/esm/models/chatstreamingresponsechunk.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 00bf2ea52439
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";

package/esm/models/chatstreamoptions.js

@@ -1,5 +1,6 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 83ba1c3db4bb
  */
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";