@omnicross/core 0.1.8 → 0.1.10

package/dist/transformer/transformers/OpenAIResponseTransformer.d.cts

@@ -1,4 +1,6 @@
 import { Transformer, TransformerLogger, LLMProvider, TransformerContext, UnifiedChatRequest } from '../types.cjs';
+import '@omnicross/contracts/llm-config';
+import '@omnicross/contracts/completion-types';
 
 /**
  * OpenAIResponseTransformer - Transformer for OpenAI Responses API
@@ -35,11 +37,11 @@ declare class OpenAIResponseTransformer implements Transformer {
     /**
      * Transform unified request → Response API format
      */
-    transformRequestIn(request: UnifiedChatRequest, provider: LLMProvider, _context: TransformerContext): Promise<Record<string, unknown>>;
+    transformRequestIn(request: UnifiedChatRequest, provider: LLMProvider, context: TransformerContext): Promise<Record<string, unknown>>;
     /**
      * Transform Response API request → unified format
      */
-    transformRequestOut(request: unknown, _context: TransformerContext): Promise<UnifiedChatRequest>;
+    transformRequestOut(request: unknown, context: TransformerContext): Promise<UnifiedChatRequest>;
     /**
      * Transform Response API response → unified (OpenAI CC) format
      */

package/dist/transformer/transformers/OpenAIResponseTransformer.d.ts

@@ -1,4 +1,6 @@
 import { Transformer, TransformerLogger, LLMProvider, TransformerContext, UnifiedChatRequest } from '../types.js';
+import '@omnicross/contracts/llm-config';
+import '@omnicross/contracts/completion-types';
 
 /**
  * OpenAIResponseTransformer - Transformer for OpenAI Responses API
@@ -35,11 +37,11 @@ declare class OpenAIResponseTransformer implements Transformer {
     /**
      * Transform unified request → Response API format
      */
-    transformRequestIn(request: UnifiedChatRequest, provider: LLMProvider, _context: TransformerContext): Promise<Record<string, unknown>>;
+    transformRequestIn(request: UnifiedChatRequest, provider: LLMProvider, context: TransformerContext): Promise<Record<string, unknown>>;
     /**
      * Transform Response API request → unified format
      */
-    transformRequestOut(request: unknown, _context: TransformerContext): Promise<UnifiedChatRequest>;
+    transformRequestOut(request: unknown, context: TransformerContext): Promise<UnifiedChatRequest>;
     /**
      * Transform Response API response → unified (OpenAI CC) format
      */

package/dist/transformer/transformers/OpenAIResponseTransformer.js

@@ -1,7 +1,8 @@
 import {
   OpenAIResponseTransformer
-} from "../../chunk-32O35CIF.js";
+} from "../../chunk-45FHEOKW.js";
 import "../../chunk-FU7EAR73.js";
+import "../../chunk-N2EIM2XJ.js";
 export {
   OpenAIResponseTransformer
 };

package/dist/transformer/transformers/OpenAITransformer.cjs

@@ -1,6 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkOF3BECU2cjs = require('../../chunk-OF3BECU2.cjs');
+var _chunk56QD3YW6cjs = require('../../chunk-56QD3YW6.cjs');
+require('../../chunk-AOFWNWLT.cjs');
 
 
-exports.OpenAITransformer = _chunkOF3BECU2cjs.OpenAITransformer;
+exports.OpenAITransformer = _chunk56QD3YW6cjs.OpenAITransformer;

package/dist/transformer/transformers/OpenAITransformer.d.cts

@@ -1,4 +1,6 @@
 import { Transformer, TransformerLogger, UnifiedChatRequest, LLMProvider, TransformerContext } from '../types.cjs';
+import '@omnicross/contracts/llm-config';
+import '@omnicross/contracts/completion-types';
 
 /**
  * OpenAITransformer — the format-axis encoder for OpenAI Chat Completions
@@ -57,7 +59,7 @@ declare class OpenAITransformer implements Transformer {
     /**
      * Unified → OpenAI Chat Completions.
      */
-    transformRequestIn(request: UnifiedChatRequest, _provider: LLMProvider, _context: TransformerContext): Promise<Record<string, unknown>>;
+    transformRequestIn(request: UnifiedChatRequest, provider: LLMProvider, _context: TransformerContext): Promise<Record<string, unknown>>;
     /**
      * OpenAI Chat Completions → Unified. Identity — see the module JSDoc for why
      * `reasoning_content` is NOT rewritten here.

package/dist/transformer/transformers/OpenAITransformer.d.ts

@@ -1,4 +1,6 @@
 import { Transformer, TransformerLogger, UnifiedChatRequest, LLMProvider, TransformerContext } from '../types.js';
+import '@omnicross/contracts/llm-config';
+import '@omnicross/contracts/completion-types';
 
 /**
  * OpenAITransformer — the format-axis encoder for OpenAI Chat Completions
@@ -57,7 +59,7 @@ declare class OpenAITransformer implements Transformer {
     /**
      * Unified → OpenAI Chat Completions.
      */
