@qduc/term2 0.1.0

package/dist/providers/openai.provider.js

@@ -0,0 +1,36 @@
+import { registerProvider } from './registry.js';
+const OPENAI_MODELS_URL = 'https://api.openai.com/v1/models';
+async function fetchOpenAIModels(_deps, fetchImpl = fetch) {
+    const headers = {
+        'Content-Type': 'application/json',
+    };
+    const apiKey = process.env.OPENAI_API_KEY;
+    if (apiKey) {
+        headers.Authorization = `Bearer ${apiKey}`;
+    }
+    const response = await fetchImpl(OPENAI_MODELS_URL, { headers });
+    if (!response.ok) {
+        throw new Error(`OpenAI models request failed (${response.status})`);
+    }
+    const body = await response.json();
+    const raw = body?.data || [];
+    if (!Array.isArray(raw))
+        return [];
+    return raw
+        .map((item) => {
+        const id = item?.id || item?.model || '';
+        const name = item?.name || item?.display_name || item?.description;
+        return id ? { id, name } : null;
+    })
+        .filter(Boolean);
+}
+// Register OpenAI provider
+registerProvider({
+    id: 'openai',
+    label: 'OpenAI',
+    createRunner: undefined, // Use SDK default
+    fetchModels: fetchOpenAIModels,
+    clearConversations: undefined, // No conversation state to clear
+    sensitiveSettingKeys: [],
+});
+//# sourceMappingURL=openai.provider.js.map

package/dist/providers/openai.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.provider.js","sourceRoot":"","sources":["../../source/providers/openai.provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gBAAgB,EAAC,MAAM,eAAe,CAAC;AAE/C,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAE7D,KAAK,UAAU,iBAAiB,CAC5B,KAAkD,EAClD,YAA0D,KAAY;IAEtE,MAAM,OAAO,GAA2B;QACpC,cAAc,EAAE,kBAAkB;KACrC,CAAC;IACF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAC1C,IAAI,MAAM,EAAE,CAAC;QACT,OAAO,CAAC,aAAa,GAAG,UAAU,MAAM,EAAE,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,iBAAiB,EAAE,EAAC,OAAO,EAAC,CAAC,CAAC;IAC/D,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;IAE7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,OAAO,GAAG;SACL,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE;QACf,MAAM,EAAE,GAAG,IAAI,EAAE,EAAE,IAAI,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,YAAY,IAAI,IAAI,EAAE,WAAW,CAAC;QACnE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAC,EAAE,EAAE,IAAI,EAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAClC,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAuC,CAAC;AAC/D,CAAC;AAED,2BAA2B;AAC3B,gBAAgB,CAAC;IACb,EAAE,EAAE,QAAQ;IACZ,KAAK,EAAE,QAAQ;IACf,YAAY,EAAE,SAAS,EAAE,kBAAkB;IAC3C,WAAW,EAAE,iBAAiB;IAC9B,kBAAkB,EAAE,SAAS,EAAE,iCAAiC;IAChE,oBAAoB,EAAE,EAAE;CAC3B,CAAC,CAAC"}

package/dist/providers/openrouter/api.d.ts

