@nuvin/agent-core 0.2.0-rc.1 → 0.2.0-rc.3

package/dist/models/model-registry.d.ts

@@ -1,7 +1,9 @@
+import type { ModelReasoningConfig } from "@nuvin/config";
 import type { ChatModelAuthScheme, ChatModelSurface } from "./chat-model.ts";
 export interface ModelProfile {
     contextWindow?: number;
     maxOutput?: number;
+    reasoning?: ModelReasoningConfig;
     surface?: ChatModelSurface;
     baseUrl?: string;
 }
@@ -29,7 +31,13 @@ export interface ResolvedModelProfile {
     supportsModelFetch?: boolean;
     contextWindow?: number;
     maxOutput?: number;
+    reasoning?: ModelReasoningConfig;
 }
+export declare const REASONING_METADATA_VERSIONS: {
+    readonly anthropic: "2026-07-22";
+    readonly openai: "2026-07-22";
+    readonly codex: "0.145.0+25af12f7e61572b0bc18ddb1008be543b91519b0";
+};
 export declare function getProviderProfile(provider: string): ProviderProfile | undefined;
 export declare function getModelProfile(provider: string, model: string): ModelProfile | undefined;
 export declare function resolveModelProfile(provider: string, model: string): ResolvedModelProfile | undefined;

package/dist/models/openai-surfaces.d.ts

