@x12i/ai-gateway 9.1.2 → 9.1.5

package/README.md

@@ -789,7 +789,9 @@ const response = await gateway.invoke({
 
 - **`GatewayConfig.templateRendering`** — default `TemplateRenderOptions` for every `invoke()` render path (merged after packaged **`src/defaults/template-rendering.json`**, which ships with **`subPathSearch.enabled: false`**). Your gateway config overrides that JSON.
 - **`templateRenderOptions` on the request** (`ChatRequest` / `AIInvokeRequest`) — merged on top of the gateway default for that call only (per-field override; `subPathSearch` fields merge with request winning).
-- Supported fields match the parser: **`templateId`**, **`subPathSearch`** (`enabled`, `roots`), **`silentMissingMustTokens`** (legacy Handlebars-style silence for missing MUST paths).
+- **Smart Input (optional shorthand on the request)** — top-level **`smartInput`** (`SmartInputConfig`) and **`smartInputRenderOptions`** (`SmartInputRenderOptions`) are merged into the same Rendrix options object **after** `GatewayConfig.templateRendering` and **before** `templateRenderOptions`. If you set the same field both as a shorthand and inside **`templateRenderOptions`**, the nested **`templateRenderOptions`** value wins. Templates use the **`{{smartInput}}`** insertion macro (see **`@x12i/rendrix`**). Types **`SmartInputConfig`** and **`SmartInputRenderOptions`** are re-exported from this package.
+- For programmatic merges (tests or wrappers), use **`mergeGatewayAndRequestTemplateRenderOptions`** (same rules as `buildMessages`).
+- Supported fields match the parser: **`templateId`**, **`subPathSearch`** (`enabled`, `roots`), **`silentMissingMustTokens`** (legacy Handlebars-style silence for missing MUST paths), **`smartInput`**, **`smartInputRenderOptions`**.
 - **Sub-path root priority:** `subPathSearch.roots` is an **ordered** list. The parser tries roots in **array order**; **the first root that resolves the leaf path wins** (see ISSUE-005). There is no separate “priority” field—the order of `roots` *is* the priority. Omit `roots` when `enabled` is true to use **`@x12i/rendrix`** packaged defaults.
 
 ```typescript

package/dist/activity-manager.js

@@ -133,6 +133,30 @@ function logUpstreamIdentityWarnings(logger, incomingIdentity, merged) {
         }));
     }
 }
+/** Routing / generation facts from gateway response metadata for Activix `outer.metadata` on completion. */
+function pickActivixCompletionRoutingMetadata(response) {
+    if (response == null || typeof response !== 'object')
+        return {};
+    const meta = response.metadata;
+    if (meta == null || typeof meta !== 'object')
+        return {};
+    const m = meta;
+    const out = {};
+    if (typeof m.modelUsed === 'string')
+        out.modelUsed = m.modelUsed;
+    if (typeof m.model === 'string')
+        out.model = m.model;
+    if (typeof m.provider === 'string')
+        out.provider = m.provider;
+    if (typeof m.maxTokensRequested === 'number')
+        out.maxTokensRequested = m.maxTokensRequested;
+    if (typeof m.region === 'string')
+        out.region = m.region;
+    if (m.effectiveModelConfig != null && typeof m.effectiveModelConfig === 'object') {
+        out.effectiveModelConfig = m.effectiveModelConfig;
+    }
+    return out;
+}
 function mergeGatewayActivityIdentity(request, aiRequestId, extras) {
     const incomingIdentity = request.identity;
     const sessionId = resolveSessionIdForRequest(request, incomingIdentity, aiRequestId);
@@ -388,33 +412,37 @@ export class ActivityManager {
             // - provider, model, temperature, maxTokens → only in config object
             // - NO response, endTime, duration (these are added via logSuccess)
         };
-        // Config snapshot
-        // CRITICAL: This captures the exact config sent to the router (finalRouterConfig)
-        // This ensures activity records show the actual config that was sent, including that response_format was removed
-        if (request.config !== undefined) {
-            // Verify response_format is not present (for debugging)
-            const hasResponseFormat = 'responseFormat' in request.config || 'response_format' in request.config;
+        // Config snapshot — prefer gateway merge output (`_mergedRouterConfig`) over raw `request.config`.
+        // Callers often put model only on `modelConfig`; merge happens in `mergeConfig()` before `router.invoke`.
+        const mergedRouterConfig = request._mergedRouterConfig;
+        const configSource = mergedRouterConfig != null && typeof mergedRouterConfig === 'object'
+            ? mergedRouterConfig
+            : request.config;
+        // CRITICAL: Capture the exact config sent to the router (finalRouterConfig)
+        if (configSource !== undefined) {
+            const hasResponseFormat = 'responseFormat' in configSource || 'response_format' in configSource;
             if (hasResponseFormat) {
                 this.logger.warn('Activity tracking received config with response_format - this should not happen', {
                     aiRequestId,
-                    hasResponseFormat: 'responseFormat' in request.config,
-                    hasResponse_format: 'response_format' in request.config,
-                    configKeys: Object.keys(request.config)
+                    hasResponseFormat: 'responseFormat' in configSource,
+                    hasResponse_format: 'response_format' in configSource,
+                    configKeys: Object.keys(configSource)
                 });
             }
             activityMetadata.config = {
-                model: request.config.model,
-                provider: request.config.provider || null, // Ensure provider is captured (may be null if not set)
-                temperature: request.config.temperature,
-                maxTokens: request.config.maxTokens,
-                rawConfig: request.config // ✅ Captures finalRouterConfig (exact config sent to router)
+                model: configSource.model,
+                provider: configSource.provider || null,
+                temperature: configSource.temperature,
+                maxTokens: configSource.maxTokens,
+                rawConfig: configSource
             };
             this.logger.debug('Activity tracking config captured', {
                 aiRequestId,
-                model: request.config.model,
-                provider: request.config.provider,
-                hasResponseFormat: hasResponseFormat,
-                rawConfigKeys: Object.keys(request.config).slice(0, 10)
+                model: configSource.model,
+                provider: configSource.provider,
+                configSource: mergedRouterConfig != null ? '_mergedRouterConfig' : 'request.config',
+                hasResponseFormat,
+                rawConfigKeys: Object.keys(configSource).slice(0, 10)
             });
         }
         // Build request object snapshots (raw = incoming; parsed = constructed messages/meta)
@@ -605,14 +633,17 @@ export class ActivityManager {
             ...(aiRequest.masterSkillActivityId && { masterSkillActivityId: aiRequest.masterSkillActivityId }),
             ...(aiRequest.masterSkillId && { masterSkillId: aiRequest.masterSkillId })
         };
-        // Config snapshot (same as startActivity)
-        if (request.config !== undefined) {
+        const mergedRouterConfigSkill = request._mergedRouterConfig;
+        const configSourceSkill = mergedRouterConfigSkill != null && typeof mergedRouterConfigSkill === 'object'
+            ? mergedRouterConfigSkill
+            : request.config;
+        if (configSourceSkill !== undefined) {
             activityMetadata.config = {
-                model: request.config.model,
-                provider: request.config.provider || null,
-                temperature: request.config.temperature,
-                maxTokens: request.config.maxTokens,
-                rawConfig: request.config
+                model: configSourceSkill.model,
+                provider: configSourceSkill.provider || null,
+                temperature: configSourceSkill.temperature,
+                maxTokens: configSourceSkill.maxTokens,
+                rawConfig: configSourceSkill
             };
         }
         // Build request object snapshots (same as startActivity)
@@ -816,7 +847,7 @@ export class ActivityManager {
                 response: details.response,
                 outer: {
                     output: details.response,
-                    metadata: {}
+                    metadata: pickActivixCompletionRoutingMetadata(details.response)
                 },
                 endTime: details.endTime,
                 duration: details.duration

package/dist/gateway-utils.d.ts

@@ -2,7 +2,7 @@
  * Gateway Utilities Module
  * Handles utility functions
  */
-import type { AIInvokeRequest, ChatRequest, GatewayConfig, GatewayInvokeRejectionMetadata, GatewayTraceRequestIds, ModelConfig } from './types.js';
+import type { AIInvokeRequest, ChatRequest, GatewayConfig, GatewayInvokeRejectionMetadata, GatewayTraceMergedConfig, GatewayTraceRequestIds, ModelConfig } from './types.js';
 import type { Logxer } from '@x12i/logxer';
 /**
  * Generates MD5 hash of a string
@@ -57,6 +57,10 @@ export declare function pickInvokeRoutingMetadataSlice(routerResponse: unknown,
  * Allowlisted generation profile from merged config for client introspection (no secrets, no arbitrary extras).
  */
 export declare function pickEffectiveModelConfigForMetadata(mergedConfig: unknown): Partial<Pick<ModelConfig, 'model' | 'modelId' | 'provider' | 'temperature' | 'maxTokens' | 'topP'>> | undefined;
+/**
+ * Allowlisted snapshot of merged router config for diagnostics trace responses (no arbitrary extras).
+ */
+export declare function pickTraceMergedRouterConfig(mergedConfig: unknown): GatewayTraceMergedConfig | undefined;
 declare const EFFECTIVE_MODEL_CONFIG_KEYS: readonly ["model", "modelId", "provider", "temperature", "maxTokens", "topP"];
 /**
  * Allowlisted generation fields from request only (before mergeConfig / flex-md).

package/dist/gateway-utils.js

@@ -358,6 +358,40 @@ export function pickEffectiveModelConfigForMetadata(mergedConfig) {
     }
     return Object.keys(out).length ? out : undefined;
 }
+const TRACE_MERGED_ROUTER_NUMERIC_KEYS = [
+    'temperature',
+    'maxTokens',
+    'topP',
+    'frequencyPenalty',
+    'presencePenalty'
+];
+/**
+ * Allowlisted snapshot of merged router config for diagnostics trace responses (no arbitrary extras).
+ */
+export function pickTraceMergedRouterConfig(mergedConfig) {
+    if (mergedConfig == null || typeof mergedConfig !== 'object')
+        return undefined;
+    const c = mergedConfig;
+    const out = {};
+    for (const k of ['model', 'modelId', 'provider']) {
+        const v = c[k];
+        if (typeof v === 'string' && v.length > 0)
+            out[k] = v;
+    }
+    for (const k of TRACE_MERGED_ROUTER_NUMERIC_KEYS) {
+        const v = c[k];
+        if (typeof v === 'number' && Number.isFinite(v))
+            out[k] = v;
+    }
+    const stop = c.stop;
+    if (Array.isArray(stop) && stop.every((x) => typeof x === 'string')) {
+        out.stop = stop;
+    }
+    else if (typeof stop === 'string' && stop.length > 0) {
+        out.stop = [stop];
+    }
+    return Object.keys(out).length ? out : undefined;
+}
 const EFFECTIVE_MODEL_CONFIG_KEYS = ['model', 'modelId', 'provider', 'temperature', 'maxTokens', 'topP'];
 /**
  * Allowlisted generation fields from request only (before mergeConfig / flex-md).

package/dist/gateway.js

@@ -8,7 +8,7 @@ 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 { attachGatewayInvokeRejectionMetadata, buildInvokeRejectionMetadata, capActivityFullResponsePayload, DEFAULT_ACTIVITY_FULL_RESPONSE_MAX_CHARS, extractCostUsdFromRouterResponse, extractTokenUsageFromRouterResponse, mergeConfig, pickEffectiveModelConfigForMetadata, pickInvokeRoutingMetadataSlice, tryExtractRouterLikePayloadFromErrorChain } from './gateway-utils.js';
+import { attachGatewayInvokeRejectionMetadata, buildInvokeRejectionMetadata, capActivityFullResponsePayload, DEFAULT_ACTIVITY_FULL_RESPONSE_MAX_CHARS, extractCostUsdFromRouterResponse, extractTokenUsageFromRouterResponse, mergeConfig, pickEffectiveModelConfigForMetadata, pickInvokeRoutingMetadataSlice, pickTraceMergedRouterConfig, tryExtractRouterLikePayloadFromErrorChain } from './gateway-utils.js';
 import { autoRegisterProviders } from './gateway-provider-auto-register.js';
 import { setGatewayLastJobId, setGatewayRuntimeClients } from './runtime-objects.js';
 import { gatewayLogDebug, withActivityIdentity } from './gateway-log-meta.js';
@@ -77,6 +77,8 @@ export class AIGateway {
         const messages = this.buildSimpleMessages(request);
         // Merge config (modelConfig > request.config > gateway defaults)
         const mergedConfig = await mergeConfig(request, this.config, this.logger);
+        // 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 autoRegisterProviders(this.router, this.logger);
@@ -244,6 +246,7 @@ export class AIGateway {
         request._parsedRequest = parsedSnapshot;
         // Merge config (modelConfig > request.config > gateway defaults)
         const mergedConfig = await mergeConfig(request, this.config, this.logger);
+        request._mergedRouterConfig = mergedConfig;
         const diagnosticsMode = request.diagnostics?.mode;
         const traceEnabled = diagnosticsMode === 'trace';
         const includeRawProviderPayload = request.diagnostics?.includeRawProviderPayload === true;
@@ -533,6 +536,7 @@ export class AIGateway {
             const routerMetaForCost = routerResponse?.metadata || {};
             const routingMetadataSlice = pickInvokeRoutingMetadataSlice(routerResponse, mergedConfig);
             const effectiveModelConfig = pickEffectiveModelConfigForMetadata(mergedConfig);
+            const traceMergedRouterSnapshot = traceEnabled ? pickTraceMergedRouterConfig(mergedConfig) : undefined;
             const enhancedResponse = {
                 content: content,
                 parsedContent: parsedContent,
@@ -560,7 +564,10 @@ export class AIGateway {
                             requestIds: traceRequestIds,
                             retryCount: traceRetryCount,
                             fallbackCount: traceFallbackCount,
-                            attempts: traceAttempts
+                            attempts: traceAttempts,
+                            ...(traceMergedRouterSnapshot !== undefined
+                                ? { mergedRouterConfig: traceMergedRouterSnapshot }
+                                : {})
                         }
                         : {})
                 }

package/dist/index.d.ts

@@ -16,9 +16,10 @@ export * from '@x12i/ai-providers-router';
 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, EnhancedLLMResponse, InstructionMetadata, ValidationRule, TemplateRenderOptions } from './types.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 } from './gateway-utils.js';
-export { mergeTemplateRenderOptions } from './template-render-merge.js';
+export { mergeGatewayAndRequestTemplateRenderOptions, mergeTemplateRenderOptions } from './template-render-merge.js';
+export type { GatewayTemplateRenderRequestSlice } from './template-render-merge.js';
 export type { UsageTier } from './types.js';
 export { Activix } from '@x12i/activix';
 export type { ActivixRunContext, FindByRunContextCriteria, GetJobActivitiesInput, GetJobActivitiesResult } from '@x12i/activix';

package/dist/index.js

@@ -18,7 +18,7 @@ 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 } from './gateway-utils.js';
-export { mergeTemplateRenderOptions } from './template-render-merge.js';
+export { mergeGatewayAndRequestTemplateRenderOptions, mergeTemplateRenderOptions } from './template-render-merge.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)

package/dist/message-builder.js

@@ -4,7 +4,7 @@
  * Handles flex-md format exclusively
  */
 import { parseTemplate } from './template-parser.js';
-import { mergeTemplateRenderOptions } from './template-render-merge.js';
+import { mergeGatewayAndRequestTemplateRenderOptions } from './template-render-merge.js';
 import { resolveNestedInstructionsBlock } from './gateway-instructions.js';
 // Type guard
 // AIRequest is distinguished by having primaryObjectType or objectTypes
@@ -379,7 +379,7 @@ export async function buildMessages(request, config, options = {}) {
     const shortTermMemory = options.shortTermMemory;
     const experienceMemory = options.experienceMemory;
     const knowledgeMemory = options.knowledgeMemory;
-    const templateRenderOptions = mergeTemplateRenderOptions(config.templateRendering, request.templateRenderOptions);
+    const templateRenderOptions = mergeGatewayAndRequestTemplateRenderOptions(config.templateRendering, request);
     if (request.instructions) {
         if (typeof request.instructions === 'string') {
             logger.info('Using instructions as template text', {

package/dist/template-render-merge.d.ts

@@ -1,9 +1,20 @@
 /**
  * Merge @x12i/rendrix TemplateRenderOptions from gateway defaults and per-request overrides.
  */
-import type { TemplateRenderOptions } from '@x12i/rendrix';
+import type { SmartInputConfig, SmartInputRenderOptions, TemplateRenderOptions } from '@x12i/rendrix';
+/** Request fields that participate in gateway + Rendrix template option merging. */
+export type GatewayTemplateRenderRequestSlice = {
+    smartInput?: SmartInputConfig;
+    smartInputRenderOptions?: SmartInputRenderOptions;
+    templateRenderOptions?: TemplateRenderOptions;
+};
 /**
  * Deep-merge template render options. Request/gateway overrides win per field.
  * For `subPathSearch`, `roots` on the override replace the base list when present.
  */
 export declare function mergeTemplateRenderOptions(base?: TemplateRenderOptions, override?: TemplateRenderOptions): TemplateRenderOptions | undefined;
+/**
+ * Gateway default `templateRendering` + optional request shorthand (`smartInput`, `smartInputRenderOptions`) + `templateRenderOptions`.
+ * Same merge order as {@link buildMessages}.
+ */
+export declare function mergeGatewayAndRequestTemplateRenderOptions(gatewayTemplateRendering: TemplateRenderOptions | undefined, request: GatewayTemplateRenderRequestSlice): TemplateRenderOptions | undefined;

package/dist/template-render-merge.js

@@ -6,6 +6,10 @@ function hasMeaningfulOptions(o) {
         return true;
     if (o.silentMissingMustTokens !== undefined)
         return true;
+    if (o.smartInput !== undefined)
+        return true;
+    if (o.smartInputRenderOptions !== undefined)
+        return true;
     if (o.subPathSearch !== undefined) {
         const s = o.subPathSearch;
         return (s.enabled !== undefined ||
@@ -38,3 +42,18 @@ export function mergeTemplateRenderOptions(base, override) {
     }
     return hasMeaningfulOptions(merged) ? merged : undefined;
 }
+/**
+ * Gateway default `templateRendering` + optional request shorthand (`smartInput`, `smartInputRenderOptions`) + `templateRenderOptions`.
+ * Same merge order as {@link buildMessages}.
+ */
+export function mergeGatewayAndRequestTemplateRenderOptions(gatewayTemplateRendering, request) {
+    const requestSmartTemplateOpts = request.smartInput !== undefined || request.smartInputRenderOptions !== undefined
+        ? {
+            ...(request.smartInput !== undefined ? { smartInput: request.smartInput } : {}),
+            ...(request.smartInputRenderOptions !== undefined
+                ? { smartInputRenderOptions: request.smartInputRenderOptions }
+                : {})
+        }
+        : undefined;
+    return mergeTemplateRenderOptions(mergeTemplateRenderOptions(gatewayTemplateRendering, requestSmartTemplateOpts), request.templateRenderOptions);
+}

package/dist/types.d.ts

@@ -8,7 +8,7 @@ type AIProvider = string;
 type AIModel = string;
 export type UsageTier = string;
 import type { Activix } from '@x12i/activix';
-import type { TemplateRenderOptions } from '@x12i/rendrix';
+import type { SmartInputConfig, SmartInputRenderOptions, TemplateRenderOptions } from '@x12i/rendrix';
 import type { Logxer } from '@x12i/logxer';
 /**
  * Diagnostics options for opt-in authoritative tracing.
@@ -84,6 +84,11 @@ export type GatewayTraceAttempt = {
      */
     rawProviderPayload?: unknown;
 };
+/**
+ * Allowlisted merged router/generation config returned in {@link EnhancedLLMResponse.metadata}
+ * when `diagnostics.mode === 'trace'`. Omits arbitrary extras and secrets.
+ */
+export type GatewayTraceMergedConfig = Partial<Pick<ModelConfig, 'model' | 'modelId' | 'provider' | 'temperature' | 'maxTokens' | 'topP' | 'frequencyPenalty' | 'presencePenalty' | 'stop'>>;
 /**
  * Normalized observability payload attached to thrown errors from {@link AIGateway.invoke}
  * when the gateway can derive fields (merged config, partial router body on error).
@@ -163,8 +168,8 @@ export type ActivityIdentity = {
      */
     actionRef?: string;
 };
-/** Re-export parser template options for gateway consumers (MUST/optional protocol, subPathSearch, etc.). */
-export type { TemplateRenderOptions } from '@x12i/rendrix';
+/** Re-export parser template options for gateway consumers (MUST/optional protocol, subPathSearch, smartInput, etc.). */
+export type { SmartInputConfig, SmartInputRenderOptions, TemplateRenderOptions } from '@x12i/rendrix';
 type LLMRequest = Parameters<LLMProviderRouter['invoke']>[0];
 type LLMResponse = Awaited<ReturnType<LLMProviderRouter['invoke']>>;
 /**
@@ -630,6 +635,17 @@ interface BaseLLMRequest extends Omit<LLMRequest, 'messages' | 'input' | 'reques
      * the full list or only set `enabled` and inherit `roots` from the gateway default merge.
      */
     templateRenderOptions?: TemplateRenderOptions;
+    /**
+     * Smart Input paths for Rendrix `{{smartInput}}` (optional shorthand).
+     * Merged into render options after gateway `templateRendering` and before `templateRenderOptions`
+     * (nested `templateRenderOptions.smartInput` wins when both are set).
+     */
+    smartInput?: SmartInputConfig;
+    /**
+     * Rendering controls for Smart Input markdown (optional shorthand).
+     * Merged the same way as `smartInput`; `templateRenderOptions.smartInputRenderOptions` wins when both are set.
+     */
+    smartInputRenderOptions?: SmartInputRenderOptions;
     /**
      * Messages array - Optional, can be used instead of instructions/prompt
      * If provided, will be appended as-is after built messages; instructions template text is still parsed for the system message when present
@@ -954,6 +970,12 @@ export interface EnhancedLLMResponse<TContent = unknown> extends Omit<AIResponse
          * Ordered, authoritative attempts across retries and fallbacks (trace mode).
          */
         attempts?: GatewayTraceAttempt[];
+        /**
+         * Merged gateway/router generation config actually used for the invocation (after
+         * {@link mergeConfig}: modelConfig / request.config / defaults / flex-md maxTokens).
+         * Only populated when diagnostics trace mode is enabled.
+         */
+        mergedRouterConfig?: GatewayTraceMergedConfig;
         /**
          * Content type classification
          * Indicates whether content is 'string', 'object', 'array', or 'null'

package/dist-cjs/activity-manager.cjs

@@ -137,6 +137,30 @@ function logUpstreamIdentityWarnings(logger, incomingIdentity, merged) {
         }));
     }
 }
+/** Routing / generation facts from gateway response metadata for Activix `outer.metadata` on completion. */
+function pickActivixCompletionRoutingMetadata(response) {
+    if (response == null || typeof response !== 'object')
+        return {};
+    const meta = response.metadata;
+    if (meta == null || typeof meta !== 'object')
+        return {};
+    const m = meta;
+    const out = {};
+    if (typeof m.modelUsed === 'string')
+        out.modelUsed = m.modelUsed;
+    if (typeof m.model === 'string')
+        out.model = m.model;
+    if (typeof m.provider === 'string')
+        out.provider = m.provider;
+    if (typeof m.maxTokensRequested === 'number')
+        out.maxTokensRequested = m.maxTokensRequested;
+    if (typeof m.region === 'string')
+        out.region = m.region;
+    if (m.effectiveModelConfig != null && typeof m.effectiveModelConfig === 'object') {
+        out.effectiveModelConfig = m.effectiveModelConfig;
+    }
+    return out;
+}
 function mergeGatewayActivityIdentity(request, aiRequestId, extras) {
     const incomingIdentity = request.identity;
     const sessionId = resolveSessionIdForRequest(request, incomingIdentity, aiRequestId);
@@ -392,33 +416,37 @@ class ActivityManager {
             // - provider, model, temperature, maxTokens → only in config object
             // - NO response, endTime, duration (these are added via logSuccess)
         };
-        // Config snapshot
-        // CRITICAL: This captures the exact config sent to the router (finalRouterConfig)
-        // This ensures activity records show the actual config that was sent, including that response_format was removed
-        if (request.config !== undefined) {
-            // Verify response_format is not present (for debugging)
-            const hasResponseFormat = 'responseFormat' in request.config || 'response_format' in request.config;
+        // Config snapshot — prefer gateway merge output (`_mergedRouterConfig`) over raw `request.config`.
+        // Callers often put model only on `modelConfig`; merge happens in `mergeConfig()` before `router.invoke`.
+        const mergedRouterConfig = request._mergedRouterConfig;
+        const configSource = mergedRouterConfig != null && typeof mergedRouterConfig === 'object'
+            ? mergedRouterConfig
+            : request.config;
+        // CRITICAL: Capture the exact config sent to the router (finalRouterConfig)
+        if (configSource !== undefined) {
+            const hasResponseFormat = 'responseFormat' in configSource || 'response_format' in configSource;
             if (hasResponseFormat) {
                 this.logger.warn('Activity tracking received config with response_format - this should not happen', {
                     aiRequestId,
-                    hasResponseFormat: 'responseFormat' in request.config,
-                    hasResponse_format: 'response_format' in request.config,
-                    configKeys: Object.keys(request.config)
+                    hasResponseFormat: 'responseFormat' in configSource,
+                    hasResponse_format: 'response_format' in configSource,
+                    configKeys: Object.keys(configSource)
                 });
             }
             activityMetadata.config = {
-                model: request.config.model,
-                provider: request.config.provider || null, // Ensure provider is captured (may be null if not set)
-                temperature: request.config.temperature,
-                maxTokens: request.config.maxTokens,
-                rawConfig: request.config // ✅ Captures finalRouterConfig (exact config sent to router)
+                model: configSource.model,
+                provider: configSource.provider || null,
+                temperature: configSource.temperature,
+                maxTokens: configSource.maxTokens,
+                rawConfig: configSource
             };
             this.logger.debug('Activity tracking config captured', {
                 aiRequestId,
-                model: request.config.model,
-                provider: request.config.provider,
-                hasResponseFormat: hasResponseFormat,
-                rawConfigKeys: Object.keys(request.config).slice(0, 10)
+                model: configSource.model,
+                provider: configSource.provider,
+                configSource: mergedRouterConfig != null ? '_mergedRouterConfig' : 'request.config',
+                hasResponseFormat,
+                rawConfigKeys: Object.keys(configSource).slice(0, 10)
             });
         }
         // Build request object snapshots (raw = incoming; parsed = constructed messages/meta)
@@ -609,14 +637,17 @@ class ActivityManager {
             ...(aiRequest.masterSkillActivityId && { masterSkillActivityId: aiRequest.masterSkillActivityId }),
             ...(aiRequest.masterSkillId && { masterSkillId: aiRequest.masterSkillId })
         };
-        // Config snapshot (same as startActivity)
-        if (request.config !== undefined) {
+        const mergedRouterConfigSkill = request._mergedRouterConfig;
+        const configSourceSkill = mergedRouterConfigSkill != null && typeof mergedRouterConfigSkill === 'object'
+            ? mergedRouterConfigSkill
+            : request.config;
+        if (configSourceSkill !== undefined) {
             activityMetadata.config = {
-                model: request.config.model,
-                provider: request.config.provider || null,
-                temperature: request.config.temperature,
-                maxTokens: request.config.maxTokens,
-                rawConfig: request.config
+                model: configSourceSkill.model,
+                provider: configSourceSkill.provider || null,
+                temperature: configSourceSkill.temperature,
+                maxTokens: configSourceSkill.maxTokens,
+                rawConfig: configSourceSkill
             };
         }
         // Build request object snapshots (same as startActivity)
@@ -820,7 +851,7 @@ class ActivityManager {
                 response: details.response,
                 outer: {
                     output: details.response,
-                    metadata: {}
+                    metadata: pickActivixCompletionRoutingMetadata(details.response)
                 },
                 endTime: details.endTime,
                 duration: details.duration

package/dist-cjs/gateway-utils.cjs

@@ -46,6 +46,7 @@ exports.extractTokenUsageFromRouterResponse = extractTokenUsageFromRouterRespons
 exports.extractCostUsdFromRouterResponse = extractCostUsdFromRouterResponse;
 exports.pickInvokeRoutingMetadataSlice = pickInvokeRoutingMetadataSlice;
 exports.pickEffectiveModelConfigForMetadata = pickEffectiveModelConfigForMetadata;
+exports.pickTraceMergedRouterConfig = pickTraceMergedRouterConfig;
 exports.pickEffectiveModelConfigFromInvokeRequest = pickEffectiveModelConfigFromInvokeRequest;
 exports.tryExtractRouterLikePayloadFromErrorChain = tryExtractRouterLikePayloadFromErrorChain;
 exports.pickRequestIdsFromRouterLike = pickRequestIdsFromRouterLike;
@@ -408,6 +409,40 @@ function pickEffectiveModelConfigForMetadata(mergedConfig) {
     }
     return Object.keys(out).length ? out : undefined;
 }
+const TRACE_MERGED_ROUTER_NUMERIC_KEYS = [
+    'temperature',
+    'maxTokens',
+    'topP',
+    'frequencyPenalty',
+    'presencePenalty'
+];
+/**
+ * Allowlisted snapshot of merged router config for diagnostics trace responses (no arbitrary extras).
+ */
+function pickTraceMergedRouterConfig(mergedConfig) {
+    if (mergedConfig == null || typeof mergedConfig !== 'object')
+        return undefined;
+    const c = mergedConfig;
+    const out = {};
+    for (const k of ['model', 'modelId', 'provider']) {
+        const v = c[k];
+        if (typeof v === 'string' && v.length > 0)
+            out[k] = v;
+    }
+    for (const k of TRACE_MERGED_ROUTER_NUMERIC_KEYS) {
+        const v = c[k];
+        if (typeof v === 'number' && Number.isFinite(v))
+            out[k] = v;
+    }
+    const stop = c.stop;
+    if (Array.isArray(stop) && stop.every((x) => typeof x === 'string')) {
+        out.stop = stop;
+    }
+    else if (typeof stop === 'string' && stop.length > 0) {
+        out.stop = [stop];
+    }
+    return Object.keys(out).length ? out : undefined;
+}
 const EFFECTIVE_MODEL_CONFIG_KEYS = ['model', 'modelId', 'provider', 'temperature', 'maxTokens', 'topP'];
 /**
  * Allowlisted generation fields from request only (before mergeConfig / flex-md).

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

@@ -2,7 +2,7 @@
  * Gateway Utilities Module
  * Handles utility functions
  */
-import type { AIInvokeRequest, ChatRequest, GatewayConfig, GatewayInvokeRejectionMetadata, GatewayTraceRequestIds, ModelConfig } from './types.js';
+import type { AIInvokeRequest, ChatRequest, GatewayConfig, GatewayInvokeRejectionMetadata, GatewayTraceMergedConfig, GatewayTraceRequestIds, ModelConfig } from './types.js';
 import type { Logxer } from '@x12i/logxer';
 /**
  * Generates MD5 hash of a string
@@ -57,6 +57,10 @@ export declare function pickInvokeRoutingMetadataSlice(routerResponse: unknown,
  * Allowlisted generation profile from merged config for client introspection (no secrets, no arbitrary extras).
  */
 export declare function pickEffectiveModelConfigForMetadata(mergedConfig: unknown): Partial<Pick<ModelConfig, 'model' | 'modelId' | 'provider' | 'temperature' | 'maxTokens' | 'topP'>> | undefined;
+/**
+ * Allowlisted snapshot of merged router config for diagnostics trace responses (no arbitrary extras).
+ */
+export declare function pickTraceMergedRouterConfig(mergedConfig: unknown): GatewayTraceMergedConfig | undefined;
 declare const EFFECTIVE_MODEL_CONFIG_KEYS: readonly ["model", "modelId", "provider", "temperature", "maxTokens", "topP"];
 /**
  * Allowlisted generation fields from request only (before mergeConfig / flex-md).

package/dist-cjs/gateway.cjs

@@ -80,6 +80,8 @@ class AIGateway {
         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);
+        // 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);
@@ -247,6 +249,7 @@ class AIGateway {
         request._parsedRequest = parsedSnapshot;
         // Merge config (modelConfig > request.config > gateway defaults)
         const mergedConfig = await (0, gateway_utils_js_1.mergeConfig)(request, this.config, this.logger);
+        request._mergedRouterConfig = mergedConfig;
         const diagnosticsMode = request.diagnostics?.mode;
         const traceEnabled = diagnosticsMode === 'trace';
         const includeRawProviderPayload = request.diagnostics?.includeRawProviderPayload === true;
@@ -536,6 +539,7 @@ class AIGateway {
             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 enhancedResponse = {
                 content: content,
                 parsedContent: parsedContent,
@@ -563,7 +567,10 @@ class AIGateway {
                             requestIds: traceRequestIds,
                             retryCount: traceRetryCount,
                             fallbackCount: traceFallbackCount,
-                            attempts: traceAttempts
+                            attempts: traceAttempts,
+                            ...(traceMergedRouterSnapshot !== undefined
+                                ? { mergedRouterConfig: traceMergedRouterSnapshot }
+                                : {})
                         }
                         : {})
                 }

package/dist-cjs/index.cjs

@@ -21,7 +21,7 @@ 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.resetObjectTypesLibrary = exports.getObjectTypesLibrary = exports.initializeObjectTypesLibrary = exports.getObjectTypesForAgent = exports.getObjectType = exports.OBJECT_TYPES_LIBRARY = exports.assertValidAIRequest = exports.formatDiagnostic = exports.runValidationTests = 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.mergeTemplateRenderOptions = 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 = 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.mergeTemplateRenderOptions = exports.mergeGatewayAndRequestTemplateRenderOptions = 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;
 // 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; } });
@@ -49,6 +49,7 @@ Object.defineProperty(exports, "buildInvokeRejectionMetadata", { enumerable: tru
 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; } });
 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; } });
 // 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)

package/dist-cjs/index.d.ts

@@ -16,9 +16,10 @@ export * from '@x12i/ai-providers-router';
 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, EnhancedLLMResponse, InstructionMetadata, ValidationRule, TemplateRenderOptions } from './types.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 } from './gateway-utils.js';
-export { mergeTemplateRenderOptions } from './template-render-merge.js';
+export { mergeGatewayAndRequestTemplateRenderOptions, mergeTemplateRenderOptions } from './template-render-merge.js';
+export type { GatewayTemplateRenderRequestSlice } from './template-render-merge.js';
 export type { UsageTier } from './types.js';
 export { Activix } from '@x12i/activix';
 export type { ActivixRunContext, FindByRunContextCriteria, GetJobActivitiesInput, GetJobActivitiesResult } from '@x12i/activix';

package/dist-cjs/message-builder.cjs

@@ -415,7 +415,7 @@ async function buildMessages(request, config, options = {}) {
     const shortTermMemory = options.shortTermMemory;
     const experienceMemory = options.experienceMemory;
     const knowledgeMemory = options.knowledgeMemory;
-    const templateRenderOptions = (0, template_render_merge_js_1.mergeTemplateRenderOptions)(config.templateRendering, request.templateRenderOptions);
+    const templateRenderOptions = (0, template_render_merge_js_1.mergeGatewayAndRequestTemplateRenderOptions)(config.templateRendering, request);
     if (request.instructions) {
         if (typeof request.instructions === 'string') {
             logger.info('Using instructions as template text', {

package/dist-cjs/template-render-merge.cjs

@@ -4,11 +4,16 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.mergeTemplateRenderOptions = mergeTemplateRenderOptions;
+exports.mergeGatewayAndRequestTemplateRenderOptions = mergeGatewayAndRequestTemplateRenderOptions;
 function hasMeaningfulOptions(o) {
     if (o.templateId !== undefined)
         return true;
     if (o.silentMissingMustTokens !== undefined)
         return true;
+    if (o.smartInput !== undefined)
+        return true;
+    if (o.smartInputRenderOptions !== undefined)
+        return true;
     if (o.subPathSearch !== undefined) {
         const s = o.subPathSearch;
         return (s.enabled !== undefined ||
@@ -41,3 +46,18 @@ function mergeTemplateRenderOptions(base, override) {
     }
     return hasMeaningfulOptions(merged) ? merged : undefined;
 }
+/**
+ * Gateway default `templateRendering` + optional request shorthand (`smartInput`, `smartInputRenderOptions`) + `templateRenderOptions`.
+ * Same merge order as {@link buildMessages}.
+ */
+function mergeGatewayAndRequestTemplateRenderOptions(gatewayTemplateRendering, request) {
+    const requestSmartTemplateOpts = request.smartInput !== undefined || request.smartInputRenderOptions !== undefined
+        ? {
+            ...(request.smartInput !== undefined ? { smartInput: request.smartInput } : {}),
+            ...(request.smartInputRenderOptions !== undefined
+                ? { smartInputRenderOptions: request.smartInputRenderOptions }
+                : {})
+        }
+        : undefined;
+    return mergeTemplateRenderOptions(mergeTemplateRenderOptions(gatewayTemplateRendering, requestSmartTemplateOpts), request.templateRenderOptions);
+}

package/dist-cjs/template-render-merge.d.ts

@@ -1,9 +1,20 @@
 /**
  * Merge @x12i/rendrix TemplateRenderOptions from gateway defaults and per-request overrides.
  */
-import type { TemplateRenderOptions } from '@x12i/rendrix';
+import type { SmartInputConfig, SmartInputRenderOptions, TemplateRenderOptions } from '@x12i/rendrix';
+/** Request fields that participate in gateway + Rendrix template option merging. */
+export type GatewayTemplateRenderRequestSlice = {
+    smartInput?: SmartInputConfig;
+    smartInputRenderOptions?: SmartInputRenderOptions;
+    templateRenderOptions?: TemplateRenderOptions;
+};
 /**
  * Deep-merge template render options. Request/gateway overrides win per field.
  * For `subPathSearch`, `roots` on the override replace the base list when present.
  */
 export declare function mergeTemplateRenderOptions(base?: TemplateRenderOptions, override?: TemplateRenderOptions): TemplateRenderOptions | undefined;
+/**
+ * Gateway default `templateRendering` + optional request shorthand (`smartInput`, `smartInputRenderOptions`) + `templateRenderOptions`.
+ * Same merge order as {@link buildMessages}.
+ */
+export declare function mergeGatewayAndRequestTemplateRenderOptions(gatewayTemplateRendering: TemplateRenderOptions | undefined, request: GatewayTemplateRenderRequestSlice): TemplateRenderOptions | undefined;

package/dist-cjs/types.d.ts

@@ -8,7 +8,7 @@ type AIProvider = string;
 type AIModel = string;
 export type UsageTier = string;
 import type { Activix } from '@x12i/activix';
-import type { TemplateRenderOptions } from '@x12i/rendrix';
+import type { SmartInputConfig, SmartInputRenderOptions, TemplateRenderOptions } from '@x12i/rendrix';
 import type { Logxer } from '@x12i/logxer';
 /**
  * Diagnostics options for opt-in authoritative tracing.
@@ -84,6 +84,11 @@ export type GatewayTraceAttempt = {
      */
     rawProviderPayload?: unknown;
 };
+/**
+ * Allowlisted merged router/generation config returned in {@link EnhancedLLMResponse.metadata}
+ * when `diagnostics.mode === 'trace'`. Omits arbitrary extras and secrets.
+ */
+export type GatewayTraceMergedConfig = Partial<Pick<ModelConfig, 'model' | 'modelId' | 'provider' | 'temperature' | 'maxTokens' | 'topP' | 'frequencyPenalty' | 'presencePenalty' | 'stop'>>;
 /**
  * Normalized observability payload attached to thrown errors from {@link AIGateway.invoke}
  * when the gateway can derive fields (merged config, partial router body on error).
@@ -163,8 +168,8 @@ export type ActivityIdentity = {
      */
     actionRef?: string;
 };
-/** Re-export parser template options for gateway consumers (MUST/optional protocol, subPathSearch, etc.). */
-export type { TemplateRenderOptions } from '@x12i/rendrix';
+/** Re-export parser template options for gateway consumers (MUST/optional protocol, subPathSearch, smartInput, etc.). */
+export type { SmartInputConfig, SmartInputRenderOptions, TemplateRenderOptions } from '@x12i/rendrix';
 type LLMRequest = Parameters<LLMProviderRouter['invoke']>[0];
 type LLMResponse = Awaited<ReturnType<LLMProviderRouter['invoke']>>;
 /**
@@ -630,6 +635,17 @@ interface BaseLLMRequest extends Omit<LLMRequest, 'messages' | 'input' | 'reques
      * the full list or only set `enabled` and inherit `roots` from the gateway default merge.
      */
     templateRenderOptions?: TemplateRenderOptions;
+    /**
+     * Smart Input paths for Rendrix `{{smartInput}}` (optional shorthand).
+     * Merged into render options after gateway `templateRendering` and before `templateRenderOptions`
+     * (nested `templateRenderOptions.smartInput` wins when both are set).
+     */
+    smartInput?: SmartInputConfig;
+    /**
+     * Rendering controls for Smart Input markdown (optional shorthand).
+     * Merged the same way as `smartInput`; `templateRenderOptions.smartInputRenderOptions` wins when both are set.
+     */
+    smartInputRenderOptions?: SmartInputRenderOptions;
     /**
      * Messages array - Optional, can be used instead of instructions/prompt
      * If provided, will be appended as-is after built messages; instructions template text is still parsed for the system message when present
@@ -954,6 +970,12 @@ export interface EnhancedLLMResponse<TContent = unknown> extends Omit<AIResponse
          * Ordered, authoritative attempts across retries and fallbacks (trace mode).
          */
         attempts?: GatewayTraceAttempt[];
+        /**
+         * Merged gateway/router generation config actually used for the invocation (after
+         * {@link mergeConfig}: modelConfig / request.config / defaults / flex-md maxTokens).
+         * Only populated when diagnostics trace mode is enabled.
+         */
+        mergedRouterConfig?: GatewayTraceMergedConfig;
         /**
          * Content type classification
          * Indicates whether content is 'string', 'object', 'array', or 'null'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/ai-gateway",
-  "version": "9.1.2",
+  "version": "9.1.5",
   "description": "AI Gateway - Unified interface for LLM provider routing and management",
   "type": "module",
   "exports": {
@@ -61,7 +61,7 @@
   "license": "mit",
   "dependencies": {
     "@x12i/ai-providers-router": "^4.7.7",
-    "@x12i/rendrix": "^4.2.0",
+    "@x12i/rendrix": "^4.3.0",
     "@aws-sdk/s3-request-presigner": "^3.953.0",
     "@x12i/env": "^4.0.1",
     "@x12i/logxer": "^4.3.5",