@@ -0,0 +1,39 @@
+import type { ISettingsService } from '../../services/service-interfaces.js';
+type FetchImpl = (url: string, init?: RequestInit) => Promise<Response>;
+type SleepImpl = (ms: number, signal?: AbortSignal) => Promise<void>;
+export type OpenRouterRetryOptions = {
+    /**
+     * Number of retries after the initial attempt.
+     * Example: maxRetries=2 => up to 3 total attempts.
+     */
+    maxRetries?: number;
+    /** Base delay for exponential backoff (ms). */
+    baseDelayMs?: number;
+    /** Max delay cap (ms). */
+    maxDelayMs?: number;
+    /**
+     * Jitter factor. 1 = full jitter (random 0..delay), 0 = no jitter (exact delay).
+     */
+    jitter?: number;
+};
+export declare class OpenRouterError extends Error {
+    status: number;
+    headers: Record<string, string>;
+    responseBody?: string;
+    constructor(message: string, status: number, headers: Record<string, string>, responseBody?: string);
+}
+export declare function callOpenRouter({ apiKey, model, messages, stream, signal, settings, tools, settingsService, fetchImpl, sleepImpl, retry, }: {
+    apiKey: string;
+    model: string;
+    messages: any[];
+    stream: boolean;
+    signal?: AbortSignal;
+    settings?: any;
+    tools?: any[];
+    settingsService: ISettingsService;
+    fetchImpl?: FetchImpl;
+    sleepImpl?: SleepImpl;
+    retry?: OpenRouterRetryOptions;
+}): Promise<Response>;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/dist/providers/openrouter/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../source/providers/openrouter/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,gBAAgB,EAAC,MAAM,sCAAsC,CAAC;AAI3E,KAAK,SAAS,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AACxE,KAAK,SAAS,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAErE,MAAM,MAAM,sBAAsB,GAAG;IACjC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAiFF,qBAAa,eAAgB,SAAQ,KAAK;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;gBAGlB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,YAAY,CAAC,EAAE,MAAM;CAQ5B;AAED,wBAAsB,cAAc,CAAC,EACjC,MAAM,EACN,KAAK,EACL,QAAQ,EACR,MAAM,EACN,MAAM,EACN,QAAQ,EACR,KAAK,EACL,eAAe,EACf,SAAS,EACT,SAAS,EACT,KAAK,GACR,EAAE;IACC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,GAAG,EAAE,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,CAAC;IACf,KAAK,CAAC,EAAE,GAAG,EAAE,CAAC;IACd,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,sBAAsB,CAAC;CAClC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqHpB"}

package/dist/providers/openrouter/api.js