@@ -43,8 +43,11 @@ interface OpenAiChatCompletionsRequest {
     messages: OpenAiChatCompletionMessage[];
     max_completion_tokens?: number;
     max_tokens?: number;
-    reasoning_effort?: "high" | "low" | "medium" | "minimal" | "none" | "xhigh";
+    reasoning_effort?: "high" | "low" | "max" | "medium" | "minimal" | "none" | "xhigh";
     stream: boolean;
+    stream_options?: {
+        include_usage: true;
+    };
     tools?: OpenAiChatCompletionToolDefinition[];
     response_format?: {
         type: "json_schema";

package/dist/models/routed-model.d.ts

@@ -32,6 +32,7 @@ export interface RoutedModelOptions {
     model: string;
     modelIdentity?: string;
     maxTokens?: number;
+    pricingProviderId?: string;
     reasoning?: ReasoningConfig;
     providerAdapter: ProviderAdapter;
     providerSessionResolver?: ProviderSessionResolver;
@@ -45,6 +46,7 @@ export declare class RoutedModel implements EngineChatModel {
     readonly model: string;
     readonly modelIdentity: string;
     readonly maxTokens?: number;
+    readonly pricingProviderId?: string;
     protected readonly reasoning?: ReasoningConfig;
     protected readonly apiKey?: string;
     protected readonly baseUrl: string;
@@ -83,6 +85,7 @@ export declare class RoutedModel implements EngineChatModel {
     protected mapApiError(error: Error): Error;
     protected toApiError(response: Response): Promise<Error>;
     private getSurface;
+    protected withPricingProviderId(request: ChatRequest): ChatRequest;
     private prepareChatRequest;
     protected applyModelDefaults(request: ChatRequest): ChatRequest;
     private sendHttpSurfaceRequest;

package/dist/shared/index.js

@@ -1 +1 @@
-(function(_0x1a44ae,_0x4b642c){var _0x1769c9={_0x2059bc:0x263,_0x38ba40:0x267,_0xf31b37:0x26b,_0x29ef54:0x26a,_0x42fa9f:0x269,_0x3c7788:0x262,_0x120428:0x261,_0xc4fb5d:0x224,_0x19adf5:0x21f,_0x2f92dd:0x21e,_0x2b2d28:0x266,_0x59f9ca:0x265,_0x4f2921:0x264,_0x38a5ed:0x227,_0x47f7a3:0x21d,_0x210ff3:0x222,_0x49b3aa:0x228,_0x48b494:0x223,_0x661105:0x272,_0x1c67da:0x26c,_0x212a38:0x21c,_0x56f2d4:0x21a,_0x417d50:0x220,_0x108f40:0x268},_0x13548a={_0x32b835:0x395},_0x524750=_0x1a44ae();function _0x2612ef(_0x507809,_0x3168d3,_0x388964,_0x8067bf){return _0x4438(_0x388964-0xf3,_0x8067bf);}function _0x4d3df5(_0x1461e6,_0xc32b9f,_0x5c9ca0,_0x58377a){return _0x4438(_0x5c9ca0- -_0x13548a._0x32b835,_0x1461e6);}while(!![]){try{var _0x501036=parseInt(_0x4d3df5(-0x26c,-_0x1769c9._0x2059bc,-_0x1769c9._0x38ba40,-_0x1769c9._0xf31b37))/0x1+parseInt(_0x4d3df5(-0x26d,-_0x1769c9._0x29ef54,-0x26b,-_0x1769c9._0x42fa9f))/0x2+-parseInt(_0x4d3df5(-_0x1769c9._0x3c7788,-_0x1769c9._0x120428,-0x262,-0x265))/0x3*(parseInt(_0x2612ef(0x220,_0x1769c9._0xc4fb5d,_0x1769c9._0x19adf5,_0x1769c9._0x2f92dd))/0x4)+parseInt(_0x4d3df5(-0x260,-_0x1769c9._0x2b2d28,-_0x1769c9._0x59f9ca,-_0x1769c9._0x4f2921))/0x5+-parseInt(_0x2612ef(_0x1769c9._0x38a5ed,_0x1769c9._0x47f7a3,_0x1769c9._0x210ff3,0x228))/0x6*(parseInt(_0x2612ef(_0x1769c9._0x49b3aa,0x223,0x225,_0x1769c9._0x48b494))/0x7)+-parseInt(_0x4d3df5(-0x269,-_0x1769c9._0x661105,-_0x1769c9._0x1c67da,-0x26a))/0x8*(-parseInt(_0x2612ef(_0x1769c9._0x212a38,_0x1769c9._0x56f2d4,_0x1769c9._0x417d50,0x224))/0x9)+-parseInt(_0x2612ef(0x221,0x222,0x224,0x227))/0xa*(parseInt(_0x4d3df5(-_0x1769c9._0x108f40,-0x26f,-0x26a,-0x26e))/0xb);if(_0x501036===_0x4b642c)break;else _0x524750['push'](_0x524750['shift']());}catch(_0x440116){_0x524750['push'](_0x524750['shift']());}}}(_0x212a,0x20f04));import{modelIdentityFromParts}from'../chunk-D5IVWJHX.js';function _0x212a(){var _0x47964d=['mZG1ntv2tvzXtwy','mJb6wurgDhm','mtHrzKj1vMC','mty2mdK5vgretMzs','nZj6yKLzr2q','mti3ndu0mhnWwfzNuW','ntiWsMzitvff','mteYnZKXB2rfzgje','nJC5odLdCurzqwq','mJq2ndmYDgfVs01j','mJGYndy0D0Loz21q'];_0x212a=function(){return _0x47964d;};return _0x212a();}import{mapAutoReasoningEffortToBudgetTokens,resolveAnthropicThinkingConfig,resolveOpenAiReasoningConfig}from'../chunk-NYZR4XKO.js';function _0x4438(_0x2c8eb2,_0x4df041){_0x2c8eb2=_0x2c8eb2-0x129;var _0x212a73=_0x212a();var _0x4438d8=_0x212a73[_0x2c8eb2];if(_0x4438['FKnJEj']===undefined){var _0x348666=function(_0x1469e8){var _0x2177cf='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x3b5833='',_0x4d09b2='';for(var _0x48a4d9=0x0,_0x1baa76,_0x5cbaf4,_0xd85d51=0x0;_0x5cbaf4=_0x1469e8['charAt'](_0xd85d51++);~_0x5cbaf4&&(_0x1baa76=_0x48a4d9%0x4?_0x1baa76*0x40+_0x5cbaf4:_0x5cbaf4,_0x48a4d9++%0x4)?_0x3b5833+=String['fromCharCode'](0xff&_0x1baa76>>(-0x2*_0x48a4d9&0x6)):0x0){_0x5cbaf4=_0x2177cf['indexOf'](_0x5cbaf4);}for(var _0x3a9311=0x0,_0x1c0456=_0x3b5833['length'];_0x3a9311<_0x1c0456;_0x3a9311++){_0x4d09b2+='%'+('00'+_0x3b5833['charCodeAt'](_0x3a9311)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x4d09b2);};_0x4438['ixrnln']=_0x348666,_0x4438['JwTCHQ']={},_0x4438['FKnJEj']=!![];}var _0x2498ea=_0x212a73[0x0],_0x59c234=_0x2c8eb2+_0x2498ea,_0x331644=_0x4438['JwTCHQ'][_0x59c234];return!_0x331644?(_0x4438d8=_0x4438['ixrnln'](_0x4438d8),_0x4438['JwTCHQ'][_0x59c234]=_0x4438d8):_0x4438d8=_0x331644,_0x4438d8;}import{TurnFailedError}from'../chunk-FFIZ6TKW.js';import{OperationAbortedError,addAbortListener,isAbortError,throwIfAborted,toAbortError}from'../chunk-X7VAACWY.js';export{OperationAbortedError,TurnFailedError,addAbortListener,isAbortError,mapAutoReasoningEffortToBudgetTokens,modelIdentityFromParts,resolveAnthropicThinkingConfig,resolveOpenAiReasoningConfig,throwIfAborted,toAbortError};
+(function(_0x52d6a9,_0x19b009){var _0x1af99f={_0x5f604f:0x187,_0x5b8d97:0x184,_0x143e9d:0xca,_0x571f70:0xc9,_0x5a51c1:0xc8,_0x29b68e:0xca,_0x3899cb:0xd3,_0x184fd0:0xd0,_0xff9145:0xcb,_0x8c15cd:0x189,_0x3a3656:0x18a,_0x161592:0x18d,_0x583c86:0x185,_0x2fd984:0x180,_0x31c6f1:0x188,_0x561f84:0xc9},_0x3ea0bf=_0x52d6a9();function _0x17f373(_0x395d31,_0x424fa5,_0x5c23f4,_0x408dee){return _0x4cd4(_0x424fa5- -0x325,_0x395d31);}function _0x4eada4(_0x275509,_0x44c80a,_0x59dfe2,_0x63b107){return _0x4cd4(_0x59dfe2- -0xcf,_0x63b107);}while(!![]){try{var _0x100239=-parseInt(_0x17f373(-0x182,-_0x1af99f._0x5f604f,-0x188,-_0x1af99f._0x5b8d97))/0x1+parseInt(_0x4eada4(_0x1af99f._0x143e9d,_0x1af99f._0x571f70,_0x1af99f._0x5a51c1,0xc6))/0x2+parseInt(_0x4eada4(0xc8,0xc6,_0x1af99f._0x29b68e,0xcc))/0x3*(parseInt(_0x4eada4(0xd5,_0x1af99f._0x3899cb,_0x1af99f._0x184fd0,_0x1af99f._0xff9145))/0x4)+-parseInt(_0x17f373(-0x184,-_0x1af99f._0x8c15cd,-0x187,-0x184))/0x5*(-parseInt(_0x17f373(-0x189,-_0x1af99f._0x3a3656,-_0x1af99f._0x161592,-0x189))/0x6)+-parseInt(_0x17f373(-0x183,-_0x1af99f._0x583c86,-_0x1af99f._0x2fd984,-0x186))/0x7*(parseInt(_0x17f373(-0x189,-0x18b,-_0x1af99f._0x5f604f,-0x18e))/0x8)+parseInt(_0x17f373(-0x186,-_0x1af99f._0x31c6f1,-0x189,-_0x1af99f._0x5f604f))/0x9+-parseInt(_0x4eada4(0xca,0xca,_0x1af99f._0x561f84,0xcb))/0xa;if(_0x100239===_0x19b009)break;else _0x3ea0bf['push'](_0x3ea0bf['shift']());}catch(_0x595eb2){_0x3ea0bf['push'](_0x3ea0bf['shift']());}}}(_0xae9d,0x93226));function _0xae9d(){var _0x2450e2=['nJqWmteYvNH5shLz','odKWotaWzvHQswT0','m0LAqxznBa','ndCYnJiZmMjQsgvPCq','nNvhtwDpAa','mtG3mte1mhjVsNj6Da','mtaZndq3mtDxs1fpsxu','odq1ndqWwLLwEMnb','mZuWmdiWneLIuhDkDa','mtr3wu1jrNC'];_0xae9d=function(){return _0x2450e2;};return _0xae9d();}import{modelIdentityFromParts}from'../chunk-D5IVWJHX.js';import{resolveAnthropicReasoningConfig,resolveOpenAiReasoningConfig}from'../chunk-IUZALP6K.js';function _0x4cd4(_0x3c3a66,_0xd56804){_0x3c3a66=_0x3c3a66-0x197;var _0xae9db=_0xae9d();var _0x4cd407=_0xae9db[_0x3c3a66];if(_0x4cd4['mVxHgH']===undefined){var _0x55cea6=function(_0x2f0f7b){var _0x5bec90='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x3544ab='',_0xe3ed64='';for(var _0x3c5953=0x0,_0x524d85,_0x3e7deb,_0xf31e2=0x0;_0x3e7deb=_0x2f0f7b['charAt'](_0xf31e2++);~_0x3e7deb&&(_0x524d85=_0x3c5953%0x4?_0x524d85*0x40+_0x3e7deb:_0x3e7deb,_0x3c5953++%0x4)?_0x3544ab+=String['fromCharCode'](0xff&_0x524d85>>(-0x2*_0x3c5953&0x6)):0x0){_0x3e7deb=_0x5bec90['indexOf'](_0x3e7deb);}for(var _0x5d27dd=0x0,_0x2e0a18=_0x3544ab['length'];_0x5d27dd<_0x2e0a18;_0x5d27dd++){_0xe3ed64+='%'+('00'+_0x3544ab['charCodeAt'](_0x5d27dd)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0xe3ed64);};_0x4cd4['yrhrFk']=_0x55cea6,_0x4cd4['mnLfiT']={},_0x4cd4['mVxHgH']=!![];}var _0x31c2f8=_0xae9db[0x0],_0x15c899=_0x3c3a66+_0x31c2f8,_0x9418c7=_0x4cd4['mnLfiT'][_0x15c899];return!_0x9418c7?(_0x4cd407=_0x4cd4['yrhrFk'](_0x4cd407),_0x4cd4['mnLfiT'][_0x15c899]=_0x4cd407):_0x4cd407=_0x9418c7,_0x4cd407;}import{TurnFailedError}from'../chunk-FFIZ6TKW.js';import{OperationAbortedError,addAbortListener,isAbortError,throwIfAborted,toAbortError}from'../chunk-X7VAACWY.js';export{OperationAbortedError,TurnFailedError,addAbortListener,isAbortError,modelIdentityFromParts,resolveAnthropicReasoningConfig,resolveOpenAiReasoningConfig,throwIfAborted,toAbortError};

package/dist/shared/reasoning-config.d.ts

@@ -1,5 +1,4 @@
-import type { AnthropicThinkingConfig, AutoReasoningEffort, OpenAiReasoningConfig, ReasoningConfig } from "./types.ts";
-export declare function mapAutoReasoningEffortToBudgetTokens(effort: AutoReasoningEffort): number;
-export declare function resolveAnthropicThinkingConfig(reasoning: ReasoningConfig | undefined): AnthropicThinkingConfig | undefined;
-export declare function resolveOpenAiReasoningConfig(reasoning: ReasoningConfig | undefined): OpenAiReasoningConfig | undefined;
+import type { AnthropicReasoningConfig, CodexReasoningConfig, OpenAiReasoningConfig, ReasoningConfig } from "./types.ts";
+export declare function resolveAnthropicReasoningConfig(reasoning: ReasoningConfig | undefined): AnthropicReasoningConfig | undefined;
+export declare function resolveOpenAiReasoningConfig(reasoning: ReasoningConfig | undefined): CodexReasoningConfig | OpenAiReasoningConfig | undefined;
 //# sourceMappingURL=reasoning-config.d.ts.map

package/dist/shared/types.d.ts

@@ -82,12 +82,8 @@ export interface AnthropicRedactedThinkingWireBlock {
 }
 export type AnthropicAssistantContentBlock = AnthropicRedactedThinkingWireBlock | AnthropicThinkingWireBlock | TextBlock | ToolUseBlock;
 export type ReasoningVisibility = "continuity-only" | "user-visible";
-export type AutoReasoningEffort = "low" | "medium" | "high";
-export interface AutoReasoningConfig {
-    effort: AutoReasoningEffort;
-}
 export type AnthropicThinkingDisplay = "omitted" | "summarized";
-export type AnthropicThinkingEffort = "low" | "medium" | "high";
+export type AnthropicThinkingEffort = "low" | "medium" | "high" | "xhigh" | "max";
 export interface AnthropicEnabledThinkingConfig {
     type: "enabled";
     budgetTokens: number;
@@ -97,23 +93,29 @@ export interface AnthropicEnabledThinkingConfig {
 export interface AnthropicAdaptiveThinkingConfig {
     type: "adaptive";
     display?: AnthropicThinkingDisplay;
-    effort?: AnthropicThinkingEffort;
     interleaved?: boolean;
 }
 export interface AnthropicDisabledThinkingConfig {
     type: "disabled";
 }
 export type AnthropicThinkingConfig = AnthropicAdaptiveThinkingConfig | AnthropicDisabledThinkingConfig | AnthropicEnabledThinkingConfig;
-export type OpenAiReasoningEffort = "high" | "low" | "medium" | "minimal" | "none" | "xhigh";
+export interface AnthropicReasoningConfig {
+    thinking: AnthropicThinkingConfig;
+    effort?: AnthropicThinkingEffort;
+}
+export type OpenAiReasoningEffort = "none" | "minimal" | "low" | "medium" | "high" | "xhigh" | "max";
 export type OpenAiReasoningSummary = "auto" | "concise" | "detailed";
 export interface OpenAiReasoningConfig {
     effort?: OpenAiReasoningEffort;
     includeEncryptedContent?: boolean;
     summary?: OpenAiReasoningSummary;
 }
+export interface CodexReasoningConfig {
+    effort: string;
+}
 export interface ReasoningConfig {
-    auto?: AutoReasoningConfig;
-    anthropic?: AnthropicThinkingConfig;
+    anthropic?: AnthropicReasoningConfig;
+    codex?: CodexReasoningConfig;
     openai?: OpenAiReasoningConfig;
     visibility?: ReasoningVisibility;
 }
@@ -170,6 +172,7 @@ export interface ModelRequest {
         session_id: string;
         turn_id: string;
         model_identity?: string;
+        pricing_provider_id?: string;
     };
     outputFormat?: OutputFormat;
 }
@@ -194,20 +197,36 @@ export interface ChatRequest {
         sessionId: string;
         turnId: string;
         modelIdentity?: string;
+        pricingProviderId?: string;
     };
     outputFormat?: OutputFormat;
 }
+export interface ReportedModelCost {
+    amountUsdTicks: number;
+    source: "openrouter" | "xai";
+}
+export interface EstimatedModelCost {
+    amountUsdTicks: number;
+    source: "models.dev";
+    pricingSnapshotId: string;
+    pricingProviderIds: readonly string[];
+    pricingModelId: string;
+    matchKind: "provider-model" | "model-unique" | "model-identical";
+}
+export interface ChatResponseUsage {
+    inputTokens: number;
+    outputTokens: number;
+    reasoningTokens?: number;
+    cacheReadInputTokens?: number;
+    cacheCreationInputTokens?: number;
+    reportedCost?: ReportedModelCost;
+    estimatedCost?: EstimatedModelCost;
+}
 export interface ChatResponse {
     id: string;
     content: AssistantContentBlock[];
     stopReason: "end_turn" | "tool_use";
-    usage: {
-        inputTokens: number;
-        outputTokens: number;
-        reasoningTokens?: number;
-        cacheReadInputTokens?: number;
-        cacheCreationInputTokens?: number;
-    };
+    usage: ChatResponseUsage;
     providerState?: MessageProviderState;
 }
 export interface ContentDeltaChunk {
@@ -303,6 +322,7 @@ export interface TurnInput {
     system?: SystemInput;
     messages?: MessageInput[];
     message: MessageInput;
+    drainSteering?: () => Promise<MessageInput[]>;
 }
 export interface TurnState {
     sessionId: string;
@@ -384,6 +404,7 @@ export interface EngineChatModel {
     modelIdentity: string;
     provider?: string;
     maxTokens?: number;
+    readonly pricingProviderId?: string;
     complete(request: ChatRequest, options?: ModelExecutionOptions): Promise<ChatResponse>;
     stream?(request: ChatRequest, options?: ModelExecutionOptions): AsyncIterable<ChatResponseChunk>;
     getModels?(signal?: AbortSignal): Promise<ModelInfo[]>;
@@ -392,6 +413,7 @@ export interface BaseChatModelOptions {
     model: string;
     modelIdentity?: string;
     maxTokens?: number;
+    pricingProviderId?: string;
     reasoning?: ReasoningConfig;
     providerSessionResolver?: ProviderSessionResolver;
     requestMutators?: ProviderRequestMutator[];
@@ -417,9 +439,11 @@ export type AskUserQuestionRequest = {
     questionId: string;
     questions: AskUserQuestion[];
 };
+export type ToolPermissionClass = "read" | "write" | "always-confirm";
 export interface ToolExecutionContext extends AgentEventContext {
     signal: AbortSignal;
     toolCallId?: string;
+    permissionClass?: ToolPermissionClass;
     askUser?: (request: AskUserQuestionRequest) => Promise<AskUserAnswers>;
     setTopic?: (topic: string) => void;
 }
@@ -548,10 +572,16 @@ type OptionalProperties<TProperties extends Record<string, JsonSchema>, TRequire
 };
 export type ToolOutputValue = JsonValue | ToolOutputEnvelope;
 export type ToolGenerator<TYield extends ToolOutputValue = ToolOutputValue, TReturn extends ToolOutputValue | undefined = ToolOutputValue | undefined> = AsyncGenerator<TYield, TReturn, void>;
+/** Internal resource lifetime contract; omitted from model-facing tool schemas and messages. */
+export interface ToolDefinitionLifecycle {
+    acquire(): () => void;
+}
 export interface ToolDefinition<TInput extends JsonObject = JsonObject, TYield extends ToolOutputValue = ToolOutputValue, TReturn extends ToolOutputValue | undefined = ToolOutputValue | undefined, TSchema extends JsonSchemaObject = JsonSchemaObject> {
     name: string;
     description: string;
     inputSchema: TSchema;
+    permissionClass?: ToolPermissionClass;
+    internalLifecycle?: ToolDefinitionLifecycle;
     execute(input: TInput, ctx: ToolExecutionContext): ToolGenerator<TYield, TReturn>;
 }
 export type AnyToolDefinition = ToolDefinition<JsonObject, ToolOutputValue, ToolOutputValue | undefined, JsonSchemaObject>;
@@ -614,9 +644,11 @@ export interface RunTurnDeps {
     outputFormat?: OutputFormat;
 }
 export type AgentInput = MessageInput | string;
+export type SteeringInputDrain = () => Promise<AgentInput[]>;
 export interface AgentSendOptions {
     streaming?: boolean;
     signal?: AbortSignal;
+    drainSteering?: SteeringInputDrain;
 }
 export interface AgentOptions {
     sessionId?: string;
@@ -751,7 +783,7 @@ export interface OpenAiReasoningOutputItem {
 }
 export type OpenAiResponsesOutputItem = JsonObject | OpenAiFunctionCall | OpenAiOutputMessage | OpenAiReasoningOutputItem;
 export interface OpenAiResponsesReasoningParam {
-    effort?: OpenAiReasoningEffort;
+    effort?: string;
     generate_summary?: OpenAiReasoningSummary;
     summary?: OpenAiReasoningSummary;
 }

package/dist/tools/index.d.ts

@@ -13,7 +13,10 @@ export * from "./internal-tool-runtime.ts";
 export * from "./kill-shell-tool.ts";
 export * from "./ls-tool.ts";
 export * from "./lsp-tool.ts";
+export * from "./mcp-connection-generation.ts";
 export * from "./mcp-oauth-provider.ts";
+export * from "./mcp-safe-error.ts";
+export { extractOwnedMcpSafeError } from "./mcp-safe-error-provenance.ts";
 export * from "./mcp-server-manager.ts";
 export * from "./mcp-tool-adapter.ts";
 export * from "./mock-tool-runtime.ts";