@x12i/ai-gateway 9.1.6 → 9.3.0

package/dist-cjs/gateway-config.cjs

@@ -1,49 +1,10 @@
-"use strict";
 /**
  * Gateway Configuration Module
  * Handles configuration loading and setup
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadConfig = loadConfig;
-exports.getFlexMdMinComplianceLevel = getFlexMdMinComplianceLevel;
-exports.setupRequestInterceptor = setupRequestInterceptor;
-exports.initializeGatewayComponents = initializeGatewayComponents;
-const fs = __importStar(require("fs"));
-const path = __importStar(require("path"));
-const url_1 = require("url");
+import * as fs from 'fs';
+import * as path from 'path';
+import { fileURLToPath } from 'url';
 /** Resolve current module directory across ESM/CJS builds. */
 function getModuleDir() {
     if (typeof __dirname !== 'undefined') {
@@ -53,7 +14,7 @@ function getModuleDir() {
         const getMetaUrl = new Function('return import.meta.url');
         const metaUrl = getMetaUrl();
         if (metaUrl && metaUrl.startsWith('file:')) {
-            return path.dirname((0, url_1.fileURLToPath)(metaUrl));
+            return path.dirname(fileURLToPath(metaUrl));
         }
     }
     catch {
@@ -84,18 +45,18 @@ function getDefaultsDir() {
     // Keep existing behavior as a last fallback.
     return path.join(cwd, 'dist');
 }
-const ai_providers_router_1 = require("@x12i/ai-providers-router");
-const logger_factory_js_1 = require("./logger-factory.cjs");
-const activity_manager_js_1 = require("./activity-manager.cjs");
-const usage_tracker_js_1 = require("./usage-tracker.cjs");
-const template_render_merge_js_1 = require("./template-render-merge.cjs");
-const gateway_rate_limiter_js_1 = require("./gateway-rate-limiter.cjs");
-const gateway_rate_limiter_constants_js_1 = require("./gateway-rate-limiter-constants.cjs");
+import { LLMProviderRouter } from '@x12i/ai-providers-router';
+import { createGatewayLogger } from './logger-factory.js';
+import { ActivityManager } from './activity-manager.js';
+import { UsageTracker } from './usage-tracker.js';
+import { mergeTemplateRenderOptions } from './template-render-merge.js';
+import { GatewayRateLimiter } from './gateway-rate-limiter.js';
+import { DEFAULT_RATE_LIMIT_MIN_INTERVAL_MS, DEFAULT_RATE_LIMIT_ENABLED } from './gateway-rate-limiter-constants.js';
 /**
  * Loads configuration from JSON files (model config and instructionsBlocks).
  * Pass a {@link Logxer} instance so load diagnostics go through logxer (not console).
  */
-function loadConfig(logger) {
+export function loadConfig(logger) {
     const defaultModelConfig = {};
     const defaultInstructionsBlocks = {};
     let defaultTemplateRendering;
@@ -150,7 +111,7 @@ function loadConfig(logger) {
  * Gets the minimum flex-md compliance level from environment variable
  * Defaults to 'L0' if not set or invalid
  */
-function getFlexMdMinComplianceLevel() {
+export function getFlexMdMinComplianceLevel() {
     const envValue = process.env.FLEX_MD_MIN_COMPLIANCE_LEVEL;
     if (envValue === 'L0' || envValue === 'L1' || envValue === 'L2' || envValue === 'L3') {
         return envValue;
@@ -160,7 +121,7 @@ function getFlexMdMinComplianceLevel() {
 /**
  * Sets up request interceptor for jobId propagation and config cleanup
  */
-function setupRequestInterceptor(router, logger) {
+export function setupRequestInterceptor(router, logger) {
     logger.debug('Setting up request interceptor for jobId propagation and config cleanup');
     router.addRequestInterceptor(async (request, provider) => {
         const identityJobId = request?.identity?.jobId;
@@ -194,9 +155,9 @@ function setupRequestInterceptor(router, logger) {
 /**
  * Initializes gateway components
  */
-function initializeGatewayComponents(config) {
+export function initializeGatewayComponents(config) {
     // Initialize logger FIRST (before other components that might need it)
-    const logger = (0, logger_factory_js_1.createGatewayLogger)({
+    const logger = createGatewayLogger({
         enableLogging: config.enableLogging ?? true,
         packageName: config.packageName,
         customLogger: config.logger
@@ -242,7 +203,7 @@ function initializeGatewayComponents(config) {
         routerConfig.openrouter = { apiKey: openRouterKey };
         routerConfig.defaultMode = 'openrouter';
     }
-    const router = new ai_providers_router_1.LLMProviderRouter(routerConfig);
+    const router = new LLMProviderRouter(routerConfig);
     // Set up BETWEEN-CALLS rate limiting as a request interceptor (applies to all provider calls)
     // This ensures rate limiting works even when router is used directly without gateway
     // Hidden in the flow - automatic and transparent
@@ -252,14 +213,14 @@ function initializeGatewayComponents(config) {
     const rateLimitConfig = config.rateLimit;
     // Get defaults from JSON config, fallback to constants
     const jsonRateLimitConfig = defaultModelConfig.rateLimit || {};
-    const rateLimitEnabled = rateLimitConfig?.enabled ?? jsonRateLimitConfig.enabled ?? gateway_rate_limiter_constants_js_1.DEFAULT_RATE_LIMIT_ENABLED;
+    const rateLimitEnabled = rateLimitConfig?.enabled ?? jsonRateLimitConfig.enabled ?? DEFAULT_RATE_LIMIT_ENABLED;
     if (rateLimitEnabled) {
         // Priority: explicit config > JSON defaults > constants
         const defaultMinIntervalMs = rateLimitConfig?.defaultMinIntervalMs
             ?? jsonRateLimitConfig.defaultMinIntervalMs
-            ?? gateway_rate_limiter_constants_js_1.DEFAULT_RATE_LIMIT_MIN_INTERVAL_MS;
+            ?? DEFAULT_RATE_LIMIT_MIN_INTERVAL_MS;
         const providerIntervals = rateLimitConfig?.providerIntervals;
-        const rateLimiter = new gateway_rate_limiter_js_1.GatewayRateLimiter(defaultMinIntervalMs, providerIntervals, logger);
+        const rateLimiter = new GatewayRateLimiter(defaultMinIntervalMs, providerIntervals, logger);
         // Add request interceptor for BETWEEN-CALLS rate limiting (hidden in the flow)
         router.addRequestInterceptor(async (request, provider) => {
             // Get provider name
@@ -295,18 +256,18 @@ function initializeGatewayComponents(config) {
         logger.debug('Rate limiting disabled');
     }
     // Initialize usage tracking
-    const usageTracker = new usage_tracker_js_1.UsageTracker({
+    const usageTracker = new UsageTracker({
         enableUsageTracking: config.enableUsageTracking ?? true,
         usageTier: config.usageTier,
         logger
     });
     // Initialize activity tracking
-    const activityManager = new activity_manager_js_1.ActivityManager({
+    const activityManager = new ActivityManager({
         enableActivityTracking: config.enableActivityTracking ?? true,
         customTracker: config.activityTracker,
         logger
     });
-    const templateRendering = (0, template_render_merge_js_1.mergeTemplateRenderOptions)(defaultTemplateRendering, config.templateRendering);
+    const templateRendering = mergeTemplateRenderOptions(defaultTemplateRendering, config.templateRendering);
     const instructionsBlockOverrides = {
         ...(config.instructionsBlocks ?? {})
     };
@@ -322,6 +283,7 @@ function initializeGatewayComponents(config) {
         router,
         activityManager,
         usageTracker,
-        messageBuilderConfig
+        messageBuilderConfig,
+        defaultModelConfig
     };
 }

package/dist-cjs/gateway-config.d.ts

@@ -19,6 +19,7 @@ export interface GatewayConfigContext {
     usageTracker: UsageTracker;
     messageBuilderConfig: MessageBuilderConfig;
 }
+export type InitializedGatewayComponents = ReturnType<typeof initializeGatewayComponents>;
 /**
  * Loads configuration from JSON files (model config and instructionsBlocks).
  * Pass a {@link Logxer} instance so load diagnostics go through logxer (not console).
@@ -46,4 +47,5 @@ export declare function initializeGatewayComponents(config: GatewayConfig): {
     activityManager: ActivityManager;
     usageTracker: UsageTracker;
     messageBuilderConfig: MessageBuilderConfig;
+    defaultModelConfig: Record<string, unknown>;
 };

package/dist-cjs/gateway-conversion.cjs

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * Gateway Conversion Module
  * Handles structured text conversion and two-step conversion
@@ -6,44 +5,7 @@
  * Text mode now uses flex-md format exclusively.
  * Two-step conversion parses flex-md directly to JSON without additional LLM call.
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.invokeStructuredText = invokeStructuredText;
-exports.getDefaultConversionInstructions = getDefaultConversionInstructions;
-exports.convertStructuredToJson = convertStructuredToJson;
-const flex_md_loader_js_1 = require("./flex-md-loader.cjs");
+import { extractJsonFromFlexMd } from './flex-md-loader.js';
 /**
  * Get the current directory - works in both ESM and CJS
  * In CJS: uses __dirname
@@ -59,8 +21,8 @@ async function getCurrentDir() {
         const getMetaUrl = new Function('return import.meta.url');
         const metaUrl = getMetaUrl();
         if (metaUrl) {
-            const url = await Promise.resolve().then(() => __importStar(require('url')));
-            const path = await Promise.resolve().then(() => __importStar(require('path')));
+            const url = await import('url');
+            const path = await import('path');
             return path.dirname(url.fileURLToPath(metaUrl));
         }
     }
@@ -73,7 +35,7 @@ async function getCurrentDir() {
 /**
  * Invoke structured text mode (first step of two-step conversion)
  */
-async function invokeStructuredText(request, gateway) {
+export async function invokeStructuredText(request, gateway) {
     // Create a new request with structured-text mode
     const structuredRequest = {
         ...request,
@@ -89,7 +51,7 @@ async function invokeStructuredText(request, gateway) {
  * Two-step mode now parses flex-md directly using the flex-md package.
  * This function is kept for backward compatibility only.
  */
-function getDefaultConversionInstructions() {
+export function getDefaultConversionInstructions() {
     return `You are a data converter. Your task is to convert structured text into valid JSON.
 
 You will receive structured text output from an AI assistant. Convert it into a valid JSON object that captures all the information from the structured text.
@@ -111,7 +73,7 @@ CRITICAL RULES:
  * This function now parses flex-md directly using the flex-md package,
  * eliminating the need for an additional LLM call.
  */
-async function convertStructuredToJson(structuredText, originalRequest, config, gateway, logger) {
+export async function convertStructuredToJson(structuredText, originalRequest, config, gateway, logger) {
     logger.debug('Two-step conversion: Parsing flex-md text directly using flex-md SDK 3.0.0', {
         aiRequestId: originalRequest.aiRequestId,
         structuredTextLength: structuredText.length,
@@ -119,7 +81,7 @@ async function convertStructuredToJson(structuredText, originalRequest, config,
     });
     try {
         // Use flex-md 3.0.0 to extract and parse JSON
-        const flexMdResult = await (0, flex_md_loader_js_1.extractJsonFromFlexMd)(structuredText, logger);
+        const flexMdResult = await extractJsonFromFlexMd(structuredText, logger);
         if (!flexMdResult || !flexMdResult.json) {
             throw new Error('flex-md SDK could not extract JSON from structured text');
         }
@@ -168,7 +130,7 @@ async function convertStructuredToJson(structuredText, originalRequest, config,
         let flexMdVersion = 'unknown';
         try {
             // Use type assertion to allow dynamic import of package.json
-            const flexMdPkg = await Promise.resolve(`${'flex-md/package.json'}`).then(s => __importStar(require(s)));
+            const flexMdPkg = await import('flex-md/package.json');
             flexMdVersion = flexMdPkg?.version || flexMdPkg?.default?.version || 'unknown';
         }
         catch {
@@ -195,8 +157,8 @@ async function convertStructuredToJson(structuredText, originalRequest, config,
         };
         // Write report to docs directory
         try {
-            const fs = await Promise.resolve().then(() => __importStar(require('fs')));
-            const path = await Promise.resolve().then(() => __importStar(require('path')));
+            const fs = await import('fs');
+            const path = await import('path');
             const currentDir = await getCurrentDir();
             const reportPath = path.join(currentDir, '../../docs/FLEX_MD_PACKAGE_ISSUE_REPORT.json');
             fs.writeFileSync(reportPath, JSON.stringify(report, null, 2));

package/dist-cjs/gateway-instructions.cjs

@@ -1,13 +1,8 @@
-"use strict";
 /**
  * Gateway Instructions Module
  * Handles instructions block resolution from inline config only (no content registry).
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveNestedInstructionsBlock = resolveNestedInstructionsBlock;
-exports.resolveInstructionsBlock = resolveInstructionsBlock;
-exports.getPreParsedInstructions = getPreParsedInstructions;
-const instruction_errors_js_1 = require("./instruction-errors.cjs");
+import { InstructionNotFoundError } from './instruction-errors.js';
 function getNestedString(blocks, dotPath) {
     const parts = dotPath.split('.');
     let cur = blocks;
@@ -23,13 +18,13 @@ function getNestedString(blocks, dotPath) {
  * Supports dot notation for nested object access in defaultInstructionsBlocks,
  * then flat keys in merged overrides.
  */
-async function resolveNestedInstructionsBlock(blockPath, _agentId, _taskTypeId, context) {
+export async function resolveNestedInstructionsBlock(blockPath, _agentId, _taskTypeId, context) {
     return resolveInstructionsBlock(blockPath, _agentId, _taskTypeId, context);
 }
 /**
  * Resolves instructionsBlocks from config overrides, request overrides, nested defaults, or flat defaults.
  */
-async function resolveInstructionsBlock(blockName, agentId, taskTypeId, context) {
+export async function resolveInstructionsBlock(blockName, agentId, taskTypeId, context) {
     const { config, logger, defaultInstructionsBlocks, instructionsBlockOverrides, requestInstructionsBlocks } = context;
     logger.verbose('Resolving instructionsBlock', {
         blockName,
@@ -57,11 +52,11 @@ async function resolveInstructionsBlock(blockName, agentId, taskTypeId, context)
         logger.debug('Using nested defaultInstructionsBlocks for instructionsBlock', { blockName, agentId });
         return nested;
     }
-    throw new instruction_errors_js_1.InstructionNotFoundError(blockName, 'instructions-blocks', `InstructionsBlock "${blockName}" not found. Provide it via packaged defaults, gateway instructionsBlocks, or request.config.instructionsBlocks.`, blockName);
+    throw new InstructionNotFoundError(blockName, 'instructions-blocks', `InstructionsBlock "${blockName}" not found. Provide it via packaged defaults, gateway instructionsBlocks, or request.config.instructionsBlocks.`, blockName);
 }
 /**
  * Pre-parse instructions string for stable hashing (taskTypeId). No external resolution.
  */
-function getPreParsedInstructions(instructions) {
+export function getPreParsedInstructions(instructions) {
     return instructions ?? '';
 }

package/dist-cjs/gateway-log-meta.cjs

@@ -1,11 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.gatewayLogDebug = void 0;
-exports.activityIdentityToLogMeta = activityIdentityToLogMeta;
-exports.withActivityIdentity = withActivityIdentity;
-const logxer_1 = require("@x12i/logxer");
+import { DebugLogAbstract } from '@x12i/logxer';
 /** Subset of identity forwarded on every structured log line (plus full envelope under `identity`). */
-function activityIdentityToLogMeta(identity) {
+export function activityIdentityToLogMeta(identity) {
     if (!identity) {
         return {};
     }
@@ -25,17 +20,17 @@ function activityIdentityToLogMeta(identity) {
     };
     return meta;
 }
-function withActivityIdentity(identity, data, debugKind) {
+export function withActivityIdentity(identity, data, debugKind) {
     return {
         ...activityIdentityToLogMeta(identity),
         ...(data || {}),
         ...(debugKind !== undefined ? { debugKind } : {})
     };
 }
-exports.gatewayLogDebug = {
-    anomaly: logxer_1.DebugLogAbstract.ANOMALY,
-    trace: logxer_1.DebugLogAbstract.TRACE,
-    intent: logxer_1.DebugLogAbstract.INTENT,
-    event: logxer_1.DebugLogAbstract.EVENT,
-    state: logxer_1.DebugLogAbstract.STATE
+export const gatewayLogDebug = {
+    anomaly: DebugLogAbstract.ANOMALY,
+    trace: DebugLogAbstract.TRACE,
+    intent: DebugLogAbstract.INTENT,
+    event: DebugLogAbstract.EVENT,
+    state: DebugLogAbstract.STATE
 };

package/dist-cjs/gateway-memory.cjs

@@ -1,11 +1,7 @@
-"use strict";
 /**
  * Gateway Memory Module
  * Handles working memory and template parameter resolution
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.buildWorkingMemory = buildWorkingMemory;
-exports.resolveTemplateParams = resolveTemplateParams;
 // Type guard to check if request is AIRequest (has primaryObjectType)
 function isAIRequest(request) {
     return 'primaryObjectType' in request &&
@@ -21,7 +17,7 @@ function isAIRequest(request) {
  * - Tier 2: workingMemory (this method) - checks existing workingMemory first
  * - Tier 3: derived from request fields or other memories (fallback)
  */
-function buildWorkingMemory(request, existingWorkingMemory, otherMemories) {
+export function buildWorkingMemory(request, existingWorkingMemory, otherMemories) {
     // Start with existing workingMemory if provided, otherwise empty object
     const workingMemory = existingWorkingMemory && typeof existingWorkingMemory === 'object'
         ? { ...existingWorkingMemory }
@@ -142,7 +138,7 @@ function buildWorkingMemory(request, existingWorkingMemory, otherMemories) {
  * Resolves template parameters with smart fallback logic
  * Priority: request.workingMemory -> memoryManager resolution -> buildWorkingMemory merge
  */
-async function resolveTemplateParams(request, config, logger) {
+export async function resolveTemplateParams(request, config, logger) {
     // Tier 1: Request args (highest priority)
     let workingMemory = request.workingMemory;
     // Tier 2: Memory component integration (if available)

package/dist-cjs/gateway-messages.cjs

@@ -1,11 +1,8 @@
-"use strict";
 /**
  * Gateway Messages Module
  * Handles message construction using direct message builder
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.constructMessages = constructMessages;
-const message_builder_js_1 = require("./message-builder.cjs");
+import { buildMessages } from './message-builder.js';
 // Type guard to check if request is AIRequest
 // AIRequest is distinguished by having primaryObjectType, objectTypes, or other AIRequest-specific fields
 function isAIRequest(request) {
@@ -25,7 +22,7 @@ function isAIRequest(request) {
  * - Flex-md format specification
  * - Message assembly
  */
-async function constructMessages(request, config, logger, parsedSnapshot) {
+export async function constructMessages(request, config, logger, parsedSnapshot) {
     logger.verbose('Constructing messages from request', {
         jobId: request.identity.jobId,
         agentId: request.agentId,
@@ -73,7 +70,7 @@ async function constructMessages(request, config, logger, parsedSnapshot) {
     // Update request with final instructions (for message builder)
     const requestWithExamples = { ...request, instructions: finalInstructions };
     // Build messages using direct message builder
-    const result = await (0, message_builder_js_1.buildMessages)(requestWithExamples, config, {
+    const result = await buildMessages(requestWithExamples, config, {
         useSystemContextFallback: true,
         includeInputRecognition: isAIRequest(request),
         includeReinforcement: isAIRequest(request),

package/dist-cjs/gateway-meta.cjs

@@ -1,14 +1,11 @@
-"use strict";
 /**
  * Gateway Meta Operations Module
  * Handles meta operations like instruction optimization and testing
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.testInstructions = testInstructions;
 /**
  * Test instructions by running them and analyzing the response
  */
-async function testInstructions(instructions, testInput, expectedSchema, options, config, gateway, logger) {
+export async function testInstructions(instructions, testInput, expectedSchema, options, config, gateway, logger) {
     // Get internal system action config (instruction audit)
     const internalConfig = config.internalSystemActions?.instructionAudit;
     const defaultEngine = config.defaultEngine || 'openai';

package/dist-cjs/gateway-mode.cjs

@@ -0,0 +1,75 @@
+/**
+ * Gateway operational mode (prod vs dev/debug) and default model resolution.
+ */
+import { gatewayLogDebug, withActivityIdentity } from './gateway-log-meta.js';
+export const CODE_DEFAULT_MODEL = 'gpt-5-nano';
+/**
+ * Operational mode: `GatewayConfig.mode` overrides `process.env.mode` / `MODE`.
+ * Only `prod` allows silent default-model substitution; all other values are strict.
+ */
+export function getGatewayOperationalMode(config) {
+    if (config?.mode) {
+        return config.mode;
+    }
+    const raw = (process.env.mode ?? process.env.MODE ?? '').toLowerCase();
+    if (raw === 'prod')
+        return 'prod';
+    if (raw === 'dev')
+        return 'dev';
+    return 'debug';
+}
+export function isProdGatewayMode(mode) {
+    return mode === 'prod';
+}
+/**
+ * Parse `provider/model` or bare model id (OpenRouter ids may contain multiple slashes).
+ */
+export function parseModelProviderSpec(spec) {
+    const trimmed = spec.trim();
+    if (!trimmed) {
+        return { model: CODE_DEFAULT_MODEL };
+    }
+    const slash = trimmed.indexOf('/');
+    if (slash === -1) {
+        return { model: trimmed };
+    }
+    const first = trimmed.slice(0, slash);
+    const rest = trimmed.slice(slash + 1);
+    if (rest.includes('/') && (first === 'openrouter' || first === 'open-router')) {
+        return { provider: 'openrouter', model: trimmed };
+    }
+    return { provider: first, model: rest };
+}
+/**
+ * Default model priority: AI_GATEWAY_DEFAULT_MODEL → model-config.json → code constant.
+ */
+export function resolveGatewayDefaultModel(defaultModelConfig, gatewayDefaultEngine) {
+    const envSpec = process.env.AI_GATEWAY_DEFAULT_MODEL?.trim();
+    if (envSpec) {
+        const parsed = parseModelProviderSpec(envSpec);
+        return { model: parsed.model, provider: parsed.provider, source: 'env' };
+    }
+    const jsonModel = typeof defaultModelConfig?.defaultModel === 'string' ? defaultModelConfig.defaultModel : undefined;
+    if (jsonModel) {
+        const parsed = parseModelProviderSpec(jsonModel);
+        const jsonEngine = typeof defaultModelConfig?.defaultEngine === 'string'
+            ? defaultModelConfig.defaultEngine
+            : gatewayDefaultEngine;
+        return {
+            model: parsed.model,
+            provider: parsed.provider ?? jsonEngine,
+            source: 'model-config.json'
+        };
+    }
+    return {
+        model: CODE_DEFAULT_MODEL,
+        provider: gatewayDefaultEngine,
+        source: 'code'
+    };
+}
+export function warnDefaultModelSubstitution(logger, identity, details) {
+    logger.warn('Gateway substituted default model for request', withActivityIdentity(identity, {
+        ...details,
+        debugKind: gatewayLogDebug.anomaly
+    }));
+}

package/dist-cjs/gateway-mode.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Gateway operational mode (prod vs dev/debug) and default model resolution.
+ */
+import type { Logxer } from '@x12i/logxer';
+import type { ActivityIdentity, GatewayConfig } from './types.js';
+export type GatewayOperationalMode = 'prod' | 'debug' | 'dev';
+export type GatewayDefaultModelSource = 'env' | 'model-config.json' | 'code';
+export type DefaultModelSubstitutionReason = 'no_model_provided' | 'model_resolution_failed' | 'ai_tools_unavailable';
+export declare const CODE_DEFAULT_MODEL = "gpt-5-nano";
+export type ResolvedGatewayDefault = {
+    model: string;
+    provider?: string;
+    source: GatewayDefaultModelSource;
+};
+/**
+ * Operational mode: `GatewayConfig.mode` overrides `process.env.mode` / `MODE`.
+ * Only `prod` allows silent default-model substitution; all other values are strict.
+ */
+export declare function getGatewayOperationalMode(config?: Pick<GatewayConfig, 'mode'>): GatewayOperationalMode;
+export declare function isProdGatewayMode(mode: GatewayOperationalMode): boolean;
+/**
+ * Parse `provider/model` or bare model id (OpenRouter ids may contain multiple slashes).
+ */
+export declare function parseModelProviderSpec(spec: string): {
+    provider?: string;
+    model: string;
+};
+/**
+ * Default model priority: AI_GATEWAY_DEFAULT_MODEL → model-config.json → code constant.
+ */
+export declare function resolveGatewayDefaultModel(defaultModelConfig?: Record<string, unknown>, gatewayDefaultEngine?: string): ResolvedGatewayDefault;
+export declare function warnDefaultModelSubstitution(logger: Logxer, identity: Partial<ActivityIdentity> | undefined, details: {
+    reason: DefaultModelSubstitutionReason;
+    mode: GatewayOperationalMode;
+    defaultSource: GatewayDefaultModelSource;
+    defaultProvider?: string;
+    defaultModel: string;
+    originalProvider?: string;
+    originalModel?: string;
+}): void;

package/dist-cjs/gateway-provider-auto-register.cjs

@@ -1,43 +1,7 @@
-"use strict";
 /**
  * Gateway Provider Auto-Registration Module
  * Automatically registers providers based on environment variables
  */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.autoRegisterProviders = autoRegisterProviders;
 const PROVIDER_CONFIGS = [
     {
         name: 'openai',
@@ -90,7 +54,7 @@ const PROVIDER_CONFIGS = [
  * @param logger - Logger instance
  * @returns Array of provider names that were successfully registered
  */
-async function autoRegisterProviders(router, logger) {
+export async function autoRegisterProviders(router, logger) {
     const registeredProviders = [];
     logger.debug('Auto-registering providers from environment variables');
     for (const providerConfig of PROVIDER_CONFIGS) {
@@ -107,7 +71,7 @@ async function autoRegisterProviders(router, logger) {
             // Use dynamic import() for ES module compatibility
             let ProviderClass;
             try {
-                const providerModule = await Promise.resolve(`${providerConfig.packageName}`).then(s => __importStar(require(s)));
+                const providerModule = await import(providerConfig.packageName);
                 ProviderClass = providerModule[providerConfig.className] || providerModule.default;
                 if (!ProviderClass) {
                     logger.debug(`Provider class ${providerConfig.className} not found in ${providerConfig.packageName}`);