@x12i/ai-gateway 9.1.3 → 9.1.6

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,12 @@ 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 { GATEWAY_DUAL_MEMORY_ROOTS, buildMemoryResolutionRootFromWorkingMemory, coalesceMergedInputBucket, extractCallerInputsBag, mapSmartInputPathsInputsToInput, parseLooseJsonObject, prepareWorkingMemoryForTemplateRender, resolveGatewayMemoryPathValue } from './memory-path-resolution.js';
+export type { GatewayDualMemoryRoot } from './memory-path-resolution.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,8 @@ 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';
+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)

package/dist/memory-path-resolution.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Dual memory roots `input` (merged MAIN payload) and `inputs` (caller / graph-entry bag).
+ * Aligned with @exellix/graph-engine ≥ 5.5.0 resolution rules for template / smart-input paths.
+ */
+export declare const GATEWAY_DUAL_MEMORY_ROOTS: readonly ["input", "inputs"];
+export type GatewayDualMemoryRoot = (typeof GATEWAY_DUAL_MEMORY_ROOTS)[number];
+/**
+ * Parse JSON object shapes from strings (matches graph-engine `parseLooseJsonObject`).
+ */
+export declare function parseLooseJsonObject(value: unknown): Record<string, unknown> | undefined;
+/** Caller / graph-entry bag from `workingMemory.inputs`. */
+export declare function extractCallerInputsBag(workingMemory: unknown): Record<string, unknown> | undefined;
+/** Merged MAIN bucket from `workingMemory.input` (object or parsed JSON string). */
+export declare function coalesceMergedInputBucket(workingMemory: unknown): unknown;
+/**
+ * Resolve a dotted path against working memory with dual-root rules:
+ * - `inputs` / `inputs.*` → caller bag first, then merged `input`
+ * - `input` / `input.*` → merged `input` first, then caller `inputs`
+ * - other paths → direct lookup on working memory
+ */
+export declare function resolveGatewayMemoryPathValue(workingMemory: unknown, path: string): unknown;
+/**
+ * Working-memory view for Rendrix / smart-input: preserves all keys but overlays
+ * `input` and `inputs` with dual-root merge views (does not rewrite authored paths).
+ */
+export declare function buildMemoryResolutionRootFromWorkingMemory(workingMemory: unknown): Record<string, unknown>;
+/**
+ * When WM carries `input` and/or `inputs`, return a resolution root for template rendering.
+ * Otherwise returns the original reference unchanged.
+ */
+export declare function prepareWorkingMemoryForTemplateRender(workingMemory: unknown): unknown;
+/** Optional migration: rewrite `inputs.*` smart-input / memory paths to `input.*`. */
+export declare function mapSmartInputPathsInputsToInput(paths: string[]): string[];

package/dist/memory-path-resolution.js