@@ -0,0 +1,172 @@
+import { getOpenRouterBaseUrl } from './utils.js';
+import { extractModelSettingsForRequest } from './converters.js';
+function isAbortError(err) {
+    return ((err instanceof DOMException && err.name === 'AbortError') ||
+        (typeof err === 'object' &&
+            err !== null &&
+            err.name === 'AbortError'));
+}
+function defaultSleep(ms, signal) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve, reject) => {
+        const id = setTimeout(() => {
+            cleanup();
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            cleanup();
+            clearTimeout(id);
+            reject(new DOMException('Aborted', 'AbortError'));
+        };
+        const cleanup = () => {
+            signal?.removeEventListener('abort', onAbort);
+        };
+        if (signal) {
+            if (signal.aborted) {
+                onAbort();
+                return;
+            }
+            signal.addEventListener('abort', onAbort);
+        }
+    });
+}
+function parseRetryAfterToMs(value) {
+    if (!value)
+        return undefined;
+    // Retry-After can be seconds or an HTTP date.
+    const asSeconds = Number.parseInt(value, 10);
+    if (Number.isFinite(asSeconds)) {
+        return Math.max(0, asSeconds) * 1000;
+    }
+    const asDate = Date.parse(value);
+    if (!Number.isNaN(asDate)) {
+        return Math.max(0, asDate - Date.now());
+    }
+    return undefined;
+}
+function isRetryableStatus(status) {
+    // 408 can occur for upstream timeouts; treat as transient.
+    return status === 429 || status === 408 || status >= 500;
+}
+function computeRetryDelayMs(opts) {
+    if (typeof opts.retryAfterMs === 'number' && opts.retryAfterMs >= 0) {
+        return opts.retryAfterMs;
+    }
+    const exponential = opts.baseDelayMs * Math.pow(2, opts.attemptIndex);
+    const capped = Math.min(exponential, opts.maxDelayMs);
+    if (opts.jitter > 0) {
+        return Math.random() * capped;
+    }
+    return capped;
+}
+export class OpenRouterError extends Error {
+    status;
+    headers;
+    responseBody;
+    constructor(message, status, headers, responseBody) {
+        super(message);
+        this.name = 'OpenRouterError';
+        this.status = status;
+        this.headers = headers;
+        this.responseBody = responseBody;
+    }
+}
+export async function callOpenRouter({ apiKey, model, messages, stream, signal, settings, tools, settingsService, fetchImpl, sleepImpl, retry, }) {
+    const url = `${getOpenRouterBaseUrl(settingsService)}/chat/completions`;
+    const body = {
+        model,
+        messages,
+        stream,
+    };
+    // Merge settings into request body
+    const settingsParams = extractModelSettingsForRequest(settings);
+    Object.assign(body, settingsParams);
+    // Add tools if provided
+    const functionTools = tools ?? [];
+    body.tools = functionTools;
+    if (functionTools.length > 0) {
+        body.tool_choice = 'auto'; // Let model choose when to use tools
+    }
+    const effectiveFetch = fetchImpl ?? fetch;
+    const effectiveSleep = sleepImpl ?? defaultSleep;
+    const retryCfg = {
+        maxRetries: retry?.maxRetries ?? 2,
+        baseDelayMs: retry?.baseDelayMs ?? 500,
+        maxDelayMs: retry?.maxDelayMs ?? 30000,
+        jitter: retry?.jitter ?? 1,
+    };
+    let attemptIndex = 0;
+    // attemptIndex tracks the retry attempt number (0 for first retry).
+    // We allow up to maxRetries retries after the initial attempt.
+    while (true) {
+        if (signal?.aborted) {
+            throw new DOMException('Aborted', 'AbortError');
+        }
+        try {
+            const res = await effectiveFetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    Authorization: `Bearer ${apiKey}`,
+                    'HTTP-Referer': settingsService.get('agent.openrouter.referrer') ||
+                        'http://localhost',
+                    'X-Title': settingsService.get('agent.openrouter.title') ||
+                        'term2',
+                },
+                body: JSON.stringify(body),
+                signal,
+            });
+            if (res.ok)
+                return res;
+            let errText;
+            try {
+                errText = await res.text();
+            }
+            catch { }
+            // Extract headers for retry logic (especially Retry-After)
+            const headers = {};
+            res.headers.forEach((value, key) => {
+                headers[key.toLowerCase()] = value;
+            });
+            const message = `OpenRouter request failed: ${res.status} ${res.statusText}${errText ? ` - ${errText}` : ''}`;
+            const error = new OpenRouterError(message, res.status, headers, errText);
+            const canRetry = retryCfg.maxRetries > 0 &&
+                isRetryableStatus(res.status) &&
+                attemptIndex < retryCfg.maxRetries;
+            if (!canRetry)
+                throw error;
+            const retryAfterMs = parseRetryAfterToMs(headers['retry-after']);
+            const delayMs = computeRetryDelayMs({
+                attemptIndex,
+                retryAfterMs,
+                baseDelayMs: retryCfg.baseDelayMs,
+                maxDelayMs: retryCfg.maxDelayMs,
+                jitter: retryCfg.jitter,
+            });
+            await effectiveSleep(delayMs, signal);
+            attemptIndex++;
+            continue;
+        }
+        catch (err) {
+            if (isAbortError(err) || signal?.aborted)
+                throw err;
+            // Network-level failures (DNS, connection reset, etc.) often surface as TypeError.
+            const isNetworkError = err instanceof TypeError;
+            const canRetry = isNetworkError &&
+                retryCfg.maxRetries > 0 &&
+                attemptIndex < retryCfg.maxRetries;
+            if (!canRetry)
+                throw err;
+            const delayMs = computeRetryDelayMs({
+                attemptIndex,
+                baseDelayMs: retryCfg.baseDelayMs,
+                maxDelayMs: retryCfg.maxDelayMs,
+                jitter: retryCfg.jitter,
+            });
+            await effectiveSleep(delayMs, signal);
+            attemptIndex++;
+        }
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/providers/openrouter/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../source/providers/openrouter/api.ts"],"names":[],"mappings":"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"}

package/dist/providers/openrouter/converters.d.ts

