eve 0.83.3 → 0.84.1

package/dist/src/computer-use/extension/tools/computer_use.js

@@ -1 +1 @@
-import{computerUseDesktopSizeCommand,computerUseDriverCommand,computerUseDriverRequest,computerUseFocusCommand,computerUseLaunchCommand,computerUsePaths,computerUseWindowLayoutCommand,recordingPath,screenshotPath}from"../lib/computer-use.js";import{ensureComputerUse}from"../lib/computer-use-sandbox.js";import{z}from"#compiled/zod/index.js";import{defineTool}from"eve/tools";import{never}from"eve/tools/approval";const coordinate=z.number().int().min(0),screenshotFileName=z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*\.png$/u),recordingFileName=z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*\.mp4$/u),key=z.string().regex(/^[A-Za-z0-9_.-]+$/u),browserUrl=z.string().url().refine(isHttpUrl,{message:`browser URL must use HTTP or HTTPS`}),button=z.enum([`left`,`middle`,`wheel`,`right`,`back`,`forward`]).default(`left`),modifierKeys=z.array(key).min(1).max(4).optional();function typeActionShape(e){return{action:z.literal(`type`),text:z.string().min(1).max(e),typingDelayMs:z.number().int().min(0).max(200).optional(),typingStyle:z.literal(`natural`).optional()}}const typingStyleRefinement=[e=>e.typingDelayMs===void 0||e.typingStyle===void 0,{message:`type action cannot set both typingDelayMs and typingStyle`}],sequenceTypeActionSchema=z.object(typeActionShape(2e3)).refine(...typingStyleRefinement),typeActionSchema=z.object(typeActionShape(1e4)).refine(...typingStyleRefinement),movementStyle=z.enum([`natural`,`precision`]).optional(),pointerDurationMs=z.number().int().min(0).max(2e3).optional().describe(`optional cursor travel duration for recorded demos; use about 600ms`),precisionMovementStyle=z.literal(`precision`).optional(),dragPoint=z.object({x:coordinate.max(1919),y:coordinate.max(1079)}),windowSelectorSchema=z.discriminatedUnion(`app`,[z.object({app:z.literal(`firefox`)}),z.object({app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`])})]),windowRegionSchema=z.object({x:z.number().min(0).max(1),y:z.number().min(0).max(1),width:z.number().positive().max(1),height:z.number().positive().max(1)}).refine(e=>e.x+e.width<=1&&e.y+e.height<=1,{message:`window region must fit within the desktop`}),arrangeWindowsSchema=z.object({action:z.literal(`arrange_windows`),windows:z.array(z.object({selector:windowSelectorSchema,region:windowRegionSchema})).min(1).max(4),waitForMs:z.number().int().min(0).max(1e4).optional().default(5e3)}),sequenceActionSchema=z.discriminatedUnion(`action`,[z.object({action:z.literal(`click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`double_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`triple_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`drag`),path:z.array(dragPoint).min(2).max(100),movementStyle:precisionMovementStyle,durationMs:pointerDurationMs}),z.object({action:z.literal(`keypress`),keys:z.array(key).min(1).max(4)}),z.object({action:z.literal(`move`),x:coordinate.max(1919),y:coordinate.max(1079),durationMs:pointerDurationMs,movementStyle}),sequenceTypeActionSchema,z.object({action:z.literal(`wait`),durationMs:z.number().int().min(100).max(1e4)}),arrangeWindowsSchema,z.object({action:z.literal(`record_start`),path:recordingFileName}),z.object({action:z.literal(`record_stop`)})]),driverResponseSchema=z.object({backend:z.literal(`cua-driver`),screenshot:z.string(),state:z.string(),action:z.unknown().optional(),version:z.literal(`0.12.5`)}).passthrough(),inputSchema=z.union([z.union([z.object({action:z.literal(`set_desktop_size`),size:z.enum([`full_hd`,`large_16_9`,`social_16_9`])}),z.object({action:z.literal(`launch`),app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`]).optional().default(`primary`)}),z.object({action:z.literal(`focus`),app:z.literal(`firefox`)}),z.object({action:z.literal(`focus`),app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`]).optional().default(`primary`)}),z.object({action:z.literal(`arrange_pair`),pair:z.enum([`terminal_browser`,`terminal_terminal`]),waitForMs:z.number().int().min(0).max(1e4).optional().default(5e3)}),arrangeWindowsSchema,z.object({action:z.literal(`window_layout`),app:z.literal(`desktop`),layout:z.enum([`maximized`,`left`,`right`])}),z.object({action:z.literal(`launch`),app:z.literal(`firefox`),url:browserUrl.optional()})]),z.discriminatedUnion(`action`,[z.object({action:z.literal(`screenshot`),path:screenshotFileName.optional()}),z.object({action:z.literal(`click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`double_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`triple_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`drag`),path:z.array(dragPoint).min(2).max(100),keys:modifierKeys,movementStyle:precisionMovementStyle,durationMs:pointerDurationMs}),z.object({action:z.literal(`keypress`),keys:z.array(key).min(1).max(4)}),z.object({action:z.literal(`move`),x:coordinate.max(1919),y:coordinate.max(1079),keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`scroll`),x:coordinate.max(1919),y:coordinate.max(1079),scroll_x:z.number().finite().min(-1e4).max(1e4),scroll_y:z.number().finite().min(-1e4).max(1e4),keys:modifierKeys}),typeActionSchema,z.object({action:z.literal(`clipboard_read`),selection:z.enum([`clipboard`,`primary`])}),z.object({action:z.literal(`clipboard_write`),selection:z.enum([`clipboard`,`primary`]),text:z.string().max(1e4)}),z.object({action:z.literal(`wait`),durationMs:z.number().int().min(100).max(1e4).optional().default(2e3)}),z.object({action:z.literal(`record_start`),path:recordingFileName.optional()}),z.object({action:z.literal(`record_stop`)}),z.object({action:z.literal(`sequence`),actions:z.array(sequenceActionSchema).min(1).max(30)})])]);var computer_use_default=defineTool({description:`Pass the selected action inside request, for example {request:{action:"screenshot"}}. Execute an OpenAI computer-use action against the isolated X11 desktop. Use set_desktop_size before launching managed windows to select full_hd (1920x1080), large_16_9 (1600x900), or social_16_9 (1280x720); smaller desktops make fixed-size UI and terminal text occupy more of the recording. Each action runs through Cua Driver and returns a fresh screenshot path plus the foreground application grounding window, pointer position, and bounded accessibility elements with screen coordinates. Actions execute without a human approval prompt. Use those coordinates for the next action. Use launch with app firefox and an optional HTTP(S) URL for the browser. Use launch with app xterm and instance primary or secondary for up to two managed terminals. Use focus to activate an existing app without changing its geometry. Use arrange_pair for common 50/50 terminal/browser or two-terminal layouts. Use arrange_windows for custom one-to-four-window scenes with proportional regions; it resolves every managed selector before moving any window, rejects overlap and unreadable geometry, waits boundedly for newly opened windows, and verifies the applied scene. Use window_layout with app desktop only for a single active window. Do not launch either application through a shell command. The action shape follows the OpenAI computer tool: screenshot, click, double_click, triple_click, drag, keypress, move, scroll, type, clipboard_read, clipboard_write, and wait, plus constrained layout, launch, and recording lifecycle actions. arrange_windows is available inside sequence for a deterministic mid-demo transition after an interaction opens Firefox. Use sequence for a rehearsed recording so up to 30 actions execute in one sandbox round trip with only one final screenshot. Pointer movement remains direct when movementStyle is omitted, preserving faithful exploratory and bug-repro interaction. For polished recordings, explicitly use movementStyle natural for confident curved moves/clicks and precision for drags; precision approaches the drag start naturally, pauses briefly around mouse-down, makes one subtle undershoot and exact correction while held, then pauses before mouse-up. Natural duration is distance-based and deliberately brisk; durationMs can override styled moves, clicks, and drags when exact timing matters. Recording actions return the sandbox path of the MP4 file; recordings stop automatically after five minutes. Requests have a two-minute deadline including queue time. Typing is limited to 10000 characters total per request; paced typing additionally allows at most 1000 graphemes and 30000ms of planned delay across the whole sequence. Omit typingStyle and typingDelayMs for longer text. Paced typing timings retain only the final driver result and grapheme count.`,inputSchema:z.object({request:inputSchema}),approval:never(),async execute({request:e},t){let n=await t.getSandbox();if(`keys`in e&&e.action!==`keypress`&&e.keys?.length)throw Error(`computer-use pointer action modifiers are not supported`);e.action===`sequence`&&validateSequenceBudget(e.actions),await ensureComputerUse(n,t.abortSignal);let r=e.action===`arrange_pair`?arrangePairAction(e.pair,e.waitForMs):e.action===`sequence`?{...e,actions:e.actions.map(e=>e.action===`record_start`?{...e,path:recordingPath(n,e.path)}:e)}:e.action===`record_start`?{...e,path:recordingPath(n,e.path??`recording-${crypto.randomUUID()}.mp4`)}:e.action===`scroll`?{...e,scrollX:e.scroll_x,scrollY:e.scroll_y}:e;if(r.action===`set_desktop_size`||r.action===`launch`||r.action===`focus`||r.action===`window_layout`){let i=await n.run({command:r.action===`set_desktop_size`?computerUseDesktopSizeCommand(n,r.size):r.action===`launch`?computerUseLaunchCommand(n,r):r.action===`focus`?computerUseFocusCommand(n,r.app,r.app===`xterm`?r.instance:void 0):computerUseWindowLayoutCommand(n,r.layout),abortSignal:t.abortSignal});ensureSuccess(e.action,i)}let i=r.action===`screenshot`?screenshotPath(n,r.path):screenshotPath(n),a=r.action===`set_desktop_size`||r.action===`launch`||r.action===`focus`||r.action===`window_layout`?{action:`screenshot`}:r,o=await callComputerUseDriver(n,computerUseDriverRequest(a,i),t.abortSignal);if(o.screenshot!==i)throw Error(`computer-use driver returned an unexpected screenshot path`);let s={action:e.action,backend:o.backend,path:r.action===`screenshot`?i:r.action===`record_start`?r.path:r.action===`sequence`?r.actions.find(e=>e.action===`record_start`)?.path??null:null,screenshot:i,state:o.state,version:o.version};return(e.action===`clipboard_read`||e.action===`clipboard_write`)&&(s.result=o.action),r.action===`sequence`&&(s.timings=o.action),s}});async function callComputerUseDriver(e,t,n){let r=await e.run({command:computerUseDriverCommand(e),env:{COMPUTER_USE_REQUEST:JSON.stringify(t),COMPUTER_USE_SOCKET_PATH:computerUsePaths(e).driverSocket},abortSignal:n});ensureSuccess(t.action.action,r);try{return driverResponseSchema.parse(JSON.parse(r.stdout))}catch(e){throw Error(`computer-use driver returned an invalid response`,{cause:e})}}function arrangePairAction(e,t){return{action:`arrange_windows`,waitForMs:t,windows:[{selector:e===`terminal_browser`?{app:`firefox`}:{app:`xterm`,instance:`primary`},region:{x:0,y:0,width:.5,height:1}},{selector:e===`terminal_browser`?{app:`xterm`,instance:`primary`}:{app:`xterm`,instance:`secondary`},region:{x:.5,y:0,width:.5,height:1}}]}}function validateSequenceBudget(e){let t=e.reduce((e,t)=>e+(t.action===`type`?t.text.length:0),0),n=e.flatMap((e,t)=>e.action===`record_start`?[t]:[]),r=e.flatMap((e,t)=>e.action===`record_stop`?[t]:[]),i=n.length,a=r.length;if(t>1e4)throw Error(`computer-use sequence may type at most 10000 characters`);if(i>1||a>1)throw Error(`computer-use sequence may record at most one take`);if(i===0!=(a===0))throw Error(`computer-use recording sequence requires one start and one stop`);if(i===1&&(n[0]!==0||r[0]!==e.length-1))throw Error(`computer-use recording sequence must start first and stop last`)}function ensureSuccess(e,t){if(t.exitCode!==0)throw Error(`computer ${e} failed (exit ${t.exitCode}): ${t.stderr}`)}function isHttpUrl(e){if(!URL.canParse(e))return!1;let t=new URL(e).protocol;return t===`http:`||t===`https:`}export{computer_use_default as default};
+import{computerUseDesktopSizeCommand,computerUseDriverCommand,computerUseDriverRequest,computerUseFocusCommand,computerUseLaunchCommand,computerUsePaths,computerUseWindowLayoutCommand,recordingPath,screenshotPath}from"../lib/computer-use.js";import{ensureComputerUse}from"../lib/computer-use-sandbox.js";import{z}from"#compiled/zod/index.js";import{defineTool}from"eve/tools";import{never}from"eve/tools/approval";const coordinate=z.number().int().min(0),screenshotFileName=z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*\.png$/u),recordingFileName=z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*\.mp4$/u),key=z.string().regex(/^[A-Za-z0-9_.-]+$/u),browserUrl=z.string().url().refine(isHttpUrl,{message:`browser URL must use HTTP or HTTPS`}),button=z.enum([`left`,`middle`,`wheel`,`right`,`back`,`forward`]).default(`left`),modifierKeys=z.array(key).min(1).max(4).optional();function typeActionShape(e){return{action:z.literal(`type`),text:z.string().min(1).max(e),typingDelayMs:z.number().int().min(0).max(200).optional(),typingStyle:z.literal(`natural`).optional()}}const typingStyleRefinement=[e=>e.typingDelayMs===void 0||e.typingStyle===void 0,{message:`type action cannot set both typingDelayMs and typingStyle`}],sequenceTypeActionSchema=z.object(typeActionShape(2e3)).refine(...typingStyleRefinement),typeActionSchema=z.object(typeActionShape(1e4)).refine(...typingStyleRefinement),movementStyle=z.enum([`natural`,`precision`]).optional(),pointerDurationMs=z.number().int().min(0).max(2e3).optional().describe(`optional cursor travel duration for recorded demos; use about 600ms`),precisionMovementStyle=z.literal(`precision`).optional(),dragPoint=z.object({x:coordinate.max(1919),y:coordinate.max(1079)}),windowSelectorSchema=z.discriminatedUnion(`app`,[z.object({app:z.literal(`firefox`)}),z.object({app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`])})]),windowRegionSchema=z.object({x:z.number().min(0).max(1),y:z.number().min(0).max(1),width:z.number().positive().max(1),height:z.number().positive().max(1)}).refine(e=>e.x+e.width<=1&&e.y+e.height<=1,{message:`window region must fit within the desktop`}),arrangeWindowsSchema=z.object({action:z.literal(`arrange_windows`),windows:z.array(z.object({selector:windowSelectorSchema,region:windowRegionSchema})).min(1).max(4),waitForMs:z.number().int().min(0).max(1e4).optional().default(5e3)}),sequenceActionSchema=z.discriminatedUnion(`action`,[z.object({action:z.literal(`click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`double_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`triple_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`drag`),path:z.array(dragPoint).min(2).max(100),movementStyle:precisionMovementStyle,durationMs:pointerDurationMs}),z.object({action:z.literal(`keypress`),keys:z.array(key).min(1).max(4)}),z.object({action:z.literal(`move`),x:coordinate.max(1919),y:coordinate.max(1079),durationMs:pointerDurationMs,movementStyle}),sequenceTypeActionSchema,z.object({action:z.literal(`wait`),durationMs:z.number().int().min(100).max(1e4)}),arrangeWindowsSchema,z.object({action:z.literal(`record_start`),path:recordingFileName}),z.object({action:z.literal(`record_stop`)})]),driverResponseSchema=z.object({backend:z.literal(`cua-driver`),screenshot:z.string(),state:z.string(),action:z.unknown().optional(),version:z.literal(`0.12.5`)}).passthrough(),inputSchema=z.union([z.union([z.object({action:z.literal(`set_desktop_size`),size:z.enum([`full_hd`,`large_16_9`,`social_16_9`])}),z.object({action:z.literal(`launch`),app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`]).optional().default(`primary`)}),z.object({action:z.literal(`focus`),app:z.literal(`firefox`)}),z.object({action:z.literal(`focus`),app:z.literal(`xterm`),instance:z.enum([`primary`,`secondary`]).optional().default(`primary`)}),z.object({action:z.literal(`arrange_pair`),pair:z.enum([`terminal_browser`,`terminal_terminal`]),waitForMs:z.number().int().min(0).max(1e4).optional().default(5e3)}),arrangeWindowsSchema,z.object({action:z.literal(`window_layout`),app:z.literal(`desktop`),layout:z.enum([`maximized`,`left`,`right`])}),z.object({action:z.literal(`launch`),app:z.literal(`firefox`),url:browserUrl.optional()})]),z.discriminatedUnion(`action`,[z.object({action:z.literal(`screenshot`),path:screenshotFileName.optional()}),z.object({action:z.literal(`click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`double_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`triple_click`),x:coordinate.max(1919),y:coordinate.max(1079),button,keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`drag`),path:z.array(dragPoint).min(2).max(100),keys:modifierKeys,movementStyle:precisionMovementStyle,durationMs:pointerDurationMs}),z.object({action:z.literal(`keypress`),keys:z.array(key).min(1).max(4)}),z.object({action:z.literal(`move`),x:coordinate.max(1919),y:coordinate.max(1079),keys:modifierKeys,durationMs:pointerDurationMs,movementStyle}),z.object({action:z.literal(`scroll`),x:coordinate.max(1919),y:coordinate.max(1079),scroll_x:z.number().finite().min(-1e4).max(1e4),scroll_y:z.number().finite().min(-1e4).max(1e4),keys:modifierKeys}),typeActionSchema,z.object({action:z.literal(`clipboard_read`),selection:z.enum([`clipboard`,`primary`])}),z.object({action:z.literal(`clipboard_write`),selection:z.enum([`clipboard`,`primary`]),text:z.string().max(1e4)}),z.object({action:z.literal(`wait`),durationMs:z.number().int().min(100).max(1e4).optional().default(2e3)}),z.object({action:z.literal(`record_start`),path:recordingFileName.optional()}),z.object({action:z.literal(`record_stop`)}),z.object({action:z.literal(`sequence`),actions:z.array(sequenceActionSchema).min(1).max(30)})])]);var computer_use_default=defineTool({description:`Pass the selected action inside request, for example {request:{action:"screenshot"}}. Execute an OpenAI computer-use action against the isolated X11 desktop. Use set_desktop_size before launching managed windows to select full_hd (1920x1080), large_16_9 (1600x900), or social_16_9 (1280x720); smaller desktops make fixed-size UI and terminal text occupy more of the recording. Each action runs through Cua Driver and returns a fresh screenshot path plus the foreground application grounding window, pointer position, and bounded accessibility elements with screen coordinates. Actions execute without a human approval prompt. Use those coordinates for the next action. Use launch with app firefox and an optional HTTP(S) URL for the browser. Use launch with app xterm and instance primary or secondary for up to two managed terminals. Use focus to activate an existing app without changing its geometry. Use arrange_pair for common 50/50 terminal/browser or two-terminal layouts. Use arrange_windows for custom one-to-four-window scenes with proportional regions; it resolves every managed selector before moving any window, rejects overlap and unreadable geometry, waits boundedly for newly opened windows, and verifies the applied scene. Use window_layout with app desktop only for a single active window. Do not launch either application through a shell command. The action shape follows the OpenAI computer tool: screenshot, click, double_click, triple_click, drag, keypress, move, scroll, type, clipboard_read, clipboard_write, and wait, plus constrained layout, launch, and recording lifecycle actions. arrange_windows is available inside sequence for a deterministic mid-demo transition after an interaction opens Firefox. Use sequence for a rehearsed recording so up to 30 actions execute in one sandbox round trip with only one final screenshot. Pointer movement remains direct when movementStyle is omitted, preserving faithful exploratory and bug-repro interaction. For polished recordings, explicitly use movementStyle natural for confident curved moves/clicks and precision for drags; precision approaches the drag start naturally, pauses briefly around mouse-down, makes one subtle undershoot and exact correction while held, then pauses before mouse-up. Natural duration is distance-based and deliberately brisk; durationMs can override styled moves, clicks, and drags when exact timing matters. Recording actions return the sandbox path of the MP4 file; recordings stop automatically after five minutes. Requests have a two-minute deadline including queue time. Typing is limited to 10000 characters total per request; paced typing additionally allows at most 1000 graphemes and 30000ms of planned delay across the whole sequence. Omit typingStyle and typingDelayMs for longer text. Paced typing timings retain only the final driver result and grapheme count.`,inputSchema:z.object({request:inputSchema}),approval:never(),async execute({request:e},t){let n=await t.getSandbox();if(`keys`in e&&e.action!==`keypress`&&e.keys?.length)throw Error(`computer-use pointer action modifiers are not supported`);e.action===`sequence`&&validateSequenceBudget(e.actions),await ensureComputerUse(n,t.abortSignal);let r=e.action===`arrange_pair`?arrangePairAction(e.pair,e.waitForMs):e.action===`sequence`?{...e,actions:e.actions.map(e=>e.action===`record_start`?{...e,path:recordingPath(n,e.path)}:e)}:e.action===`record_start`?{...e,path:recordingPath(n,e.path??`recording-${crypto.randomUUID()}.mp4`)}:e.action===`scroll`?{...e,scrollX:e.scroll_x,scrollY:e.scroll_y}:e;if(r.action===`set_desktop_size`||r.action===`launch`||r.action===`focus`||r.action===`window_layout`){let i=await n.run({command:r.action===`set_desktop_size`?computerUseDesktopSizeCommand(n,r.size):r.action===`launch`?computerUseLaunchCommand(n,r):r.action===`focus`?computerUseFocusCommand(n,r.app,r.app===`xterm`?r.instance:void 0):computerUseWindowLayoutCommand(n,r.layout),signal:t.abortSignal});ensureSuccess(e.action,i)}let i=r.action===`screenshot`?screenshotPath(n,r.path):screenshotPath(n),a=r.action===`set_desktop_size`||r.action===`launch`||r.action===`focus`||r.action===`window_layout`?{action:`screenshot`}:r,o=await callComputerUseDriver(n,computerUseDriverRequest(a,i),t.abortSignal);if(o.screenshot!==i)throw Error(`computer-use driver returned an unexpected screenshot path`);let s={action:e.action,backend:o.backend,path:r.action===`screenshot`?i:r.action===`record_start`?r.path:r.action===`sequence`?r.actions.find(e=>e.action===`record_start`)?.path??null:null,screenshot:i,state:o.state,version:o.version};return(e.action===`clipboard_read`||e.action===`clipboard_write`)&&(s.result=o.action),r.action===`sequence`&&(s.timings=o.action),s}});async function callComputerUseDriver(e,t,n){let r=await e.run({command:computerUseDriverCommand(e),env:{COMPUTER_USE_REQUEST:JSON.stringify(t),COMPUTER_USE_SOCKET_PATH:computerUsePaths(e).driverSocket},signal:n});ensureSuccess(t.action.action,r);try{return driverResponseSchema.parse(JSON.parse(r.stdout))}catch(e){throw Error(`computer-use driver returned an invalid response`,{cause:e})}}function arrangePairAction(e,t){return{action:`arrange_windows`,waitForMs:t,windows:[{selector:e===`terminal_browser`?{app:`firefox`}:{app:`xterm`,instance:`primary`},region:{x:0,y:0,width:.5,height:1}},{selector:e===`terminal_browser`?{app:`xterm`,instance:`primary`}:{app:`xterm`,instance:`secondary`},region:{x:.5,y:0,width:.5,height:1}}]}}function validateSequenceBudget(e){let t=e.reduce((e,t)=>e+(t.action===`type`?t.text.length:0),0),n=e.flatMap((e,t)=>e.action===`record_start`?[t]:[]),r=e.flatMap((e,t)=>e.action===`record_stop`?[t]:[]),i=n.length,a=r.length;if(t>1e4)throw Error(`computer-use sequence may type at most 10000 characters`);if(i>1||a>1)throw Error(`computer-use sequence may record at most one take`);if(i===0!=(a===0))throw Error(`computer-use recording sequence requires one start and one stop`);if(i===1&&(n[0]!==0||r[0]!==e.length-1))throw Error(`computer-use recording sequence must start first and stop last`)}function ensureSuccess(e,t){if(t.exitCode!==0)throw Error(`computer ${e} failed (exit ${t.exitCode}): ${t.stderr}`)}function isHttpUrl(e){if(!URL.canParse(e))return!1;let t=new URL(e).protocol;return t===`http:`||t===`https:`}export{computer_use_default as default};

