@x12i/ai-gateway 9.2.0 → 9.3.4

package/dist-cjs/gateway.cjs

@@ -1,22 +1,20 @@
-"use strict";
 /**
  * @x12i/ai-gateway
  *
  * Simplified AI Gateway - Clean proxy implementation
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AIGateway = void 0;
-const gateway_validation_js_1 = require("./gateway-validation.cjs");
-const activity_manager_js_1 = require("./activity-manager.cjs");
-const gateway_config_js_1 = require("./gateway-config.cjs");
-const message_builder_js_1 = require("./message-builder.cjs");
-const flex_md_loader_js_1 = require("./flex-md-loader.cjs");
-const output_contract_normalizer_js_1 = require("./output-contract-normalizer.cjs");
-const gateway_utils_js_1 = require("./gateway-utils.cjs");
-const gateway_provider_auto_register_js_1 = require("./gateway-provider-auto-register.cjs");
-const runtime_objects_js_1 = require("./runtime-objects.cjs");
-const gateway_log_meta_js_1 = require("./gateway-log-meta.cjs");
-const gateway_retry_js_1 = require("./gateway-retry.cjs");
+import { validateChatRequest, validateAIRequest } from './gateway-validation.js';
+import { ensureGatewayRequestIdentity } from './activity-manager.js';
+import { initializeGatewayComponents } from './gateway-config.js';
+import { buildMessages } from './message-builder.js';
+import { extractJsonFromFlexMd } from './flex-md-loader.js';
+import { enrichParsedContentForOutputContract, resolveOutputContractFieldKeys } from './output-contract-normalizer.js';
+import { attachGatewayInvokeRejectionMetadata, buildInvokeRejectionMetadata, capActivityFullResponsePayload, DEFAULT_ACTIVITY_FULL_RESPONSE_MAX_CHARS, extractCostUsdFromRouterResponse, extractTokenUsageFromRouterResponse, mergeConfig, pickEffectiveModelConfigForMetadata, pickInvokeRoutingMetadataSlice, pickTraceMergedRouterConfig, resolveCostCompletionWithAiTools, tryExtractRouterLikePayloadFromErrorChain } from './gateway-utils.js';
+import { getAiToolsClient } from './ai-tools-client.js';
+import { autoRegisterProviders } from './gateway-provider-auto-register.js';
+import { setGatewayLastJobId, setGatewayRuntimeClients } from './runtime-objects.js';
+import { gatewayLogDebug, withActivityIdentity } from './gateway-log-meta.js';
+import { invokeWithRetry } from './gateway-retry.js';
 /** Error message thrown by the router when no provider is registered or specified */
 const NO_PROVIDER_ERROR = 'No provider specified and no providers registered';
 const NO_PROVIDER_HINT = ' Set OPEN_ROUTER_KEY (or OPENROUTER_API_KEY) in the environment to use OpenRouter, or register a provider with the router (e.g. via autoRegisterProviders or gateway config).';
