@x12i/ai-gateway 9.1.3 → 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/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, GatewayTraceMergedConfig, 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.
@@ -168,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']>>;
 /**
@@ -635,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

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, GatewayTraceMergedConfig, 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.
@@ -168,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']>>;
 /**
@@ -635,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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/ai-gateway",
-  "version": "9.1.3",
+  "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",