package/dist/src/connections/errors.d.ts

@@ -59,7 +59,7 @@ export interface ConnectionAuthorizationFailedErrorOptions {
     /**
      * Stable machine-readable code describing why authorization failed.
      *
-     * The runtime surfaces this code on the `authorization.completed`
+     * The runtime surfaces this code on the sign-in `interaction.settled`
      * stream event and on the failed tool result the model sees. Use a
      * short kebab- or snake-cased string (e.g. `"access_denied"`,
      * `"invalid_grant"`).
@@ -87,9 +87,9 @@ export interface ConnectionAuthorizationFailedErrorOptions {
  * Thrown from a connection's `getToken` when no valid credential is
  * available and authorization must be completed before the connection
  * can be used. Covers both interactive OAuth (the runtime emits
- * `authorization.required` and suspends the turn on a webhook) and
+ * sign-in `interaction.opened` and suspends the turn on a webhook) and
  * non-interactive / out-of-band flows such as static API keys (the
- * runtime emits `authorization.required` without suspending).
+ * runtime emits sign-in `interaction.opened` without suspending).
  */
 export declare class ConnectionAuthorizationRequiredError extends Error {
     readonly connectionName: string;

package/dist/src/context/accessors.d.ts

@@ -6,19 +6,6 @@ export type { Session, SessionAuth, SessionAuthContext, SessionParent, SessionPr
  * @throws When called outside of a managed step execution.
  */
 export declare function getContext<T>(key: ContextKey<T>): T | undefined;
-/**
- * Returns the current value of a context key, throwing when unset.
- *
- * @throws When the key is not set or when called outside of a managed
- *   step execution.
- */
-export declare function requireContext<T>(key: ContextKey<T>): T;
-/**
- * Returns whether the key is currently set in the active context.
- *
- * @throws When called outside of a managed step execution.
- */
-export declare function hasContext<T>(key: ContextKey<T>): boolean;
 /**
  * Sets the durable value of a context key in the active context.
  *

package/dist/src/context/accessors.js

@@ -1 +1 @@
-import{loadContext}from"#context/container.js";function getContext(e){return loadContext().get(e)}function requireContext(e){return loadContext().require(e)}function hasContext(e){return loadContext().has(e)}function setContext(e,t){return loadContext().set(e,t)}function ensureContext(e,t){return loadContext().ensure(e,t)}export{ensureContext,getContext,hasContext,requireContext,setContext};
+import{loadContext}from"#context/container.js";function getContext(e){return loadContext().get(e)}function setContext(e,t){return loadContext().set(e,t)}function ensureContext(e,t){return loadContext().ensure(e,t)}export{ensureContext,getContext,setContext};

package/dist/src/context/container.d.ts

@@ -1,4 +1,3 @@
-import { AsyncLocalStorage } from "node:async_hooks";
 import { type ContextAccessor, type ContextKey } from "#context/key.js";
 import { type LocalDevRequestProvenance } from "#context/keys.js";
 /**
@@ -56,16 +55,14 @@ export declare class ContextContainer implements AlsContext {
     setVirtualContext<T>(key: ContextKey<T>, value: T): void;
     entries(): Generator<readonly [ContextKey<unknown>, unknown]>;
 }
-/**
- * Process-wide AsyncLocalStorage used by every eve module copy in the current
- * runtime.
- *
- * Nitro step bundles can inline parts of eve while authored modules still
- * import `eve/*` from disk. Backing the storage with a global
- * symbol keeps those copies on the same ALS instance so authored tools,
- * model callbacks, and step code observe one unified eve context.
- */
-export declare const contextStorage: AsyncLocalStorage<AlsContext>;
+export declare const contextStorage: {
+    getStore: () => AlsContext | undefined;
+    run: <T>(context: AlsContext, fn: () => T) => T;
+};
+/** Reads branch-local metadata without changing the identity of the active context. */
+export declare function contextScopeValue<T>(key: symbol): T | undefined;
+/** Runs one async branch with metadata on the existing context storage, not another ALS. */
+export declare function withContextScopeValue<T>(key: symbol, value: unknown, fn: () => T): T;
 /**
  * Returns the active context, throwing when called outside a managed scope.
  */

package/dist/src/context/container.js

@@ -1 +1 @@
-import{LocalDevRequestKey}from"#context/keys.js";import{AsyncLocalStorage}from"node:async_hooks";import{resolveKey}from"#context/key.js";const EVE_CONTEXT_STORAGE_KEY=Symbol.for(`eve.context-storage`);var ContextContainer=class{_durableValues=new Map;_virtualValues=new Map;constructor(e){let t=e!==void 0&&Object.hasOwn(e,`localDevRequest`)?e.localDevRequest:contextStorage.getStore()?.localDevRequest;t!==void 0&&this._durableValues.set(LocalDevRequestKey.name,t)}get localDevRequest(){return this.get(LocalDevRequestKey)}get(e){return this._virtualValues.has(e.name)?this._virtualValues.get(e.name):this._durableValues.get(e.name)}require(e){if(!this.has(e))throw Error(`Context key "${e.name}" is not set.`);return this.get(e)}has(e){return this._virtualValues.has(e.name)||this._durableValues.has(e.name)}set(e,t){let n=typeof t==`function`?t(this.get(e)):t;return this._durableValues.set(e.name,n),n}ensure(e,t){return this.has(e)?this.require(e):this.set(e,t())}delete(e){let t=this._durableValues.delete(e.name),n=this._virtualValues.delete(e.name);return t||n}clearVirtualContext(){this._virtualValues.clear()}setVirtualContext(e,t){this._virtualValues.set(e.name,t)}*entries(){for(let[e,t]of this._durableValues){let n=resolveKey(e);n!==void 0&&(yield[n,t])}}};const globalContextStorage=globalThis;globalContextStorage[EVE_CONTEXT_STORAGE_KEY]===void 0&&(globalContextStorage[EVE_CONTEXT_STORAGE_KEY]=new AsyncLocalStorage);const contextStorage=globalContextStorage[EVE_CONTEXT_STORAGE_KEY];function loadContext(){let e=contextStorage.getStore();if(e===void 0)throw Error(`No active eve context. Call this function only from authored runtime code such as tools, steps, and model callbacks.`);return e}export{ContextContainer,contextStorage,loadContext};
+import{LocalDevRequestKey}from"#context/keys.js";import{AsyncLocalStorage}from"node:async_hooks";import{resolveKey}from"#context/key.js";const EVE_CONTEXT_STORAGE_KEY=Symbol.for(`eve.context-storage`);var ContextContainer=class{_durableValues=new Map;_virtualValues=new Map;constructor(e){let t=e!==void 0&&Object.hasOwn(e,`localDevRequest`)?e.localDevRequest:contextStorage.getStore()?.localDevRequest;t!==void 0&&this._durableValues.set(LocalDevRequestKey.name,t)}get localDevRequest(){return this.get(LocalDevRequestKey)}get(e){return this._virtualValues.has(e.name)?this._virtualValues.get(e.name):this._durableValues.get(e.name)}require(e){if(!this.has(e))throw Error(`Context key "${e.name}" is not set.`);return this.get(e)}has(e){return this._virtualValues.has(e.name)||this._durableValues.has(e.name)}set(e,t){let n=typeof t==`function`?t(this.get(e)):t;return this._durableValues.set(e.name,n),n}ensure(e,t){return this.has(e)?this.require(e):this.set(e,t())}delete(e){let t=this._durableValues.delete(e.name),n=this._virtualValues.delete(e.name);return t||n}clearVirtualContext(){this._virtualValues.clear()}setVirtualContext(e,t){this._virtualValues.set(e.name,t)}*entries(){for(let[e,t]of this._durableValues){let n=resolveKey(e);n!==void 0&&(yield[n,t])}}};const globalContextStorage=globalThis;globalContextStorage[EVE_CONTEXT_STORAGE_KEY]===void 0&&(globalContextStorage[EVE_CONTEXT_STORAGE_KEY]=new AsyncLocalStorage);const storage=globalContextStorage[EVE_CONTEXT_STORAGE_KEY],contextStorage={getStore:()=>storage.getStore()?.context,run:(e,t)=>storage.run({context:e},t)};function contextScopeValue(e){return storage.getStore()?.values?.get(e)}function withContextScopeValue(e,t,n){let r=storage.getStore(),i=new Map(r?.values);return i.set(e,t),storage.run({context:r?.context,values:i},n)}function loadContext(){let e=contextStorage.getStore();if(e===void 0)throw Error(`No active eve context. Call this function only from authored runtime code such as tools, steps, and model callbacks.`);return e}export{ContextContainer,contextScopeValue,contextStorage,loadContext,withContextScopeValue};

package/dist/src/context/key-names.d.ts

@@ -11,3 +11,4 @@
 export declare const BUNDLE_CONTEXT_KEY_NAME = "eve.bundle";
 export declare const CHANNEL_CONTEXT_KEY_NAME = "eve.channel";
 export declare const SESSION_CALLBACK_CONTEXT_KEY_NAME = "eve.sessionCallback";
+export declare const EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME = "eve.earlierRemoteCaller";

package/dist/src/context/key-names.js

@@ -1 +1 @@
-const BUNDLE_CONTEXT_KEY_NAME=`eve.bundle`,CHANNEL_CONTEXT_KEY_NAME=`eve.channel`,SESSION_CALLBACK_CONTEXT_KEY_NAME=`eve.sessionCallback`;export{BUNDLE_CONTEXT_KEY_NAME,CHANNEL_CONTEXT_KEY_NAME,SESSION_CALLBACK_CONTEXT_KEY_NAME};
+const BUNDLE_CONTEXT_KEY_NAME=`eve.bundle`,CHANNEL_CONTEXT_KEY_NAME=`eve.channel`,SESSION_CALLBACK_CONTEXT_KEY_NAME=`eve.sessionCallback`,EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME=`eve.earlierRemoteCaller`;export{BUNDLE_CONTEXT_KEY_NAME,CHANNEL_CONTEXT_KEY_NAME,EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME,SESSION_CALLBACK_CONTEXT_KEY_NAME};

package/dist/src/context/keys.d.ts

@@ -3,27 +3,22 @@
  * tier. Codec-carrying keys (`ChannelKey`, `BundleKey`) live in
  * `#runtime/sessions/runtime-context-keys.ts`.
  */
-import type { LanguageModel, ModelMessage, SystemModelMessage } from "ai";
-import type { ChannelDeliveryMetadata, ChannelInstrumentationProjection, SessionAuthContext, SessionCallback, SessionCapabilities, SessionParent, SessionTraceContext, SessionTraceRoot, SessionTurn } from "#channel/types.js";
+import type { LanguageModel } from "ai";
+import type { AgentSessionRuntimeOverrides } from "#execution/agent-sessions/runtime-overrides.js";
+import type { ChannelDeliveryMetadata, ChannelInstrumentationProjection, SessionAuthContext, SessionCallback, SessionCapabilities, SessionParent, SessionTraceSeed, SessionTraceRoot, SessionTurn } from "#channel/types.js";
 import { ContextKey } from "#context/key.js";
 import { type StubScope } from "#tool-stubs/types.js";
 import { type SessionInboxAddress } from "#execution/session-inbox/address.js";
-import type { LegacyRemoteAgentCaller } from "#execution/legacy-remote-agent/protocol.js";
-import type { InstrumentationChannelDeliveryRef } from "#instrumentation/lifecycle.js";
-import type { UserModelMessage } from "#harness/messages.js";
 import type { HandleEventFn } from "#harness/types.js";
-import type { PersistedDynamicToolMetadata } from "#context/dynamic-tool-metadata.js";
-import type { AgentSessionRuntimeOverrides } from "#execution/agent-sessions/runtime-overrides.js";
 import type { DynamicSubagentAgentConfig } from "#runtime/subagents/dynamic-agent-config.js";
 import type { DynamicRemoteAgentConfig } from "#runtime/subagents/dynamic-remote-agent-config.js";
+import type { DynamicRemoteBinding } from "#reactions/remote.js";
 import type { SandboxAccess, SandboxSessionEndReason } from "#sandbox/state.js";
-import type { HistoryViewProjector } from "#shared/history-view.js";
 import type { RuntimeModelReference } from "#runtime/agent/bootstrap.js";
 import type { PreparedRuntimeDelegationTool } from "#runtime/sessions/turn.js";
-import type { MemoryScope, MemoryTurnContext } from "#public/memory/index.js";
-import type { SessionPredecessor } from "#protocol/message.js";
+import type { SessionPredecessor } from "#protocol/session-events/families/session.js";
 export type { SessionAuthContext, SessionParent, SessionTraceRoot, SessionTurn, } from "#channel/types.js";
-export type { SessionPredecessor } from "#protocol/message.js";
+export type { SessionPredecessor } from "#protocol/session-events/families/session.js";
 /**
  * Auth metadata on the active session.
  *
@@ -100,18 +95,6 @@ export interface OfferedCatalogTools {
     readonly tools: boolean;
 }
 export declare const OfferedCatalogToolsKey: ContextKey<OfferedCatalogTools>;
-export interface ActiveChannelDelivery {
-    readonly traceSessionId: string;
-    readonly agentName?: string;
-    readonly channelType?: string;
-    readonly delivery: InstrumentationChannelDeliveryRef;
-    readonly policyAgentName?: string;
-    readonly rootSessionId: string;
-    readonly sequence: number;
-    readonly sessionId: string;
-    readonly turnId: string;
-}
-export declare const ActiveChannelDeliveriesKey: ContextKey<readonly ActiveChannelDelivery[]>;
 export declare const ChannelInstrumentationKey: ContextKey<ChannelInstrumentationProjection>;
 export declare const ParentSessionKey: ContextKey<SessionParent>;
 /** Set only on a session eve started in place of one that could no longer run. */
@@ -119,9 +102,9 @@ export declare const SessionPredecessorKey: ContextKey<SessionPredecessor>;
 /** Set only when the trace root differs from `ParentSessionKey`'s root; see {@link SessionTraceRoot}. */
 export declare const TraceRootKey: ContextKey<SessionTraceRoot>;
 /** Separate from {@link ParentSessionKey} so it stays out of what extensions read. */
-export declare const ParentTraceContextKey: ContextKey<SessionTraceContext>;
-export type SessionTraceSeed = SessionTraceContext;
-export declare const SessionTraceSeedKey: ContextKey<SessionTraceContext>;
+export declare const ParentTraceContextKey: ContextKey<SessionTraceSeed>;
+export type { SessionTraceSeed } from "#channel/types.js";
+export declare const SessionTraceSeedKey: ContextKey<SessionTraceSeed>;
 export declare const OtelTraceEnabledKey: ContextKey<boolean>;
 /**
  * Session-level capability flags (see {@link SessionCapabilities}). Set
@@ -133,8 +116,11 @@ export declare const CapabilitiesKey: ContextKey<SessionCapabilities>;
  * Optional framework-owned caller callback captured when the session is created.
  */
 export declare const SessionCallbackKey: ContextKey<SessionCallback>;
-/** Present when a remote agent protocol 1 caller created the session. */
-export declare const LegacyRemoteAgentCallerKey: ContextKey<LegacyRemoteAgentCaller>;
+/**
+ * The remote agent protocol of a {@link SessionCallbackKey} caller that speaks an earlier one. That
+ * caller gets the session's result, but the session relays none of its requests to it.
+ */
+export declare const EarlierRemoteCallerKey: ContextKey<number>;
 export declare const SessionKey: ContextKey<Session>;
 export declare const SandboxKey: ContextKey<SandboxAccess>;
 export declare const SandboxTerminalCleanupKey: ContextKey<(reason: SandboxSessionEndReason) => Promise<void>>;
@@ -143,71 +129,11 @@ export declare const HandleEventKey: ContextKey<HandleEventFn>;
 export declare const StaticModelReferenceKey: ContextKey<Readonly<import("../shared/agent-definition.ts").InternalAgentModelDefinition & {
     reasoning?: import("../index.ts").AgentReasoningDefinition;
 }> | null>;
-/** Session-scoped dynamic model selection (from `session.started`). */
-export declare const SessionDynamicModelReferenceKey: ContextKey<Readonly<import("../shared/agent-definition.ts").InternalAgentModelDefinition & {
-    reasoning?: import("../index.ts").AgentReasoningDefinition;
-}> | null>;
-/** Turn-scoped dynamic model selection (from `turn.started`). */
-export declare const TurnDynamicModelReferenceKey: ContextKey<Readonly<import("../shared/agent-definition.ts").InternalAgentModelDefinition & {
-    reasoning?: import("../index.ts").AgentReasoningDefinition;
-}> | null>;
-export interface CachedModelMetadata {
-    readonly contextWindowTokens: number;
-    readonly expiresAt: number;
-    readonly maxOutputTokens?: number;
-    readonly resolvedModelId: string;
-}
-/** Successful runtime catalog selections cached in durable workflow state. */
-export declare const RuntimeModelMetadataCacheKey: ContextKey<Readonly<Record<string, CachedModelMetadata>>>;
 export interface LiveDynamicModelSelection {
     /** Live provider instance; absent for string selections, which resolve through the reference. */
     readonly model?: LanguageModel;
     readonly reference: RuntimeModelReference;
 }
-/** Virtual step-scoped dynamic model selection (from `step.started`); never serialized. */
-export declare const LiveStepDynamicModelSelectionKey: ContextKey<LiveDynamicModelSelection | null>;
-/**
- * Session-scoped dynamic tool metadata (from `session.started`).
- * Persists for the session lifetime.
- */
-export declare const SessionDynamicToolMetadataKey: ContextKey<readonly PersistedDynamicToolMetadata[]>;
-/**
- * Runtime revision that last resolved session-scoped dynamic tools.
- * Used to refresh their durable metadata after a deploy or development rebuild.
- */
-export declare const SessionDynamicToolRuntimeRevisionKey: ContextKey<string>;
-/**
- * Turn-scoped dynamic tool metadata (from `turn.started`).
- * Replaced each turn.
- */
-export declare const TurnDynamicToolMetadataKey: ContextKey<readonly PersistedDynamicToolMetadata[]>;
-export interface LockedMemorySlot {
-    readonly scope: MemoryScope;
-    readonly slot: string;
-    readonly turn: MemoryTurnContext;
-    readonly visibility: "scope" | "session";
-}
-export declare const TurnMemoryLocksKey: ContextKey<Readonly<Record<string, LockedMemorySlot>>>;
-export interface PreparedMemoryPreamble {
-    readonly projector?: HistoryViewProjector;
-    readonly history: readonly ModelMessage[];
-    readonly input: readonly ModelMessage[];
-    readonly state?: Readonly<Record<string, unknown>>;
-}
-export interface PendingMemoryCommit {
-    /** Records recalled by this operation, to append after the prepared history. */
-    readonly recalledMessages: readonly ModelMessage[];
-    readonly state: Readonly<Record<string, unknown>>;
-}
-export declare const PreparedMemoryPreambleKey: ContextKey<PreparedMemoryPreamble>;
-export declare const PendingMemoryCommitKey: ContextKey<PendingMemoryCommit>;
-export interface PreparedMemoryCompaction {
-    readonly history: readonly ModelMessage[];
-    readonly state?: Readonly<Record<string, unknown>>;
-}
-export declare const PreparedMemoryCompactionKey: ContextKey<PreparedMemoryCompaction>;
-/** Step-scoped dynamic tool metadata, replaced before each model step. */
-export declare const StepDynamicToolMetadataKey: ContextKey<readonly PersistedDynamicToolMetadata[]>;
 export type DurableDynamicSubagentSelection = {
     readonly agentConfig: DynamicSubagentAgentConfig;
     readonly kind: "subagent";
@@ -218,10 +144,12 @@ export type DurableDynamicSubagentSelection = {
     readonly kind: "remote";
     readonly prepared: PreparedRuntimeDelegationTool;
     readonly remoteAgent: DynamicRemoteAgentConfig;
+    /**
+     * The binding a child opened now keeps, when the remote agent carries credentials: the steps
+     * that reach the child build them again from it.
+     */
+    readonly binding?: DynamicRemoteBinding;
 } | null;
-export declare const SessionDynamicSubagentSelectionsKey: ContextKey<Readonly<Record<string, DurableDynamicSubagentSelection>>>;
-export declare const TurnDynamicSubagentSelectionsKey: ContextKey<Readonly<Record<string, DurableDynamicSubagentSelection>>>;
-export declare const SessionDynamicSubagentRuntimeRevisionKey: ContextKey<string>;
 export declare const DynamicSubagentAgentConfigKey: ContextKey<DynamicSubagentAgentConfig>;
 export declare const AgentSessionRuntimeOverridesKey: ContextKey<AgentSessionRuntimeOverrides>;
 /**
@@ -232,7 +160,7 @@ export interface DurableDynamicSkillMetadata {
     /** Listed in the catalog instead of the dynamic skill announcement. */
     readonly deferred?: true;
     readonly description: string;
-    /** `SKILL.md` content as authored; loading strips any frontmatter. */
+    /** Checkpoint storage keeps `markdown`; the authoring API uses `content`. */
     readonly markdown: string;
     /**
      * Content hash of the package files. Present only for packages with
@@ -241,29 +169,9 @@ export interface DurableDynamicSkillMetadata {
     readonly revision?: string;
 }
 export type DynamicSkillManifest = Readonly<Record<string, readonly DurableDynamicSkillMetadata[]>>;
-/**
- * Durable map from resolver slug to the qualified skills it last produced.
- * Used to diff on re-resolution, load skills, and rebuild the model-visible
- * announcement across turns without a sandbox.
- */
-export declare const DynamicSkillManifestKey: ContextKey<Readonly<Record<string, readonly DurableDynamicSkillMetadata[]>>>;
 /**
  * Durable map from dynamic skill name to the serialized sandbox session state
  * that holds its current manifest revision. Refreshes skip writes when the
  * revision and sandbox are unchanged; deleting the sandbox clears it.
  */
 export declare const DynamicSkillSandboxKey: ContextKey<Readonly<Record<string, string>>>;
-/**
- * Durable session-scoped instruction messages (from `session.started`
- * resolvers). Keyed by resolver slug. Persists for the session lifetime.
- */
-export declare const SessionDynamicInstructionsKey: ContextKey<Record<string, readonly SystemModelMessage[]>>;
-/**
- * Durable turn-scoped instruction messages (from `turn.started`
- * resolvers). Keyed by resolver slug. Replaced each turn.
- */
-export declare const TurnDynamicInstructionsKey: ContextKey<Record<string, readonly SystemModelMessage[]>>;
-/** Existing history exposed only to instructions resolvers during a preamble. */
-export declare const DynamicInstructionResolveMessagesKey: ContextKey<readonly ModelMessage[]>;
-/** User-role results waiting to be committed immediately after a preamble. */
-export declare const PendingDynamicInstructionUserMessagesKey: ContextKey<readonly UserModelMessage[]>;

package/dist/src/context/keys.js

@@ -1 +1 @@
-import{SESSION_INBOX_CONTEXT_KEY}from"#execution/session-inbox/address.js";import{ContextKey}from"#context/key.js";import{STUB_CONTEXT_KEY}from"#tool-stubs/types.js";import{SESSION_CALLBACK_CONTEXT_KEY_NAME}from"#context/key-names.js";const AuthKey=new ContextKey(`eve.auth`),ToolStubsKey=new ContextKey(STUB_CONTEXT_KEY),InitiatorAuthKey=new ContextKey(`eve.initiatorAuth`),SessionIdKey=new ContextKey(`eve.sessionId`),ConversationIdKey=new ContextKey(`eve.conversationId`),SessionInboxKey=new ContextKey(SESSION_INBOX_CONTEXT_KEY),ContinuationTokenKey=new ContextKey(`eve.continuationToken`),ContinuationHookTokensKey=new ContextKey(`eve.continuationHookTokens`),ChannelRequestIdKey=new ContextKey(`eve.channelRequestId`),LocalDevRequestKey=new ContextKey(`eve.internal.localDevRequest`),OccurrenceIdKey=new ContextKey(`eve.scheduleOccurrenceId`),ScheduleIdKey=new ContextKey(`eve.scheduleId`),ScheduleInstanceKey=new ContextKey(`eve.scheduleInstance`),SessionTitleKey=new ContextKey(`eve.sessionTitle`),ChannelDeliveryKey=new ContextKey(`eve.channelDelivery`),TurnDeliveryIdsKey=new ContextKey(`eve.turnDeliveryIds`),HistoryStateKey=new ContextKey(`eve.historyState`),OfferedCatalogToolsKey=new ContextKey(`eve.offeredCatalogTools`),ActiveChannelDeliveriesKey=new ContextKey(`eve.activeChannelDeliveries`),ChannelInstrumentationKey=new ContextKey(`eve.channelInstrumentation`),ParentSessionKey=new ContextKey(`eve.parentSession`),SessionPredecessorKey=new ContextKey(`eve.sessionPredecessor`),TraceRootKey=new ContextKey(`eve.traceRoot`),ParentTraceContextKey=new ContextKey(`eve.parentTraceContext`),SessionTraceSeedKey=new ContextKey(`eve.sessionTraceSeed`),OtelTraceEnabledKey=new ContextKey(`eve.otelTraceEnabled`),CapabilitiesKey=new ContextKey(`eve.capabilities`),SessionCallbackKey=new ContextKey(SESSION_CALLBACK_CONTEXT_KEY_NAME),LegacyRemoteAgentCallerKey=new ContextKey(`eve.legacyRemoteAgentCaller`),SessionKey=new ContextKey(`eve.session`),SandboxKey=new ContextKey(`eve.sandbox`),SandboxTerminalCleanupKey=new ContextKey(`eve.internal.sandboxTerminalCleanup`),HandleEventKey=new ContextKey(`eve.internal.handleEvent`),StaticModelReferenceKey=new ContextKey(`eve.staticModelReference`),SessionDynamicModelReferenceKey=new ContextKey(`eve.sessionDynamicModelReference`),TurnDynamicModelReferenceKey=new ContextKey(`eve.turnDynamicModelReference`),RuntimeModelMetadataCacheKey=new ContextKey(`eve.runtimeModelMetadataCache`),LiveStepDynamicModelSelectionKey=new ContextKey(`eve.liveStepDynamicModelSelection`),SessionDynamicToolMetadataKey=new ContextKey(`eve.sessionDynamicToolMetadata`),SessionDynamicToolRuntimeRevisionKey=new ContextKey(`eve.sessionDynamicToolRuntimeRevision`),TurnDynamicToolMetadataKey=new ContextKey(`eve.turnDynamicToolMetadata`),TurnMemoryLocksKey=new ContextKey(`eve.memory.turnLocks`),PreparedMemoryPreambleKey=new ContextKey(`eve.memory.preparedPreamble`),PendingMemoryCommitKey=new ContextKey(`eve.memory.pendingCommit`),PreparedMemoryCompactionKey=new ContextKey(`eve.memory.preparedCompaction`),StepDynamicToolMetadataKey=new ContextKey(`eve.stepDynamicToolMetadata`),SessionDynamicSubagentSelectionsKey=new ContextKey(`eve.sessionDynamicSubagentSelections`),TurnDynamicSubagentSelectionsKey=new ContextKey(`eve.turnDynamicSubagentSelections`),SessionDynamicSubagentRuntimeRevisionKey=new ContextKey(`eve.sessionDynamicSubagentRuntimeRevision`),DynamicSubagentAgentConfigKey=new ContextKey(`eve.dynamicSubagentAgentConfig`),AgentSessionRuntimeOverridesKey=new ContextKey(`eve.agentSessionRuntimeOverrides`),DynamicSkillManifestKey=new ContextKey(`eve.dynamicSkillManifest`),DynamicSkillSandboxKey=new ContextKey(`eve.dynamicSkillSandbox`),SessionDynamicInstructionsKey=new ContextKey(`eve.sessionDynamicInstructions`),TurnDynamicInstructionsKey=new ContextKey(`eve.turnDynamicInstructions`),DynamicInstructionResolveMessagesKey=new ContextKey(`eve.dynamicInstructionResolveMessages`),PendingDynamicInstructionUserMessagesKey=new ContextKey(`eve.pendingDynamicInstructionUserMessages`);export{ActiveChannelDeliveriesKey,AgentSessionRuntimeOverridesKey,AuthKey,CapabilitiesKey,ChannelDeliveryKey,ChannelInstrumentationKey,ChannelRequestIdKey,ContinuationHookTokensKey,ContinuationTokenKey,ConversationIdKey,DynamicInstructionResolveMessagesKey,DynamicSkillManifestKey,DynamicSkillSandboxKey,DynamicSubagentAgentConfigKey,HandleEventKey,HistoryStateKey,InitiatorAuthKey,LegacyRemoteAgentCallerKey,LiveStepDynamicModelSelectionKey,LocalDevRequestKey,OccurrenceIdKey,OfferedCatalogToolsKey,OtelTraceEnabledKey,ParentSessionKey,ParentTraceContextKey,PendingDynamicInstructionUserMessagesKey,PendingMemoryCommitKey,PreparedMemoryCompactionKey,PreparedMemoryPreambleKey,RuntimeModelMetadataCacheKey,SandboxKey,SandboxTerminalCleanupKey,ScheduleIdKey,ScheduleInstanceKey,SessionCallbackKey,SessionDynamicInstructionsKey,SessionDynamicModelReferenceKey,SessionDynamicSubagentRuntimeRevisionKey,SessionDynamicSubagentSelectionsKey,SessionDynamicToolMetadataKey,SessionDynamicToolRuntimeRevisionKey,SessionIdKey,SessionInboxKey,SessionKey,SessionPredecessorKey,SessionTitleKey,SessionTraceSeedKey,StaticModelReferenceKey,StepDynamicToolMetadataKey,ToolStubsKey,TraceRootKey,TurnDeliveryIdsKey,TurnDynamicInstructionsKey,TurnDynamicModelReferenceKey,TurnDynamicSubagentSelectionsKey,TurnDynamicToolMetadataKey,TurnMemoryLocksKey};
+import{SESSION_INBOX_CONTEXT_KEY}from"#execution/session-inbox/address.js";import{ContextKey}from"#context/key.js";import{STUB_CONTEXT_KEY}from"#tool-stubs/types.js";import{EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME,SESSION_CALLBACK_CONTEXT_KEY_NAME}from"#context/key-names.js";const AuthKey=new ContextKey(`eve.auth`),ToolStubsKey=new ContextKey(STUB_CONTEXT_KEY),InitiatorAuthKey=new ContextKey(`eve.initiatorAuth`),SessionIdKey=new ContextKey(`eve.sessionId`),ConversationIdKey=new ContextKey(`eve.conversationId`),SessionInboxKey=new ContextKey(SESSION_INBOX_CONTEXT_KEY),ContinuationTokenKey=new ContextKey(`eve.continuationToken`),ContinuationHookTokensKey=new ContextKey(`eve.continuationHookTokens`),ChannelRequestIdKey=new ContextKey(`eve.channelRequestId`),LocalDevRequestKey=new ContextKey(`eve.internal.localDevRequest`),OccurrenceIdKey=new ContextKey(`eve.scheduleOccurrenceId`),ScheduleIdKey=new ContextKey(`eve.scheduleId`),ScheduleInstanceKey=new ContextKey(`eve.scheduleInstance`),SessionTitleKey=new ContextKey(`eve.sessionTitle`),ChannelDeliveryKey=new ContextKey(`eve.channelDelivery`),TurnDeliveryIdsKey=new ContextKey(`eve.turnDeliveryIds`),HistoryStateKey=new ContextKey(`eve.historyState`),OfferedCatalogToolsKey=new ContextKey(`eve.offeredCatalogTools`),ChannelInstrumentationKey=new ContextKey(`eve.channelInstrumentation`),ParentSessionKey=new ContextKey(`eve.parentSession`),SessionPredecessorKey=new ContextKey(`eve.sessionPredecessor`),TraceRootKey=new ContextKey(`eve.traceRoot`),ParentTraceContextKey=new ContextKey(`eve.parentTraceContext`),SessionTraceSeedKey=new ContextKey(`eve.sessionTraceSeed`),OtelTraceEnabledKey=new ContextKey(`eve.otelTraceEnabled`),CapabilitiesKey=new ContextKey(`eve.capabilities`),SessionCallbackKey=new ContextKey(SESSION_CALLBACK_CONTEXT_KEY_NAME),EarlierRemoteCallerKey=new ContextKey(EARLIER_REMOTE_CALLER_CONTEXT_KEY_NAME),SessionKey=new ContextKey(`eve.session`),SandboxKey=new ContextKey(`eve.sandbox`),SandboxTerminalCleanupKey=new ContextKey(`eve.internal.sandboxTerminalCleanup`),HandleEventKey=new ContextKey(`eve.internal.handleEvent`),StaticModelReferenceKey=new ContextKey(`eve.staticModelReference`),DynamicSubagentAgentConfigKey=new ContextKey(`eve.dynamicSubagentAgentConfig`),AgentSessionRuntimeOverridesKey=new ContextKey(`eve.agentSessionRuntimeOverrides`),DynamicSkillSandboxKey=new ContextKey(`eve.dynamicSkillSandbox`);export{AgentSessionRuntimeOverridesKey,AuthKey,CapabilitiesKey,ChannelDeliveryKey,ChannelInstrumentationKey,ChannelRequestIdKey,ContinuationHookTokensKey,ContinuationTokenKey,ConversationIdKey,DynamicSkillSandboxKey,DynamicSubagentAgentConfigKey,EarlierRemoteCallerKey,HandleEventKey,HistoryStateKey,InitiatorAuthKey,LocalDevRequestKey,OccurrenceIdKey,OfferedCatalogToolsKey,OtelTraceEnabledKey,ParentSessionKey,ParentTraceContextKey,SandboxKey,SandboxTerminalCleanupKey,ScheduleIdKey,ScheduleInstanceKey,SessionCallbackKey,SessionIdKey,SessionInboxKey,SessionKey,SessionPredecessorKey,SessionTitleKey,SessionTraceSeedKey,StaticModelReferenceKey,ToolStubsKey,TraceRootKey,TurnDeliveryIdsKey};

package/dist/src/context/memory-tools.d.ts

@@ -1,11 +1,13 @@
 import type { MemoryDefinition } from "#public/memory/index.js";
+import type { InternalContext } from "#reactions/reaction.js";
+/** A memory slot's provider tools, as a dynamic tool resolver named `<slot>__<key>`. */
 export declare function createMemoryToolDynamicDefinition(definition: MemoryDefinition, slot: string): import("#dynamic/definition.js").DynamicSentinel<{
     [k: string]: {
-        approval?: import("#approval/definition.js").Approval<never>;
+        approval?: import("../approval/definition.ts").Approval<never>;
         execute(input: never, context: import("../tools/definition.ts").ToolContext): unknown | Promise<unknown> | AsyncIterable<unknown>;
         inputSchema: unknown;
         outputSchema?: unknown;
         toModelOutput?: (output: never) => import("../tools/model-output.ts").ToolModelOutput | Promise<import("../tools/model-output.ts").ToolModelOutput>;
         description: string;
     };
-} | null>;
+} | null, InternalContext>;

package/dist/src/context/memory-tools.js

@@ -1 +1 @@
-import{loadContext}from"#context/container.js";import{TurnMemoryLocksKey}from"#context/keys.js";import{parseJsonObject}from"#shared/json.js";import{defineDynamic}from"#dynamic/definition.js";import{stampDurableDynamicToolCallbacks}from"#tools/durable-callbacks.js";import{isBrandedToolEntry}from"#tools/dynamic.js";import{resolveApprovalPolicy}from"#approval/definition.js";import{markDynamicCallbackRebind}from"#internal/dynamic-tool-rebind.js";function createMemoryToolDynamicDefinition(e,t){return markDynamicCallbackRebind(defineDynamic({events:{"turn.started":async(n,r)=>{let i=loadContext().get(TurnMemoryLocksKey)?.[t];if(i===void 0||e.provider.tools===void 0)return null;let a={...r,memory:{scope:i.scope,slot:t},turn:i.turn},o=await e.provider.tools(a);if(o===null)return null;if(typeof o!=`object`||Array.isArray(o))throw Error(`Memory slot "${t}" provider.tools() must return a tool map or null.`);return Object.fromEntries(Object.entries(o).map(([n,r])=>{let i=`${t}__${n}`;if(!isBrandedToolEntry(r))throw Error(`Memory provider tool "${i}" must be created with defineTool().`);let o=e.description===void 0?r.description:`${e.description}\n\n${r.description}`,s={...r,description:o};return stampDurableDynamicToolCallbacks(s,createProviderToolCallbacks({context:a,definition:e,key:n,tool:r})),[i,s]}))}}}))}function createProviderToolCallbacks(e){let{messages:t,turn:{input:n,...r},...i}=e.context,a=parseJsonObject({context:{...i,turn:r},key:e.key}),loadTool=async r=>{let i=r.key,a=r.context;if(typeof i!=`string`||typeof a!=`object`||!a)throw Error(`Memory provider tool callback has an invalid durable closure.`);let o=readMemoryToolsContext({...a,messages:t}),s=(await e.definition.provider.tools?.({...o,turn:{...o.turn,input:n}}))?.[i];if(s===void 0||!isBrandedToolEntry(s))throw Error(`Memory provider tool "${i}" was removed or renamed.`);return s},o={execute:{callback:async(e,t,n)=>await(await loadTool(e)).execute(t,n),closure:a}};for(let t of[`inputSchema`,`outputSchema`])e.tool[t]!==void 0&&(o[t]={callback:async e=>(await loadTool(e))[t],closure:a});return e.tool.approval!==void 0&&(o.approvalRequest={callback:async(e,t)=>await resolveApprovalPolicy((await loadTool(e)).approval)(t),closure:a},typeof e.tool.approval!=`function`&&e.tool.approval.response!==void 0&&(o.approvalResponse={callback:async(t,n)=>{let r=(await loadTool(t)).approval;if(r===void 0||typeof r==`function`||r.response===void 0)throw Error(`Memory provider tool "${e.key}" approval response was removed.`);return await r.response(n)},closure:a})),e.tool.toModelOutput!==void 0&&(o.toModelOutput={callback:async(e,t)=>await(await loadTool(e)).toModelOutput(t),closure:a}),o}function readMemoryToolsContext(e){if(typeof e!=`object`||!e||Array.isArray(e))throw Error(`Memory provider tool callback has an invalid durable context.`);let t=e;if(typeof t.channel!=`object`||t.channel===null||typeof t.memory!=`object`||t.memory===null||!Array.isArray(t.messages)||typeof t.session!=`object`||t.session===null||typeof t.turn!=`object`||t.turn===null)throw Error(`Memory provider tool callback has an invalid durable context.`);return t}export{createMemoryToolDynamicDefinition};
+import{asFrameworkDefinition,defineDynamic}from"#dynamic/definition.js";import{principalOf,resolveMemoryScope}from"#reactions/kinds/memory.js";import{readReactionsState}from"#reactions/state.js";import{isBrandedToolEntry}from"#tools/dynamic.js";function createMemoryToolDynamicDefinition(e,t){return asFrameworkDefinition(defineDynamic(async n=>{if(e.provider.tools===void 0)return null;let r=readReactionsState(n.ctx).latest[`turn.started`]??null,i=await n.memo({principal:principalOf(n),turn:r},()=>resolveMemoryScope({...e,slot:t},n));if(i===null)return null;let a={abortSignal:n.abortSignal,channel:n.channel,memory:{scope:i,slot:t},session:n.session};n.conversation!==void 0&&(a.conversation=n.conversation);let o=await e.provider.tools(a);if(o===null)return null;if(typeof o!=`object`||Array.isArray(o))throw Error(`Memory slot "${t}" provider.tools() must return a tool map or null.`);return Object.fromEntries(Object.entries(o).map(([n,r])=>{let i=`${t}__${n}`;if(!isBrandedToolEntry(r))throw Error(`Memory provider tool "${i}" must be created with defineTool().`);let a=e.description===void 0?r.description:`${e.description}\n\n${r.description}`;return[i,{...r,description:a}]}))}))}export{createMemoryToolDynamicDefinition};

package/dist/src/context/providers/connection.js

@@ -1 +1 @@
-import{ConnectionRegistryKey,ConnectionRegistryKey as ConnectionRegistryKey$1}from"#context/providers/connection-key.js";import{ConnectionRegistryImpl}from"#runtime/connections/registry.js";import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{getActiveRuntimeNode}from"#context/node.js";const connectionProvider={key:ConnectionRegistryKey$1,create(e,t){if(e.get(BundleKey)===void 0)return;let n=getActiveRuntimeNode(e).agent;if(n===void 0)return;let r=n.connections;if(r.length!==0||(n.dynamicConnectionResolvers?.length??0)!==0)return{value:new ConnectionRegistryImpl(r)}},dispose:e=>e.dispose()};export{ConnectionRegistryKey,connectionProvider};
+import{BundleKey}from"#runtime/sessions/runtime-context-keys.js";import{ConnectionRegistryKey,ConnectionRegistryKey as ConnectionRegistryKey$1}from"#context/providers/connection-key.js";import{ConnectionRegistryImpl}from"#runtime/connections/registry.js";import{getActiveRuntimeNode}from"#context/node.js";const connectionProvider={key:ConnectionRegistryKey$1,create(e,t){if(e.get(BundleKey)===void 0)return;let n=getActiveRuntimeNode(e).agent;if(n===void 0)return;let r=n.connections;if(r.length!==0||(n.dynamicConnectionResolvers?.length??0)!==0)return{value:new ConnectionRegistryImpl(r)}},dispose:e=>e.dispose()};export{ConnectionRegistryKey,connectionProvider};

package/dist/src/context/providers/session.js

@@ -1 +1 @@
-import{projectionFor}from"#harness/session-machine/current.js";import{AuthKey,InitiatorAuthKey,ParentSessionKey,SessionIdKey,SessionKey,SessionPredecessorKey}from"#context/keys.js";import{activeTurnId,turnPosition}from"#harness/session-machine/view.js";const sessionProvider={key:SessionKey,create(e,t){let n=e.require(AuthKey),r=turnPosition(projectionFor(e,t.state)),i=activeTurnId(r);return{value:Object.freeze({auth:{current:n,initiator:e.get(InitiatorAuthKey)??n},parent:e.get(ParentSessionKey),predecessor:e.get(SessionPredecessorKey),sessionId:e.require(SessionIdKey),turn:{id:i,sequence:r.sequence}})}}};export{sessionProvider};
+import{AuthKey,InitiatorAuthKey,ParentSessionKey,SessionIdKey,SessionKey,SessionPredecessorKey}from"#context/keys.js";import{activeTurnId,turnPosition}from"#harness/session-machine/view.js";import{projectionFor}from"#harness/session-machine/current.js";const sessionProvider={key:SessionKey,create(e,t){let n=e.require(AuthKey),r=turnPosition(projectionFor(e,t.state)),i=activeTurnId(r);return{value:Object.freeze({auth:{current:n,initiator:e.get(InitiatorAuthKey)??n},parent:e.get(ParentSessionKey),predecessor:e.get(SessionPredecessorKey),sessionId:e.require(SessionIdKey),turn:{id:i,sequence:r.sequence}})}}};export{sessionProvider};

package/dist/src/context/schedule-collection-tools.d.ts

@@ -5,5 +5,5 @@ export declare function createScheduleCollectionToolDynamicDefinition<TInput, TP
     readonly application: string;
     readonly collection: string;
 }): import("#dynamic/definition.js").DynamicSentinel<{
-    [x: string]: DynamicToolEntry<Record<string, unknown>, any>;
-} | null>;
+    [x: string]: DynamicToolEntry;
+} | null, import("#dynamic/definition.js").DynamicContext>;