-    transformRequestIn(request: UnifiedChatRequest, _provider: LLMProvider, _context: TransformerContext): Promise<Record<string, unknown>>;
+    transformRequestIn(request: UnifiedChatRequest, provider: LLMProvider, _context: TransformerContext): Promise<Record<string, unknown>>;
     /**
      * OpenAI Chat Completions → Unified. Identity — see the module JSDoc for why
      * `reasoning_content` is NOT rewritten here.

package/dist/transformer/transformers/OpenAITransformer.js

@@ -1,6 +1,7 @@
 import {
   OpenAITransformer
-} from "../../chunk-LB6EBS6Y.js";
+} from "../../chunk-CCVRRJOX.js";
+import "../../chunk-N2EIM2XJ.js";
 export {
   OpenAITransformer
 };

package/dist/transformer/transformers.cjs

@@ -3,24 +3,26 @@
 
 
 
-var _chunk2Z4XM3H5cjs = require('../chunk-2Z4XM3H5.cjs');
+var _chunkP7EM6BNDcjs = require('../chunk-P7EM6BND.cjs');
 
 
-var _chunkOXHNSZ53cjs = require('../chunk-OXHNSZ53.cjs');
+var _chunkZQQUD66Mcjs = require('../chunk-ZQQUD66M.cjs');
 
 
-var _chunkV4TXMEJScjs = require('../chunk-V4TXMEJS.cjs');
+var _chunk5LNYGCIWcjs = require('../chunk-5LNYGCIW.cjs');
 
 
-var _chunkOVQBNVSVcjs = require('../chunk-OVQBNVSV.cjs');
+var _chunkCMVXX7ONcjs = require('../chunk-CMVXX7ON.cjs');
 require('../chunk-5RSZYQJH.cjs');
 
 
-var _chunkOF3BECU2cjs = require('../chunk-OF3BECU2.cjs');
+var _chunk56QD3YW6cjs = require('../chunk-56QD3YW6.cjs');
 
 
-var _chunkOKMJLEXXcjs = require('../chunk-OKMJLEXX.cjs');
-require('../chunk-KBM2W6UY.cjs');
+var _chunkOC6DOOFXcjs = require('../chunk-OC6DOOFX.cjs');
+require('../chunk-RICPANBY.cjs');
+require('../chunk-77USGNRW.cjs');
+require('../chunk-AOFWNWLT.cjs');
 
 
 
@@ -31,4 +33,4 @@ require('../chunk-KBM2W6UY.cjs');
 
 
 
-exports.AnthropicTransformer = _chunkOXHNSZ53cjs.AnthropicTransformer; exports.BUILTIN_TRANSFORMER_NAMES = _chunk2Z4XM3H5cjs.BUILTIN_TRANSFORMER_NAMES; exports.BuiltinTransformers = _chunk2Z4XM3H5cjs.BuiltinTransformers; exports.GeminiCodeAssistTransformer = _chunkOKMJLEXXcjs.GeminiCodeAssistTransformer; exports.GeminiTransformer = _chunkV4TXMEJScjs.GeminiTransformer; exports.OpenAIResponseTransformer = _chunkOVQBNVSVcjs.OpenAIResponseTransformer; exports.OpenAITransformer = _chunkOF3BECU2cjs.OpenAITransformer; exports.getBuiltinTransformers = _chunk2Z4XM3H5cjs.getBuiltinTransformers; exports.registerBuiltinTransformers = _chunk2Z4XM3H5cjs.registerBuiltinTransformers;
+exports.AnthropicTransformer = _chunkZQQUD66Mcjs.AnthropicTransformer; exports.BUILTIN_TRANSFORMER_NAMES = _chunkP7EM6BNDcjs.BUILTIN_TRANSFORMER_NAMES; exports.BuiltinTransformers = _chunkP7EM6BNDcjs.BuiltinTransformers; exports.GeminiCodeAssistTransformer = _chunkOC6DOOFXcjs.GeminiCodeAssistTransformer; exports.GeminiTransformer = _chunk5LNYGCIWcjs.GeminiTransformer; exports.OpenAIResponseTransformer = _chunkCMVXX7ONcjs.OpenAIResponseTransformer; exports.OpenAITransformer = _chunk56QD3YW6cjs.OpenAITransformer; exports.getBuiltinTransformers = _chunkP7EM6BNDcjs.getBuiltinTransformers; exports.registerBuiltinTransformers = _chunkP7EM6BNDcjs.registerBuiltinTransformers;

package/dist/transformer/transformers.d.cts

@@ -5,6 +5,8 @@ import { GeminiTransformer } from './transformers/GeminiTransformer.cjs';
 import { OpenAIResponseTransformer } from './transformers/OpenAIResponseTransformer.cjs';
 import { OpenAITransformer } from './transformers/OpenAITransformer.cjs';
 import './types.cjs';
+import '@omnicross/contracts/llm-config';
+import '@omnicross/contracts/completion-types';
 
 /**
  * Transformer Registry

package/dist/transformer/transformers.d.ts

@@ -5,6 +5,8 @@ import { GeminiTransformer } from './transformers/GeminiTransformer.js';
 import { OpenAIResponseTransformer } from './transformers/OpenAIResponseTransformer.js';
 import { OpenAITransformer } from './transformers/OpenAITransformer.js';
 import './types.js';
+import '@omnicross/contracts/llm-config';
+import '@omnicross/contracts/completion-types';
 
 /**
  * Transformer Registry

package/dist/transformer/transformers.js

@@ -3,24 +3,26 @@ import {
   BuiltinTransformers,
   getBuiltinTransformers,
   registerBuiltinTransformers
-} from "../chunk-MYYR3HZL.js";
+} from "../chunk-NGYOO5TO.js";
 import {
   AnthropicTransformer
-} from "../chunk-PEGTIPB3.js";
+} from "../chunk-HKB656B4.js";
 import {
   GeminiTransformer
-} from "../chunk-LVUCAWMK.js";
+} from "../chunk-55FMGZ3L.js";
 import {
   OpenAIResponseTransformer
-} from "../chunk-32O35CIF.js";
+} from "../chunk-45FHEOKW.js";
 import "../chunk-FU7EAR73.js";
 import {
   OpenAITransformer
-} from "../chunk-LB6EBS6Y.js";
+} from "../chunk-CCVRRJOX.js";
 import {
   GeminiCodeAssistTransformer
-} from "../chunk-N5T4M4GU.js";
-import "../chunk-TOVPMMHM.js";
+} from "../chunk-2UTGX6FM.js";
+import "../chunk-S3DYFEBE.js";
+import "../chunk-WYVGULTQ.js";
+import "../chunk-N2EIM2XJ.js";
 export {
   AnthropicTransformer,
   BUILTIN_TRANSFORMER_NAMES,

package/dist/transformer/types.d.cts

@@ -1,3 +1,7 @@
+import { ModelConfig } from '@omnicross/contracts/llm-config';
+import { ThinkLevel } from '@omnicross/contracts/completion-types';
+export { ThinkLevel } from '@omnicross/contracts/completion-types';
+
 /**
  * TransformerService Types
  *
@@ -6,10 +10,7 @@
  *
  * @module transformer/types
  */
