@openrouter/sdk 0.3.2 → 0.3.10

package/esm/index.d.ts

@@ -1,6 +1,21 @@
-export * from "./lib/config.js";
-export * as files from "./lib/files.js";
-export { HTTPClient } from "./lib/http.js";
-export type { Fetcher, HTTPClientOptions } from "./lib/http.js";
-export * from "./sdk/sdk.js";
+export type { CallModelInput, FieldOrAsyncFunction, ResolvedCallModelInput, } from './lib/async-params.js';
+export type { Fetcher, HTTPClientOptions } from './lib/http.js';
+export type { ChatStreamEvent, ResponseStreamEvent as EnhancedResponseStreamEvent, InferToolEvent, InferToolEventsUnion, InferToolInput, InferToolOutput, ManualTool, NextTurnParamsContext, NextTurnParamsFunctions, ParsedToolCall, StepResult, StopCondition, StopWhen, Tool, ToolExecutionResult, ToolExecutionResultUnion, ToolPreliminaryResultEvent, ToolStreamEvent, ToolWithExecute, ToolWithGenerator, TurnContext, TypedToolCall, TypedToolCallUnion, Warning, } from './lib/tool-types.js';
+export type { BuildTurnContextOptions } from './lib/turn-context.js';
+export type { ClaudeBase64ImageSource, ClaudeCacheControl, ClaudeCitationCharLocation, ClaudeCitationContentBlockLocation, ClaudeCitationPageLocation, ClaudeCitationSearchResultLocation, ClaudeCitationWebSearchResultLocation, ClaudeContentBlock, ClaudeContentBlockParam, ClaudeImageBlockParam, ClaudeMessage, ClaudeMessageParam, ClaudeRedactedThinkingBlock, ClaudeServerToolUseBlock, ClaudeStopReason, ClaudeTextBlock, ClaudeTextBlockParam, ClaudeTextCitation, ClaudeThinkingBlock, ClaudeToolResultBlockParam, ClaudeToolUseBlock, ClaudeToolUseBlockParam, ClaudeURLImageSource, ClaudeUsage, } from './models/claude-message.js';
+export { fromClaudeMessages, toClaudeMessage } from './lib/anthropic-compat.js';
+export { hasAsyncFunctions, resolveAsyncFunctions, } from './lib/async-params.js';
+export { fromChatMessages, toChatMessage } from './lib/chat-compat.js';
+export { ClaudeContentBlockType, NonClaudeMessageRole } from './lib/claude-constants.js';
+export { isClaudeStyleMessages } from './lib/claude-type-guards.js';
+export * from './lib/config.js';
+export * as files from './lib/files.js';
+export { HTTPClient } from './lib/http.js';
+export { applyNextTurnParamsToRequest, buildNextTurnParamsContext, executeNextTurnParamsFunctions, } from './lib/next-turn-params.js';
+export { finishReasonIs, hasToolCall, isStopConditionMet, maxCost, maxTokensUsed, stepCountIs, } from './lib/stop-conditions.js';
+export { extractUnsupportedContent, getUnsupportedContentSummary, hasUnsupportedContent, } from './lib/stream-transformers.js';
+export { tool } from './lib/tool.js';
+export { hasExecuteFunction, isGeneratorTool, isRegularExecuteTool, isToolPreliminaryResultEvent, ToolType, } from './lib/tool-types.js';
+export { buildTurnContext, normalizeInputToArray } from './lib/turn-context.js';
+export * from './sdk/sdk.js';
 //# sourceMappingURL=index.d.ts.map

package/esm/index.js