package/dist/src/context/schedule-collection-tools.js

@@ -1 +1 @@
-import{z}from"#compiled/zod/index.js";import{loadContext}from"#context/container.js";import{scheduleDisplayName}from"#runtime/schedules/record.js";import{isDeepStrictEqual}from"node:util";import{parseJsonObject}from"#shared/json.js";import{defineDynamic}from"#dynamic/definition.js";import{scheduleCollectionToolPrefix}from"#shared/schedule-collection-tools.js";import{readDurableDynamicToolCallbacks,stampDurableDynamicToolCallbacks}from"#tools/durable-callbacks.js";import{ContextKey}from"#context/key.js";import{markDynamicCallbackRebind}from"#internal/dynamic-tool-rebind.js";import{isApprovalRecheck}from"#harness/approval-recheck.js";import{bindScheduleCollection,schedules}from"#public/experimental/schedules/client.js";import{MAX_SCHEDULE_DELAY_MINUTES}from"#runtime/schedules/validation.js";import{always}from"#tools/approval/policies.js";import{defineTool}from"#tools/definition.js";const PreparedWritesKey=new ContextKey(`eve.schedulePreparedWrites`),nameSchema=z.string().min(1).max(256).regex(/^[0-9A-Za-z][0-9A-Za-z._-]*$/).describe(`Readable display label; it may repeat. Creation returns a unique management name.`),nameInput=z.object({name:z.string().min(1).max(256).describe(`Exact unique management name returned by create/get/list, not the display label.`)}).strict(),timezoneSchema=z.string().describe(`IANA timezone; omission means UTC. Delays need no timezone.`),expressionSchema=z.discriminatedUnion(`type`,[z.object({type:z.literal(`cron`),cron:z.string().describe(`Five-field cron: minute hour day-of-month month day-of-week.`),timezone:timezoneSchema.optional(),jitter:z.number().int().min(1).max(15).optional()}).strict(),z.object({type:z.literal(`single`),at:z.string().describe(`Local YYYY-MM-DDTHH:mm, without offset or fractions.`),timezone:timezoneSchema.optional()}).strict(),z.object({type:z.literal(`delay`),minutes:z.number().int().min(1).max(MAX_SCHEDULE_DELAY_MINUTES)}).strict()]),timingGuidance=`For relative requests use expression { type: 'delay', minutes: 1 }; eve resolves timing after approval and rounds up to minute precision (up to 59 seconds later). Do not guess the clock or ask for a timezone for delays.`;function createScheduleCollectionToolDynamicDefinition(e,t){let bind=()=>bindScheduleCollection(e);return markDynamicCallbackRebind(defineDynamic({events:{"turn.started":async()=>{if(e.tool===!1)return null;let n=`${scheduleCollectionToolPrefix(t.collection)}__`,keyFor=(e,t)=>`${n}${e}:${t}`,r=z.object({name:nameSchema,expression:expressionSchema,payload:e.inputSchema}).strict(),i=r.partial({expression:!0,payload:!0}).extend({name:nameInput.shape.name}).refine(e=>e.expression!==void 0||e.payload!==void 0,{message:`Schedule update requires an expression or replacement payload.`}),a=writeApproval(e.approval?.create??always(),e=>keyFor(`create`,e),async e=>(await bind()).prepareCreate(await r.parseAsync(e)),e=>e.envelope.payload),o=writeApproval(e.approval?.update??always(),e=>keyFor(`update`,e),async e=>{let{name:t,expression:n,payload:r}=await i.parseAsync(e),a=await bind();return n===void 0?a.prepareUpdate(t,{payload:r}):a.prepareUpdate(t,{expression:n,payload:r})},e=>e.envelope?.payload),define=(t,n,r,i,a)=>{let o=defineTool({deferred:e.tool===`deferred`,description:`${e.description?`${e.description}\n\n`:``}${n}`,inputSchema:r,approval:a,label:{start:e=>e.name?`${t}: ${scheduleDisplayName(e.name)}`:t},execute:i});return stampCallbacks(o),o};return{[`${n}create`]:define(`Create schedule`,`Create future work, not an immediate action. The display name may repeat; use the returned unique name for management. ${timingGuidance} Preparation validates the destination before approval; a changed prepared payload requires fresh approval.`,r,async(t,n)=>{let r=keyFor(`create`,n.callId),i=loadContext().get(PreparedWritesKey)?.[r];if(i===void 0||!(`displayName`in i))throw Error(`Schedule creation has no prepared approval snapshot. Request creation again.`);let a=await(await bindScheduleCollection(e)).create(t,i),o={...loadContext().get(PreparedWritesKey)};return delete o[r],loadContext().set(PreparedWritesKey,o),a},a),[`${n}update`]:define(`Update schedule`,`Replace timing and/or the complete payload of an existing schedule. A payload replacement prepares new work and makes the updating caller its creator; timing-only updates preserve ownership. State and dispatch target are unchanged. Already started work is not cancelled. ${timingGuidance}`,i,async({name:t,...n},r)=>{let i=keyFor(`update`,r.callId),a=loadContext().get(PreparedWritesKey)?.[i];if(a===void 0||!(`name`in a))throw Error(`Schedule update has no prepared approval snapshot. Request update again.`);let o=await(await bindScheduleCollection(e)).update(t,n,a),s={...loadContext().get(PreparedWritesKey)};return delete s[i],loadContext().set(PreparedWritesKey,s),o},o),[`${n}get`]:define(`Read schedule`,`Read timing/state; stored payload is not returned.`,nameInput,async({name:t})=>await(await schedules(e)).get(t),e.approval?.get),[`${n}list`]:define(`List schedules`,`List identity, timing/state, and timestamps; payload is not returned.`,z.object({cursor:z.string().optional(),limit:z.number().int().min(1).max(100).optional()}).strict(),async t=>await(await schedules(e)).list(t),e.approval?.list),[`${n}enable`]:define(`Enable schedule`,`Enable future occurrences.`,nameInput,async({name:t})=>await(await schedules(e)).enable(t),e.approval?.enable??always()),[`${n}disable`]:define(`Disable schedule`,`Disable future occurrences; already started work is not cancelled.`,nameInput,async({name:t})=>await(await schedules(e)).disable(t),e.approval?.disable??always()),[`${n}invoke`]:define(`Run schedule`,`Enqueue an extra occurrence as the stored creator; acceptance is not execution success.`,nameInput,async({name:t})=>(await(await schedules(e)).invoke(t),{accepted:!0}),e.approval?.invoke??always()),[`${n}delete`]:define(`Delete schedule`,`Delete a schedule; already started work is not cancelled.`,nameInput,async({name:t})=>({deleted:await(await schedules(e)).delete(t)}),e.approval?.delete??always())}}}}))}function writeApproval(e,t,n,r){let i={request:async i=>{try{let a=await n(i.toolInput),o=t(i.callId),s=loadContext().get(PreparedWritesKey)??{};if(isApprovalRecheck(i)){if(s[o]===void 0||!isDeepStrictEqual(s[o],a))return{type:`denied`,reason:`The prepared schedule changed or its approval expired. Request a new approval.`}}else{let e={...Object.fromEntries(Object.entries(s).filter(([e])=>e!==o).slice(-31)),[o]:a};for(;Buffer.byteLength(JSON.stringify(e))>524288;)delete e[Object.keys(e)[0]];loadContext().set(PreparedWritesKey,e)}let c=r(a),l={...i,toolInput:{...i.toolInput,payload:c},payload:c};return typeof e==`function`?await e(l):await e.request(l)}catch(e){return{type:`denied`,reason:e instanceof Error?e.message:`Schedule preparation failed.`}}}};return typeof e!=`function`&&e.response!==void 0&&(i.response=async n=>{let i=loadContext().get(PreparedWritesKey)?.[t(n.request.callId)];if(i===void 0)return{status:`rejected`,reason:`The prepared schedule approval expired. Request approval again.`};let a=r(i);return await e.response({...n,request:{...n.request,toolInput:{...n.request.toolInput,payload:a}},payload:a})}),i}function stampCallbacks(e){let t=parseJsonObject({}),n={...readDurableDynamicToolCallbacks(e),execute:{callback:async(t,n,r)=>await e.execute(n,r),closure:t},inputSchema:{callback:()=>e.inputSchema,closure:t},label:{start:{callback:(t,n)=>e.label.start(n),closure:t}}};if(e.approval!==void 0){let r=e.approval;n.approvalRequest={callback:async(e,t)=>typeof r==`function`?await r(t):await r.request(t),closure:t},typeof r!=`function`&&r.response!==void 0&&(n.approvalResponse={callback:async(e,t)=>await r.response(t),closure:t})}stampDurableDynamicToolCallbacks(e,n)}export{createScheduleCollectionToolDynamicDefinition};
+import{z}from"#compiled/zod/index.js";import{scheduleDisplayName}from"#runtime/schedules/record.js";import{loadContext}from"#context/container.js";import{isDeepStrictEqual}from"node:util";import{defineDynamic}from"#dynamic/definition.js";import{scheduleCollectionToolPrefix}from"#shared/schedule-collection-tools.js";import{ContextKey}from"#context/key.js";import{inheritApprovalContext,isApprovalRecheck}from"#approval/evaluation.js";import{bindScheduleCollection,schedules}from"#public/experimental/schedules/client.js";import{MAX_SCHEDULE_DELAY_MINUTES}from"#runtime/schedules/validation.js";import{always}from"#tools/approval/policies.js";import{defineTool}from"#tools/definition.js";const PreparedWritesKey=new ContextKey(`eve.schedulePreparedWrites`),nameSchema=z.string().min(1).max(256).regex(/^[0-9A-Za-z][0-9A-Za-z._-]*$/).describe(`Readable display label; it may repeat. Creation returns a unique management name.`),nameInput=z.object({name:z.string().min(1).max(256).describe(`Exact unique management name returned by create/get/list, not the display label.`)}).strict(),timezoneSchema=z.string().describe(`IANA timezone; omission means UTC. Delays need no timezone.`),expressionSchema=z.discriminatedUnion(`type`,[z.object({type:z.literal(`cron`),cron:z.string().describe(`Five-field cron: minute hour day-of-month month day-of-week.`),timezone:timezoneSchema.optional(),jitter:z.number().int().min(1).max(15).optional()}).strict(),z.object({type:z.literal(`single`),at:z.string().describe(`Local YYYY-MM-DDTHH:mm, without offset or fractions.`),timezone:timezoneSchema.optional()}).strict(),z.object({type:z.literal(`delay`),minutes:z.number().int().min(1).max(MAX_SCHEDULE_DELAY_MINUTES)}).strict()]),timingGuidance=`For relative requests use expression { type: 'delay', minutes: 1 }; eve resolves timing after approval and rounds up to minute precision (up to 59 seconds later). Do not guess the clock or ask for a timezone for delays.`;function createScheduleCollectionToolDynamicDefinition(e,t){let bind=()=>bindScheduleCollection(e);return defineDynamic(()=>{if(e.tool===!1)return null;let n=`${scheduleCollectionToolPrefix(t.collection)}__`,keyFor=(e,t)=>`${n}${e}:${t}`,r=z.object({name:nameSchema,expression:expressionSchema,payload:e.inputSchema}).strict(),i=r.partial({expression:!0,payload:!0}).extend({name:nameInput.shape.name}).refine(e=>e.expression!==void 0||e.payload!==void 0,{message:`Schedule update requires an expression or replacement payload.`}),a=writeApproval(e.approval?.create??always(),e=>keyFor(`create`,e),async e=>(await bind()).prepareCreate(await r.parseAsync(e)),e=>e.envelope.payload),o=writeApproval(e.approval?.update??always(),e=>keyFor(`update`,e),async e=>{let{name:t,expression:n,payload:r}=await i.parseAsync(e),a=await bind();return n===void 0?a.prepareUpdate(t,{payload:r}):a.prepareUpdate(t,{expression:n,payload:r})},e=>e.envelope?.payload),define=(t,n,r,i,a)=>defineTool({deferred:e.tool===`deferred`,description:`${e.description?`${e.description}\n\n`:``}${n}`,inputSchema:r,approval:a,label:{start:e=>e.name?`${t}: ${scheduleDisplayName(e.name)}`:t},execute:i});return{[`${n}create`]:define(`Create schedule`,`Create future work, not an immediate action. The display name may repeat; use the returned unique name for management. ${timingGuidance} Preparation validates the destination before approval; a changed prepared payload requires fresh approval.`,r,async(t,n)=>{let r=keyFor(`create`,n.callId),i=loadContext().get(PreparedWritesKey)?.[r];if(i===void 0||!(`displayName`in i))throw Error(`Schedule creation has no prepared approval snapshot. Request creation again.`);let a=await(await bindScheduleCollection(e)).create(t,i),o={...loadContext().get(PreparedWritesKey)};return delete o[r],loadContext().set(PreparedWritesKey,o),a},a),[`${n}update`]:define(`Update schedule`,`Replace timing and/or the complete payload of an existing schedule. A payload replacement prepares new work and makes the updating caller its creator; timing-only updates preserve ownership. State and dispatch target are unchanged. Already started work is not cancelled. ${timingGuidance}`,i,async({name:t,...n},r)=>{let i=keyFor(`update`,r.callId),a=loadContext().get(PreparedWritesKey)?.[i];if(a===void 0||!(`name`in a))throw Error(`Schedule update has no prepared approval snapshot. Request update again.`);let o=await(await bindScheduleCollection(e)).update(t,n,a),s={...loadContext().get(PreparedWritesKey)};return delete s[i],loadContext().set(PreparedWritesKey,s),o},o),[`${n}get`]:define(`Read schedule`,`Read timing/state; stored payload is not returned.`,nameInput,async({name:t})=>await(await schedules(e)).get(t),e.approval?.get),[`${n}list`]:define(`List schedules`,`List identity, timing/state, and timestamps; payload is not returned.`,z.object({cursor:z.string().optional(),limit:z.number().int().min(1).max(100).optional()}).strict(),async t=>await(await schedules(e)).list(t),e.approval?.list),[`${n}enable`]:define(`Enable schedule`,`Enable future occurrences.`,nameInput,async({name:t})=>await(await schedules(e)).enable(t),e.approval?.enable??always()),[`${n}disable`]:define(`Disable schedule`,`Disable future occurrences; already started work is not cancelled.`,nameInput,async({name:t})=>await(await schedules(e)).disable(t),e.approval?.disable??always()),[`${n}invoke`]:define(`Run schedule`,`Enqueue an extra occurrence as the stored creator; acceptance is not execution success.`,nameInput,async({name:t})=>(await(await schedules(e)).invoke(t),{accepted:!0}),e.approval?.invoke??always()),[`${n}delete`]:define(`Delete schedule`,`Delete a schedule; already started work is not cancelled.`,nameInput,async({name:t})=>({deleted:await(await schedules(e)).delete(t)}),e.approval?.delete??always())}})}function writeApproval(e,t,n,r){let i={request:async i=>{try{let a=await n(i.toolInput),o=t(i.callId),s=loadContext().get(PreparedWritesKey)??{};if(isApprovalRecheck(i)){if(s[o]===void 0||!isDeepStrictEqual(s[o],a))return{type:`denied`,reason:`The prepared schedule changed or its approval expired. Request a new approval.`}}else{let e={...Object.fromEntries(Object.entries(s).filter(([e])=>e!==o).slice(-31)),[o]:a};for(;Buffer.byteLength(JSON.stringify(e))>524288;)delete e[Object.keys(e)[0]];loadContext().set(PreparedWritesKey,e)}let c=r(a),l=inheritApprovalContext(i,{...i,toolInput:{...i.toolInput,payload:c},payload:c});return typeof e==`function`?await e(l):await e.request(l)}catch(e){return{type:`denied`,reason:e instanceof Error?e.message:`Schedule preparation failed.`}}}};return typeof e!=`function`&&e.response!==void 0&&(i.response=async n=>{let i=loadContext().get(PreparedWritesKey)?.[t(n.request.callId)];if(i===void 0)return{status:`rejected`,reason:`The prepared schedule approval expired. Request approval again.`};let a=r(i);return await e.response({...n,request:{...n.request,toolInput:{...n.request.toolInput,payload:a}},payload:a})}),i}export{createScheduleCollectionToolDynamicDefinition};