-/**
- * Thinking effort level for reasoning models
- */
-type ThinkLevel = 'none' | 'low' | 'medium' | 'high';
+
 /**
  * Thinking content with optional signature for extended context
  */
@@ -118,6 +119,8 @@ interface UnifiedChatRequest {
     tools?: UnifiedTool[];
     tool_choice?: ToolChoice;
     reasoning?: ReasoningConfig;
+    /** Native OpenAI Chat field retained by the identity-shaped ingress. */
+    reasoning_effort?: string;
     /**
      * Internal-only routing metadata. Populated by callers (CompletionService /
      * the host's engine adapters and proxy servers) so the usage-capture hook can attribute
@@ -255,6 +258,8 @@ interface LLMProvider {
     baseUrl: string;
     apiKey: string;
     models: string[];
+    /** Effective per-model capability overrides used by target encoders. */
+    modelConfigs?: Array<Pick<ModelConfig, 'id'> & Partial<ModelConfig>>;
     transformer?: TransformerChainConfig;
     /**
      * Resolved Google **Code Assist** project id, threaded onto the transformer
@@ -298,6 +303,12 @@ interface TransformerContext {
     logger?: TransformerLogger;
     /** Provider name */
     providerName?: string;
+    /**
+     * Native request format that supplied a recognized reasoning effort.
+     * Target encoders use this provenance to preserve same-format values while
+     * continuing to negotiate genuine cross-format conversions.
+     */
+    reasoningSourceFormat?: string;
     /** Additional context data */
     [key: string]: unknown;
 }
@@ -419,4 +430,4 @@ interface TransformerServiceConfig {
     transformers?: TransformerConfigEntry[];
 }
 