@@ -0,0 +1,8 @@
+import { type ModelRequest } from '@openai/agents-core';
+import type { ILoggingService } from '../../services/service-interfaces.js';
+export declare function addCacheControlToLastUserMessage(messages: any[]): void;
+export declare function addCacheControlToLastToolMessage(messages: any[]): void;
+export declare function buildMessagesFromRequest(req: ModelRequest, modelId?: string, loggingService?: ILoggingService): any[];
+export declare function extractFunctionToolsFromRequest(req: ModelRequest): any[];
+export declare function extractModelSettingsForRequest(settings: any): any;
+//# sourceMappingURL=converters.d.ts.map

package/dist/providers/openrouter/converters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converters.d.ts","sourceRoot":"","sources":["../../../source/providers/openrouter/converters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,YAAY,EAAC,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,sCAAsC,CAAC;AA2J1E,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CA4BtE;AAED,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,IAAI,CA4BtE;AAED,wBAAgB,wBAAwB,CACpC,GAAG,EAAE,YAAY,EACjB,OAAO,CAAC,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,eAAe,GACjC,GAAG,EAAE,CAwKP;AAED,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,YAAY,GAAG,GAAG,EAAE,CAsBxE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,GAAG,GAAG,GAAG,CAgDjE"}

package/dist/providers/openrouter/converters.js