package/dist/src/context/session-context.d.ts

@@ -1,5 +1,5 @@
 import type { SandboxEnvironment } from "#shared/sandbox-environment.js";
-import type { RuntimeSandboxSession, RuntimeSandboxSessionFor, SandboxSession } from "#shared/sandbox-session.js";
+import type { RuntimeSandboxSession, SandboxSession } from "#shared/sandbox-session.js";
 import type { SessionAuth, SessionParent, SessionPredecessor, SessionTurn } from "#context/keys.js";
 import type { SessionSchedule } from "#context/session-schedule.js";
 export type { SessionAuth, SessionParent, SessionPredecessor, SessionSchedule, SessionTurn };
@@ -38,5 +38,7 @@ export interface SessionContext {
      * Resolves the session's sandbox with the capabilities declared by its
      * configured environment. Throws when the environment is not active.
      */
-    getSandbox<Session extends SandboxSession>(environment: SandboxEnvironment<object | undefined, Session>): Promise<RuntimeSandboxSessionFor<Session>>;
+    getSandbox<Session extends SandboxSession>(environment: SandboxEnvironment<object | undefined, Session>): Promise<RuntimeSandboxSession<Session>>;
 }
+/** Active session metadata observed by authored callbacks as `ctx.session`. */
+export type SessionInfo = SessionContext["session"];