-export type { Annotation, ImageContent, LLMProvider, MessageContent, ModelRoute, ModelTransformerConfig, ReasoningConfig, RequestConfig, RequestRouteInfo, ResolvedTransformerChain, StreamChunk, TextContent, ThinkLevel, ThinkingContent, ToolCall, ToolChoice, ToolParameterSchema, TransformRequestResult, Transformer, TransformerChainConfig, TransformerConfigEntry, TransformerConstructor, TransformerContext, TransformerLogger, TransformerOptions, TransformerReference, TransformerServiceConfig, UnifiedChatRequest, UnifiedChatRequestMeta, UnifiedChatResponse, UnifiedMessage, UnifiedTool, UrlCitation };
+export type { Annotation, ImageContent, LLMProvider, MessageContent, ModelRoute, ModelTransformerConfig, ReasoningConfig, RequestConfig, RequestRouteInfo, ResolvedTransformerChain, StreamChunk, TextContent, ThinkingContent, ToolCall, ToolChoice, ToolParameterSchema, TransformRequestResult, Transformer, TransformerChainConfig, TransformerConfigEntry, TransformerConstructor, TransformerContext, TransformerLogger, TransformerOptions, TransformerReference, TransformerServiceConfig, UnifiedChatRequest, UnifiedChatRequestMeta, UnifiedChatResponse, UnifiedMessage, UnifiedTool, UrlCitation };

package/dist/transformer/types.d.ts

@@ -1,3 +1,7 @@
+import { ModelConfig } from '@omnicross/contracts/llm-config';
+import { ThinkLevel } from '@omnicross/contracts/completion-types';
+export { ThinkLevel } from '@omnicross/contracts/completion-types';
+
 /**
  * TransformerService Types
  *
@@ -6,10 +10,7 @@
  *
  * @module transformer/types
  */
-/**
- * Thinking effort level for reasoning models
- */
-type ThinkLevel = 'none' | 'low' | 'medium' | 'high';
+
 /**
  * Thinking content with optional signature for extended context
  */
@@ -118,6 +119,8 @@ interface UnifiedChatRequest {
     tools?: UnifiedTool[];
     tool_choice?: ToolChoice;
     reasoning?: ReasoningConfig;
+    /** Native OpenAI Chat field retained by the identity-shaped ingress. */
+    reasoning_effort?: string;
     /**
      * Internal-only routing metadata. Populated by callers (CompletionService /
      * the host's engine adapters and proxy servers) so the usage-capture hook can attribute
@@ -255,6 +258,8 @@ interface LLMProvider {
     baseUrl: string;
     apiKey: string;
     models: string[];
+    /** Effective per-model capability overrides used by target encoders. */
+    modelConfigs?: Array<Pick<ModelConfig, 'id'> & Partial<ModelConfig>>;
     transformer?: TransformerChainConfig;
     /**
      * Resolved Google **Code Assist** project id, threaded onto the transformer
@@ -298,6 +303,12 @@ interface TransformerContext {
     logger?: TransformerLogger;
     /** Provider name */
     providerName?: string;
+    /**
+     * Native request format that supplied a recognized reasoning effort.
+     * Target encoders use this provenance to preserve same-format values while
+     * continuing to negotiate genuine cross-format conversions.
+     */
+    reasoningSourceFormat?: string;
     /** Additional context data */
     [key: string]: unknown;
 }
@@ -419,4 +430,4 @@ interface TransformerServiceConfig {
     transformers?: TransformerConfigEntry[];
 }
 
-export type { Annotation, ImageContent, LLMProvider, MessageContent, ModelRoute, ModelTransformerConfig, ReasoningConfig, RequestConfig, RequestRouteInfo, ResolvedTransformerChain, StreamChunk, TextContent, ThinkLevel, ThinkingContent, ToolCall, ToolChoice, ToolParameterSchema, TransformRequestResult, Transformer, TransformerChainConfig, TransformerConfigEntry, TransformerConstructor, TransformerContext, TransformerLogger, TransformerOptions, TransformerReference, TransformerServiceConfig, UnifiedChatRequest, UnifiedChatRequestMeta, UnifiedChatResponse, UnifiedMessage, UnifiedTool, UrlCitation };
+export type { Annotation, ImageContent, LLMProvider, MessageContent, ModelRoute, ModelTransformerConfig, ReasoningConfig, RequestConfig, RequestRouteInfo, ResolvedTransformerChain, StreamChunk, TextContent, ThinkingContent, ToolCall, ToolChoice, ToolParameterSchema, TransformRequestResult, Transformer, TransformerChainConfig, TransformerConfigEntry, TransformerConstructor, TransformerContext, TransformerLogger, TransformerOptions, TransformerReference, TransformerServiceConfig, UnifiedChatRequest, UnifiedChatRequestMeta, UnifiedChatResponse, UnifiedMessage, UnifiedTool, UrlCitation };

package/dist/transformer.cjs

@@ -1,12 +1,12 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-FZ46M34D.cjs');
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});require('./chunk-QVOB2DNX.cjs');
 
 
-var _chunk2Z4XM3H5cjs = require('./chunk-2Z4XM3H5.cjs');
-require('./chunk-OXHNSZ53.cjs');
-require('./chunk-V4TXMEJS.cjs');
-require('./chunk-OVQBNVSV.cjs');
+var _chunkP7EM6BNDcjs = require('./chunk-P7EM6BND.cjs');
+require('./chunk-ZQQUD66M.cjs');
+require('./chunk-5LNYGCIW.cjs');
+require('./chunk-CMVXX7ON.cjs');
 require('./chunk-5RSZYQJH.cjs');
