eve 0.67.1 → 0.68.0

package/dist/src/{extensions/code → computer-use}/extension/lib/computer-use-driver-source.d.ts

@@ -1,9 +1,7 @@
 export declare const SERVER_MJS_SOURCE = "import { setTimeout as delay } from \"node:timers/promises\";\nimport { execFile, execFileSync } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { chmod, rename, rm } from \"node:fs/promises\";\nimport { promisify } from \"node:util\";\nimport http from \"node:http\";\nimport { env } from \"node:process\";\nimport { dirname, resolve } from \"node:path\";\n\nimport { CuaDriver } from \"@trycua/cua-driver\";\n\nimport { pointerMotionPlan } from \"./pointer-motion.mjs\";\nimport { selectGroundingElements } from \"./state.mjs\";\nimport { naturalTypingPlan } from \"./typing.mjs\";\n\nconst socketPath = env.COMPUTER_USE_SOCKET_PATH;\nconst workspaceRoot = env.COMPUTER_USE_ROOT;\nconst maxRequestBytes = 32 * 1024;\nconst maxRequestMs = 120_000;\nconst maxRecordingMs = 300_000;\nconst nativeCallTimeoutMs = 10_000;\n// Only the queue owner sets this signal; recording finalization deliberately bypasses it.\nlet requestSignal;\nconst desktopMargin = 24;\nconst minimumWindow = { height: 240, width: 480 };\nconst layoutTolerance = { height: 8, width: 8, x: 4, y: 4 };\nconst maxClipboardBytes = 10_000;\nconst driver = await CuaDriver.create({ claudeCodeCompatibility: false });\nconst execFilePromise = promisify(execFile);\nfunction execFileAsync(file, args, options) {\n  return execFilePromise(file, args, {\n    timeout: nativeCallTimeoutMs,\n    ...options,\n    signal: requestSignal,\n  });\n}\n\nlet activeRecording = null;\nlet queue = Promise.resolve();\nlet shuttingDown = false;\n\nawait rm(socketPath, { force: true });\n\nconst server = http.createServer((request, response) => {\n  if (shuttingDown) return response.destroy();\n  if (request.method !== \"POST\" || request.url !== \"/call\") {\n    sendJson(response, 404, { error: \"not found\" });\n    return;\n  }\n  const controller = new AbortController();\n  const deadline = Number(request.headers[\"x-computer-use-deadline\"]);\n  const timeoutMs = Number.isFinite(deadline)\n    ? Math.max(0, Math.min(maxRequestMs, deadline - Date.now()))\n    : maxRequestMs;\n  const cancel = () =>\n    controller.abort(new Error(\"computer-use request cancelled or deadline exceeded\"));\n  const timer = setTimeout(cancel, timeoutMs);\n  response.once(\"close\", cancel);\n  controller.signal.addEventListener(\"abort\", () => response.destroy(), { once: true });\n  if (timeoutMs === 0) cancel();\n  // Read immediately: a body may finish or disconnect while another call owns the queue.\n  const body = readBody(request);\n  void body.catch(() => undefined);\n  const task = queue.then(async () => {\n    controller.signal.throwIfAborted();\n    if (shuttingDown) return;\n    requestSignal = controller.signal;\n    try {\n      await handleRequest(await body, response);\n    } finally {\n      requestSignal = undefined;\n    }\n  });\n  queue = task\n    .catch(() => response.destroy())\n    .finally(() => {\n      clearTimeout(timer);\n      response.removeListener(\"close\", cancel);\n    });\n});\n\nserver.listen(socketPath, () => {\n  void chmod(socketPath, 0o600);\n});\n\nfor (const signal of [\"SIGINT\", \"SIGTERM\"]) {\n  process.once(signal, () => {\n    void shutdown();\n  });\n}\n\nasync function shutdown() {\n  if (shuttingDown) return;\n  shuttingDown = true;\n  server.close();\n  server.closeAllConnections();\n  const timer = setTimeout(() => process.exit(1), nativeCallTimeoutMs * 2);\n  let exitCode = 0;\n  try {\n    await queue;\n    if (activeRecording !== null) await stopRecording();\n  } catch {\n    exitCode = 1;\n  } finally {\n    try {\n      await driver.shutdown();\n    } catch {\n      exitCode = 1;\n    } finally {\n      clearTimeout(timer);\n      process.exit(exitCode);\n    }\n  }\n}\n\nasync function handleRequest(body, response) {\n  try {\n    const input = JSON.parse(body);\n    if (input.action === \"health\") {\n      sendJson(response, 200, { backend: \"cua-driver\", version: \"0.12.5\" });\n      return;\n    }\n\n    validateRequest(input);\n    const actionResult = await performAction(input.action);\n    const state = await captureState(input.screenshotPath);\n    sendJson(response, 200, {\n      action: actionResult,\n      backend: \"cua-driver\",\n      screenshot: input.screenshotPath,\n      state,\n      version: \"0.12.5\",\n    });\n  } catch (error) {\n    if (requestSignal?.aborted && activeRecording !== null) {\n      await stopRecording().catch(() => undefined);\n    }\n    sendJson(response, 500, {\n      error: error instanceof Error ? error.message : String(error),\n    });\n  }\n}\n\nasync function performAction(action) {\n  requestSignal?.throwIfAborted();\n  validateActionCoordinates(action);\n  if (action.action === \"sequence\") {\n    const results = [];\n    try {\n      for (const nested of action.actions) {\n        const startedAt = performance.now();\n        const result = await performAction(nested);\n        results.push({\n          action: nested.action,\n          durationMs: Math.round(performance.now() - startedAt),\n          result,\n        });\n      }\n      return results;\n    } catch (error) {\n      // Never strand the durable driver in an active-recording state when a\n      // rehearsed step fails. Preserve the original action error.\n      if (activeRecording !== null) await stopRecording().catch(() => undefined);\n      throw error;\n    }\n  }\n  switch (action.action) {\n    case \"screenshot\":\n      return null;\n    case \"click\":\n      await moveCursor(action);\n      return click(action, 1);\n    case \"double_click\":\n      await moveCursor(action);\n      return click(action, 2);\n    case \"triple_click\":\n      await moveCursor(action);\n      return click(action, 3);\n    case \"drag\":\n      return dragCursor(action);\n    case \"keypress\":\n      return action.keys.length === 1\n        ? call(\"press_key\", {\n            scope: \"desktop\",\n            key: normalizeKey(action.keys[0]),\n          })\n        : call(\"hotkey\", {\n            scope: \"desktop\",\n            keys: action.keys.map(normalizeKey),\n          });\n    case \"move\":\n      return moveCursor(action);\n    case \"scroll\": {\n      await call(\"move_cursor\", {\n        scope: \"desktop\",\n        x: action.x,\n        y: action.y,\n      });\n      const results = [];\n      if (action.scrollY !== 0) {\n        results.push(await call(\"scroll\", scrollInput(action.scrollY, \"up\", \"down\")));\n      }\n      if (action.scrollX !== 0) {\n        results.push(await call(\"scroll\", scrollInput(action.scrollX, \"left\", \"right\")));\n      }\n      return results;\n    }\n    case \"type\":\n      return typeText(action);\n    case \"clipboard_read\":\n      return readClipboard(action.selection);\n    case \"clipboard_write\":\n      return writeClipboard(action.selection, action.text);\n    case \"wait\":\n      await sleep(action.durationMs ?? 2_000);\n      return null;\n    case \"arrange_windows\":\n      return arrangeWindows(action);\n    case \"record_start\":\n      return startRecording(action.path);\n    case \"record_stop\":\n      return stopRecording();\n    default:\n      throw new Error(`unsupported computer-use action: ${String(action.action)}`);\n  }\n}\n\nasync function captureState(screenshotPath) {\n  await call(\"get_desktop_state\", { screenshot_out_file: screenshotPath });\n  const pointer = structured(await call(\"get_cursor_position\", {}));\n  const screen = x11ScreenSize();\n  const windows = structured(await call(\"list_windows\", { on_screen_only: true })).windows;\n  const contentWindows = Array.isArray(windows) ? windows.filter(isContentWindow) : [];\n  const groundingWindow = contentWindows.toSorted((left, right) => right.z_index - left.z_index)[0];\n\n  let elements = [];\n  if (groundingWindow !== undefined) {\n    const windowState = structured(\n      await call(\"get_window_state\", {\n        pid: groundingWindow.pid,\n        window_id: groundingWindow.window_id,\n        include_screenshot: false,\n        max_depth: 20,\n        max_elements: 250,\n      }),\n    );\n    if (Array.isArray(windowState.elements)) {\n      elements = selectGroundingElements(windowState.elements, {\n        width: Number(screen.width) || 1920,\n        height: Number(screen.height) || 1080,\n      });\n    }\n  }\n\n  return formatState(groundingWindow, pointer, elements);\n}\n\nasync function startRecording(path) {\n  if (activeRecording !== null) {\n    throw new Error(\"a recording is already active\");\n  }\n\n  const outputDirectory = `${workspaceRoot}/recording-${randomUUID()}`;\n  const result = await call(\n    \"start_recording\",\n    {\n      output_dir: outputDirectory,\n      record_video: true,\n    },\n    false,\n  );\n  activeRecording = {\n    outputDirectory,\n    outputPath: path,\n    stopping: null,\n    timer: setTimeout(() => {\n      void stopRecording().catch(() => {\n        void shutdown();\n      });\n    }, maxRecordingMs),\n  };\n  return result;\n}\n\nasync function stopRecording() {\n  if (activeRecording === null) {\n    throw new Error(\"no recording is active\");\n  }\n\n  const recording = activeRecording;\n  if (recording.stopping !== null) return recording.stopping;\n  clearTimeout(recording.timer);\n  recording.stopping = finalizeRecording(recording);\n  return recording.stopping;\n}\n\nasync function finalizeRecording(recording) {\n  try {\n    const result = await call(\"stop_recording\", {}, false);\n    const output = structured(result);\n    const videoPath =\n      typeof output.last_video_path === \"string\"\n        ? output.last_video_path\n        : recording.outputDirectory + \"/recording.mp4\";\n    await rename(videoPath, recording.outputPath);\n    await rm(recording.outputDirectory, { force: true, recursive: true });\n    return result;\n  } catch (error) {\n    void shutdown();\n    throw error;\n  } finally {\n    activeRecording = null;\n  }\n}\n\nasync function call(name, input, cancellable = true) {\n  const signal = cancellable ? requestSignal : undefined;\n  signal?.throwIfAborted();\n  let timer;\n  const result = await Promise.race([\n    driver.callTool(name, JSON.stringify(input)),\n    new Promise((_, reject) => {\n      timer = setTimeout(() => {\n        // Native calls have no abort API. Do not reuse a driver with uncertain in-flight work.\n        void shutdown();\n        reject(new Error(\"computer-use native call timed out; restart with startComputerUse\"));\n      }, nativeCallTimeoutMs);\n    }),\n  ]).finally(() => clearTimeout(timer));\n  signal?.throwIfAborted();\n  if (result.isError) {\n    throw new Error(\n      `Cua ${name} failed${result.errorCode ? ` (${result.errorCode})` : \"\"}: ${result.text}`,\n    );\n  }\n  return {\n    degraded: result.degraded,\n    structuredJson: result.structuredJson,\n    text: result.text,\n    verified: result.verified,\n  };\n}\n\nfunction structured(result) {\n  if (result.structuredJson === undefined) return {};\n  return JSON.parse(result.structuredJson);\n}\n\nfunction pointerClickInput(x, y, button, count) {\n  return {\n    scope: \"desktop\",\n    x,\n    y,\n    button: button === \"wheel\" ? \"middle\" : button,\n    count,\n  };\n}\n\nasync function moveCursor(action) {\n  if (action.movementStyle === undefined) {\n    return call(\"move_cursor\", { scope: \"desktop\", x: action.x, y: action.y });\n  }\n  const current = structured(await call(\"get_cursor_position\", {}));\n  const start = { x: Number(current.x), y: Number(current.y) };\n  if (!Number.isFinite(start.x) || !Number.isFinite(start.y)) {\n    return call(\"move_cursor\", { scope: \"desktop\", x: action.x, y: action.y });\n  }\n  const options = { style: action.movementStyle };\n  if (action.durationMs !== undefined) options.durationMs = action.durationMs;\n  return followPointerPlan(pointerMotionPlan(start, { x: action.x, y: action.y }, options), \"x11\");\n}\n\nasync function dragCursor(action) {\n  const start = action.path[0];\n  const end = action.path.at(-1);\n  if (action.movementStyle === undefined) {\n    return call(\"drag\", {\n      scope: \"desktop\",\n      from_x: start.x,\n      from_y: start.y,\n      to_x: end.x,\n      to_y: end.y,\n      steps: Math.min(200, Math.max(20, action.path.length * 10)),\n    });\n  }\n  const style = action.movementStyle;\n  const current = structured(await call(\"get_cursor_position\", {}));\n  const currentPoint = { x: Number(current.x), y: Number(current.y) };\n  const approach =\n    Number.isFinite(currentPoint.x) && Number.isFinite(currentPoint.y)\n      ? pointerPlanArgs(pointerMotionPlan(currentPoint, start, { style: \"natural\" }))\n      : [\"mousemove\", String(start.x), String(start.y)];\n  const options = { style };\n  if (action.durationMs !== undefined) options.durationMs = action.durationMs;\n  const drag = pointerPlanArgs(pointerMotionPlan(start, end, options));\n  return xdotool([\n    ...approach,\n    \"sleep\",\n    \"0.025\",\n    \"mousedown\",\n    \"1\",\n    \"sleep\",\n    \"0.030\",\n    ...drag,\n    \"sleep\",\n    \"0.030\",\n    \"mouseup\",\n    \"1\",\n  ]);\n}\n\nasync function followPointerPlan(plan, backend = \"cua\") {\n  if (backend === \"x11\") return xdotool(pointerPlanArgs(plan));\n  const results = [];\n  for (let phaseIndex = 0; phaseIndex < plan.phases.length; phaseIndex += 1) {\n    for (const point of plan.phases[phaseIndex]) {\n      results.push(await call(\"move_cursor\", { scope: \"desktop\", x: point.x, y: point.y }));\n      if (point.delayMs > 0) await sleep(point.delayMs);\n    }\n    if (phaseIndex < plan.phases.length - 1 && plan.settleMs > 0) await sleep(plan.settleMs);\n  }\n  if (plan.phases.length === 1 && plan.settleMs > 0) await sleep(plan.settleMs);\n  return results;\n}\n\nfunction pointerPlanArgs(plan) {\n  const args = [];\n  for (let phaseIndex = 0; phaseIndex < plan.phases.length; phaseIndex += 1) {\n    for (const point of plan.phases[phaseIndex]) {\n      args.push(\"mousemove\", String(point.x), String(point.y));\n      if (point.delayMs > 0) args.push(\"sleep\", (point.delayMs / 1000).toFixed(3));\n    }\n    if (phaseIndex < plan.phases.length - 1 && plan.settleMs > 0) {\n      args.push(\"sleep\", (plan.settleMs / 1000).toFixed(3));\n    }\n  }\n  if (plan.phases.length === 1 && plan.settleMs > 0) {\n    args.push(\"sleep\", (plan.settleMs / 1000).toFixed(3));\n  }\n  return args;\n}\n\nasync function xdotool(args) {\n  const plannedSleepMs = args.reduce(\n    (total, value, index) => (args[index - 1] === \"sleep\" ? total + Number(value) * 1000 : total),\n    0,\n  );\n  const timeout = Math.max(2_000, Math.ceil(plannedSleepMs + 1_500));\n  const result = await execFileAsync(\"xdotool\", args, { env: displayEnv(), timeout });\n  return {\n    plannedSleepMs: Math.round(plannedSleepMs),\n    stderr: result.stderr,\n    stdout: result.stdout,\n  };\n}\n\nfunction typingPlan(action) {\n  if (action.typingStyle === \"natural\") return naturalTypingPlan(action.text);\n  return [...new Intl.Segmenter().segment(action.text)].map(({ segment }) => ({\n    grapheme: segment,\n    delayMs: action.typingDelayMs ?? 0,\n  }));\n}\n\nfunction validateTypingBudget(actions) {\n  let characters = 0;\n  let calls = 0;\n  let delayMs = 0;\n  for (const action of actions) {\n    if (action.action !== \"type\") continue;\n    if (typeof action.text !== \"string\" || action.text.length > 10_000) {\n      throw new Error(\"typing text must be at most 10000 characters\");\n    }\n    characters += action.text.length;\n    if (action.typingStyle === undefined && !action.typingDelayMs) continue;\n    const plan = typingPlan(action);\n    calls += plan.length;\n    delayMs += plan.reduce((total, step) => total + step.delayMs, 0);\n  }\n  if (characters > 10_000 || calls > 1_000 || delayMs > 30_000) {\n    throw new Error(\n      \"typing budget exceeded: at most 10000 characters, 1000 paced graphemes and 30000ms delay per request; use unpaced typing for longer text\",\n    );\n  }\n}\n\nasync function typeText(action) {\n  if (action.typingStyle === undefined && !action.typingDelayMs) {\n    return call(\"type_text\", { scope: \"desktop\", text: action.text });\n  }\n  let result;\n  let graphemesTyped = 0;\n  for (const { grapheme, delayMs } of typingPlan(action)) {\n    result = await call(\"type_text\", { scope: \"desktop\", text: grapheme });\n    graphemesTyped += 1;\n    if (delayMs > 0) await sleep(delayMs);\n  }\n  return { graphemesTyped, result };\n}\n\nasync function click(action, count) {\n  if (action.button !== \"back\" && action.button !== \"forward\") {\n    return call(\"click\", pointerClickInput(action.x, action.y, action.button, count));\n  }\n\n  await call(\"move_cursor\", {\n    scope: \"desktop\",\n    x: action.x,\n    y: action.y,\n  });\n  const results = [];\n  for (let index = 0; index < count; index += 1) {\n    results.push(\n      await call(\"hotkey\", {\n        scope: \"desktop\",\n        keys: [\"alt\", action.button === \"back\" ? \"left\" : \"right\"],\n      }),\n    );\n  }\n  return results;\n}\n\nasync function readClipboard(selection) {\n  try {\n    const result = await execFileAsync(\"xclip\", [\"-selection\", xclipSelection(selection), \"-out\"], {\n      env: displayEnv(),\n      maxBuffer: maxClipboardBytes + 1,\n    });\n    if (Buffer.byteLength(result.stdout) > maxClipboardBytes) {\n      throw new Error(`clipboard content exceeds ${maxClipboardBytes} bytes`);\n    }\n    return { selection, text: result.stdout };\n  } catch (error) {\n    if (error instanceof Error && error.message.includes(\"clipboard content exceeds\")) throw error;\n    return { selection, text: \"\" };\n  }\n}\n\nasync function writeClipboard(selection, text) {\n  if (Buffer.byteLength(text) > maxClipboardBytes) {\n    throw new Error(`clipboard content exceeds ${maxClipboardBytes} bytes`);\n  }\n  await new Promise((resolve, reject) => {\n    const child = execFile(\"xclip\", [\"-selection\", xclipSelection(selection), \"-in\"], {\n      env: displayEnv(),\n      timeout: nativeCallTimeoutMs,\n      signal: requestSignal,\n    });\n    child.once(\"error\", reject);\n    child.once(\"exit\", (code) =>\n      code === 0 ? resolve() : reject(new Error(`xclip exited ${code}`)),\n    );\n    child.stdin.end(text);\n  });\n  return { bytes: Buffer.byteLength(text), selection };\n}\n\nfunction xclipSelection(selection) {\n  return selection === \"primary\" ? \"primary\" : \"clipboard\";\n}\n\nasync function arrangeWindows(action) {\n  const scene = validateWindowScene(action.windows);\n  const deadline = Date.now() + action.waitForMs;\n  let resolved = null;\n  while (resolved === null) {\n    const windows = structured(await call(\"list_windows\", { on_screen_only: true })).windows;\n    resolved = resolveSceneWindows(scene, Array.isArray(windows) ? windows : []);\n    if (resolved !== null) break;\n    if (Date.now() >= deadline) {\n      throw new Error(\n        `arrange_windows timed out waiting for: ${missingSceneSelectors(scene, Array.isArray(windows) ? windows : []).join(\", \")}`,\n      );\n    }\n    await sleep(100);\n  }\n\n  // Resolve the complete scene before mutating any window. A missing selector\n  // therefore leaves the existing desktop untouched.\n  for (const item of resolved) {\n    const windowId = String(item.window.window_id);\n    await execFileAsync(\"xdotool\", [\"windowactivate\", \"--sync\", windowId], { env: displayEnv() });\n    await execFileAsync(\n      \"xdotool\",\n      [\"windowmove\", windowId, String(item.bounds.x), String(item.bounds.y)],\n      {\n        env: displayEnv(),\n      },\n    );\n    await execFileAsync(\n      \"xdotool\",\n      [\"windowsize\", windowId, String(item.bounds.width), String(item.bounds.height)],\n      { env: displayEnv() },\n    );\n  }\n\n  let verified = null;\n  let windows = [];\n  for (let attempt = 0; attempt < 10; attempt += 1) {\n    const response = structured(await call(\"list_windows\", { on_screen_only: true })).windows;\n    windows = Array.isArray(response) ? response : [];\n    verified = resolveSceneWindows(scene, windows);\n    if (\n      verified !== null &&\n      verified.every(({ bounds, window }) => approximatelyEqual(bounds, window))\n    ) {\n      return verified.map(layoutResult);\n    }\n    await sleep(100);\n  }\n\n  const screenshotPath = `${workspaceRoot}/layout-failure-${Date.now()}.png`;\n  await call(\"get_desktop_state\", { screenshot_out_file: screenshotPath });\n  const details =\n    verified === null\n      ? { stage: \"selector_resolution\", missing: missingSceneSelectors(scene, windows) }\n      : {\n          stage: \"verification\",\n          tolerance: layoutTolerance,\n          windows: verified.map(layoutResult),\n        };\n  throw new Error(\n    `arrange_windows failed: ${JSON.stringify({ ...details, screenshot: screenshotPath })}`,\n  );\n}\n\nfunction validateWindowScene(windows) {\n  if (!Array.isArray(windows) || windows.length < 1 || windows.length > 4) {\n    throw new Error(\"arrange_windows requires 1 to 4 windows\");\n  }\n  const scene = windows.map((item) => ({ ...item, bounds: regionBounds(item.region) }));\n  const selectors = scene.map((item) => selectorLabel(item.selector));\n  if (new Set(selectors).size !== selectors.length) {\n    throw new Error(\"arrange_windows selectors must be unique\");\n  }\n  for (let left = 0; left < scene.length; left += 1) {\n    for (let right = left + 1; right < scene.length; right += 1) {\n      if (overlaps(scene[left].bounds, scene[right].bounds)) {\n        throw new Error(\"arrange_windows regions must not overlap\");\n      }\n    }\n  }\n  return scene;\n}\n\nfunction desktopBounds() {\n  const screen = x11ScreenSize();\n  return {\n    x: desktopMargin,\n    y: desktopMargin,\n    width: screen.width - desktopMargin * 2,\n    height: screen.height - desktopMargin * 2,\n  };\n}\n\nfunction x11ScreenSize() {\n  // The X server is the source of truth after set_desktop_size. Avoid CUA's\n  // session-oriented get_screen_size contract, which differs from pointer\n  // actions and does not accept scope.\n  const output = execFileSync(\"xdpyinfo\", [\"-display\", \":99\"], {\n    encoding: \"utf8\",\n    timeout: 2_000,\n  });\n  const match = /dimensions:\\s+(\\d+)x(\\d+) pixels/u.exec(output);\n  if (match === null) throw new Error(\"could not determine desktop dimensions\");\n  return { width: Number(match[1]), height: Number(match[2]) };\n}\n\nfunction regionBounds(region) {\n  if (\n    typeof region !== \"object\" ||\n    region === null ||\n    ![region.x, region.y, region.width, region.height].every(Number.isFinite) ||\n    region.x < 0 ||\n    region.y < 0 ||\n    region.width <= 0 ||\n    region.height <= 0 ||\n    region.x + region.width > 1 ||\n    region.y + region.height > 1\n  ) {\n    throw new Error(\"arrange_windows regions must fit within the desktop\");\n  }\n  const desktop = desktopBounds();\n  const left = Math.round(desktop.x + desktop.width * region.x);\n  const top = Math.round(desktop.y + desktop.height * region.y);\n  const right = Math.round(desktop.x + desktop.width * (region.x + region.width));\n  const bottom = Math.round(desktop.y + desktop.height * (region.y + region.height));\n  const bounds = { x: left, y: top, width: right - left, height: bottom - top };\n  if (bounds.width < minimumWindow.width || bounds.height < minimumWindow.height) {\n    throw new Error(\n      `arrange_windows regions must be at least ${minimumWindow.width}x${minimumWindow.height}`,\n    );\n  }\n  return bounds;\n}\n\nfunction resolveSceneWindows(scene, windows) {\n  const resolved = scene.map((item) => {\n    const window = windows.find((candidate) => matchesSelector(candidate, item.selector));\n    return window === undefined ? null : { bounds: item.bounds, window };\n  });\n  return resolved.includes(null) ? null : resolved;\n}\n\nfunction missingSceneSelectors(scene, windows) {\n  return scene\n    .filter((item) => !windows.some((window) => matchesSelector(window, item.selector)))\n    .map((item) => selectorLabel(item.selector));\n}\n\nfunction matchesSelector(window, selector) {\n  const identity = `${window.app_name ?? \"\"}\\n${window.title ?? \"\"}`.toLowerCase();\n  if (selector.app === \"firefox\") return identity.includes(\"firefox\");\n  const title = selector.instance === \"primary\" ? \"terminal 1\" : \"terminal 2\";\n  return identity.includes(title);\n}\n\nfunction selectorLabel(selector) {\n  return selector.app === \"firefox\" ? \"firefox\" : `xterm:${selector.instance}`;\n}\n\nfunction overlaps(left, right) {\n  return (\n    left.x < right.x + right.width &&\n    left.x + left.width > right.x &&\n    left.y < right.y + right.height &&\n    left.y + left.height > right.y\n  );\n}\n\nfunction layoutResult({ bounds, window }) {\n  const observed = {\n    x: Number(window.x),\n    y: Number(window.y),\n    width: Number(window.width),\n    height: Number(window.height),\n  };\n  return {\n    selector: `${window.app_name ?? \"\"}:${window.title ?? \"\"}`,\n    requested: bounds,\n    observed,\n    delta: {\n      x: observed.x - bounds.x,\n      y: observed.y - bounds.y,\n      width: observed.width - bounds.width,\n      height: observed.height - bounds.height,\n    },\n    tolerance: layoutTolerance,\n    title: window.title,\n    window_id: window.window_id,\n  };\n}\n\nfunction displayEnv() {\n  return { ...env, DISPLAY: \":99\" };\n}\n\nfunction approximatelyEqual(bounds, window) {\n  return (\n    Math.abs(bounds.x - window.x) <= layoutTolerance.x &&\n    Math.abs(bounds.y - window.y) <= layoutTolerance.y &&\n    Math.abs(bounds.width - window.width) <= layoutTolerance.width &&\n    Math.abs(bounds.height - window.height) <= layoutTolerance.height\n  );\n}\n\nfunction sleep(milliseconds) {\n  return delay(milliseconds, undefined, { signal: requestSignal });\n}\n\nfunction scrollInput(delta, negativeDirection, positiveDirection) {\n  return {\n    scope: \"desktop\",\n    direction: delta < 0 ? negativeDirection : positiveDirection,\n    amount: Math.min(50, Math.max(1, Math.round(Math.abs(delta) / 100))),\n    by: \"line\",\n  };\n}\n\nfunction normalizeKey(key) {\n  const aliases = {\n    ARROWDOWN: \"down\",\n    ARROWLEFT: \"left\",\n    ARROWRIGHT: \"right\",\n    ARROWUP: \"up\",\n    CMD: \"meta\",\n    COMMAND: \"meta\",\n    CONTROL: \"ctrl\",\n    DEL: \"delete\",\n    ENTER: \"enter\",\n    ESC: \"escape\",\n    OPTION: \"alt\",\n    RETURN: \"enter\",\n  };\n  return aliases[key] ?? key.toLowerCase();\n}\n\nfunction isContentWindow(window) {\n  const identity = `${window.app_name ?? \"\"}\\n${window.title ?? \"\"}`.toLowerCase();\n  return (\n    window.width >= 200 &&\n    window.height >= 100 &&\n    !identity.includes(\"xfce4-panel\") &&\n    !identity.includes(\"xfdesktop\") &&\n    window.title !== \"Desktop\"\n  );\n}\n\nfunction formatState(groundingWindow, pointer, elements) {\n  const lines = [\n    groundingWindow === undefined\n      ? \"grounding_window\\t(none)\"\n      : `grounding_window\\t${groundingWindow.title} pid=${groundingWindow.pid} window_id=${groundingWindow.window_id}`,\n    `pointer\\tx=${pointer.x ?? \"unknown\"} y=${pointer.y ?? \"unknown\"}`,\n    \"accessibility_elements\",\n  ];\n\n  for (const element of elements) {\n    const frame =\n      element.frame === undefined\n        ? \"\"\n        : ` x=${element.frame.x} y=${element.frame.y} width=${element.frame.w} height=${element.frame.h}`;\n    lines.push(\n      `[${element.element_index}] role=${element.role}${frame} label=${JSON.stringify(element.label ?? \"\")}`,\n    );\n  }\n  return lines.join(\"\\n\");\n}\n\nfunction validateActionCoordinates(action) {\n  const screen = x11ScreenSize();\n  const points = [];\n  if ([\"click\", \"double_click\", \"triple_click\", \"move\", \"scroll\"].includes(action.action)) {\n    points.push({ x: action.x, y: action.y });\n  }\n  if (action.action === \"drag\") points.push(...action.path);\n  for (const point of points) {\n    if (\n      !Number.isFinite(point.x) ||\n      !Number.isFinite(point.y) ||\n      point.x < 0 ||\n      point.y < 0 ||\n      point.x >= screen.width ||\n      point.y >= screen.height\n    ) {\n      throw new Error(\n        `computer-use coordinate is outside the ${screen.width}x${screen.height} desktop`,\n      );\n    }\n  }\n}\n\nfunction validateRequest(input) {\n  if (typeof input !== \"object\" || input === null) {\n    throw new Error(\"request must be an object\");\n  }\n  if (!isArtifactPath(input.screenshotPath, \".png\")) {\n    throw new Error(\"screenshot path must be a PNG under the computer-use workspace\");\n  }\n  if (typeof input.action !== \"object\" || input.action === null) {\n    throw new Error(\"request action must be an object\");\n  }\n  const actions = new Set([\n    \"arrange_windows\",\n    \"click\",\n    \"clipboard_read\",\n    \"clipboard_write\",\n    \"double_click\",\n    \"drag\",\n    \"keypress\",\n    \"move\",\n    \"record_start\",\n    \"record_stop\",\n    \"screenshot\",\n    \"scroll\",\n    \"sequence\",\n    \"triple_click\",\n    \"type\",\n    \"wait\",\n  ]);\n  if (!actions.has(input.action.action)) {\n    throw new Error(`unsupported computer-use action: ${String(input.action.action)}`);\n  }\n  if (input.action.action === \"sequence\") {\n    if (\n      !Array.isArray(input.action.actions) ||\n      input.action.actions.length < 1 ||\n      input.action.actions.length > 30\n    ) {\n      throw new Error(\"sequence must contain 1 to 30 actions\");\n    }\n    for (const action of input.action.actions) validateNestedSequenceAction(action);\n  }\n  if (input.action.action === \"arrange_windows\") validateArrangeWindowsAction(input.action);\n  if (input.action.action === \"record_start\" && !isArtifactPath(input.action.path, \".mp4\")) {\n    throw new Error(\"recording path must be an MP4 under the computer-use workspace\");\n  }\n  if (\n    [\"click\", \"double_click\", \"triple_click\", \"drag\", \"move\"].includes(input.action.action) &&\n    \"durationMs\" in input.action &&\n    (!Number.isInteger(input.action.durationMs) ||\n      input.action.durationMs < 0 ||\n      input.action.durationMs > 2000)\n  ) {\n    throw new Error(\"pointer durationMs must be an integer from 0 to 2000\");\n  }\n  validateMovementStyle(input.action, \"\");\n  if (\n    input.action.action === \"wait\" &&\n    (!Number.isInteger(input.action.durationMs) ||\n      input.action.durationMs < 100 ||\n      input.action.durationMs > 10_000)\n  ) {\n    throw new Error(\"wait durationMs must be an integer from 100 to 10000\");\n  }\n  validateClipboardOptions(input.action);\n  validateTypingOptions(input.action, \"\");\n  validateTypingBudget(input.action.action === \"sequence\" ? input.action.actions : [input.action]);\n}\n\nfunction validateNestedSequenceAction(action) {\n  if (typeof action !== \"object\" || action === null)\n    throw new Error(\"sequence action must be an object\");\n  const allowed = new Set([\n    \"arrange_windows\",\n    \"click\",\n    \"double_click\",\n    \"drag\",\n    \"keypress\",\n    \"move\",\n    \"record_start\",\n    \"record_stop\",\n    \"triple_click\",\n    \"type\",\n    \"wait\",\n  ]);\n  if (!allowed.has(action.action))\n    throw new Error(`unsupported sequence action: ${String(action.action)}`);\n  if (action.action === \"arrange_windows\") validateArrangeWindowsAction(action);\n  if (action.action === \"record_start\" && !isArtifactPath(action.path, \".mp4\")) {\n    throw new Error(\"sequence recording path must be an MP4 under the computer-use workspace\");\n  }\n  if (\n    [\"click\", \"double_click\", \"triple_click\", \"drag\", \"move\"].includes(action.action) &&\n    \"durationMs\" in action &&\n    (!Number.isInteger(action.durationMs) || action.durationMs < 0 || action.durationMs > 2000)\n  ) {\n    throw new Error(\"sequence pointer durationMs must be an integer from 0 to 2000\");\n  }\n  validateMovementStyle(action, \"sequence \");\n  if (\n    action.action === \"wait\" &&\n    (!Number.isInteger(action.durationMs) || action.durationMs < 100 || action.durationMs > 10_000)\n  ) {\n    throw new Error(\"sequence wait durationMs must be an integer from 100 to 10000\");\n  }\n  if (action.action === \"type\") validateTypingOptions(action, \"sequence \");\n}\n\nfunction validateMovementStyle(action, prefix) {\n  if (\n    \"movementStyle\" in action &&\n    action.movementStyle !== \"natural\" &&\n    action.movementStyle !== \"precision\"\n  ) {\n    throw new Error(`${prefix}movementStyle must be natural or precision`);\n  }\n  if (\n    action.action === \"drag\" &&\n    \"movementStyle\" in action &&\n    action.movementStyle !== \"precision\"\n  ) {\n    throw new Error(`${prefix}drag movementStyle must be precision`);\n  }\n}\n\nfunction validateClipboardOptions(action) {\n  if (\n    [\"clipboard_read\", \"clipboard_write\"].includes(action.action) &&\n    action.selection !== \"clipboard\" &&\n    action.selection !== \"primary\"\n  ) {\n    throw new Error(\"clipboard selection must be clipboard or primary\");\n  }\n  if (\n    action.action === \"clipboard_write\" &&\n    (typeof action.text !== \"string\" || Buffer.byteLength(action.text) > maxClipboardBytes)\n  ) {\n    throw new Error(`clipboard text must be at most ${maxClipboardBytes} bytes`);\n  }\n}\n\nfunction validateTypingOptions(action, prefix) {\n  if (\n    \"typingDelayMs\" in action &&\n    (!Number.isInteger(action.typingDelayMs) ||\n      action.typingDelayMs < 0 ||\n      action.typingDelayMs > 200)\n  ) {\n    throw new Error(`${prefix}typingDelayMs must be an integer from 0 to 200`);\n  }\n  if (\"typingStyle\" in action && action.typingStyle !== \"natural\") {\n    throw new Error(`${prefix}typingStyle must be natural`);\n  }\n  if (\"typingStyle\" in action && \"typingDelayMs\" in action) {\n    throw new Error(`${prefix}type action cannot set both typingStyle and typingDelayMs`);\n  }\n}\n\nfunction validateArrangeWindowsAction(action) {\n  if (!Number.isInteger(action.waitForMs) || action.waitForMs < 0 || action.waitForMs > 10_000) {\n    throw new Error(\"arrange_windows waitForMs must be an integer from 0 to 10000\");\n  }\n  validateWindowScene(action.windows);\n}\n\nfunction isArtifactPath(value, extension) {\n  if (typeof value !== \"string\" || !value.endsWith(extension)) return false;\n  const path = resolve(value);\n  return dirname(path) === workspaceRoot;\n}\n\nasync function readBody(request) {\n  let body = \"\";\n  for await (const chunk of request) {\n    body += chunk;\n    if (Buffer.byteLength(body) > maxRequestBytes) {\n      throw new Error(\"request exceeds 32 KiB\");\n    }\n  }\n  return body;\n}\n\nfunction sendJson(response, statusCode, body) {\n  if (response.destroyed) return;\n  const json = JSON.stringify(body);\n  response.writeHead(statusCode, {\n    \"content-length\": Buffer.byteLength(json),\n    \"content-type\": \"application/json\",\n  });\n  response.end(json);\n}\n";
 export declare const CLIENT_MJS_SOURCE = "import http from \"node:http\";\nimport { env } from \"node:process\";\n\nconst socketPath = env.COMPUTER_USE_SOCKET_PATH;\nconst body = env.COMPUTER_USE_REQUEST;\n\nif (body === undefined) {\n  throw new Error(\"COMPUTER_USE_REQUEST is required\");\n}\n\nconst deadline = Date.now() + 120_000;\nconst response = await new Promise((resolve, reject) => {\n  const request = http.request(\n    {\n      socketPath,\n      method: \"POST\",\n      path: \"/call\",\n      headers: {\n        \"content-length\": Buffer.byteLength(body),\n        \"content-type\": \"application/json\",\n        \"x-computer-use-deadline\": String(deadline),\n      },\n    },\n    (incoming) => {\n      incoming.on(\"error\", reject);\n      incoming.setEncoding(\"utf8\");\n      let responseBody = \"\";\n      incoming.on(\"data\", (chunk) => {\n        responseBody += chunk;\n      });\n      incoming.on(\"end\", () => {\n        resolve({ body: responseBody, statusCode: incoming.statusCode ?? 500 });\n      });\n    },\n  );\n  const timer = setTimeout(\n    () => request.destroy(new Error(\"computer-use request deadline exceeded\")),\n    Math.max(0, deadline - Date.now()),\n  );\n  request.once(\"close\", () => clearTimeout(timer));\n  request.on(\"error\", reject);\n  request.end(body);\n});\n\nif (response.statusCode !== 200) {\n  process.stderr.write(response.body);\n  process.exitCode = 1;\n} else {\n  process.stdout.write(response.body);\n}\n";
