@x12i/ai-gateway 11.0.1 → 11.0.2

package/dist/openrouter-runtime-adapter/create-openrouter-runtime-provider.d.ts

@@ -5,5 +5,6 @@ export type OpenRouterRuntimeProviderOptions = {
     apiKey: string;
     logger?: Logxer;
     runtime?: OpenRouterRuntime;
+    debugOpenRouterBody?: boolean;
 };
 export declare function createOpenRouterRuntimeProvider(options: OpenRouterRuntimeProviderOptions): ProviderModule;

package/dist/openrouter-runtime-adapter/create-openrouter-runtime-provider.js

@@ -1,6 +1,37 @@
 import { createOpenRouterRuntime, RuntimeConfigError, OpenRouterHttpError, } from '@x12i/openrouter-runtime';
 import { OPENROUTER_RUNTIME_OPERATION } from './map-gateway-request.js';
 import { throwMappedOpenRouterHttpError, throwMappedRuntimeConfigError, throwMappedRuntimeResponseErrors, } from './map-runtime-errors.js';
+import { redactRawOpenRouterPayload } from './map-trace.js';
+function hasOwn(obj, key) {
+    return Object.prototype.hasOwnProperty.call(obj, key);
+}
+function summarizeStreamValue(value) {
+    if (value == null || ['boolean', 'number', 'string'].includes(typeof value))
+        return value;
+    if (Array.isArray(value))
+        return `[array:${value.length}]`;
+    return `[${typeof value}]`;
+}
+function collectStreamFields(value, path = 'body', depth = 0, out = []) {
+    if (out.length >= 20 || depth > 8 || value == null || typeof value !== 'object')
+        return out;
+    if (Array.isArray(value)) {
+        for (let i = 0; i < value.length && out.length < 20; i += 1) {
+            collectStreamFields(value[i], `${path}[${i}]`, depth + 1, out);
+        }
+        return out;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        const childPath = `${path}.${key}`;
+        if (key === 'stream') {
+            out.push({ path: childPath, value: summarizeStreamValue(child) });
+            if (out.length >= 20)
+                return out;
+        }
+        collectStreamFields(child, childPath, depth + 1, out);
+    }
+    return out;
+}
 function summarizeServerTools(serverTools) {
     if (!serverTools)
         return undefined;
@@ -26,9 +57,19 @@ function summarizeCompiledTools(compiled) {
         toolCount: tools.length,
         toolTypes,
         bodyKeys: Object.keys(compiled.body),
+        hasTopLevelStream: hasOwn(compiled.body, 'stream'),
+        topLevelStream: compiled.body.stream,
+        streamFields: collectStreamFields(compiled.body),
     };
 }