-require('./chunk-OF3BECU2.cjs');
+require('./chunk-56QD3YW6.cjs');
 
 
 var _chunkIIRPUVPHcjs = require('./chunk-IIRPUVPH.cjs');
@@ -14,10 +14,29 @@ require('./chunk-GBHYAGX3.cjs');
 
 
 var _chunk3OPYJG76cjs = require('./chunk-3OPYJG76.cjs');
-require('./chunk-OKMJLEXX.cjs');
-require('./chunk-KBM2W6UY.cjs');
+require('./chunk-OC6DOOFX.cjs');
+require('./chunk-RICPANBY.cjs');
+require('./chunk-77USGNRW.cjs');
 
 
 
 
-exports.TransformerChainExecutor = _chunkIIRPUVPHcjs.TransformerChainExecutor; exports.TransformerService = _chunk3OPYJG76cjs.TransformerService; exports.registerBuiltinTransformers = _chunk2Z4XM3H5cjs.registerBuiltinTransformers;
+
+
+
+
+
+var _chunkAOFWNWLTcjs = require('./chunk-AOFWNWLT.cjs');
+
+
+
+
+
+
+
+
+
+
+
+
+exports.THINK_LEVELS = _chunkAOFWNWLTcjs.THINK_LEVELS; exports.TransformerChainExecutor = _chunkIIRPUVPHcjs.TransformerChainExecutor; exports.TransformerService = _chunk3OPYJG76cjs.TransformerService; exports.extractReasoningIntent = _chunkAOFWNWLTcjs.extractReasoningIntent; exports.normalizeThinkLevel = _chunkAOFWNWLTcjs.normalizeThinkLevel; exports.registerBuiltinTransformers = _chunkP7EM6BNDcjs.registerBuiltinTransformers; exports.resolveReasoningEffort = _chunkAOFWNWLTcjs.resolveReasoningEffort; exports.resolveReasoningPlan = _chunkAOFWNWLTcjs.resolveReasoningPlan; exports.resolveReasoningTokenLimit = _chunkAOFWNWLTcjs.resolveReasoningTokenLimit; exports.resolveRequestReasoning = _chunkAOFWNWLTcjs.resolveRequestReasoning; exports.resolveTargetModelCapabilities = _chunkAOFWNWLTcjs.resolveTargetModelCapabilities;

package/dist/transformer.d.cts

@@ -1,9 +1,84 @@
 export { ChainExecutionOptions, TransformerChainExecutor } from './transformer/TransformerChainExecutor.cjs';
 export { TransformerService } from './transformer/TransformerService.cjs';
 export { registerBuiltinTransformers } from './transformer/transformers.cjs';
-export { Annotation, ImageContent, LLMProvider, MessageContent, ModelRoute, ModelTransformerConfig, ReasoningConfig, RequestConfig, RequestRouteInfo, ResolvedTransformerChain, StreamChunk, TextContent, ThinkLevel, ThinkingContent, ToolCall, ToolChoice, ToolParameterSchema, TransformRequestResult, Transformer, TransformerChainConfig, TransformerConfigEntry, TransformerConstructor, TransformerContext, TransformerLogger, TransformerOptions, TransformerReference, TransformerServiceConfig, UnifiedChatRequest, UnifiedChatResponse, UnifiedMessage, UnifiedTool, UrlCitation } from './transformer/types.cjs';
+import { ResolvedModelCapabilities } from '@omnicross/contracts/canonical-models';
+import { ThinkLevel } from '@omnicross/contracts/completion-types';
+export { ThinkLevel } from '@omnicross/contracts/completion-types';
+import { ModelConfig } from '@omnicross/contracts/llm-config';
+export { Annotation, ImageContent, LLMProvider, MessageContent, ModelRoute, ModelTransformerConfig, ReasoningConfig, RequestConfig, RequestRouteInfo, ResolvedTransformerChain, StreamChunk, TextContent, ThinkingContent, ToolCall, ToolChoice, ToolParameterSchema, TransformRequestResult, Transformer, TransformerChainConfig, TransformerConfigEntry, TransformerConstructor, TransformerContext, TransformerLogger, TransformerOptions, TransformerReference, TransformerServiceConfig, UnifiedChatRequest, UnifiedChatResponse, UnifiedMessage, UnifiedTool, UrlCitation } from './transformer/types.cjs';
 import './transformer/transformers/AnthropicTransformer.cjs';
 import './transformer/transformers/GeminiCodeAssistTransformer.cjs';
 import './transformer/transformers/GeminiTransformer.cjs';
 import './transformer/transformers/OpenAIResponseTransformer.cjs';
 import './transformer/transformers/OpenAITransformer.cjs';
