@x12i/ai-dispatcher 3.0.0 → 3.2.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { ReasoningEffort, ReasoningOutcome } from '@x12i/ai-profiles';
-export { ReasoningEffort, ReasoningOutcome, registerHostIntents } from '@x12i/ai-profiles';
+export { ReasoningEffort, ReasoningOutcome, registerHostIntents, resolveAIProfile } from '@x12i/ai-profiles';
 import * as _x12i_openrouter_runtime from '@x12i/openrouter-runtime';
 import { RuntimeToolExecutor, RuntimeLogger, RuntimeRequest, RuntimeResponse, RuntimeUsage, RuntimeStreamEvent, CompiledOpenRouterRequest, OpenRouterRuntimeOptions } from '@x12i/openrouter-runtime';
 export { CompiledOpenRouterRequest, METADATA_NORMALIZATION_MAP, NormalizedMetadataKey, OpenRouterRuntimeOptions, RuntimeDefaults, RuntimeLogger, RuntimeMessage, RuntimeRequest, RuntimeResponse, RuntimeServerToolsPolicy, RuntimeStreamEvent, canonicalMetadataKey, decodeProviderMetadata, normalizeMetadata } from '@x12i/openrouter-runtime';
@@ -214,8 +214,9 @@ interface AiDispatcherRequest extends RuntimeRequest {
      */
     role?: RoleStamp;
     /**
-     * Provider-neutral reasoning intent. The bundled catalog chooses the wire action.
-     * An explicit provider control on the same request wins and the catalog is not called.
+     * Provider-neutral reasoning intent. `@x12i/ai-profiles` chooses the wire action
+     * from its reasoning catalog. An explicit provider control on the same request
+     * wins and the catalog is not called.
      */
     reasoningEffort?: ReasoningEffort;
     /**
@@ -289,6 +290,9 @@ interface AiDispatcherOptions {
      * The dispatcher trims on every call and adds a `METADATA_RECORD_TRIMMED` warning when it drops keys.
      * The default keeps `agentId`, `orgId`, `stepId`, `skillId`, `role`, `roleLayer`,
      * `roleDigest`, `profileChoice`, `recordId`, and `objectType`.
+     * A custom list replaces that default. Include `session_id`, `xtivix.caller`, and `xtivix.gate` when you pass one.
+     * With the default list, those short values stay until every longer unlisted value,
+     * including `xtivix.execution`, has been dropped.
      */
     metadataPriority?: readonly string[];
     logger?: RuntimeLogger;
@@ -380,10 +384,16 @@ interface AiDispatcher {
     readonly provider: AiProviderId;
 }
 
-/** Identity keys stay when a record has to be trimmed. Earlier entries are kept ahead of later ones. */
+/**
+ * Identity keys stay when a record has to be trimmed. Earlier entries are kept ahead of later ones.
+ * `session_id`, `xtivix.caller`, and `xtivix.gate` stay off this list. A custom `metadataPriority` should include them.
+ */
 declare const DEFAULT_METADATA_PRIORITY: readonly ["agentId", "orgId", "stepId", "skillId", "role", "roleLayer", "roleDigest", "profileChoice", "recordId", "objectType"];
 declare function createAiDispatcher(options?: AiDispatcherOptions): AiDispatcher;
 
+/** Stored as `xtivix.gate` on every call this package packs. */
+declare const AI_DISPATCHER_GATE = "ai-dispatcher";
+
 declare class AiDispatcherError extends Error {
     readonly code: string;
     readonly details?: unknown | undefined;
@@ -399,4 +409,4 @@ declare function stripReasoningHistoryFields<T>(message: T, paths: readonly stri
 
 declare function resolveProvider(requestProvider: AiProviderId | undefined, defaultProvider: AiProviderId): ImplementedAiProvider;
 
-export { type AiDispatcher, AiDispatcherError, type AiDispatcherOptions, type AiDispatcherRequest, type AiDispatcherResponse, type AiDispatcherUsage, type AiInputCodec, type AiInputCodecChoice, type AiInputFraming, type AiInputMode, type AiInputReadableFormat, type AiInputSettings, type AiInputSharing, type AiInputTokenizer, type AiProviderAdapter, type AiProviderId, type CacheMode, type CacheOutcome, type CachePolicy, type CacheResolution, type CacheTtl, type CloudflareBackoff, type CloudflareCallContext, type CloudflareEndpoint, type CloudflareEndpointChoice, type CloudflareGatewayControls, type CloudflareRequestOptions, type CloudflareRunOptions, type CloudflareRuntimeOptions, type CloudflareWebhookFormat, type CompiledAiRequest, type CompiledCloudflareRequest, type CompiledOpenAiRequest, DEFAULT_METADATA_PRIORITY, type DispatcherMcpOptions, type DispatcherMcpServer, type DispatcherMcpTool, IMPLEMENTED_AI_PROVIDERS, type ImplementedAiProvider, type InputResolution, type OpenAiRuntimeOptions, type ReasoningResolution, type RoleStamp, createAiDispatcher, isImplementedAiProvider, providerNotImplemented, resolveProvider, stripReasoningHistoryFields };
+export { AI_DISPATCHER_GATE, type AiDispatcher, AiDispatcherError, type AiDispatcherOptions, type AiDispatcherRequest, type AiDispatcherResponse, type AiDispatcherUsage, type AiInputCodec, type AiInputCodecChoice, type AiInputFraming, type AiInputMode, type AiInputReadableFormat, type AiInputSettings, type AiInputSharing, type AiInputTokenizer, type AiProviderAdapter, type AiProviderId, type CacheMode, type CacheOutcome, type CachePolicy, type CacheResolution, type CacheTtl, type CloudflareBackoff, type CloudflareCallContext, type CloudflareEndpoint, type CloudflareEndpointChoice, type CloudflareGatewayControls, type CloudflareRequestOptions, type CloudflareRunOptions, type CloudflareRuntimeOptions, type CloudflareWebhookFormat, type CompiledAiRequest, type CompiledCloudflareRequest, type CompiledOpenAiRequest, DEFAULT_METADATA_PRIORITY, type DispatcherMcpOptions, type DispatcherMcpServer, type DispatcherMcpTool, IMPLEMENTED_AI_PROVIDERS, type ImplementedAiProvider, type InputResolution, type OpenAiRuntimeOptions, type ReasoningResolution, type RoleStamp, createAiDispatcher, isImplementedAiProvider, providerNotImplemented, resolveProvider, stripReasoningHistoryFields };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { ReasoningEffort, ReasoningOutcome } from '@x12i/ai-profiles';
-export { ReasoningEffort, ReasoningOutcome, registerHostIntents } from '@x12i/ai-profiles';
+export { ReasoningEffort, ReasoningOutcome, registerHostIntents, resolveAIProfile } from '@x12i/ai-profiles';
 import * as _x12i_openrouter_runtime from '@x12i/openrouter-runtime';
 import { RuntimeToolExecutor, RuntimeLogger, RuntimeRequest, RuntimeResponse, RuntimeUsage, RuntimeStreamEvent, CompiledOpenRouterRequest, OpenRouterRuntimeOptions } from '@x12i/openrouter-runtime';
 export { CompiledOpenRouterRequest, METADATA_NORMALIZATION_MAP, NormalizedMetadataKey, OpenRouterRuntimeOptions, RuntimeDefaults, RuntimeLogger, RuntimeMessage, RuntimeRequest, RuntimeResponse, RuntimeServerToolsPolicy, RuntimeStreamEvent, canonicalMetadataKey, decodeProviderMetadata, normalizeMetadata } from '@x12i/openrouter-runtime';
@@ -214,8 +214,9 @@ interface AiDispatcherRequest extends RuntimeRequest {
      */
     role?: RoleStamp;
     /**
-     * Provider-neutral reasoning intent. The bundled catalog chooses the wire action.
-     * An explicit provider control on the same request wins and the catalog is not called.
+     * Provider-neutral reasoning intent. `@x12i/ai-profiles` chooses the wire action
+     * from its reasoning catalog. An explicit provider control on the same request
+     * wins and the catalog is not called.
      */
     reasoningEffort?: ReasoningEffort;
     /**
@@ -289,6 +290,9 @@ interface AiDispatcherOptions {
      * The dispatcher trims on every call and adds a `METADATA_RECORD_TRIMMED` warning when it drops keys.
      * The default keeps `agentId`, `orgId`, `stepId`, `skillId`, `role`, `roleLayer`,
      * `roleDigest`, `profileChoice`, `recordId`, and `objectType`.
+     * A custom list replaces that default. Include `session_id`, `xtivix.caller`, and `xtivix.gate` when you pass one.
+     * With the default list, those short values stay until every longer unlisted value,
+     * including `xtivix.execution`, has been dropped.
      */
     metadataPriority?: readonly string[];
     logger?: RuntimeLogger;
@@ -380,10 +384,16 @@ interface AiDispatcher {
     readonly provider: AiProviderId;
 }
 
-/** Identity keys stay when a record has to be trimmed. Earlier entries are kept ahead of later ones. */
+/**
+ * Identity keys stay when a record has to be trimmed. Earlier entries are kept ahead of later ones.
+ * `session_id`, `xtivix.caller`, and `xtivix.gate` stay off this list. A custom `metadataPriority` should include them.
+ */
 declare const DEFAULT_METADATA_PRIORITY: readonly ["agentId", "orgId", "stepId", "skillId", "role", "roleLayer", "roleDigest", "profileChoice", "recordId", "objectType"];
 declare function createAiDispatcher(options?: AiDispatcherOptions): AiDispatcher;
 
+/** Stored as `xtivix.gate` on every call this package packs. */
+declare const AI_DISPATCHER_GATE = "ai-dispatcher";
+
 declare class AiDispatcherError extends Error {
     readonly code: string;
     readonly details?: unknown | undefined;
@@ -399,4 +409,4 @@ declare function stripReasoningHistoryFields<T>(message: T, paths: readonly stri
 
 declare function resolveProvider(requestProvider: AiProviderId | undefined, defaultProvider: AiProviderId): ImplementedAiProvider;
 
-export { type AiDispatcher, AiDispatcherError, type AiDispatcherOptions, type AiDispatcherRequest, type AiDispatcherResponse, type AiDispatcherUsage, type AiInputCodec, type AiInputCodecChoice, type AiInputFraming, type AiInputMode, type AiInputReadableFormat, type AiInputSettings, type AiInputSharing, type AiInputTokenizer, type AiProviderAdapter, type AiProviderId, type CacheMode, type CacheOutcome, type CachePolicy, type CacheResolution, type CacheTtl, type CloudflareBackoff, type CloudflareCallContext, type CloudflareEndpoint, type CloudflareEndpointChoice, type CloudflareGatewayControls, type CloudflareRequestOptions, type CloudflareRunOptions, type CloudflareRuntimeOptions, type CloudflareWebhookFormat, type CompiledAiRequest, type CompiledCloudflareRequest, type CompiledOpenAiRequest, DEFAULT_METADATA_PRIORITY, type DispatcherMcpOptions, type DispatcherMcpServer, type DispatcherMcpTool, IMPLEMENTED_AI_PROVIDERS, type ImplementedAiProvider, type InputResolution, type OpenAiRuntimeOptions, type ReasoningResolution, type RoleStamp, createAiDispatcher, isImplementedAiProvider, providerNotImplemented, resolveProvider, stripReasoningHistoryFields };
+export { AI_DISPATCHER_GATE, type AiDispatcher, AiDispatcherError, type AiDispatcherOptions, type AiDispatcherRequest, type AiDispatcherResponse, type AiDispatcherUsage, type AiInputCodec, type AiInputCodecChoice, type AiInputFraming, type AiInputMode, type AiInputReadableFormat, type AiInputSettings, type AiInputSharing, type AiInputTokenizer, type AiProviderAdapter, type AiProviderId, type CacheMode, type CacheOutcome, type CachePolicy, type CacheResolution, type CacheTtl, type CloudflareBackoff, type CloudflareCallContext, type CloudflareEndpoint, type CloudflareEndpointChoice, type CloudflareGatewayControls, type CloudflareRequestOptions, type CloudflareRunOptions, type CloudflareRuntimeOptions, type CloudflareWebhookFormat, type CompiledAiRequest, type CompiledCloudflareRequest, type CompiledOpenAiRequest, DEFAULT_METADATA_PRIORITY, type DispatcherMcpOptions, type DispatcherMcpServer, type DispatcherMcpTool, IMPLEMENTED_AI_PROVIDERS, type ImplementedAiProvider, type InputResolution, type OpenAiRuntimeOptions, type ReasoningResolution, type RoleStamp, createAiDispatcher, isImplementedAiProvider, providerNotImplemented, resolveProvider, stripReasoningHistoryFields };

package/dist/index.js

@@ -1,5 +1,5 @@
 // src/index.ts
-import { registerHostIntents } from "@x12i/ai-profiles";
+import { registerHostIntents, resolveAIProfile } from "@x12i/ai-profiles";
 import {
   decodeProviderMetadata,
   METADATA_NORMALIZATION_MAP,
@@ -2619,6 +2619,7 @@ function prepareDispatchRequest(params) {
   applyRoleStamp(cloned);
   applyDispatchIdentity(cloned);
   absorbOverrideMetadata(cloned);
+  applyDispatchGate(cloned);
   const provider = params.provider;
   const reasoningEffort = cloned.reasoningEffort;
   const bedrockControls = cloned.bedrockControls;
@@ -2971,6 +2972,12 @@ function applyDispatchIdentity(request) {
   for (const key of Object.keys(identity)) delete rest[key];
   request.metadata = { ...identity, ...rest };
 }
+var AI_DISPATCHER_GATE = "ai-dispatcher";
+function applyDispatchGate(request) {
+  const rest = { ...request.metadata ?? {} };
+  delete rest["xtivix.gate"];
+  request.metadata = { "xtivix.gate": AI_DISPATCHER_GATE, ...rest };
+}
 function cloneRequest(request) {
   const functionTools = request.functionTools?.map((tool) => ({ ...tool }));
   const cloned = JSON.parse(JSON.stringify(request));
@@ -4000,6 +4007,7 @@ function stripReasoningHistoryFields(message, paths) {
   return clone;
 }
 export {
+  AI_DISPATCHER_GATE,
   AiDispatcherError,
   DEFAULT_METADATA_PRIORITY,
   IMPLEMENTED_AI_PROVIDERS,
@@ -4011,6 +4019,7 @@ export {
   normalizeMetadata,
   providerNotImplemented,
   registerHostIntents,
+  resolveAIProfile,
   resolveProvider,
   stripReasoningHistoryFields
 };