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

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/abort-aware-semaphore.d.ts

@@ -0,0 +1,5 @@
+export interface AbortAwareSemaphore {
+    acquire(signal?: AbortSignal): Promise<() => void>;
+}
+export declare function createAbortAwareSemaphore(maxConcurrency: number): AbortAwareSemaphore;
+//# sourceMappingURL=abort-aware-semaphore.d.ts.map

package/dist/shared/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./abort.ts";
+export * from "./abort-aware-semaphore.ts";
 export * from "./model-identity.ts";
 export * from "./reasoning-config.ts";
 export * from "./turn-failed.ts";

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 _0x21f6(_0x3bea76,_0x3e0418){_0x3bea76=_0x3bea76-0x19d;const _0x85ebce=_0x85eb();let _0x21f642=_0x85ebce[_0x3bea76];if(_0x21f6['hYrEOG']===undefined){var _0x48126a=function(_0x395bd2){const _0x4d625d='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x159f2e='',_0x42344f='';for(let _0x5e384a=0x0,_0x5e0fe8,_0x3d87be,_0x2815a9=0x0;_0x3d87be=_0x395bd2['charAt'](_0x2815a9++);~_0x3d87be&&(_0x5e0fe8=_0x5e384a%0x4?_0x5e0fe8*0x40+_0x3d87be:_0x3d87be,_0x5e384a++%0x4)?_0x159f2e+=String['fromCharCode'](0xff&_0x5e0fe8>>(-0x2*_0x5e384a&0x6)):0x0){_0x3d87be=_0x4d625d['indexOf'](_0x3d87be);}for(let _0x1390ad=0x0,_0xacb231=_0x159f2e['length'];_0x1390ad<_0xacb231;_0x1390ad++){_0x42344f+='%'+('00'+_0x159f2e['charCodeAt'](_0x1390ad)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x42344f);};_0x21f6['YLFJWV']=_0x48126a,_0x21f6['QIGThW']={},_0x21f6['hYrEOG']=!![];}const _0x34bc75=_0x85ebce[0x0],_0x35aae3=_0x3bea76+_0x34bc75,_0x313f1f=_0x21f6['QIGThW'][_0x35aae3];return!_0x313f1f?(_0x21f642=_0x21f6['YLFJWV'](_0x21f642),_0x21f6['QIGThW'][_0x35aae3]=_0x21f642):_0x21f642=_0x313f1f,_0x21f642;}(function(_0x2bfd99,_0x15717c){const _0x2da93b={_0x54e9ce:0xe4,_0x365578:0xdc,_0x1e3d40:0xca,_0x4b6685:0xcf,_0x203ef1:0xcd,_0x40c126:0x42c,_0x2c39ab:0x418,_0x26293d:0x425,_0x104a07:0x42a,_0x4bb110:0x429,_0x3fc6bc:0x424,_0x338cb0:0x413,_0x28e0d3:0x412,_0x59f92f:0xd5,_0x50e32f:0xdd,_0x14de79:0x417},_0x264a7c={_0x10e0b1:0xd8},_0x2625b6={_0x1f13c6:0x26f};function _0x26eaa7(_0x4e8fc7,_0xe9230d,_0x36c1e2,_0x3643c1){return _0x21f6(_0x3643c1-_0x2625b6._0x1f13c6,_0x4e8fc7);}const _0x40ceea=_0x2bfd99();function _0x19cced(_0x3e0e2c,_0x53e49c,_0x384124,_0x335c20){return _0x21f6(_0x335c20- -_0x264a7c._0x10e0b1,_0x384124);}while(!![]){try{const _0x5479a1=parseInt(_0x19cced(0xc2,0xcb,0xce,0xc7))/0x1*(-parseInt(_0x19cced(_0x2da93b._0x54e9ce,0xe7,0xde,_0x2da93b._0x365578))/0x2)+-parseInt(_0x19cced(_0x2da93b._0x1e3d40,_0x2da93b._0x4b6685,0xc8,0xd2))/0x3+-parseInt(_0x19cced(0xd2,_0x2da93b._0x203ef1,0xcc,0xd7))/0x4*(-parseInt(_0x19cced(0xcf,0xc6,0xc5,0xcd))/0x5)+-parseInt(_0x26eaa7(_0x2da93b._0x40c126,_0x2da93b._0x2c39ab,_0x2da93b._0x26293d,0x421))/0x6*(parseInt(_0x26eaa7(_0x2da93b._0x104a07,_0x2da93b._0x4bb110,0x42f,_0x2da93b._0x3fc6bc))/0x7)+-parseInt(_0x19cced(0xc8,0xc6,0xd3,_0x2da93b._0x1e3d40))/0x8+-parseInt(_0x26eaa7(0x418,0x413,_0x2da93b._0x338cb0,_0x2da93b._0x28e0d3))/0x9*(parseInt(_0x26eaa7(0x417,0x423,0x41c,0x41a))/0xa)+-parseInt(_0x19cced(_0x2da93b._0x59f92f,0xe7,_0x2da93b._0x50e32f,0xdb))/0xb*(-parseInt(_0x26eaa7(0x419,0x40f,_0x2da93b._0x14de79,0x415))/0xc);if(_0x5479a1===_0x15717c)break;else _0x40ceea['push'](_0x40ceea['shift']());}catch(_0x41314e){_0x40ceea['push'](_0x40ceea['shift']());}}}(_0x85eb,0x2ccf2));import{modelIdentityFromParts}from'../chunk-D5IVWJHX.js';import{resolveAnthropicReasoningConfig,resolveOpenAiReasoningConfig}from'../chunk-IUZALP6K.js';import{TurnFailedError}from'../chunk-FFIZ6TKW.js';function _0x85eb(){const _0x27065e=['mMPWCfHhua','mZC4ntGXDfrfwKDz','AxngAw5PDgu','Aw5KzxHpzG','mta5mdC3serRuNLq','Bwf4q29Uy3vYCMvUy3KGBxvZDcbIzsbHigzPBML0zsbWB3nPDgL2zsbPBNrLz2vY','CMvTB3zLqwjVCNrmAxn0zw5LCG','odG5mZKYBhrmwePz','mZyWqMnXDKfs','y2fUy2vSBgvK','nxPjALn4yW','ndmWnJHqEeHkqKK','ywjVCNrLza','AxnjBNrLz2vY','C2HPzNq','ndiYmZeWy1vgyxPo','mJC4nZbxquviChq','CMvZB2X2zq','ChvZAa','BgvUz3rO','mZmXmty0wvHdsgXQ','CMvQzwn0','CMvHC29U','mJr5AMLms1G','mJqYmhjHALfKrW'];_0x85eb=function(){return _0x27065e;};return _0x85eb();}import{OperationAbortedError,addAbortListener,isAbortError,throwIfAborted,toAbortError}from'../chunk-X7VAACWY.js';function createAbortAwareSemaphore(_0x159f2e){const _0x5116df={_0x52bd9e:0x513,_0x4640d5:0x50b,_0x20d093:0x51c,_0x142810:0x318,_0x5467e3:0x306,_0x42ee64:0x307,_0x1d7c65:0x305,_0x18c0ec:0x305},_0xad800b={_0x1f896e:0x69,_0x1e59df:0xe1,_0x528fe3:0xeb,_0x1ae8b9:0xea,_0x541020:0xe6},_0x557b18={_0x1a549b:0x1f4,_0x2ff18e:0x1ef,_0x4c5876:0x107,_0x9426e:0x109,_0xb6d125:0x106},_0x5cbccd={_0x36cbd8:0x441},_0x433fd0={_0x5f01d7:0xa8,_0x1ce750:0x1ea,_0xe665d6:0x1f6,_0x15f5c3:0x1f3,_0x2413cd:0x1f0,_0x3ac0e3:0x95,_0x1fb895:0x9a,_0x568824:0x8a,_0x47117c:0x1ed,_0x47113f:0x1ec},_0x23491b={_0x521549:0x181,_0x107090:0x274,_0xbb772a:0x42},_0x4e652c={_0x277ebb:0x165};if(!Number[_0x310b87(_0x5116df._0x52bd9e,_0x5116df._0x52bd9e,_0x5116df._0x4640d5,_0x5116df._0x20d093)](_0x159f2e)||!Number[_0x319ca3(0x319,_0x5116df._0x142810,0x30d,_0x5116df._0x5467e3)](_0x159f2e)||_0x159f2e<=0x0)throw new Error(_0x319ca3(_0x5116df._0x42ee64,0x309,_0x5116df._0x1d7c65,_0x5116df._0x18c0ec));let _0x42344f=0x0;const _0x5e384a=[];function _0x310b87(_0x1e573b,_0x310c5f,_0x13b431,_0x175478){return _0x21f6(_0x1e573b-0x376,_0x175478);}function _0x319ca3(_0x52cd38,_0x20544b,_0x533fbe,_0x5ad669){return _0x21f6(_0x533fbe-_0x4e652c._0x277ebb,_0x20544b);}const _0x5e0fe8=()=>{let _0x2815a9=![];return()=>{if(_0x2815a9)return;_0x2815a9=!![],_0x42344f-=0x1,_0x3d87be();};},_0x3d87be=()=>{const _0x1fae54={_0x1cd051:0x335,_0x20a516:0x1bd};function _0x2eeead(_0x3d1572,_0x36be8d,_0x261d40,_0x33f1b1){return _0x310b87(_0x3d1572- -_0x1fae54._0x1cd051,_0x36be8d-_0x1fae54._0x20a516,_0x261d40-0x89,_0x33f1b1);}function _0x59251e(_0x19010e,_0x5567c5,_0x1d9acd,_0x3e694a){return _0x319ca3(_0x19010e-_0x23491b._0x521549,_0x5567c5,_0x19010e- -_0x23491b._0x107090,_0x3e694a-_0x23491b._0xbb772a);}while(_0x5e384a[_0x59251e(0x9f,0x98,_0x433fd0._0x5f01d7,0x97)]>0x0){const _0x1390ad=_0x5e384a[_0x2eeead(_0x433fd0._0x1ce750,_0x433fd0._0xe665d6,0x1f5,_0x433fd0._0x15f5c3)]();if(!_0x1390ad||_0x1390ad[_0x2eeead(0x1e5,_0x433fd0._0x2413cd,_0x433fd0._0x1ce750,0x1dc)])continue;_0x1390ad[_0x59251e(_0x433fd0._0x3ac0e3,_0x433fd0._0x1fb895,_0x433fd0._0x568824,0x8c)]=!![],_0x1390ad[_0x2eeead(0x1e2,0x1de,0x1db,_0x433fd0._0x47117c)](),_0x42344f+=0x1,_0x1390ad[_0x2eeead(_0x433fd0._0x47117c,_0x433fd0._0x47113f,0x1ed,0x1e8)](_0x5e0fe8());return;}};return{'acquire'(_0xacb231){const _0x174f16={_0x114af4:0xb0,_0x159a75:0xa6,_0x33c0f9:0x223,_0x94854f:0x227,_0x4f4d38:0xbd,_0x514e2e:0xc9},_0x52235d={_0x59002a:0x170,_0x16c4de:0x12f},_0x590b8b={_0x2d1889:0x4b4,_0x330ba4:0xb6};function _0x35638(_0x15ee00,_0x276d9a,_0x409435,_0x5f5b25){return _0x310b87(_0x15ee00- -_0x5cbccd._0x36cbd8,_0x276d9a-0x4f,_0x409435-0x152,_0x409435);}if(_0xacb231?.[_0x5cc8bc(0x5d,_0xad800b._0x1f896e,0x67,0x65)])return Promise[_0x35638(0xe5,0xef,_0xad800b._0x1e59df,_0xad800b._0x528fe3)](toAbortError(_0xacb231['reason']));function _0x5cc8bc(_0x37cd80,_0x44916c,_0x5ea631,_0x26d780){return _0x310b87(_0x44916c- -_0x590b8b._0x2d1889,_0x44916c-_0x590b8b._0x330ba4,_0x5ea631-0x11a,_0x26d780);}if(_0x42344f<_0x159f2e)return _0x42344f+=0x1,Promise[_0x35638(0xe1,_0xad800b._0x1e59df,_0xad800b._0x1ae8b9,_0xad800b._0x541020)](_0x5e0fe8());return new Promise((_0x3d4735,_0x279b0b)=>{const _0xcf2c92={_0x19dd82:0xd5,_0x5718d0:0x180};function _0x55ff3c(_0x40d500,_0x1aaaf3,_0x1e535b,_0x5aa2c0){return _0x5cc8bc(_0x40d500-_0xcf2c92._0x19dd82,_0x5aa2c0-_0xcf2c92._0x5718d0,_0x1e535b-0x34,_0x1aaaf3);}const _0x279ab1={'resolve':_0x3d4735,'reject':_0x279b0b,'cancelled':![],'removeAbortListener':()=>{}};_0x5e384a[_0x55ff3c(0x1e2,_0x557b18._0x1a549b,0x1f9,_0x557b18._0x2ff18e)](_0x279ab1);function _0x2aae1a(_0x1aeb8c,_0x4a80a0,_0x40abdd,_0x257aa7){return _0x35638(_0x1aeb8c-0x35,_0x4a80a0-_0x52235d._0x59002a,_0x40abdd,_0x257aa7-_0x52235d._0x16c4de);}_0x279ab1[_0x2aae1a(0x10b,_0x557b18._0x4c5876,_0x557b18._0x9426e,_0x557b18._0xb6d125)]=addAbortListener(_0xacb231,()=>{const _0x18f9a5={_0x332c3b:0x11d,_0x91f1f7:0x134},_0x2916df={_0x18b137:0x136};if(_0x279ab1[_0x3c7486(_0x174f16._0x114af4,_0x174f16._0x159a75,0xbb,0xa7)])return;_0x279ab1[_0x540950(0x233,0x22d,0x22b,_0x174f16._0x33c0f9)]=!![];function _0x3c7486(_0x4929f8,_0x40020f,_0x3edc1f,_0x41a978){return _0x55ff3c(_0x4929f8-0x141,_0x3edc1f,_0x3edc1f-0xf0,_0x4929f8- -_0x2916df._0x18b137);}function _0x540950(_0x52f145,_0x546201,_0x396388,_0x5e0790){return _0x2aae1a(_0x396388-_0x18f9a5._0x332c3b,_0x546201-_0x18f9a5._0x91f1f7,_0x5e0790,_0x5e0790-_0x18f9a5._0x91f1f7);}_0x279ab1['removeAbortListener']();const _0x1e7b56=_0x5e384a[_0x540950(0x21c,_0x174f16._0x94854f,0x225,_0x174f16._0x94854f)](_0x279ab1);if(_0x1e7b56>=0x0)_0x5e384a['splice'](_0x1e7b56,0x1);_0x279ab1['reject'](toAbortError(_0xacb231?.[_0x3c7486(_0x174f16._0x4f4d38,0xc4,_0x174f16._0x514e2e,0xb2)]));});});}};}export{OperationAbortedError,TurnFailedError,addAbortListener,createAbortAwareSemaphore,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

@@ -4,9 +4,10 @@ export interface JsonObject {
 }
 export type JsonValue = JsonObject | JsonPrimitive | JsonValue[];
 export type JsonSchemaType = "array" | "boolean" | "number" | "object" | "string";
-export interface JsonSchemaString {
+export interface JsonSchemaString<TEnum extends readonly string[] | undefined = readonly string[] | undefined> {
     type: "string";
     description?: string;
+    enum?: TEnum;
 }
 export interface JsonSchemaNumber {
     type: "number";
@@ -22,8 +23,12 @@ export interface JsonSchemaObject<TProperties extends Record<string, JsonSchema>
     type: "object";
     properties: TProperties;
     required?: TRequired;
+    additionalProperties?: boolean;
 }
-export type JsonSchema = JsonSchemaArray | JsonSchemaBoolean | JsonSchemaNumber | JsonSchemaObject | JsonSchemaString;
+export interface JsonSchemaAnyOf<TVariants extends readonly JsonSchema[] = readonly JsonSchema[]> {
+    anyOf: TVariants;
+}
+export type JsonSchema = JsonSchemaAnyOf | JsonSchemaArray | JsonSchemaBoolean | JsonSchemaNumber | JsonSchemaObject | JsonSchemaString;
 export interface TextBlock {
     type: "text";
     text: string;
@@ -82,12 +87,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 +98,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 +177,7 @@ export interface ModelRequest {
         session_id: string;
         turn_id: string;
         model_identity?: string;
+        pricing_provider_id?: string;
     };
     outputFormat?: OutputFormat;
 }
@@ -194,20 +202,43 @@ 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 PersistedModelCallMetricsV1 {
+    version: 1;
+    usage: ChatResponseUsage;
+    modelTimeMs: number;
+    completesRequest: boolean;
+}
+export type PersistedModelCallMetrics = PersistedModelCallMetricsV1;
 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 {
@@ -246,6 +277,9 @@ export interface OpenAiReasoningSummaryDeltaChunk {
     outputIndex: number;
     summaryIndex: number;
 }
+export interface ProviderStreamResetChunk {
+    type: "provider_stream_reset";
+}
 export interface ProviderRetryChunk {
     type: "provider_retry";
     attempt: number;
@@ -259,7 +293,7 @@ export interface DoneChunk {
     type: "done";
     response: ChatResponse;
 }
-export type ChatResponseChunk = AnthropicSignatureDeltaChunk | AnthropicThinkingDeltaChunk | ContentDeltaChunk | DoneChunk | OpenAiReasoningDeltaChunk | OpenAiReasoningSummaryDeltaChunk | ProviderRetryChunk | ToolUseDeltaChunk;
+export type ChatResponseChunk = AnthropicSignatureDeltaChunk | AnthropicThinkingDeltaChunk | ContentDeltaChunk | DoneChunk | OpenAiReasoningDeltaChunk | OpenAiReasoningSummaryDeltaChunk | ProviderStreamResetChunk | ProviderRetryChunk | ToolUseDeltaChunk;
 export interface ModelLimits {
     contextWindow?: number;
     maxOutput?: number;
@@ -303,6 +337,7 @@ export interface TurnInput {
     system?: SystemInput;
     messages?: MessageInput[];
     message: MessageInput;
+    drainSteering?: () => Promise<MessageInput[]>;
 }
 export interface TurnState {
     sessionId: string;
@@ -370,6 +405,7 @@ export interface TurnMessageMeta {
     provider?: string;
     model?: string;
     modelIdentity?: string;
+    metrics?: PersistedModelCallMetrics;
     /** ms epoch — provider request sent. */
     turnStartedAt?: number;
     /** ms epoch — response fully received. */
@@ -384,6 +420,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 +429,7 @@ export interface BaseChatModelOptions {
     model: string;
     modelIdentity?: string;
     maxTokens?: number;
+    pricingProviderId?: string;
     reasoning?: ReasoningConfig;
     providerSessionResolver?: ProviderSessionResolver;
     requestMutators?: ProviderRequestMutator[];
@@ -417,12 +455,22 @@ 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;
+    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;
@@ -453,6 +501,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 {
@@ -507,8 +557,14 @@ export interface AgentTurnCompleteEvent {
     state: TurnState;
 }
 export interface AgentProviderRetryEvent extends ProviderRetryChunk {
+    assistantMessageId: string;
 }
-export type AgentLifecycleEvent = AgentAssistantChunkEvent | AgentAssistantMessageEvent | AgentFinalMessageEvent | AgentModelRequestEvent | AgentModelResponseEvent | AgentProviderRetryEvent | AgentReasoningChunkEvent | AgentReasoningMessageEvent | AgentToolCallEvent | AgentToolUseChunkEvent | AgentToolUseMessageEvent | AgentToolResultEvent | AgentToolResultMessageEvent | AgentTurnCompleteEvent | AgentUserMessageEvent;
+export interface AgentProviderStreamResetEvent {
+    type: "provider_stream_reset";
+    assistantMessageId: string;
+    reasoningMessageId: string;
+}
+export type AgentLifecycleEvent = AgentAssistantChunkEvent | AgentAssistantMessageEvent | AgentFinalMessageEvent | AgentModelRequestEvent | AgentModelResponseEvent | AgentProviderRetryEvent | AgentProviderStreamResetEvent | AgentReasoningChunkEvent | AgentReasoningMessageEvent | AgentToolCallEvent | AgentToolUseChunkEvent | AgentToolUseMessageEvent | AgentToolResultEvent | AgentToolResultMessageEvent | AgentTurnCompleteEvent | AgentUserMessageEvent;
 export type AgentEvent = AgentLifecycleEvent | ToolRuntimeEvent;
 export type ToolRuntimeDispatchDecision = {
     action: "reject";
@@ -524,6 +580,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;
@@ -534,10 +593,14 @@ export interface ToolRuntime {
     executeCalls(toolCalls: ToolUseBlock[], ctx: ToolExecutionContext): Promise<ToolResult[]>;
     execute(toolCall: ToolUseBlock, ctx: ToolExecutionContext): Promise<ToolResult>;
 }
-export type InferJsonSchema<TSchema extends JsonSchema> = TSchema extends JsonSchemaString ? string : TSchema extends JsonSchemaNumber ? number : TSchema extends JsonSchemaBoolean ? boolean : TSchema extends JsonSchemaArray<infer TItem> ? InferJsonSchema<TItem>[] : TSchema extends JsonSchemaObject<infer TProperties, infer TRequired> ? Expand<RequiredProperties<TProperties, TRequired> & OptionalProperties<TProperties, TRequired>> : never;
+export type InferJsonSchema<TSchema extends JsonSchema> = TSchema extends JsonSchemaAnyOf<infer TVariants> ? JsonSchema extends TVariants[number] ? JsonValue : InferJsonSchemaAnyOf<TVariants> : TSchema extends JsonSchemaString<infer TEnum> ? TEnum extends readonly string[] ? TEnum[number] : string : TSchema extends JsonSchemaNumber ? number : TSchema extends JsonSchemaBoolean ? boolean : TSchema extends JsonSchemaArray<infer TItem> ? InferJsonSchema<TItem>[] : TSchema extends JsonSchemaObject<infer TProperties, infer TRequired> ? Expand<RequiredProperties<TProperties, TRequired> & OptionalProperties<TProperties, TRequired>> : never;
 type Expand<TValue> = TValue extends infer TObject ? {
     [TKey in keyof TObject]: TObject[TKey];
 } : never;
+type JsonSchemaObjectPropertyKeys<TSchema extends JsonSchema> = TSchema extends JsonSchemaObject<infer TProperties> ? Extract<keyof TProperties, string> : never;
+type InferJsonSchemaAnyOfVariant<TVariant extends JsonSchema, TAllVariants extends JsonSchema> = TVariant extends JsonSchemaObject<infer TProperties, infer TRequired> ? Expand<RequiredProperties<TProperties, TRequired> & OptionalProperties<TProperties, TRequired> & (TVariant["additionalProperties"] extends false ? Partial<Record<Exclude<JsonSchemaObjectPropertyKeys<TAllVariants>, keyof TProperties>, never>> : Record<never, never>)> : InferJsonSchema<TVariant>;
+type InferJsonSchemaAnyOfVariants<TVariant extends JsonSchema, TAllVariants extends JsonSchema> = TVariant extends JsonSchema ? InferJsonSchemaAnyOfVariant<TVariant, TAllVariants> : never;
+type InferJsonSchemaAnyOf<TVariants extends readonly JsonSchema[]> = InferJsonSchemaAnyOfVariants<TVariants[number], TVariants[number]>;
 type RequiredKeyUnion<TRequired extends readonly string[] | undefined> = TRequired extends readonly string[] ? TRequired[number] : never;
 type OptionalKeyUnion<TProperties extends Record<string, JsonSchema>, TRequired extends readonly string[] | undefined> = Exclude<keyof TProperties, RequiredKeyUnion<TRequired>>;
 type RequiredProperties<TProperties extends Record<string, JsonSchema>, TRequired extends readonly string[] | undefined> = {
@@ -548,13 +611,19 @@ 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>;
-export interface ToolDefinition<TInput extends JsonObject = JsonObject, TYield extends ToolOutputValue = ToolOutputValue, TReturn extends ToolOutputValue | undefined = ToolOutputValue | undefined, TSchema extends JsonSchemaObject = JsonSchemaObject> {
+/** Internal resource lifetime contract; omitted from model-facing tool schemas and messages. */
+export interface ToolDefinitionLifecycle {
+    acquire(): () => void;
+}
+export interface ToolDefinition<TInput extends object = 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>;
+export type AnyToolDefinition = ToolDefinition<object, ToolOutputValue, ToolOutputValue | undefined, JsonSchemaObject>;
 export type TransformableStage = "afterModelResponse" | "afterToolResult" | "beforeAssistantAppend" | "beforeFinalOutput" | "beforeModelRequest" | "beforeToolExecution" | "beforeToolResultAppend" | "onUserMessage";
 export type ObserverOnlyStage = "afterMessageAppend" | "afterTurnComplete";
 export type Stage = ObserverOnlyStage | TransformableStage;
@@ -591,6 +660,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 = {
@@ -614,9 +685,19 @@ export interface RunTurnDeps {
     outputFormat?: OutputFormat;
 }
 export type AgentInput = MessageInput | string;
+export type SteeringInputDrain = () => Promise<AgentInput[]>;
+/** Immutable ownership metadata for the exact agent submission being sent. */
+export type AgentSubmission = Readonly<{
+    origin: "user";
+}> | Readonly<{
+    origin: "coordinator";
+    token: string;
+}>;
 export interface AgentSendOptions {
     streaming?: boolean;
     signal?: AbortSignal;
+    drainSteering?: SteeringInputDrain;
+    submission?: AgentSubmission;
 }
 export interface AgentOptions {
     sessionId?: string;
@@ -751,7 +832,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/{internal-tool-runtime.d.ts → core/internal-tool-runtime.d.ts}

@@ -1,4 +1,4 @@
-import type { AnyToolDefinition, ToolRuntime, ToolRuntimeEventHandler, ToolRuntimeToolCallHandler } from "../shared/types.ts";
+import type { AnyToolDefinition, ToolRuntime, ToolRuntimeEventHandler, ToolRuntimeToolCallHandler } from "../../shared/types.ts";
 interface InternalToolRuntimeOptions {
     onEvent?: ToolRuntimeEventHandler;
     onToolCall?: ToolRuntimeToolCallHandler;

package/dist/tools/core/mock-tool-runtime.d.ts

@@ -0,0 +1,3 @@
+import type { ToolRuntime } from "../../shared/types.ts";
+export declare function createMockToolRuntime(): ToolRuntime;
+//# sourceMappingURL=mock-tool-runtime.d.ts.map

package/dist/tools/core/runtime-manager-tools.d.ts

@@ -0,0 +1,87 @@
+import { Agent } from "../../agent/agent.ts";
+import type { AbortAwareSemaphore } from "../../shared/abort-aware-semaphore.ts";
+import type { AgentDefinitionFactoryContext, AgentOptions } from "../../shared/types.ts";
+export interface DelegatedAgentFactoryContext extends AgentDefinitionFactoryContext {
+    parentSessionId: string;
+    runId: string;
+    signal: AbortSignal;
+}
+export type DelegatedAgentDefinition = AgentOptions | ((ctx: DelegatedAgentFactoryContext) => AgentOptions | Promise<AgentOptions>);
+export interface CreateDelegationToolsOptions {
+    agents?: Record<string, DelegatedAgentDefinition>;
+    semaphore?: AbortAwareSemaphore;
+    /** Register an active child for shared tool refresh; returns its cleanup callback. */
+    registerActiveAgent?: (agent: Agent, context: DelegatedAgentFactoryContext) => () => void;
+    registerActiveRun?: (entry: {
+        runId: string;
+        abortController: AbortController;
+        completion: Promise<void>;
+    }) => () => void;
+    /** Render a resolved child prompt immediately before constructing its Agent. */
+    renderSystemPrompt?: (systemPrompt: string) => string;
+    /**
+     * Idempotent delegated-resource release (e.g. the run's observation store),
+     * invoked from the outer `finally` on EVERY terminal path: success, abort,
+     * factory rejection, `Agent` construction failure, and registration failure.
+     * The runtime wires this to its idempotent per-run store release, so the
+     * delegation factory's own failure-release may safely converge here.
+     */
+    releaseAgentResources?: (context: DelegatedAgentFactoryContext) => void;
+}
+export declare function resolveDelegatedAgentOptions(definition: DelegatedAgentDefinition, ctx: DelegatedAgentFactoryContext): Promise<AgentOptions>;
+export declare function createAssignTaskTool(options: CreateDelegationToolsOptions): import("../../shared/types.ts").ToolDefinition<{
+    description: string;
+    agentId: string;
+    nickname: string;
+    task: string;
+}, import("../../shared/types.ts").ToolOutputEnvelope, import("../../shared/types.ts").ToolOutputEnvelope, {
+    type: "object";
+    properties: {
+        agentId: {
+            type: "string";
+            description: string;
+        };
+        description: {
+            type: "string";
+            description: string;
+        };
+        nickname: {
+            type: "string";
+            description: string;
+        };
+        task: {
+            type: "string";
+            description: string;
+        };
+    };
+    required: string[];
+}>;
+export declare const createDelegateToAgentTool: typeof createAssignTaskTool;
+export declare function createDelegationTools(options: CreateDelegationToolsOptions): import("../../shared/types.ts").ToolDefinition<{
+    description: string;
+    agentId: string;
+    nickname: string;
+    task: string;
+}, import("../../shared/types.ts").ToolOutputEnvelope, import("../../shared/types.ts").ToolOutputEnvelope, {
+    type: "object";
+    properties: {
+        agentId: {
+            type: "string";
+            description: string;
+        };
+        description: {
+            type: "string";
+            description: string;
+        };
+        nickname: {
+            type: "string";
+            description: string;
+        };
+        task: {
+            type: "string";
+            description: string;
+        };
+    };
+    required: string[];
+}>[];
+//# sourceMappingURL=runtime-manager-tools.d.ts.map

package/dist/tools/{tool-output-offload.d.ts → core/tool-output-offload.d.ts}

@@ -1,4 +1,4 @@
-import type { ToolResult } from "../shared/types.ts";
+import type { ToolResult } from "../../shared/types.ts";
 export interface ToolOutputOffloadOptions {
     maxBytes: number;
     sessionDir?: string;

package/dist/tools/{tools.d.ts → core/tools.d.ts}

@@ -1,4 +1,4 @@
-import type { AnyToolDefinition, InferJsonSchema, JsonObject, JsonSchemaObject, JsonValue, ToolDefinition, ToolExecutionContext, ToolOutputEnvelope, ToolOutputValue, ToolResultChunk, ToolResultContent, ToolSchema } from "../shared/types.ts";
+import type { AnyToolDefinition, InferJsonSchema, JsonObject, JsonSchemaObject, JsonValue, ToolDefinition, ToolDefinitionLifecycle, ToolExecutionContext, ToolOutputEnvelope, ToolOutputValue, ToolPermissionClass, ToolResultChunk, ToolResultContent, ToolSchema } from "../../shared/types.ts";
 export declare function normalizeToolOutputValue(output: ToolOutputValue): ToolResultChunk;
 export declare function createToolOutput(output: string, structured?: JsonObject, content?: ToolResultContent): ToolOutputEnvelope;
 export declare class ToolExecutionError extends Error {
@@ -9,8 +9,11 @@ export declare function defineTool<TSchema extends JsonSchemaObject, TYield exte
     name: string;
     description: string;
     inputSchema: TSchema;
+    permissionClass: ToolPermissionClass;
+    internalLifecycle?: ToolDefinitionLifecycle;
     execute(input: InferJsonSchema<TSchema>, ctx: ToolExecutionContext): AsyncGenerator<TYield, TReturn, void>;
 }): ToolDefinition<InferJsonSchema<TSchema>, TYield, TReturn, TSchema>;
+export declare function resolveToolPermissionClass(tool: AnyToolDefinition | undefined): ToolPermissionClass;
 export declare class ToolRegistry {
     private readonly toolsByName;
     constructor(tools?: AnyToolDefinition[]);

package/dist/tools/file-editing/anchored-file-edit.d.ts

@@ -0,0 +1,53 @@
+import type { Stats } from "node:fs";
+import type { ToolExecutionContext, ToolOutputEnvelope } from "../../shared/types.ts";
+import { type CanonicalFileEditBlock, type CanonicalFileOperation } from "./anchored-file-operations.ts";
+import type { FileMutationCoordinator } from "./file-mutation-coordinator.ts";
+import type { FileObservationStore } from "./file-observation-store.ts";
+import { type AnchoredFileEditMode } from "./structured-file-edit-adapter.ts";
+/**
+ * Upper bound on the canonical preview text an edit may produce. Authored
+ * replacement content is already bounded by the adapters; this bound also
+ * caps source-derived `oldText` when a huge range is deleted/replaced so the
+ * approval preview stays small enough to audit.
+ */
+export declare const MAX_ANCHORED_PREVIEW_BYTES: number;
+export interface CanonicalFileEditPreview {
+    mode: AnchoredFileEditMode;
+    filePath: string;
+    canonicalPath: string;
+    tag: string;
+    digest: string;
+    operationCount: number;
+    operations: readonly CanonicalFileOperation[];
+    blocks: readonly CanonicalFileEditBlock[];
+}
+export interface AnchoredFileEditEnvironment {
+    defaultCwd: string;
+    allowedDirs: readonly string[];
+    observations: FileObservationStore;
+    mutations: FileMutationCoordinator;
+    outputBudgetBytes: number;
+}
+export interface AnchoredFileEditStructuredResult {
+    preview: CanonicalFileEditPreview;
+    beforeDigest: string;
+    afterDigest: string;
+    beforeTag: string;
+    afterTag: string;
+    bytesWritten: number;
+    dryRun: boolean;
+    operationCount: number;
+    tokenClassification: "edit";
+}
+/**
+ * Filesystem seams for under-lock execution tests. Production callers omit the
+ * argument and receive the default Node filesystem backed by `atomicReplaceFile`.
+ */
+export interface AnchoredFileEditFileSystem {
+    readFile(path: string): Promise<Buffer>;
+    stat(path: string): Promise<Stats>;
+    atomicWrite(target: string, bytes: Uint8Array, mode: number): Promise<void>;
+}
+export declare function prepareAnchoredFileEditApproval(mode: AnchoredFileEditMode, input: unknown, sessionId: string, environment: Omit<AnchoredFileEditEnvironment, "mutations">): Promise<CanonicalFileEditPreview>;
+export declare function executeAnchoredFileEdit(mode: AnchoredFileEditMode, input: unknown, context: ToolExecutionContext, environment: AnchoredFileEditEnvironment, fileSystem?: AnchoredFileEditFileSystem): Promise<ToolOutputEnvelope>;
+//# sourceMappingURL=anchored-file-edit.d.ts.map

package/dist/tools/file-editing/anchored-file-errors.d.ts

@@ -0,0 +1,5 @@
+import type { JsonValue } from "../../shared/types.ts";
+import { ToolExecutionError } from "../core/tools.ts";
+export type AnchoredFileErrorCode = "invalid_patch" | "unknown_snapshot" | "ambiguous_snapshot_tag" | "stale_snapshot" | "unseen_lines" | "invalid_range" | "overlapping_operations" | "no_change" | "write_failed" | "post_write_drift";
+export declare function createAnchoredFileError(code: AnchoredFileErrorCode, message: string, structured?: Record<string, JsonValue>): ToolExecutionError;
+//# sourceMappingURL=anchored-file-errors.d.ts.map