@@ -0,0 +1,172 @@
+/**
+ * Dual memory roots `input` (merged MAIN payload) and `inputs` (caller / graph-entry bag).
+ * Aligned with @exellix/graph-engine ≥ 5.5.0 resolution rules for template / smart-input paths.
+ */
+export const GATEWAY_DUAL_MEMORY_ROOTS = ['input', 'inputs'];
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Parse JSON object shapes from strings (matches graph-engine `parseLooseJsonObject`).
+ */
+export function parseLooseJsonObject(value) {
+    if (isPlainObject(value))
+        return value;
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed.startsWith('{'))
+        return undefined;
+    try {
+        const parsed = JSON.parse(trimmed);
+        return isPlainObject(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Caller / graph-entry bag from `workingMemory.inputs`. */
+export function extractCallerInputsBag(workingMemory) {
+    if (!isPlainObject(workingMemory))
+        return undefined;
+    const inputs = workingMemory.inputs;
+    return isPlainObject(inputs) ? inputs : undefined;
+}
+/** Merged MAIN bucket from `workingMemory.input` (object or parsed JSON string). */
+export function coalesceMergedInputBucket(workingMemory) {
+    if (!isPlainObject(workingMemory))
+        return undefined;
+    const raw = workingMemory.input;
+    if (raw === undefined || raw === null)
+        return undefined;
+    const parsed = parseLooseJsonObject(raw);
+    return parsed !== undefined ? parsed : raw;
+}
+function getValueAtPath(obj, path) {
+    if (obj == null)
+        return undefined;
+    if (path === '' || path === 'this' || path === '.')
+        return obj;
+    const parts = path.split('.');
+    let cur = obj;
+    for (const part of parts) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+function asObjectBucket(value) {
+    const parsed = parseLooseJsonObject(value);
+    if (parsed)
+        return parsed;
+    return isPlainObject(value) ? value : undefined;
+}
+/**
+ * Shallow-deep merge for template lookup: primary wins per key; nested plain objects merge recursively.
+ */
+function mergeBucketViews(primary, fallback) {
+    const pObj = asObjectBucket(primary);
+    const fObj = asObjectBucket(fallback);
+    if (!pObj && !fObj) {
+        if (primary !== undefined && primary !== null)
+            return primary;
+        return fallback;
+    }
+    if (!pObj)
+        return { ...fObj };
+    if (!fObj)
+        return { ...pObj };
+    const keys = new Set([...Object.keys(pObj), ...Object.keys(fObj)]);
+    const view = {};
+    for (const key of keys) {
+        const pv = pObj[key];
+        const fv = fObj[key];
+        if (isPlainObject(pv) && isPlainObject(fv)) {
+            view[key] = mergeBucketViews(pv, fv);
+        }
+        else {
+            view[key] = pv !== undefined ? pv : fv;
+        }
+    }
+    return view;
+}
+/**
+ * Resolve a dotted path against working memory with dual-root rules:
+ * - `inputs` / `inputs.*` → caller bag first, then merged `input`
+ * - `input` / `input.*` → merged `input` first, then caller `inputs`
+ * - other paths → direct lookup on working memory
+ */
+export function resolveGatewayMemoryPathValue(workingMemory, path) {
+    const trimmed = path.trim();
+    if (!trimmed)
+        return undefined;
+    const dot = trimmed.indexOf('.');
+    const root = dot >= 0 ? trimmed.slice(0, dot) : trimmed;
+    const tail = dot >= 0 ? trimmed.slice(dot + 1) : '';
+    if (root === 'inputs') {
+        const primary = extractCallerInputsBag(workingMemory);
+        const fallback = coalesceMergedInputBucket(workingMemory);
+        if (!tail) {
+            if (primary && Object.keys(primary).length > 0)
+                return primary;
+            return fallback;
+        }
+        const fromPrimary = primary ? getValueAtPath(primary, tail) : undefined;
+        if (fromPrimary !== undefined)
+            return fromPrimary;
+        return fallback !== undefined ? getValueAtPath(fallback, tail) : undefined;
+    }
+    if (root === 'input') {
+        const primary = coalesceMergedInputBucket(workingMemory);
+        const fallback = extractCallerInputsBag(workingMemory);
+        if (!tail) {
+            if (primary !== undefined && primary !== null)
+                return primary;
+            return fallback;
+        }
+        const fromPrimary = primary !== undefined ? getValueAtPath(primary, tail) : undefined;
+        if (fromPrimary !== undefined)
+            return fromPrimary;
+        return fallback ? getValueAtPath(fallback, tail) : undefined;
+    }
+    return getValueAtPath(workingMemory, trimmed);
+}
+/**
+ * Working-memory view for Rendrix / smart-input: preserves all keys but overlays
+ * `input` and `inputs` with dual-root merge views (does not rewrite authored paths).
+ */
+export function buildMemoryResolutionRootFromWorkingMemory(workingMemory) {
+    if (!isPlainObject(workingMemory))
+        return {};
+    const inputsBag = extractCallerInputsBag(workingMemory);
+    const mergedInput = coalesceMergedInputBucket(workingMemory);
+    return {
+        ...workingMemory,
+        input: mergeBucketViews(mergedInput, inputsBag),
+        inputs: mergeBucketViews(inputsBag, mergedInput)
+    };
+}
+/**
+ * When WM carries `input` and/or `inputs`, return a resolution root for template rendering.
+ * Otherwise returns the original reference unchanged.
+ */
+export function prepareWorkingMemoryForTemplateRender(workingMemory) {
+    if (!isPlainObject(workingMemory))
+        return workingMemory;
+    if (workingMemory.input === undefined && workingMemory.inputs === undefined) {
+        return workingMemory;
+    }
+    return buildMemoryResolutionRootFromWorkingMemory(workingMemory);
+}
+/** Optional migration: rewrite `inputs.*` smart-input / memory paths to `input.*`. */
+export function mapSmartInputPathsInputsToInput(paths) {
+    return paths.map((p) => {
+        const t = p.trim();
+        if (t === 'inputs')
+            return 'input';
+        if (t.startsWith('inputs.'))
+            return `input.${t.slice('inputs.'.length)}`;
+        return p;
+    });
+}

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-parser.js

@@ -4,6 +4,7 @@
  * Uses @x12i/rendrix (v4+) to parse templates with workingMemory.
  * TemplateResolutionError from the parser is rethrown; other errors fall back to the raw template.
  */
+import { prepareWorkingMemoryForTemplateRender } from './memory-path-resolution.js';
 let rendrixModule = null;
 let parserLoadPromise = null;
 async function loadRendrix() {
@@ -48,6 +49,7 @@ export async function parseTemplate(template, workingMemory, taskConfig, shortTe
     if (!workingMemory) {
         return template;
     }
+    const wmForRender = prepareWorkingMemoryForTemplateRender(workingMemory);
     await loadRendrix();
     if (!rendrixModule) {
         return template;
@@ -57,18 +59,18 @@ export async function parseTemplate(template, workingMemory, taskConfig, shortTe
             ? rendrixModule
             : rendrixModule.default || rendrixModule;
         if (typeof api.render === 'function') {
-            return await api.render(template, workingMemory, shortTermMemory, experienceMemory, knowledgeMemory, undefined, // functionsMap
+            return await api.render(template, wmForRender, shortTermMemory, experienceMemory, knowledgeMemory, undefined, // functionsMap
             undefined, // choiceOptions
             undefined, // filesContent
             templateRenderOptions);
         }
         if (typeof api.parse === 'function') {
-            return await api.parse(template, workingMemory);
+            return await api.parse(template, wmForRender);
         }
         else if (typeof api === 'function') {
             const parser = new api();
             if (typeof parser.parse === 'function') {
-                return await parser.parse(template, workingMemory);
+                return await parser.parse(template, wmForRender);
             }
         }
         return template;

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']>>;
 /**
@@ -626,6 +626,10 @@ interface BaseLLMRequest extends Omit<LLMRequest, 'messages' | 'input' | 'reques
      * Working memory (optional) - Affects all template parsing
      * Passed to Rendrix (v4+) for template variable substitution.
      * Plain {{path}} tokens are MUST paths: undefined after merge throws TemplateResolutionError (rethrown by the gateway).
+     *
+     * Dual roots (graph-engine / ai-tasks contract): `inputs` is the caller / graph-entry bag;
+     * `input` is the merged MAIN payload (object or JSON string). Smart-input and `input.*` / `inputs.*`
+     * paths resolve with cross-root fallback before render (see `resolveGatewayMemoryPathValue`).
      */
     workingMemory?: unknown;
     /**
@@ -635,6 +639,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,8 @@ 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.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.resolveGatewayMemoryPathValue = exports.prepareWorkingMemoryForTemplateRender = exports.parseLooseJsonObject = exports.mapSmartInputPathsInputsToInput = exports.extractCallerInputsBag = exports.coalesceMergedInputBucket = exports.buildMemoryResolutionRootFromWorkingMemory = exports.GATEWAY_DUAL_MEMORY_ROOTS = 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;
+exports.resetObjectTypesLibrary = exports.getObjectTypesLibrary = exports.initializeObjectTypesLibrary = 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,7 +50,17 @@ 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; } });
+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; } });
 // 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-cjs/index.d.ts

@@ -16,9 +16,12 @@ 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 { GATEWAY_DUAL_MEMORY_ROOTS, buildMemoryResolutionRootFromWorkingMemory, coalesceMergedInputBucket, extractCallerInputsBag, mapSmartInputPathsInputsToInput, parseLooseJsonObject, prepareWorkingMemoryForTemplateRender, resolveGatewayMemoryPathValue } from './memory-path-resolution.js';
+export type { GatewayDualMemoryRoot } from './memory-path-resolution.js';
 export type { UsageTier } from './types.js';
 export { Activix } from '@x12i/activix';
 export type { ActivixRunContext, FindByRunContextCriteria, GetJobActivitiesInput, GetJobActivitiesResult } from '@x12i/activix';

package/dist-cjs/memory-path-resolution.cjs

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * Dual memory roots `input` (merged MAIN payload) and `inputs` (caller / graph-entry bag).
+ * Aligned with @exellix/graph-engine ≥ 5.5.0 resolution rules for template / smart-input paths.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GATEWAY_DUAL_MEMORY_ROOTS = void 0;
+exports.parseLooseJsonObject = parseLooseJsonObject;
+exports.extractCallerInputsBag = extractCallerInputsBag;
+exports.coalesceMergedInputBucket = coalesceMergedInputBucket;
+exports.resolveGatewayMemoryPathValue = resolveGatewayMemoryPathValue;
+exports.buildMemoryResolutionRootFromWorkingMemory = buildMemoryResolutionRootFromWorkingMemory;
+exports.prepareWorkingMemoryForTemplateRender = prepareWorkingMemoryForTemplateRender;
+exports.mapSmartInputPathsInputsToInput = mapSmartInputPathsInputsToInput;
+exports.GATEWAY_DUAL_MEMORY_ROOTS = ['input', 'inputs'];
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Parse JSON object shapes from strings (matches graph-engine `parseLooseJsonObject`).
+ */
+function parseLooseJsonObject(value) {
+    if (isPlainObject(value))
+        return value;
+    if (typeof value !== 'string')
+        return undefined;
+    const trimmed = value.trim();
+    if (!trimmed.startsWith('{'))
+        return undefined;
+    try {
+        const parsed = JSON.parse(trimmed);
+        return isPlainObject(parsed) ? parsed : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Caller / graph-entry bag from `workingMemory.inputs`. */
+function extractCallerInputsBag(workingMemory) {
+    if (!isPlainObject(workingMemory))
+        return undefined;
+    const inputs = workingMemory.inputs;
+    return isPlainObject(inputs) ? inputs : undefined;
+}
+/** Merged MAIN bucket from `workingMemory.input` (object or parsed JSON string). */
+function coalesceMergedInputBucket(workingMemory) {
+    if (!isPlainObject(workingMemory))
+        return undefined;
+    const raw = workingMemory.input;
+    if (raw === undefined || raw === null)
+        return undefined;
+    const parsed = parseLooseJsonObject(raw);
+    return parsed !== undefined ? parsed : raw;
+}
+function getValueAtPath(obj, path) {
+    if (obj == null)
+        return undefined;
+    if (path === '' || path === 'this' || path === '.')
+        return obj;
+    const parts = path.split('.');
+    let cur = obj;
+    for (const part of parts) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+function asObjectBucket(value) {
+    const parsed = parseLooseJsonObject(value);
+    if (parsed)
+        return parsed;
+    return isPlainObject(value) ? value : undefined;
+}
+/**
+ * Shallow-deep merge for template lookup: primary wins per key; nested plain objects merge recursively.
+ */
+function mergeBucketViews(primary, fallback) {
+    const pObj = asObjectBucket(primary);
+    const fObj = asObjectBucket(fallback);
+    if (!pObj && !fObj) {
+        if (primary !== undefined && primary !== null)
+            return primary;
+        return fallback;
+    }
+    if (!pObj)
+        return { ...fObj };
+    if (!fObj)
+        return { ...pObj };
+    const keys = new Set([...Object.keys(pObj), ...Object.keys(fObj)]);
+    const view = {};
+    for (const key of keys) {
+        const pv = pObj[key];
+        const fv = fObj[key];
+        if (isPlainObject(pv) && isPlainObject(fv)) {
+            view[key] = mergeBucketViews(pv, fv);
+        }
+        else {
+            view[key] = pv !== undefined ? pv : fv;
+        }
+    }
+    return view;
+}
+/**
+ * Resolve a dotted path against working memory with dual-root rules:
+ * - `inputs` / `inputs.*` → caller bag first, then merged `input`
+ * - `input` / `input.*` → merged `input` first, then caller `inputs`
+ * - other paths → direct lookup on working memory
+ */
+function resolveGatewayMemoryPathValue(workingMemory, path) {
+    const trimmed = path.trim();
+    if (!trimmed)
+        return undefined;
+    const dot = trimmed.indexOf('.');
+    const root = dot >= 0 ? trimmed.slice(0, dot) : trimmed;
+    const tail = dot >= 0 ? trimmed.slice(dot + 1) : '';
+    if (root === 'inputs') {
+        const primary = extractCallerInputsBag(workingMemory);
+        const fallback = coalesceMergedInputBucket(workingMemory);
+        if (!tail) {
+            if (primary && Object.keys(primary).length > 0)
+                return primary;
+            return fallback;
+        }
+        const fromPrimary = primary ? getValueAtPath(primary, tail) : undefined;
+        if (fromPrimary !== undefined)
+            return fromPrimary;
+        return fallback !== undefined ? getValueAtPath(fallback, tail) : undefined;
+    }
+    if (root === 'input') {
+        const primary = coalesceMergedInputBucket(workingMemory);
+        const fallback = extractCallerInputsBag(workingMemory);
+        if (!tail) {
+            if (primary !== undefined && primary !== null)
+                return primary;
+            return fallback;
+        }
+        const fromPrimary = primary !== undefined ? getValueAtPath(primary, tail) : undefined;
+        if (fromPrimary !== undefined)
+            return fromPrimary;
+        return fallback ? getValueAtPath(fallback, tail) : undefined;
+    }
+    return getValueAtPath(workingMemory, trimmed);
+}
+/**
+ * Working-memory view for Rendrix / smart-input: preserves all keys but overlays
+ * `input` and `inputs` with dual-root merge views (does not rewrite authored paths).
+ */
+function buildMemoryResolutionRootFromWorkingMemory(workingMemory) {
+    if (!isPlainObject(workingMemory))
+        return {};
+    const inputsBag = extractCallerInputsBag(workingMemory);
+    const mergedInput = coalesceMergedInputBucket(workingMemory);
+    return {
+        ...workingMemory,
+        input: mergeBucketViews(mergedInput, inputsBag),
+        inputs: mergeBucketViews(inputsBag, mergedInput)
+    };
+}
+/**
+ * When WM carries `input` and/or `inputs`, return a resolution root for template rendering.
+ * Otherwise returns the original reference unchanged.
+ */
+function prepareWorkingMemoryForTemplateRender(workingMemory) {
+    if (!isPlainObject(workingMemory))
+        return workingMemory;
+    if (workingMemory.input === undefined && workingMemory.inputs === undefined) {
+        return workingMemory;
+    }
+    return buildMemoryResolutionRootFromWorkingMemory(workingMemory);
+}
+/** Optional migration: rewrite `inputs.*` smart-input / memory paths to `input.*`. */
+function mapSmartInputPathsInputsToInput(paths) {
+    return paths.map((p) => {
+        const t = p.trim();
+        if (t === 'inputs')
+            return 'input';
+        if (t.startsWith('inputs.'))
+            return `input.${t.slice('inputs.'.length)}`;
+        return p;
+    });
+}

package/dist-cjs/memory-path-resolution.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Dual memory roots `input` (merged MAIN payload) and `inputs` (caller / graph-entry bag).
+ * Aligned with @exellix/graph-engine ≥ 5.5.0 resolution rules for template / smart-input paths.
+ */
+export declare const GATEWAY_DUAL_MEMORY_ROOTS: readonly ["input", "inputs"];
+export type GatewayDualMemoryRoot = (typeof GATEWAY_DUAL_MEMORY_ROOTS)[number];
+/**
+ * Parse JSON object shapes from strings (matches graph-engine `parseLooseJsonObject`).
+ */
+export declare function parseLooseJsonObject(value: unknown): Record<string, unknown> | undefined;
+/** Caller / graph-entry bag from `workingMemory.inputs`. */
+export declare function extractCallerInputsBag(workingMemory: unknown): Record<string, unknown> | undefined;
+/** Merged MAIN bucket from `workingMemory.input` (object or parsed JSON string). */
+export declare function coalesceMergedInputBucket(workingMemory: unknown): unknown;
+/**
+ * Resolve a dotted path against working memory with dual-root rules:
+ * - `inputs` / `inputs.*` → caller bag first, then merged `input`
+ * - `input` / `input.*` → merged `input` first, then caller `inputs`
+ * - other paths → direct lookup on working memory
+ */
+export declare function resolveGatewayMemoryPathValue(workingMemory: unknown, path: string): unknown;
+/**
+ * Working-memory view for Rendrix / smart-input: preserves all keys but overlays
+ * `input` and `inputs` with dual-root merge views (does not rewrite authored paths).
+ */
+export declare function buildMemoryResolutionRootFromWorkingMemory(workingMemory: unknown): Record<string, unknown>;
+/**
+ * When WM carries `input` and/or `inputs`, return a resolution root for template rendering.
+ * Otherwise returns the original reference unchanged.
+ */
+export declare function prepareWorkingMemoryForTemplateRender(workingMemory: unknown): unknown;
+/** Optional migration: rewrite `inputs.*` smart-input / memory paths to `input.*`. */
+export declare function mapSmartInputPathsInputsToInput(paths: string[]): string[];

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-parser.cjs

@@ -41,6 +41,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseTemplate = parseTemplate;
 exports.isParserAvailable = isParserAvailable;
+const memory_path_resolution_js_1 = require("./memory-path-resolution.cjs");
 let rendrixModule = null;
 let parserLoadPromise = null;
 async function loadRendrix() {
@@ -85,6 +86,7 @@ async function parseTemplate(template, workingMemory, taskConfig, shortTermMemor
     if (!workingMemory) {
         return template;
     }
+    const wmForRender = (0, memory_path_resolution_js_1.prepareWorkingMemoryForTemplateRender)(workingMemory);
     await loadRendrix();
     if (!rendrixModule) {
         return template;
@@ -94,18 +96,18 @@ async function parseTemplate(template, workingMemory, taskConfig, shortTermMemor
             ? rendrixModule
             : rendrixModule.default || rendrixModule;
         if (typeof api.render === 'function') {
-            return await api.render(template, workingMemory, shortTermMemory, experienceMemory, knowledgeMemory, undefined, // functionsMap
+            return await api.render(template, wmForRender, shortTermMemory, experienceMemory, knowledgeMemory, undefined, // functionsMap
             undefined, // choiceOptions
             undefined, // filesContent
             templateRenderOptions);
         }
         if (typeof api.parse === 'function') {
-            return await api.parse(template, workingMemory);
+            return await api.parse(template, wmForRender);
         }
         else if (typeof api === 'function') {
             const parser = new api();
             if (typeof parser.parse === 'function') {
-                return await parser.parse(template, workingMemory);
+                return await parser.parse(template, wmForRender);
             }
         }
         return template;

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']>>;
 /**
@@ -626,6 +626,10 @@ interface BaseLLMRequest extends Omit<LLMRequest, 'messages' | 'input' | 'reques
      * Working memory (optional) - Affects all template parsing
      * Passed to Rendrix (v4+) for template variable substitution.
      * Plain {{path}} tokens are MUST paths: undefined after merge throws TemplateResolutionError (rethrown by the gateway).
+     *
+     * Dual roots (graph-engine / ai-tasks contract): `inputs` is the caller / graph-entry bag;
+     * `input` is the merged MAIN payload (object or JSON string). Smart-input and `input.*` / `inputs.*`
+     * paths resolve with cross-root fallback before render (see `resolveGatewayMemoryPathValue`).
      */
     workingMemory?: unknown;
     /**
@@ -635,6 +639,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.6",
   "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",