@ai-matrx/desktop-protocol 0.14.0 → 0.16.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 = 5;
 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_-]+$/);
@@ -877,7 +877,7 @@ var AppsOpenResult = z11.strictObject({
 // src/schema/service.ts
 import { z as z12 } from "zod";
 var SERVICE_MAX_FRAME_BYTES = 16777216;
-var ServiceName = z12.enum(["ml"]);
+var ServiceName = z12.enum(["ml", "coding"]);
 var ContractHash = z12.string().regex(/^[0-9a-f]{64}$/);
 var ServiceToken = z12.string().regex(/^[A-Za-z0-9_-]{43}$/);
 var ServiceRequestId = u32;
@@ -1012,6 +1012,416 @@ 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/coding.ts
+import { z as z24 } from "zod";
+var CodingServiceCredentials = z24.strictObject({
+  access_token: z24.string().min(16).max(16384),
+  user_id: z24.string().regex(/^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/),
+  /** The AI Matrx server this app talks to (production, or a local server on the nightly copy). */
+  server_url: z24.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
+});
+var CodingHistoryBlocked = z24.enum([
+  "signed_out",
+  "offline",
+  "organization_required",
+  "claude_unavailable",
+  "cloud_list_unavailable",
+  "history_too_large"
+]);
+var CodingHistoryFailure = z24.strictObject({
+  session_id: z24.string().max(64),
+  reason: z24.string().max(300)
+});
+var CodingHistoryRun = z24.strictObject({
+  /** Claude Code sessions found on this computer. */
+  local_sessions: nonNegInt,
+  /** Of those, already complete in AI Matrx. */
+  in_cloud: nonNegInt,
+  /** In AI Matrx under neither of its identities. */
+  missing: nonNegInt,
+  /** In AI Matrx, but changed here after the last turn AI Matrx received (turns the hook lost). */
+  behind: nonNegInt,
+  /** Over the importer's size cap; never imported. */
+  too_large: nonNegInt,
+  imported: nonNegInt,
+  /** Changed while being read; a later run takes them. */
+  changed: nonNegInt,
+  failed: nonNegInt,
+  failures: z24.array(CodingHistoryFailure).max(20),
+  /** Candidates not reached yet. */
+  remaining: nonNegInt,
+  /** The one line a person reads, e.g. "Imported 12 of 14 sessions. 140 already in AI Matrx." */
+  summary: z24.string().max(400)
+});
+var CodingHistoryStep = z24.strictObject({
+  /** Null when the run could not start (blocked before a plan existed). */
+  plan_id: z24.string().regex(/^[0-9a-f]{32}$/).nullable(),
+  finished: z24.boolean(),
+  blocked: CodingHistoryBlocked.nullable(),
+  run: CodingHistoryRun
+});
+var CodingPlanMissingParams = z24.strictObject({ credentials: CodingServiceCredentials });
+var CodingImportNextParams = z24.strictObject({
+  plan_id: z24.string().regex(/^[0-9a-f]{32}$/),
+  credentials: CodingServiceCredentials
+});
+var CodingServiceProgress = z24.strictObject({
+  phase: z24.enum(["checking", "importing"]),
+  done: nonNegInt,
+  total: nonNegInt
+});
+var CodingHistoryImportMissingParams = z24.strictObject({});
+var CodingHistoryImportMissingResult = z24.strictObject({
+  state: z24.enum(["done", "blocked", "cancelled"]),
+  blocked: CodingHistoryBlocked.nullable(),
+  run: CodingHistoryRun,
+  elapsed_ms: nonNegInt
+});
+var CodingHistoryProgressEvent = z24.strictObject({
+  request_id: RequestId,
+  phase: z24.enum(["checking", "importing"]),
+  /** Sessions settled so far, of `total` candidates (0 of 0 while checking). */
+  done: nonNegInt,
+  total: nonNegInt,
+  imported: nonNegInt,
+  failed: nonNegInt
+});
+
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
@@ -1053,7 +1463,32 @@ 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"] },
+  // Claude Code history (SPEC §6 coding): served by the `coding` Python service through SERVICES below.
+  "coding.history.import_missing": { params: CodingHistoryImportMissingParams, result: CodingHistoryImportMissingResult, kind: "unary", since: "1.5", errors: ["RESOURCE_BUSY", "RESOURCE_GONE", "CANCELLED", "INTERNAL"] }
 };
 var EVENTS = {
   "fs.changed": FsChangedEvent,
@@ -1062,6 +1497,7 @@ var EVENTS = {
   "exec.cwd": ExecCwdEvent,
   "session.control_changed": SessionControlChangedEvent,
   "models.progress": ModelsProgressEvent,
+  "coding.history.progress": CodingHistoryProgressEvent,
   "relay.device_status": RelayDeviceStatusEvent,
   "relay.auth_expiring": RelayAuthExpiringEvent
 };
@@ -1073,6 +1509,13 @@ var SERVICES = {
       "ml.install": { params: ModelsInstallParams, result: ModelsInstallResult },
       "ml.transcribe": { params: ModelsTranscribeParams, result: ModelsTranscribeResult }
     }
+  },
+  coding: {
+    progress: CodingServiceProgress,
+    ops: {
+      "coding.plan_missing": { params: CodingPlanMissingParams, result: CodingHistoryStep },
+      "coding.import_next": { params: CodingImportNextParams, result: CodingHistoryStep }
+    }
   }
 };
 var NAMED_SCHEMAS = {
@@ -1181,6 +1624,17 @@ var NAMED_SCHEMAS = {
   ModelsStatusParams,
   ModelsStatusResult,
   ModelsProgressEvent,
+  CodingServiceCredentials,
+  CodingHistoryBlocked,
+  CodingHistoryFailure,
+  CodingHistoryRun,
+  CodingHistoryStep,
+  CodingPlanMissingParams,
+  CodingImportNextParams,
+  CodingServiceProgress,
+  CodingHistoryImportMissingParams,
+  CodingHistoryImportMissingResult,
+  CodingHistoryProgressEvent,
   ServiceName,
   ContractHash,
   ServiceToken,
@@ -1218,6 +1672,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 +1831,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [...RESULT_PATH.keys()];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "0354e634fd50ffdc4c83b7ede7f9c31f3b2c877c4574557a6b264d2998470fd6";
+var CONTRACT_SHA256 = "c536cb055d02ce0704cee4693f08b4af9e83a38e00e6879160037c1006f2e72e";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -1372,19 +1880,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 +1993,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"),
@@ -1695,6 +2203,17 @@ export {
   ClipboardWriteResult,
   CloseCode,
   CloseCodeValue,
+  CodingHistoryBlocked,
+  CodingHistoryFailure,
+  CodingHistoryImportMissingParams,
+  CodingHistoryImportMissingResult,
+  CodingHistoryProgressEvent,
+  CodingHistoryRun,
+  CodingHistoryStep,
+  CodingImportNextParams,
+  CodingPlanMissingParams,
+  CodingServiceCredentials,
+  CodingServiceProgress,
   ContractHash,
   CoreToClientMsg,
   CoreToServiceMsg,
@@ -1714,6 +2233,16 @@ export {
   EventMsg,
   ExecCwdEvent,
   ExecExitedEvent,
+  ExecJobId,
+  ExecJobInfo,
+  ExecJobListParams,
+  ExecJobListResult,
+  ExecJobOutputParams,
+  ExecJobOutputResult,
+  ExecJobStartParams,
+  ExecJobStartResult,
+  ExecJobStopParams,
+  ExecJobStopResult,
   ExecListParams,
   ExecListResult,
   ExecPtyKillParams,
@@ -1763,11 +2292,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 +2342,10 @@ export {
   PROTOCOL_MAJOR,
   PROTOCOL_MINOR,
   PROTOCOL_VERSION,
+  PowerPreventSleepParams,
+  PowerPreventSleepResult,
+  PowerStatusParams,
+  PowerStatusResult,
   ProcInfo,
   ProcKillParams,
   ProcKillResult,
@@ -1826,10 +2376,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 +2415,12 @@ export {
   StreamMsg,
   SysinfoGetParams,
   SysinfoGetResult,
+  SystemNotifyParams,
+  SystemNotifyResult,
+  SystemOpenPathParams,
+  SystemOpenPathResult,
+  SystemOpenUrlParams,
+  SystemOpenUrlResult,
   TOOL_CATALOG,
   TOOL_GROUPS,
   TOOL_LEVELS,
@@ -1873,6 +2437,15 @@ export {
   TranscriptionModelInfo,
   VERSIONED_RESULT_OPS,
   Welcome,
+  WindowFocusParams,
+  WindowFocusResult,
+  WindowInfo,
+  WindowListParams,
+  WindowListResult,
+  WindowMinimizeParams,
+  WindowMinimizeResult,
+  WindowMoveParams,
+  WindowMoveResult,
   announcedVersion,
   assertFrameHeader,
   buildToolStatus,