@x12i/ai-dispatcher 2.2.0 → 2.3.1

package/dist/index.d.cts

@@ -1,8 +1,8 @@
+import { ReasoningEffort, ReasoningOutcome } from '@x12i/ai-profiles';
+export { ReasoningEffort, ReasoningOutcome, registerHostIntents } 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';
-import { ReasoningEffort, ReasoningOutcome } from '@x12i/ai-profiles';
-export { ReasoningEffort, ReasoningOutcome } from '@x12i/ai-profiles';
 import { CompiledBedrockRequest, BedrockRuntimeOptions } from '@x12i/bedrock-runtime';
 export { BedrockClientLike, BedrockCredentials, BedrockRuntimeOptions, CompiledBedrockRequest } from '@x12i/bedrock-runtime';
 
@@ -93,6 +93,13 @@ interface OpenAiRuntimeOptions {
     logger?: RuntimeLogger;
 }
 
+/** Caller role stamp. Omitted or blank fields are not stored. */
+interface RoleStamp {
+    role?: string;
+    roleLayer?: string;
+    roleDigest?: string;
+    profileChoice?: string;
+}
 /**
  * Catalog resolution for one call.
  * `outcome` is present only when the catalog resolver ran.
@@ -152,6 +159,12 @@ interface AiDispatcherRequest extends RuntimeRequest {
      * Caller skill id. Stored in the one provider metadata record as `skillId`.
      */
     skillId?: string;