+
+declare const THINK_LEVELS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max"];
+type ReasoningTarget = 'openai-chat' | 'openai-responses' | 'anthropic' | 'gemini';
+interface ReasoningIntent {
+    effort?: ThinkLevel;
+    enabled?: boolean;
+    /** Explicit reasoning budget from a normalized request. */
+    max_tokens?: number;
+}
+type ReasoningPlan = {
+    kind: 'off';
+} | {
+    kind: 'level';
+    effort: ThinkLevel;
+    enabled: boolean;
+} | {
+    kind: 'budget';
+    effort: ThinkLevel;
+    enabled: boolean;
+    budgetTokens: number;
+};
+interface ResolveReasoningPlanInput {
+    intent?: ReasoningIntent;
+    model: string;
+    provider?: ReasoningProvider;
+    target: ReasoningTarget;
+    /** Caller-visible bound used by legacy token-budget APIs. */
+    requestMaxTokens?: number;
+    /** Preserve a recognized native effort on a same-format round trip. */
+    preserveNativeEffort?: boolean;
+}
+interface ReasoningRequestLike {
+    model: string;
+    reasoning?: ReasoningIntent;
+    reasoning_effort?: unknown;
+}
+interface ResolveRequestReasoningOptions {
+    preserveNativeEffort?: boolean;
+}
+interface ReasoningProvider {
+    modelConfigs?: Array<Pick<ModelConfig, 'id'> & Partial<ModelConfig>>;
+}
+type TokenLimit = {
+    min: number;
+    max: number;
+};
+/** Normalize an untrusted wire value onto the shared seven-level domain. */
+declare function normalizeThinkLevel(value: unknown): ThinkLevel | undefined;
+/** Read normalized reasoning intent without mutating the request. */
+declare function extractReasoningIntent(request: ReasoningRequestLike): ReasoningIntent | undefined;
+/** Merge canonical metadata with the matching provider-row override. */
+declare function resolveTargetModelCapabilities(targetModel: string, provider?: ReasoningProvider): ResolvedModelCapabilities;
+/** Resolve an enabled effort to the nearest level supported by the target. */
+declare function resolveReasoningEffort(requested: ThinkLevel, targetModel: string, provider?: ReasoningProvider): ThinkLevel;
+/**
+ * Resolve token limits in provider-row → canonical → legacy regex → protocol
+ * fallback order. OpenAI discrete targets have no protocol budget fallback.
+ */
+declare function resolveReasoningTokenLimit(model: string, provider: ReasoningProvider | undefined, target: ReasoningTarget): TokenLimit | undefined;
+/**
+ * Resolve normalized reasoning intent into one semantic plan. Protocol adapters
+ * consume this result and only encode its wire shape.
+ */
+declare function resolveReasoningPlan(input: ResolveReasoningPlanInput): ReasoningPlan | undefined;
+/**
+ * Compatibility facade for callers that still consume a negotiated
+ * ReasoningIntent. New request builders should consume `resolveReasoningPlan`.
+ */
+declare function resolveRequestReasoning(request: ReasoningRequestLike, provider?: ReasoningProvider, options?: ResolveRequestReasoningOptions): ReasoningIntent | undefined;
+
+export { type ReasoningIntent, type ReasoningPlan, type ReasoningProvider, type ReasoningTarget, type ResolveReasoningPlanInput, THINK_LEVELS, extractReasoningIntent, normalizeThinkLevel, resolveReasoningEffort, resolveReasoningPlan, resolveReasoningTokenLimit, resolveRequestReasoning, resolveTargetModelCapabilities };

package/dist/transformer.d.ts

@@ -1,9 +1,84 @@
 export { ChainExecutionOptions, TransformerChainExecutor } from './transformer/TransformerChainExecutor.js';
 export { TransformerService } from './transformer/TransformerService.js';
 export { registerBuiltinTransformers } from './transformer/transformers.js';