@@ -1,8 +1,25 @@
 /*
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
-export * from "./lib/config.js";
-export * as files from "./lib/files.js";
-export { HTTPClient } from "./lib/http.js";
-export * from "./sdk/sdk.js";
+// Message format compatibility helpers
+export { fromClaudeMessages, toClaudeMessage } from './lib/anthropic-compat.js';
+export { hasAsyncFunctions, resolveAsyncFunctions, } from './lib/async-params.js';
+export { fromChatMessages, toChatMessage } from './lib/chat-compat.js';
+// Claude constants and type guards
+export { ClaudeContentBlockType, NonClaudeMessageRole } from './lib/claude-constants.js';
+export { isClaudeStyleMessages } from './lib/claude-type-guards.js';
+export * from './lib/config.js';
+export * as files from './lib/files.js';
+export { HTTPClient } from './lib/http.js';
+// Next turn params helpers
+export { applyNextTurnParamsToRequest, buildNextTurnParamsContext, executeNextTurnParamsFunctions, } from './lib/next-turn-params.js';
+// Stop condition helpers
+export { finishReasonIs, hasToolCall, isStopConditionMet, maxCost, maxTokensUsed, stepCountIs, } from './lib/stop-conditions.js';
+export { extractUnsupportedContent, getUnsupportedContentSummary, hasUnsupportedContent, } from './lib/stream-transformers.js';
+// Tool creation helpers
+export { tool } from './lib/tool.js';
+export { hasExecuteFunction, isGeneratorTool, isRegularExecuteTool, isToolPreliminaryResultEvent, ToolType, } from './lib/tool-types.js';
+// Turn context helpers
+export { buildTurnContext, normalizeInputToArray } from './lib/turn-context.js';
+export * from './sdk/sdk.js';
 //# sourceMappingURL=index.js.map

package/esm/lib/anthropic-compat.d.ts

@@ -0,0 +1,50 @@
+import type * as models from '../models/index.js';
+import { convertToClaudeMessage } from './stream-transformers.js';
+/**
+ * Convert Anthropic Claude-style messages to OpenResponses input format.
+ *
+ * This function transforms ClaudeMessageParam[] (Anthropic SDK format) to
+ * OpenResponsesInput format that can be passed directly to callModel().
+ *
+ * Note: Some Claude features are lost in conversion as OpenRouter doesn't support them:
+ * - cache_control on content blocks
+ * - is_error flag on tool_result blocks
+ *
+ * @example
+ * ```typescript
+ * import { fromClaudeMessages } from '@openrouter/sdk';
+ *
+ * const claudeMessages = [
+ *   { role: "user", content: "Hello!" },
+ *   { role: "assistant", content: "Hi there!" },
+ * ];
+ *
+ * const response = openrouter.callModel({
+ *   model: "anthropic/claude-3-sonnet",
+ *   input: fromClaudeMessages(claudeMessages),
+ * });
+ * ```
+ */
+export declare function fromClaudeMessages(messages: models.ClaudeMessageParam[]): models.OpenResponsesInput;
+/**
+ * Convert an OpenResponses response to Anthropic Claude message format.
+ *
+ * This function transforms OpenResponsesNonStreamingResponse to ClaudeMessage
+ * (Anthropic SDK format) for compatibility with code expecting Claude responses.
+ *
+ * @example
+ * ```typescript
+ * import { toClaudeMessage } from '@openrouter/sdk';
+ *
+ * const response = await openrouter.callModel({
+ *   model: "anthropic/claude-3-sonnet",
+ *   input: "Hello!",
+ * });
+ *
+ * const openResponsesResult = await response.getResponse();
+ * const claudeMessage = toClaudeMessage(openResponsesResult);
+ * // claudeMessage is now compatible with Anthropic SDK types
+ * ```
+ */
+export declare const toClaudeMessage: typeof convertToClaudeMessage;
+//# sourceMappingURL=anthropic-compat.d.ts.map

package/esm/lib/anthropic-compat.js

