@nuvin/agent-core 0.2.0-rc.2 → 0.2.0-rc.4

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,7 +43,7 @@ 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;

package/dist/shared/index.js

@@ -1 +1 @@
-(function(_0x231ab8,_0x347ff9){var _0xdbfbf2={_0x53e11f:0x22,_0x35f21b:0x1f,_0x1ce949:0x418,_0x34f7f5:0x41d,_0x6d0e3d:0x41a,_0x1467c6:0x1f,_0x2b6163:0x1a,_0x3e4e88:0x15,_0x9bbc2b:0x421,_0x1d01e5:0x12,_0x3d5118:0x17,_0x55c0ff:0x14,_0xfe3c2f:0x17,_0x5ca0b1:0x40c,_0x4cf0f3:0x17,_0x4a05cb:0x1c,_0x3b5c6f:0x19,_0x191289:0x410,_0xe921ad:0x13,_0x57e031:0x18,_0x5dec03:0x417,_0x443113:0x417,_0x5aedaf:0x413},_0x4f2f33={_0x42d435:0x179},_0x279f30={_0x4f7326:0x283};function _0x5de123(_0x5d12ab,_0x2feb84,_0x46ab7a,_0xd51d2a){return _0x494c(_0x46ab7a-_0x279f30._0x4f7326,_0x5d12ab);}var _0x513984=_0x231ab8();function _0x12a96c(_0x1caa54,_0x48adcb,_0x3a0ef6,_0x123d1d){return _0x494c(_0x48adcb- -_0x4f2f33._0x42d435,_0x123d1d);}while(!![]){try{var _0x164269=-parseInt(_0x12a96c(_0xdbfbf2._0x53e11f,_0xdbfbf2._0x35f21b,0x21,0x21))/0x1*(parseInt(_0x5de123(_0xdbfbf2._0x1ce949,_0xdbfbf2._0x34f7f5,0x419,_0xdbfbf2._0x6d0e3d))/0x2)+parseInt(_0x12a96c(_0xdbfbf2._0x1467c6,_0xdbfbf2._0x2b6163,_0xdbfbf2._0x3e4e88,_0xdbfbf2._0x2b6163))/0x3*(-parseInt(_0x5de123(0x422,0x41a,0x41c,_0xdbfbf2._0x9bbc2b))/0x4)+parseInt(_0x12a96c(_0xdbfbf2._0x1d01e5,_0xdbfbf2._0x3d5118,_0xdbfbf2._0x55c0ff,_0xdbfbf2._0xfe3c2f))/0x5+parseInt(_0x5de123(_0xdbfbf2._0x5ca0b1,0x411,0x411,0x415))/0x6+parseInt(_0x12a96c(_0xdbfbf2._0x4cf0f3,_0xdbfbf2._0x4a05cb,0x21,0x20))/0x7*(parseInt(_0x12a96c(0x20,0x1e,0x1d,0x23))/0x8)+parseInt(_0x12a96c(0x17,_0xdbfbf2._0x3b5c6f,_0xdbfbf2._0x3e4e88,_0xdbfbf2._0x3b5c6f))/0x9*(parseInt(_0x5de123(0x413,0x40c,0x412,_0xdbfbf2._0x191289))/0xa)+parseInt(_0x12a96c(_0xdbfbf2._0xe921ad,_0xdbfbf2._0x57e031,0x16,_0xdbfbf2._0x1d01e5))/0xb*(-parseInt(_0x5de123(0x41b,_0xdbfbf2._0x5dec03,_0xdbfbf2._0x443113,_0xdbfbf2._0x5aedaf))/0xc);if(_0x164269===_0x347ff9)break;else _0x513984['push'](_0x513984['shift']());}catch(_0x56176f){_0x513984['push'](_0x513984['shift']());}}}(_0x5c28,0xe86fe));import{modelIdentityFromParts}from'../chunk-D5IVWJHX.js';import{mapAutoReasoningEffortToBudgetTokens,resolveAnthropicThinkingConfig,resolveOpenAiReasoningConfig}from'../chunk-NYZR4XKO.js';function _0x5c28(){var _0x4bd20a=['mJbHzezAA3i','mtq0mdq1zwjouwnN','mtfHqK5ju1a','mZe4mtuWovftugzXqq','mte1mtyXDfDxyNHp','nJq4ndGXmMHAuffQEG','nJK2mdCZwwf6y2jY','mKzXwLztwq','mtm2EfPoueLw','mtqZnZCXm0L5CLPMDq','mtz1zxnPuKG','mZK0ndCWmhH1zKvlwG'];_0x5c28=function(){return _0x4bd20a;};return _0x5c28();}import{TurnFailedError}from'../chunk-FFIZ6TKW.js';function _0x494c(_0x29c78f,_0x4d2400){_0x29c78f=_0x29c78f-0x18e;var _0x5c28f6=_0x5c28();var _0x494c58=_0x5c28f6[_0x29c78f];if(_0x494c['PhmulH']===undefined){var _0x367384=function(_0x4b9098){var _0x160e42='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x5a49c6='',_0xbb03a6='';for(var _0x2bd7fa=0x0,_0x3068ec,_0x4026a2,_0x5a0472=0x0;_0x4026a2=_0x4b9098['charAt'](_0x5a0472++);~_0x4026a2&&(_0x3068ec=_0x2bd7fa%0x4?_0x3068ec*0x40+_0x4026a2:_0x4026a2,_0x2bd7fa++%0x4)?_0x5a49c6+=String['fromCharCode'](0xff&_0x3068ec>>(-0x2*_0x2bd7fa&0x6)):0x0){_0x4026a2=_0x160e42['indexOf'](_0x4026a2);}for(var _0x416446=0x0,_0x586afb=_0x5a49c6['length'];_0x416446<_0x586afb;_0x416446++){_0xbb03a6+='%'+('00'+_0x5a49c6['charCodeAt'](_0x416446)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0xbb03a6);};_0x494c['IKnZDM']=_0x367384,_0x494c['rqCLNx']={},_0x494c['PhmulH']=!![];}var _0x480f41=_0x5c28f6[0x0],_0x2c35c8=_0x29c78f+_0x480f41,_0x3f885e=_0x494c['rqCLNx'][_0x2c35c8];return!_0x3f885e?(_0x494c58=_0x494c['IKnZDM'](_0x494c58),_0x494c['rqCLNx'][_0x2c35c8]=_0x494c58):_0x494c58=_0x3f885e,_0x494c58;}import{OperationAbortedError,addAbortListener,isAbortError,throwIfAborted,toAbortError}from'../chunk-X7VAACWY.js';export{OperationAbortedError,TurnFailedError,addAbortListener,isAbortError,mapAutoReasoningEffortToBudgetTokens,modelIdentityFromParts,resolveAnthropicThinkingConfig,resolveOpenAiReasoningConfig,throwIfAborted,toAbortError};
+(function(_0x5decff,_0x3c2c65){var _0x456f32={_0x42f1f7:0x27c,_0x126e93:0x277,_0x368610:0x276,_0xe76eb8:0x244,_0x74400e:0x245,_0x14c5e3:0x273,_0x13ad44:0x248,_0x525a5c:0x250,_0x11e31e:0x24a,_0x216957:0x276,_0x51acd3:0x27c,_0x322857:0x275,_0x4d6895:0x27b,_0x410316:0x274,_0x208522:0x24c,_0x1bcaf8:0x24d,_0x14786d:0x249,_0x3939e7:0x246},_0x3140d5={_0xfe6fcd:0x374};function _0x8cbafb(_0x3e2fb7,_0x2c8786,_0x4a7e95,_0x11c6a1){return _0x491b(_0x11c6a1-0x14a,_0x4a7e95);}var _0x12381e=_0x5decff();function _0xc870c6(_0x26c597,_0x1342d0,_0x39868f,_0x44c244){return _0x491b(_0x1342d0- -_0x3140d5._0xfe6fcd,_0x44c244);}while(!![]){try{var _0x5299ac=-parseInt(_0xc870c6(-_0x456f32._0x42f1f7,-_0x456f32._0x126e93,-_0x456f32._0x368610,-0x272))/0x1*(parseInt(_0x8cbafb(_0x456f32._0xe76eb8,0x245,0x249,_0x456f32._0x74400e))/0x2)+-parseInt(_0xc870c6(-0x270,-_0x456f32._0x14c5e3,-0x276,-0x276))/0x3+parseInt(_0x8cbafb(_0x456f32._0x13ad44,_0x456f32._0x525a5c,_0x456f32._0x11e31e,_0x456f32._0x11e31e))/0x4*(parseInt(_0xc870c6(-0x26d,-0x272,-_0x456f32._0x216957,-0x271))/0x5)+-parseInt(_0xc870c6(-_0x456f32._0x51acd3,-0x27a,-_0x456f32._0x322857,-0x27b))/0x6*(parseInt(_0xc870c6(-0x27b,-0x27c,-0x27a,-0x278))/0x7)+-parseInt(_0x8cbafb(0x23f,0x246,0x248,0x243))/0x8*(parseInt(_0xc870c6(-_0x456f32._0x4d6895,-_0x456f32._0x216957,-0x27a,-_0x456f32._0x410316))/0x9)+parseInt(_0x8cbafb(_0x456f32._0x208522,_0x456f32._0x1bcaf8,0x245,_0x456f32._0x14786d))/0xa+parseInt(_0x8cbafb(_0x456f32._0x3939e7,_0x456f32._0x11e31e,0x243,_0x456f32._0x3939e7))/0xb;if(_0x5299ac===_0x3c2c65)break;else _0x12381e['push'](_0x12381e['shift']());}catch(_0x159437){_0x12381e['push'](_0x12381e['shift']());}}}(_0x3405,0x8db6d));import{modelIdentityFromParts}from'../chunk-D5IVWJHX.js';import{resolveAnthropicReasoningConfig,resolveOpenAiReasoningConfig}from'../chunk-IUZALP6K.js';function _0x491b(_0x341534,_0x5a81be){_0x341534=_0x341534-0xf8;var _0x340527=_0x3405();var _0x491bd9=_0x340527[_0x341534];if(_0x491b['RlwUjy']===undefined){var _0x2e4e10=function(_0x4a94a4){var _0x498c35='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x32ea79='',_0x2b8e1b='';for(var _0x283b30=0x0,_0x439ee3,_0x1873ba,_0x29be11=0x0;_0x1873ba=_0x4a94a4['charAt'](_0x29be11++);~_0x1873ba&&(_0x439ee3=_0x283b30%0x4?_0x439ee3*0x40+_0x1873ba:_0x1873ba,_0x283b30++%0x4)?_0x32ea79+=String['fromCharCode'](0xff&_0x439ee3>>(-0x2*_0x283b30&0x6)):0x0){_0x1873ba=_0x498c35['indexOf'](_0x1873ba);}for(var _0x3a3de9=0x0,_0x32f36e=_0x32ea79['length'];_0x3a3de9<_0x32f36e;_0x3a3de9++){_0x2b8e1b+='%'+('00'+_0x32ea79['charCodeAt'](_0x3a3de9)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x2b8e1b);};_0x491b['ebrCTv']=_0x2e4e10,_0x491b['YhpFIX']={},_0x491b['RlwUjy']=!![];}var _0x524e7f=_0x340527[0x0],_0x4994aa=_0x341534+_0x524e7f,_0x14eff7=_0x491b['YhpFIX'][_0x4994aa];return!_0x14eff7?(_0x491bd9=_0x491b['ebrCTv'](_0x491bd9),_0x491b['YhpFIX'][_0x4994aa]=_0x491bd9):_0x491bd9=_0x14eff7,_0x491bd9;}function _0x3405(){var _0x253c5f=['mJu2otyXmhLTEez2Bq','ngPjBgrlqW','ntq0nZi1turfwun3','mJqYnJyXnw1ht0nxEG','mZK2mdq0nNrND2XRsG','mte1odiYneznu0zSrq','nNDlsfbREG','mta1otrLs3L2DMW','ote0mdq2muvsrMDOAq','mtLRz1P5uKK','ovHPzenqzG'];_0x3405=function(){return _0x253c5f;};return _0x3405();}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;
 }
@@ -220,6 +222,13 @@ export interface ChatResponseUsage {
     reportedCost?: ReportedModelCost;
     estimatedCost?: EstimatedModelCost;
 }
+export interface PersistedModelCallMetricsV1 {
+    version: 1;
+    usage: ChatResponseUsage;
+    modelTimeMs: number;
+    completesRequest: boolean;
+}
+export type PersistedModelCallMetrics = PersistedModelCallMetricsV1;
 export interface ChatResponse {
     id: string;
     content: AssistantContentBlock[];
@@ -320,6 +329,7 @@ export interface TurnInput {
     system?: SystemInput;
     messages?: MessageInput[];
     message: MessageInput;
+    drainSteering?: () => Promise<MessageInput[]>;
 }
 export interface TurnState {
     sessionId: string;
@@ -387,6 +397,7 @@ export interface TurnMessageMeta {
     provider?: string;
     model?: string;
     modelIdentity?: string;
+    metrics?: PersistedModelCallMetrics;
     /** ms epoch — provider request sent. */
     turnStartedAt?: number;
     /** ms epoch — response fully received. */
@@ -441,9 +452,17 @@ export interface ToolExecutionContext extends AgentEventContext {
     signal: AbortSignal;
     toolCallId?: string;
     permissionClass?: ToolPermissionClass;
+    executionAuthorization?: unknown;
     askUser?: (request: AskUserQuestionRequest) => Promise<AskUserAnswers>;
     setTopic?: (topic: string) => void;
 }
+export interface BashExecutionTarget {
+    command: string;
+    cwd: string;
+    shellPath: string;
+    dialect: "bash" | "posix" | "windows" | "unknown";
+    background: boolean;
+}
 export interface ToolRuntimeStartedEvent {
     type: "tool_started";
     toolCall: ToolUseBlock;
@@ -474,6 +493,8 @@ export interface AgentModelRequestEvent {
 }
 export interface AgentModelResponseEvent {
     type: "model_response";
+    /** Exact provider/model-call duration measured by the turn engine. */
+    modelTimeMs?: number;
     response: ChatResponse;
 }
 export interface AgentAssistantMessageEvent {
@@ -545,6 +566,9 @@ export type ToolRuntimeDispatchDecision = {
         dir: string;
         persist: boolean;
     };
+    executionAuthorization?: unknown;
+    approvalDecision?: "y" | "a" | "t";
+    approvalSource?: "policy" | "remembered" | "sudo" | "user";
 };
 export type ToolRuntimeToolCallHandler = (toolCall: ToolUseBlock, ctx: ToolExecutionContext) => Promise<ToolRuntimeDispatchDecision | undefined> | ToolRuntimeDispatchDecision | undefined;
 export type ToolRuntimeEventHandler = (event: ToolRuntimeEvent, ctx: ToolExecutionContext) => Promise<void> | void;
@@ -618,6 +642,8 @@ export interface ObserverExtensionRegistration<S extends Stage = Stage> {
     kind: "observer";
     order: number;
     enabled: boolean;
+    /** Runs after every enabled non-terminal observer registered for this stage. */
+    terminal?: boolean;
     run: Observer<S>;
 }
 export type AnyExtensionRegistration = {
@@ -641,9 +667,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;
@@ -778,7 +806,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/bash-tool.d.ts

@@ -1,3 +1,4 @@
+import type { BashExecutionTarget, ToolExecutionContext } from "../shared/types.ts";
 import type { BackgroundProcessRegistry } from "./background-process-registry.ts";
 export interface BashToolInput {
     command: string;
@@ -18,16 +19,19 @@ export interface BashToolOptions {
     shellPath?: string;
     stripAnsi?: boolean;
     scrubEnvKeys?: readonly string[];
+    scrubEnvPrefixes?: readonly string[];
     backgroundRegistry?: BackgroundProcessRegistry;
+    verifyExecution?: (target: BashExecutionTarget, authorization: unknown, ctx: ToolExecutionContext) => Promise<void> | void;
 }
+export declare function resolveBashExecutionTarget(input: Pick<BashToolInput, "command" | "cwd" | "runInBackground">, options?: Pick<BashToolOptions, "allowedDirs" | "defaultCwd" | "shellPath">): BashExecutionTarget;
 export declare function createBashTool(options?: BashToolOptions): import("../shared/types.ts").ToolDefinition<{
     description: string;
     command: string;
     timeoutMs?: number | undefined;
     cwd?: string | undefined;
+    runInBackground?: boolean | undefined;
     ignoreOutput?: boolean | undefined;
     outputRegex?: string | undefined;
-    runInBackground?: boolean | undefined;
 }, string, import("../shared/types.ts").ToolOutputEnvelope, {
     type: "object";
     properties: {
@@ -62,9 +66,9 @@ export declare function createShellExecTool(options?: BashToolOptions): import("
     command: string;
     timeoutMs?: number | undefined;
     cwd?: string | undefined;
+    runInBackground?: boolean | undefined;
     ignoreOutput?: boolean | undefined;
     outputRegex?: string | undefined;
-    runInBackground?: boolean | undefined;
 }, string, import("../shared/types.ts").ToolOutputEnvelope, {
     type: "object";
     properties: {

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";