-export { Annotation, ImageContent, LLMProvider, MessageContent, ModelRoute, ModelTransformerConfig, ReasoningConfig, RequestConfig, RequestRouteInfo, ResolvedTransformerChain, StreamChunk, TextContent, ThinkLevel, ThinkingContent, ToolCall, ToolChoice, ToolParameterSchema, TransformRequestResult, Transformer, TransformerChainConfig, TransformerConfigEntry, TransformerConstructor, TransformerContext, TransformerLogger, TransformerOptions, TransformerReference, TransformerServiceConfig, UnifiedChatRequest, UnifiedChatResponse, UnifiedMessage, UnifiedTool, UrlCitation } from './transformer/types.js';
+import { ResolvedModelCapabilities } from '@omnicross/contracts/canonical-models';
+import { ThinkLevel } from '@omnicross/contracts/completion-types';
+export { ThinkLevel } from '@omnicross/contracts/completion-types';
+import { ModelConfig } from '@omnicross/contracts/llm-config';
+export { Annotation, ImageContent, LLMProvider, MessageContent, ModelRoute, ModelTransformerConfig, ReasoningConfig, RequestConfig, RequestRouteInfo, ResolvedTransformerChain, StreamChunk, TextContent, ThinkingContent, ToolCall, ToolChoice, ToolParameterSchema, TransformRequestResult, Transformer, TransformerChainConfig, TransformerConfigEntry, TransformerConstructor, TransformerContext, TransformerLogger, TransformerOptions, TransformerReference, TransformerServiceConfig, UnifiedChatRequest, UnifiedChatResponse, UnifiedMessage, UnifiedTool, UrlCitation } from './transformer/types.js';
 import './transformer/transformers/AnthropicTransformer.js';
 import './transformer/transformers/GeminiCodeAssistTransformer.js';
 import './transformer/transformers/GeminiTransformer.js';
 import './transformer/transformers/OpenAIResponseTransformer.js';
 import './transformer/transformers/OpenAITransformer.js';
+
+declare const THINK_LEVELS: readonly ["none", "minimal", "low", "medium", "high", "xhigh", "max"];
+type ReasoningTarget = 'openai-chat' | 'openai-responses' | 'anthropic' | 'gemini';
+interface ReasoningIntent {
+    effort?: ThinkLevel;
+    enabled?: boolean;
+    /** Explicit reasoning budget from a normalized request. */
+    max_tokens?: number;
+}
+type ReasoningPlan = {
+    kind: 'off';
+} | {
+    kind: 'level';
+    effort: ThinkLevel;
+    enabled: boolean;
+} | {
+    kind: 'budget';
+    effort: ThinkLevel;
+    enabled: boolean;
+    budgetTokens: number;
+};
+interface ResolveReasoningPlanInput {
+    intent?: ReasoningIntent;
+    model: string;
+    provider?: ReasoningProvider;
+    target: ReasoningTarget;
+    /** Caller-visible bound used by legacy token-budget APIs. */
+    requestMaxTokens?: number;
+    /** Preserve a recognized native effort on a same-format round trip. */
+    preserveNativeEffort?: boolean;
+}
+interface ReasoningRequestLike {
+    model: string;
+    reasoning?: ReasoningIntent;
+    reasoning_effort?: unknown;
+}
+interface ResolveRequestReasoningOptions {
+    preserveNativeEffort?: boolean;
+}
+interface ReasoningProvider {
+    modelConfigs?: Array<Pick<ModelConfig, 'id'> & Partial<ModelConfig>>;
+}
+type TokenLimit = {
+    min: number;
+    max: number;
+};
+/** Normalize an untrusted wire value onto the shared seven-level domain. */
+declare function normalizeThinkLevel(value: unknown): ThinkLevel | undefined;
+/** Read normalized reasoning intent without mutating the request. */
+declare function extractReasoningIntent(request: ReasoningRequestLike): ReasoningIntent | undefined;
+/** Merge canonical metadata with the matching provider-row override. */
+declare function resolveTargetModelCapabilities(targetModel: string, provider?: ReasoningProvider): ResolvedModelCapabilities;
+/** Resolve an enabled effort to the nearest level supported by the target. */
+declare function resolveReasoningEffort(requested: ThinkLevel, targetModel: string, provider?: ReasoningProvider): ThinkLevel;
+/**
+ * Resolve token limits in provider-row → canonical → legacy regex → protocol
+ * fallback order. OpenAI discrete targets have no protocol budget fallback.
+ */
+declare function resolveReasoningTokenLimit(model: string, provider: ReasoningProvider | undefined, target: ReasoningTarget): TokenLimit | undefined;
+/**
+ * Resolve normalized reasoning intent into one semantic plan. Protocol adapters
+ * consume this result and only encode its wire shape.
+ */
+declare function resolveReasoningPlan(input: ResolveReasoningPlanInput): ReasoningPlan | undefined;
+/**
+ * Compatibility facade for callers that still consume a negotiated
+ * ReasoningIntent. New request builders should consume `resolveReasoningPlan`.
+ */
+declare function resolveRequestReasoning(request: ReasoningRequestLike, provider?: ReasoningProvider, options?: ResolveRequestReasoningOptions): ReasoningIntent | undefined;
+
+export { type ReasoningIntent, type ReasoningPlan, type ReasoningProvider, type ReasoningTarget, type ResolveReasoningPlanInput, THINK_LEVELS, extractReasoningIntent, normalizeThinkLevel, resolveReasoningEffort, resolveReasoningPlan, resolveReasoningTokenLimit, resolveRequestReasoning, resolveTargetModelCapabilities };

package/dist/transformer.js

