@nuvin/agent-core 0.1.1-rc.0 → 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(_0x28b6cf,_0x313690){var _0x38bbe6={_0x10a28a:0x49b,_0x19a2ed:0x49f,_0x43e27e:0x2fd,_0x497508:0x2f5,_0x7d2cac:0x2ef,_0x4b4c9c:0x2f6,_0xe80ea9:0x2f2,_0x36c5dc:0x2f4,_0x18244b:0x2f8,_0x210343:0x2f2,_0x3d5d26:0x496,_0x5724a5:0x497,_0x2a0e1a:0x49e,_0x35e477:0x4a2,_0x3526f5:0x49d,_0x4a53b5:0x2ee,_0x32dec5:0x2f3,_0x9260f3:0x2fc,_0x12505d:0x2f9},_0x28bebd={_0x3f354a:0x17a},_0xc060d4={_0x3bca37:0x31c};function _0x3f19f4(_0x440d31,_0x2703a6,_0x12d843,_0x1c8ef5){return _0xe757(_0x440d31-_0xc060d4._0x3bca37,_0x2703a6);}function _0x364ee1(_0x14ff6d,_0x32366e,_0x4c4683,_0x569d52){return _0xe757(_0x4c4683-_0x28bebd._0x3f354a,_0x14ff6d);}var _0x595bd5=_0x28b6cf();while(!![]){try{var _0x4a9229=parseInt(_0x3f19f4(_0x38bbe6._0x10a28a,_0x38bbe6._0x19a2ed,_0x38bbe6._0x19a2ed,0x4a0))/0x1*(parseInt(_0x364ee1(_0x38bbe6._0x43e27e,0x2f5,0x2fb,_0x38bbe6._0x497508))/0x2)+-parseInt(_0x364ee1(_0x38bbe6._0x7d2cac,_0x38bbe6._0x4b4c9c,_0x38bbe6._0xe80ea9,0x2f0))/0x3*(parseInt(_0x364ee1(0x2f0,0x2f8,_0x38bbe6._0x36c5dc,0x2f8))/0x4)+-parseInt(_0x364ee1(0x2f7,0x2f5,0x2fa,_0x38bbe6._0x18244b))/0x5*(-parseInt(_0x364ee1(0x300,0x301,0x2fd,0x2fd))/0x6)+parseInt(_0x364ee1(0x2f6,_0x38bbe6._0x210343,0x2f8,0x2f6))/0x7+-parseInt(_0x3f19f4(0x499,_0x38bbe6._0x19a2ed,0x49c,0x498))/0x8*(-parseInt(_0x3f19f4(0x497,_0x38bbe6._0x3d5d26,0x495,_0x38bbe6._0x5724a5))/0x9)+parseInt(_0x3f19f4(_0x38bbe6._0x2a0e1a,_0x38bbe6._0x35e477,0x49c,_0x38bbe6._0x3526f5))/0xa+parseInt(_0x364ee1(_0x38bbe6._0x4a53b5,_0x38bbe6._0xe80ea9,_0x38bbe6._0x32dec5,0x2ef))/0xb*(-parseInt(_0x364ee1(_0x38bbe6._0x9260f3,_0x38bbe6._0x12505d,0x2f6,0x2f4))/0xc);if(_0x4a9229===_0x313690)break;else _0x595bd5['push'](_0x595bd5['shift']());}catch(_0x4800f7){_0x595bd5['push'](_0x595bd5['shift']());}}}(_0x2f30,0x76c45));function _0xe757(_0x55bbf4,_0x44a331){_0x55bbf4=_0x55bbf4-0x178;var _0x2f3055=_0x2f30();var _0xe757dc=_0x2f3055[_0x55bbf4];if(_0xe757['cPLpok']===undefined){var _0x2f47c5=function(_0x29e67b){var _0x321903='abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789+/=';var _0x28f50b='',_0x3f0394='';for(var _0x1f89e0=0x0,_0x4582eb,_0x4ed472,_0x32c798=0x0;_0x4ed472=_0x29e67b['charAt'](_0x32c798++);~_0x4ed472&&(_0x4582eb=_0x1f89e0%0x4?_0x4582eb*0x40+_0x4ed472:_0x4ed472,_0x1f89e0++%0x4)?_0x28f50b+=String['fromCharCode'](0xff&_0x4582eb>>(-0x2*_0x1f89e0&0x6)):0x0){_0x4ed472=_0x321903['indexOf'](_0x4ed472);}for(var _0x3e670f=0x0,_0x37e678=_0x28f50b['length'];_0x3e670f<_0x37e678;_0x3e670f++){_0x3f0394+='%'+('00'+_0x28f50b['charCodeAt'](_0x3e670f)['toString'](0x10))['slice'](-0x2);}return decodeURIComponent(_0x3f0394);};_0xe757['GdDsmh']=_0x2f47c5,_0xe757['XhpQrj']={},_0xe757['cPLpok']=!![];}var _0x3788ea=_0x2f3055[0x0],_0x28db43=_0x55bbf4+_0x3788ea,_0x2b2057=_0xe757['XhpQrj'][_0x28db43];return!_0x2b2057?(_0xe757dc=_0xe757['GdDsmh'](_0xe757dc),_0xe757['XhpQrj'][_0x28db43]=_0xe757dc):_0xe757dc=_0x2b2057,_0xe757dc;}function _0x2f30(){var _0x2576de=['mJy3mtKXnhzMEu9LBa','mJG1Du16sLDl','nZDcsfHTAhO','mtm4nZzhthDxs2m','nty3nZeXBfvVBxjU','mtyXmJG2mhvwzvvwCW','oenzvhr6vq','ndq0odmWnhvnCNLLBa','mZeYnZmZs1HiChn2','nuL3EvDfzW','mKHpAfrvAG','mZaWmJu2mfHWA3Hwzq'];_0x2f30=function(){return _0x2576de;};return _0x2f30();}import{modelIdentityFromParts}from'../chunk-D5IVWJHX.js';import{mapAutoReasoningEffortToBudgetTokens,resolveAnthropicThinkingConfig,resolveOpenAiReasoningConfig}from'../chunk-NYZR4XKO.js';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;
 }
