@ai-matrx/desktop-protocol 0.14.0 → 0.15.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/schema/primitives.ts
 import { z } from "zod";
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 3;
+var PROTOCOL_MINOR = 4;
 var PROTOCOL_VERSION = `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
 var ProtocolVersion = z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -1012,6 +1012,341 @@ var ClipboardReadResult = z15.strictObject({
 var ClipboardWriteParams = z15.strictObject({ text: z15.string().max(1048576) });
 var ClipboardWriteResult = z15.strictObject({ bytes: nonNegInt });
 
+// src/schema/system.ts
+import { z as z16 } from "zod";
+var SystemOpenUrlParams = z16.strictObject({
+  /** http, https or mailto; opened in the person's default app for it. */
+  url: z16.string().min(1).max(4096)
+});
+var SystemOpenUrlResult = z16.strictObject({ url: z16.string().max(4096) });
+var SystemOpenPathParams = z16.strictObject({
+  path: AbsPath,
+  /** Show it in the file manager (Finder, Explorer) instead of opening it. */
+  reveal: z16.boolean().default(false)
+});
+var SystemOpenPathResult = z16.strictObject({ path: AbsPath, revealed: z16.boolean() });
+var SystemNotifyParams = z16.strictObject({
+  title: z16.string().min(1).max(128),
+  body: z16.string().max(1024).default("")
+});
+var SystemNotifyResult = z16.strictObject({
+  /** False when this computer has no notification service to show it (a bare Linux box). */
+  shown: z16.boolean()
+});
+
+// src/schema/screen.ts
+import { z as z17 } from "zod";
+var ScreenDisplay = z17.strictObject({
+  /** The OS's display id; pass it to screen.capture. */
+  id: nonNegInt,
+  name: z17.string().max(128),
+  /** Position and size in the OS's logical points (x and y may be negative left of or above the main display). */
+  x: z17.int(),
+  y: z17.int(),
+  width: z17.int().min(1),
+  height: z17.int().min(1),
+  /** Pixels per point (2 on a Retina display). */
+  scale: z17.number().min(0.1).max(8),
+  primary: z17.boolean()
+});
+var ScreenListParams = z17.strictObject({});
+var ScreenListResult = z17.strictObject({ displays: z17.array(ScreenDisplay).max(32) });
+var ScreenCaptureParams = z17.strictObject({
+  /** The display (from screen.list); the primary display when absent. */
+  display_id: nonNegInt.optional(),
+  format: z17.enum(["jpeg", "png"]).default("jpeg"),
+  /** Scale the picture down to at most this width in pixels (kept when already smaller). */
+  max_width: z17.int().min(160).max(7680).default(1600)
+});
+var ScreenCaptureResult = z17.strictObject({
+  display_id: nonNegInt,
+  mime_type: z17.enum(["image/jpeg", "image/png"]),
+  width: z17.int().min(1),
+  height: z17.int().min(1),
+  /** The display's full resolution in pixels, before scaling. */
+  source_width: z17.int().min(1),
+  source_height: z17.int().min(1),
+  /** The image, base64 (at most 6 MiB of text). */
+  data_base64: z17.string().max(6291456)
+});
+
+// src/schema/window.ts
+import { z as z18 } from "zod";
+var WindowInfo = z18.strictObject({
+  /** The OS's window handle (macOS window number, Windows HWND, X11 window id). */
+  id: nonNegInt,
+  title: z18.string().max(512),
+  /** Position and size in logical points. */
+  x: z18.int(),
+  y: z18.int(),
+  width: z18.int().min(0),
+  height: z18.int().min(0)
+});
+var WindowListParams = z18.strictObject({
+  /** Case-insensitive substring of the window title. */
+  title: z18.string().min(1).max(256).optional(),
+  limit: z18.int().min(1).max(500).default(100)
+});
+var WindowListResult = z18.strictObject({
+  windows: z18.array(WindowInfo).max(500),
+  total: nonNegInt,
+  truncated: z18.boolean()
+});
+var WindowFocusParams = z18.strictObject({ id: nonNegInt });
+var WindowFocusResult = z18.strictObject({ window: WindowInfo });
+var WindowMoveParams = z18.strictObject({
+  id: nonNegInt,
+  /** New top-left corner; unchanged when absent. */
+  x: z18.int().optional(),
+  y: z18.int().optional(),
+  /** New size; unchanged when absent. */
+  width: z18.int().min(50).max(16384).optional(),
+  height: z18.int().min(50).max(16384).optional()
+});
+var WindowMoveResult = z18.strictObject({ window: WindowInfo });
+var WindowMinimizeParams = z18.strictObject({ id: nonNegInt });
+var WindowMinimizeResult = z18.strictObject({ id: nonNegInt });
+
+// src/schema/input.ts
+import { z as z19 } from "zod";
+var InputKey = z19.enum([
+  "cmd",
+  "ctrl",
+  "alt",
+  "shift",
+  "meta",
+  "a",
+  "b",
+  "c",
+  "d",
+  "e",
+  "f",
+  "g",
+  "h",
+  "i",
+  "j",
+  "k",
+  "l",
+  "m",
+  "n",
+  "o",
+  "p",
+  "q",
+  "r",
+  "s",
+  "t",
+  "u",
+  "v",
+  "w",
+  "x",
+  "y",
+  "z",
+  "0",
+  "1",
+  "2",
+  "3",
+  "4",
+  "5",
+  "6",
+  "7",
+  "8",
+  "9",
+  "f1",
+  "f2",
+  "f3",
+  "f4",
+  "f5",
+  "f6",
+  "f7",
+  "f8",
+  "f9",
+  "f10",
+  "f11",
+  "f12",
+  "enter",
+  "tab",
+  "escape",
+  "space",
+  "backspace",
+  "delete",
+  "up",
+  "down",
+  "left",
+  "right",
+  "home",
+  "end",
+  "pageup",
+  "pagedown",
+  "minus",
+  "equal",
+  "comma",
+  "period",
+  "slash",
+  "semicolon",
+  "quote",
+  "bracketleft",
+  "bracketright",
+  "backslash",
+  "grave"
+]);
+var InputTypeTextParams = z19.strictObject({ text: z19.string().min(1).max(1e4) });
+var InputTypeTextResult = z19.strictObject({ characters: z19.int().min(1) });
+var InputHotkeyParams = z19.strictObject({
+  /** Pressed together in order and released in reverse: ["cmd", "shift", "t"]. */
+  keys: z19.array(InputKey).min(1).max(6)
+});
+var InputHotkeyResult = z19.strictObject({ keys: z19.array(InputKey) });
+var InputPoint = z19.strictObject({ x: z19.int(), y: z19.int() });
+var InputMouseMoveParams = z19.strictObject({
+  /** Screen position in logical points (the coordinates screen.list and window.list report). */
+  x: z19.int(),
+  y: z19.int()
+});
+var InputMouseMoveResult = z19.strictObject({
+  /** Where the pointer is now, read back from the OS. */
+  position: InputPoint
+});
+var InputMouseClickParams = z19.strictObject({
+  /** Move here first; clicks where the pointer is when absent. */
+  x: z19.int().optional(),
+  y: z19.int().optional(),
+  button: z19.enum(["left", "right", "middle"]).default("left"),
+  double: z19.boolean().default(false)
+});
+var InputMouseClickResult = z19.strictObject({
+  position: InputPoint,
+  button: z19.enum(["left", "right", "middle"]),
+  double: z19.boolean()
+});
+
+// src/schema/power.ts
+import { z as z20 } from "zod";
+var PowerStatusParams = z20.strictObject({});
+var PowerStatusResult = z20.strictObject({
+  has_battery: z20.boolean(),
+  /** 0–100; null without a battery. */
+  percent: z20.number().min(0).max(100).nullable(),
+  charging: z20.boolean().nullable(),
+  /** On wall power; null where the OS does not say. */
+  plugged_in: z20.boolean().nullable(),
+  /** Minutes of battery left; null when charging, unknown or without a battery. */
+  minutes_left: nonNegInt.nullable(),
+  /** Matrx 2 is keeping the computer awake (power.prevent_sleep) until this time; null when it is not. */
+  awake_until_ms: epochMs.nullable()
+});
+var PowerPreventSleepParams = z20.strictObject({
+  /** Keep the computer awake this long; 0 lets it sleep again now. */
+  seconds: z20.int().min(0).max(86400),
+  /** Shown where the OS lists what keeps it awake. */
+  reason: z20.string().min(1).max(128).default("Matrx 2 is working")
+});
+var PowerPreventSleepResult = z20.strictObject({
+  /** When it may sleep again; null after seconds 0. */
+  awake_until_ms: epochMs.nullable()
+});
+
+// src/schema/resources.ts
+import { z as z21 } from "zod";
+var ResourcesDisk = z21.strictObject({
+  /** Where it is mounted ("/", "C:"). */
+  mount: z21.string().max(512),
+  /** The file system ("apfs", "NTFS", "ext4"). */
+  fs: z21.string().max(64),
+  size_bytes: nonNegInt,
+  used_bytes: nonNegInt,
+  available_bytes: nonNegInt
+});
+var ResourcesSnapshotParams = z21.strictObject({});
+var ResourcesSnapshotResult = z21.strictObject({
+  cpu: z21.strictObject({
+    /** Busy share of all cores, 0–100, measured now. */
+    percent: z21.number().min(0).max(100),
+    cores: z21.int().min(1),
+    /** 1, 5 and 15 minute load averages; null on Windows. */
+    load: z21.array(z21.number().min(0)).length(3).nullable()
+  }),
+  memory: z21.strictObject({ total_bytes: nonNegInt, used_bytes: nonNegInt, available_bytes: nonNegInt }),
+  swap: z21.strictObject({ total_bytes: nonNegInt, used_bytes: nonNegInt }),
+  disks: z21.array(ResourcesDisk).max(64),
+  uptime_seconds: nonNegInt
+});
+
+// src/schema/fs-watch.ts
+import { z as z22 } from "zod";
+var FsWatchId = z22.string().regex(/^fw_[A-Za-z0-9]{12,40}$/);
+var FsWatchStartParams = z22.strictObject({
+  path: AbsPath,
+  recursive: z22.boolean().default(true),
+  /** Globs relative to `path` whose changes are not reported (".git/**", "node_modules/**"). */
+  ignore: z22.array(z22.string().max(256)).max(64).default([])
+});
+var FsWatchStartResult = z22.strictObject({
+  watch_id: FsWatchId,
+  path: AbsPath,
+  /** The watch ends by itself if nobody reads it for 30 minutes. */
+  expires_at_ms: epochMs
+});
+var FsWatchEventsParams = z22.strictObject({
+  watch_id: FsWatchId,
+  /** Wait up to this long for a first change when none is waiting (0 answers at once). */
+  wait_ms: z22.int().min(0).max(25e3).default(0)
+});
+var FsWatchEventsResult = z22.strictObject({
+  /** What changed since the last read, oldest first; re-checked against the disk when read. */
+  changes: z22.array(FsChange).max(1e3),
+  /** Changes were dropped (more than 1000 waited): list the folder again. */
+  overflow: z22.boolean(),
+  expires_at_ms: epochMs
+});
+var FsWatchStopParams = z22.strictObject({ watch_id: FsWatchId });
+var FsWatchStopResult = z22.strictObject({ watch_id: FsWatchId });
+
+// src/schema/exec-job.ts
+import { z as z23 } from "zod";
+var ExecJobId = z23.string().regex(/^job_[A-Za-z0-9]{12,40}$/);
+var ExecJobStartParams = z23.strictObject({
+  command: z23.string().min(1).max(131072),
+  /** The folder it runs in; the home folder when absent. */
+  cwd: AbsPath.optional(),
+  env: z23.record(z23.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).max(128), z23.string().max(32768)).optional()
+});
+var ExecJobStartResult = z23.strictObject({ job_id: ExecJobId, pid: z23.int().min(1), cwd: AbsPath });
+var ExecJobOutputParams = z23.strictObject({
+  job_id: ExecJobId,
+  /** Byte offset into the job's output to read from (next_offset of the last read; 0 = the start). */
+  offset: nonNegInt.default(0),
+  /** Wait up to this long for new output or the exit when none is waiting (0 answers at once). */
+  wait_ms: z23.int().min(0).max(25e3).default(0),
+  max_bytes: z23.int().min(1024).max(1048576).default(65536)
+});
+var ExecJobOutputResult = z23.strictObject({
+  /** stdout and stderr interleaved as they arrived (UTF-8). */
+  output: z23.string(),
+  next_offset: nonNegInt,
+  /** Bytes before `offset` that are gone (the job keeps its last 4 MiB). */
+  dropped_bytes: nonNegInt,
+  running: z23.boolean(),
+  exit_code: z23.int().nullable()
+});
+var ExecJobStopParams = z23.strictObject({
+  job_id: ExecJobId,
+  /** End it at once (SIGKILL; on Windows the whole tree with /F) instead of asking it to quit. */
+  force: z23.boolean().default(false)
+});
+var ExecJobStopResult = z23.strictObject({ job_id: ExecJobId, exited: z23.boolean(), exit_code: z23.int().nullable() });
+var ExecJobInfo = z23.strictObject({
+  job_id: ExecJobId,
+  command: z23.string().max(1024),
+  pid: z23.int().min(1),
+  cwd: AbsPath,
+  running: z23.boolean(),
+  exit_code: z23.int().nullable(),
+  started_at_ms: epochMs,
+  output_bytes: nonNegInt
+});
+var ExecJobListParams = z23.strictObject({});
+var ExecJobListResult = z23.strictObject({ jobs: z23.array(ExecJobInfo).max(64) });
+
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
@@ -1053,7 +1388,30 @@ var OPS = {
   "proc.ports": { params: ProcPortsParams, result: ProcPortsResult, kind: "unary", since: "1.3", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "proc.kill": { params: ProcKillParams, result: ProcKillResult, kind: "unary", since: "1.3", errors: ["NOT_FOUND", "AUTH_FORBIDDEN", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "INTERNAL"] },
   "clipboard.read": { params: ClipboardReadParams, result: ClipboardReadResult, kind: "unary", since: "1.3", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
-  "clipboard.write": { params: ClipboardWriteParams, result: ClipboardWriteResult, kind: "unary", since: "1.3", errors: ["PLATFORM_UNSUPPORTED", "PAYLOAD_TOO_LARGE", "INTERNAL"] }
+  "clipboard.write": { params: ClipboardWriteParams, result: ClipboardWriteResult, kind: "unary", since: "1.3", errors: ["PLATFORM_UNSUPPORTED", "PAYLOAD_TOO_LARGE", "INTERNAL"] },
+  "fs.watch.start": { params: FsWatchStartParams, result: FsWatchStartResult, kind: "unary", since: "1.4", errors: [...FS_ERR, "RATE_LIMITED"] },
+  "fs.watch.events": { params: FsWatchEventsParams, result: FsWatchEventsResult, kind: "unary", since: "1.4", errors: ["RESOURCE_GONE", "INVALID_PARAMS", "INTERNAL"] },
+  "fs.watch.stop": { params: FsWatchStopParams, result: FsWatchStopResult, kind: "unary", since: "1.4", errors: ["RESOURCE_GONE", "INVALID_PARAMS"] },
+  "exec.job.start": { params: ExecJobStartParams, result: ExecJobStartResult, kind: "unary", since: "1.4", errors: ["INVALID_PARAMS", "NOT_FOUND", "RATE_LIMITED", "INTERNAL"] },
+  "exec.job.output": { params: ExecJobOutputParams, result: ExecJobOutputResult, kind: "unary", since: "1.4", errors: ["RESOURCE_GONE", "INVALID_PARAMS"] },
+  "exec.job.stop": { params: ExecJobStopParams, result: ExecJobStopResult, kind: "unary", since: "1.4", errors: ["RESOURCE_GONE", "INVALID_PARAMS", "INTERNAL"] },
+  "exec.job.list": { params: ExecJobListParams, result: ExecJobListResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] },
+  "system.open_url": { params: SystemOpenUrlParams, result: SystemOpenUrlResult, kind: "unary", since: "1.4", errors: ["INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "system.open_path": { params: SystemOpenPathParams, result: SystemOpenPathResult, kind: "unary", since: "1.4", errors: ["NOT_FOUND", "INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "system.notify": { params: SystemNotifyParams, result: SystemNotifyResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "INTERNAL"] },
+  "screen.list": { params: ScreenListParams, result: ScreenListResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "screen.capture": { params: ScreenCaptureParams, result: ScreenCaptureResult, kind: "unary", since: "1.4", errors: ["NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "PAYLOAD_TOO_LARGE", "INTERNAL"] },
+  "window.list": { params: WindowListParams, result: WindowListResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "window.focus": { params: WindowFocusParams, result: WindowFocusResult, kind: "unary", since: "1.4", errors: ["NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "window.move": { params: WindowMoveParams, result: WindowMoveResult, kind: "unary", since: "1.4", errors: ["NOT_FOUND", "INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "window.minimize": { params: WindowMinimizeParams, result: WindowMinimizeResult, kind: "unary", since: "1.4", errors: ["NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "input.type_text": { params: InputTypeTextParams, result: InputTypeTextResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "input.hotkey": { params: InputHotkeyParams, result: InputHotkeyResult, kind: "unary", since: "1.4", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "input.mouse_move": { params: InputMouseMoveParams, result: InputMouseMoveResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "input.mouse_click": { params: InputMouseClickParams, result: InputMouseClickResult, kind: "unary", since: "1.4", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "power.status": { params: PowerStatusParams, result: PowerStatusResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] },
+  "power.prevent_sleep": { params: PowerPreventSleepParams, result: PowerPreventSleepResult, kind: "unary", since: "1.4", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "resources.snapshot": { params: ResourcesSnapshotParams, result: ResourcesSnapshotResult, kind: "unary", since: "1.4", errors: ["INTERNAL"] }
 };
 var EVENTS = {
   "fs.changed": FsChangedEvent,
@@ -1218,6 +1576,60 @@ var NAMED_SCHEMAS = {
   ClipboardReadResult,
   ClipboardWriteParams,
   ClipboardWriteResult,
+  SystemOpenUrlParams,
+  SystemOpenUrlResult,
+  SystemOpenPathParams,
+  SystemOpenPathResult,
+  SystemNotifyParams,
+  SystemNotifyResult,
+  ScreenDisplay,
+  ScreenListParams,
+  ScreenListResult,
+  ScreenCaptureParams,
+  ScreenCaptureResult,
+  WindowInfo,
+  WindowListParams,
+  WindowListResult,
+  WindowFocusParams,
+  WindowFocusResult,
+  WindowMoveParams,
+  WindowMoveResult,
+  WindowMinimizeParams,
+  WindowMinimizeResult,
+  InputKey,
+  InputPoint,
+  InputTypeTextParams,
+  InputTypeTextResult,
+  InputHotkeyParams,
+  InputHotkeyResult,
+  InputMouseMoveParams,
+  InputMouseMoveResult,
+  InputMouseClickParams,
+  InputMouseClickResult,
+  PowerStatusParams,
+  PowerStatusResult,
+  PowerPreventSleepParams,
+  PowerPreventSleepResult,
+  ResourcesDisk,
+  ResourcesSnapshotParams,
+  ResourcesSnapshotResult,
+  FsWatchId,
+  FsWatchStartParams,
+  FsWatchStartResult,
+  FsWatchEventsParams,
+  FsWatchEventsResult,
+  FsWatchStopParams,
+  FsWatchStopResult,
+  ExecJobId,
+  ExecJobStartParams,
+  ExecJobStartResult,
+  ExecJobOutputParams,
+  ExecJobOutputResult,
+  ExecJobStopParams,
+  ExecJobStopResult,
+  ExecJobInfo,
+  ExecJobListParams,
+  ExecJobListResult,
   ToolLevel,
   ToolOutcome,
   ToolPlatform,
@@ -1323,7 +1735,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [...RESULT_PATH.keys()];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "0354e634fd50ffdc4c83b7ede7f9c31f3b2c877c4574557a6b264d2998470fd6";
+var CONTRACT_SHA256 = "a5378bb523cbf52619f16e2accc788931ffb443e762052db4ca42c598792c181";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -1372,19 +1784,19 @@ var TOOL_CATALOG = [
   { name: "fs_search", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["fs.search_paths", "fs.search_content"], platforms: ALL, summary: "Find files by name or content" },
   { name: "shell_execute", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["exec.run"], platforms: ALL, summary: "Run a command; cd carries over" },
   { name: "shell_python", group: "files_shell", state: "built", path: "sandbox_proxy", ops: ["exec.run"], platforms: ALL, summary: "Run a Python script" },
-  { name: "shell_job", group: "files_shell", state: "planned", path: "device_op", ops: ["exec.job.start", "exec.job.output", "exec.job.stop"], platforms: ALL, summary: "Background commands: start, read output, stop" },
+  { name: "shell_job", group: "files_shell", state: "built", path: "device_op", ops: ["exec.job.start", "exec.job.output", "exec.job.stop", "exec.job.list"], platforms: ALL, summary: "Background commands: start, read output, stop" },
   // ── 2. Computer control (TS owners) ──────────────────────────────────────────────────────────
   { name: "desktop_process", group: "os_control", state: "built", path: "device_op", ops: ["proc.list", "proc.ports", "proc.kill"], platforms: ALL, summary: "Running processes and ports; stop one" },
-  { name: "desktop_apps", group: "os_control", state: "planned", path: "device_op", ops: ["apps.list", "apps.open"], platforms: ALL, summary: "Installed apps; open or bring one forward" },
-  { name: "desktop_system", group: "os_control", state: "planned", path: "device_op", ops: ["sysinfo.get", "system.open_url", "system.open_path", "system.notify"], platforms: ALL, summary: "System facts, open, notify" },
+  { name: "desktop_apps", group: "os_control", state: "built", path: "device_op", ops: ["apps.list", "apps.open"], platforms: ALL, summary: "Installed apps; open or bring one forward" },
+  { name: "desktop_system", group: "os_control", state: "built", path: "device_op", ops: ["sysinfo.get", "system.open_url", "system.open_path", "system.notify"], platforms: ALL, summary: "System facts, open, notify" },
   { name: "desktop_clipboard", group: "os_control", state: "built", path: "device_op", ops: ["clipboard.read", "clipboard.write"], platforms: ALL, summary: "Read and write the clipboard's text" },
-  { name: "desktop_screen", group: "os_control", state: "planned", path: "device_op", ops: ["screen.list", "screen.capture"], platforms: ALL, summary: "Displays and screenshots" },
-  { name: "desktop_window", group: "os_control", state: "planned", path: "device_op", ops: ["window.list", "window.focus", "window.move", "window.minimize"], platforms: ALL, summary: "Find, focus and arrange windows" },
-  { name: "desktop_input", group: "os_control", state: "planned", path: "device_op", ops: ["input.type_text", "input.hotkey", "input.mouse_click", "input.mouse_move"], platforms: ALL, summary: "Keyboard and mouse" },
+  { name: "desktop_screen", group: "os_control", state: "built", path: "device_op", ops: ["screen.list", "screen.capture"], platforms: ALL, summary: "Displays and screenshots" },
+  { name: "desktop_window", group: "os_control", state: "built", path: "device_op", ops: ["window.list", "window.focus", "window.move", "window.minimize"], platforms: ALL, summary: "Find, focus and arrange windows" },
+  { name: "desktop_input", group: "os_control", state: "built", path: "device_op", ops: ["input.type_text", "input.hotkey", "input.mouse_click", "input.mouse_move"], platforms: ALL, summary: "Keyboard and mouse" },
   { name: "desktop_audio", group: "os_control", state: "planned", path: "device_op", ops: ["audio.devices", "audio.record", "audio.play"], platforms: ALL, summary: "Audio devices, record, play" },
-  { name: "desktop_power", group: "os_control", state: "planned", path: "device_op", ops: ["power.status", "power.prevent_sleep"], platforms: ALL, summary: "Battery and keep awake" },
-  { name: "desktop_resources", group: "os_control", state: "planned", path: "device_op", ops: ["resources.snapshot", "resources.top"], platforms: ALL, summary: "CPU, memory and disk use" },
-  { name: "fs_watch", group: "os_control", state: "planned", path: "device_op", ops: ["fs.watch"], platforms: ALL, summary: "Watch a folder for changes" },
+  { name: "desktop_power", group: "os_control", state: "built", path: "device_op", ops: ["power.status", "power.prevent_sleep"], platforms: ALL, summary: "Battery and keep awake" },
+  { name: "desktop_resources", group: "os_control", state: "built", path: "device_op", ops: ["resources.snapshot"], platforms: ALL, summary: "CPU, memory and disk use" },
+  { name: "fs_watch", group: "os_control", state: "built", path: "device_op", ops: ["fs.watch.start", "fs.watch.events", "fs.watch.stop"], platforms: ALL, summary: "Watch a folder; read what changed" },
   // ── 3. Personal apps and automation ──────────────────────────────────────────────────────────
   { name: "desktop_automation", group: "personal_automation", state: "planned", path: "device_op", ops: ["automation.script"], platforms: ["darwin", "win32"], summary: "AppleScript on a Mac, PowerShell on Windows" },
   { name: "desktop_mail", group: "personal_automation", state: "planned", path: "device_op", ops: ["mail.accounts", "mail.list", "mail.send"], platforms: ["darwin"], summary: "The Mail app" },
@@ -1485,7 +1897,7 @@ var LEGACY_ACTIONS = {
   "local_monitor.resources": tool("desktop_resources"),
   "local_monitor.battery": tool("desktop_power"),
   "local_monitor.disk_usage": tool("desktop_resources"),
-  "local_monitor.top_processes": tool("desktop_resources"),
+  "local_monitor.top_processes": tool("desktop_process"),
   "local_monitor.watch_directory": tool("fs_watch"),
   "local_monitor.watch_events": tool("fs_watch"),
   "local_monitor.stop_watch": tool("fs_watch"),
@@ -1714,6 +2126,16 @@ export {
   EventMsg,
   ExecCwdEvent,
   ExecExitedEvent,
+  ExecJobId,
+  ExecJobInfo,
+  ExecJobListParams,
+  ExecJobListResult,
+  ExecJobOutputParams,
+  ExecJobOutputResult,
+  ExecJobStartParams,
+  ExecJobStartResult,
+  ExecJobStopParams,
+  ExecJobStopResult,
   ExecListParams,
   ExecListResult,
   ExecPtyKillParams,
@@ -1763,11 +2185,28 @@ export {
   FsSearchPathsResult,
   FsStatParams,
   FsStatResult,
+  FsWatchEventsParams,
+  FsWatchEventsResult,
+  FsWatchId,
   FsWatchParams,
   FsWatchResult,
+  FsWatchStartParams,
+  FsWatchStartResult,
+  FsWatchStopParams,
+  FsWatchStopResult,
   FsWriteParams,
   FsWriteResult,
   HelloMsg,
+  InputHotkeyParams,
+  InputHotkeyResult,
+  InputKey,
+  InputMouseClickParams,
+  InputMouseClickResult,
+  InputMouseMoveParams,
+  InputMouseMoveResult,
+  InputPoint,
+  InputTypeTextParams,
+  InputTypeTextResult,
   LEGACY_ACTIONS,
   LEGACY_DISPATCHERS,
   Limits,
@@ -1796,6 +2235,10 @@ export {
   PROTOCOL_MAJOR,
   PROTOCOL_MINOR,
   PROTOCOL_VERSION,
+  PowerPreventSleepParams,
+  PowerPreventSleepResult,
+  PowerStatusParams,
+  PowerStatusResult,
   ProcInfo,
   ProcKillParams,
   ProcKillResult,
@@ -1826,10 +2269,18 @@ export {
   RequestMsg,
   ResourceId,
   ResourceInfo,
+  ResourcesDisk,
+  ResourcesSnapshotParams,
+  ResourcesSnapshotResult,
   ResponseMsg,
   SERVICES,
   SERVICE_MAX_FRAME_BYTES,
   SUBPROTOCOL,
+  ScreenCaptureParams,
+  ScreenCaptureResult,
+  ScreenDisplay,
+  ScreenListParams,
+  ScreenListResult,
   ServiceCancel,
   ServiceErrorMsg,
   ServiceHello,
@@ -1857,6 +2308,12 @@ export {
   StreamMsg,
   SysinfoGetParams,
   SysinfoGetResult,
+  SystemNotifyParams,
+  SystemNotifyResult,
+  SystemOpenPathParams,
+  SystemOpenPathResult,
+  SystemOpenUrlParams,
+  SystemOpenUrlResult,
   TOOL_CATALOG,
   TOOL_GROUPS,
   TOOL_LEVELS,
@@ -1873,6 +2330,15 @@ export {
   TranscriptionModelInfo,
   VERSIONED_RESULT_OPS,
   Welcome,
+  WindowFocusParams,
+  WindowFocusResult,
+  WindowInfo,
+  WindowListParams,
+  WindowListResult,
+  WindowMinimizeParams,
+  WindowMinimizeResult,
+  WindowMoveParams,
+  WindowMoveResult,
   announcedVersion,
   assertFrameHeader,
   buildToolStatus,