@@ -28,7 +26,7 @@ function warnIfSuccessfulInvokeReportsZeroUsageOrCost(logger, identity, meta, in
     const zeroCost = typeof cost === 'number' && cost === 0;
     if (!zeroTokens && !zeroCostUsd && !zeroCost)
         return;
-    logger.warn('Successful provider response reported zero token usage and/or zero cost; verify router adapter usage and billing metadata', (0, gateway_log_meta_js_1.withActivityIdentity)(identity, {
+    logger.warn('Successful provider response reported zero token usage and/or zero cost; verify router adapter usage and billing metadata', withActivityIdentity(identity, {
         invokeKind,
         zeroTokens,
         zeroCostUsd,
@@ -36,28 +34,31 @@ function warnIfSuccessfulInvokeReportsZeroUsageOrCost(logger, identity, meta, in
         tokens,
         costUsd,
         cost,
-        debugKind: gateway_log_meta_js_1.gatewayLogDebug.anomaly
+        debugKind: gatewayLogDebug.anomaly
     }));
 }
 /**
  * Simplified AI Gateway - Clean proxy implementation
  */
-class AIGateway {
+export class AIGateway {
     router;
     config;
     logger;
     activityManager;
     messageBuilderConfig;
+    defaultModelConfig = {};
     _autoRegisterDone = false;
+    _aiToolsClient = null;
     constructor(config = {}, activityManager) {
         this.config = config;
         this.activityManager = activityManager;
-        const components = (0, gateway_config_js_1.initializeGatewayComponents)(config);
+        const components = initializeGatewayComponents(config);
         this.logger = components.logger;
         this.router = components.router;
         this.activityManager = components.activityManager;
         this.messageBuilderConfig = components.messageBuilderConfig;
-        (0, runtime_objects_js_1.setGatewayRuntimeClients)({
+        this.defaultModelConfig = components.defaultModelConfig ?? {};
+        setGatewayRuntimeClients({
             activix: this.activityManager?.getTracker(),
             logger: this.logger
         });
@@ -72,20 +73,24 @@ class AIGateway {
     async invokeChat(request) {
         const startTime = Date.now();
         // Basic validation
-        (0, gateway_validation_js_1.validateChatRequest)(request);
-        (0, activity_manager_js_1.ensureGatewayRequestIdentity)(request, undefined, this.logger);
-        (0, runtime_objects_js_1.setGatewayLastJobId)(resolveRuntimeJobId(request));
+        validateChatRequest(request);
+        ensureGatewayRequestIdentity(request, undefined, this.logger);
+        setGatewayLastJobId(resolveRuntimeJobId(request));
         // Generate simple task type ID
         const taskTypeId = request.taskTypeId || `task-${Date.now()}`;
         // Simple message construction
         const messages = this.buildSimpleMessages(request);
         // Merge config (modelConfig > request.config > gateway defaults)
-        const mergedConfig = await (0, gateway_utils_js_1.mergeConfig)(request, this.config, this.logger);
+        const aiTools = await this.getAiTools();
+        const mergedConfig = await mergeConfig(request, this.config, this.logger, {
+            defaultModelConfig: this.defaultModelConfig,
+            catalog: aiTools?.catalog ?? null
+        });
         // Activix start snapshot must match what the router receives (modelConfig-only callers omit request.config.model).
         request._mergedRouterConfig = mergedConfig;
         // Lazy auto-register providers from env (OPENAI_API_KEY, etc.) so consumers don't have to call init
         if (!this._autoRegisterDone) {
-            await (0, gateway_provider_auto_register_js_1.autoRegisterProviders)(this.router, this.logger);
+            await autoRegisterProviders(this.router, this.logger);
             this._autoRegisterDone = true;
         }
         // Start activity tracking if available
@@ -113,8 +118,12 @@ class AIGateway {
                 mode: 'sync'
             });
             const metaChat = response?.metadata || {};
-            const tokensChat = (0, gateway_utils_js_1.extractTokenUsageFromRouterResponse)(response);
-            const costCompletionChat = (0, gateway_utils_js_1.resolveCostCompletionForActivity)(response, tokensChat);
+            const tokensChat = extractTokenUsageFromRouterResponse(response);
+            const costCompletionChat = await resolveCostCompletionWithAiTools(response, tokensChat, {
+                mergedConfig,
+                calculator: aiTools?.calculator ?? null,
+                calculateCost: this.config.aiTools?.calculateCost
+            });
             // Create enhanced response
             const enhancedResponse = {
                 content: response.content || '',
@@ -133,7 +142,10 @@ class AIGateway {
                                 : { cost: costCompletionChat.cost })
                         }
                         : {}),
-                    ...(costCompletionChat.costStatus ? { costStatus: costCompletionChat.costStatus } : {})
+                    ...(costCompletionChat.costStatus ? { costStatus: costCompletionChat.costStatus } : {}),
+                    ...(costCompletionChat.costBreakdown
+                        ? { costBreakdown: costCompletionChat.costBreakdown }
+                        : {})
                 }
             };
             // Track activity success if activity was started
@@ -175,9 +187,9 @@ class AIGateway {
     async invoke(request) {
         const startTime = Date.now();
         // Basic validation
-        (0, gateway_validation_js_1.validateAIRequest)(request);
-        (0, activity_manager_js_1.ensureGatewayRequestIdentity)(request, undefined, this.logger);
-        (0, runtime_objects_js_1.setGatewayLastJobId)(resolveRuntimeJobId(request));
+        validateAIRequest(request);
+        ensureGatewayRequestIdentity(request, undefined, this.logger);
+        setGatewayLastJobId(resolveRuntimeJobId(request));
         // Generate simple task type ID
         const taskTypeId = request.taskTypeId || `task-${Date.now()}`;
         // Resolve instructions and build messages using proper components
@@ -188,7 +200,7 @@ class AIGateway {
         // Use proper instruction resolution and message building
         let builtMessages;
         try {
-            builtMessages = await (0, message_builder_js_1.buildMessages)(request, this.messageBuilderConfig, {
+            builtMessages = await buildMessages(request, this.messageBuilderConfig, {
                 parsedSnapshot
             });
             messages = builtMessages.messages;
@@ -233,13 +245,13 @@ class AIGateway {
                     failureType: 'validation-failure'
                 }, startTime);
             }
-            const rejectMeta = (0, gateway_utils_js_1.buildInvokeRejectionMetadata)({
+            const rejectMeta = buildInvokeRejectionMetadata({
                 request,
                 taskTypeId,
                 startTime,
                 gatewayAiRequestId: request.aiRequestId
             });
-            (0, gateway_utils_js_1.attachGatewayInvokeRejectionMetadata)(err, rejectMeta);
+            attachGatewayInvokeRejectionMetadata(err, rejectMeta);
             // Re-throw the error so it propagates to the caller
             throw err;
         }
@@ -253,14 +265,18 @@ class AIGateway {
         // Attach parsedSnapshot to request for activity tracking
         request._parsedRequest = parsedSnapshot;
         // Merge config (modelConfig > request.config > gateway defaults)
-        const mergedConfig = await (0, gateway_utils_js_1.mergeConfig)(request, this.config, this.logger);
+        const aiTools = await this.getAiTools();
+        const mergedConfig = await mergeConfig(request, this.config, this.logger, {
+            defaultModelConfig: this.defaultModelConfig,
+            catalog: aiTools?.catalog ?? null
+        });
         request._mergedRouterConfig = mergedConfig;
         const diagnosticsMode = request.diagnostics?.mode;
         const traceEnabled = diagnosticsMode === 'trace';
         const includeRawProviderPayload = request.diagnostics?.includeRawProviderPayload === true;
         // Lazy auto-register providers from env (OPENAI_API_KEY, etc.) so consumers don't have to call init
         if (!this._autoRegisterDone) {
-            await (0, gateway_provider_auto_register_js_1.autoRegisterProviders)(this.router, this.logger);
+            await autoRegisterProviders(this.router, this.logger);
             this._autoRegisterDone = true;
         }
         // Start activity tracking if available
@@ -351,7 +367,7 @@ class AIGateway {
                     // Track per-retry attempt objects through retry hooks.
                     const attemptIndexByRetry = new Map();
                     try {
-                        const result = await (0, gateway_retry_js_1.invokeWithRetry)({
+                        const result = await invokeWithRetry({
                             ...baseRequest,
                             request: {
                                 ...baseRequest.request,
@@ -391,7 +407,7 @@ class AIGateway {
                                 const respAny = tryResp;
                                 if (ok && respAny) {
                                     const meta = respAny.metadata || {};
-                                    const tokenCounts = (0, gateway_utils_js_1.extractTokenUsageFromRouterResponse)(respAny);
+                                    const tokenCounts = extractTokenUsageFromRouterResponse(respAny);
                                     a.usage = {
                                         tokens: tokenCounts,
                                         maxTokensRequested: typeof meta?.maxTokensRequested === 'number'
@@ -420,7 +436,7 @@ class AIGateway {
                                     a.routing.requestIds = requestIds;
                                     a.modelUsed =
                                         meta?.modelUsed || meta?.model || respAny.model || candidate.model;
-                                    const attemptCostUsd = (0, gateway_utils_js_1.extractCostUsdFromRouterResponse)(respAny);
+                                    const attemptCostUsd = extractCostUsdFromRouterResponse(respAny);
                                     if (typeof attemptCostUsd === 'number')
                                         a.costUsd = attemptCostUsd;
                                     if (includeRawProviderPayload) {
@@ -485,35 +501,35 @@ class AIGateway {
             let parsingMethod = undefined;
             // Actually use flex-md parsing - extract structured data from markdown
             try {
-                this.logger.debug('Attempting flex-md extraction', (0, gateway_log_meta_js_1.withActivityIdentity)(request.identity, {
+                this.logger.debug('Attempting flex-md extraction', withActivityIdentity(request.identity, {
                     contentLength: content.length,
                     hasInstructions: !!resolvedRequest.instructions,
-                    debugKind: gateway_log_meta_js_1.gatewayLogDebug.intent
+                    debugKind: gatewayLogDebug.intent
                 }));
                 // Let flex-md extract structured data from the response content
-                const extractionResult = await (0, flex_md_loader_js_1.extractJsonFromFlexMd)(content, this.logger);
-                this.logger.debug('Flex-md extraction result', (0, gateway_log_meta_js_1.withActivityIdentity)(request.identity, {
+                const extractionResult = await extractJsonFromFlexMd(content, this.logger);
+                this.logger.debug('Flex-md extraction result', withActivityIdentity(request.identity, {
                     hasResult: !!extractionResult,
                     hasJson: !!(extractionResult && extractionResult.json),
                     method: extractionResult?.method,
                     jsonType: extractionResult?.json ? typeof extractionResult.json : 'none',
-                    debugKind: gateway_log_meta_js_1.gatewayLogDebug.state
+                    debugKind: gatewayLogDebug.state
                 }));
                 if (extractionResult && extractionResult.json) {
                     // Successfully extracted structured data
                     parsedContent = extractionResult.json;
-                    this.logger.info('Flex-md extraction successful - parsed into structured object', (0, gateway_log_meta_js_1.withActivityIdentity)(request.identity, {
+                    this.logger.info('Flex-md extraction successful - parsed into structured object', withActivityIdentity(request.identity, {
                         method: extractionResult.method,
                         extractedKeys: Object.keys(extractionResult.json),
-                        debugKind: gateway_log_meta_js_1.gatewayLogDebug.event
+                        debugKind: gatewayLogDebug.event
                     }));
                 }
                 else {
                     // Extraction failed, fall back to raw text wrapper
-                    this.logger.warn('Flex-md extraction failed - no structured data extracted', (0, gateway_log_meta_js_1.withActivityIdentity)(request.identity, {
+                    this.logger.warn('Flex-md extraction failed - no structured data extracted', withActivityIdentity(request.identity, {
                         hasResult: !!extractionResult,
                         method: extractionResult?.method || 'none',
-                        debugKind: gateway_log_meta_js_1.gatewayLogDebug.anomaly
+                        debugKind: gatewayLogDebug.anomaly
                     }));
                     parsedContent = { rawText: content };
                 }
@@ -521,32 +537,36 @@ class AIGateway {
             catch (extractionError) {
                 // Extraction failed, fall back to raw text wrapper
                 const errorMessage = extractionError instanceof Error ? extractionError.message : String(extractionError);
-                this.logger.warn('Flex-md extraction failed - flex-md library compatibility issue', (0, gateway_log_meta_js_1.withActivityIdentity)(request.identity, {
+                this.logger.warn('Flex-md extraction failed - flex-md library compatibility issue', withActivityIdentity(request.identity, {
                     error: errorMessage,
                     issue: 'flex-md uses require() in ES module context - needs fixing in flex-md-loader.ts',
                     fallback: 'using rawText wrapper',
-                    debugKind: gateway_log_meta_js_1.gatewayLogDebug.anomaly
+                    debugKind: gatewayLogDebug.anomaly
                 }));
                 parsedContent = { rawText: content };
             }
             contentType = 'structured';
             parsingMethod = 'flex-md';
-            const outputContractKeys = (0, output_contract_normalizer_js_1.resolveOutputContractFieldKeys)(request);
-            parsedContent = await (0, output_contract_normalizer_js_1.enrichParsedContentForOutputContract)(parsedContent, content, outputContractKeys, this.logger);
-            let tokens = (0, gateway_utils_js_1.extractTokenUsageFromRouterResponse)(routerResponse);
+            const outputContractKeys = resolveOutputContractFieldKeys(request);
+            parsedContent = await enrichParsedContentForOutputContract(parsedContent, content, outputContractKeys, this.logger);
+            let tokens = extractTokenUsageFromRouterResponse(routerResponse);
             if (!(tokens.prompt || tokens.completion || tokens.total)) {
                 const alt = routerResponse?.rawResponse ?? routerResponse?.raw;
                 if (alt != null && typeof alt === 'object' && alt !== routerResponse) {
-                    const second = (0, gateway_utils_js_1.extractTokenUsageFromRouterResponse)(alt);
+                    const second = extractTokenUsageFromRouterResponse(alt);
                     if (second.prompt || second.completion || second.total)
                         tokens = second;
                 }
             }
-            const costCompletion = (0, gateway_utils_js_1.resolveCostCompletionForActivity)(routerResponse, tokens);
+            const costCompletion = await resolveCostCompletionWithAiTools(routerResponse, tokens, {
+                mergedConfig,
+                calculator: aiTools?.calculator ?? null,
+                calculateCost: this.config.aiTools?.calculateCost
+            });
             const routerMetaForCost = routerResponse?.metadata || {};
-            const routingMetadataSlice = (0, gateway_utils_js_1.pickInvokeRoutingMetadataSlice)(routerResponse, mergedConfig);
-            const effectiveModelConfig = (0, gateway_utils_js_1.pickEffectiveModelConfigForMetadata)(mergedConfig);
-            const traceMergedRouterSnapshot = traceEnabled ? (0, gateway_utils_js_1.pickTraceMergedRouterConfig)(mergedConfig) : undefined;
+            const routingMetadataSlice = pickInvokeRoutingMetadataSlice(routerResponse, mergedConfig);
+            const effectiveModelConfig = pickEffectiveModelConfigForMetadata(mergedConfig);
+            const traceMergedRouterSnapshot = traceEnabled ? pickTraceMergedRouterConfig(mergedConfig) : undefined;
             const enhancedResponse = {
                 content: content,
                 parsedContent: parsedContent,
@@ -570,6 +590,7 @@ class AIGateway {
                         }
                         : {}),
                     ...(costCompletion.costStatus ? { costStatus: costCompletion.costStatus } : {}),
+                    ...(costCompletion.costBreakdown ? { costBreakdown: costCompletion.costBreakdown } : {}),
                     ...(traceEnabled
                         ? {
                             requestIds: traceRequestIds,
@@ -590,10 +611,10 @@ class AIGateway {
                     const includeFullProviderBlob = diag?.includeFullProviderResponseInActivity !== false;
                     const maxFullChars = typeof diag?.activityFullResponseMaxChars === 'number' && diag.activityFullResponseMaxChars > 0
                         ? diag.activityFullResponseMaxChars
-                        : gateway_utils_js_1.DEFAULT_ACTIVITY_FULL_RESPONSE_MAX_CHARS;
+                        : DEFAULT_ACTIVITY_FULL_RESPONSE_MAX_CHARS;
                     const rawFull = routerResponse.rawResponse || routerResponse;
                     const fullResponseForActivity = includeFullProviderBlob
-                        ? (0, gateway_utils_js_1.capActivityFullResponsePayload)(rawFull, maxFullChars)
+                        ? capActivityFullResponsePayload(rawFull, maxFullChars)
                         : undefined;
                     // Create activity response with proper structure for ActivityTracker
                     const activityResponse = {
@@ -627,17 +648,17 @@ class AIGateway {
                 costUsd: enhancedResponse.metadata.costUsd,
                 cost: enhancedResponse.metadata.cost
             }, 'invoke');
-            this.logger.debug('gateway: enhancedResponse', (0, gateway_log_meta_js_1.withActivityIdentity)(request.identity, {
+            this.logger.debug('gateway: enhancedResponse', withActivityIdentity(request.identity, {
                 latencyMs: enhancedResponse.metadata?.latencyMs,
                 contentType: enhancedResponse.metadata?.contentType,
-                debugKind: gateway_log_meta_js_1.gatewayLogDebug.state
+                debugKind: gatewayLogDebug.state
             }));
             return enhancedResponse;
         }
         catch (error) {
             const err = error instanceof Error ? error : new Error(String(error));
-            const partial = (0, gateway_utils_js_1.tryExtractRouterLikePayloadFromErrorChain)(err);
-            const rejectMeta = (0, gateway_utils_js_1.buildInvokeRejectionMetadata)({
+            const partial = tryExtractRouterLikePayloadFromErrorChain(err);
+            const rejectMeta = buildInvokeRejectionMetadata({
                 request,
                 taskTypeId,
                 startTime,
@@ -645,11 +666,11 @@ class AIGateway {
                 partialRouterPayload: partial,
                 gatewayAiRequestId: request.aiRequestId
             });
-            (0, gateway_utils_js_1.attachGatewayInvokeRejectionMetadata)(err, rejectMeta);
+            attachGatewayInvokeRejectionMetadata(err, rejectMeta);
             if (err.message.includes(NO_PROVIDER_ERROR)) {
                 const wrapped = new Error(err.message + NO_PROVIDER_HINT);
                 wrapped.cause = err;
-                (0, gateway_utils_js_1.attachGatewayInvokeRejectionMetadata)(wrapped, rejectMeta);
+                attachGatewayInvokeRejectionMetadata(wrapped, rejectMeta);
                 throw wrapped;
             }
             throw err;
@@ -705,13 +726,16 @@ class AIGateway {
     }
     setActivityManager(activityManager) {
         this.activityManager = activityManager;
-        (0, runtime_objects_js_1.setGatewayRuntimeClients)({
+        setGatewayRuntimeClients({
             activix: this.activityManager.getTracker(),
             logger: this.logger
         });
     }
+    getAiTools() {
+        this._aiToolsClient ??= getAiToolsClient(this.config, this.logger);
+        return this._aiToolsClient;
+    }
 }
-exports.AIGateway = AIGateway;
 function resolveRuntimeJobId(request) {
     return request.identity.jobId || request.identity.sessionId || request.aiRequestId;
 }

package/dist-cjs/gateway.d.ts

@@ -16,7 +16,9 @@ export declare class AIGateway {
     private logger;
     private activityManager?;
     private messageBuilderConfig?;
+    private defaultModelConfig;
     private _autoRegisterDone;
+    private _aiToolsClient;
     constructor(config?: GatewayConfig, activityManager?: ActivityManager);
     /**
      * Invoke chat request (without structured output requirements)
@@ -36,4 +38,5 @@ export declare class AIGateway {
     getLogger(): Logxer;
     getActivityManager(): ActivityManager | undefined;
     setActivityManager(activityManager: ActivityManager): void;
+    private getAiTools;
 }

package/dist-cjs/index.cjs

@@ -1,4 +1,3 @@
-"use strict";
 /**
  * @x12i/ai-gateway
  *
@@ -6,117 +5,42 @@
  * This package exposes all functionality from @x12i/ai-providers-router
  * with enhanced features: context propagation, usage tier tracking, and comprehensive metadata.
  */
-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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createValidationTestCases = exports.createTestAIRequest = exports.supportsJSONMode = exports.diagnoseResponse = exports.diagnoseRequest = exports.validateResponse = exports.extractJSON = exports.validateJSON = exports.validateAIRequest = exports.DEFAULT_RATE_LIMIT_ENABLED = exports.DEFAULT_RATE_LIMIT_MIN_INTERVAL_MS = exports.GatewayRateLimiter = exports.runtimeObjects = exports.DebugLogAbstract = exports.createLogxer = exports.gatewayLogDebug = exports.withActivityIdentity = exports.activityIdentityToLogMeta = exports.ensureGatewayRequestIdentity = exports.ActivityManager = exports.Activix = exports.resolveGatewayMemoryPathValue = exports.prepareWorkingMemoryForTemplateRender = exports.parseLooseJsonObject = exports.mapSmartInputPathsInputsToInput = exports.extractCallerInputsBag = exports.coalesceMergedInputBucket = exports.buildMemoryResolutionRootFromWorkingMemory = exports.GATEWAY_DUAL_MEMORY_ROOTS = exports.mergeTemplateRenderOptions = exports.mergeGatewayAndRequestTemplateRenderOptions = exports.resolveOutputContractFieldKeys = exports.enrichParsedContentForOutputContract = exports.contractSpecToFieldKeys = exports.hasNonZeroTokenUsage = exports.resolveCostCompletionForActivity = exports.resolveActivityCostCompletion = exports.pickRequestIdsFromRouterLike = exports.tryExtractRouterLikePayloadFromErrorChain = exports.buildInvokeRejectionMetadata = exports.attachGatewayInvokeRejectionMetadata = exports.autoRegisterProviders = exports.InstructionBackendError = exports.InstructionNotFoundError = exports.AIGateway = exports.FallbackExhaustedError = exports.ProviderNotFoundError = exports.createRouterFromConfig = exports.createRouter = exports.LLMProviderRouter = void 0;
-exports.resetObjectTypesLibrary = exports.getObjectTypesLibrary = exports.initializeObjectTypesLibrary = exports.getObjectTypesForAgent = exports.getObjectType = exports.OBJECT_TYPES_LIBRARY = exports.assertValidAIRequest = exports.formatDiagnostic = exports.runValidationTests = void 0;
 // Re-export router class and types (base functionality)
-var ai_providers_router_1 = require("@x12i/ai-providers-router");
-Object.defineProperty(exports, "LLMProviderRouter", { enumerable: true, get: function () { return ai_providers_router_1.LLMProviderRouter; } });
+export { LLMProviderRouter } from '@x12i/ai-providers-router';
 // Re-export factory functions
-var ai_providers_router_2 = require("@x12i/ai-providers-router");
-Object.defineProperty(exports, "createRouter", { enumerable: true, get: function () { return ai_providers_router_2.createRouter; } });
-Object.defineProperty(exports, "createRouterFromConfig", { enumerable: true, get: function () { return ai_providers_router_2.createRouterFromConfig; } });
+export { createRouter, createRouterFromConfig } from '@x12i/ai-providers-router';
 // Re-export error classes
-var ai_providers_router_3 = require("@x12i/ai-providers-router");
-Object.defineProperty(exports, "ProviderNotFoundError", { enumerable: true, get: function () { return ai_providers_router_3.ProviderNotFoundError; } });
-Object.defineProperty(exports, "FallbackExhaustedError", { enumerable: true, get: function () { return ai_providers_router_3.FallbackExhaustedError; } });
+export { ProviderNotFoundError, FallbackExhaustedError } from '@x12i/ai-providers-router';
 // Re-export all from router (includes everything it exports)
-__exportStar(require("@x12i/ai-providers-router"), exports);
+export * from '@x12i/ai-providers-router';
 // Export enhanced gateway
-var gateway_js_1 = require("./gateway.cjs");
-Object.defineProperty(exports, "AIGateway", { enumerable: true, get: function () { return gateway_js_1.AIGateway; } });
-var instruction_errors_js_1 = require("./instruction-errors.cjs");
-Object.defineProperty(exports, "InstructionNotFoundError", { enumerable: true, get: function () { return instruction_errors_js_1.InstructionNotFoundError; } });
-Object.defineProperty(exports, "InstructionBackendError", { enumerable: true, get: function () { return instruction_errors_js_1.InstructionBackendError; } });
-var gateway_provider_auto_register_js_1 = require("./gateway-provider-auto-register.cjs");
-Object.defineProperty(exports, "autoRegisterProviders", { enumerable: true, get: function () { return gateway_provider_auto_register_js_1.autoRegisterProviders; } });
-var gateway_utils_js_1 = require("./gateway-utils.cjs");
-Object.defineProperty(exports, "attachGatewayInvokeRejectionMetadata", { enumerable: true, get: function () { return gateway_utils_js_1.attachGatewayInvokeRejectionMetadata; } });
-Object.defineProperty(exports, "buildInvokeRejectionMetadata", { enumerable: true, get: function () { return gateway_utils_js_1.buildInvokeRejectionMetadata; } });
-Object.defineProperty(exports, "tryExtractRouterLikePayloadFromErrorChain", { enumerable: true, get: function () { return gateway_utils_js_1.tryExtractRouterLikePayloadFromErrorChain; } });
-Object.defineProperty(exports, "pickRequestIdsFromRouterLike", { enumerable: true, get: function () { return gateway_utils_js_1.pickRequestIdsFromRouterLike; } });
-Object.defineProperty(exports, "resolveActivityCostCompletion", { enumerable: true, get: function () { return gateway_utils_js_1.resolveActivityCostCompletion; } });
-Object.defineProperty(exports, "resolveCostCompletionForActivity", { enumerable: true, get: function () { return gateway_utils_js_1.resolveCostCompletionForActivity; } });
-Object.defineProperty(exports, "hasNonZeroTokenUsage", { enumerable: true, get: function () { return gateway_utils_js_1.hasNonZeroTokenUsage; } });
-var output_contract_normalizer_js_1 = require("./output-contract-normalizer.cjs");
-Object.defineProperty(exports, "contractSpecToFieldKeys", { enumerable: true, get: function () { return output_contract_normalizer_js_1.contractSpecToFieldKeys; } });
-Object.defineProperty(exports, "enrichParsedContentForOutputContract", { enumerable: true, get: function () { return output_contract_normalizer_js_1.enrichParsedContentForOutputContract; } });
-Object.defineProperty(exports, "resolveOutputContractFieldKeys", { enumerable: true, get: function () { return output_contract_normalizer_js_1.resolveOutputContractFieldKeys; } });
-var template_render_merge_js_1 = require("./template-render-merge.cjs");
-Object.defineProperty(exports, "mergeGatewayAndRequestTemplateRenderOptions", { enumerable: true, get: function () { return template_render_merge_js_1.mergeGatewayAndRequestTemplateRenderOptions; } });
-Object.defineProperty(exports, "mergeTemplateRenderOptions", { enumerable: true, get: function () { return template_render_merge_js_1.mergeTemplateRenderOptions; } });
-var memory_path_resolution_js_1 = require("./memory-path-resolution.cjs");
-Object.defineProperty(exports, "GATEWAY_DUAL_MEMORY_ROOTS", { enumerable: true, get: function () { return memory_path_resolution_js_1.GATEWAY_DUAL_MEMORY_ROOTS; } });
-Object.defineProperty(exports, "buildMemoryResolutionRootFromWorkingMemory", { enumerable: true, get: function () { return memory_path_resolution_js_1.buildMemoryResolutionRootFromWorkingMemory; } });
-Object.defineProperty(exports, "coalesceMergedInputBucket", { enumerable: true, get: function () { return memory_path_resolution_js_1.coalesceMergedInputBucket; } });
-Object.defineProperty(exports, "extractCallerInputsBag", { enumerable: true, get: function () { return memory_path_resolution_js_1.extractCallerInputsBag; } });
-Object.defineProperty(exports, "mapSmartInputPathsInputsToInput", { enumerable: true, get: function () { return memory_path_resolution_js_1.mapSmartInputPathsInputsToInput; } });
-Object.defineProperty(exports, "parseLooseJsonObject", { enumerable: true, get: function () { return memory_path_resolution_js_1.parseLooseJsonObject; } });
-Object.defineProperty(exports, "prepareWorkingMemoryForTemplateRender", { enumerable: true, get: function () { return memory_path_resolution_js_1.prepareWorkingMemoryForTemplateRender; } });
-Object.defineProperty(exports, "resolveGatewayMemoryPathValue", { enumerable: true, get: function () { return memory_path_resolution_js_1.resolveGatewayMemoryPathValue; } });
+export { AIGateway } from './gateway.js';
+export { InstructionNotFoundError, InstructionBackendError } from './instruction-errors.js';
+export { autoRegisterProviders } from './gateway-provider-auto-register.js';
+export { attachGatewayInvokeRejectionMetadata, buildInvokeRejectionMetadata, tryExtractRouterLikePayloadFromErrorChain, pickRequestIdsFromRouterLike, resolveActivityCostCompletion, resolveCostCompletionForActivity, resolveCostCompletionWithAiTools, hasNonZeroTokenUsage } from './gateway-utils.js';
+export { getGatewayOperationalMode, isProdGatewayMode, resolveGatewayDefaultModel, parseModelProviderSpec, CODE_DEFAULT_MODEL } from './gateway-mode.js';
+export { contractSpecToFieldKeys, enrichParsedContentForOutputContract, resolveOutputContractFieldKeys } from './output-contract-normalizer.js';
+export { mergeGatewayAndRequestTemplateRenderOptions, mergeTemplateRenderOptions } from './template-render-merge.js';
+export { GATEWAY_DUAL_MEMORY_ROOTS, buildMemoryResolutionRootFromWorkingMemory, coalesceMergedInputBucket, extractCallerInputsBag, mapSmartInputPathsInputsToInput, parseLooseJsonObject, prepareWorkingMemoryForTemplateRender, resolveGatewayMemoryPathValue } from './memory-path-resolution.js';
 // Usage tracking: UsageTracker class methods are available but consumption calculation is disabled
 // (x-models was previously used for RPM/TPM tracking but is no longer integrated)
 // Re-export activity tracking primitives (Activix)
-var activix_1 = require("@x12i/activix");
-Object.defineProperty(exports, "Activix", { enumerable: true, get: function () { return activix_1.Activix; } });
-var activity_manager_js_1 = require("./activity-manager.cjs");
-Object.defineProperty(exports, "ActivityManager", { enumerable: true, get: function () { return activity_manager_js_1.ActivityManager; } });
-Object.defineProperty(exports, "ensureGatewayRequestIdentity", { enumerable: true, get: function () { return activity_manager_js_1.ensureGatewayRequestIdentity; } });
-var gateway_log_meta_js_1 = require("./gateway-log-meta.cjs");
-Object.defineProperty(exports, "activityIdentityToLogMeta", { enumerable: true, get: function () { return gateway_log_meta_js_1.activityIdentityToLogMeta; } });
-Object.defineProperty(exports, "withActivityIdentity", { enumerable: true, get: function () { return gateway_log_meta_js_1.withActivityIdentity; } });
-Object.defineProperty(exports, "gatewayLogDebug", { enumerable: true, get: function () { return gateway_log_meta_js_1.gatewayLogDebug; } });
+export { Activix } from '@x12i/activix';
+export { ActivityManager, ensureGatewayRequestIdentity } from './activity-manager.js';
+export { activityIdentityToLogMeta, withActivityIdentity, gatewayLogDebug } from './gateway-log-meta.js';
 // Re-export logging (@x12i/logxer)
-var logxer_1 = require("@x12i/logxer");
-Object.defineProperty(exports, "createLogxer", { enumerable: true, get: function () { return logxer_1.createLogxer; } });
-Object.defineProperty(exports, "DebugLogAbstract", { enumerable: true, get: function () { return logxer_1.DebugLogAbstract; } });
+export { createLogxer, DebugLogAbstract } from '@x12i/logxer';
 // Runtime observability surface (leaf package: no downstream runtime objects)
-var runtime_objects_js_1 = require("./runtime-objects.cjs");
-Object.defineProperty(exports, "runtimeObjects", { enumerable: true, get: function () { return runtime_objects_js_1.runtimeObjects; } });
+export { runtimeObjects } from './runtime-objects.js';
 // Export rate limiter
-var gateway_rate_limiter_js_1 = require("./gateway-rate-limiter.cjs");
-Object.defineProperty(exports, "GatewayRateLimiter", { enumerable: true, get: function () { return gateway_rate_limiter_js_1.GatewayRateLimiter; } });
-var gateway_rate_limiter_constants_js_1 = require("./gateway-rate-limiter-constants.cjs");
-Object.defineProperty(exports, "DEFAULT_RATE_LIMIT_MIN_INTERVAL_MS", { enumerable: true, get: function () { return gateway_rate_limiter_constants_js_1.DEFAULT_RATE_LIMIT_MIN_INTERVAL_MS; } });
-Object.defineProperty(exports, "DEFAULT_RATE_LIMIT_ENABLED", { enumerable: true, get: function () { return gateway_rate_limiter_constants_js_1.DEFAULT_RATE_LIMIT_ENABLED; } });
+export { GatewayRateLimiter } from './gateway-rate-limiter.js';
+export { DEFAULT_RATE_LIMIT_MIN_INTERVAL_MS, DEFAULT_RATE_LIMIT_ENABLED } from './gateway-rate-limiter-constants.js';
 // Export troubleshooting helpers
-var troubleshooting_helper_js_1 = require("./troubleshooting-helper.cjs");
-Object.defineProperty(exports, "validateAIRequest", { enumerable: true, get: function () { return troubleshooting_helper_js_1.validateAIRequest; } });
-Object.defineProperty(exports, "validateJSON", { enumerable: true, get: function () { return troubleshooting_helper_js_1.validateJSON; } });
-Object.defineProperty(exports, "extractJSON", { enumerable: true, get: function () { return troubleshooting_helper_js_1.extractJSON; } });
-Object.defineProperty(exports, "validateResponse", { enumerable: true, get: function () { return troubleshooting_helper_js_1.validateResponse; } });
-Object.defineProperty(exports, "diagnoseRequest", { enumerable: true, get: function () { return troubleshooting_helper_js_1.diagnoseRequest; } });
-Object.defineProperty(exports, "diagnoseResponse", { enumerable: true, get: function () { return troubleshooting_helper_js_1.diagnoseResponse; } });
-Object.defineProperty(exports, "supportsJSONMode", { enumerable: true, get: function () { return troubleshooting_helper_js_1.supportsJSONMode; } });
-Object.defineProperty(exports, "createTestAIRequest", { enumerable: true, get: function () { return troubleshooting_helper_js_1.createTestAIRequest; } });
-Object.defineProperty(exports, "createValidationTestCases", { enumerable: true, get: function () { return troubleshooting_helper_js_1.createValidationTestCases; } });
-Object.defineProperty(exports, "runValidationTests", { enumerable: true, get: function () { return troubleshooting_helper_js_1.runValidationTests; } });
-Object.defineProperty(exports, "formatDiagnostic", { enumerable: true, get: function () { return troubleshooting_helper_js_1.formatDiagnostic; } });
-Object.defineProperty(exports, "assertValidAIRequest", { enumerable: true, get: function () { return troubleshooting_helper_js_1.assertValidAIRequest; } });
+export { validateAIRequest, validateJSON, extractJSON, validateResponse, diagnoseRequest, diagnoseResponse, supportsJSONMode, createTestAIRequest, createValidationTestCases, runValidationTests, formatDiagnostic, assertValidAIRequest } from './troubleshooting-helper.js';
 // Export object types library
-var object_types_library_js_1 = require("./object-types-library.cjs");
-Object.defineProperty(exports, "OBJECT_TYPES_LIBRARY", { enumerable: true, get: function () { return object_types_library_js_1.OBJECT_TYPES_LIBRARY; } });
-Object.defineProperty(exports, "getObjectType", { enumerable: true, get: function () { return object_types_library_js_1.getObjectType; } });
-Object.defineProperty(exports, "getObjectTypesForAgent", { enumerable: true, get: function () { return object_types_library_js_1.getObjectTypesForAgent; } });
+export { OBJECT_TYPES_LIBRARY, getObjectType, getObjectTypesForAgent } from './object-types-library.js';
 // Re-export outputs library integration functions
-var object_types_library_integration_js_1 = require("./object-types-library-integration.cjs");
-Object.defineProperty(exports, "initializeObjectTypesLibrary", { enumerable: true, get: function () { return object_types_library_integration_js_1.initializeObjectTypesLibrary; } });
-Object.defineProperty(exports, "getObjectTypesLibrary", { enumerable: true, get: function () { return object_types_library_integration_js_1.getObjectTypesLibrary; } });
-Object.defineProperty(exports, "resetObjectTypesLibrary", { enumerable: true, get: function () { return object_types_library_integration_js_1.resetObjectTypesLibrary; } });
+export { initializeObjectTypesLibrary, getObjectTypesLibrary, resetObjectTypesLibrary } from './object-types-library-integration.js';
 // Re-export outputs library types and utilities for convenience
 // Note: Since we use dynamic imports for the outputs library, these types may not be available
 // at compile time if the package isn't installed. Users can import directly from

package/dist-cjs/index.d.ts

@@ -17,7 +17,9 @@ export { AIGateway } from './gateway.js';
 export { InstructionNotFoundError, InstructionBackendError } from './instruction-errors.js';
 export { autoRegisterProviders } from './gateway-provider-auto-register.js';
 export type { GatewayConfig, ProviderModelRef, ModelConfig, RetryConfig, ChatRequest, AIInvokeRequest, AIRequest, GatewayActionType, GatewayInvokeRejectionMetadata, GatewayTraceRequestIds, GatewayTraceMergedConfig, EnhancedLLMResponse, InstructionMetadata, ValidationRule, TemplateRenderOptions, SmartInputConfig, SmartInputRenderOptions } from './types.js';
-export { attachGatewayInvokeRejectionMetadata, buildInvokeRejectionMetadata, tryExtractRouterLikePayloadFromErrorChain, pickRequestIdsFromRouterLike, resolveActivityCostCompletion, resolveCostCompletionForActivity, hasNonZeroTokenUsage } from './gateway-utils.js';
+export { attachGatewayInvokeRejectionMetadata, buildInvokeRejectionMetadata, tryExtractRouterLikePayloadFromErrorChain, pickRequestIdsFromRouterLike, resolveActivityCostCompletion, resolveCostCompletionForActivity, resolveCostCompletionWithAiTools, hasNonZeroTokenUsage } from './gateway-utils.js';
+export { getGatewayOperationalMode, isProdGatewayMode, resolveGatewayDefaultModel, parseModelProviderSpec, CODE_DEFAULT_MODEL } from './gateway-mode.js';
+export type { GatewayOperationalMode, GatewayDefaultModelSource, DefaultModelSubstitutionReason, ResolvedGatewayDefault } from './gateway-mode.js';
 export type { ActivityCostStatus, ResolvedActivityCost } from './gateway-utils.js';
 export { contractSpecToFieldKeys, enrichParsedContentForOutputContract, resolveOutputContractFieldKeys } from './output-contract-normalizer.js';
 export type { OutputContractSpec } from './output-contract-normalizer.js';

package/dist-cjs/instruction-errors.cjs

@@ -1,10 +1,7 @@
-"use strict";
 /**
  * Errors for instruction / prompt template and instructions-block resolution.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.InstructionBackendError = exports.InstructionNotFoundError = void 0;
-class InstructionNotFoundError extends Error {
+export class InstructionNotFoundError extends Error {
     key;
     backend;
     originalKey;
@@ -16,8 +13,7 @@ class InstructionNotFoundError extends Error {
         this.name = 'InstructionNotFoundError';
     }
 }
-exports.InstructionNotFoundError = InstructionNotFoundError;
-class InstructionBackendError extends Error {
+export class InstructionBackendError extends Error {
     key;
     backend;
     isRetryable;
@@ -31,4 +27,3 @@ class InstructionBackendError extends Error {
         this.name = 'InstructionBackendError';
     }
 }
-exports.InstructionBackendError = InstructionBackendError;