@x12i/ai-gateway 11.0.0 → 11.0.2

package/README.md

@@ -463,14 +463,14 @@ At invoke, gateway merges server-tool intent in this order (later wins):
 2. `request.config.serverTools` / `request.config.openrouter`
 3. `request.modelConfig.serverTools` / `request.modelConfig.openrouter`
 
-Gateway then applies **post-routing policy** internally (`applyPostRoutingServerToolsPolicy`): required tools force `provider=openrouter`; `allowed` tools on non-OpenRouter providers are stripped with a warning. **Do not duplicate post-routing policy in consumers** — merge pre-invoke intent only.
+Gateway then applies **post-routing policy** internally (`applyPostRoutingServerToolsPolicy`): any active server tool (`allowed` or `required`) forces `provider=openrouter` so tools are sent in the OpenRouter request. **Do not duplicate post-routing policy in consumers** — merge pre-invoke intent only.
 
 ### Stable error codes
 
 | Code | When |
 |------|------|
-| `SERVER_TOOL_REQUIRES_OPENROUTER_PROVIDER` | Not thrown — gateway **forces** `provider=openrouter` when required tools are configured and a key is present |
-| `OPENROUTER_SERVER_TOOL_REQUIRES_KEY` | Required tools but no OpenRouter key (`codeAliases` includes `OPENROUTER_SERVER_TOOL_REQUIRES_OPENROUTER_KEY`) |
+| `SERVER_TOOL_REQUIRES_OPENROUTER_PROVIDER` | Not thrown — gateway **forces** `provider=openrouter` when active server tools are configured and a key is present |
+| `OPENROUTER_SERVER_TOOL_REQUIRES_KEY` | Active server tools but no OpenRouter key (`codeAliases` includes `OPENROUTER_SERVER_TOOL_REQUIRES_OPENROUTER_KEY`) |
 | `WEB_SEARCH_REQUIRED_BUT_NOT_USED`, etc. | From `@x12i/openrouter-runtime` policy → `GatewayPolicyViolationError.code` and `error.metadata.openrouterRuntime.policyViolations` |
 | `CITATIONS_REQUIRED_BUT_MISSING` | `@x12i/openrouter-runtime` ≥ **1.0.3** policy when `webSearch.requireCitations: true` (or global default) and search used with no citations |
 | `APPLY_PATCH_REQUIRES_RESPONSES_API` | `applyPatch` with `openrouter.apiMode: 'chat'` |

package/dist/gateway-utils.js