-export declare const STATE_MJS_SOURCE = "const MAX_GROUNDING_ELEMENTS = 80;\n\n/**\n * @typedef {{\n *   element_index?: number;\n *   frame?: { h?: number; w?: number; x?: number; y?: number };\n *   label?: unknown;\n *   [key: string]: unknown;\n * }} GroundingElement\n */\n\n/**\n * Keep the model-facing state aligned with the visible desktop screenshot.\n *\n * @param {unknown[]} elements\n * @returns {GroundingElement[]}\n */\nexport function selectGroundingElements(elements, screen = { width: 1920, height: 1080 }) {\n  return elements\n    .filter((element) => isVisibleLabeledElement(element, screen))\n    .slice(0, MAX_GROUNDING_ELEMENTS);\n}\n\n/**\n * @param {unknown} value\n * @returns {value is GroundingElement}\n */\nfunction isVisibleLabeledElement(value, screen) {\n  if (typeof value !== \"object\" || value === null) return false;\n  const element = /** @type {GroundingElement} */ (value);\n  const frame = element.frame;\n  if (typeof element.label !== \"string\" || element.label.trim().length === 0) return false;\n  if (typeof frame !== \"object\" || frame === null) return false;\n  if (\n    !Number.isFinite(frame.x) ||\n    !Number.isFinite(frame.y) ||\n    !Number.isFinite(frame.w) ||\n    !Number.isFinite(frame.h)\n  ) {\n    return false;\n  }\n\n  const x = /** @type {number} */ (frame.x);\n  const y = /** @type {number} */ (frame.y);\n  const width = /** @type {number} */ (frame.w);\n  const height = /** @type {number} */ (frame.h);\n  return (\n    width > 0 &&\n    height > 0 &&\n    x < screen.width &&\n    y < screen.height &&\n    x + width > 0 &&\n    y + height > 0\n  );\n}\n";
 export declare const TYPING_MJS_SOURCE = "const DEMO_TYPING_SPEED = 1.2;\nconst MIN_DELAY_MS = 35;\nconst MAX_DELAY_MS = 220;\n\nexport function naturalTypingPlan(text) {\n  const graphemes = [...new Intl.Segmenter().segment(text)].map(({ segment }) => segment);\n  let state = hashText(text) || 1;\n  return graphemes.map((grapheme, index) => {\n    state = nextState(state);\n    return {\n      grapheme,\n      delayMs: index === graphemes.length - 1 ? 0 : naturalDelay(grapheme, state),\n    };\n  });\n}\n\nfunction naturalDelay(grapheme, state) {\n  const jitter = state / 0x1_0000_0000;\n  const range = delayRange(grapheme);\n  return Math.round((range.min + (range.max - range.min) * jitter) / DEMO_TYPING_SPEED);\n}\n\nfunction delayRange(grapheme) {\n  if (/\\s/u.test(grapheme)) return { min: 75, max: 125 };\n  if (/[.!?]/u.test(grapheme)) return { min: 145, max: MAX_DELAY_MS };\n  if (/[/|;&]/u.test(grapheme)) return { min: 105, max: 175 };\n  if (/[-_=,:]/u.test(grapheme)) return { min: 70, max: 125 };\n  return { min: MIN_DELAY_MS, max: 85 };\n}\n\nfunction hashText(text) {\n  let hash = 2166136261;\n  for (const character of text) {\n    hash ^= character.codePointAt(0);\n    hash = Math.imul(hash, 16777619);\n  }\n  return hash >>> 0;\n}\n\nfunction nextState(state) {\n  let value = state;\n  value ^= value << 13;\n  value ^= value >>> 17;\n  value ^= value << 5;\n  return value >>> 0;\n}\n";
 export declare const POINTER_MOTION_MJS_SOURCE = "const FRAME_MS = 16;\n\nexport function pointerMotionPlan(start, end, options = {}) {\n  const style = options.style ?? \"natural\";\n  const distance = Math.hypot(end.x - start.x, end.y - start.y);\n  const durationMs = options.durationMs ?? naturalDuration(distance, style);\n  if (distance < 2 || durationMs === 0) {\n    return { phases: [[{ ...end, delayMs: 0 }]], settleMs: 0 };\n  }\n\n  if (style === \"precision\" && distance >= 120) {\n    const ratio = 0.92 + deterministicUnit(start, end, 7) * 0.04;\n    const undershoot = {\n      x: Math.round(start.x + (end.x - start.x) * ratio),\n      y: Math.round(start.y + (end.y - start.y) * ratio),\n    };\n    // Cover most of the distance quickly, then spend a disproportionate\n    // share of the duration continuously correcting the final 4\u20138%.\n    const firstDuration = Math.round(durationMs * 0.62);\n    return {\n      phases: [\n        bezierPhase(start, undershoot, firstDuration, \"natural\", 11),\n        bezierPhase(undershoot, end, durationMs - firstDuration, \"precision\", 23),\n      ],\n      settleMs: 0,\n    };\n  }\n\n  return {\n    phases: [bezierPhase(start, end, durationMs, style, 17)],\n    settleMs: style === \"natural\" ? 15 + Math.round(deterministicUnit(start, end, 31) * 15) : 0,\n  };\n}\n\nfunction bezierPhase(start, end, durationMs, style, salt) {\n  const distance = Math.hypot(end.x - start.x, end.y - start.y);\n  const steps = Math.max(2, Math.min(60, Math.round(durationMs / FRAME_MS)));\n  const perpendicular = unitPerpendicular(start, end);\n  const bendLimit = style === \"precision\" ? 8 : Math.min(70, distance * 0.09);\n  const bend = (deterministicUnit(start, end, salt) * 2 - 1) * bendLimit;\n  const c1 = {\n    x: start.x + (end.x - start.x) * 0.28 + perpendicular.x * bend,\n    y: start.y + (end.y - start.y) * 0.28 + perpendicular.y * bend,\n  };\n  const c2 = {\n    x: start.x + (end.x - start.x) * 0.76 + perpendicular.x * bend * 0.65,\n    y: start.y + (end.y - start.y) * 0.76 + perpendicular.y * bend * 0.65,\n  };\n  const delayMs = durationMs / steps;\n  return Array.from({ length: steps }, (_, index) => {\n    // This asymmetric timing curve accelerates quickly and eases into the\n    // target without the perfectly mirrored feel of smoothstep.\n    const progress = (index + 1) / steps;\n    const t = 1 - (1 - progress) ** 2.35;\n    const point = cubicBezier(start, c1, c2, end, t);\n    return {\n      x: index === steps - 1 ? end.x : Math.round(point.x),\n      y: index === steps - 1 ? end.y : Math.round(point.y),\n      delayMs: index === steps - 1 ? 0 : delayMs,\n    };\n  });\n}\n\nfunction cubicBezier(start, c1, c2, end, t) {\n  const inverse = 1 - t;\n  return {\n    x:\n      inverse ** 3 * start.x +\n      3 * inverse ** 2 * t * c1.x +\n      3 * inverse * t ** 2 * c2.x +\n      t ** 3 * end.x,\n    y:\n      inverse ** 3 * start.y +\n      3 * inverse ** 2 * t * c1.y +\n      3 * inverse * t ** 2 * c2.y +\n      t ** 3 * end.y,\n  };\n}\n\nfunction naturalDuration(distance, style) {\n  const base = style === \"precision\" ? 150 : 110;\n  const scale = style === \"precision\" ? 0.35 : 0.28;\n  const minimum = style === \"precision\" ? 180 : 140;\n  const maximum = style === \"precision\" ? 650 : 550;\n  return Math.round(Math.min(maximum, Math.max(minimum, base + distance * scale)));\n}\n\nfunction unitPerpendicular(start, end) {\n  const dx = end.x - start.x;\n  const dy = end.y - start.y;\n  const length = Math.hypot(dx, dy) || 1;\n  return { x: -dy / length, y: dx / length };\n}\n\nfunction deterministicUnit(start, end, salt) {\n  let value =\n    (Math.imul(Math.round(start.x), 73_856_093) ^\n      Math.imul(Math.round(start.y), 19_349_663) ^\n      Math.imul(Math.round(end.x), 83_492_791) ^\n      Math.imul(Math.round(end.y), 2_654_435_761) ^\n      salt) >>>\n    0;\n  value ^= value << 13;\n  value ^= value >>> 17;\n  value ^= value << 5;\n  return (value >>> 0) / 0x1_0000_0000;\n}\n";