@@ -1,12 +1,12 @@
-import "./chunk-46RLHI7D.js";
+import "./chunk-WTQMX2Q6.js";
 import {
   registerBuiltinTransformers
-} from "./chunk-MYYR3HZL.js";
-import "./chunk-PEGTIPB3.js";
-import "./chunk-LVUCAWMK.js";
-import "./chunk-32O35CIF.js";
+} from "./chunk-NGYOO5TO.js";
+import "./chunk-HKB656B4.js";
+import "./chunk-55FMGZ3L.js";
+import "./chunk-45FHEOKW.js";
 import "./chunk-FU7EAR73.js";
-import "./chunk-LB6EBS6Y.js";
+import "./chunk-CCVRRJOX.js";
 import {
   TransformerChainExecutor
 } from "./chunk-WNKWAEUR.js";
@@ -14,10 +14,29 @@ import "./chunk-MZNPGW5Q.js";
 import {
   TransformerService
 } from "./chunk-DK4A7DLE.js";
-import "./chunk-N5T4M4GU.js";
-import "./chunk-TOVPMMHM.js";
+import "./chunk-2UTGX6FM.js";
+import "./chunk-S3DYFEBE.js";
+import "./chunk-WYVGULTQ.js";
+import {
+  THINK_LEVELS,
+  extractReasoningIntent,
+  normalizeThinkLevel,
+  resolveReasoningEffort,
+  resolveReasoningPlan,
+  resolveReasoningTokenLimit,
+  resolveRequestReasoning,
+  resolveTargetModelCapabilities
+} from "./chunk-N2EIM2XJ.js";
 export {
+  THINK_LEVELS,
   TransformerChainExecutor,
   TransformerService,
-  registerBuiltinTransformers
+  extractReasoningIntent,
+  normalizeThinkLevel,
+  registerBuiltinTransformers,
+  resolveReasoningEffort,
+  resolveReasoningPlan,
+  resolveReasoningTokenLimit,
+  resolveRequestReasoning,
+  resolveTargetModelCapabilities
 };

package/dist/usage/usage-recorder.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});
 
-var _chunkEPN67EGPcjs = require('../chunk-EPN67EGP.cjs');
+var _chunk5UK3KLE2cjs = require('../chunk-5UK3KLE2.cjs');
 require('../chunk-XSVNC2UD.cjs');
 
 
-exports.UsageRecorder = _chunkEPN67EGPcjs.UsageRecorder;
+exports.UsageRecorder = _chunk5UK3KLE2cjs.UsageRecorder;

package/dist/usage/usage-recorder.d.cts

@@ -1,8 +1,8 @@
-import { PricingEngine } from './pricing-engine.cjs';
-import { UsageCacheKeySource, UsageDateRange, UsageTotals, ModelUsageRow, ApiKeyUsageRow, UsageTimeBucket, UsageTimeSeriesBucket, MessageUsageRow, SessionCacheStats } from '@omnicross/contracts/usage-stats-types';
+import { UsageCacheKeySource, UsageEventInput, UsageDateRange, UsageTotals, ModelUsageRow, ApiKeyUsageRow, UsageTimeBucket, UsageTimeSeriesBucket, MessageUsageRow, SessionCacheStats } from '@omnicross/contracts/usage-stats-types';
 import { UsageEngineOrigin, UsageTokens } from '@omnicross/contracts/usage-types';
 import { L as Logger } from '../logger-4GvQNzhE.cjs';
 import { UsageEventStore } from '../ports/usage-event-store.cjs';
+import { PricingEngine } from './pricing-engine.cjs';
 import '@omnicross/contracts/pricing-types';
 import '../ports/pricing-store.cjs';
 
@@ -69,6 +69,15 @@ interface UsageRecorderOptions {
      * Absent ⇒ no-op (byte-identical for hosts/tests that do not wire it).
      */
     onRecord?: (apiKeyId: string, costUsd: number, now: number) => void;
+    /**
+     * OPTIONAL per-request hook (live-throughput). Called synchronously with the
+     * FINISHED row, immediately before the store insert, for EVERY recorded
+     * request — attributed or not. Distinct from `onRecord`, which is gated on
+     * `apiKeyId` and carries only the cost: a rate metric must see subscription-
+     * account traffic too, and needs the token counts. Absent ⇒ no-op
+     * (byte-identical for hosts/tests that do not wire it).
+     */
+    onEvent?: (row: UsageEventInput, at: number) => void;
 }
 declare class UsageRecorder {
     private store;
@@ -76,6 +85,7 @@ declare class UsageRecorder {
     private logger;
     private defer;
     private onRecord?;
+    private onEvent?;
     constructor(store: UsageEventStore, pricing: PricingEngine, logger: Logger, options?: UsageRecorderOptions);
     /**
      * Record one LLM request. Returns immediately — the actual store insert is