@@ -0,0 +1,223 @@
+import { OpenResponsesEasyInputMessageRoleAssistant, OpenResponsesEasyInputMessageRoleUser, } from '../models/openresponseseasyinputmessage.js';
+import { OpenResponsesFunctionCallOutputType } from '../models/openresponsesfunctioncalloutput.js';
+import { OpenResponsesInputMessageItemRoleUser, OpenResponsesInputMessageItemRoleDeveloper } from '../models/openresponsesinputmessageitem.js';
+import { convertToClaudeMessage } from './stream-transformers.js';
+/**
+ * Maps Claude role strings to OpenResponses role types
+ */
+function mapClaudeRole(role) {
+    if (role === 'user') {
+        return OpenResponsesEasyInputMessageRoleUser.User;
+    }
+    return OpenResponsesEasyInputMessageRoleAssistant.Assistant;
+}
+/**
+ * Creates a properly typed OpenResponsesEasyInputMessage
+ */
+function createEasyInputMessage(role, content) {
+    return {
+        role: mapClaudeRole(role),
+        content,
+    };
+}
+/**
+ * Creates a properly typed OpenResponsesFunctionCallOutput
+ */
+function createFunctionCallOutput(callId, output) {
+    return {
+        type: OpenResponsesFunctionCallOutputType.FunctionCallOutput,
+        callId,
+        output,
+    };
+}
+/**
+ * Convert Anthropic Claude-style messages to OpenResponses input format.
+ *
+ * This function transforms ClaudeMessageParam[] (Anthropic SDK format) to
+ * OpenResponsesInput format that can be passed directly to callModel().
+ *
+ * Note: Some Claude features are lost in conversion as OpenRouter doesn't support them:
+ * - cache_control on content blocks
+ * - is_error flag on tool_result blocks
+ *
+ * @example
+ * ```typescript
+ * import { fromClaudeMessages } from '@openrouter/sdk';
+ *
+ * const claudeMessages = [
+ *   { role: "user", content: "Hello!" },
+ *   { role: "assistant", content: "Hi there!" },
+ * ];
+ *
+ * const response = openrouter.callModel({
+ *   model: "anthropic/claude-3-sonnet",
+ *   input: fromClaudeMessages(claudeMessages),
+ * });
+ * ```
+ */
+export function fromClaudeMessages(messages) {
+    const result = [];
+    for (const msg of messages) {
+        const { role, content } = msg;
+        if (typeof content === 'string') {
+            result.push(createEasyInputMessage(role, content));
+            continue;
+        }
+        // Separate content blocks into categories for clearer processing
+        const textBlocks = [];
+        const imageBlocks = [];
+        const toolUseBlocks = [];
+        const toolResultBlocks = [];
+        for (const block of content) {
+            switch (block.type) {
+                case 'text':
+                    textBlocks.push(block);
+                    break;
+                case 'image':
+                    imageBlocks.push(block);
+                    break;
+                case 'tool_use':
+                    toolUseBlocks.push(block);
+                    break;
+                case 'tool_result':
+                    toolResultBlocks.push(block);
+                    break;
+                default: {
+                    // Exhaustiveness check - TypeScript will error if we don't handle all block types
+                    const exhaustiveCheck = block;
+                    throw new Error(`Unhandled content block type: ${JSON.stringify(exhaustiveCheck)}`);
+                }
+            }
+        }
+        // Process tool use blocks first (they go directly to result)
+        for (const toolUseBlock of toolUseBlocks) {
+            result.push({
+                type: 'function_call',
+                callId: toolUseBlock.id,
+                name: toolUseBlock.name,
+                arguments: JSON.stringify(toolUseBlock.input),
+                id: toolUseBlock.id,
+                status: 'completed',
+            });
+        }
+        // Process tool result blocks
+        for (const toolResultBlock of toolResultBlocks) {
+            let toolOutput = '';
+            if (typeof toolResultBlock.content === 'string') {
+                toolOutput = toolResultBlock.content;
+            }
+            else {
+                // Extract text and handle images separately
+                const textParts = [];
+                const imageParts = [];
+                for (const part of toolResultBlock.content) {
+                    if (part.type === 'text') {
+                        textParts.push(part.text);
+                    }
+                    else if (part.type === 'image') {
+                        imageParts.push(part);
+                    }
+                }
+                toolOutput = textParts.join('');
+                // Map images to image_generation_call items
+                imageParts.forEach((imagePart, i) => {
+                    let imageUrl;
+                    if (imagePart.source.type === 'url') {
+                        imageUrl = imagePart.source.url;
+                    }
+                    else if (imagePart.source.type === 'base64') {
+                        imageUrl = `data:${imagePart.source.media_type};base64,${imagePart.source.data}`;
+                    }
+                    else {
+                        const exhaustiveCheck = imagePart.source;
+                        throw new Error(`Unhandled image source type: ${exhaustiveCheck}`);
+                    }
+                    result.push({
+                        type: 'image_generation_call',
+                        id: `${toolResultBlock.tool_use_id}-image-${i}`,
+                        result: imageUrl,
+                        status: 'completed',
+                    });
+                });
+            }
+            // Add the function call output for the text portion (if any)
+            if (toolOutput.length > 0) {
+                result.push(createFunctionCallOutput(toolResultBlock.tool_use_id, toolOutput));
+            }
+        }
+        // Process text and image blocks (these become message content)
+        if (textBlocks.length > 0 || imageBlocks.length > 0) {
+            const contentItems = [];
+            // Add text blocks
+            for (const textBlock of textBlocks) {
+                contentItems.push({
+                    type: 'input_text',
+                    text: textBlock.text,
+                });
+            }
+            // Add image blocks
+            for (const imageBlock of imageBlocks) {
+                let imageUrl;
+                if (imageBlock.source.type === 'url') {
+                    imageUrl = imageBlock.source.url;
+                }
+                else if (imageBlock.source.type === 'base64') {
+                    imageUrl = `data:${imageBlock.source.media_type};base64,${imageBlock.source.data}`;
+                }
+                else {
+                    const exhaustiveCheck = imageBlock.source;
+                    throw new Error(`Unhandled image source type: ${exhaustiveCheck}`);
+                }
+                contentItems.push({
+                    type: 'input_image',
+                    detail: 'auto',
+                    imageUrl,
+                });
+            }
+            // Determine output format based on content
+            if (imageBlocks.length > 0) {
+                // Use structured format for messages with images
+                result.push({
+                    type: 'message',
+                    role: role === 'user'
+                        ? OpenResponsesInputMessageItemRoleUser.User
+                        : OpenResponsesInputMessageItemRoleDeveloper.Developer,
+                    content: contentItems,
+                });
+            }
+            else {
+                // Use simple string format for text-only messages
+                const textContent = contentItems
+                    .filter((item) => item.type === 'input_text')
+                    .map((item) => item.text)
+                    .join('');
+                if (textContent.length > 0) {
+                    result.push(createEasyInputMessage(role, textContent));
+                }
+            }
+        }
+    }
+    return result;
+}
+/**
+ * Convert an OpenResponses response to Anthropic Claude message format.
+ *
+ * This function transforms OpenResponsesNonStreamingResponse to ClaudeMessage
+ * (Anthropic SDK format) for compatibility with code expecting Claude responses.
+ *
+ * @example
+ * ```typescript
+ * import { toClaudeMessage } from '@openrouter/sdk';
+ *
+ * const response = await openrouter.callModel({
+ *   model: "anthropic/claude-3-sonnet",
+ *   input: "Hello!",
+ * });
+ *
+ * const openResponsesResult = await response.getResponse();
+ * const claudeMessage = toClaudeMessage(openResponsesResult);
+ * // claudeMessage is now compatible with Anthropic SDK types
+ * ```
+ */
+export const toClaudeMessage = convertToClaudeMessage;
+//# sourceMappingURL=anthropic-compat.js.map

package/esm/lib/anthropic-compat.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=anthropic-compat.test.d.ts.map