@@ -121,6 +128,7 @@ export interface MessageProviderState {
     anthropicAssistantContent?: AnthropicAssistantContentBlock[];
     openaiResponsesOutput?: OpenAiResponsesOutputItem[];
     openaiResponsesResponseId?: string;
+    originModelIdentity?: string;
 }
 export type AssistantContentBlock = AnthropicRedactedThinkingBlock | AnthropicThinkingBlock | OpenAiReasoningBlock | TextBlock | ToolUseBlock;
 export type ContentBlock = AssistantContentBlock | ImageBlock | ToolResultBlock;
@@ -168,6 +176,8 @@ export interface ModelRequest {
     metadata: {
         session_id: string;
         turn_id: string;
+        model_identity?: string;
+        pricing_provider_id?: string;
     };
     outputFormat?: OutputFormat;
 }
@@ -191,20 +201,44 @@ export interface ChatRequest {
     metadata: {
         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 {
@@ -300,6 +334,7 @@ export interface TurnInput {
     system?: SystemInput;
     messages?: MessageInput[];
     message: MessageInput;
+    drainSteering?: () => Promise<MessageInput[]>;
 }
 export interface TurnState {
     sessionId: string;
@@ -366,6 +401,8 @@ export interface ModelExecutionOptions {
 export interface TurnMessageMeta {
     provider?: string;
     model?: string;
+    modelIdentity?: string;
+    metrics?: PersistedModelCallMetrics;
     /** ms epoch — provider request sent. */
     turnStartedAt?: number;
     /** ms epoch — response fully received. */
@@ -380,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[]>;
@@ -388,6 +426,7 @@ export interface BaseChatModelOptions {
     model: string;
     modelIdentity?: string;
     maxTokens?: number;
+    pricingProviderId?: string;
     reasoning?: ReasoningConfig;
     providerSessionResolver?: ProviderSessionResolver;
     requestMutators?: ProviderRequestMutator[];
@@ -413,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;
@@ -449,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 {
@@ -520,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;
@@ -530,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> = {
@@ -544,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;
@@ -587,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 = {
@@ -610,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;
@@ -747,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