package/dist/src/discover/extensions.d.ts

@@ -23,10 +23,9 @@ export declare const DISCOVER_EXTENSION_NESTED_MOUNT_UNSUPPORTED = "discover/ext
  */
 export declare const DISCOVER_EXTENSION_COMPATIBILITY_INVALID = "discover/extension-compatibility-invalid";
 /**
- * Emitted when this eve cannot consume one of the extension capabilities the
- * distribution requires.
+ * Emitted when the consumer cannot load this extension distribution.
  */
-export declare const DISCOVER_EXTENSION_CAPABILITY_INCOMPATIBLE = "discover/extension-capability-incompatible";
+export declare const DISCOVER_EXTENSION_VERSION_INCOMPATIBLE = "discover/extension-version-incompatible";
 /**
  * Emitted when an extension source tree declares agent-level config (`agent.ts`),
  * which is the consuming agent's to own.

package/dist/src/discover/extensions.js

@@ -1 +1 @@
-import{dirname,isAbsolute,join,resolve}from"node:path";import{SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS}from"#discover/filesystem.js";import{readPackageJsonName}from"#discover/project-source.js";import{createDiscoverErrorDiagnostic}from"#discover/diagnostics.js";import{EXTENSION_COMPATIBILITY_MANIFEST_FILENAME,findUnsupportedExtensionCapabilities,parseExtensionCompatibilityManifest}from"#compiler/extension-compatibility.js";import{parseExtensionMountSpecifier}from"#discover/extension-specifier.js";import{parseBuiltInExtensionPackageRoots,parseExtensionPackageRoots}from"#shared/extension-package-contract.js";const DISCOVER_EXTENSION_MOUNT_UNRESOLVED=`discover/extension-mount-unresolved`,DISCOVER_EXTENSION_MOUNT_AMBIGUOUS=`discover/extension-mount-ambiguous`,DISCOVER_EXTENSION_MOUNT_MISSING_DECLARATION=`discover/extension-mount-missing-declaration`,DISCOVER_EXTENSION_NESTED_MOUNT_UNSUPPORTED=`discover/extension-nested-mount-unsupported`,DISCOVER_EXTENSION_PACKAGE_INVALID=`discover/extension-package-invalid`,DISCOVER_EXTENSION_COMPATIBILITY_INVALID=`discover/extension-compatibility-invalid`,DISCOVER_EXTENSION_CAPABILITY_INCOMPATIBLE=`discover/extension-capability-incompatible`,DISCOVER_EXTENSION_AGENT_CONFIG_UNSUPPORTED=`discover/extension-agent-config-unsupported`,DISCOVER_EXTENSION_SANDBOX_UNSUPPORTED=`discover/extension-sandbox-unsupported`,DISCOVER_EXTENSION_MEMORY_UNSUPPORTED=`discover/extension-memory-unsupported`,DISCOVER_EXTENSION_INSTRUMENTATION_UNSUPPORTED=`discover/extension-instrumentation-unsupported`;function mountNamespace(e){let t=e.slice(e.lastIndexOf(`/`)+1);for(let e of SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS)if(t.toLowerCase().endsWith(e))return t.slice(0,t.length-e.length);return t}function mountRefNamespace(e){let t=e.replace(/^extensions\//,``),n=t.indexOf(`/`);return n===-1?mountNamespace(e):t.slice(0,n)}async function locateExtensionMount(e){let t=await locateExtensionMountPackage(e);if(t.location===void 0)return{diagnostics:t.diagnostics};let{location:n}=t;if(n.builtIn)return{location:{namespace:n.namespace,specifier:n.specifier,packageName:n.packageName,packageRoot:n.packageRoot,sourceRoot:n.distRoot,externalDependencies:[]},diagnostics:[]};let r=join(n.distRoot,EXTENSION_COMPATIBILITY_MANIFEST_FILENAME),i;try{i=parseExtensionCompatibilityManifest(await e.source.readTextFile(r),r)}catch(e){return{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_COMPATIBILITY_INVALID,message:`Extension "${n.packageName}" has no valid compatibility manifest at "${r}". Rebuild or reinstall the extension. ${e instanceof Error?e.message:String(e)}`,sourcePath:r})]}}let a=findUnsupportedExtensionCapabilities(i);return a.length>0?{diagnostics:a.map(e=>createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_CAPABILITY_INCOMPATIBLE,message:`Extension "${n.packageName}" requires ${e.capability} contract v${e.requiredVersion}, but this eve supports ${e.capability} contract ${formatSupportedVersions(e.supportedVersions)}. Upgrade eve or install an extension release that requires a supported ${e.capability} contract.`,sourcePath:r}))}:{location:{namespace:n.namespace,specifier:n.specifier,packageName:n.packageName,packageRoot:n.packageRoot,sourceRoot:n.distRoot,externalDependencies:i.build?.externalDependencies??[]},diagnostics:[]}}async function locateExtensionMountPackage(e){let t=join(e.agentRoot,e.mount.logicalPath),{namespace:n}=e,r;try{r=await e.source.readTextFile(t)}catch{return{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_MOUNT_UNRESOLVED,message:`Could not read extension mount "${e.mount.logicalPath}".`,sourcePath:t})]}}let i=parseExtensionMountSpecifier(r);if(i===null)return{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_MOUNT_UNRESOLVED,message:`Extension mount "${e.mount.logicalPath}" must default-export a mounted extension, e.g. \`export default crm({ ... })\` or \`export { default } from "@acme/crm"\`.`,sourcePath:t})]};let a=await resolvePackageRoot({source:e.source,appRoot:e.appRoot,mountDirectory:dirname(t),specifier:i});if(a===null)return{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_MOUNT_UNRESOLVED,message:`Could not resolve extension package "${i}" mounted by "${e.mount.logicalPath}".`,sourcePath:t})]};let o=join(a,`package.json`),s;try{s=JSON.parse(await e.source.readTextFile(o))}catch{return{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_PACKAGE_INVALID,message:`Extension package "${i}" has no readable package.json at "${o}".`,sourcePath:o})]}}let c=parseBuiltInExtensionPackageRoots(s.eve?.builtInExtensions,packageSpecifierSubpath(i)),l=c??parseExtensionPackageRoots(s.eve?.extension);return l===null?{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_PACKAGE_INVALID,message:`Package "${i}" is not an eve extension: its package.json must declare \`eve.extension.dist\`.`,sourcePath:o})]}:{location:{namespace:n,specifier:i,packageName:typeof s.name==`string`&&s.name.length>0?s.name:i,packageRoot:a,...l.source===void 0?{}:{authoredSourceRoot:resolve(a,l.source)},builtIn:c!==null,distRoot:resolve(a,l.dist)},diagnostics:[]}}function formatSupportedVersions(e){return e.length===0?`versions: none`:`versions: ${e.map(e=>`v${e}`).join(`, `)}`}async function resolvePackageRoot(e){if(e.specifier.startsWith(`.`)){let t=resolve(e.mountDirectory,e.specifier);return await hasPackageJson(e.source,t)?t:null}if(isAbsolute(e.specifier))return await hasPackageJson(e.source,e.specifier)?e.specifier:null;let t=bareSpecifierPackagePath(e.specifier);if(await readPackageJsonName(e.source,e.appRoot)===t)return resolve(e.appRoot);let n=resolve(e.appRoot);for(;;){let r=join(n,`node_modules`,t);if(await hasPackageJson(e.source,r))return r;let i=dirname(n);if(i===n)return null;n=i}}function packageSpecifierSubpath(e){let t=e.slice(bareSpecifierPackagePath(e).length);return t.length===0?`.`:`.${t}`}function bareSpecifierPackagePath(e){let t=e.split(`/`);return e.startsWith(`@`)?t.slice(0,2).join(`/`):t[0]??e}async function hasPackageJson(e,t){return await e.stat(join(t,`package.json`))===`file`}export{DISCOVER_EXTENSION_AGENT_CONFIG_UNSUPPORTED,DISCOVER_EXTENSION_CAPABILITY_INCOMPATIBLE,DISCOVER_EXTENSION_COMPATIBILITY_INVALID,DISCOVER_EXTENSION_INSTRUMENTATION_UNSUPPORTED,DISCOVER_EXTENSION_MEMORY_UNSUPPORTED,DISCOVER_EXTENSION_MOUNT_AMBIGUOUS,DISCOVER_EXTENSION_MOUNT_MISSING_DECLARATION,DISCOVER_EXTENSION_NESTED_MOUNT_UNSUPPORTED,DISCOVER_EXTENSION_SANDBOX_UNSUPPORTED,locateExtensionMount,locateExtensionMountPackage,mountNamespace,mountRefNamespace};
+import{dirname,isAbsolute,join,resolve}from"node:path";import{resolveInstalledPackageInfo}from"#internal/application/package.js";import{SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS}from"#discover/filesystem.js";import{readPackageJsonName}from"#discover/project-source.js";import{createDiscoverErrorDiagnostic}from"#discover/diagnostics.js";import{EXTENSION_COMPATIBILITY_MANIFEST_FILENAME,UnsupportedExtensionManifestVersionError,checkExtensionVersionCompatibility,parseExtensionCompatibilityManifest}from"#compiler/extension-compatibility.js";import{parseExtensionMountSpecifier}from"#discover/extension-specifier.js";import{parseBuiltInExtensionPackageRoots,parseExtensionPackageRoots}from"#shared/extension-package-contract.js";const DISCOVER_EXTENSION_MOUNT_UNRESOLVED=`discover/extension-mount-unresolved`,DISCOVER_EXTENSION_MOUNT_AMBIGUOUS=`discover/extension-mount-ambiguous`,DISCOVER_EXTENSION_MOUNT_MISSING_DECLARATION=`discover/extension-mount-missing-declaration`,DISCOVER_EXTENSION_NESTED_MOUNT_UNSUPPORTED=`discover/extension-nested-mount-unsupported`,DISCOVER_EXTENSION_PACKAGE_INVALID=`discover/extension-package-invalid`,DISCOVER_EXTENSION_COMPATIBILITY_INVALID=`discover/extension-compatibility-invalid`,DISCOVER_EXTENSION_VERSION_INCOMPATIBLE=`discover/extension-version-incompatible`,DISCOVER_EXTENSION_AGENT_CONFIG_UNSUPPORTED=`discover/extension-agent-config-unsupported`,DISCOVER_EXTENSION_SANDBOX_UNSUPPORTED=`discover/extension-sandbox-unsupported`,DISCOVER_EXTENSION_MEMORY_UNSUPPORTED=`discover/extension-memory-unsupported`,DISCOVER_EXTENSION_INSTRUMENTATION_UNSUPPORTED=`discover/extension-instrumentation-unsupported`;function mountNamespace(e){let t=e.slice(e.lastIndexOf(`/`)+1);for(let e of SUPPORTED_AUTHORED_MODULE_FILE_EXTENSIONS)if(t.toLowerCase().endsWith(e))return t.slice(0,t.length-e.length);return t}function mountRefNamespace(e){let t=e.replace(/^extensions\//,``),n=t.indexOf(`/`);return n===-1?mountNamespace(e):t.slice(0,n)}async function locateExtensionMount(e){let t=await locateExtensionMountPackage(e);if(t.location===void 0)return{diagnostics:t.diagnostics};let{location:n}=t;if(n.builtIn)return{location:{namespace:n.namespace,specifier:n.specifier,packageName:n.packageName,packageRoot:n.packageRoot,sourceRoot:n.distRoot,externalDependencies:[]},diagnostics:[]};let r=join(n.distRoot,EXTENSION_COMPATIBILITY_MANIFEST_FILENAME),i;try{i=parseExtensionCompatibilityManifest(await e.source.readTextFile(r),r)}catch(e){return e instanceof UnsupportedExtensionManifestVersionError?{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_VERSION_INCOMPATIBLE,message:`Extension "${n.packageName}" uses an old epoch-based distribution manifest at "${r}". Rebuild the extension with this eve release or install a compatible extension release.`,sourcePath:r})]}:{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_COMPATIBILITY_INVALID,message:`Extension "${n.packageName}" has no valid compatibility manifest at "${r}". Rebuild or reinstall the extension. ${e instanceof Error?e.message:String(e)}`,sourcePath:r})]}}let a=checkExtensionVersionCompatibility(i,resolveInstalledPackageInfo().version);return a===void 0?{location:{namespace:n.namespace,specifier:n.specifier,packageName:n.packageName,packageRoot:n.packageRoot,sourceRoot:n.distRoot,externalDependencies:i.build?.externalDependencies??[]},diagnostics:[]}:{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_VERSION_INCOMPATIBLE,message:a.kind===`newer-eve`?`Extension "${n.packageName}" was built with eve ${a.minimumVersion}. Upgrade eve to ${a.minimumVersion} or later, or install an extension built with your eve version.`:`Extension "${n.packageName}" requires distribution contract ${a.contractMajor}, which this eve does not support. Rebuild the extension with this eve or install a compatible extension release.`,sourcePath:r})]}}async function locateExtensionMountPackage(e){let t=join(e.agentRoot,e.mount.logicalPath),{namespace:n}=e,r;try{r=await e.source.readTextFile(t)}catch{return{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_MOUNT_UNRESOLVED,message:`Could not read extension mount "${e.mount.logicalPath}".`,sourcePath:t})]}}let i=parseExtensionMountSpecifier(r);if(i===null)return{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_MOUNT_UNRESOLVED,message:`Extension mount "${e.mount.logicalPath}" must default-export a mounted extension, e.g. \`export default crm({ ... })\` or \`export { default } from "@acme/crm"\`.`,sourcePath:t})]};let a=await resolvePackageRoot$1({source:e.source,appRoot:e.appRoot,mountDirectory:dirname(t),specifier:i});if(a===null)return{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_MOUNT_UNRESOLVED,message:`Could not resolve extension package "${i}" mounted by "${e.mount.logicalPath}".`,sourcePath:t})]};let o=join(a,`package.json`),s;try{s=JSON.parse(await e.source.readTextFile(o))}catch{return{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_PACKAGE_INVALID,message:`Extension package "${i}" has no readable package.json at "${o}".`,sourcePath:o})]}}let c=parseBuiltInExtensionPackageRoots(s.eve?.builtInExtensions,packageSpecifierSubpath(i)),l=c??parseExtensionPackageRoots(s.eve?.extension);return l===null?{diagnostics:[createDiscoverErrorDiagnostic({code:DISCOVER_EXTENSION_PACKAGE_INVALID,message:`Package "${i}" is not an eve extension: its package.json must declare \`eve.extension.dist\`.`,sourcePath:o})]}:{location:{namespace:n,specifier:i,packageName:typeof s.name==`string`&&s.name.length>0?s.name:i,packageRoot:a,...l.source===void 0?{}:{authoredSourceRoot:resolve(a,l.source)},builtIn:c!==null,distRoot:resolve(a,l.dist)},diagnostics:[]}}async function resolvePackageRoot$1(e){if(e.specifier.startsWith(`.`)){let t=resolve(e.mountDirectory,e.specifier);return await hasPackageJson(e.source,t)?t:null}if(isAbsolute(e.specifier))return await hasPackageJson(e.source,e.specifier)?e.specifier:null;let t=bareSpecifierPackagePath(e.specifier);if(await readPackageJsonName(e.source,e.appRoot)===t)return resolve(e.appRoot);let n=resolve(e.appRoot);for(;;){let r=join(n,`node_modules`,t);if(await hasPackageJson(e.source,r))return r;let i=dirname(n);if(i===n)return null;n=i}}function packageSpecifierSubpath(e){let t=e.slice(bareSpecifierPackagePath(e).length);return t.length===0?`.`:`.${t}`}function bareSpecifierPackagePath(e){let t=e.split(`/`);return e.startsWith(`@`)?t.slice(0,2).join(`/`):t[0]??e}async function hasPackageJson(e,t){return await e.stat(join(t,`package.json`))===`file`}export{DISCOVER_EXTENSION_AGENT_CONFIG_UNSUPPORTED,DISCOVER_EXTENSION_COMPATIBILITY_INVALID,DISCOVER_EXTENSION_INSTRUMENTATION_UNSUPPORTED,DISCOVER_EXTENSION_MEMORY_UNSUPPORTED,DISCOVER_EXTENSION_MOUNT_AMBIGUOUS,DISCOVER_EXTENSION_MOUNT_MISSING_DECLARATION,DISCOVER_EXTENSION_NESTED_MOUNT_UNSUPPORTED,DISCOVER_EXTENSION_SANDBOX_UNSUPPORTED,DISCOVER_EXTENSION_VERSION_INCOMPATIBLE,locateExtensionMount,locateExtensionMountPackage,mountNamespace,mountRefNamespace};

package/dist/src/discover/manifest.js

@@ -1 +1 @@
-import{basename,relative,resolve}from"node:path";import{normalizeLogicalPath}from"#discover/filesystem.js";import{summarizeDiscoverDiagnostics}from"#discover/diagnostics.js";const AGENT_SOURCE_MANIFEST_KIND=`eve-agent-discovery-manifest`,AGENT_SOURCE_MANIFEST_VERSION=15;function createAgentSourceManifest(e){let t=resolve(e.appRoot),n=resolve(e.agentRoot),r={agentId:e.agentId??deriveAgentIdFromRoots(t,n,e.packageName),agentRoot:n,appRoot:t,channels:[...e.channels??[]],connections:[...e.connections??[]],diagnosticsSummary:summarizeDiscoverDiagnostics(e.diagnostics??[]),extensions:[...e.extensions??[]],resolvedExtensions:[...e.resolvedExtensions??[]],hooks:[...e.hooks??[]],memories:[...e.memories??[]],instructions:[...e.instructions??[]],lib:[...e.lib??[]],kind:AGENT_SOURCE_MANIFEST_KIND,sandbox:e.sandbox??null,sandboxWorkspaces:[...e.sandboxWorkspaces??[]],schedules:[...e.schedules??[]],skills:[...e.skills??[]],tools:[...e.tools??[]],version:15,subagents:[...e.subagents??[]]};return e.configModule!==void 0&&(r.configModule=e.configModule),r}function deriveAgentIdFromRoots(e,t,n){let r=normalizeLogicalPath(relative(e,t));return r===``||r===`.`||r===`agent`?n??basename(e):basename(t)}function createPathDerivedSourceId(e){return normalizeLogicalPath(e)}function createModuleSourceRef(e){let t=normalizeLogicalPath(e.logicalPath),n={sourceKind:`module`,logicalPath:t,sourceId:e.sourceId??createPathDerivedSourceId(t)};return e.exportName!==void 0&&(n.exportName=e.exportName),n}function createConnectionSourceRef(e){return{...createModuleSourceRef(e),connectionName:e.connectionName}}function createLocalSubagentSourceRef(e){let t=normalizeLogicalPath(e.logicalPath);return{entryPath:e.entryPath,logicalPath:t,manifest:e.manifest,rootPath:e.rootPath,sourceId:e.sourceId??createPathDerivedSourceId(t),subagentId:e.subagentId}}function createSkillPackageSourceRef(e){return{assetsPath:e.assetsPath,deferred:e.deferred,description:e.description,license:e.license,logicalPath:normalizeLogicalPath(e.logicalPath),markdown:e.markdown,metadata:e.metadata===void 0?void 0:{...e.metadata},name:e.name,referencesPath:e.referencesPath,rootPath:e.rootPath,scriptsPath:e.scriptsPath,skillFilePath:e.skillFilePath,skillId:e.skillId,sourceId:e.sourceId,sourceKind:`skill-package`}}export{AGENT_SOURCE_MANIFEST_KIND,AGENT_SOURCE_MANIFEST_VERSION,createAgentSourceManifest,createConnectionSourceRef,createLocalSubagentSourceRef,createModuleSourceRef,createPathDerivedSourceId,createSkillPackageSourceRef,deriveAgentIdFromRoots};
+import{basename,relative,resolve}from"node:path";import{normalizeLogicalPath}from"#discover/filesystem.js";import{summarizeDiscoverDiagnostics}from"#discover/diagnostics.js";const AGENT_SOURCE_MANIFEST_KIND=`eve-agent-discovery-manifest`,AGENT_SOURCE_MANIFEST_VERSION=15;function createAgentSourceManifest(e){let t=resolve(e.appRoot),n=resolve(e.agentRoot),r={agentId:e.agentId??deriveAgentIdFromRoots(t,n,e.packageName),agentRoot:n,appRoot:t,channels:[...e.channels??[]],connections:[...e.connections??[]],diagnosticsSummary:summarizeDiscoverDiagnostics(e.diagnostics??[]),extensions:[...e.extensions??[]],resolvedExtensions:[...e.resolvedExtensions??[]],hooks:[...e.hooks??[]],memories:[...e.memories??[]],instructions:[...e.instructions??[]],lib:[...e.lib??[]],kind:AGENT_SOURCE_MANIFEST_KIND,sandbox:e.sandbox??null,sandboxWorkspaces:[...e.sandboxWorkspaces??[]],schedules:[...e.schedules??[]],skills:[...e.skills??[]],tools:[...e.tools??[]],version:15,subagents:[...e.subagents??[]]};return e.configModule!==void 0&&(r.configModule=e.configModule),r}function deriveAgentIdFromRoots(e,t,n){let r=normalizeLogicalPath(relative(e,t));return r===``||r===`.`||r===`agent`?n??basename(e):basename(t)}function createPathDerivedSourceId(e){return normalizeLogicalPath(e)}function createModuleSourceRef(e){let t=normalizeLogicalPath(e.logicalPath),n={sourceKind:`module`,logicalPath:t,sourceId:e.sourceId??createPathDerivedSourceId(t)};return e.exportName!==void 0&&(n.exportName=e.exportName),n}function createConnectionSourceRef(e){return{...createModuleSourceRef(e),connectionName:e.connectionName}}function createLocalSubagentSourceRef(e){let t=normalizeLogicalPath(e.logicalPath);return{entryPath:e.entryPath,logicalPath:t,manifest:e.manifest,rootPath:e.rootPath,sourceId:e.sourceId??createPathDerivedSourceId(t),subagentId:e.subagentId}}function createSkillPackageSourceRef(e){return{assetsPath:e.assetsPath,deferred:e.deferred,description:e.description,license:e.license,logicalPath:normalizeLogicalPath(e.logicalPath),content:e.markdown,metadata:e.metadata===void 0?void 0:{...e.metadata},name:e.name,referencesPath:e.referencesPath,rootPath:e.rootPath,scriptsPath:e.scriptsPath,skillFilePath:e.skillFilePath,skillId:e.skillId,sourceId:e.sourceId,sourceKind:`skill-package`}}export{AGENT_SOURCE_MANIFEST_KIND,AGENT_SOURCE_MANIFEST_VERSION,createAgentSourceManifest,createConnectionSourceRef,createLocalSubagentSourceRef,createModuleSourceRef,createPathDerivedSourceId,createSkillPackageSourceRef,deriveAgentIdFromRoots};