@@ -209,7 +209,7 @@ export async function mergeConfig(request, config, logger, mergeOptions) {
     });
     if (serverToolsPolicy.forceOpenRouter) {
         merged.provider = 'openrouter';
-        logger.verbose('Required OpenRouter server tool forced provider=openrouter', {
+        logger.verbose('OpenRouter server tool forced provider=openrouter', {
             jobId: request.identity.jobId,
         });
     }

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,7 +1,75 @@
 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;
+    const out = {};
+    for (const [key, value] of Object.entries(serverTools)) {
+        if (Array.isArray(value)) {
+            out[key] = value.map((item) => item.mode).join(',');
+            continue;
+        }
+        if (value && typeof value === 'object' && 'mode' in value && typeof value.mode === 'string') {
+            out[key] = value.mode;
+        }
+    }
+    return Object.keys(out).length ? out : undefined;
+}
+function summarizeCompiledTools(compiled) {
+    const tools = Array.isArray(compiled.body.tools) ? compiled.body.tools : [];
+    const toolTypes = tools
+        .map((tool) => (tool && typeof tool === 'object' && 'type' in tool ? String(tool.type) : undefined))
+        .filter((type) => typeof type === 'string');
+    return {
+        apiMode: compiled.apiMode,
+        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,
@@ -9,6 +77,34 @@ export function createOpenRouterRuntimeProvider(options) {
                 retry: { enabled: false },
                 onPolicyViolation: 'throw',
             },
+            logger: options.logger
+                ? {
+                    debug: (event, data) => options.logger?.debug(event, data),
+                    info: (event, data) => options.logger?.info(event, data),
+                    warn: (event, data) => options.logger?.warn(event, data),
+                    error: (event, data) => options.logger?.error(event, data),
+                }
+                : undefined,
+            hooks: options.logger
+                ? {
+                    beforeOpenRouterRequest: (compiled) => {
+                        const summary = summarizeCompiledTools(compiled);
+                        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,
         });
     return {
         name: 'openrouter',
@@ -22,6 +118,21 @@ export function createOpenRouterRuntimeProvider(options) {
                 throw new Error(`Unsupported OpenRouter runtime operation: ${spec.operation}`);
             }
             const runtimeRequest = spec.args;
+            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,
+                rawOverrideHasStream,
+                rawOverrideStream: rawOverrides.stream,
+                rawOverridesToolsPresent: Object.prototype.hasOwnProperty.call(rawOverrides, 'tools'),
+            });
             try {
                 const response = await runtime.run(runtimeRequest);
                 if (response.status !== 'completed') {

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

@@ -22,14 +22,17 @@ function buildGenerationOverrides(config) {
         overrides.stop = config.stop;
     return overrides;
 }
+function buildRawOpenRouterOverrides(generationOverrides, trustedRaw) {
+    const merged = { ...generationOverrides, ...trustedRaw };
+    return Object.keys(merged).length ? merged : undefined;
+}
 export function mapGatewayRequestToRuntimeRequest(request, exec) {
     const config = request.config ?? {};
     const openrouter = config.openrouter;
     const generationOverrides = buildGenerationOverrides(config);
     const trustedRaw = openrouter?.rawOverrides ?? {};
-    const rawOpenRouterOverrides = Object.keys(generationOverrides).length || Object.keys(trustedRaw).length
-        ? { ...generationOverrides, ...trustedRaw }
-        : undefined;
+    const serverTools = mapGatewayServerTools(config.serverTools);
+    const rawOpenRouterOverrides = buildRawOpenRouterOverrides(generationOverrides, trustedRaw);
     const aiRequestId = (typeof request.aiRequestId === 'string' && request.aiRequestId) ||
         (typeof request.identity?.aiRequestId === 'string' ? request.identity.aiRequestId : undefined);
     return {
@@ -42,7 +45,7 @@ export function mapGatewayRequestToRuntimeRequest(request, exec) {
         reasoning: config.reasoning != null && typeof config.reasoning === 'object'
             ? config.reasoning
             : undefined,
-        serverTools: mapGatewayServerTools(config.serverTools),
+        serverTools,
         execution: exec?.timeoutMs ? { timeoutMs: exec.timeoutMs } : undefined,
         rawOpenRouterOverrides,
         metadata: {

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/openrouter-runtime-adapter/validate-server-tools.js

@@ -73,22 +73,12 @@ export function applyPostRoutingServerToolsPolicy(input) {
         return { serverTools, warnings, forceOpenRouter: false };
     }
     validateApplyPatchConfig(serverTools, openrouter);
-    if (hasRequiredServerTool(serverTools)) {
-        if (!openRouterApiKey) {
-            throw new ProviderConfigError('OPENROUTER_SERVER_TOOL_REQUIRES_KEY', 'Required OpenRouter server tools need OPENROUTER_API_KEY or GatewayConfig.openrouter.apiKey', { codeAliases: ['OPENROUTER_SERVER_TOOL_REQUIRES_OPENROUTER_KEY'] });
-        }
-        if (provider !== 'openrouter') {
-            provider = 'openrouter';
-            return { serverTools, warnings, forceOpenRouter: true };
-        }
-        return { serverTools, warnings, forceOpenRouter: false };
+    if (!openRouterApiKey) {
+        throw new ProviderConfigError('OPENROUTER_SERVER_TOOL_REQUIRES_KEY', 'OpenRouter server tools need OPENROUTER_API_KEY or GatewayConfig.openrouter.apiKey', { codeAliases: ['OPENROUTER_SERVER_TOOL_REQUIRES_OPENROUTER_KEY'] });
     }
     if (provider !== 'openrouter') {
-        warnings.push({
-            code: 'SERVER_TOOLS_IGNORED_FOR_NON_OPENROUTER_PROVIDER',
-            message: 'OpenRouter server tools were requested but the final provider is not openrouter; tools were stripped',
-        });
-        return { serverTools: undefined, warnings, forceOpenRouter: false };
+        provider = 'openrouter';
+        return { serverTools, warnings, forceOpenRouter: true };
     }
     return { serverTools, warnings, forceOpenRouter: false };
 }

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/gateway-utils.cjs

@@ -209,7 +209,7 @@ export async function mergeConfig(request, config, logger, mergeOptions) {
     });
     if (serverToolsPolicy.forceOpenRouter) {
         merged.provider = 'openrouter';
-        logger.verbose('Required OpenRouter server tool forced provider=openrouter', {
+        logger.verbose('OpenRouter server tool forced provider=openrouter', {
             jobId: request.identity.jobId,
         });
     }

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

@@ -1,7 +1,75 @@
 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;
+    const out = {};
+    for (const [key, value] of Object.entries(serverTools)) {
+        if (Array.isArray(value)) {
+            out[key] = value.map((item) => item.mode).join(',');
+            continue;
+        }
+        if (value && typeof value === 'object' && 'mode' in value && typeof value.mode === 'string') {
+            out[key] = value.mode;
+        }
+    }
+    return Object.keys(out).length ? out : undefined;
+}
+function summarizeCompiledTools(compiled) {
+    const tools = Array.isArray(compiled.body.tools) ? compiled.body.tools : [];
+    const toolTypes = tools
+        .map((tool) => (tool && typeof tool === 'object' && 'type' in tool ? String(tool.type) : undefined))
+        .filter((type) => typeof type === 'string');
+    return {
+        apiMode: compiled.apiMode,
+        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,
@@ -9,6 +77,34 @@ export function createOpenRouterRuntimeProvider(options) {
                 retry: { enabled: false },
                 onPolicyViolation: 'throw',
             },
+            logger: options.logger
+                ? {
+                    debug: (event, data) => options.logger?.debug(event, data),
+                    info: (event, data) => options.logger?.info(event, data),
+                    warn: (event, data) => options.logger?.warn(event, data),
+                    error: (event, data) => options.logger?.error(event, data),
+                }
+                : undefined,
+            hooks: options.logger
+                ? {
+                    beforeOpenRouterRequest: (compiled) => {
+                        const summary = summarizeCompiledTools(compiled);
+                        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,
         });
     return {
         name: 'openrouter',
@@ -22,6 +118,21 @@ export function createOpenRouterRuntimeProvider(options) {
                 throw new Error(`Unsupported OpenRouter runtime operation: ${spec.operation}`);
             }
             const runtimeRequest = spec.args;
+            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,
+                rawOverrideHasStream,
+                rawOverrideStream: rawOverrides.stream,
+                rawOverridesToolsPresent: Object.prototype.hasOwnProperty.call(rawOverrides, 'tools'),
+            });
             try {
                 const response = await runtime.run(runtimeRequest);
                 if (response.status !== 'completed') {

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,14 +22,17 @@ function buildGenerationOverrides(config) {
         overrides.stop = config.stop;
     return overrides;
 }
+function buildRawOpenRouterOverrides(generationOverrides, trustedRaw) {
+    const merged = { ...generationOverrides, ...trustedRaw };
+    return Object.keys(merged).length ? merged : undefined;
+}
 export function mapGatewayRequestToRuntimeRequest(request, exec) {
     const config = request.config ?? {};
     const openrouter = config.openrouter;
     const generationOverrides = buildGenerationOverrides(config);
     const trustedRaw = openrouter?.rawOverrides ?? {};
-    const rawOpenRouterOverrides = Object.keys(generationOverrides).length || Object.keys(trustedRaw).length
-        ? { ...generationOverrides, ...trustedRaw }
-        : undefined;
+    const serverTools = mapGatewayServerTools(config.serverTools);
+    const rawOpenRouterOverrides = buildRawOpenRouterOverrides(generationOverrides, trustedRaw);
     const aiRequestId = (typeof request.aiRequestId === 'string' && request.aiRequestId) ||
         (typeof request.identity?.aiRequestId === 'string' ? request.identity.aiRequestId : undefined);
     return {
@@ -42,7 +45,7 @@ export function mapGatewayRequestToRuntimeRequest(request, exec) {
         reasoning: config.reasoning != null && typeof config.reasoning === 'object'
             ? config.reasoning
             : undefined,
-        serverTools: mapGatewayServerTools(config.serverTools),
+        serverTools,
         execution: exec?.timeoutMs ? { timeoutMs: exec.timeoutMs } : undefined,
         rawOpenRouterOverrides,
         metadata: {

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/openrouter-runtime-adapter/validate-server-tools.cjs

@@ -73,22 +73,12 @@ export function applyPostRoutingServerToolsPolicy(input) {
         return { serverTools, warnings, forceOpenRouter: false };
     }
     validateApplyPatchConfig(serverTools, openrouter);
-    if (hasRequiredServerTool(serverTools)) {
-        if (!openRouterApiKey) {
-            throw new ProviderConfigError('OPENROUTER_SERVER_TOOL_REQUIRES_KEY', 'Required OpenRouter server tools need OPENROUTER_API_KEY or GatewayConfig.openrouter.apiKey', { codeAliases: ['OPENROUTER_SERVER_TOOL_REQUIRES_OPENROUTER_KEY'] });
-        }
-        if (provider !== 'openrouter') {
-            provider = 'openrouter';
-            return { serverTools, warnings, forceOpenRouter: true };
-        }
-        return { serverTools, warnings, forceOpenRouter: false };
+    if (!openRouterApiKey) {
+        throw new ProviderConfigError('OPENROUTER_SERVER_TOOL_REQUIRES_KEY', 'OpenRouter server tools need OPENROUTER_API_KEY or GatewayConfig.openrouter.apiKey', { codeAliases: ['OPENROUTER_SERVER_TOOL_REQUIRES_OPENROUTER_KEY'] });
     }
     if (provider !== 'openrouter') {
-        warnings.push({
-            code: 'SERVER_TOOLS_IGNORED_FOR_NON_OPENROUTER_PROVIDER',
-            message: 'OpenRouter server tools were requested but the final provider is not openrouter; tools were stripped',
-        });
-        return { serverTools: undefined, warnings, forceOpenRouter: false };
+        provider = 'openrouter';
+        return { serverTools, warnings, forceOpenRouter: true };
     }
     return { serverTools, warnings, forceOpenRouter: false };
 }

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.0",
+  "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.10.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": {