-export declare const PACKAGE_JSON_SOURCE = "{\n  \"name\": \"computer-use-driver\",\n  \"private\": true,\n  \"type\": \"module\",\n  \"dependencies\": {\n    \"@trycua/cua-driver\": \"0.12.5\"\n  }\n}\n";
 export declare const COMPUTER_USE_DRIVER_SOURCES: {
     readonly "server.mjs": "import { setTimeout as delay } from \"node:timers/promises\";\nimport { execFile, execFileSync } from \"node:child_process\";\nimport { randomUUID } from \"node:crypto\";\nimport { chmod, rename, rm } from \"node:fs/promises\";\nimport { promisify } from \"node:util\";\nimport http from \"node:http\";\nimport { env } from \"node:process\";\nimport { dirname, resolve } from \"node:path\";\n\nimport { CuaDriver } from \"@trycua/cua-driver\";\n\nimport { pointerMotionPlan } from \"./pointer-motion.mjs\";\nimport { selectGroundingElements } from \"./state.mjs\";\nimport { naturalTypingPlan } from \"./typing.mjs\";\n\nconst socketPath = env.COMPUTER_USE_SOCKET_PATH;\nconst workspaceRoot = env.COMPUTER_USE_ROOT;\nconst maxRequestBytes = 32 * 1024;\nconst maxRequestMs = 120_000;\nconst maxRecordingMs = 300_000;\nconst nativeCallTimeoutMs = 10_000;\n// Only the queue owner sets this signal; recording finalization deliberately bypasses it.\nlet requestSignal;\nconst desktopMargin = 24;\nconst minimumWindow = { height: 240, width: 480 };\nconst layoutTolerance = { height: 8, width: 8, x: 4, y: 4 };\nconst maxClipboardBytes = 10_000;\nconst driver = await CuaDriver.create({ claudeCodeCompatibility: false });\nconst execFilePromise = promisify(execFile);\nfunction execFileAsync(file, args, options) {\n  return execFilePromise(file, args, {\n    timeout: nativeCallTimeoutMs,\n    ...options,\n    signal: requestSignal,\n  });\n}\n\nlet activeRecording = null;\nlet queue = Promise.resolve();\nlet shuttingDown = false;\n\nawait rm(socketPath, { force: true });\n\nconst server = http.createServer((request, response) => {\n  if (shuttingDown) return response.destroy();\n  if (request.method !== \"POST\" || request.url !== \"/call\") {\n    sendJson(response, 404, { error: \"not found\" });\n    return;\n  }\n  const controller = new AbortController();\n  const deadline = Number(request.headers[\"x-computer-use-deadline\"]);\n  const timeoutMs = Number.isFinite(deadline)\n    ? Math.max(0, Math.min(maxRequestMs, deadline - Date.now()))\n    : maxRequestMs;\n  const cancel = () =>\n    controller.abort(new Error(\"computer-use request cancelled or deadline exceeded\"));\n  const timer = setTimeout(cancel, timeoutMs);\n  response.once(\"close\", cancel);\n  controller.signal.addEventListener(\"abort\", () => response.destroy(), { once: true });\n  if (timeoutMs === 0) cancel();\n  // Read immediately: a body may finish or disconnect while another call owns the queue.\n  const body = readBody(request);\n  void body.catch(() => undefined);\n  const task = queue.then(async () => {\n    controller.signal.throwIfAborted();\n    if (shuttingDown) return;\n    requestSignal = controller.signal;\n    try {\n      await handleRequest(await body, response);\n    } finally {\n      requestSignal = undefined;\n    }\n  });\n  queue = task\n    .catch(() => response.destroy())\n    .finally(() => {\n      clearTimeout(timer);\n      response.removeListener(\"close\", cancel);\n    });\n});\n\nserver.listen(socketPath, () => {\n  void chmod(socketPath, 0o600);\n});\n\nfor (const signal of [\"SIGINT\", \"SIGTERM\"]) {\n  process.once(signal, () => {\n    void shutdown();\n  });\n}\n\nasync function shutdown() {\n  if (shuttingDown) return;\n  shuttingDown = true;\n  server.close();\n  server.closeAllConnections();\n  const timer = setTimeout(() => process.exit(1), nativeCallTimeoutMs * 2);\n  let exitCode = 0;\n  try {\n    await queue;\n    if (activeRecording !== null) await stopRecording();\n  } catch {\n    exitCode = 1;\n  } finally {\n    try {\n      await driver.shutdown();\n    } catch {\n      exitCode = 1;\n    } finally {\n      clearTimeout(timer);\n      process.exit(exitCode);\n    }\n  }\n}\n\nasync function handleRequest(body, response) {\n  try {\n    const input = JSON.parse(body);\n    if (input.action === \"health\") {\n      sendJson(response, 200, { backend: \"cua-driver\", version: \"0.12.5\" });\n      return;\n    }\n\n    validateRequest(input);\n    const actionResult = await performAction(input.action);\n    const state = await captureState(input.screenshotPath);\n    sendJson(response, 200, {\n      action: actionResult,\n      backend: \"cua-driver\",\n      screenshot: input.screenshotPath,\n      state,\n      version: \"0.12.5\",\n    });\n  } catch (error) {\n    if (requestSignal?.aborted && activeRecording !== null) {\n      await stopRecording().catch(() => undefined);\n    }\n    sendJson(response, 500, {\n      error: error instanceof Error ? error.message : String(error),\n    });\n  }\n}\n\nasync function performAction(action) {\n  requestSignal?.throwIfAborted();\n  validateActionCoordinates(action);\n  if (action.action === \"sequence\") {\n    const results = [];\n    try {\n      for (const nested of action.actions) {\n        const startedAt = performance.now();\n        const result = await performAction(nested);\n        results.push({\n          action: nested.action,\n          durationMs: Math.round(performance.now() - startedAt),\n          result,\n        });\n      }\n      return results;\n    } catch (error) {\n      // Never strand the durable driver in an active-recording state when a\n      // rehearsed step fails. Preserve the original action error.\n      if (activeRecording !== null) await stopRecording().catch(() => undefined);\n      throw error;\n    }\n  }\n  switch (action.action) {\n    case \"screenshot\":\n      return null;\n    case \"click\":\n      await moveCursor(action);\n      return click(action, 1);\n    case \"double_click\":\n      await moveCursor(action);\n      return click(action, 2);\n    case \"triple_click\":\n      await moveCursor(action);\n      return click(action, 3);\n    case \"drag\":\n      return dragCursor(action);\n    case \"keypress\":\n      return action.keys.length === 1\n        ? call(\"press_key\", {\n            scope: \"desktop\",\n            key: normalizeKey(action.keys[0]),\n          })\n        : call(\"hotkey\", {\n            scope: \"desktop\",\n            keys: action.keys.map(normalizeKey),\n          });\n    case \"move\":\n      return moveCursor(action);\n    case \"scroll\": {\n      await call(\"move_cursor\", {\n        scope: \"desktop\",\n        x: action.x,\n        y: action.y,\n      });\n      const results = [];\n      if (action.scrollY !== 0) {\n        results.push(await call(\"scroll\", scrollInput(action.scrollY, \"up\", \"down\")));\n      }\n      if (action.scrollX !== 0) {\n        results.push(await call(\"scroll\", scrollInput(action.scrollX, \"left\", \"right\")));\n      }\n      return results;\n    }\n    case \"type\":\n      return typeText(action);\n    case \"clipboard_read\":\n      return readClipboard(action.selection);\n    case \"clipboard_write\":\n      return writeClipboard(action.selection, action.text);\n    case \"wait\":\n      await sleep(action.durationMs ?? 2_000);\n      return null;\n    case \"arrange_windows\":\n      return arrangeWindows(action);\n    case \"record_start\":\n      return startRecording(action.path);\n    case \"record_stop\":\n      return stopRecording();\n    default:\n      throw new Error(`unsupported computer-use action: ${String(action.action)}`);\n  }\n}\n\nasync function captureState(screenshotPath) {\n  await call(\"get_desktop_state\", { screenshot_out_file: screenshotPath });\n  const pointer = structured(await call(\"get_cursor_position\", {}));\n  const screen = x11ScreenSize();\n  const windows = structured(await call(\"list_windows\", { on_screen_only: true })).windows;\n  const contentWindows = Array.isArray(windows) ? windows.filter(isContentWindow) : [];\n  const groundingWindow = contentWindows.toSorted((left, right) => right.z_index - left.z_index)[0];\n\n  let elements = [];\n  if (groundingWindow !== undefined) {\n    const windowState = structured(\n      await call(\"get_window_state\", {\n        pid: groundingWindow.pid,\n        window_id: groundingWindow.window_id,\n        include_screenshot: false,\n        max_depth: 20,\n        max_elements: 250,\n      }),\n    );\n    if (Array.isArray(windowState.elements)) {\n      elements = selectGroundingElements(windowState.elements, {\n        width: Number(screen.width) || 1920,\n        height: Number(screen.height) || 1080,\n      });\n    }\n  }\n\n  return formatState(groundingWindow, pointer, elements);\n}\n\nasync function startRecording(path) {\n  if (activeRecording !== null) {\n    throw new Error(\"a recording is already active\");\n  }\n\n  const outputDirectory = `${workspaceRoot}/recording-${randomUUID()}`;\n  const result = await call(\n    \"start_recording\",\n    {\n      output_dir: outputDirectory,\n      record_video: true,\n    },\n    false,\n  );\n  activeRecording = {\n    outputDirectory,\n    outputPath: path,\n    stopping: null,\n    timer: setTimeout(() => {\n      void stopRecording().catch(() => {\n        void shutdown();\n      });\n    }, maxRecordingMs),\n  };\n  return result;\n}\n\nasync function stopRecording() {\n  if (activeRecording === null) {\n    throw new Error(\"no recording is active\");\n  }\n\n  const recording = activeRecording;\n  if (recording.stopping !== null) return recording.stopping;\n  clearTimeout(recording.timer);\n  recording.stopping = finalizeRecording(recording);\n  return recording.stopping;\n}\n\nasync function finalizeRecording(recording) {\n  try {\n    const result = await call(\"stop_recording\", {}, false);\n    const output = structured(result);\n    const videoPath =\n      typeof output.last_video_path === \"string\"\n        ? output.last_video_path\n        : recording.outputDirectory + \"/recording.mp4\";\n    await rename(videoPath, recording.outputPath);\n    await rm(recording.outputDirectory, { force: true, recursive: true });\n    return result;\n  } catch (error) {\n    void shutdown();\n    throw error;\n  } finally {\n    activeRecording = null;\n  }\n}\n\nasync function call(name, input, cancellable = true) {\n  const signal = cancellable ? requestSignal : undefined;\n  signal?.throwIfAborted();\n  let timer;\n  const result = await Promise.race([\n    driver.callTool(name, JSON.stringify(input)),\n    new Promise((_, reject) => {\n      timer = setTimeout(() => {\n        // Native calls have no abort API. Do not reuse a driver with uncertain in-flight work.\n        void shutdown();\n        reject(new Error(\"computer-use native call timed out; restart with startComputerUse\"));\n      }, nativeCallTimeoutMs);\n    }),\n  ]).finally(() => clearTimeout(timer));\n  signal?.throwIfAborted();\n  if (result.isError) {\n    throw new Error(\n      `Cua ${name} failed${result.errorCode ? ` (${result.errorCode})` : \"\"}: ${result.text}`,\n    );\n  }\n  return {\n    degraded: result.degraded,\n    structuredJson: result.structuredJson,\n    text: result.text,\n    verified: result.verified,\n  };\n}\n\nfunction structured(result) {\n  if (result.structuredJson === undefined) return {};\n  return JSON.parse(result.structuredJson);\n}\n\nfunction pointerClickInput(x, y, button, count) {\n  return {\n    scope: \"desktop\",\n    x,\n    y,\n    button: button === \"wheel\" ? \"middle\" : button,\n    count,\n  };\n}\n\nasync function moveCursor(action) {\n  if (action.movementStyle === undefined) {\n    return call(\"move_cursor\", { scope: \"desktop\", x: action.x, y: action.y });\n  }\n  const current = structured(await call(\"get_cursor_position\", {}));\n  const start = { x: Number(current.x), y: Number(current.y) };\n  if (!Number.isFinite(start.x) || !Number.isFinite(start.y)) {\n    return call(\"move_cursor\", { scope: \"desktop\", x: action.x, y: action.y });\n  }\n  const options = { style: action.movementStyle };\n  if (action.durationMs !== undefined) options.durationMs = action.durationMs;\n  return followPointerPlan(pointerMotionPlan(start, { x: action.x, y: action.y }, options), \"x11\");\n}\n\nasync function dragCursor(action) {\n  const start = action.path[0];\n  const end = action.path.at(-1);\n  if (action.movementStyle === undefined) {\n    return call(\"drag\", {\n      scope: \"desktop\",\n      from_x: start.x,\n      from_y: start.y,\n      to_x: end.x,\n      to_y: end.y,\n      steps: Math.min(200, Math.max(20, action.path.length * 10)),\n    });\n  }\n  const style = action.movementStyle;\n  const current = structured(await call(\"get_cursor_position\", {}));\n  const currentPoint = { x: Number(current.x), y: Number(current.y) };\n  const approach =\n    Number.isFinite(currentPoint.x) && Number.isFinite(currentPoint.y)\n      ? pointerPlanArgs(pointerMotionPlan(currentPoint, start, { style: \"natural\" }))\n      : [\"mousemove\", String(start.x), String(start.y)];\n  const options = { style };\n  if (action.durationMs !== undefined) options.durationMs = action.durationMs;\n  const drag = pointerPlanArgs(pointerMotionPlan(start, end, options));\n  return xdotool([\n    ...approach,\n    \"sleep\",\n    \"0.025\",\n    \"mousedown\",\n    \"1\",\n    \"sleep\",\n    \"0.030\",\n    ...drag,\n    \"sleep\",\n    \"0.030\",\n    \"mouseup\",\n    \"1\",\n  ]);\n}\n\nasync function followPointerPlan(plan, backend = \"cua\") {\n  if (backend === \"x11\") return xdotool(pointerPlanArgs(plan));\n  const results = [];\n  for (let phaseIndex = 0; phaseIndex < plan.phases.length; phaseIndex += 1) {\n    for (const point of plan.phases[phaseIndex]) {\n      results.push(await call(\"move_cursor\", { scope: \"desktop\", x: point.x, y: point.y }));\n      if (point.delayMs > 0) await sleep(point.delayMs);\n    }\n    if (phaseIndex < plan.phases.length - 1 && plan.settleMs > 0) await sleep(plan.settleMs);\n  }\n  if (plan.phases.length === 1 && plan.settleMs > 0) await sleep(plan.settleMs);\n  return results;\n}\n\nfunction pointerPlanArgs(plan) {\n  const args = [];\n  for (let phaseIndex = 0; phaseIndex < plan.phases.length; phaseIndex += 1) {\n    for (const point of plan.phases[phaseIndex]) {\n      args.push(\"mousemove\", String(point.x), String(point.y));\n      if (point.delayMs > 0) args.push(\"sleep\", (point.delayMs / 1000).toFixed(3));\n    }\n    if (phaseIndex < plan.phases.length - 1 && plan.settleMs > 0) {\n      args.push(\"sleep\", (plan.settleMs / 1000).toFixed(3));\n    }\n  }\n  if (plan.phases.length === 1 && plan.settleMs > 0) {\n    args.push(\"sleep\", (plan.settleMs / 1000).toFixed(3));\n  }\n  return args;\n}\n\nasync function xdotool(args) {\n  const plannedSleepMs = args.reduce(\n    (total, value, index) => (args[index - 1] === \"sleep\" ? total + Number(value) * 1000 : total),\n    0,\n  );\n  const timeout = Math.max(2_000, Math.ceil(plannedSleepMs + 1_500));\n  const result = await execFileAsync(\"xdotool\", args, { env: displayEnv(), timeout });\n  return {\n    plannedSleepMs: Math.round(plannedSleepMs),\n    stderr: result.stderr,\n    stdout: result.stdout,\n  };\n}\n\nfunction typingPlan(action) {\n  if (action.typingStyle === \"natural\") return naturalTypingPlan(action.text);\n  return [...new Intl.Segmenter().segment(action.text)].map(({ segment }) => ({\n    grapheme: segment,\n    delayMs: action.typingDelayMs ?? 0,\n  }));\n}\n\nfunction validateTypingBudget(actions) {\n  let characters = 0;\n  let calls = 0;\n  let delayMs = 0;\n  for (const action of actions) {\n    if (action.action !== \"type\") continue;\n    if (typeof action.text !== \"string\" || action.text.length > 10_000) {\n      throw new Error(\"typing text must be at most 10000 characters\");\n    }\n    characters += action.text.length;\n    if (action.typingStyle === undefined && !action.typingDelayMs) continue;\n    const plan = typingPlan(action);\n    calls += plan.length;\n    delayMs += plan.reduce((total, step) => total + step.delayMs, 0);\n  }\n  if (characters > 10_000 || calls > 1_000 || delayMs > 30_000) {\n    throw new Error(\n      \"typing budget exceeded: at most 10000 characters, 1000 paced graphemes and 30000ms delay per request; use unpaced typing for longer text\",\n    );\n  }\n}\n\nasync function typeText(action) {\n  if (action.typingStyle === undefined && !action.typingDelayMs) {\n    return call(\"type_text\", { scope: \"desktop\", text: action.text });\n  }\n  let result;\n  let graphemesTyped = 0;\n  for (const { grapheme, delayMs } of typingPlan(action)) {\n    result = await call(\"type_text\", { scope: \"desktop\", text: grapheme });\n    graphemesTyped += 1;\n    if (delayMs > 0) await sleep(delayMs);\n  }\n  return { graphemesTyped, result };\n}\n\nasync function click(action, count) {\n  if (action.button !== \"back\" && action.button !== \"forward\") {\n    return call(\"click\", pointerClickInput(action.x, action.y, action.button, count));\n  }\n\n  await call(\"move_cursor\", {\n    scope: \"desktop\",\n    x: action.x,\n    y: action.y,\n  });\n  const results = [];\n  for (let index = 0; index < count; index += 1) {\n    results.push(\n      await call(\"hotkey\", {\n        scope: \"desktop\",\n        keys: [\"alt\", action.button === \"back\" ? \"left\" : \"right\"],\n      }),\n    );\n  }\n  return results;\n}\n\nasync function readClipboard(selection) {\n  try {\n    const result = await execFileAsync(\"xclip\", [\"-selection\", xclipSelection(selection), \"-out\"], {\n      env: displayEnv(),\n      maxBuffer: maxClipboardBytes + 1,\n    });\n    if (Buffer.byteLength(result.stdout) > maxClipboardBytes) {\n      throw new Error(`clipboard content exceeds ${maxClipboardBytes} bytes`);\n    }\n    return { selection, text: result.stdout };\n  } catch (error) {\n    if (error instanceof Error && error.message.includes(\"clipboard content exceeds\")) throw error;\n    return { selection, text: \"\" };\n  }\n}\n\nasync function writeClipboard(selection, text) {\n  if (Buffer.byteLength(text) > maxClipboardBytes) {\n    throw new Error(`clipboard content exceeds ${maxClipboardBytes} bytes`);\n  }\n  await new Promise((resolve, reject) => {\n    const child = execFile(\"xclip\", [\"-selection\", xclipSelection(selection), \"-in\"], {\n      env: displayEnv(),\n      timeout: nativeCallTimeoutMs,\n      signal: requestSignal,\n    });\n    child.once(\"error\", reject);\n    child.once(\"exit\", (code) =>\n      code === 0 ? resolve() : reject(new Error(`xclip exited ${code}`)),\n    );\n    child.stdin.end(text);\n  });\n  return { bytes: Buffer.byteLength(text), selection };\n}\n\nfunction xclipSelection(selection) {\n  return selection === \"primary\" ? \"primary\" : \"clipboard\";\n}\n\nasync function arrangeWindows(action) {\n  const scene = validateWindowScene(action.windows);\n  const deadline = Date.now() + action.waitForMs;\n  let resolved = null;\n  while (resolved === null) {\n    const windows = structured(await call(\"list_windows\", { on_screen_only: true })).windows;\n    resolved = resolveSceneWindows(scene, Array.isArray(windows) ? windows : []);\n    if (resolved !== null) break;\n    if (Date.now() >= deadline) {\n      throw new Error(\n        `arrange_windows timed out waiting for: ${missingSceneSelectors(scene, Array.isArray(windows) ? windows : []).join(\", \")}`,\n      );\n    }\n    await sleep(100);\n  }\n\n  // Resolve the complete scene before mutating any window. A missing selector\n  // therefore leaves the existing desktop untouched.\n  for (const item of resolved) {\n    const windowId = String(item.window.window_id);\n    await execFileAsync(\"xdotool\", [\"windowactivate\", \"--sync\", windowId], { env: displayEnv() });\n    await execFileAsync(\n      \"xdotool\",\n      [\"windowmove\", windowId, String(item.bounds.x), String(item.bounds.y)],\n      {\n        env: displayEnv(),\n      },\n    );\n    await execFileAsync(\n      \"xdotool\",\n      [\"windowsize\", windowId, String(item.bounds.width), String(item.bounds.height)],\n      { env: displayEnv() },\n    );\n  }\n\n  let verified = null;\n  let windows = [];\n  for (let attempt = 0; attempt < 10; attempt += 1) {\n    const response = structured(await call(\"list_windows\", { on_screen_only: true })).windows;\n    windows = Array.isArray(response) ? response : [];\n    verified = resolveSceneWindows(scene, windows);\n    if (\n      verified !== null &&\n      verified.every(({ bounds, window }) => approximatelyEqual(bounds, window))\n    ) {\n      return verified.map(layoutResult);\n    }\n    await sleep(100);\n  }\n\n  const screenshotPath = `${workspaceRoot}/layout-failure-${Date.now()}.png`;\n  await call(\"get_desktop_state\", { screenshot_out_file: screenshotPath });\n  const details =\n    verified === null\n      ? { stage: \"selector_resolution\", missing: missingSceneSelectors(scene, windows) }\n      : {\n          stage: \"verification\",\n          tolerance: layoutTolerance,\n          windows: verified.map(layoutResult),\n        };\n  throw new Error(\n    `arrange_windows failed: ${JSON.stringify({ ...details, screenshot: screenshotPath })}`,\n  );\n}\n\nfunction validateWindowScene(windows) {\n  if (!Array.isArray(windows) || windows.length < 1 || windows.length > 4) {\n    throw new Error(\"arrange_windows requires 1 to 4 windows\");\n  }\n  const scene = windows.map((item) => ({ ...item, bounds: regionBounds(item.region) }));\n  const selectors = scene.map((item) => selectorLabel(item.selector));\n  if (new Set(selectors).size !== selectors.length) {\n    throw new Error(\"arrange_windows selectors must be unique\");\n  }\n  for (let left = 0; left < scene.length; left += 1) {\n    for (let right = left + 1; right < scene.length; right += 1) {\n      if (overlaps(scene[left].bounds, scene[right].bounds)) {\n        throw new Error(\"arrange_windows regions must not overlap\");\n      }\n    }\n  }\n  return scene;\n}\n\nfunction desktopBounds() {\n  const screen = x11ScreenSize();\n  return {\n    x: desktopMargin,\n    y: desktopMargin,\n    width: screen.width - desktopMargin * 2,\n    height: screen.height - desktopMargin * 2,\n  };\n}\n\nfunction x11ScreenSize() {\n  // The X server is the source of truth after set_desktop_size. Avoid CUA's\n  // session-oriented get_screen_size contract, which differs from pointer\n  // actions and does not accept scope.\n  const output = execFileSync(\"xdpyinfo\", [\"-display\", \":99\"], {\n    encoding: \"utf8\",\n    timeout: 2_000,\n  });\n  const match = /dimensions:\\s+(\\d+)x(\\d+) pixels/u.exec(output);\n  if (match === null) throw new Error(\"could not determine desktop dimensions\");\n  return { width: Number(match[1]), height: Number(match[2]) };\n}\n\nfunction regionBounds(region) {\n  if (\n    typeof region !== \"object\" ||\n    region === null ||\n    ![region.x, region.y, region.width, region.height].every(Number.isFinite) ||\n    region.x < 0 ||\n    region.y < 0 ||\n    region.width <= 0 ||\n    region.height <= 0 ||\n    region.x + region.width > 1 ||\n    region.y + region.height > 1\n  ) {\n    throw new Error(\"arrange_windows regions must fit within the desktop\");\n  }\n  const desktop = desktopBounds();\n  const left = Math.round(desktop.x + desktop.width * region.x);\n  const top = Math.round(desktop.y + desktop.height * region.y);\n  const right = Math.round(desktop.x + desktop.width * (region.x + region.width));\n  const bottom = Math.round(desktop.y + desktop.height * (region.y + region.height));\n  const bounds = { x: left, y: top, width: right - left, height: bottom - top };\n  if (bounds.width < minimumWindow.width || bounds.height < minimumWindow.height) {\n    throw new Error(\n      `arrange_windows regions must be at least ${minimumWindow.width}x${minimumWindow.height}`,\n    );\n  }\n  return bounds;\n}\n\nfunction resolveSceneWindows(scene, windows) {\n  const resolved = scene.map((item) => {\n    const window = windows.find((candidate) => matchesSelector(candidate, item.selector));\n    return window === undefined ? null : { bounds: item.bounds, window };\n  });\n  return resolved.includes(null) ? null : resolved;\n}\n\nfunction missingSceneSelectors(scene, windows) {\n  return scene\n    .filter((item) => !windows.some((window) => matchesSelector(window, item.selector)))\n    .map((item) => selectorLabel(item.selector));\n}\n\nfunction matchesSelector(window, selector) {\n  const identity = `${window.app_name ?? \"\"}\\n${window.title ?? \"\"}`.toLowerCase();\n  if (selector.app === \"firefox\") return identity.includes(\"firefox\");\n  const title = selector.instance === \"primary\" ? \"terminal 1\" : \"terminal 2\";\n  return identity.includes(title);\n}\n\nfunction selectorLabel(selector) {\n  return selector.app === \"firefox\" ? \"firefox\" : `xterm:${selector.instance}`;\n}\n\nfunction overlaps(left, right) {\n  return (\n    left.x < right.x + right.width &&\n    left.x + left.width > right.x &&\n    left.y < right.y + right.height &&\n    left.y + left.height > right.y\n  );\n}\n\nfunction layoutResult({ bounds, window }) {\n  const observed = {\n    x: Number(window.x),\n    y: Number(window.y),\n    width: Number(window.width),\n    height: Number(window.height),\n  };\n  return {\n    selector: `${window.app_name ?? \"\"}:${window.title ?? \"\"}`,\n    requested: bounds,\n    observed,\n    delta: {\n      x: observed.x - bounds.x,\n      y: observed.y - bounds.y,\n      width: observed.width - bounds.width,\n      height: observed.height - bounds.height,\n    },\n    tolerance: layoutTolerance,\n    title: window.title,\n    window_id: window.window_id,\n  };\n}\n\nfunction displayEnv() {\n  return { ...env, DISPLAY: \":99\" };\n}\n\nfunction approximatelyEqual(bounds, window) {\n  return (\n    Math.abs(bounds.x - window.x) <= layoutTolerance.x &&\n    Math.abs(bounds.y - window.y) <= layoutTolerance.y &&\n    Math.abs(bounds.width - window.width) <= layoutTolerance.width &&\n    Math.abs(bounds.height - window.height) <= layoutTolerance.height\n  );\n}\n\nfunction sleep(milliseconds) {\n  return delay(milliseconds, undefined, { signal: requestSignal });\n}\n\nfunction scrollInput(delta, negativeDirection, positiveDirection) {\n  return {\n    scope: \"desktop\",\n    direction: delta < 0 ? negativeDirection : positiveDirection,\n    amount: Math.min(50, Math.max(1, Math.round(Math.abs(delta) / 100))),\n    by: \"line\",\n  };\n}\n\nfunction normalizeKey(key) {\n  const aliases = {\n    ARROWDOWN: \"down\",\n    ARROWLEFT: \"left\",\n    ARROWRIGHT: \"right\",\n    ARROWUP: \"up\",\n    CMD: \"meta\",\n    COMMAND: \"meta\",\n    CONTROL: \"ctrl\",\n    DEL: \"delete\",\n    ENTER: \"enter\",\n    ESC: \"escape\",\n    OPTION: \"alt\",\n    RETURN: \"enter\",\n  };\n  return aliases[key] ?? key.toLowerCase();\n}\n\nfunction isContentWindow(window) {\n  const identity = `${window.app_name ?? \"\"}\\n${window.title ?? \"\"}`.toLowerCase();\n  return (\n    window.width >= 200 &&\n    window.height >= 100 &&\n    !identity.includes(\"xfce4-panel\") &&\n    !identity.includes(\"xfdesktop\") &&\n    window.title !== \"Desktop\"\n  );\n}\n\nfunction formatState(groundingWindow, pointer, elements) {\n  const lines = [\n    groundingWindow === undefined\n      ? \"grounding_window\\t(none)\"\n      : `grounding_window\\t${groundingWindow.title} pid=${groundingWindow.pid} window_id=${groundingWindow.window_id}`,\n    `pointer\\tx=${pointer.x ?? \"unknown\"} y=${pointer.y ?? \"unknown\"}`,\n    \"accessibility_elements\",\n  ];\n\n  for (const element of elements) {\n    const frame =\n      element.frame === undefined\n        ? \"\"\n        : ` x=${element.frame.x} y=${element.frame.y} width=${element.frame.w} height=${element.frame.h}`;\n    lines.push(\n      `[${element.element_index}] role=${element.role}${frame} label=${JSON.stringify(element.label ?? \"\")}`,\n    );\n  }\n  return lines.join(\"\\n\");\n}\n\nfunction validateActionCoordinates(action) {\n  const screen = x11ScreenSize();\n  const points = [];\n  if ([\"click\", \"double_click\", \"triple_click\", \"move\", \"scroll\"].includes(action.action)) {\n    points.push({ x: action.x, y: action.y });\n  }\n  if (action.action === \"drag\") points.push(...action.path);\n  for (const point of points) {\n    if (\n      !Number.isFinite(point.x) ||\n      !Number.isFinite(point.y) ||\n      point.x < 0 ||\n      point.y < 0 ||\n      point.x >= screen.width ||\n      point.y >= screen.height\n    ) {\n      throw new Error(\n        `computer-use coordinate is outside the ${screen.width}x${screen.height} desktop`,\n      );\n    }\n  }\n}\n\nfunction validateRequest(input) {\n  if (typeof input !== \"object\" || input === null) {\n    throw new Error(\"request must be an object\");\n  }\n  if (!isArtifactPath(input.screenshotPath, \".png\")) {\n    throw new Error(\"screenshot path must be a PNG under the computer-use workspace\");\n  }\n  if (typeof input.action !== \"object\" || input.action === null) {\n    throw new Error(\"request action must be an object\");\n  }\n  const actions = new Set([\n    \"arrange_windows\",\n    \"click\",\n    \"clipboard_read\",\n    \"clipboard_write\",\n    \"double_click\",\n    \"drag\",\n    \"keypress\",\n    \"move\",\n    \"record_start\",\n    \"record_stop\",\n    \"screenshot\",\n    \"scroll\",\n    \"sequence\",\n    \"triple_click\",\n    \"type\",\n    \"wait\",\n  ]);\n  if (!actions.has(input.action.action)) {\n    throw new Error(`unsupported computer-use action: ${String(input.action.action)}`);\n  }\n  if (input.action.action === \"sequence\") {\n    if (\n      !Array.isArray(input.action.actions) ||\n      input.action.actions.length < 1 ||\n      input.action.actions.length > 30\n    ) {\n      throw new Error(\"sequence must contain 1 to 30 actions\");\n    }\n    for (const action of input.action.actions) validateNestedSequenceAction(action);\n  }\n  if (input.action.action === \"arrange_windows\") validateArrangeWindowsAction(input.action);\n  if (input.action.action === \"record_start\" && !isArtifactPath(input.action.path, \".mp4\")) {\n    throw new Error(\"recording path must be an MP4 under the computer-use workspace\");\n  }\n  if (\n    [\"click\", \"double_click\", \"triple_click\", \"drag\", \"move\"].includes(input.action.action) &&\n    \"durationMs\" in input.action &&\n    (!Number.isInteger(input.action.durationMs) ||\n      input.action.durationMs < 0 ||\n      input.action.durationMs > 2000)\n  ) {\n    throw new Error(\"pointer durationMs must be an integer from 0 to 2000\");\n  }\n  validateMovementStyle(input.action, \"\");\n  if (\n    input.action.action === \"wait\" &&\n    (!Number.isInteger(input.action.durationMs) ||\n      input.action.durationMs < 100 ||\n      input.action.durationMs > 10_000)\n  ) {\n    throw new Error(\"wait durationMs must be an integer from 100 to 10000\");\n  }\n  validateClipboardOptions(input.action);\n  validateTypingOptions(input.action, \"\");\n  validateTypingBudget(input.action.action === \"sequence\" ? input.action.actions : [input.action]);\n}\n\nfunction validateNestedSequenceAction(action) {\n  if (typeof action !== \"object\" || action === null)\n    throw new Error(\"sequence action must be an object\");\n  const allowed = new Set([\n    \"arrange_windows\",\n    \"click\",\n    \"double_click\",\n    \"drag\",\n    \"keypress\",\n    \"move\",\n    \"record_start\",\n    \"record_stop\",\n    \"triple_click\",\n    \"type\",\n    \"wait\",\n  ]);\n  if (!allowed.has(action.action))\n    throw new Error(`unsupported sequence action: ${String(action.action)}`);\n  if (action.action === \"arrange_windows\") validateArrangeWindowsAction(action);\n  if (action.action === \"record_start\" && !isArtifactPath(action.path, \".mp4\")) {\n    throw new Error(\"sequence recording path must be an MP4 under the computer-use workspace\");\n  }\n  if (\n    [\"click\", \"double_click\", \"triple_click\", \"drag\", \"move\"].includes(action.action) &&\n    \"durationMs\" in action &&\n    (!Number.isInteger(action.durationMs) || action.durationMs < 0 || action.durationMs > 2000)\n  ) {\n    throw new Error(\"sequence pointer durationMs must be an integer from 0 to 2000\");\n  }\n  validateMovementStyle(action, \"sequence \");\n  if (\n    action.action === \"wait\" &&\n    (!Number.isInteger(action.durationMs) || action.durationMs < 100 || action.durationMs > 10_000)\n  ) {\n    throw new Error(\"sequence wait durationMs must be an integer from 100 to 10000\");\n  }\n  if (action.action === \"type\") validateTypingOptions(action, \"sequence \");\n}\n\nfunction validateMovementStyle(action, prefix) {\n  if (\n    \"movementStyle\" in action &&\n    action.movementStyle !== \"natural\" &&\n    action.movementStyle !== \"precision\"\n  ) {\n    throw new Error(`${prefix}movementStyle must be natural or precision`);\n  }\n  if (\n    action.action === \"drag\" &&\n    \"movementStyle\" in action &&\n    action.movementStyle !== \"precision\"\n  ) {\n    throw new Error(`${prefix}drag movementStyle must be precision`);\n  }\n}\n\nfunction validateClipboardOptions(action) {\n  if (\n    [\"clipboard_read\", \"clipboard_write\"].includes(action.action) &&\n    action.selection !== \"clipboard\" &&\n    action.selection !== \"primary\"\n  ) {\n    throw new Error(\"clipboard selection must be clipboard or primary\");\n  }\n  if (\n    action.action === \"clipboard_write\" &&\n    (typeof action.text !== \"string\" || Buffer.byteLength(action.text) > maxClipboardBytes)\n  ) {\n    throw new Error(`clipboard text must be at most ${maxClipboardBytes} bytes`);\n  }\n}\n\nfunction validateTypingOptions(action, prefix) {\n  if (\n    \"typingDelayMs\" in action &&\n    (!Number.isInteger(action.typingDelayMs) ||\n      action.typingDelayMs < 0 ||\n      action.typingDelayMs > 200)\n  ) {\n    throw new Error(`${prefix}typingDelayMs must be an integer from 0 to 200`);\n  }\n  if (\"typingStyle\" in action && action.typingStyle !== \"natural\") {\n    throw new Error(`${prefix}typingStyle must be natural`);\n  }\n  if (\"typingStyle\" in action && \"typingDelayMs\" in action) {\n    throw new Error(`${prefix}type action cannot set both typingStyle and typingDelayMs`);\n  }\n}\n\nfunction validateArrangeWindowsAction(action) {\n  if (!Number.isInteger(action.waitForMs) || action.waitForMs < 0 || action.waitForMs > 10_000) {\n    throw new Error(\"arrange_windows waitForMs must be an integer from 0 to 10000\");\n  }\n  validateWindowScene(action.windows);\n}\n\nfunction isArtifactPath(value, extension) {\n  if (typeof value !== \"string\" || !value.endsWith(extension)) return false;\n  const path = resolve(value);\n  return dirname(path) === workspaceRoot;\n}\n\nasync function readBody(request) {\n  let body = \"\";\n  for await (const chunk of request) {\n    body += chunk;\n    if (Buffer.byteLength(body) > maxRequestBytes) {\n      throw new Error(\"request exceeds 32 KiB\");\n    }\n  }\n  return body;\n}\n\nfunction sendJson(response, statusCode, body) {\n  if (response.destroyed) return;\n  const json = JSON.stringify(body);\n  response.writeHead(statusCode, {\n    \"content-length\": Buffer.byteLength(json),\n    \"content-type\": \"application/json\",\n  });\n  response.end(json);\n}\n";
     readonly "client.mjs": "import http from \"node:http\";\nimport { env } from \"node:process\";\n\nconst socketPath = env.COMPUTER_USE_SOCKET_PATH;\nconst body = env.COMPUTER_USE_REQUEST;\n\nif (body === undefined) {\n  throw new Error(\"COMPUTER_USE_REQUEST is required\");\n}\n\nconst deadline = Date.now() + 120_000;\nconst response = await new Promise((resolve, reject) => {\n  const request = http.request(\n    {\n      socketPath,\n      method: \"POST\",\n      path: \"/call\",\n      headers: {\n        \"content-length\": Buffer.byteLength(body),\n        \"content-type\": \"application/json\",\n        \"x-computer-use-deadline\": String(deadline),\n      },\n    },\n    (incoming) => {\n      incoming.on(\"error\", reject);\n      incoming.setEncoding(\"utf8\");\n      let responseBody = \"\";\n      incoming.on(\"data\", (chunk) => {\n        responseBody += chunk;\n      });\n      incoming.on(\"end\", () => {\n        resolve({ body: responseBody, statusCode: incoming.statusCode ?? 500 });\n      });\n    },\n  );\n  const timer = setTimeout(\n    () => request.destroy(new Error(\"computer-use request deadline exceeded\")),\n    Math.max(0, deadline - Date.now()),\n  );\n  request.once(\"close\", () => clearTimeout(timer));\n  request.on(\"error\", reject);\n  request.end(body);\n});\n\nif (response.statusCode !== 200) {\n  process.stderr.write(response.body);\n  process.exitCode = 1;\n} else {\n  process.stdout.write(response.body);\n}\n";

package/dist/src/{extensions/code → computer-use}/extension/lib/computer-use-driver-source.js

@@ -1090,61 +1090,6 @@ if (response.statusCode !== 200) {
 } else {
   process.stdout.write(response.body);
 }
-`,STATE_MJS_SOURCE=`const MAX_GROUNDING_ELEMENTS = 80;
-
-/**
- * @typedef {{
- *   element_index?: number;
- *   frame?: { h?: number; w?: number; x?: number; y?: number };
- *   label?: unknown;
- *   [key: string]: unknown;
- * }} GroundingElement
- */
-
-/**
- * Keep the model-facing state aligned with the visible desktop screenshot.
- *
- * @param {unknown[]} elements
- * @returns {GroundingElement[]}
- */
-export function selectGroundingElements(elements, screen = { width: 1920, height: 1080 }) {
-  return elements
-    .filter((element) => isVisibleLabeledElement(element, screen))
-    .slice(0, MAX_GROUNDING_ELEMENTS);
-}
-
-/**
- * @param {unknown} value
- * @returns {value is GroundingElement}
- */
-function isVisibleLabeledElement(value, screen) {
-  if (typeof value !== "object" || value === null) return false;
-  const element = /** @type {GroundingElement} */ (value);
-  const frame = element.frame;
-  if (typeof element.label !== "string" || element.label.trim().length === 0) return false;
-  if (typeof frame !== "object" || frame === null) return false;
-  if (
-    !Number.isFinite(frame.x) ||
-    !Number.isFinite(frame.y) ||
-    !Number.isFinite(frame.w) ||
-    !Number.isFinite(frame.h)
-  ) {
-    return false;
-  }
-
-  const x = /** @type {number} */ (frame.x);
-  const y = /** @type {number} */ (frame.y);
-  const width = /** @type {number} */ (frame.w);
-  const height = /** @type {number} */ (frame.h);
-  return (
-    width > 0 &&
-    height > 0 &&
-    x < screen.width &&
-    y < screen.height &&
-    x + width > 0 &&
-    y + height > 0
-  );
-}
 `,TYPING_MJS_SOURCE=`const DEMO_TYPING_SPEED = 1.2;
 const MIN_DELAY_MS = 35;
 const MAX_DELAY_MS = 220;
@@ -1298,7 +1243,62 @@ function deterministicUnit(start, end, salt) {
   value ^= value << 5;
   return (value >>> 0) / 0x1_0000_0000;
 }
-`,PACKAGE_JSON_SOURCE=`{
+`,COMPUTER_USE_DRIVER_SOURCES={"server.mjs":SERVER_MJS_SOURCE,"client.mjs":CLIENT_MJS_SOURCE,"state.mjs":`const MAX_GROUNDING_ELEMENTS = 80;
+
+/**
+ * @typedef {{
+ *   element_index?: number;
+ *   frame?: { h?: number; w?: number; x?: number; y?: number };
+ *   label?: unknown;
+ *   [key: string]: unknown;
+ * }} GroundingElement
+ */
+
+/**
+ * Keep the model-facing state aligned with the visible desktop screenshot.
+ *
+ * @param {unknown[]} elements
+ * @returns {GroundingElement[]}
+ */
+export function selectGroundingElements(elements, screen = { width: 1920, height: 1080 }) {
+  return elements
+    .filter((element) => isVisibleLabeledElement(element, screen))
+    .slice(0, MAX_GROUNDING_ELEMENTS);
+}
+
+/**
+ * @param {unknown} value
+ * @returns {value is GroundingElement}
+ */
+function isVisibleLabeledElement(value, screen) {
+  if (typeof value !== "object" || value === null) return false;
+  const element = /** @type {GroundingElement} */ (value);
+  const frame = element.frame;
+  if (typeof element.label !== "string" || element.label.trim().length === 0) return false;
+  if (typeof frame !== "object" || frame === null) return false;
+  if (
+    !Number.isFinite(frame.x) ||
+    !Number.isFinite(frame.y) ||
+    !Number.isFinite(frame.w) ||
+    !Number.isFinite(frame.h)
+  ) {
+    return false;
+  }
+
+  const x = /** @type {number} */ (frame.x);
+  const y = /** @type {number} */ (frame.y);
+  const width = /** @type {number} */ (frame.w);
+  const height = /** @type {number} */ (frame.h);
+  return (
+    width > 0 &&
+    height > 0 &&
+    x < screen.width &&
+    y < screen.height &&
+    x + width > 0 &&
+    y + height > 0
+  );
+}
+`,"typing.mjs":TYPING_MJS_SOURCE,"pointer-motion.mjs":POINTER_MOTION_MJS_SOURCE,"package.json":`{
   "name": "computer-use-driver",
   "private": true,
   "type": "module",
@@ -1306,4 +1306,4 @@ function deterministicUnit(start, end, salt) {
     "@trycua/cua-driver": "0.12.5"
   }
 }
-`,COMPUTER_USE_DRIVER_SOURCES={"server.mjs":SERVER_MJS_SOURCE,"client.mjs":CLIENT_MJS_SOURCE,"state.mjs":STATE_MJS_SOURCE,"typing.mjs":TYPING_MJS_SOURCE,"pointer-motion.mjs":POINTER_MOTION_MJS_SOURCE,"package.json":PACKAGE_JSON_SOURCE};export{CLIENT_MJS_SOURCE,COMPUTER_USE_DRIVER_SOURCES,PACKAGE_JSON_SOURCE,POINTER_MOTION_MJS_SOURCE,SERVER_MJS_SOURCE,STATE_MJS_SOURCE,TYPING_MJS_SOURCE};
+`};export{CLIENT_MJS_SOURCE,COMPUTER_USE_DRIVER_SOURCES,POINTER_MOTION_MJS_SOURCE,SERVER_MJS_SOURCE,TYPING_MJS_SOURCE};

package/dist/src/{extensions/code → computer-use}/extension/lib/computer-use-sandbox.js

@@ -1,4 +1,4 @@
-import{shellQuote}from"./shell.js";import{commandFailureDetail}from"./command-failure.js";import{COMPUTER_USE_DRIVER_SOURCES}from"./computer-use-driver-source.js";import{computerUseDisplayCommand,computerUseDriverStartCommand,computerUsePaths}from"./computer-use.js";const COMPUTER_USE_REVALIDATION_KEY=`computer-use:0.12.5:2026-09-17.1`;async function installComputerUse(e){let t=computerUsePaths(e),n=e.resolvePath(`.eve-code/install-computer-use.sh`);await e.run({command:`mkdir -p ${shellQuote(t.driverRoot)}`}),await Promise.all([...Object.entries(COMPUTER_USE_DRIVER_SOURCES).map(([n,r])=>e.writeTextFile({path:`${t.driverRoot}/${n}`,content:r})),e.writeTextFile({path:n,content:computerUseInstallScript(e)})]);let r=await e.run({command:[`set -e`,`if [ "$(id -u)" = 0 ]; then`,`  bash ${shellQuote(n)}`,`elif command -v sudo >/dev/null 2>&1; then`,`  sudo -n bash ${shellQuote(n)}`,`else`,`  echo 'computer-use requires an apt-based sandbox image with root or passwordless sudo' >&2`,`  exit 1`,`fi`].join(`
+import{commandFailureDetail}from"./command-failure.js";import{COMPUTER_USE_DRIVER_SOURCES}from"./computer-use-driver-source.js";import{shellQuote}from"./shell.js";import{computerUseDisplayCommand,computerUseDriverStartCommand,computerUsePaths}from"./computer-use.js";const COMPUTER_USE_REVALIDATION_KEY=`computer-use:0.12.5:2026-09-17.1`;async function installComputerUse(e){let t=computerUsePaths(e),n=e.resolvePath(`.eve-code/install-computer-use.sh`);await e.run({command:`mkdir -p ${shellQuote(t.driverRoot)}`}),await Promise.all([...Object.entries(COMPUTER_USE_DRIVER_SOURCES).map(([n,r])=>e.writeTextFile({path:`${t.driverRoot}/${n}`,content:r})),e.writeTextFile({path:n,content:computerUseInstallScript(e)})]);let r=await e.run({command:[`set -e`,`if [ "$(id -u)" = 0 ]; then`,`  bash ${shellQuote(n)}`,`elif command -v sudo >/dev/null 2>&1; then`,`  sudo -n bash ${shellQuote(n)}`,`else`,`  echo 'computer-use requires an apt-based sandbox image with root or passwordless sudo' >&2`,`  exit 1`,`fi`].join(`
 `)});if(r.exitCode!==0)throw Error(`computer-use installation failed (exit ${r.exitCode}): ${commandFailureDetail(r)}`)}async function startComputerUse(e){let t={TERM:`xterm-256color`},n=await e.run({command:computerUseDisplayCommand(e),env:t});if(n.exitCode!==0)throw Error(`computer-use display startup failed (exit ${n.exitCode}): ${commandFailureDetail(n)}`);let r=await e.run({command:computerUseDriverStartCommand(e),env:t});if(r.exitCode!==0)throw Error(`computer-use driver startup failed (exit ${r.exitCode}): ${commandFailureDetail(r)}`)}function computerUseInstallScript(e){let t=computerUsePaths(e);return`#!/usr/bin/env bash
 set -euo pipefail
 

package/dist/src/{extensions/code → computer-use}/extension/lib/computer-use.d.ts

@@ -19,7 +19,7 @@ type LaunchAction = {
 type DriverAction = {
     action: string;
 } & Record<string, unknown>;
-export interface ComputerUseDriverRequest {
+interface ComputerUseDriverRequest {
     action: DriverAction;
     screenshotPath: string;
 }

package/dist/src/computer-use/extension/lib/sandbox.d.ts

@@ -0,0 +1 @@
+export { COMPUTER_USE_REVALIDATION_KEY, installComputerUse, startComputerUse, } from "./computer-use-sandbox.ts";

package/dist/src/computer-use/extension/lib/sandbox.js

@@ -0,0 +1 @@
+import{COMPUTER_USE_REVALIDATION_KEY,installComputerUse,startComputerUse}from"./computer-use-sandbox.js";export{COMPUTER_USE_REVALIDATION_KEY,installComputerUse,startComputerUse};

package/dist/src/computer-use/extension/lib/shell.d.ts

@@ -0,0 +1 @@
+export declare function shellQuote(value: string): string;

package/dist/src/computer-use/extension/lib/shell.js

@@ -0,0 +1 @@
+function shellQuote(e){return`'${e.replaceAll(`'`,`'"'"'`)}'`}export{shellQuote};

package/dist/src/computer-use/tools.d.ts

@@ -0,0 +1 @@
+export { default as computer_use } from "./extension/tools/computer_use.ts";

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

@@ -0,0 +1 @@
+import computer_use_default from"./extension/tools/computer_use.js";export{computer_use_default as computer_use};

package/dist/src/context/build-base-tool-context.d.ts

@@ -1,7 +1,7 @@
 import type { SessionContext } from "#context/session-context.js";
 import type { ToolExecuteOptions } from "#tools/definition.js";
 /** Base context shared by tool executors. */
-export type BaseToolContext = SessionContext & {
+type BaseToolContext = SessionContext & {
     readonly abortSignal: AbortSignal;
     readonly callId: string;
     readonly toolName: string;
@@ -11,3 +11,4 @@ export declare function buildBaseToolContext(input: {
     readonly options: Pick<ToolExecuteOptions, "abortSignal" | "toolCallId">;
     readonly toolName: string;
 }): BaseToolContext;
+export {};

package/dist/src/context/dynamic-tool-lifecycle.d.ts

@@ -1,13 +1,9 @@
 import type { ModelMessage } from "ai";
 import { type AlsContext } from "#context/container.js";
-import { type CurrentDynamicToolMetadata } from "#context/dynamic-tool-metadata.js";
-import type { HarnessToolDefinition } from "#harness/execute-tool.js";
 import type { SessionStartedStreamEvent, StepStartedStreamEvent, UnstampedMessageStreamEvent } from "#protocol/message.js";
 import { type DynamicToolEntry } from "#tools/dynamic.js";
 import { type DynamicToolCallbackOwner, type DurableDynamicToolCallbacks } from "#tools/durable-callbacks.js";
 import type { ResolvedDynamicToolResolver } from "#runtime/types.js";
-/** Kept as the session-specific entry point for existing runtime consumers. */
-export declare function replayDynamicSessionTools(metadata: readonly CurrentDynamicToolMetadata[], _resolvers: readonly ResolvedDynamicToolResolver[], sessionId: string): readonly HarnessToolDefinition[];
 export declare function validateDurableDynamicToolCallbacks(name: string, entry: DynamicToolEntry, owner: DynamicToolCallbackOwner): DurableDynamicToolCallbacks;
 /** Resolves step-scoped tools once for one internal policy/model pass. */
 export declare function resolveStepDynamicTools(input: {
@@ -41,7 +37,7 @@ export declare function refreshDynamicSessionToolsForRuntimeRevision(input: {
     readonly messages: readonly ModelMessage[];
     readonly runtimeRevision: string;
 }): Promise<void>;
-/** Re-registers callbacks for compiled resolvers that explicitly support cold replay. */
+/** Re-registers missing callbacks while preserving the active turn's persisted tool set. */
 export declare function rebindMissingCompiledDynamicToolCallbacks(input: {
     readonly ctx: AlsContext;
     readonly event: UnstampedMessageStreamEvent;

package/dist/src/context/dynamic-tool-lifecycle.js

@@ -1 +1 @@
-import{createLogger}from"#internal/logging.js";import{contextStorage}from"#context/container.js";import{SessionDynamicToolMetadataKey,SessionDynamicToolRuntimeRevisionKey,SessionIdKey,StepDynamicToolMetadataKey,TurnDynamicToolMetadataKey}from"#context/keys.js";import{toErrorMessage}from"#shared/errors.js";import{parseJsonObject}from"#shared/json.js";import{serializeInputSchema,serializeOutputSchema}from"#tools/schema.js";import{ALLOWED_DYNAMIC_TOOL_EVENTS}from"#dynamic/definition.js";import{isCurrentDynamicToolMetadata,toCurrentDynamicToolMetadataList}from"#context/dynamic-tool-metadata.js";import{clearDurableDynamicCallbacks,hasUnregisteredDurableDynamicCallbacks,readDurableDynamicToolCallbacks,registerDurableDynamicCallback}from"#tools/durable-callbacks.js";import{hasSchemaValidator}from"#tools/durable-schema.js";import{buildResolveContext}from"#context/dynamic-resolve-context.js";import{isWorkflowToolDefinition}from"#tools/workflow-definition.js";import{replayDynamicTools}from"#context/build-dynamic-tools.js";import{isBrandedToolEntry}from"#tools/dynamic.js";const log=createLogger(`dynamic-tools`);function qualifyDynamicToolNames(e,t,n){let r=Object.keys(n);if(r.length===0)return[];if(t){let t=r[0];return[{name:e.slug,entryKey:t,entry:n[t]}]}let i=e.extensionNamespace===void 0?``:`${e.extensionNamespace}__`;return r.map(e=>({entry:n[e],entryKey:e,name:`${i}${e}`}))}function replayDynamicSessionTools(e,t,n){return replayDynamicTools(e,{sessionId:n,scope:`session`})}function durableKeyForEvent(e){switch(e){case`session.started`:return SessionDynamicToolMetadataKey;case`turn.started`:return TurnDynamicToolMetadataKey;case`step.started`:return StepDynamicToolMetadataKey;default:return}}function readDynamicToolResult(e,t){let assertOrdinaryTool=t=>{if(isWorkflowToolDefinition(t))throw Error(`Dynamic tool resolver "${e.logicalPath}" cannot return defineWorkflowTool(). Workflow tools must be static tools; use defineTool() for dynamic entries.`)};if(assertOrdinaryTool(t),isBrandedToolEntry(t))return{entries:{_single:t},isSingle:!0};if(typeof t!=`object`||!t||Array.isArray(t))throw Error(`Dynamic tool resolver "${e.logicalPath}" must return defineTool(), a map of defineTool() values, or null.`);let n={};for(let[r,i]of Object.entries(t)){if(assertOrdinaryTool(i),!isBrandedToolEntry(i))throw Error(`Dynamic tool resolver "${e.logicalPath}" returned "${r}" without defineTool(). Wrap every dynamic tool entry in defineTool().`);n[r]=i}return{entries:n,isSingle:!1}}function validateReference(e){let t=e.phase===`inputSchema`||e.phase===`outputSchema`,n=t?`Write the schema expression inline in defineTool() or use defineDurableSchema() for a provider package.`:`Author the callback inline in transformed source or use an eve durable callback helper.`;if(e.stamped===void 0){if(e.required)throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" does not have a durable descriptor. `+n);return}let r=Object.keys(e.stamped).filter(e=>e!==`closure`&&e!==`callback`);if(r.includes(`stepId`))throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" was persisted by a pre-release eve version that identified callbacks by build offset. Start a new session to re-resolve it.`);if(r.length>0)throw Error(`Dynamic tool "${e.name}" has invalid ${e.phase} callback metadata: unknown key(s) ${r.join(`, `)}.`);if(typeof e.stamped.callback!=`function`)throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" does not have a durable descriptor. `+n);let i;try{i=parseJsonObject(e.stamped.closure)}catch(n){throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" has a non-serializable capture. ${toErrorMessage(n)}`+(t?` Inline the schema construction or reference a stable module-level schema; put only JSON data in its closure.`:``))}return registerDurableDynamicCallback({callback:e.stamped.callback,phase:e.phase,owner:e.owner}),{closure:i}}function validateDurableDynamicToolCallbacks(e,t,n){let r=readDurableDynamicToolCallbacks(t)??{},i=Object.keys(r).filter(e=>e!==`execute`&&e!==`inputSchema`&&e!==`outputSchema`&&e!==`label`&&e!==`approvalKey`&&e!==`approvalRequest`&&e!==`approvalResponse`&&e!==`toModelOutput`);if(i.length>0)throw Error(`Dynamic tool "${e}" has unknown durable callback phase(s): ${i.join(`, `)}.`);let a=t.approval!==void 0,o=t.approval!==void 0&&typeof t.approval!=`function`&&t.approval.response!==void 0,s=validateReference({name:e,owner:n,phase:`execute`,stamped:r.execute,required:!0}),c=validateReference({name:e,owner:n,phase:`labelComplete`,stamped:r.label?.complete,required:!1}),l=validateReference({name:e,owner:n,phase:`labelDelta`,stamped:r.label?.delta,required:!1}),u=validateReference({name:e,owner:n,phase:`labelStart`,stamped:r.label?.start,required:!1}),d=validateReference({name:e,owner:n,phase:`approvalKey`,stamped:r.approvalKey,required:t.approvalKey!==void 0}),f=validateReference({name:e,owner:n,phase:`approvalRequest`,stamped:r.approvalRequest,required:a}),p=validateReference({name:e,owner:n,phase:`approvalResponse`,stamped:r.approvalResponse,required:o}),m=validateReference({name:e,owner:n,phase:`toModelOutput`,stamped:r.toModelOutput,required:t.toModelOutput!==void 0}),h=validateReference({name:e,owner:n,phase:`inputSchema`,stamped:r.inputSchema,required:hasSchemaValidator(t.inputSchema)}),g=validateReference({name:e,owner:n,phase:`outputSchema`,stamped:r.outputSchema,required:hasSchemaValidator(t.outputSchema)}),_={execute:s};return h!==void 0&&(_.inputSchema=h),g!==void 0&&(_.outputSchema=g),(c!==void 0||l!==void 0||u!==void 0)&&(_.label={complete:c,delta:l,start:u}),d!==void 0&&(_.approvalKey=d),f!==void 0&&(_.approvalRequest=f),p!==void 0&&(_.approvalResponse=p),m!==void 0&&(_.toModelOutput=m),_}function createMetadata(e){return{availableInSubagents:e.entry.availableInSubagents,callbacks:validateDurableDynamicToolCallbacks(e.name,e.entry,{sessionId:e.sessionId,scope:e.scope,resolverSlug:e.resolver.slug,entryKey:e.entryKey,name:e.name}),description:e.entry.description,entryKey:e.entryKey,inputSchema:serializeInputSchema(e.entry.inputSchema),name:e.name,outputSchema:serializeOutputSchema(e.entry.outputSchema),resolverSlug:e.resolver.slug}}async function resolveToolsFromEvent(e,t,n,r){let i=e.require(SessionIdKey),a=n.type.split(`.`)[0],o=await Promise.allSettled(t.map(async t=>{let o=t.events[n.type];if(o===void 0)return null;clearDurableDynamicCallbacks(i,{scope:a,resolverSlug:t.slug});try{let s=await o(n,buildResolveContext(e,r));if(s==null)return null;let{entries:c,isSingle:l}=readDynamicToolResult(t,s);return{metadata:qualifyDynamicToolNames(t,l,c).map(({name:e,entryKey:n,entry:r})=>createMetadata({entry:r,entryKey:n,name:e,resolver:t,sessionId:i,scope:a})),resolver:t}}catch(e){throw clearDurableDynamicCallbacks(i,{scope:a,resolverSlug:t.slug}),e}})),s=[],c=new Map;for(let e of o){if(e.status===`rejected`){log.error(`Dynamic tool resolver (${n.type}) failed — skipping its complete result.`,{error:toErrorMessage(e.reason)});continue}if(e.value!==null){for(let t of e.value.metadata){let n=c.get(t.name);if(n!==void 0&&n!==e.value.resolver.slug)throw Error(`Dynamic tool "${t.name}" from resolver "${e.value.resolver.slug}" collides with dynamic resolver "${n}". Namespace the map key manually.`);c.set(t.name,e.value.resolver.slug)}s.push(...e.value.metadata)}}return{metadata:s}}const resolvedStepTools=new WeakMap;function stepCoordinate(e){return`${e.data.turnId}:${String(e.data.stepIndex)}`}function storeResolvedStepTools(e){e.ctx.set(StepDynamicToolMetadataKey,e.metadata);let t=stepCoordinate(e.event);resolvedStepTools.set(e.ctx,{coordinate:t,metadata:e.metadata})}async function resolveStepDynamicTools(e){let t=stepCoordinate(e.event),n=resolvedStepTools.get(e.ctx);if(n?.coordinate===t){e.ctx.set(StepDynamicToolMetadataKey,n.metadata);return}let r=e.resolvers.filter(e=>e.eventNames.includes(`step.started`)),{metadata:i}=r.length===0?{metadata:[]}:await resolveToolsFromEvent(e.ctx,r,e.event,e.messages);storeResolvedStepTools({ctx:e.ctx,event:e.event,metadata:i})}async function preparePersistedStepDynamicToolMetadata(e){let t=e.ctx.get(StepDynamicToolMetadataKey)??[],n=t.filter(isCurrentDynamicToolMetadata);if(n.length===t.length&&!hasUnregisteredDurableDynamicCallbacks(n,{sessionId:e.ctx.require(SessionIdKey),scope:`step`})){n.length>0&&storeResolvedStepTools({ctx:e.ctx,event:e.event,metadata:n});return}await resolveStepDynamicTools(e);let r=e.ctx.get(StepDynamicToolMetadataKey)??[];storeResolvedStepTools({ctx:e.ctx,event:e.event,metadata:toCurrentDynamicToolMetadataList(t,r.filter(isCurrentDynamicToolMetadata))})}async function dispatchDynamicToolEvent(e){if(e.event.type===`session.completed`){let t=e.ctx.get(SessionIdKey);t!==void 0&&clearDurableDynamicCallbacks(t);return}if(!ALLOWED_DYNAMIC_TOOL_EVENTS.has(e.event.type))return;if(e.event.type===`step.started`){await resolveStepDynamicTools({...e,event:e.event});return}e.event.type===`turn.started`&&e.ctx.set(StepDynamicToolMetadataKey,[]);let t=e.resolvers.filter(t=>t.eventNames.includes(e.event.type)),{metadata:n}=t.length===0?{metadata:[]}:await resolveToolsFromEvent(e.ctx,t,e.event,e.messages),r=durableKeyForEvent(e.event.type);if(r===void 0)return;if(e.event.type===`session.started`){e.ctx.set(SessionDynamicToolMetadataKey,n);return}let i=new Set(t.map(e=>e.slug)),a=(e.ctx.get(r)??[]).filter(e=>!i.has(e.resolverSlug));e.ctx.set(r,[...a,...n])}async function refreshDynamicSessionToolsForRuntimeRevision(e){let t=e.ctx.get(SessionDynamicToolMetadataKey)??[],n=t.filter(isCurrentDynamicToolMetadata),r=n.length!==t.length,i=e.ctx.get(SessionDynamicToolRuntimeRevisionKey)!==e.runtimeRevision;if(!i&&!r&&!hasUnregisteredDurableDynamicCallbacks(n,{sessionId:e.ctx.require(SessionIdKey),scope:`session`}))return;let a=e.resolvers.filter(e=>e.eventNames.includes(`session.started`)),{metadata:o}=a.length===0?{metadata:[]}:await resolveToolsFromEvent(e.ctx,a,e.event,e.messages);e.ctx.set(SessionDynamicToolMetadataKey,i?o:toCurrentDynamicToolMetadataList(t,o)),e.ctx.set(SessionDynamicToolRuntimeRevisionKey,e.runtimeRevision)}async function rebindMissingCompiledDynamicToolCallbacks(e){let t=e.ctx.get(TurnDynamicToolMetadataKey)??[],n=t.filter(t=>!isCurrentDynamicToolMetadata(t)||hasUnregisteredDurableDynamicCallbacks([t],{sessionId:e.ctx.require(SessionIdKey),scope:`turn`}));if(n.length===0)return;let r=new Set(n.map(e=>e.resolverSlug)),i=new Set(t.filter(e=>!isCurrentDynamicToolMetadata(e)).map(e=>e.resolverSlug)),a=e.resolvers.filter(e=>r.has(e.slug)&&(i.has(e.slug)||e.rebindMissingCallbacks===!0));if(a.length===0){e.ctx.set(TurnDynamicToolMetadataKey,toCurrentDynamicToolMetadataList(t));return}let o=await contextStorage.run(e.ctx,async()=>await resolveToolsFromEvent(e.ctx,a,e.event,e.messages)),s=toCurrentDynamicToolMetadataList(t,o.metadata);e.ctx.set(TurnDynamicToolMetadataKey,s);let c=s.filter(t=>n.some(e=>e.resolverSlug===t.resolverSlug&&e.name===t.name)&&hasUnregisteredDurableDynamicCallbacks([t],{sessionId:e.ctx.require(SessionIdKey),scope:`turn`}));if(c.length>0)throw Error(`Dynamic tool callback rebind did not restore: ${c.map(e=>e.name).join(`, `)}. The tool may have been renamed or removed.`)}export{dispatchDynamicToolEvent,preparePersistedStepDynamicToolMetadata,rebindMissingCompiledDynamicToolCallbacks,refreshDynamicSessionToolsForRuntimeRevision,replayDynamicSessionTools,resolveStepDynamicTools,validateDurableDynamicToolCallbacks};
+import{createLogger}from"#internal/logging.js";import{contextStorage}from"#context/container.js";import{SessionDynamicToolMetadataKey,SessionDynamicToolRuntimeRevisionKey,SessionIdKey,StepDynamicToolMetadataKey,TurnDynamicToolMetadataKey}from"#context/keys.js";import{toErrorMessage}from"#shared/errors.js";import{parseJsonObject}from"#shared/json.js";import{serializeInputSchema,serializeOutputSchema}from"#tools/schema.js";import{ALLOWED_DYNAMIC_TOOL_EVENTS}from"#dynamic/definition.js";import{isCurrentDynamicToolMetadata,toCurrentDynamicToolMetadataList}from"#context/dynamic-tool-metadata.js";import{clearDurableDynamicCallbacks,hasUnregisteredDurableDynamicCallbacks,readDurableDynamicToolCallbacks,registerDurableDynamicCallback}from"#tools/durable-callbacks.js";import{hasSchemaValidator}from"#tools/durable-schema.js";import{buildResolveContext}from"#context/dynamic-resolve-context.js";import{isWorkflowToolDefinition}from"#tools/workflow-definition.js";import{isBrandedToolEntry}from"#tools/dynamic.js";const log=createLogger(`dynamic-tools`);function qualifyDynamicToolNames(e,t,n){let r=Object.keys(n);if(r.length===0)return[];if(t){let t=r[0];return[{name:e.slug,entryKey:t,entry:n[t]}]}let i=e.extensionNamespace===void 0?``:`${e.extensionNamespace}__`;return r.map(e=>({entry:n[e],entryKey:e,name:`${i}${e}`}))}function durableKeyForEvent(e){switch(e){case`session.started`:return SessionDynamicToolMetadataKey;case`turn.started`:return TurnDynamicToolMetadataKey;case`step.started`:return StepDynamicToolMetadataKey;default:return}}function readDynamicToolResult(e,t){let assertOrdinaryTool=t=>{if(isWorkflowToolDefinition(t))throw Error(`Dynamic tool resolver "${e.logicalPath}" cannot return defineWorkflowTool(). Workflow tools must be static tools; use defineTool() for dynamic entries.`)};if(assertOrdinaryTool(t),isBrandedToolEntry(t))return{entries:{_single:t},isSingle:!0};if(typeof t!=`object`||!t||Array.isArray(t))throw Error(`Dynamic tool resolver "${e.logicalPath}" must return defineTool(), a map of defineTool() values, or null.`);let n={};for(let[r,i]of Object.entries(t)){if(assertOrdinaryTool(i),!isBrandedToolEntry(i))throw Error(`Dynamic tool resolver "${e.logicalPath}" returned "${r}" without defineTool(). Wrap every dynamic tool entry in defineTool().`);n[r]=i}return{entries:n,isSingle:!1}}function validateReference(e){let t=e.phase===`inputSchema`||e.phase===`outputSchema`,n=t?`Write the schema expression inline in defineTool() or use defineDurableSchema() for a provider package.`:`Author the callback inline in transformed source or use an eve durable callback helper.`;if(e.stamped===void 0){if(e.required)throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" does not have a durable descriptor. `+n);return}let r=Object.keys(e.stamped).filter(e=>e!==`closure`&&e!==`callback`);if(r.includes(`stepId`))throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" was persisted by a pre-release eve version that identified callbacks by build offset. Start a new session to re-resolve it.`);if(r.length>0)throw Error(`Dynamic tool "${e.name}" has invalid ${e.phase} callback metadata: unknown key(s) ${r.join(`, `)}.`);if(typeof e.stamped.callback!=`function`)throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" does not have a durable descriptor. `+n);let i;try{i=parseJsonObject(e.stamped.closure)}catch(n){throw Error(`Dynamic tool "${e.name}" callback "${e.phase}" has a non-serializable capture. ${toErrorMessage(n)}`+(t?` Inline the schema construction or reference a stable module-level schema; put only JSON data in its closure.`:``))}return registerDurableDynamicCallback({callback:e.stamped.callback,phase:e.phase,owner:e.owner}),{closure:i}}function validateDurableDynamicToolCallbacks(e,t,n){let r=readDurableDynamicToolCallbacks(t)??{},i=Object.keys(r).filter(e=>e!==`execute`&&e!==`inputSchema`&&e!==`outputSchema`&&e!==`label`&&e!==`approvalKey`&&e!==`approvalRequest`&&e!==`approvalResponse`&&e!==`toModelOutput`);if(i.length>0)throw Error(`Dynamic tool "${e}" has unknown durable callback phase(s): ${i.join(`, `)}.`);let a=t.approval!==void 0,o=t.approval!==void 0&&typeof t.approval!=`function`&&t.approval.response!==void 0,s=validateReference({name:e,owner:n,phase:`execute`,stamped:r.execute,required:!0}),c=validateReference({name:e,owner:n,phase:`labelComplete`,stamped:r.label?.complete,required:!1}),l=validateReference({name:e,owner:n,phase:`labelDelta`,stamped:r.label?.delta,required:!1}),u=validateReference({name:e,owner:n,phase:`labelStart`,stamped:r.label?.start,required:!1}),d=validateReference({name:e,owner:n,phase:`approvalKey`,stamped:r.approvalKey,required:t.approvalKey!==void 0}),f=validateReference({name:e,owner:n,phase:`approvalRequest`,stamped:r.approvalRequest,required:a}),p=validateReference({name:e,owner:n,phase:`approvalResponse`,stamped:r.approvalResponse,required:o}),m=validateReference({name:e,owner:n,phase:`toModelOutput`,stamped:r.toModelOutput,required:t.toModelOutput!==void 0}),h=validateReference({name:e,owner:n,phase:`inputSchema`,stamped:r.inputSchema,required:hasSchemaValidator(t.inputSchema)}),g=validateReference({name:e,owner:n,phase:`outputSchema`,stamped:r.outputSchema,required:hasSchemaValidator(t.outputSchema)}),_={execute:s};return h!==void 0&&(_.inputSchema=h),g!==void 0&&(_.outputSchema=g),(c!==void 0||l!==void 0||u!==void 0)&&(_.label={complete:c,delta:l,start:u}),d!==void 0&&(_.approvalKey=d),f!==void 0&&(_.approvalRequest=f),p!==void 0&&(_.approvalResponse=p),m!==void 0&&(_.toModelOutput=m),_}function createMetadata(e){return{availableInSubagents:e.entry.availableInSubagents,callbacks:validateDurableDynamicToolCallbacks(e.name,e.entry,{sessionId:e.sessionId,scope:e.scope,resolverSlug:e.resolver.slug,entryKey:e.entryKey,name:e.name}),description:e.entry.description,entryKey:e.entryKey,inputSchema:serializeInputSchema(e.entry.inputSchema),name:e.name,outputSchema:serializeOutputSchema(e.entry.outputSchema),resolverSlug:e.resolver.slug}}async function resolveToolsFromEvent(e,t,n,r){let i=e.require(SessionIdKey),a=n.type.split(`.`)[0],o=await Promise.allSettled(t.map(async t=>{let o=t.events[n.type];if(o===void 0)return null;clearDurableDynamicCallbacks(i,{scope:a,resolverSlug:t.slug});try{let s=await o(n,buildResolveContext(e,r));if(s==null)return null;let{entries:c,isSingle:l}=readDynamicToolResult(t,s);return{metadata:qualifyDynamicToolNames(t,l,c).map(({name:e,entryKey:n,entry:r})=>createMetadata({entry:r,entryKey:n,name:e,resolver:t,sessionId:i,scope:a})),resolver:t}}catch(e){throw clearDurableDynamicCallbacks(i,{scope:a,resolverSlug:t.slug}),e}})),s=[],c=new Map;for(let e of o){if(e.status===`rejected`){log.error(`Dynamic tool resolver (${n.type}) failed — skipping its complete result.`,{error:toErrorMessage(e.reason)});continue}if(e.value!==null){for(let t of e.value.metadata){let n=c.get(t.name);if(n!==void 0&&n!==e.value.resolver.slug)throw Error(`Dynamic tool "${t.name}" from resolver "${e.value.resolver.slug}" collides with dynamic resolver "${n}". Namespace the map key manually.`);c.set(t.name,e.value.resolver.slug)}s.push(...e.value.metadata)}}return{metadata:s}}const resolvedStepTools=new WeakMap;function stepCoordinate(e){return`${e.data.turnId}:${String(e.data.stepIndex)}`}function storeResolvedStepTools(e){e.ctx.set(StepDynamicToolMetadataKey,e.metadata);let t=stepCoordinate(e.event);resolvedStepTools.set(e.ctx,{coordinate:t,metadata:e.metadata})}async function resolveStepDynamicTools(e){let t=stepCoordinate(e.event),n=resolvedStepTools.get(e.ctx);if(n?.coordinate===t){e.ctx.set(StepDynamicToolMetadataKey,n.metadata);return}let r=e.resolvers.filter(e=>e.eventNames.includes(`step.started`)),{metadata:i}=r.length===0?{metadata:[]}:await resolveToolsFromEvent(e.ctx,r,e.event,e.messages);storeResolvedStepTools({ctx:e.ctx,event:e.event,metadata:i})}async function preparePersistedStepDynamicToolMetadata(e){let t=e.ctx.get(StepDynamicToolMetadataKey)??[],n=t.filter(isCurrentDynamicToolMetadata);if(n.length===t.length&&!hasUnregisteredDurableDynamicCallbacks(n,{sessionId:e.ctx.require(SessionIdKey),scope:`step`})){n.length>0&&storeResolvedStepTools({ctx:e.ctx,event:e.event,metadata:n});return}await resolveStepDynamicTools(e);let r=e.ctx.get(StepDynamicToolMetadataKey)??[];storeResolvedStepTools({ctx:e.ctx,event:e.event,metadata:toCurrentDynamicToolMetadataList(t,r.filter(isCurrentDynamicToolMetadata))})}async function dispatchDynamicToolEvent(e){if(e.event.type===`session.completed`){let t=e.ctx.get(SessionIdKey);t!==void 0&&clearDurableDynamicCallbacks(t);return}if(!ALLOWED_DYNAMIC_TOOL_EVENTS.has(e.event.type))return;if(e.event.type===`step.started`){await resolveStepDynamicTools({...e,event:e.event});return}e.event.type===`turn.started`&&e.ctx.set(StepDynamicToolMetadataKey,[]);let t=e.resolvers.filter(t=>t.eventNames.includes(e.event.type)),{metadata:n}=t.length===0?{metadata:[]}:await resolveToolsFromEvent(e.ctx,t,e.event,e.messages),r=durableKeyForEvent(e.event.type);if(r===void 0)return;if(e.event.type===`session.started`){e.ctx.set(SessionDynamicToolMetadataKey,n);return}let i=new Set(t.map(e=>e.slug)),a=(e.ctx.get(r)??[]).filter(e=>!i.has(e.resolverSlug));e.ctx.set(r,[...a,...n])}async function refreshDynamicSessionToolsForRuntimeRevision(e){let t=e.ctx.get(SessionDynamicToolMetadataKey)??[],n=t.filter(isCurrentDynamicToolMetadata),r=n.length!==t.length,i=e.ctx.get(SessionDynamicToolRuntimeRevisionKey)!==e.runtimeRevision;if(!i&&!r&&!hasUnregisteredDurableDynamicCallbacks(n,{sessionId:e.ctx.require(SessionIdKey),scope:`session`}))return;let a=e.resolvers.filter(e=>e.eventNames.includes(`session.started`)),{metadata:o}=a.length===0?{metadata:[]}:await resolveToolsFromEvent(e.ctx,a,e.event,e.messages);e.ctx.set(SessionDynamicToolMetadataKey,i?o:toCurrentDynamicToolMetadataList(t,o)),e.ctx.set(SessionDynamicToolRuntimeRevisionKey,e.runtimeRevision)}async function rebindMissingCompiledDynamicToolCallbacks(e){let t=e.ctx.get(TurnDynamicToolMetadataKey)??[],n=t.filter(t=>!isCurrentDynamicToolMetadata(t)||hasUnregisteredDurableDynamicCallbacks([t],{sessionId:e.ctx.require(SessionIdKey),scope:`turn`}));if(n.length===0)return;let r=new Set(n.map(e=>e.resolverSlug)),i=e.resolvers.filter(e=>r.has(e.slug)),a=new Set(i.filter(e=>e.rebindMissingCallbacks===!0).map(e=>e.slug)),o=new Set(t.filter(e=>!isCurrentDynamicToolMetadata(e)).map(e=>e.resolverSlug));if(i.length===0){e.ctx.set(TurnDynamicToolMetadataKey,toCurrentDynamicToolMetadataList(t));return}let s=await contextStorage.run(e.ctx,async()=>await resolveToolsFromEvent(e.ctx,i,e.event,e.messages)),c=toCurrentDynamicToolMetadataList(t,s.metadata);e.ctx.set(TurnDynamicToolMetadataKey,c);let l=c.filter(t=>(a.has(t.resolverSlug)||o.has(t.resolverSlug))&&n.some(e=>e.resolverSlug===t.resolverSlug&&e.name===t.name)&&hasUnregisteredDurableDynamicCallbacks([t],{sessionId:e.ctx.require(SessionIdKey),scope:`turn`}));if(l.length>0)throw Error(`Dynamic tool callback rebind did not restore: ${l.map(e=>e.name).join(`, `)}. The tool may have been renamed or removed.`)}export{dispatchDynamicToolEvent,preparePersistedStepDynamicToolMetadata,rebindMissingCompiledDynamicToolCallbacks,refreshDynamicSessionToolsForRuntimeRevision,resolveStepDynamicTools,validateDurableDynamicToolCallbacks};

package/dist/src/context/dynamic-tool-metadata.d.ts

@@ -39,7 +39,6 @@ export type OldDynamicToolMetadata = OldStepFunctionDynamicToolMetadata | OldSou
 export type PersistedDynamicToolMetadata = CurrentDynamicToolMetadata | OldDynamicToolMetadata;
 export declare function isOldSourceOffsetDynamicToolMetadata(metadata: PersistedDynamicToolMetadata): metadata is OldSourceOffsetDynamicToolMetadata;
 export declare function isCurrentDynamicToolMetadata(metadata: PersistedDynamicToolMetadata): metadata is CurrentDynamicToolMetadata;
-export declare function isOldStepFunctionDynamicToolMetadata(metadata: PersistedDynamicToolMetadata): metadata is OldStepFunctionDynamicToolMetadata;
 /** Converts persisted metadata without changing already-persisted callback closures. */
 export declare function toCurrentDynamicToolMetadata(persisted: PersistedDynamicToolMetadata, resolved?: CurrentDynamicToolMetadata): CurrentDynamicToolMetadata;
 export declare function toCurrentDynamicToolMetadataList(persisted: readonly PersistedDynamicToolMetadata[], resolved?: readonly CurrentDynamicToolMetadata[]): readonly CurrentDynamicToolMetadata[];

package/dist/src/context/dynamic-tool-metadata.js

@@ -1 +1 @@
-function isOldSourceOffsetDynamicToolMetadata(e){return e.callbacks!==void 0&&`stepId`in e.callbacks.execute}function isCurrentDynamicToolMetadata(e){return e.callbacks!==void 0&&!isOldSourceOffsetDynamicToolMetadata(e)}function isOldStepFunctionDynamicToolMetadata(e){return e.callbacks===void 0}function withoutSourceOffset(e){return{closure:e.closure}}function convertSourceOffsetMetadata(e){let t={execute:withoutSourceOffset(e.callbacks.execute),...e.callbacks.approvalRequest===void 0?{}:{approvalRequest:withoutSourceOffset(e.callbacks.approvalRequest)},...e.callbacks.approvalResponse===void 0?{}:{approvalResponse:withoutSourceOffset(e.callbacks.approvalResponse)},...e.callbacks.toModelOutput===void 0?{}:{toModelOutput:withoutSourceOffset(e.callbacks.toModelOutput)}};return{...e,callbacks:t}}function toCurrentDynamicToolMetadata(e,t){if(isCurrentDynamicToolMetadata(e))return e;if(t===void 0)throw Error(`Dynamic tool "${e.name}" uses old persisted metadata, but its resolver did not return a current replacement.`);if(t.resolverSlug!==e.resolverSlug||t.name!==e.name)throw Error(`Dynamic tool "${e.name}" received current metadata from a different resolver or tool.`);if(!isOldStepFunctionDynamicToolMetadata(e)){for(let n of Object.keys(e.callbacks))if(t.callbacks[n]===void 0)throw Error(`Dynamic tool "${e.name}" lost its ${n} callback while converting old persisted metadata.`);return convertSourceOffsetMetadata(e)}if(e.approvalResponseStepFnName!==void 0&&e.approvalStepFnName===void 0)throw Error(`Dynamic tool "${e.name}" has an old approval-response callback without an approval-request callback.`);if(e.approvalStepFnName!==void 0&&t.callbacks.approvalRequest===void 0)throw Error(`Dynamic tool "${e.name}" lost its approval-request callback while converting old persisted metadata.`);if(e.approvalResponseStepFnName!==void 0&&t.callbacks.approvalResponse===void 0)throw Error(`Dynamic tool "${e.name}" lost its approval-response callback while converting old persisted metadata.`);return t}function toCurrentDynamicToolMetadataList(e,t=[]){return e.map(e=>toCurrentDynamicToolMetadata(e,t.find(t=>t.resolverSlug===e.resolverSlug&&t.name===e.name)))}export{isCurrentDynamicToolMetadata,isOldSourceOffsetDynamicToolMetadata,isOldStepFunctionDynamicToolMetadata,toCurrentDynamicToolMetadata,toCurrentDynamicToolMetadataList};
+function isOldSourceOffsetDynamicToolMetadata(e){return e.callbacks!==void 0&&`stepId`in e.callbacks.execute}function isCurrentDynamicToolMetadata(e){return e.callbacks!==void 0&&!isOldSourceOffsetDynamicToolMetadata(e)}function isOldStepFunctionDynamicToolMetadata(e){return e.callbacks===void 0}function withoutSourceOffset(e){return{closure:e.closure}}function convertSourceOffsetMetadata(e){let t={execute:withoutSourceOffset(e.callbacks.execute),...e.callbacks.approvalRequest===void 0?{}:{approvalRequest:withoutSourceOffset(e.callbacks.approvalRequest)},...e.callbacks.approvalResponse===void 0?{}:{approvalResponse:withoutSourceOffset(e.callbacks.approvalResponse)},...e.callbacks.toModelOutput===void 0?{}:{toModelOutput:withoutSourceOffset(e.callbacks.toModelOutput)}};return{...e,callbacks:t}}function toCurrentDynamicToolMetadata(e,t){if(isCurrentDynamicToolMetadata(e))return e;if(t===void 0)throw Error(`Dynamic tool "${e.name}" uses old persisted metadata, but its resolver did not return a current replacement.`);if(t.resolverSlug!==e.resolverSlug||t.name!==e.name)throw Error(`Dynamic tool "${e.name}" received current metadata from a different resolver or tool.`);if(!isOldStepFunctionDynamicToolMetadata(e)){for(let n of Object.keys(e.callbacks))if(t.callbacks[n]===void 0)throw Error(`Dynamic tool "${e.name}" lost its ${n} callback while converting old persisted metadata.`);return convertSourceOffsetMetadata(e)}if(e.approvalResponseStepFnName!==void 0&&e.approvalStepFnName===void 0)throw Error(`Dynamic tool "${e.name}" has an old approval-response callback without an approval-request callback.`);if(e.approvalStepFnName!==void 0&&t.callbacks.approvalRequest===void 0)throw Error(`Dynamic tool "${e.name}" lost its approval-request callback while converting old persisted metadata.`);if(e.approvalResponseStepFnName!==void 0&&t.callbacks.approvalResponse===void 0)throw Error(`Dynamic tool "${e.name}" lost its approval-response callback while converting old persisted metadata.`);return t}function toCurrentDynamicToolMetadataList(e,t=[]){return e.map(e=>toCurrentDynamicToolMetadata(e,t.find(t=>t.resolverSlug===e.resolverSlug&&t.name===e.name)))}export{isCurrentDynamicToolMetadata,isOldSourceOffsetDynamicToolMetadata,toCurrentDynamicToolMetadata,toCurrentDynamicToolMetadataList};

package/dist/src/context/hook-lifecycle.d.ts

@@ -3,12 +3,13 @@ import type { RuntimeHookRegistry } from "#runtime/hooks/registry.js";
 import type { ContextContainer } from "./container.js";
 /**
  * Fans one runtime stream event out to every matching subscriber.
- * Errors propagate — harness error paths convert them into the
- * recoverable `turn.failed` cascade. Caller must hold an active ALS
- * scope so hooks see the same context as the rest of the step.
+ * Authored handler failures are logged independently. Caller must hold an
+ * active ALS scope so hooks see the same context as the rest of the step.
  */
 export declare function dispatchStreamEventHooks(input: {
     readonly ctx: ContextContainer;
     readonly registry: RuntimeHookRegistry;
     readonly event: MessageStreamEvent;
+    /** Stops the running turn for `ctx.cancel()`; `undefined` when this event cannot stop one. */
+    readonly cancelTurn: (() => void) | undefined;
 }): Promise<void>;

package/dist/src/context/hook-lifecycle.js

@@ -1 +1 @@
-import{ContinuationTokenKey}from"./keys.js";import{getAdapterKind}from"#channel/adapter.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";import{BoundaryHookError}from"#shared/boundary-hook-error.js";async function dispatchStreamEventHooks(e){let t=e.registry.streamEventsByType.get(e.event.type)??[],n=e.registry.streamEventsWildcard;if(t.length===0&&n.length===0)return;let r=buildHookContext(e.ctx);try{for(let n of t)await n.handler(e.event,r);for(let t of n)await t.handler(e.event,r)}catch(t){throw e.event.type===`turn.started`||e.event.type===`step.started`?new BoundaryHookError(t):t}}function buildHookContext(e){let t=e.require(BundleKey),n=e.get(ChannelKey),r=e.get(ContinuationTokenKey),i=n===void 0?void 0:getAdapterKind(n);return{...buildCallbackContext(),agent:{name:t.turnAgent.id,nodeId:t.nodeId},channel:{kind:i,continuationToken:r}}}export{dispatchStreamEventHooks};
+import{ContinuationTokenKey}from"./keys.js";import{createLogger,logError}from"#internal/logging.js";import{getAdapterKind}from"#channel/adapter.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{BundleKey,ChannelKey}from"#runtime/sessions/runtime-context-keys.js";const log=createLogger(`hooks`);async function dispatchStreamEventHooks(e){let t=e.registry.streamEventsByType.get(e.event.type)??[],n=e.registry.streamEventsWildcard;if(t.length===0&&n.length===0)return;let r=buildHookContext(e.ctx),i=!0;for(let a of[...t,...n]){let t={...r,cancel:()=>{if(i&&e.cancelTurn!==void 0){e.cancelTurn();return}log.warn(i?`ctx.cancel() ignored: the event is not part of a running turn`:`ctx.cancel() ignored: the event's hooks already returned`,{hook:a.slug,eventId:e.event.meta.id,eventType:e.event.type,sessionId:r.session.id})}};try{await a.handler(e.event,t)}catch(t){logError(log,`stream event hook failed`,t,{hook:a.slug,subscription:a.eventType,eventId:e.event.meta.id,eventType:e.event.type,sessionId:r.session.id})}}i=!1}function buildHookContext(e){let t=e.require(BundleKey),n=e.get(ChannelKey),r=e.get(ContinuationTokenKey),i=n===void 0?void 0:getAdapterKind(n);return{...buildCallbackContext(),agent:{name:t.turnAgent.id,nodeId:t.nodeId},channel:{kind:i,continuationToken:r}}}export{dispatchStreamEventHooks};

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

@@ -45,11 +45,3 @@ export declare function dispatchMemoryTurnCompleted(input: {
     readonly messages: readonly ModelMessage[];
     readonly instrumentation?: MemoryInstrumentation;
 }): Promise<void>;
-export declare function memoryOperationId(input: {
-    readonly phase: string;
-    readonly sequence: number;
-    readonly sessionId: string;
-    readonly slot: string;
-    readonly stepIndex?: number;
-    readonly turnId: string | null;
-}): string;

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

@@ -1 +1 @@
-import{createLogger}from"#internal/logging.js";import{PendingMemoryCommitKey,PreparedMemoryCompactionKey,PreparedMemoryPreambleKey,TurnMemoryLocksKey}from"#context/keys.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{buildResolveContext}from"#context/dynamic-resolve-context.js";import{isEveDevEnvironment}from"#internal/application/dev-environment.js";import{defaultNamespace}from"#public/memory/index.js";import{instrumentMemoryOperation}from"#instrumentation/memory.js";import{applyMemoryRecallBatches,createMemoryLock,projectMemoryHistory,validateMemoryRecallResult}from"#shared/memory-state.js";const fallbackAbortSignal=new AbortController().signal,log=createLogger(`memory`);function prepareMemoryPreamble(e,t){e.setVirtualContext(PreparedMemoryPreambleKey,t)}async function dispatchMemoryTurnStarted(e){let t=e.ctx.get(PreparedMemoryPreambleKey);if(t===void 0)return[];let n=Object.freeze({id:e.event.data.turnId,input:Object.freeze([...t.input]),sequence:e.event.data.sequence}),r=Object.fromEntries((await Promise.all([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async t=>{let r=await resolveMemoryLock({abortSignal:e.abortSignal??fallbackAbortSignal,appRoot:e.appRoot,ctx:e.ctx,memory:t,nodeId:e.nodeId,turn:n});return r===null?null:[t.slot,r]}))).filter(e=>e!==null));e.ctx.set(TurnMemoryLocksKey,r);let i=projectMemoryHistory({locks:r,messages:t.history}),a=buildCallbackContext(),o=(await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async t=>{let o=r[t.slot];if(o===void 0)return null;let s=memoryOperationId({phase:`turn.started`,sequence:e.event.data.sequence,sessionId:a.session.id,slot:t.slot,turnId:n.id});return{lock:o,messages:await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:s,operationName:`search_memory`,phase:`turn.started`,slot:t.slot,storeId:o.scope.key,turnId:n.id}),async()=>{let r=await t.provider.recall[`turn.started`]({...a,abortSignal:e.abortSignal??fallbackAbortSignal,memory:{scope:o.scope,slot:t.slot},messages:i,operationId:s,turn:n}),c=validateMemoryRecallResult(r,t.slot);return{outputRecords:memoryRecords(r),recordCount:c.length,value:c}}),operationId:s}}))).filter(e=>e!==null),s=applyMemoryRecallBatches({batches:o,history:t.history,state:t.state}),c=[...projectMemoryHistory({locks:r,messages:s.history}),...t.input],l=t.projector?.({messages:c,state:s.state})??c;return e.ctx.setVirtualContext(PendingMemoryCommitKey,{history:s.history,projectedMessages:l,state:s.state}),l}function drainMemoryCommit(e){let t=e.get(PendingMemoryCommitKey);return e.delete(PendingMemoryCommitKey),e.delete(PreparedMemoryPreambleKey),t}function prepareMemoryCompaction(e,t){e.setVirtualContext(PreparedMemoryCompactionKey,t)}async function dispatchMemoryCompactionRequested(e){let t=buildCallbackContext(),n=await resolveCompactionLocks(e);e.ctx.set(TurnMemoryLocksKey,n);let r=e.event.data.turnId.length===0?null:firstLockedTurn(n);await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async i=>{let a=n[i.slot],o=i.provider.capture?.[`compaction.requested`];if(a===void 0||o===void 0)return;let s=memoryOperationId({phase:`compaction.requested`,sequence:e.event.data.sequence,sessionId:t.session.id,slot:i.slot,stepIndex:e.event.data.stepIndex,turnId:r?.id??null});await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:s,operationName:`upsert_memory`,phase:`compaction.requested`,slot:i.slot,storeId:a.scope.key,turnId:r?.id}),async()=>(await o({...t,abortSignal:e.abortSignal??fallbackAbortSignal,compaction:{modelId:e.event.data.modelId,usageInputTokens:e.event.data.usageInputTokens},memory:{scope:a.scope,slot:i.slot},messages:e.messages,operationId:s,turn:r}),{value:void 0}))}))}async function dispatchMemoryCompactionCompleted(e){let t=e.ctx.get(PreparedMemoryCompactionKey),n=t?.history??e.messages,r=e.ctx.get(TurnMemoryLocksKey)??{},i=projectMemoryHistory({locks:r,messages:n}),a=buildCallbackContext(),o=e.event.data.turnId.length===0?null:firstLockedTurn(r),s=(await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async t=>{let n=r[t.slot],s=t.provider.recall[`compaction.completed`];if(n===void 0||s===void 0)return null;let c=memoryOperationId({phase:`compaction.completed`,sequence:e.event.data.sequence,sessionId:a.session.id,slot:t.slot,stepIndex:e.event.data.stepIndex,turnId:o?.id??null});return{lock:n,messages:await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:c,operationName:`search_memory`,phase:`compaction.completed`,slot:t.slot,storeId:n.scope.key,turnId:o?.id}),async()=>{let r=await s({...a,abortSignal:e.abortSignal??fallbackAbortSignal,compaction:{modelId:e.event.data.modelId},memory:{scope:n.scope,slot:t.slot},messages:i,operationId:c,turn:o}),l=validateMemoryRecallResult(r,t.slot);return{outputRecords:memoryRecords(r),recordCount:l.length,value:l}}),operationId:c}}))).filter(e=>e!==null),c=applyMemoryRecallBatches({batches:s,history:n,state:t?.state}),l=projectMemoryHistory({locks:r,messages:c.history});return e.ctx.setVirtualContext(PendingMemoryCommitKey,{history:c.history,projectedMessages:l,state:c.state}),e.ctx.delete(PreparedMemoryCompactionKey),l}async function dispatchMemoryTurnCompleted(e){let t=e.ctx.get(TurnMemoryLocksKey)??{},n=buildCallbackContext(),r=projectMemoryHistory({locks:t,messages:e.messages});await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async i=>{let a=t[i.slot],o=i.provider.capture?.[`turn.completed`];if(a===void 0||o===void 0)return;let s=memoryOperationId({phase:`turn.completed`,sequence:e.event.data.sequence,sessionId:n.session.id,slot:i.slot,turnId:e.event.data.turnId});await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:s,operationName:`upsert_memory`,phase:`turn.completed`,slot:i.slot,storeId:a.scope.key,turnId:a.turn.id}),async()=>(await o({...n,abortSignal:e.abortSignal??fallbackAbortSignal,memory:{scope:a.scope,slot:i.slot},messages:r,operationId:s,turn:a.turn}),{value:void 0}))}))}async function resolveCompactionLocks(e){let t=e.ctx.get(TurnMemoryLocksKey);if(e.event.data.turnId.length>0&&t!==void 0)return t;let n=Object.freeze({id:``,input:[],sequence:e.event.data.sequence});return Object.fromEntries((await Promise.all(e.memories.map(async t=>{let r=await resolveMemoryLock({abortSignal:e.abortSignal??fallbackAbortSignal,appRoot:e.appRoot,ctx:e.ctx,memory:t,nodeId:e.nodeId,turn:n});return r===null?null:[t.slot,r]}))).filter(e=>e!==null))}function firstLockedTurn(e){return Object.values(e)[0]?.turn??null}async function resolveMemoryLock(e){let t=buildResolveContext(e.ctx,[]),n={abortSignal:e.abortSignal,channel:t.channel,session:t.session},r=typeof e.memory.scope==`function`?await e.memory.scope(n):e.memory.scope;if(r===null)return reportDisabledMemorySlot(e.memory.slot,`scope`),null;let i={appRoot:e.appRoot,node:e.nodeId,slot:e.memory.slot},a=e.memory.namespace===void 0?defaultNamespace(i):typeof e.memory.namespace==`function`?await e.memory.namespace(i):e.memory.namespace;return a===null?(reportDisabledMemorySlot(e.memory.slot,`namespace`),null):createMemoryLock({namespace:a,scope:r,slot:e.memory.slot,turn:e.turn,visibility:e.memory.visibility})}function reportDisabledMemorySlot(e,t){isEveDevEnvironment()&&log.info(`Memory slot is disabled for this operation`,{resolver:t,slot:e})}async function settleMemoryOperations(e){let t=await Promise.allSettled(e),n=[],r;for(let e of t)e.status===`rejected`?r??=e:n.push(e.value);if(r!==void 0)throw r.reason;return n}function memoryOperationId(e){return[`eve-memory-operation-v1`,e.sessionId,String(e.sequence),e.turnId??`standalone`,...e.stepIndex===void 0?[]:[String(e.stepIndex)],e.phase,e.slot].join(`:`)}function memoryInstrumentationOperation(e){return{idempotencyKey:e.operationId,operationName:e.operationName,phase:e.phase,slot:e.slot,storeId:e.storeId,turnId:e.turnId}}function memoryRecords(e){return e==null?[]:e.messages.map(e=>e.id===void 0?{content:e.content}:{content:e.content,id:e.id})}export{dispatchMemoryCompactionCompleted,dispatchMemoryCompactionRequested,dispatchMemoryTurnCompleted,dispatchMemoryTurnStarted,drainMemoryCommit,memoryOperationId,prepareMemoryCompaction,prepareMemoryPreamble};
+import{createLogger}from"#internal/logging.js";import{PendingMemoryCommitKey,PreparedMemoryCompactionKey,PreparedMemoryPreambleKey,TurnMemoryLocksKey}from"#context/keys.js";import{buildCallbackContext}from"#context/build-callback-context.js";import{buildResolveContext}from"#context/dynamic-resolve-context.js";import{isEveDevEnvironment}from"#internal/application/dev-environment.js";import{defaultNamespace}from"#public/memory/index.js";import{instrumentMemoryOperation}from"#instrumentation/memory.js";import{applyMemoryRecallBatches,createMemoryLock,projectMemoryHistory,validateMemoryRecallResult}from"#shared/memory-state.js";const fallbackAbortSignal=new AbortController().signal,log=createLogger(`memory`);function prepareMemoryPreamble(e,t){e.setVirtualContext(PreparedMemoryPreambleKey,t)}async function dispatchMemoryTurnStarted(e){let t=e.ctx.get(PreparedMemoryPreambleKey);if(t===void 0)return[];let n=Object.freeze({id:e.event.data.turnId,input:Object.freeze([...t.input]),sequence:e.event.data.sequence}),r=Object.fromEntries((await Promise.all([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async t=>{let r=await resolveMemoryLock({abortSignal:e.abortSignal??fallbackAbortSignal,appRoot:e.appRoot,ctx:e.ctx,memory:t,nodeId:e.nodeId,turn:n});return r===null?null:[t.slot,r]}))).filter(e=>e!==null));e.ctx.set(TurnMemoryLocksKey,r);let i=projectMemoryHistory({locks:r,messages:t.history}),a=buildCallbackContext(),o=(await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async t=>{let o=r[t.slot];if(o===void 0)return null;let s=memoryOperationId({phase:`turn.started`,sequence:e.event.data.sequence,sessionId:a.session.id,slot:t.slot,turnId:n.id});return{lock:o,messages:await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:s,operationName:`search_memory`,phase:`turn.started`,slot:t.slot,storeId:o.scope.key,turnId:n.id}),async()=>{let r=await t.provider.recall[`turn.started`]({...a,abortSignal:e.abortSignal??fallbackAbortSignal,memory:{scope:o.scope,slot:t.slot},messages:i,operationId:s,turn:n}),c=validateMemoryRecallResult(r,t.slot);return{outputRecords:memoryRecords(r),recordCount:c.length,value:c}}),operationId:s}}))).filter(e=>e!==null),s=applyMemoryRecallBatches({batches:o,history:t.history,state:t.state}),c=[...projectMemoryHistory({locks:r,messages:s.history}),...t.input],l=t.projector?.({messages:c,state:s.state})??c;return e.ctx.setVirtualContext(PendingMemoryCommitKey,{history:s.history,projectedMessages:l,state:s.state}),l}function drainMemoryCommit(e){let t=e.get(PendingMemoryCommitKey);return e.delete(PendingMemoryCommitKey),e.delete(PreparedMemoryPreambleKey),t}function prepareMemoryCompaction(e,t){e.setVirtualContext(PreparedMemoryCompactionKey,t)}async function dispatchMemoryCompactionRequested(e){let t=buildCallbackContext(),n=await resolveCompactionLocks(e);e.ctx.set(TurnMemoryLocksKey,n);let r=e.event.data.turnId.length===0?null:firstLockedTurn(n);await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async i=>{let a=n[i.slot],o=i.provider.capture?.[`compaction.requested`];if(a===void 0||o===void 0)return;let s=memoryOperationId({phase:`compaction.requested`,sequence:e.event.data.sequence,sessionId:t.session.id,slot:i.slot,stepIndex:e.event.data.stepIndex,turnId:r?.id??null});await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:s,operationName:`upsert_memory`,phase:`compaction.requested`,slot:i.slot,storeId:a.scope.key,turnId:r?.id}),async()=>(await o({...t,abortSignal:e.abortSignal??fallbackAbortSignal,compaction:{modelId:e.event.data.modelId,usageInputTokens:e.event.data.usageInputTokens},memory:{scope:a.scope,slot:i.slot},messages:e.messages,operationId:s,turn:r}),{value:void 0}))}))}async function dispatchMemoryCompactionCompleted(e){let t=e.ctx.get(PreparedMemoryCompactionKey),n=t?.history??e.messages,r=e.ctx.get(TurnMemoryLocksKey)??{},i=projectMemoryHistory({locks:r,messages:n}),a=buildCallbackContext(),o=e.event.data.turnId.length===0?null:firstLockedTurn(r),s=(await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async t=>{let n=r[t.slot],s=t.provider.recall[`compaction.completed`];if(n===void 0||s===void 0)return null;let c=memoryOperationId({phase:`compaction.completed`,sequence:e.event.data.sequence,sessionId:a.session.id,slot:t.slot,stepIndex:e.event.data.stepIndex,turnId:o?.id??null});return{lock:n,messages:await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:c,operationName:`search_memory`,phase:`compaction.completed`,slot:t.slot,storeId:n.scope.key,turnId:o?.id}),async()=>{let r=await s({...a,abortSignal:e.abortSignal??fallbackAbortSignal,compaction:{modelId:e.event.data.modelId},memory:{scope:n.scope,slot:t.slot},messages:i,operationId:c,turn:o}),l=validateMemoryRecallResult(r,t.slot);return{outputRecords:memoryRecords(r),recordCount:l.length,value:l}}),operationId:c}}))).filter(e=>e!==null),c=applyMemoryRecallBatches({batches:s,history:n,state:t?.state}),l=projectMemoryHistory({locks:r,messages:c.history});return e.ctx.setVirtualContext(PendingMemoryCommitKey,{history:c.history,projectedMessages:l,state:c.state}),e.ctx.delete(PreparedMemoryCompactionKey),l}async function dispatchMemoryTurnCompleted(e){let t=e.ctx.get(TurnMemoryLocksKey)??{},n=buildCallbackContext(),r=projectMemoryHistory({locks:t,messages:e.messages});await settleMemoryOperations([...e.memories].sort((e,t)=>e.logicalPath.localeCompare(t.logicalPath)).map(async i=>{let a=t[i.slot],o=i.provider.capture?.[`turn.completed`];if(a===void 0||o===void 0)return;let s=memoryOperationId({phase:`turn.completed`,sequence:e.event.data.sequence,sessionId:n.session.id,slot:i.slot,turnId:e.event.data.turnId});await instrumentMemoryOperation(e.instrumentation,memoryInstrumentationOperation({operationId:s,operationName:`upsert_memory`,phase:`turn.completed`,slot:i.slot,storeId:a.scope.key,turnId:a.turn.id}),async()=>(await o({...n,abortSignal:e.abortSignal??fallbackAbortSignal,memory:{scope:a.scope,slot:i.slot},messages:r,operationId:s,turn:a.turn}),{value:void 0}))}))}async function resolveCompactionLocks(e){let t=e.ctx.get(TurnMemoryLocksKey);if(e.event.data.turnId.length>0&&t!==void 0)return t;let n=Object.freeze({id:``,input:[],sequence:e.event.data.sequence});return Object.fromEntries((await Promise.all(e.memories.map(async t=>{let r=await resolveMemoryLock({abortSignal:e.abortSignal??fallbackAbortSignal,appRoot:e.appRoot,ctx:e.ctx,memory:t,nodeId:e.nodeId,turn:n});return r===null?null:[t.slot,r]}))).filter(e=>e!==null))}function firstLockedTurn(e){return Object.values(e)[0]?.turn??null}async function resolveMemoryLock(e){let t=buildResolveContext(e.ctx,[]),n={abortSignal:e.abortSignal,channel:t.channel,session:t.session},r=typeof e.memory.scope==`function`?await e.memory.scope(n):e.memory.scope;if(r===null)return reportDisabledMemorySlot(e.memory.slot,`scope`),null;let i={appRoot:e.appRoot,node:e.nodeId,slot:e.memory.slot},a=e.memory.namespace===void 0?defaultNamespace(i):typeof e.memory.namespace==`function`?await e.memory.namespace(i):e.memory.namespace;return a===null?(reportDisabledMemorySlot(e.memory.slot,`namespace`),null):createMemoryLock({namespace:a,scope:r,slot:e.memory.slot,turn:e.turn,visibility:e.memory.visibility})}function reportDisabledMemorySlot(e,t){isEveDevEnvironment()&&log.info(`Memory slot is disabled for this operation`,{resolver:t,slot:e})}async function settleMemoryOperations(e){let t=await Promise.allSettled(e),n=[],r;for(let e of t)e.status===`rejected`?r??=e:n.push(e.value);if(r!==void 0)throw r.reason;return n}function memoryOperationId(e){return[`eve-memory-operation-v1`,e.sessionId,String(e.sequence),e.turnId??`standalone`,...e.stepIndex===void 0?[]:[String(e.stepIndex)],e.phase,e.slot].join(`:`)}function memoryInstrumentationOperation(e){return{idempotencyKey:e.operationId,operationName:e.operationName,phase:e.phase,slot:e.slot,storeId:e.storeId,turnId:e.turnId}}function memoryRecords(e){return e==null?[]:e.messages.map(e=>e.id===void 0?{content:e.content}:{content:e.content,id:e.id})}export{dispatchMemoryCompactionCompleted,dispatchMemoryCompactionRequested,dispatchMemoryTurnCompleted,dispatchMemoryTurnStarted,drainMemoryCommit,prepareMemoryCompaction,prepareMemoryPreamble};

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

@@ -1,21 +1,6 @@
 import { type DiscoverDiagnostic } from "#discover/diagnostics.js";
 import { type ConnectionSourceRef } from "#discover/manifest.js";
 import type { ProjectSource, ProjectSourceEntry } from "#discover/project-source.js";
-/**
- * Shared diagnostic emitted when the authored `connections/` root is not a
- * directory.
- */
-export declare const DISCOVER_CONNECTIONS_DIRECTORY_INVALID = "discover/connections-directory-invalid";
-/**
- * Discovery diagnostic emitted when a connection exists in both file form
- * (`connections/<name>.ts`) and folder form (`connections/<name>/`).
- */
-export declare const DISCOVER_CONNECTION_FILE_FOLDER_COLLISION = "discover/connection-file-folder-collision";
-/**
- * Discovery diagnostic emitted when a folder-form connection contains no
- * `connection.ts` definition module.
- */
-export declare const DISCOVER_CONNECTION_FOLDER_EMPTY = "discover/connection-folder-empty";
 /**
  * Result of discovering authored connection sources from a single agent root.
  */