+    /**
+     * Role resolution stamp. Expanded into the metadata record as `role`, `roleLayer`,
+     * `roleDigest`, and `profileChoice`. A set field wins over the same key in `metadata`.
+     * Stripped before the provider payload is built.
+     */
+    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.
@@ -219,7 +232,8 @@ interface AiDispatcherOptions {
      * Highest priority first for the one metadata record.
      * Listed keys are kept ahead of keys that are not in the list.
      * The dispatcher trims on every call and adds a `METADATA_RECORD_TRIMMED` warning when it drops keys.
-     * The default keeps `agentId`, `orgId`, `stepId`, `skillId`, `recordId`, and `objectType`.
+     * The default keeps `agentId`, `orgId`, `stepId`, `skillId`, `role`, `roleLayer`,
+     * `roleDigest`, `profileChoice`, `recordId`, and `objectType`.
      */
     metadataPriority?: readonly string[];
     logger?: RuntimeLogger;
@@ -302,7 +316,7 @@ interface AiDispatcher {
 }
 
 /** Identity keys stay when a record has to be trimmed. Earlier entries are kept ahead of later ones. */
-declare const DEFAULT_METADATA_PRIORITY: readonly ["agentId", "orgId", "stepId", "skillId", "recordId", "objectType"];
+declare const DEFAULT_METADATA_PRIORITY: readonly ["agentId", "orgId", "stepId", "skillId", "role", "roleLayer", "roleDigest", "profileChoice", "recordId", "objectType"];
 declare function createAiDispatcher(options?: AiDispatcherOptions): AiDispatcher;
 
 declare class AiDispatcherError extends Error {
@@ -320,4 +334,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 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 OpenAiRuntimeOptions, type ReasoningResolution, createAiDispatcher, isImplementedAiProvider, providerNotImplemented, resolveProvider, stripReasoningHistoryFields };
+export { type AiDispatcher, AiDispatcherError, type AiDispatcherOptions, type AiDispatcherRequest, type AiDispatcherResponse, type AiDispatcherUsage, 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 OpenAiRuntimeOptions, type ReasoningResolution, type RoleStamp, createAiDispatcher, isImplementedAiProvider, providerNotImplemented, resolveProvider, stripReasoningHistoryFields };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
+import { ReasoningEffort, ReasoningOutcome } from '@x12i/ai-profiles';
+export { ReasoningEffort, ReasoningOutcome, registerHostIntents } 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';
-import { ReasoningEffort, ReasoningOutcome } from '@x12i/ai-profiles';
-export { ReasoningEffort, ReasoningOutcome } from '@x12i/ai-profiles';
 import { CompiledBedrockRequest, BedrockRuntimeOptions } from '@x12i/bedrock-runtime';
 export { BedrockClientLike, BedrockCredentials, BedrockRuntimeOptions, CompiledBedrockRequest } from '@x12i/bedrock-runtime';
 
@@ -93,6 +93,13 @@ interface OpenAiRuntimeOptions {
     logger?: RuntimeLogger;
 }
 
+/** Caller role stamp. Omitted or blank fields are not stored. */
+interface RoleStamp {
+    role?: string;
+    roleLayer?: string;
+    roleDigest?: string;
+    profileChoice?: string;
+}
 /**
  * Catalog resolution for one call.
  * `outcome` is present only when the catalog resolver ran.
@@ -152,6 +159,12 @@ interface AiDispatcherRequest extends RuntimeRequest {
      * Caller skill id. Stored in the one provider metadata record as `skillId`.
      */
     skillId?: string;
+    /**
+     * Role resolution stamp. Expanded into the metadata record as `role`, `roleLayer`,
+     * `roleDigest`, and `profileChoice`. A set field wins over the same key in `metadata`.
+     * Stripped before the provider payload is built.
+     */
+    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.
@@ -219,7 +232,8 @@ interface AiDispatcherOptions {
      * Highest priority first for the one metadata record.
      * Listed keys are kept ahead of keys that are not in the list.
      * The dispatcher trims on every call and adds a `METADATA_RECORD_TRIMMED` warning when it drops keys.
-     * The default keeps `agentId`, `orgId`, `stepId`, `skillId`, `recordId`, and `objectType`.
+     * The default keeps `agentId`, `orgId`, `stepId`, `skillId`, `role`, `roleLayer`,
+     * `roleDigest`, `profileChoice`, `recordId`, and `objectType`.
      */
     metadataPriority?: readonly string[];
     logger?: RuntimeLogger;
@@ -302,7 +316,7 @@ interface AiDispatcher {
 }
 
 /** Identity keys stay when a record has to be trimmed. Earlier entries are kept ahead of later ones. */
-declare const DEFAULT_METADATA_PRIORITY: readonly ["agentId", "orgId", "stepId", "skillId", "recordId", "objectType"];
+declare const DEFAULT_METADATA_PRIORITY: readonly ["agentId", "orgId", "stepId", "skillId", "role", "roleLayer", "roleDigest", "profileChoice", "recordId", "objectType"];
 declare function createAiDispatcher(options?: AiDispatcherOptions): AiDispatcher;
 
 declare class AiDispatcherError extends Error {
@@ -320,4 +334,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 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 OpenAiRuntimeOptions, type ReasoningResolution, createAiDispatcher, isImplementedAiProvider, providerNotImplemented, resolveProvider, stripReasoningHistoryFields };
+export { type AiDispatcher, AiDispatcherError, type AiDispatcherOptions, type AiDispatcherRequest, type AiDispatcherResponse, type AiDispatcherUsage, 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 OpenAiRuntimeOptions, type ReasoningResolution, type RoleStamp, createAiDispatcher, isImplementedAiProvider, providerNotImplemented, resolveProvider, stripReasoningHistoryFields };

package/dist/index.js

@@ -1,4 +1,5 @@
 // src/index.ts
+import { registerHostIntents } from "@x12i/ai-profiles";
 import {
   decodeProviderMetadata,
   METADATA_NORMALIZATION_MAP,
@@ -2328,6 +2329,7 @@ function isRecord5(value) {
 // src/prepare-request.ts
 function prepareDispatchRequest(params) {
   const cloned = cloneRequest(params.request);
+  applyRoleStamp(cloned);
   applyDispatchIdentity(cloned);
   absorbOverrideMetadata(cloned);
   const provider = params.provider;
@@ -2635,6 +2637,23 @@ function defaultModelFor(provider, options) {
   return options.openai?.defaultModel;
 }
 var DISPATCH_IDENTITY_FIELDS = ["orgId", "stepId", "skillId"];
+var ROLE_STAMP_FIELDS = ["role", "roleLayer", "roleDigest", "profileChoice"];
+function applyRoleStamp(request) {
+  const stamp = request.role;
+  delete request.role;
+  if (!isRecord6(stamp)) return;
+  const identity = {};
+  for (const field of ROLE_STAMP_FIELDS) {
+    const value = stamp[field];
+    if (typeof value !== "string") continue;
+    const trimmed = value.trim();
+    if (trimmed) identity[field] = trimmed;
+  }
+  if (!Object.keys(identity).length) return;
+  const rest = { ...request.metadata ?? {} };
+  for (const key of Object.keys(identity)) delete rest[key];
+  request.metadata = { ...identity, ...rest };
+}
 function absorbOverrideMetadata(request) {
   const overrides = request.rawOpenRouterOverrides;
   if (!isRecord6(overrides) || !Object.prototype.hasOwnProperty.call(overrides, "metadata")) return;
@@ -3240,8 +3259,7 @@ async function readFailure2(response) {
 function classifyStatus2(status) {
   if (status === 401 || status === 403) return "PROVIDER_AUTH_FAILED";
   if (status === 404) return "PROVIDER_MODEL_NOT_FOUND";
-  if (status === 429) return "PROVIDER_RATE_LIMITED";
-  if (status === 408 || status >= 500) return "PROVIDER_RETRYABLE";
+  if (status === 429 || status === 408 || status >= 500) return "PROVIDER_RETRYABLE";
   return "PROVIDER_REQUEST_FAILED";
 }
 function isConfigError2(code) {
@@ -3249,6 +3267,8 @@ function isConfigError2(code) {
 }
 function asTerminalError2(error) {
   if (error instanceof AiDispatcherError && error.code === "PROVIDER_RETRYABLE") {
+    const status = isRecord7(error.details) ? error.details.status : void 0;
+    if (status === 429) return new AiDispatcherError("PROVIDER_RATE_LIMITED", error.message, error.details);
     return new AiDispatcherError("PROVIDER_GATEWAY_UNREACHABLE", error.message, error.details);
   }
   if (error instanceof AiDispatcherError) return error;
@@ -3510,7 +3530,18 @@ function resolveProvider(requestProvider, defaultProvider) {
 
 // src/create-dispatcher.ts
 var SECRET_HEADERS = /* @__PURE__ */ new Set(["authorization", "x-api-key", "api-key"]);
-var DEFAULT_METADATA_PRIORITY = ["agentId", "orgId", "stepId", "skillId", "recordId", "objectType"];
+var DEFAULT_METADATA_PRIORITY = [
+  "agentId",
+  "orgId",
+  "stepId",
+  "skillId",
+  "role",
+  "roleLayer",
+  "roleDigest",
+  "profileChoice",
+  "recordId",
+  "objectType"
+];
 function createAiDispatcher(options = {}) {
   const packer = createMetadataPacker({ priority: options.metadataPriority ?? DEFAULT_METADATA_PRIORITY });
   const defaultProvider = resolveProvider(options.provider, "openrouter");
@@ -3675,6 +3706,7 @@ export {
   isImplementedAiProvider,
   normalizeMetadata,
   providerNotImplemented,
+  registerHostIntents,
   resolveProvider,
   stripReasoningHistoryFields
 };