+function shouldDebugOpenRouterBody(options) {
+    if (options.debugOpenRouterBody === true)
+        return true;
+    const env = process.env.AI_GATEWAY_DEBUG_OPENROUTER_BODY?.toLowerCase();
+    return env === '1' || env === 'true' || env === 'yes';
+}
 export function createOpenRouterRuntimeProvider(options) {
+    const debugOpenRouterBody = shouldDebugOpenRouterBody(options);
     const runtime = options.runtime ??
         createOpenRouterRuntime({
             apiKey: options.apiKey,
@@ -48,7 +89,19 @@ export function createOpenRouterRuntimeProvider(options) {
                 ? {
                     beforeOpenRouterRequest: (compiled) => {
                         const summary = summarizeCompiledTools(compiled);
-                        options.logger?.debug('OpenRouter runtime compiled request tools', summary);
+                        options.logger?.debug('OpenRouter runtime compiled request before fetch', {
+                            ...summary,
+                            url: compiled.url,
+                        });
+                        if (debugOpenRouterBody) {
+                            const redactedBody = redactRawOpenRouterPayload(compiled.body);
+                            options.logger?.debug('OpenRouter runtime compiled request body before fetch', {
+                                apiMode: compiled.apiMode,
+                                url: compiled.url,
+                                body: redactedBody,
+                                bodyJson: JSON.stringify(redactedBody, null, 2),
+                            });
+                        }
                     },
                 }
                 : undefined,
@@ -68,13 +121,17 @@ export function createOpenRouterRuntimeProvider(options) {
             const rawOverrideKeys = runtimeRequest.rawOpenRouterOverrides
                 ? Object.keys(runtimeRequest.rawOpenRouterOverrides)
                 : [];
+            const rawOverrides = runtimeRequest.rawOpenRouterOverrides ?? {};
+            const rawOverrideHasStream = hasOwn(rawOverrides, 'stream');
             options.logger?.debug('OpenRouter runtime request server tools', {
                 requestId: spec.requestId,
                 model: runtimeRequest.model,
                 apiMode: runtimeRequest.apiMode,
                 serverTools: summarizeServerTools(runtimeRequest.serverTools),
                 rawOverrideKeys,
-                rawOverridesToolsPresent: Object.prototype.hasOwnProperty.call(runtimeRequest.rawOpenRouterOverrides ?? {}, 'tools'),
+                rawOverrideHasStream,
+                rawOverrideStream: rawOverrides.stream,
+                rawOverridesToolsPresent: Object.prototype.hasOwnProperty.call(rawOverrides, 'tools'),
             });
             try {
                 const response = await runtime.run(runtimeRequest);

package/dist/openrouter-runtime-adapter/map-gateway-request.js

@@ -22,21 +22,8 @@ function buildGenerationOverrides(config) {
         overrides.stop = config.stop;
     return overrides;
 }
-function hasActiveServerTools(serverTools) {
-    if (!serverTools)
-        return false;
-    return Object.values(serverTools).some((value) => {
-        if (Array.isArray(value))
-            return value.some((item) => item.mode !== 'disabled');
-        return !!value && value.mode !== 'disabled';
-    });
-}
-function buildRawOpenRouterOverrides(generationOverrides, trustedRaw, serverTools) {
-    const raw = { ...trustedRaw };
-    if (hasActiveServerTools(serverTools)) {
-        delete raw.tools;
-    }
-    const merged = { ...generationOverrides, ...raw };
+function buildRawOpenRouterOverrides(generationOverrides, trustedRaw) {
+    const merged = { ...generationOverrides, ...trustedRaw };
     return Object.keys(merged).length ? merged : undefined;
 }
 export function mapGatewayRequestToRuntimeRequest(request, exec) {
@@ -45,7 +32,7 @@ export function mapGatewayRequestToRuntimeRequest(request, exec) {
     const generationOverrides = buildGenerationOverrides(config);
     const trustedRaw = openrouter?.rawOverrides ?? {};
     const serverTools = mapGatewayServerTools(config.serverTools);
-    const rawOpenRouterOverrides = buildRawOpenRouterOverrides(generationOverrides, trustedRaw, serverTools);
+    const rawOpenRouterOverrides = buildRawOpenRouterOverrides(generationOverrides, trustedRaw);
     const aiRequestId = (typeof request.aiRequestId === 'string' && request.aiRequestId) ||
         (typeof request.identity?.aiRequestId === 'string' ? request.identity.aiRequestId : undefined);
     return {

package/dist/openrouter-runtime-adapter/register-openrouter-runtime.js

@@ -1,14 +1,19 @@
 import { createOpenRouterRuntimeAdapter } from './create-openrouter-runtime-adapter.js';
 import { createOpenRouterRuntimeProvider } from './create-openrouter-runtime-provider.js';
 export function registerOpenRouterRuntime(router, options) {
-    const { apiKey, logger } = options;
-    const provider = createOpenRouterRuntimeProvider({ apiKey, logger });
+    const { apiKey, logger, runtimeConfig } = options;
+    const provider = createOpenRouterRuntimeProvider({
+        apiKey,
+        logger,
+        debugOpenRouterBody: runtimeConfig?.debugOpenRouterBody,
+    });
     router.registerProvider(provider);
     const adapter = createOpenRouterRuntimeAdapter();
     router.getAdapterRegistry().register(adapter);
     logger?.info('Registered OpenRouter runtime provider and adapter', {
         provider: 'openrouter',
         runtimeEnabled: true,
+        debugOpenRouterBody: runtimeConfig?.debugOpenRouterBody,
     });
 }
 export { shouldUseOpenRouterRuntime, resolveOpenRouterRuntimeDefaults } from './should-use-openrouter-runtime.js';

package/dist/types.d.ts

@@ -176,6 +176,12 @@ export interface GatewayOpenRouterRuntimeConfig {
     enabled?: boolean;
     apiMode?: 'chat' | 'responses' | 'auto';
     includeRawInTrace?: boolean;
+    /**
+     * Emit the exact compiled OpenRouter request body at debug level before fetch.
+     * Intended for short-lived diagnostics; request prompts/content are included.
+     * Can also be enabled with AI_GATEWAY_DEBUG_OPENROUTER_BODY=1.
+     */
+    debugOpenRouterBody?: boolean;
 }
 export interface GatewayServerToolUsage {
     requested: boolean;

package/dist-cjs/openrouter-runtime-adapter/create-openrouter-runtime-provider.cjs

@@ -1,6 +1,37 @@
 import { createOpenRouterRuntime, RuntimeConfigError, OpenRouterHttpError, } from '@x12i/openrouter-runtime';
 import { OPENROUTER_RUNTIME_OPERATION } from './map-gateway-request.js';
 import { throwMappedOpenRouterHttpError, throwMappedRuntimeConfigError, throwMappedRuntimeResponseErrors, } from './map-runtime-errors.js';
+import { redactRawOpenRouterPayload } from './map-trace.js';
+function hasOwn(obj, key) {
+    return Object.prototype.hasOwnProperty.call(obj, key);
+}
+function summarizeStreamValue(value) {
+    if (value == null || ['boolean', 'number', 'string'].includes(typeof value))
+        return value;
+    if (Array.isArray(value))
+        return `[array:${value.length}]`;
+    return `[${typeof value}]`;
+}
+function collectStreamFields(value, path = 'body', depth = 0, out = []) {
+    if (out.length >= 20 || depth > 8 || value == null || typeof value !== 'object')
+        return out;
+    if (Array.isArray(value)) {
+        for (let i = 0; i < value.length && out.length < 20; i += 1) {
+            collectStreamFields(value[i], `${path}[${i}]`, depth + 1, out);
+        }
+        return out;
+    }
+    for (const [key, child] of Object.entries(value)) {
+        const childPath = `${path}.${key}`;
+        if (key === 'stream') {
+            out.push({ path: childPath, value: summarizeStreamValue(child) });
+            if (out.length >= 20)
+                return out;
+        }
+        collectStreamFields(child, childPath, depth + 1, out);
+    }
+    return out;
+}
 function summarizeServerTools(serverTools) {
     if (!serverTools)
         return undefined;
@@ -26,9 +57,19 @@ function summarizeCompiledTools(compiled) {
         toolCount: tools.length,
         toolTypes,
         bodyKeys: Object.keys(compiled.body),
+        hasTopLevelStream: hasOwn(compiled.body, 'stream'),
+        topLevelStream: compiled.body.stream,
+        streamFields: collectStreamFields(compiled.body),
     };
 }
+function shouldDebugOpenRouterBody(options) {
+    if (options.debugOpenRouterBody === true)
+        return true;
+    const env = process.env.AI_GATEWAY_DEBUG_OPENROUTER_BODY?.toLowerCase();
+    return env === '1' || env === 'true' || env === 'yes';
+}
 export function createOpenRouterRuntimeProvider(options) {
+    const debugOpenRouterBody = shouldDebugOpenRouterBody(options);
     const runtime = options.runtime ??
         createOpenRouterRuntime({
             apiKey: options.apiKey,
@@ -48,7 +89,19 @@ export function createOpenRouterRuntimeProvider(options) {
                 ? {
                     beforeOpenRouterRequest: (compiled) => {
                         const summary = summarizeCompiledTools(compiled);
-                        options.logger?.debug('OpenRouter runtime compiled request tools', summary);
+                        options.logger?.debug('OpenRouter runtime compiled request before fetch', {
+                            ...summary,
+                            url: compiled.url,
+                        });
+                        if (debugOpenRouterBody) {
+                            const redactedBody = redactRawOpenRouterPayload(compiled.body);
+                            options.logger?.debug('OpenRouter runtime compiled request body before fetch', {
+                                apiMode: compiled.apiMode,
+                                url: compiled.url,
+                                body: redactedBody,
+                                bodyJson: JSON.stringify(redactedBody, null, 2),
+                            });
+                        }
                     },
                 }
                 : undefined,
@@ -68,13 +121,17 @@ export function createOpenRouterRuntimeProvider(options) {
             const rawOverrideKeys = runtimeRequest.rawOpenRouterOverrides
                 ? Object.keys(runtimeRequest.rawOpenRouterOverrides)
                 : [];
+            const rawOverrides = runtimeRequest.rawOpenRouterOverrides ?? {};
+            const rawOverrideHasStream = hasOwn(rawOverrides, 'stream');
             options.logger?.debug('OpenRouter runtime request server tools', {
                 requestId: spec.requestId,
                 model: runtimeRequest.model,
                 apiMode: runtimeRequest.apiMode,
                 serverTools: summarizeServerTools(runtimeRequest.serverTools),
                 rawOverrideKeys,
-                rawOverridesToolsPresent: Object.prototype.hasOwnProperty.call(runtimeRequest.rawOpenRouterOverrides ?? {}, 'tools'),
+                rawOverrideHasStream,
+                rawOverrideStream: rawOverrides.stream,
+                rawOverridesToolsPresent: Object.prototype.hasOwnProperty.call(rawOverrides, 'tools'),
             });
             try {
                 const response = await runtime.run(runtimeRequest);

package/dist-cjs/openrouter-runtime-adapter/create-openrouter-runtime-provider.d.ts

@@ -5,5 +5,6 @@ export type OpenRouterRuntimeProviderOptions = {
     apiKey: string;
     logger?: Logxer;
     runtime?: OpenRouterRuntime;
+    debugOpenRouterBody?: boolean;
 };
 export declare function createOpenRouterRuntimeProvider(options: OpenRouterRuntimeProviderOptions): ProviderModule;

package/dist-cjs/openrouter-runtime-adapter/map-gateway-request.cjs

@@ -22,21 +22,8 @@ function buildGenerationOverrides(config) {
         overrides.stop = config.stop;
     return overrides;
 }
-function hasActiveServerTools(serverTools) {
-    if (!serverTools)
-        return false;
-    return Object.values(serverTools).some((value) => {
-        if (Array.isArray(value))
-            return value.some((item) => item.mode !== 'disabled');
-        return !!value && value.mode !== 'disabled';
-    });
-}
-function buildRawOpenRouterOverrides(generationOverrides, trustedRaw, serverTools) {
-    const raw = { ...trustedRaw };
-    if (hasActiveServerTools(serverTools)) {
-        delete raw.tools;
-    }
-    const merged = { ...generationOverrides, ...raw };
+function buildRawOpenRouterOverrides(generationOverrides, trustedRaw) {
+    const merged = { ...generationOverrides, ...trustedRaw };
     return Object.keys(merged).length ? merged : undefined;
 }
 export function mapGatewayRequestToRuntimeRequest(request, exec) {
@@ -45,7 +32,7 @@ export function mapGatewayRequestToRuntimeRequest(request, exec) {
     const generationOverrides = buildGenerationOverrides(config);
     const trustedRaw = openrouter?.rawOverrides ?? {};
     const serverTools = mapGatewayServerTools(config.serverTools);
-    const rawOpenRouterOverrides = buildRawOpenRouterOverrides(generationOverrides, trustedRaw, serverTools);
+    const rawOpenRouterOverrides = buildRawOpenRouterOverrides(generationOverrides, trustedRaw);
     const aiRequestId = (typeof request.aiRequestId === 'string' && request.aiRequestId) ||
         (typeof request.identity?.aiRequestId === 'string' ? request.identity.aiRequestId : undefined);
     return {

package/dist-cjs/openrouter-runtime-adapter/register-openrouter-runtime.cjs

@@ -1,14 +1,19 @@
 import { createOpenRouterRuntimeAdapter } from './create-openrouter-runtime-adapter.js';
 import { createOpenRouterRuntimeProvider } from './create-openrouter-runtime-provider.js';
 export function registerOpenRouterRuntime(router, options) {
-    const { apiKey, logger } = options;
-    const provider = createOpenRouterRuntimeProvider({ apiKey, logger });
+    const { apiKey, logger, runtimeConfig } = options;
+    const provider = createOpenRouterRuntimeProvider({
+        apiKey,
+        logger,
+        debugOpenRouterBody: runtimeConfig?.debugOpenRouterBody,
+    });
     router.registerProvider(provider);
     const adapter = createOpenRouterRuntimeAdapter();
     router.getAdapterRegistry().register(adapter);
     logger?.info('Registered OpenRouter runtime provider and adapter', {
         provider: 'openrouter',
         runtimeEnabled: true,
+        debugOpenRouterBody: runtimeConfig?.debugOpenRouterBody,
     });
 }
 export { shouldUseOpenRouterRuntime, resolveOpenRouterRuntimeDefaults } from './should-use-openrouter-runtime.js';

package/dist-cjs/types.d.ts

@@ -176,6 +176,12 @@ export interface GatewayOpenRouterRuntimeConfig {
     enabled?: boolean;
     apiMode?: 'chat' | 'responses' | 'auto';
     includeRawInTrace?: boolean;
+    /**
+     * Emit the exact compiled OpenRouter request body at debug level before fetch.
+     * Intended for short-lived diagnostics; request prompts/content are included.
+     * Can also be enabled with AI_GATEWAY_DEBUG_OPENROUTER_BODY=1.
+     */
+    debugOpenRouterBody?: boolean;
 }
 export interface GatewayServerToolUsage {
     requested: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/ai-gateway",
-  "version": "11.0.1",
+  "version": "11.0.2",
   "description": "AI Gateway - Unified interface for LLM provider routing and management",
   "type": "module",
   "exports": {
@@ -44,11 +44,11 @@
   "dependencies": {
     "@x12i/activix": "^9.0.2",
     "@x12i/ai-profiles": "^3.4.1",
-    "@x12i/ai-providers-router": "^4.11.0",
+    "@x12i/ai-providers-router": "^4.11.1",
     "@x12i/ai-tools": "^3.3.5",
     "@x12i/flex-md": "^4.8.0",
     "@x12i/logxer": "^5.1.0",
-    "@x12i/openrouter-runtime": "^1.0.4",
+    "@x12i/openrouter-runtime": "^1.0.5",
     "@x12i/rendrix": "^4.3.0"
   },
   "devDependencies": {