@@ -0,0 +1,382 @@
+import { isAnthropicModel } from './utils.js';
+// No-op logger for fallback when loggingService is not provided
+const noOpLogger = {
+    debug: () => { },
+    error: () => { },
+    info: () => { },
+    warn: () => { },
+    security: () => { },
+    setCorrelationId: () => { },
+    getCorrelationId: () => undefined,
+    clearCorrelationId: () => { },
+};
+/**
+ * Converts an agent item into a structured OpenRouter message object that adheres to
+ * expected formats for roles such as user, assistant, or tool, based on the item's properties.
+ * Supports handling various item types like input text, messages, function calls, and function call outputs.
+ *
+ * @param {any} item - The agent item to be converted. It may represent different types of messages
+ * (e.g., user input, assistant messages, tool calls) and can contain nested properties like rawItem, content,
+ * reasoning, tool calls, or reasoning details.
+ * @param {ILoggingService} loggingService - Logging service for debug output
+ *
+ * @return {any|null} - Returns a structured OpenRouter message object with specified properties like `role`,
+ * `content`, `reasoning`, `reasoning_details`, or `tool_calls`. Returns `null` if the input `item` is null or
+ * cannot be converted into a recognized format.
+ */
+function convertAgentItemToOpenRouterMessage(item, loggingService) {
+    if (!item) {
+        return null;
+    }
+    const rawItem = item.rawItem || item;
+    if (rawItem.type === 'input_text' && typeof rawItem.text === 'string') {
+        return { role: 'user', content: rawItem.text };
+    }
+    if (rawItem.role === 'assistant' && rawItem.type === 'message') {
+        const message = { role: 'assistant' };
+        if (Array.isArray(rawItem.content)) {
+            const textContent = rawItem.content
+                .filter((c) => c?.type === 'output_text' && c?.text)
+                .map((c) => c.text)
+                .join('');
+            if (textContent) {
+                message.content = textContent;
+            }
+        }
+        // Preserve OpenRouter "reasoning" field (aka reasoning tokens) when present.
+        // This is distinct from reasoning_details blocks.
+        const reasoning = rawItem.reasoning ?? item.reasoning;
+        if (typeof reasoning === 'string') {
+            message.reasoning = reasoning;
+        }
+        // Preserve reasoning_details EXACTLY as received (required by OpenRouter).
+        // Some SDK history items may carry these fields under `rawItem`.
+        const reasoningDetails = rawItem.reasoning_details ?? item.reasoning_details;
+        if (reasoningDetails != null) {
+            loggingService.debug('convertAgentItemToOpenRouterMessage: reasoning_details', reasoningDetails);
+            message.reasoning_details = reasoningDetails;
+        }
+        const toolCalls = rawItem.tool_calls ?? item.tool_calls;
+        if (toolCalls != null) {
+            message.tool_calls = toolCalls;
+        }
+        return message;
+    }
+    // Handle explicit user messages included in array-form inputs
+    if (rawItem.role === 'user' && rawItem.type === 'message') {
+        if (typeof rawItem.content === 'string') {
+            return { role: 'user', content: rawItem.content };
+        }
+        if (Array.isArray(rawItem.content)) {
+            const textContent = rawItem.content
+                .filter((c) => (c?.type === 'input_text' ||
+                c?.type === 'output_text') &&
+                c?.text)
+                .map((c) => c.text)
+                .join('');
+            if (textContent) {
+                return { role: 'user', content: textContent };
+            }
+        }
+    }
+    if (rawItem?.type === 'function_call') {
+        // Tool-call continuation: to preserve reasoning blocks across tool flows,
+        // we may need to replay reasoning_details/reasoning alongside tool_calls.
+        const reasoning = rawItem.reasoning ?? item.reasoning;
+        const reasoningDetails = rawItem.reasoning_details ?? item.reasoning_details;
+        return {
+            role: 'assistant',
+            content: null,
+            tool_calls: [
+                {
+                    id: rawItem.callId || rawItem.id,
+                    type: 'function',
+                    function: {
+                        name: rawItem.name,
+                        arguments: rawItem.arguments ??
+                            (rawItem.args ? JSON.stringify(rawItem.args) : ''),
+                    },
+                },
+            ],
+            ...(typeof reasoning === 'string' ? { reasoning } : {}),
+            ...(reasoningDetails != null
+                ? { reasoning_details: reasoningDetails }
+                : {}),
+        };
+    }
+    if (rawItem?.type === 'function_call_output' ||
+        rawItem?.type === 'function_call_result' ||
+        rawItem?.type === 'function_call_output_result') {
+        let outputContent = '';
+        if (typeof rawItem.output === 'string') {
+            outputContent = rawItem.output;
+        }
+        else if (rawItem.output && typeof rawItem.output === 'object') {
+            outputContent = JSON.stringify(rawItem.output);
+        }
+        return {
+            role: 'tool',
+            tool_call_id: rawItem.callId || rawItem.id,
+            content: outputContent,
+        };
+    }
+    return null;
+}
+export function addCacheControlToLastUserMessage(messages) {
+    // Find the last user message by iterating from the end
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg.role === 'user') {
+            // Transform the message content to include cache_control
+            if (typeof msg.content === 'string') {
+                // Convert string content to array format with cache_control
+                msg.content = [
+                    {
+                        type: 'text',
+                        text: msg.content,
+                        cache_control: { type: 'ephemeral' },
+                    },
+                ];
+            }
+            else if (Array.isArray(msg.content) && msg.content.length > 0) {
+                // Add cache_control to the last text item in the array
+                for (let j = msg.content.length - 1; j >= 0; j--) {
+                    const item = msg.content[j];
+                    if (item.type === 'text') {
+                        item.cache_control = { type: 'ephemeral' };
+                        break;
+                    }
+                }
+            }
+            break; // Only process the last user message
+        }
+    }
+}
+export function addCacheControlToLastToolMessage(messages) {
+    // Find the last tool message by iterating from the end
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        if (msg.role === 'tool') {
+            // Transform the message content to include cache_control
+            if (typeof msg.content === 'string') {
+                // Convert string content to array format with cache_control
+                msg.content = [
+                    {
+                        type: 'text',
+                        text: msg.content,
+                        cache_control: { type: 'ephemeral' },
+                    },
+                ];
+            }
+            else if (Array.isArray(msg.content) && msg.content.length > 0) {
+                // Add cache_control to the last text item in the array
+                for (let j = msg.content.length - 1; j >= 0; j--) {
+                    const item = msg.content[j];
+                    if (item.type === 'text') {
+                        item.cache_control = { type: 'ephemeral' };
+                        break;
+                    }
+                }
+            }
+            break; // Only process the last tool message
+        }
+    }
+}
+export function buildMessagesFromRequest(req, modelId, loggingService) {
+    const messages = [];
+    let pendingReasoningDetails = [];
+    const logger = loggingService || noOpLogger;
+    logger.debug('buildMessagesFromRequest: req.input', {
+        inputType: typeof req.input,
+        isArray: Array.isArray(req.input),
+        inputLength: Array.isArray(req.input)
+            ? req.input.length
+            : typeof req.input === 'string'
+                ? req.input.length
+                : 'N/A',
+        inputPreview: Array.isArray(req.input)
+            ? req.input.map((item) => ({
+                role: item?.role || item?.rawItem?.role,
+                type: item?.type || item?.rawItem?.type,
+            }))
+            : typeof req.input === 'string'
+                ? req.input.substring(0, 100)
+                : 'non-string, non-array',
+    });
+    const isToolCallOnlyAssistant = (m) => {
+        return (m != null &&
+            m.role === 'assistant' &&
+            m.content == null &&
+            Array.isArray(m.tool_calls) &&
+            m.tool_calls.length > 0);
+    };
+    if (req.systemInstructions && req.systemInstructions.trim().length > 0) {
+        // For Anthropic models, use array format with cache_control for prompt caching.
+        // This enables caching of the system message (agent instructions) which is large and rarely changes.
+        // See: https://openrouter.ai/docs/guides/best-practices/prompt-caching#anthropic-claude
+        if (modelId && isAnthropicModel(modelId)) {
+            messages.push({
+                role: 'system',
+                content: [
+                    {
+                        type: 'text',
+                        text: req.systemInstructions,
+                        cache_control: { type: 'ephemeral' },
+                    },
+                ],
+            });
+        }
+        else {
+            messages.push({ role: 'system', content: req.systemInstructions });
+        }
+    }
+    // Note: History is managed by the SDK
+    // The SDK provides full conversation context in req.input
+    if (typeof req.input === 'string') {
+        const userMessage = { role: 'user', content: req.input };
+        messages.push(userMessage);
+    }
+    else if (Array.isArray(req.input)) {
+        for (const item of req.input) {
+            // The Agents SDK may represent preserved reasoning blocks as standalone
+            // output items of type "reasoning" (with providerData containing the
+            // original reasoning detail object). Gemini models require these blocks
+            // to be replayed as reasoning_details in subsequent requests.
+            const raw = item?.rawItem ?? item;
+            if (raw?.type === 'reasoning') {
+                const detail = raw?.providerData ?? item?.providerData;
+                if (detail && typeof detail === 'object') {
+                    pendingReasoningDetails.push(detail);
+                }
+                continue;
+            }
+            const converted = convertAgentItemToOpenRouterMessage(item, loggingService || noOpLogger);
+            if (converted) {
+                // Attach any pending reasoning blocks to the next assistant message we
+                // emit (including assistant tool_calls messages), unless already present.
+                if (pendingReasoningDetails.length > 0 &&
+                    converted.role === 'assistant' &&
+                    converted.reasoning_details == null) {
+                    converted.reasoning_details = pendingReasoningDetails;
+                    pendingReasoningDetails = [];
+                }
+                // Merge consecutive assistant messages with tool_calls to fix incorrect conversation flow
+                // when parallel tool calls are stored as separate history items.
+                const lastMessage = messages[messages.length - 1];
+                // Case 1: Both are tool-call-only assistant messages - merge tool_calls
+                if (isToolCallOnlyAssistant(lastMessage) &&
+                    isToolCallOnlyAssistant(converted)) {
+                    lastMessage.tool_calls.push(...converted.tool_calls);
+                    // Preserve reasoning if the merged message didn't have it but the new one does
+                    if (lastMessage.reasoning_details == null &&
+                        converted.reasoning_details != null) {
+                        lastMessage.reasoning_details =
+                            converted.reasoning_details;
+                    }
+                    if (lastMessage.reasoning == null &&
+                        converted.reasoning != null) {
+                        lastMessage.reasoning = converted.reasoning;
+                    }
+                    continue;
+                }
+                // Case 2: Last message is assistant (with or without content), current is tool-call-only assistant
+                // This happens when SDK history has assistant message followed by function_call items
+                if (lastMessage?.role === 'assistant' &&
+                    isToolCallOnlyAssistant(converted)) {
+                    if (lastMessage.content != null) {
+                        messages.push(converted);
+                        continue;
+                    }
+                    // Merge the tool_calls into the previous assistant message
+                    if (!lastMessage.tool_calls) {
+                        lastMessage.tool_calls = [];
+                    }
+                    lastMessage.tool_calls.push(...converted.tool_calls);
+                    // Preserve reasoning
+                    if (lastMessage.reasoning_details == null &&
+                        converted.reasoning_details != null) {
+                        lastMessage.reasoning_details =
+                            converted.reasoning_details;
+                    }
+                    if (lastMessage.reasoning == null &&
+                        converted.reasoning != null) {
+                        lastMessage.reasoning = converted.reasoning;
+                    }
+                    continue;
+                }
+                messages.push(converted);
+            }
+        }
+    }
+    // For Anthropic models, add cache_control to the last user message.
+    // This is an efficient caching strategy using 2 of 4 available cache points:
+    // 1. System message (static, large) - already cached above
+    // 2. Last user message (marks end of reusable conversation history)
+    // As the conversation grows, the cache automatically moves with the last user message.
+    // See: https://openrouter.ai/docs/guides/best-practices/prompt-caching#anthropic-claude
+    if (modelId && isAnthropicModel(modelId)) {
+        addCacheControlToLastUserMessage(messages);
+        addCacheControlToLastToolMessage(messages);
+    }
+    return messages;
+}
+export function extractFunctionToolsFromRequest(req) {
+    if (!req.tools || req.tools.length === 0) {
+        return [];
+    }
+    const functionTools = [];
+    for (const tool of req.tools) {
+        if (tool.type === 'function') {
+            functionTools.push({
+                type: 'function',
+                function: {
+                    name: tool.name,
+                    description: tool.description,
+                    parameters: tool.parameters,
+                    strict: tool.strict,
+                },
+            });
+        }
+    }
+    return functionTools;
+}
+export function extractModelSettingsForRequest(settings) {
+    const body = {};
+    if (settings) {
+        // Temperature: Supported by both SDK and OpenRouter
+        if (settings.temperature != null)
+            body.temperature = settings.temperature;
+        // Top P: Supported by both (SDK uses topP, OpenRouter uses top_p)
+        if (settings.topP != null)
+            body.top_p = settings.topP;
+        // Max Tokens: Supported by both (SDK uses maxTokens, OpenRouter uses max_tokens)
+        if (settings.maxTokens != null)
+            body.max_tokens = settings.maxTokens;
+        // Top K: Supported by some models via OpenRouter
+        if (settings.topK != null)
+            body.top_k = settings.topK;
+        // Frequency Penalty: OpenAI standard parameter
+        if (settings.frequencyPenalty != null)
+            body.frequency_penalty = settings.frequencyPenalty;
+        // Presence Penalty: OpenAI standard parameter
+        if (settings.presencePenalty != null)
+            body.presence_penalty = settings.presencePenalty;
+        const hasReasoningObj = settings.reasoning && typeof settings.reasoning === 'object';
+        if (hasReasoningObj) {
+            // Pass through the full reasoning object unmodified. (OpenRouter supports
+            // additional fields like max_tokens and exclude.)
+            body.reasoning = { ...settings.reasoning };
+        }
+        const reasoningEffort = settings.reasoningEffort ?? settings.reasoning?.effort;
+        const normalizedEffort = reasoningEffort === 'default' ? 'medium' : reasoningEffort;
+        // If an effort is provided (and isn't explicitly disabled), ensure it's set.
+        if (normalizedEffort && normalizedEffort !== 'none') {
+            body.reasoning = {
+                ...(body.reasoning ?? {}),
+                effort: normalizedEffort,
+            };
+        }
+    }
+    return body;
+}
+//# sourceMappingURL=converters.js.map