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

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(_0x356b53,_0x590795){const _0x182b95={_0x51b9c8:0x2b8,_0x3f8af4:0x2a2,_0x20785e:0x2a5,_0x5beef7:0x230,_0x3b4e67:0x231,_0x1304d9:0x22f,_0x95eae0:0x29f,_0x2a3425:0x2a5,_0xd2555c:0x2ae,_0x43a158:0x298,_0x55f665:0x22c,_0x5e4002:0x23f,_0xe0cc01:0x234,_0xf2d517:0x29e,_0x3c0fef:0x2a5,_0x45cca0:0x2a0,_0x480483:0x21c,_0x35f696:0x225,_0xdf073d:0x29d,_0xbec305:0x2a4,_0xdf221c:0x29c,_0x14db03:0x2a1},_0x56871c={_0x741b31:0x227},_0x42bfb2=_0x356b53();function _0x48bd76(_0x2c6b55,_0x123d16,_0x546033,_0x1c6d8b){return _0x1a7b(_0x1c6d8b-0x1b3,_0x546033);}function _0x4f3684(_0x4091af,_0x2f25db,_0x382484,_0x41ec51){return _0x1a7b(_0x41ec51-_0x56871c._0x741b31,_0x2f25db);}while(!![]){try{const _0x38b8c3=-parseInt(_0x4f3684(0x2a9,0x2ab,_0x182b95._0x51b9c8,0x2ad))/0x1*(parseInt(_0x4f3684(_0x182b95._0x3f8af4,_0x182b95._0x20785e,0x29b,0x2a2))/0x2)+parseInt(_0x48bd76(_0x182b95._0x5beef7,_0x182b95._0x3b4e67,0x23b,_0x182b95._0x1304d9))/0x3+parseInt(_0x4f3684(_0x182b95._0x95eae0,_0x182b95._0x2a3425,_0x182b95._0xd2555c,0x2a7))/0x4*(parseInt(_0x4f3684(0x293,0x2a0,0x29e,_0x182b95._0x43a158))/0x5)+parseInt(_0x48bd76(_0x182b95._0x55f665,_0x182b95._0x5e4002,0x23f,_0x182b95._0xe0cc01))/0x6*(-parseInt(_0x4f3684(_0x182b95._0xf2d517,0x2a3,_0x182b95._0x3c0fef,_0x182b95._0x45cca0))/0x7)+-parseInt(_0x48bd76(_0x182b95._0x480483,_0x182b95._0x35f696,0x22b,0x227))/0x8+parseInt(_0x4f3684(0x29d,_0x182b95._0xdf073d,0x299,0x29a))/0x9*(parseInt(_0x4f3684(_0x182b95._0xbec305,0x29e,0x29d,_0x182b95._0xdf221c))/0xa)+-parseInt(_0x4f3684(0x298,_0x182b95._0x14db03,_0x182b95._0x95eae0,0x29d))/0xb;if(_0x38b8c3===_0x590795)break;else _0x42bfb2['push'](_0x42bfb2['shift']());}catch(_0x3b8b28){_0x42bfb2['push'](_0x42bfb2['shift']());}}}(_0x56be,0x5f63c));import{modelIdentityFromParts}from'../chunk-D5IVWJHX.js';function _0x56be(){const _0x150b55=['C3bSAwnL','ndK0ogfQEwnyuq','mty2mMzQwMLMBW','ChvZAa','Bwf4q29Uy3vYCMvUy3KGBxvZDcbIzsbHigzPBML0zsbWB3nPDgL2zsbPBNrLz2vY','AxngAw5PDgu','ywjVCNrLza','n1HhyvPVDG','y2fUy2vSBgvK','mZe0mfvHA2DKzG','AxnjBNrLz2vY','mJu0nZLlzLHdtLa','mJG2ndG2ngXQsMrjzq','mZmWzhjlCxjK','nZuWndq2ngXdB3bLvq','CMvTB3zLqwjVCNrmAxn0zw5LCG','CMvHC29U','mZCXExnnr2Th','CMvZB2X2zq','ndeYodHPquLUue0','mJe1otKZnensy2jlzW','BgvUz3rO','CMvQzwn0'];_0x56be=function(){return _0x150b55;};return _0x56be();}import{resolveAnthropicReasoningConfig,resolveOpenAiReasoningConfig}from'../chunk-IUZALP6K.js';function _0x1a7b(_0x1d1df3,_0x3cc141){_0x1d1df3=_0x1d1df3-0x70;const _0x56be5b=_0x56be();let _0x1a7bd8=_0x56be5b[_0x1d1df3];if(_0x1a7b['xJhRoT']===undefined){var _0x77f554=function(_0x165bf4){const _0x534a62='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';let _0x23b13b='',_0x5a9669='';for(let _0x5af117=0x0,_0x5d35fb,_0x9dad85,_0x508b06=0x0;_0x9dad85=_0x165bf4['charAt'](_0x508b06++);~_0x9dad85&&(_0x5d35fb=_0x5af117%0x4?_0x5d35fb*0x40+_0x9dad85:_0x9dad85,_0x5af117++%0x4)?_0x23b13b+=String['fromCharCode'](0xff&_0x5d35fb>>(-0x2*_0x5af117&0x6)):0x0){_0x9dad85=_0x534a62['indexOf'](_0x9dad85);}for(let _0x4d6e27=0x0,_0x4981ba=_0x23b13b['length'];_0x4d6e27<_0x4981ba;_0x4d6e27++){_0x5a9669+='%'+('00'+_0x23b13b['charCodeAt'](_0x4d6e27)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x5a9669);};_0x1a7b['UdLlbN']=_0x77f554,_0x1a7b['tyIuMS']={},_0x1a7b['xJhRoT']=!![];}const _0x19ab5a=_0x56be5b[0x0],_0x23fc70=_0x1d1df3+_0x19ab5a,_0x541a36=_0x1a7b['tyIuMS'][_0x23fc70];return!_0x541a36?(_0x1a7bd8=_0x1a7b['UdLlbN'](_0x1a7bd8),_0x1a7b['tyIuMS'][_0x23fc70]=_0x1a7bd8):_0x1a7bd8=_0x541a36,_0x1a7bd8;}import{TurnFailedError}from'../chunk-FFIZ6TKW.js';import{OperationAbortedError,addAbortListener,isAbortError,throwIfAborted,toAbortError}from'../chunk-X7VAACWY.js';function createAbortAwareSemaphore(_0x23b13b){const _0x22a76e={_0x469a34:0x1a8,_0x570fc1:0x194,_0x324c8e:0x284,_0x403bf8:0x28e,_0x510799:0x28b},_0x1763eb={_0x58c201:0x2c0,_0x1c8f47:0x2c0,_0x21d6ef:0x2c6,_0x1326a8:0x2c8,_0x5743bc:0x18f,_0x370b07:0x18d,_0x37590d:0x18e,_0x4dc52c:0x2c1},_0x4e0546={_0x45950a:0x66,_0x3c0141:0x85,_0x2ed82c:0x87,_0x579a74:0x7d,_0x2b3ca0:0x75,_0x27f9cc:0x71,_0x30564e:0x7d,_0x1121c4:0x71,_0x3762ff:0x76},_0xac4afe={_0x367bce:0x1c4,_0x42ad18:0x5f9},_0x387a46={_0x5d0319:0x11c};if(!Number[_0x63ad76(_0x22a76e._0x469a34,0x196,0x1a0,_0x22a76e._0x570fc1)](_0x23b13b)||!Number[_0x1d0522(-_0x22a76e._0x324c8e,-0x28c,-_0x22a76e._0x403bf8,-_0x22a76e._0x510799)](_0x23b13b)||_0x23b13b<=0x0)throw new Error(_0x63ad76(0x195,0x19c,0x19f,0x1a7));let _0x5a9669=0x0;const _0x5af117=[],_0x5d35fb=()=>{let _0x508b06=![];return()=>{if(_0x508b06)return;_0x508b06=!![],_0x5a9669-=0x1,_0x9dad85();};};function _0x63ad76(_0x5aef93,_0x699e1c,_0x30c53b,_0x330c11){return _0x1a7b(_0x30c53b-_0x387a46._0x5d0319,_0x330c11);}const _0x9dad85=()=>{const _0x5c1663={_0x133fe8:0xa4};function _0x412f85(_0x218c0b,_0x23a791,_0x59f72b,_0x285af0){return _0x1d0522(_0x218c0b-_0xac4afe._0x367bce,_0x285af0-_0xac4afe._0x42ad18,_0x59f72b-0xc2,_0x23a791);}function _0x4321f2(_0xbbfc80,_0x34f378,_0x52debf,_0x25c282){return _0x63ad76(_0xbbfc80-_0x5c1663._0x133fe8,_0x34f378-0x1d8,_0x25c282- -0x209,_0x34f378);}while(_0x5af117[_0x4321f2(-0x6c,-0x71,-_0x4e0546._0x45950a,-0x70)]>0x0){const _0x4d6e27=_0x5af117['shift']();if(!_0x4d6e27||_0x4d6e27[_0x4321f2(-_0x4e0546._0x3c0141,-0x7c,-_0x4e0546._0x2ed82c,-_0x4e0546._0x579a74)])continue;_0x4d6e27[_0x4321f2(-_0x4e0546._0x2b3ca0,-0x81,-_0x4e0546._0x27f9cc,-_0x4e0546._0x30564e)]=!![],_0x4d6e27[_0x4321f2(-0x7b,-0x77,-_0x4e0546._0x1121c4,-_0x4e0546._0x3762ff)](),_0x5a9669+=0x1,_0x4d6e27['resolve'](_0x5d35fb());return;}};function _0x1d0522(_0x2f91bb,_0x4f962e,_0x198457,_0x23b4f4){return _0x1a7b(_0x4f962e- -0x2fe,_0x23b4f4);}return{'acquire'(_0x4981ba){const _0x2f17b4={_0xed0692:0x128,_0x249629:0x124},_0x138c10={_0xc21bba:0xc,_0x380654:0xb,_0x45c40f:0x0,_0x4ebb58:0x202,_0x7b61dd:0x10,_0x5c4476:0x6,_0x47dfb3:0x3,_0x5e5d8e:0xd,_0x3a2dca:0x3,_0x4b3e46:0x8},_0x235efc={_0x299b20:0x179,_0x45bee1:0xc},_0x5b7356={_0x48d2f9:0xab,_0x131c72:0x47,_0x14c728:0x28};function _0x1a3d9c(_0x478b18,_0x5a0adb,_0x3e900e,_0x557be2){return _0x1d0522(_0x478b18-_0x5b7356._0x48d2f9,_0x478b18- -_0x5b7356._0x131c72,_0x3e900e-_0x5b7356._0x14c728,_0x557be2);}if(_0x4981ba?.[_0x1a3d9c(-_0x1763eb._0x58c201,-0x2c7,-_0x1763eb._0x1c8f47,-_0x1763eb._0x21d6ef)])return Promise[_0x1a3d9c(-0x2c7,-_0x1763eb._0x1326a8,-0x2bd,-0x2c4)](toAbortError(_0x4981ba[_0x2d310d(0x188,_0x1763eb._0x5743bc,_0x1763eb._0x370b07,_0x1763eb._0x37590d)]));if(_0x5a9669<_0x23b13b)return _0x5a9669+=0x1,Promise[_0x1a3d9c(-0x2cb,-0x2ce,-_0x1763eb._0x4dc52c,-0x2c8)](_0x5d35fb());function _0x2d310d(_0x228691,_0x48e8bb,_0x3bd1b9,_0x2a62fc){return _0x63ad76(_0x228691-_0x235efc._0x299b20,_0x48e8bb-0x61,_0x228691- -_0x235efc._0x45bee1,_0x3bd1b9);}return new Promise((_0x64d9e6,_0x12dc6b)=>{const _0x4fcd95={_0x2d34aa:0x124},_0x7c80d8={_0xdaf987:0x1c5,_0x213fe5:0x116},_0x46ce52={_0x2d64cd:0x20c,_0x516b14:0x1aa};function _0x10d58b(_0x579113,_0x5a9f4c,_0x28d6f2,_0x153b36){return _0x1a3d9c(_0x28d6f2-0x3eb,_0x5a9f4c-0x1dd,_0x28d6f2-0x139,_0x153b36);}function _0x1fcdba(_0x3061c3,_0x178a86,_0x326b96,_0x4e601d){return _0x1a3d9c(_0x3061c3-_0x46ce52._0x2d64cd,_0x178a86-0x16b,_0x326b96-_0x46ce52._0x516b14,_0x178a86);}const _0x3c72c8={'resolve':_0x64d9e6,'reject':_0x12dc6b,'cancelled':![],'removeAbortListener':()=>{}};_0x5af117[_0x10d58b(0x12b,0x125,_0x2f17b4._0xed0692,0x131)](_0x3c72c8),_0x3c72c8[_0x10d58b(_0x2f17b4._0x249629,0x128,0x11d,0x116)]=addAbortListener(_0x4981ba,()=>{if(_0x3c72c8[_0x241e9e(_0x138c10._0xc21bba,-_0x138c10._0x380654,0xb,_0x138c10._0x45c40f)])return;_0x3c72c8[_0x146b4b(0x20a,0x201,_0x138c10._0x4ebb58,_0x138c10._0x4ebb58)]=!![],_0x3c72c8[_0x146b4b(0x207,0x204,0x205,0x209)]();function _0x241e9e(_0x2cbaba,_0x5cca14,_0x323388,_0x451f2f){return _0x10d58b(_0x2cbaba-_0x7c80d8._0xdaf987,_0x5cca14-0x38,_0x451f2f- -_0x7c80d8._0x213fe5,_0x323388);}const _0x30859c=_0x5af117['indexOf'](_0x3c72c8);if(_0x30859c>=0x0)_0x5af117[_0x241e9e(_0x138c10._0x7b61dd,0x9,_0x138c10._0x5c4476,0xf)](_0x30859c,0x1);function _0x146b4b(_0x399cd7,_0x2f1717,_0x2458f4,_0x5ea300){return _0x1fcdba(_0x5ea300-0x2cb,_0x2458f4,_0x2458f4-_0x4fcd95._0x2d34aa,_0x5ea300-0x104);}_0x3c72c8[_0x241e9e(_0x138c10._0x47dfb3,0x3,0xd,0xe)](toAbortError(_0x4981ba?.[_0x241e9e(_0x138c10._0x5e5d8e,_0x138c10._0xc21bba,-_0x138c10._0x3a2dca,_0x138c10._0x4b3e46)]));});});}};}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 {
@@ -303,6 +334,7 @@ export interface TurnInput {
     system?: SystemInput;
     messages?: MessageInput[];
     message: MessageInput;
+    drainSteering?: () => Promise<MessageInput[]>;
 }
 export interface TurnState {
     sessionId: string;
@@ -370,6 +402,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 +417,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 +426,7 @@ export interface BaseChatModelOptions {
     model: string;
     modelIdentity?: string;
     maxTokens?: number;
+    pricingProviderId?: string;
     reasoning?: ReasoningConfig;
     providerSessionResolver?: ProviderSessionResolver;
     requestMutators?: ProviderRequestMutator[];
@@ -417,12 +452,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 +498,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 {
@@ -524,6 +571,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 +584,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 +602,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 +651,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 +676,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 +823,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

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

@@ -0,0 +1,38 @@
+import type { NormalizedFileSnapshot } from "./file-snapshot.ts";
+export type CanonicalFileOperation = {
+    operation: "replace";
+    startLine: number;
+    endLine: number;
+    content: string;
+} | {
+    operation: "delete";
+    startLine: number;
+    endLine: number;
+} | {
+    operation: "insert";
+    position: "before" | "after";
+    line: number;
+    content: string;
+};
+export interface FileEditLineNumbers {
+    oldStartLine: number;
+    oldEndLine: number;
+    newStartLine: number;
+    newEndLine: number;
+    oldLineCount: number;
+    newLineCount: number;
+}
+export interface CanonicalFileEditBlock {
+    oldText: string;
+    newText: string;
+    lineNumbers: FileEditLineNumbers;
+}
+export interface PreparedCanonicalFileEdit {
+    afterText: string;
+    operations: readonly CanonicalFileOperation[];
+    blocks: readonly CanonicalFileEditBlock[];
+    requiredLines: readonly number[];
+    payloadDigest: string;
+}
+export declare function prepareCanonicalFileEdit(snapshot: NormalizedFileSnapshot, observedLines: ReadonlySet<number>, operations: readonly CanonicalFileOperation[]): PreparedCanonicalFileEdit;
+//# sourceMappingURL=anchored-file-operations.d.ts.map