@ai-matrx/desktop-protocol 0.21.2 → 0.21.4

package/dist/index.js

@@ -2,7 +2,7 @@
 import { z } from "zod";
 import { UUID_SHAPE_PATTERN } from "@ai-matrx/kit/uuid";
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 21;
+var PROTOCOL_MINOR = 22;
 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_-]+$/);
@@ -1311,7 +1311,7 @@ var AppsWindowsSaveNamesParams = z13.strictObject({ app_key: AppKey });
 // src/schema/service.ts
 import { z as z14 } from "zod";
 var SERVICE_MAX_FRAME_BYTES = 16777216;
-var ServiceName = z14.enum(["ml", "coding"]);
+var ServiceName = z14.enum(["ml", "coding", "tools"]);
 var ContractHash = z14.string().regex(/^[0-9a-f]{64}$/);
 var ServiceToken = z14.string().regex(/^[A-Za-z0-9_-]{43}$/);
 var ServiceRequestId = u32;
@@ -1446,112 +1446,251 @@ var ClipboardReadResult = z17.strictObject({
 var ClipboardWriteParams = z17.strictObject({ text: z17.string().max(1048576) });
 var ClipboardWriteResult = z17.strictObject({ bytes: nonNegInt });
 
-// src/schema/system.ts
+// src/schema/git.ts
 import { z as z18 } from "zod";
-var SystemOpenUrlParams = z18.strictObject({
+var GIT_MAX_OUTPUT_CHARS = 262144;
+var GitText = z18.string().max(GIT_MAX_OUTPUT_CHARS);
+var GitName = z18.string().min(1).max(255).regex(/^[^-\s][^\s]*$/);
+var GitOutputResult = z18.strictObject({ output: GitText, truncated: z18.boolean() });
+var GitStatusParams = z18.strictObject({ cwd: AbsPath });
+var GitStatusFile = z18.strictObject({
+  path: z18.string(),
+  /** Porcelain v1 status letters: index (staged) and worktree; "?" for untracked. */
+  index: z18.string().length(1),
+  worktree: z18.string().length(1)
+});
+var GitStatusResult = z18.strictObject({
+  /** The checked-out branch; null when HEAD is detached. */
+  branch: z18.string().nullable(),
+  upstream: z18.string().nullable(),
+  ahead: nonNegInt,
+  behind: nonNegInt,
+  files: z18.array(GitStatusFile).max(5e3),
+  clean: z18.boolean(),
+  /** More than 5000 changed files: the list is cut. */
+  truncated: z18.boolean()
+});
+var GitDiffParams = z18.strictObject({ cwd: AbsPath, path: z18.string().max(4096).optional(), staged: z18.boolean().default(false) });
+var GitDiffResult = z18.strictObject({ diff: GitText, truncated: z18.boolean() });
+var GitLogParams = z18.strictObject({ cwd: AbsPath, limit: z18.int().min(1).max(500).default(50) });
+var GitLogCommit = z18.strictObject({ sha: z18.string(), short: z18.string(), author: z18.string(), date: z18.string(), subject: z18.string() });
+var GitLogResult = z18.strictObject({ commits: z18.array(GitLogCommit).max(500) });
+var GitAddParams = z18.strictObject({ cwd: AbsPath, paths: z18.array(z18.string().min(1).max(4096)).min(1).max(1e3) });
+var GitCommitParams = z18.strictObject({
+  cwd: AbsPath,
+  message: z18.string().min(1).max(65536),
+  amend: z18.boolean().default(false),
+  /** "Name <email>"; absent = the computer's own git identity. */
+  author: z18.string().max(512).optional()
+});
+var GitCommitResult = z18.strictObject({ sha: z18.string(), output: GitText, truncated: z18.boolean() });
+var GitPushParams = z18.strictObject({ cwd: AbsPath, remote: GitName.default("origin"), branch: GitName.optional(), force_with_lease: z18.boolean().default(false) });
+var GitPullParams = z18.strictObject({ cwd: AbsPath, remote: GitName.default("origin"), branch: GitName.optional(), rebase: z18.boolean().default(false) });
+var GitBranchParams = z18.strictObject({ cwd: AbsPath, action: z18.enum(["list", "create", "delete", "switch"]), name: GitName.optional() });
+var GitBranchResult = z18.strictObject({
+  /** The branch checked out after the action; null when detached. */
+  current: z18.string().nullable(),
+  /** Local branches (filled by `list`; empty otherwise). */
+  branches: z18.array(z18.string()).max(5e3),
+  output: GitText,
+  truncated: z18.boolean()
+});
+var GitStashParams = z18.strictObject({ cwd: AbsPath, action: z18.enum(["push", "pop", "list", "drop"]), message: z18.string().max(4096).optional() });
+var GitCloneParams = z18.strictObject({
+  url: z18.string().min(1).max(4096).regex(/^[^-]/),
+  /** The folder to create; must not exist yet (or be empty). */
+  dest: AbsPath,
+  branch: GitName.optional(),
+  depth: z18.int().min(1).max(1e6).optional()
+});
+
+// src/schema/web.ts
+import { z as z19 } from "zod";
+var WEB_MAX_TEXT_CHARS = 524288;
+var WebUrl = z19.string().min(1).max(8192).regex(/^https?:\/\//);
+var WebText = z19.string().max(WEB_MAX_TEXT_CHARS);
+var WebHeader = z19.strictObject({ name: z19.string().min(1).max(256), value: z19.string().max(8192) });
+var WebFetchParams = z19.strictObject({
+  url: WebUrl,
+  method: z19.enum(["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"]).default("GET"),
+  headers: z19.array(WebHeader).max(64).default([]),
+  body: z19.string().max(1048576).optional(),
+  follow_redirects: z19.boolean().default(true),
+  timeout_s: z19.int().min(1).max(300).default(30)
+});
+var WebFetchResult = z19.strictObject({
+  status: z19.int().min(100).max(999),
+  reason: z19.string(),
+  /** The final URL after redirects. */
+  url: z19.string(),
+  content_type: z19.string().nullable(),
+  headers: z19.array(WebHeader),
+  body: WebText,
+  truncated: z19.boolean(),
+  bytes: nonNegInt,
+  elapsed_ms: nonNegInt
+});
+var WebScrapeParams = z19.strictObject({
+  urls: z19.array(WebUrl).min(1).max(20),
+  use_cache: z19.boolean().default(true),
+  get_links: z19.boolean().default(false)
+});
+var WebScrapePage = z19.strictObject({
+  url: z19.string(),
+  ok: z19.boolean(),
+  status: z19.int().min(0).max(999).nullable(),
+  title: z19.string().nullable(),
+  /** The page's readable content (markdown-like text from the scraper's parse). */
+  text: WebText,
+  truncated: z19.boolean(),
+  /** Links found on the page (only with get_links). */
+  links: z19.array(z19.string()).max(2e3),
+  /** Why the page failed (blocked, timeout, not found…), in the scraper's words; null when ok. */
+  error: z19.string().nullable(),
+  /** How the page was fetched (http, browser, cache). */
+  via: z19.string().nullable()
+});
+var WebScrapeResult = z19.strictObject({ pages: z19.array(WebScrapePage), elapsed_ms: nonNegInt });
+var WebSearchParams = z19.strictObject({
+  keywords: z19.array(z19.string().min(1).max(400)).min(1).max(5),
+  country: z19.string().min(2).max(2).default("us"),
+  count: z19.int().min(1).max(20).default(10),
+  freshness: z19.enum(["pd", "pw", "pm", "py"]).optional()
+});
+var WebSearchHit = z19.strictObject({ title: z19.string(), url: z19.string(), description: z19.string() });
+var WebSearchQueryResult = z19.strictObject({ keyword: z19.string(), hits: z19.array(WebSearchHit), error: z19.string().nullable() });
+var WebSearchResult = z19.strictObject({ queries: z19.array(WebSearchQueryResult), elapsed_ms: nonNegInt });
+var ToolsWebSearchParams = z19.strictObject({
+  keywords: z19.array(z19.string().min(1).max(400)).min(1).max(5),
+  country: z19.string().min(2).max(2).default("us"),
+  count: z19.int().min(1).max(20).default(10),
+  freshness: z19.enum(["pd", "pw", "pm", "py"]).optional(),
+  brave_api_key: z19.string().min(1).max(512).nullable()
+});
+var WebBrowserFetchParams = z19.strictObject({
+  url: WebUrl,
+  /** A CSS selector to wait for before reading the page. */
+  wait_for: z19.string().max(1024).optional(),
+  wait_timeout_ms: z19.int().min(100).max(12e4).default(3e4),
+  /** true: readable text; false: the rendered HTML. */
+  extract_text: z19.boolean().default(true)
+});
+var WebBrowserFetchResult = z19.strictObject({
+  url: z19.string(),
+  status: z19.int().min(0).max(999).nullable(),
+  title: z19.string().nullable(),
+  content: WebText,
+  truncated: z19.boolean(),
+  elapsed_ms: nonNegInt
+});
+var ToolsServiceProgress = z19.strictObject({ phase: z19.enum(["fetching", "installing"]), done: nonNegInt, total: nonNegInt });
+
+// src/schema/system.ts
+import { z as z20 } from "zod";
+var SystemOpenUrlParams = z20.strictObject({
   /** http, https or mailto; opened in the person's default app for it. */
-  url: z18.string().min(1).max(4096)
+  url: z20.string().min(1).max(4096)
 });
-var SystemOpenUrlResult = z18.strictObject({ url: z18.string().max(4096) });
-var SystemOpenPathParams = z18.strictObject({
+var SystemOpenUrlResult = z20.strictObject({ url: z20.string().max(4096) });
+var SystemOpenPathParams = z20.strictObject({
   path: AbsPath,
   /** Show it in the file manager (Finder, Explorer) instead of opening it. */
-  reveal: z18.boolean().default(false)
+  reveal: z20.boolean().default(false)
 });
-var SystemOpenPathResult = z18.strictObject({ path: AbsPath, revealed: z18.boolean() });
-var SystemNotifyParams = z18.strictObject({
-  title: z18.string().min(1).max(128),
-  body: z18.string().max(1024).default("")
+var SystemOpenPathResult = z20.strictObject({ path: AbsPath, revealed: z20.boolean() });
+var SystemNotifyParams = z20.strictObject({
+  title: z20.string().min(1).max(128),
+  body: z20.string().max(1024).default("")
 });
-var SystemNotifyResult = z18.strictObject({
+var SystemNotifyResult = z20.strictObject({
   /** False when this computer has no notification service to show it (a bare Linux box). */
-  shown: z18.boolean()
+  shown: z20.boolean()
 });
 
 // src/schema/screen.ts
-import { z as z19 } from "zod";
-var ScreenDisplay = z19.strictObject({
+import { z as z21 } from "zod";
+var ScreenDisplay = z21.strictObject({
   /** The OS's display id; pass it to screen.capture. */
   id: nonNegInt,
-  name: z19.string().max(128),
+  name: z21.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: z19.int(),
-  y: z19.int(),
-  width: z19.int().min(1),
-  height: z19.int().min(1),
+  x: z21.int(),
+  y: z21.int(),
+  width: z21.int().min(1),
+  height: z21.int().min(1),
   /** Pixels per point (2 on a Retina display). */
-  scale: z19.number().min(0.1).max(8),
-  primary: z19.boolean()
+  scale: z21.number().min(0.1).max(8),
+  primary: z21.boolean()
 });
-var ScreenListParams = z19.strictObject({});
-var ScreenListResult = z19.strictObject({ displays: z19.array(ScreenDisplay).max(32) });
-var ScreenCaptureParams = z19.strictObject({
+var ScreenListParams = z21.strictObject({});
+var ScreenListResult = z21.strictObject({ displays: z21.array(ScreenDisplay).max(32) });
+var ScreenCaptureParams = z21.strictObject({
   /** The display (from screen.list); the primary display when absent. */
   display_id: nonNegInt.optional(),
-  format: z19.enum(["jpeg", "png"]).default("jpeg"),
+  format: z21.enum(["jpeg", "png"]).default("jpeg"),
   /** Scale the picture down to at most this width in pixels (kept when already smaller). */
-  max_width: z19.int().min(160).max(7680).default(1600)
+  max_width: z21.int().min(160).max(7680).default(1600)
 });
-var ScreenCaptureResult = z19.strictObject({
+var ScreenCaptureResult = z21.strictObject({
   display_id: nonNegInt,
-  mime_type: z19.enum(["image/jpeg", "image/png"]),
-  width: z19.int().min(1),
-  height: z19.int().min(1),
+  mime_type: z21.enum(["image/jpeg", "image/png"]),
+  width: z21.int().min(1),
+  height: z21.int().min(1),
   /** The display's full resolution in pixels, before scaling. */
-  source_width: z19.int().min(1),
-  source_height: z19.int().min(1),
+  source_width: z21.int().min(1),
+  source_height: z21.int().min(1),
   /** The image, base64 (at most 6 MiB of text). */
-  data_base64: z19.string().max(6291456)
+  data_base64: z21.string().max(6291456)
 });
 
 // src/schema/window.ts
-import { z as z20 } from "zod";
-var WindowInfo = z20.strictObject({
+import { z as z22 } from "zod";
+var WindowInfo = z22.strictObject({
   /** The OS's window handle (macOS window number, Windows HWND, X11 window id). */
   id: nonNegInt,
-  title: z20.string().max(512),
+  title: z22.string().max(512),
   /** Position and size in logical points. */
-  x: z20.int(),
-  y: z20.int(),
-  width: z20.int().min(0),
-  height: z20.int().min(0),
+  x: z22.int(),
+  y: z22.int(),
+  width: z22.int().min(0),
+  height: z22.int().min(0),
   /**
    * The application that owns the window, by the name the OS shows people; absent when the OS does
    * not say. Optional (never null, the schema rule) because it was added in protocol 1.7: an older
    * app's answer has no such field (FIELDS_SINCE).
    */
-  app: z20.string().max(256).optional(),
+  app: z22.string().max(256).optional(),
   /** The owning process id; absent when the OS does not say. Added in protocol 1.7. */
-  pid: z20.int().min(0).optional()
+  pid: z22.int().min(0).optional()
 });
-var WindowListParams = z20.strictObject({
+var WindowListParams = z22.strictObject({
   /** Case-insensitive substring of the window title. */
-  title: z20.string().min(1).max(256).optional(),
-  limit: z20.int().min(1).max(500).default(100)
+  title: z22.string().min(1).max(256).optional(),
+  limit: z22.int().min(1).max(500).default(100)
 });
-var WindowListResult = z20.strictObject({
-  windows: z20.array(WindowInfo).max(500),
+var WindowListResult = z22.strictObject({
+  windows: z22.array(WindowInfo).max(500),
   total: nonNegInt,
-  truncated: z20.boolean()
+  truncated: z22.boolean()
 });
-var WindowFocusParams = z20.strictObject({ id: nonNegInt });
-var WindowFocusResult = z20.strictObject({ window: WindowInfo });
-var WindowMoveParams = z20.strictObject({
+var WindowFocusParams = z22.strictObject({ id: nonNegInt });
+var WindowFocusResult = z22.strictObject({ window: WindowInfo });
+var WindowMoveParams = z22.strictObject({
   id: nonNegInt,
   /** New top-left corner; unchanged when absent. */
-  x: z20.int().optional(),
-  y: z20.int().optional(),
+  x: z22.int().optional(),
+  y: z22.int().optional(),
   /** New size; unchanged when absent. */
-  width: z20.int().min(50).max(16384).optional(),
-  height: z20.int().min(50).max(16384).optional()
+  width: z22.int().min(50).max(16384).optional(),
+  height: z22.int().min(50).max(16384).optional()
 });
-var WindowMoveResult = z20.strictObject({ window: WindowInfo });
-var WindowMinimizeParams = z20.strictObject({ id: nonNegInt });
-var WindowMinimizeResult = z20.strictObject({ id: nonNegInt });
+var WindowMoveResult = z22.strictObject({ window: WindowInfo });
+var WindowMinimizeParams = z22.strictObject({ id: nonNegInt });
+var WindowMinimizeResult = z22.strictObject({ id: nonNegInt });
 
 // src/schema/input.ts
-import { z as z21 } from "zod";
-var InputKey = z21.enum([
+import { z as z23 } from "zod";
+var InputKey = z23.enum([
   "cmd",
   "ctrl",
   "alt",
@@ -1631,65 +1770,65 @@ var InputKey = z21.enum([
   "backslash",
   "grave"
 ]);
-var InputTypeTextParams = z21.strictObject({ text: z21.string().min(1).max(1e4) });
-var InputTypeTextResult = z21.strictObject({ characters: z21.int().min(1) });
-var InputHotkeyParams = z21.strictObject({
+var InputTypeTextParams = z23.strictObject({ text: z23.string().min(1).max(1e4) });
+var InputTypeTextResult = z23.strictObject({ characters: z23.int().min(1) });
+var InputHotkeyParams = z23.strictObject({
   /** Pressed together in order and released in reverse: ["cmd", "shift", "t"]. */
-  keys: z21.array(InputKey).min(1).max(6)
+  keys: z23.array(InputKey).min(1).max(6)
 });
-var InputHotkeyResult = z21.strictObject({ keys: z21.array(InputKey) });
-var InputPoint = z21.strictObject({ x: z21.int(), y: z21.int() });
-var InputMouseMoveParams = z21.strictObject({
+var InputHotkeyResult = z23.strictObject({ keys: z23.array(InputKey) });
+var InputPoint = z23.strictObject({ x: z23.int(), y: z23.int() });
+var InputMouseMoveParams = z23.strictObject({
   /** Screen position in logical points (the coordinates screen.list and window.list report). */
-  x: z21.int(),
-  y: z21.int()
+  x: z23.int(),
+  y: z23.int()
 });
-var InputMouseMoveResult = z21.strictObject({
+var InputMouseMoveResult = z23.strictObject({
   /** Where the pointer is now, read back from the OS. */
   position: InputPoint
 });
-var InputMouseClickParams = z21.strictObject({
+var InputMouseClickParams = z23.strictObject({
   /** Move here first; clicks where the pointer is when absent. */
-  x: z21.int().optional(),
-  y: z21.int().optional(),
-  button: z21.enum(["left", "right", "middle"]).default("left"),
-  double: z21.boolean().default(false)
+  x: z23.int().optional(),
+  y: z23.int().optional(),
+  button: z23.enum(["left", "right", "middle"]).default("left"),
+  double: z23.boolean().default(false)
 });
-var InputMouseClickResult = z21.strictObject({
+var InputMouseClickResult = z23.strictObject({
   position: InputPoint,
-  button: z21.enum(["left", "right", "middle"]),
-  double: z21.boolean()
+  button: z23.enum(["left", "right", "middle"]),
+  double: z23.boolean()
 });
 
 // src/schema/power.ts
-import { z as z22 } from "zod";
-var PowerStatusParams = z22.strictObject({});
-var PowerStatusResult = z22.strictObject({
-  has_battery: z22.boolean(),
+import { z as z24 } from "zod";
+var PowerStatusParams = z24.strictObject({});
+var PowerStatusResult = z24.strictObject({
+  has_battery: z24.boolean(),
   /** 0–100; null without a battery. */
-  percent: z22.number().min(0).max(100).nullable(),
-  charging: z22.boolean().nullable(),
+  percent: z24.number().min(0).max(100).nullable(),
+  charging: z24.boolean().nullable(),
   /** On wall power; null where the OS does not say. */
-  plugged_in: z22.boolean().nullable(),
+  plugged_in: z24.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 = z22.strictObject({
+var PowerPreventSleepParams = z24.strictObject({
   /** Keep the computer awake this long; 0 lets it sleep again now. */
-  seconds: z22.int().min(0).max(86400),
+  seconds: z24.int().min(0).max(86400),
   /** Shown where the OS lists what keeps it awake. */
-  reason: z22.string().min(1).max(128).default("Matrx 2 is working")
+  reason: z24.string().min(1).max(128).default("Matrx 2 is working")
 });
-var PowerPreventSleepResult = z22.strictObject({
+var PowerPreventSleepResult = z24.strictObject({
   /** When it may sleep again; null after seconds 0. */
   awake_until_ms: epochMs.nullable()
 });
 
 // src/schema/diag.ts
-import { z as z23 } from "zod";
-var DiagProcess = z23.enum([
+import { z as z25 } from "zod";
+var DiagProcess = z25.enum([
   "main",
   "renderer",
   "hosted_page",
@@ -1702,7 +1841,7 @@ var DiagProcess = z23.enum([
   "coding_sessions",
   "claude_accounts"
 ]);
-var DiagErrorKind = z23.enum([
+var DiagErrorKind = z25.enum([
   "uncaught_exception",
   "unhandled_rejection",
   "renderer_crash",
@@ -1714,148 +1853,148 @@ var DiagErrorKind = z23.enum([
   "banner",
   "logged_error"
 ]);
-var DiagErrorStatus = z23.enum(["waiting", "sent", "resolved"]);
-var DiagErrorEntry = z23.strictObject({
+var DiagErrorStatus = z25.enum(["waiting", "sent", "resolved"]);
+var DiagErrorEntry = z25.strictObject({
   /** sha256 prefix over process, kind, source, code and the normalized message. */
-  signature: z23.string().regex(/^[0-9a-f]{32}$/),
+  signature: z25.string().regex(/^[0-9a-f]{32}$/),
   process: DiagProcess,
   kind: DiagErrorKind,
   /** Where: a cap.op, a log event, a screen or page name. */
-  source: z23.string().min(1).max(128),
+  source: z25.string().min(1).max(128),
   /** An ErrorCode, an exit code or signal, an error class; null when there is none. */
-  code: z23.string().max(64).nullable(),
+  code: z25.string().max(64).nullable(),
   /** The first occurrence's message, personal data removed. */
-  message: z23.string().max(500),
+  message: z25.string().max(500),
   count: nonNegInt,
   first_seen_ms: epochMs,
   last_seen_ms: epochMs,
   status: DiagErrorStatus,
   /** What the agent who resolved it wrote; null until resolved. */
-  resolution_note: z23.string().max(500).nullable(),
-  app_version: z23.string().max(64)
+  resolution_note: z25.string().max(500).nullable(),
+  app_version: z25.string().max(64)
 });
-var DiagErrorsListParams = z23.strictObject({
+var DiagErrorsListParams = z25.strictObject({
   /** open = waiting or sent; all includes resolved. */
-  status: z23.enum(["open", "all"]).default("open"),
-  limit: z23.int().min(1).max(500).default(200)
+  status: z25.enum(["open", "all"]).default("open"),
+  limit: z25.int().min(1).max(500).default(200)
 });
-var DiagErrorsListResult = z23.strictObject({
+var DiagErrorsListResult = z25.strictObject({
   /** Newest last_seen first. */
-  entries: z23.array(DiagErrorEntry).max(500),
+  entries: z25.array(DiagErrorEntry).max(500),
   total_signatures: nonNegInt,
   total_occurrences: nonNegInt,
   /** Signatures with occurrences not yet delivered. */
   waiting: nonNegInt,
   /** signed_out = kept until sign-in; ok = the last delivery worked; failing = the last delivery failed (kept, retried). */
-  delivery: z23.enum(["signed_out", "ok", "failing"]),
+  delivery: z25.enum(["signed_out", "ok", "failing"]),
   last_delivery_ms: epochMs.nullable()
 });
-var DiagErrorsReportParams = z23.strictObject({
-  process: z23.enum(["renderer", "hosted_page"]),
-  kind: z23.enum(["uncaught_exception", "unhandled_rejection", "console_error", "banner"]),
+var DiagErrorsReportParams = z25.strictObject({
+  process: z25.enum(["renderer", "hosted_page"]),
+  kind: z25.enum(["uncaught_exception", "unhandled_rejection", "console_error", "banner"]),
   /** The screen or page, e.g. "code.chats". */
-  source: z23.string().min(1).max(128),
-  message: z23.string().min(1).max(2e3),
-  code: z23.string().max(64).optional(),
-  stack: z23.string().max(8e3).optional()
+  source: z25.string().min(1).max(128),
+  message: z25.string().min(1).max(2e3),
+  code: z25.string().max(64).optional(),
+  stack: z25.string().max(8e3).optional()
 });
-var DiagErrorsReportResult = z23.strictObject({
-  signature: z23.string().regex(/^[0-9a-f]{32}$/)
+var DiagErrorsReportResult = z25.strictObject({
+  signature: z25.string().regex(/^[0-9a-f]{32}$/)
 });
-var DiagErrorsChangedEvent = z23.strictObject({
+var DiagErrorsChangedEvent = z25.strictObject({
   total_signatures: nonNegInt,
   waiting: nonNegInt
 });
 
 // src/schema/resources.ts
-import { z as z24 } from "zod";
-var ResourcesDisk = z24.strictObject({
+import { z as z26 } from "zod";
+var ResourcesDisk = z26.strictObject({
   /** Where it is mounted ("/", "C:"). */
-  mount: z24.string().max(512),
+  mount: z26.string().max(512),
   /** The volume's name as the file manager shows it ("Macintosh HD", "Local Disk (C:)"). Since 1.17. */
-  name: z24.string().max(256).optional(),
+  name: z26.string().max(256).optional(),
   /** The file system ("apfs", "NTFS", "ext4"). */
-  fs: z24.string().max(64),
+  fs: z26.string().max(64),
   size_bytes: nonNegInt,
   used_bytes: nonNegInt,
   available_bytes: nonNegInt
 });
-var ResourcesSnapshotParams = z24.strictObject({});
-var ResourcesSnapshotResult = z24.strictObject({
-  cpu: z24.strictObject({
+var ResourcesSnapshotParams = z26.strictObject({});
+var ResourcesSnapshotResult = z26.strictObject({
+  cpu: z26.strictObject({
     /** Busy share of all cores, 0–100, measured now. */
-    percent: z24.number().min(0).max(100),
-    cores: z24.int().min(1),
+    percent: z26.number().min(0).max(100),
+    cores: z26.int().min(1),
     /** 1, 5 and 15 minute load averages; null on Windows. */
-    load: z24.array(z24.number().min(0)).length(3).nullable()
+    load: z26.array(z26.number().min(0)).length(3).nullable()
   }),
-  memory: z24.strictObject({ total_bytes: nonNegInt, used_bytes: nonNegInt, available_bytes: nonNegInt }),
-  swap: z24.strictObject({ total_bytes: nonNegInt, used_bytes: nonNegInt }),
-  disks: z24.array(ResourcesDisk).max(64),
+  memory: z26.strictObject({ total_bytes: nonNegInt, used_bytes: nonNegInt, available_bytes: nonNegInt }),
+  swap: z26.strictObject({ total_bytes: nonNegInt, used_bytes: nonNegInt }),
+  disks: z26.array(ResourcesDisk).max(64),
   uptime_seconds: nonNegInt
 });
-var ResourcesJobKind = z24.enum(["type-check", "tests", "build", "lint", "dev server", "language server", "search"]);
-var ResourcesStrain = z24.enum(["good", "strain", "overloaded"]);
-var ResourcesPressure = z24.enum(["normal", "warning", "critical"]);
-var ResourcesJob = z24.strictObject({
+var ResourcesJobKind = z26.enum(["type-check", "tests", "build", "lint", "dev server", "language server", "search"]);
+var ResourcesStrain = z26.enum(["good", "strain", "overloaded"]);
+var ResourcesPressure = z26.enum(["normal", "warning", "critical"]);
+var ResourcesJob = z26.strictObject({
   /** The job's root process (Stop takes its whole tree). */
-  pid: z24.int().min(0),
+  pid: z26.int().min(0),
   kind: ResourcesJobKind,
   /** Its heaviest process's command line, shortened ("…/lib/tsc --noEmit -p tsconfig.json"). */
-  command: z24.string().max(256),
+  command: z26.string().max(256),
   /** Who started it: "Claude Code", "Codex", "Cursor", "VS Code", "Terminal", "local stack", "detached"; null when unknown. */
-  started_by: z24.string().max(64).nullable(),
+  started_by: z26.string().max(64).nullable(),
   /** Whatever started it is gone and nothing waits for it. */
-  orphan: z24.boolean(),
+  orphan: z26.boolean(),
   /** A type-check queued for its turn (no compiler running yet). */
-  waiting: z24.boolean(),
+  waiting: z26.boolean(),
   /** The project folder it runs in ("matrx-frontend"); null when not in one. */
-  folder: z24.string().max(256).nullable(),
+  folder: z26.string().max(256).nullable(),
   /** The same command in the same folder, running this many times (1 = no duplicate). */
-  duplicates: z24.int().min(1),
-  processes: z24.int().min(1),
+  duplicates: z26.int().min(1),
+  processes: z26.int().min(1),
   /** Sum over the tree, as `ps` reports it: 100 = one full core. */
-  cpu_percent: z24.number().min(0),
+  cpu_percent: z26.number().min(0),
   /** Real memory (macOS: the physical footprint Activity Monitor shows, compressed included). */
   memory_bytes: nonNegInt,
   started_at_ms: epochMs.nullable(),
   /** False for an app, an agent session, a terminal, a system process, the local stack or Matrx 2 itself. */
-  stoppable: z24.boolean()
+  stoppable: z26.boolean()
 });
-var ResourcesProcess = z24.strictObject({
-  pid: z24.int().min(0),
+var ResourcesProcess = z26.strictObject({
+  pid: z26.int().min(0),
   /** The command line, shortened. */
-  name: z24.string().max(256),
-  cpu_percent: z24.number().min(0),
+  name: z26.string().max(256),
+  cpu_percent: z26.number().min(0),
   memory_bytes: nonNegInt,
-  started_by: z24.string().max(64).nullable(),
+  started_by: z26.string().max(64).nullable(),
   /** The job it belongs to ("type-check in aidream"); null when none. */
-  job: z24.string().max(256).nullable(),
+  job: z26.string().max(256).nullable(),
   started_at_ms: epochMs.nullable()
 });
-var ResourcesVerdict = z24.strictObject({
+var ResourcesVerdict = z26.strictObject({
   level: ResourcesStrain,
   /** One sentence ("Your Mac is under strain. 3 type-checks are running at once."). */
-  text: z24.string().max(256),
+  text: z26.string().max(256),
   /** The biggest jobs behind it; null when all is well. */
-  cause: z24.string().max(1024).nullable()
+  cause: z26.string().max(1024).nullable()
 });
-var ResourcesSample = z24.strictObject({
+var ResourcesSample = z26.strictObject({
   at_ms: epochMs,
   /** The 1-minute load average. */
-  load: z24.number().min(0),
+  load: z26.number().min(0),
   memory_used_bytes: nonNegInt,
   typechecks: nonNegInt
 });
-var ResourcesActivityParams = z24.strictObject({});
-var ResourcesActivityResult = z24.strictObject({
+var ResourcesActivityParams = z26.strictObject({});
+var ResourcesActivityResult = z26.strictObject({
   /** False until the first reading (a second or two after start). */
-  ready: z24.boolean(),
+  ready: z26.boolean(),
   sampled_at_ms: epochMs.nullable(),
-  cores: z24.int().min(1),
+  cores: z26.int().min(1),
   /** 1, 5 and 15 minute load averages. */
-  load: z24.array(z24.number().min(0)).length(3),
-  memory: z24.strictObject({
+  load: z26.array(z26.number().min(0)).length(3),
+  memory: z26.strictObject({
     total_bytes: nonNegInt,
     /** Activity Monitor's Memory Used: app memory + wired + compressed. */
     used_bytes: nonNegInt,
@@ -1866,252 +2005,252 @@ var ResourcesActivityResult = z24.strictObject({
     pressure: ResourcesPressure.nullable()
   }),
   verdict: ResourcesVerdict,
-  typechecks: z24.strictObject({ running: nonNegInt, waiting: nonNegInt, comfort: nonNegInt }),
+  typechecks: z26.strictObject({ running: nonNegInt, waiting: nonNegInt, comfort: nonNegInt }),
   /** Heaviest first (1 GB weighs as much as 16 % of a core). */
-  jobs: z24.array(ResourcesJob).max(200),
+  jobs: z26.array(ResourcesJob).max(200),
   /** The 15 heaviest by memory and the 15 busiest by CPU, together. */
-  top: z24.array(ResourcesProcess).max(30),
+  top: z26.array(ResourcesProcess).max(30),
   /** The last hour, oldest first. */
-  history: z24.array(ResourcesSample).max(1200)
+  history: z26.array(ResourcesSample).max(1200)
 });
-var ResourcesStopJobParams = z24.strictObject({ pid: z24.int().min(1) });
-var ResourcesStopJobResult = z24.strictObject({
+var ResourcesStopJobParams = z26.strictObject({ pid: z26.int().min(1) });
+var ResourcesStopJobResult = z26.strictObject({
   /** Processes signalled; whatever is still running 5 seconds later is force-stopped. */
   processes: nonNegInt,
   /** It had finished before the request arrived. */
-  already_finished: z24.boolean()
+  already_finished: z26.boolean()
 });
-var ResourcesIncident = z24.strictObject({
+var ResourcesIncident = z26.strictObject({
   at_ms: epochMs,
   verdict: ResourcesVerdict,
-  load: z24.number().min(0),
+  load: z26.number().min(0),
   memory_used_bytes: nonNegInt,
   compressed_bytes: nonNegInt,
   pressure: ResourcesPressure.nullable(),
-  jobs: z24.array(
-    z24.strictObject({
+  jobs: z26.array(
+    z26.strictObject({
       kind: ResourcesJobKind,
-      started_by: z24.string().max(64).nullable(),
-      folder: z24.string().max(256).nullable(),
-      command: z24.string().max(256),
-      cpu_percent: z24.number().min(0),
+      started_by: z26.string().max(64).nullable(),
+      folder: z26.string().max(256).nullable(),
+      command: z26.string().max(256),
+      cpu_percent: z26.number().min(0),
       memory_bytes: nonNegInt,
-      duplicates: z24.int().min(1)
+      duplicates: z26.int().min(1)
     })
   ).max(8)
 });
-var ResourcesIncidentsParams = z24.strictObject({ limit: z24.int().min(1).max(200).default(50) });
-var ResourcesIncidentsResult = z24.strictObject({
+var ResourcesIncidentsParams = z26.strictObject({ limit: z26.int().min(1).max(200).default(50) });
+var ResourcesIncidentsResult = z26.strictObject({
   /** Newest first; at most one a minute is written. */
-  incidents: z24.array(ResourcesIncident).max(200)
+  incidents: z26.array(ResourcesIncident).max(200)
 });
 
 // src/schema/stack.ts
-import { z as z25 } from "zod";
-var StackServerName = z25.string().regex(/^[a-z0-9_-]{1,64}$/);
-var StackTone = z25.enum(["good", "wait", "bad", "off"]);
-var StackServer = z25.strictObject({
+import { z as z27 } from "zod";
+var StackServerName = z27.string().regex(/^[a-z0-9_-]{1,64}$/);
+var StackTone = z27.enum(["good", "wait", "bad", "off"]);
+var StackServer = z27.strictObject({
   name: StackServerName,
   /** One word: Healthy, Starting, Unhealthy, Restarting, Stopping, Waiting, Stopped, Crashed, Off. */
-  label: z25.string().max(32),
+  label: z27.string().max(32),
   tone: StackTone,
   /** What is going on, in one or two plain sentences. */
-  sentence: z25.string().max(2e3),
+  sentence: z27.string().max(2e3),
   /** The config's own description of the server. */
-  description: z25.string().max(512),
+  description: z27.string().max(512),
   /** Where the server answers, when its description names an address. */
-  open_url: z25.string().max(2048).nullable(),
-  log_file: z25.string().max(4096),
+  open_url: z27.string().max(2048).nullable(),
+  log_file: z27.string().max(4096),
   /** When its log file was last written. */
   last_output_at_ms: epochMs.nullable(),
   started_at_ms: epochMs.nullable(),
   restarts: nonNegInt,
-  exit_code: z25.int().nullable(),
-  pid: z25.int().nullable(),
+  exit_code: z27.int().nullable(),
+  pid: z27.int().nullable(),
   /** (1.18) CPU of the server's process and everything under it, in percent of one core; absent when it is not running. */
-  cpu_percent: z25.number().min(0).optional(),
+  cpu_percent: z27.number().min(0).optional(),
   /** (1.18) Memory of the same processes: the physical footprint (Activity Monitor's Memory) summed; absent when it is not running. */
   memory_bytes: nonNegInt.optional()
 });
-var StackEvent = z25.strictObject({
+var StackEvent = z27.strictObject({
   at_ms: epochMs,
   /** A server name, or "stack" for the stack as a whole. */
-  server: z25.string().max(64),
+  server: z27.string().max(64),
   /** started · stopped · healthy · unhealthy · crashed · exited · restarting · stopping · action · action-done · action-failed · setup · error */
-  kind: z25.string().max(32),
-  text: z25.string().max(4e3)
+  kind: z27.string().max(32),
+  text: z27.string().max(4e3)
 });
-var StackStateParams = z25.strictObject({});
-var StackStateResult = z25.strictObject({
+var StackStateParams = z27.strictObject({});
+var StackStateResult = z27.strictObject({
   /** The stack's config file, when found. */
-  config_path: z25.string().max(4096).nullable(),
+  config_path: z27.string().max(4096).nullable(),
   /** Why the stack cannot be run from here (no config, no process-compose), else null. */
-  problem: z25.string().max(1e3).nullable(),
-  stack_up: z25.boolean(),
+  problem: z27.string().max(1e3).nullable(),
+  stack_up: z27.boolean(),
   stack_started_at_ms: epochMs.nullable(),
-  servers: z25.array(StackServer).max(64),
+  servers: z27.array(StackServer).max(64),
   /** One line about the one-shot setup steps ("Docker Desktop: running."), or null. */
-  setup_note: z25.string().max(500).nullable(),
+  setup_note: z27.string().max(500).nullable(),
   /** Start everything / Stop everything in flight. */
-  pending: z25.strictObject({ verb: z25.enum(["start", "stop"]), label: z25.string().max(64), since_ms: epochMs }).nullable(),
+  pending: z27.strictObject({ verb: z27.enum(["start", "stop"]), label: z27.string().max(64), since_ms: epochMs }).nullable(),
   /** The newest entries last. */
-  events: z25.array(StackEvent).max(300)
+  events: z27.array(StackEvent).max(300)
 });
-var StackStartParams = z25.strictObject({});
-var StackStopParams = z25.strictObject({});
-var StackRunResult = z25.strictObject({ accepted: z25.boolean() });
-var StackServerActionParams = z25.strictObject({
+var StackStartParams = z27.strictObject({});
+var StackStopParams = z27.strictObject({});
+var StackRunResult = z27.strictObject({ accepted: z27.boolean() });
+var StackServerActionParams = z27.strictObject({
   name: StackServerName,
-  verb: z25.enum(["start", "stop", "restart"])
+  verb: z27.enum(["start", "stop", "restart"])
 });
-var StackServerActionResult = z25.strictObject({ message: z25.string().max(1e3) });
-var StackLogsParams = z25.strictObject({
+var StackServerActionResult = z27.strictObject({ message: z27.string().max(1e3) });
+var StackLogsParams = z27.strictObject({
   name: StackServerName,
   /** Without `offset`: the last this-many complete lines. With it: new lines after it, at most this many. */
-  lines: z25.int().min(1).max(2e5).default(2e3),
+  lines: z27.int().min(1).max(2e5).default(2e3),
   /** Byte offset the last read ended at: answer only what was written after it (follow). */
   offset: nonNegInt.optional(),
   /** A "Clear" point: the lines written after this byte offset (no `offset`). */
   since: nonNegInt.optional(),
   /** With `offset`: wait up to this long for a new line when none is waiting (0 answers at once). */
-  wait_ms: z25.int().min(0).max(25e3).default(0)
+  wait_ms: z27.int().min(0).max(25e3).default(0)
 });
-var StackLogsResult = z25.strictObject({
+var StackLogsResult = z27.strictObject({
   /** Complete lines, colour codes removed. */
-  lines: z25.array(z25.string().max(65536)).max(2e5),
+  lines: z27.array(z27.string().max(65536)).max(2e5),
   /** Where these lines end: pass it back as `offset` to follow. */
   offset: nonNegInt,
   /** False when `since` no longer exists (the log rotated): the lines are the plain tail instead. */
-  since_valid: z25.boolean(),
+  since_valid: z27.boolean(),
   /** The log was rotated or truncated since `offset`: these lines start the file again. */
-  reset: z25.boolean(),
-  log_file: z25.string().max(4096)
+  reset: z27.boolean(),
+  log_file: z27.string().max(4096)
 });
-var StackErrorsParams = z25.strictObject({
-  window_minutes: z25.int().min(1).max(1440).default(60)
+var StackErrorsParams = z27.strictObject({
+  window_minutes: z27.int().min(1).max(1440).default(60)
 });
-var StackErrorsResult = z25.strictObject({
+var StackErrorsResult = z27.strictObject({
   /** Per server: a heading line ("=== aidream — errors in the last 60 minutes (<file>) ===") and each error with the 10 lines after it. */
-  sections: z25.array(z25.strictObject({ name: StackServerName, heading: z25.string().max(4096), lines: z25.array(z25.string().max(65536)).max(5e3) })).max(64),
-  window_minutes: z25.int().min(1).max(1440)
+  sections: z27.array(z27.strictObject({ name: StackServerName, heading: z27.string().max(4096), lines: z27.array(z27.string().max(65536)).max(5e3) })).max(64),
+  window_minutes: z27.int().min(1).max(1440)
 });
 
 // src/schema/audio.ts
-import { z as z26 } from "zod";
-var AudioDevice = z26.strictObject({
+import { z as z28 } from "zod";
+var AudioDevice = z28.strictObject({
   /** The OS's name for it, as audio.record takes it. */
-  id: z26.string().min(1).max(256),
-  name: z26.string().max(256),
-  default: z26.boolean()
+  id: z28.string().min(1).max(256),
+  name: z28.string().max(256),
+  default: z28.boolean()
 });
-var AudioDevicesParams = z26.strictObject({});
-var AudioDevicesResult = z26.strictObject({
-  inputs: z26.array(AudioDevice).max(64),
-  outputs: z26.array(AudioDevice).max(64)
+var AudioDevicesParams = z28.strictObject({});
+var AudioDevicesResult = z28.strictObject({
+  inputs: z28.array(AudioDevice).max(64),
+  outputs: z28.array(AudioDevice).max(64)
 });
-var AudioRecordParams = z26.strictObject({
-  seconds: z26.number().min(0.5).max(600),
+var AudioRecordParams = z28.strictObject({
+  seconds: z28.number().min(0.5).max(600),
   /** The microphone (from audio.devices); the default input when absent. */
-  device_id: z26.string().min(1).max(256).optional(),
+  device_id: z28.string().min(1).max(256).optional(),
   /** Where the WAV file goes; a new file in the temp folder when absent. */
   path: AbsPath.optional()
 });
-var AudioRecordResult = z26.strictObject({
+var AudioRecordResult = z28.strictObject({
   path: AbsPath,
-  seconds: z26.number().min(0),
+  seconds: z28.number().min(0),
   bytes: nonNegInt,
   /** Loudest sample, 0–1: 0 means the device gave silence. */
-  peak: z26.number().min(0).max(1)
+  peak: z28.number().min(0).max(1)
 });
-var AudioPlayParams = z26.strictObject({ path: AbsPath });
-var AudioPlayResult = z26.strictObject({ path: AbsPath, seconds: z26.number().min(0) });
+var AudioPlayParams = z28.strictObject({ path: AbsPath });
+var AudioPlayResult = z28.strictObject({ path: AbsPath, seconds: z28.number().min(0) });
 
 // src/schema/fs-watch.ts
-import { z as z27 } from "zod";
-var FsWatchId = z27.string().regex(/^fw_[A-Za-z0-9]{12,40}$/);
-var FsWatchStartParams = z27.strictObject({
+import { z as z29 } from "zod";
+var FsWatchId = z29.string().regex(/^fw_[A-Za-z0-9]{12,40}$/);
+var FsWatchStartParams = z29.strictObject({
   path: AbsPath,
-  recursive: z27.boolean().default(true),
+  recursive: z29.boolean().default(true),
   /** Globs relative to `path` whose changes are not reported (".git/**", "node_modules/**"). */
-  ignore: z27.array(z27.string().max(256)).max(64).default([])
+  ignore: z29.array(z29.string().max(256)).max(64).default([])
 });
-var FsWatchStartResult = z27.strictObject({
+var FsWatchStartResult = z29.strictObject({
   watch_id: FsWatchId,
   path: AbsPath,
   /** The watch ends by itself if nobody reads it for 30 minutes. */
   expires_at_ms: epochMs
 });
-var FsWatchEventsParams = z27.strictObject({
+var FsWatchEventsParams = z29.strictObject({
   watch_id: FsWatchId,
   /** Wait up to this long for a first change when none is waiting (0 answers at once). */
-  wait_ms: z27.int().min(0).max(25e3).default(0)
+  wait_ms: z29.int().min(0).max(25e3).default(0)
 });
-var FsWatchEventsResult = z27.strictObject({
+var FsWatchEventsResult = z29.strictObject({
   /** What changed since the last read, oldest first; re-checked against the disk when read. */
-  changes: z27.array(FsChange).max(1e3),
+  changes: z29.array(FsChange).max(1e3),
   /** Changes were dropped (more than 1000 waited): list the folder again. */
-  overflow: z27.boolean(),
+  overflow: z29.boolean(),
   expires_at_ms: epochMs
 });
-var FsWatchStopParams = z27.strictObject({ watch_id: FsWatchId });
-var FsWatchStopResult = z27.strictObject({ watch_id: FsWatchId });
+var FsWatchStopParams = z29.strictObject({ watch_id: FsWatchId });
+var FsWatchStopResult = z29.strictObject({ watch_id: FsWatchId });
 
 // src/schema/exec-job.ts
-import { z as z28 } from "zod";
-var ExecJobId = z28.string().regex(/^job_[A-Za-z0-9]{12,40}$/);
-var ExecJobStartParams = z28.strictObject({
-  command: z28.string().min(1).max(131072),
+import { z as z30 } from "zod";
+var ExecJobId = z30.string().regex(/^job_[A-Za-z0-9]{12,40}$/);
+var ExecJobStartParams = z30.strictObject({
+  command: z30.string().min(1).max(131072),
   /** The folder it runs in; the home folder when absent. */
   cwd: AbsPath.optional(),
-  env: z28.record(z28.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).max(128), z28.string().max(32768)).optional()
+  env: z30.record(z30.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).max(128), z30.string().max(32768)).optional()
 });
-var ExecJobStartResult = z28.strictObject({ job_id: ExecJobId, pid: z28.int().min(1), cwd: AbsPath });
-var ExecJobOutputParams = z28.strictObject({
+var ExecJobStartResult = z30.strictObject({ job_id: ExecJobId, pid: z30.int().min(1), cwd: AbsPath });
+var ExecJobOutputParams = z30.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: z28.int().min(0).max(25e3).default(0),
-  max_bytes: z28.int().min(1024).max(1048576).default(65536)
+  wait_ms: z30.int().min(0).max(25e3).default(0),
+  max_bytes: z30.int().min(1024).max(1048576).default(65536)
 });
-var ExecJobOutputResult = z28.strictObject({
+var ExecJobOutputResult = z30.strictObject({
   /** stdout and stderr interleaved as they arrived (UTF-8). */
-  output: z28.string(),
+  output: z30.string(),
   next_offset: nonNegInt,
   /** Bytes before `offset` that are gone (the job keeps its last 4 MiB). */
   dropped_bytes: nonNegInt,
-  running: z28.boolean(),
-  exit_code: z28.int().nullable()
+  running: z30.boolean(),
+  exit_code: z30.int().nullable()
 });
-var ExecJobStopParams = z28.strictObject({
+var ExecJobStopParams = z30.strictObject({
   job_id: ExecJobId,
   /** End it at once (SIGKILL; on Windows the whole tree with /F) instead of asking it to quit. */
-  force: z28.boolean().default(false)
+  force: z30.boolean().default(false)
 });
-var ExecJobStopResult = z28.strictObject({ job_id: ExecJobId, exited: z28.boolean(), exit_code: z28.int().nullable() });
-var ExecJobInfo = z28.strictObject({
+var ExecJobStopResult = z30.strictObject({ job_id: ExecJobId, exited: z30.boolean(), exit_code: z30.int().nullable() });
+var ExecJobInfo = z30.strictObject({
   job_id: ExecJobId,
-  command: z28.string().max(1024),
-  pid: z28.int().min(1),
+  command: z30.string().max(1024),
+  pid: z30.int().min(1),
   cwd: AbsPath,
-  running: z28.boolean(),
-  exit_code: z28.int().nullable(),
+  running: z30.boolean(),
+  exit_code: z30.int().nullable(),
   started_at_ms: epochMs,
   output_bytes: nonNegInt
 });
-var ExecJobListParams = z28.strictObject({});
-var ExecJobListResult = z28.strictObject({ jobs: z28.array(ExecJobInfo).max(64) });
+var ExecJobListParams = z30.strictObject({});
+var ExecJobListResult = z30.strictObject({ jobs: z30.array(ExecJobInfo).max(64) });
 
 // src/schema/coding.ts
-import { z as z29 } from "zod";
+import { z as z31 } from "zod";
 import { UUID_SHAPE_PATTERN as UUID_SHAPE_PATTERN3 } from "@ai-matrx/kit/uuid";
-var CodingServiceCredentials = z29.strictObject({
-  access_token: z29.string().min(16).max(16384),
-  user_id: z29.string().regex(UUID_SHAPE_PATTERN3),
+var CodingServiceCredentials = z31.strictObject({
+  access_token: z31.string().min(16).max(16384),
+  user_id: z31.string().regex(UUID_SHAPE_PATTERN3),
   /** The AI Matrx server this app talks to (production, or a local server on the nightly copy). */
-  server_url: z29.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
+  server_url: z31.string().min(1).max(2048).regex(/^https?:\/\/[^\s/?#]+(\/[^\s?#]*)?$/)
 });
-var CodingHistoryBlocked = z29.enum([
+var CodingHistoryBlocked = z31.enum([
   "signed_out",
   "offline",
   "organization_required",
@@ -2119,11 +2258,11 @@ var CodingHistoryBlocked = z29.enum([
   "cloud_list_unavailable",
   "history_too_large"
 ]);
-var CodingHistoryFailure = z29.strictObject({
-  session_id: z29.string().max(64),
-  reason: z29.string().max(300)
+var CodingHistoryFailure = z31.strictObject({
+  session_id: z31.string().max(64),
+  reason: z31.string().max(300)
 });
-var CodingHistoryRun = z29.strictObject({
+var CodingHistoryRun = z31.strictObject({
   /** Claude Code sessions found on this computer. */
   local_sessions: nonNegInt,
   /** Of those, already complete in AI Matrx. */
@@ -2138,39 +2277,39 @@ var CodingHistoryRun = z29.strictObject({
   /** Changed while being read; a later run takes them. */
   changed: nonNegInt,
   failed: nonNegInt,
-  failures: z29.array(CodingHistoryFailure).max(20),
+  failures: z31.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: z29.string().max(400)
+  summary: z31.string().max(400)
 });
-var CodingHistoryStep = z29.strictObject({
+var CodingHistoryStep = z31.strictObject({
   /** Null when the run could not start (blocked before a plan existed). */
-  plan_id: z29.string().regex(/^[0-9a-f]{32}$/).nullable(),
-  finished: z29.boolean(),
+  plan_id: z31.string().regex(/^[0-9a-f]{32}$/).nullable(),
+  finished: z31.boolean(),
   blocked: CodingHistoryBlocked.nullable(),
   run: CodingHistoryRun
 });
-var CodingPlanMissingParams = z29.strictObject({ credentials: CodingServiceCredentials.nullable() });
-var CodingImportNextParams = z29.strictObject({
-  plan_id: z29.string().regex(/^[0-9a-f]{32}$/),
+var CodingPlanMissingParams = z31.strictObject({ credentials: CodingServiceCredentials.nullable() });
+var CodingImportNextParams = z31.strictObject({
+  plan_id: z31.string().regex(/^[0-9a-f]{32}$/),
   credentials: CodingServiceCredentials.nullable()
 });
-var CodingServiceProgress = z29.strictObject({
-  phase: z29.enum(["checking", "importing"]),
+var CodingServiceProgress = z31.strictObject({
+  phase: z31.enum(["checking", "importing"]),
   done: nonNegInt,
   total: nonNegInt
 });
-var CodingHistoryImportMissingParams = z29.strictObject({});
-var CodingHistoryImportMissingResult = z29.strictObject({
-  state: z29.enum(["done", "blocked", "cancelled"]),
+var CodingHistoryImportMissingParams = z31.strictObject({});
+var CodingHistoryImportMissingResult = z31.strictObject({
+  state: z31.enum(["done", "blocked", "cancelled"]),
   blocked: CodingHistoryBlocked.nullable(),
   run: CodingHistoryRun,
   elapsed_ms: nonNegInt
 });
-var CodingHistoryProgressEvent = z29.strictObject({
+var CodingHistoryProgressEvent = z31.strictObject({
   request_id: RequestId,
-  phase: z29.enum(["checking", "importing"]),
+  phase: z31.enum(["checking", "importing"]),
   /** Sessions settled so far, of `total` candidates (0 of 0 while checking). */
   done: nonNegInt,
   total: nonNegInt,
@@ -2292,7 +2431,23 @@ var OPS = {
   // 1.21: what a window's sidebar draws (the Move-all grouping check).
   "apps.windows.shown": { params: AppsWindowsShownParams, result: AppsWindowsShownResult, kind: "unary", since: "1.21", errors: ["NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "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"] }
+  "coding.history.import_missing": { params: CodingHistoryImportMissingParams, result: CodingHistoryImportMissingResult, kind: "unary", since: "1.5", errors: ["RESOURCE_BUSY", "RESOURCE_GONE", "CANCELLED", "INTERNAL"] },
+  // 1.22: git for agents (core `git`, the system git; the cloud sandbox's /git/* set, SPEC 6.1).
+  "git.status": { params: GitStatusParams, result: GitStatusResult, kind: "unary", since: "1.22", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "git.diff": { params: GitDiffParams, result: GitDiffResult, kind: "unary", since: "1.22", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "git.log": { params: GitLogParams, result: GitLogResult, kind: "unary", since: "1.22", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "git.add": { params: GitAddParams, result: GitOutputResult, kind: "unary", since: "1.22", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "git.commit": { params: GitCommitParams, result: GitCommitResult, kind: "unary", since: "1.22", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "git.push": { params: GitPushParams, result: GitOutputResult, kind: "unary", since: "1.22", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "git.pull": { params: GitPullParams, result: GitOutputResult, kind: "unary", since: "1.22", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "git.branch": { params: GitBranchParams, result: GitBranchResult, kind: "unary", since: "1.22", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "git.stash": { params: GitStashParams, result: GitOutputResult, kind: "unary", since: "1.22", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "git.clone": { params: GitCloneParams, result: GitOutputResult, kind: "unary", since: "1.22", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  // 1.22: the web from this computer (the `tools` Python service: matrx_scraper's local lane).
+  "web.fetch": { params: WebFetchParams, result: WebFetchResult, kind: "unary", since: "1.22", errors: ["INVALID_PARAMS", "TIMEOUT", "RESOURCE_BUSY", "AUTH_REQUIRED", "INTERNAL"] },
+  "web.scrape": { params: WebScrapeParams, result: WebScrapeResult, kind: "unary", since: "1.22", errors: ["INVALID_PARAMS", "TIMEOUT", "RESOURCE_BUSY", "AUTH_REQUIRED", "INTERNAL"] },
+  "web.search": { params: WebSearchParams, result: WebSearchResult, kind: "unary", since: "1.22", errors: ["INVALID_PARAMS", "TIMEOUT", "RESOURCE_BUSY", "AUTH_REQUIRED", "INTERNAL"] },
+  "web.fetch_with_browser": { params: WebBrowserFetchParams, result: WebBrowserFetchResult, kind: "unary", since: "1.22", errors: ["INVALID_PARAMS", "TIMEOUT", "RESOURCE_BUSY", "AUTH_REQUIRED", "INTERNAL"] }
 };
 var EVENTS = {
   "fs.changed": FsChangedEvent,
@@ -2323,6 +2478,15 @@ var SERVICES = {
       "coding.plan_missing": { params: CodingPlanMissingParams, result: CodingHistoryStep },
       "coding.import_next": { params: CodingImportNextParams, result: CodingHistoryStep }
     }
+  },
+  tools: {
+    progress: ToolsServiceProgress,
+    ops: {
+      "tools.web_fetch": { params: WebFetchParams, result: WebFetchResult },
+      "tools.web_scrape": { params: WebScrapeParams, result: WebScrapeResult },
+      "tools.web_search": { params: ToolsWebSearchParams, result: WebSearchResult },
+      "tools.web_browser_fetch": { params: WebBrowserFetchParams, result: WebBrowserFetchResult }
+    }
   }
 };
 var NAMED_SCHEMAS = {
@@ -2684,7 +2848,39 @@ var NAMED_SCHEMAS = {
   AppsWindowsProcessesParams,
   AppsWindowsProcessesResult,
   AppsWindowsAddParams,
-  AppsWindowsSaveNamesParams
+  AppsWindowsSaveNamesParams,
+  GitOutputResult,
+  GitStatusParams,
+  GitStatusFile,
+  GitStatusResult,
+  GitDiffParams,
+  GitDiffResult,
+  GitLogParams,
+  GitLogCommit,
+  GitLogResult,
+  GitAddParams,
+  GitCommitParams,
+  GitCommitResult,
+  GitPushParams,
+  GitPullParams,
+  GitBranchParams,
+  GitBranchResult,
+  GitStashParams,
+  GitCloneParams,
+  WebHeader,
+  WebFetchParams,
+  WebFetchResult,
+  WebScrapeParams,
+  WebScrapePage,
+  WebScrapeResult,
+  WebSearchParams,
+  WebSearchHit,
+  WebSearchQueryResult,
+  WebSearchResult,
+  ToolsWebSearchParams,
+  WebBrowserFetchParams,
+  WebBrowserFetchResult,
+  ToolsServiceProgress
 };
 
 // src/versioning.ts
@@ -2830,7 +3026,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [.../* @__PURE__ */ new Set([...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys(), ...NESTED_RESULTS.keys()])];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "5745ca5b70c283eadfce68d0c66c06207405b60c7e112cb75aca7ff29b15d12e";
+var CONTRACT_SHA256 = "ac2b599f9511abd871a7374e298fab94a25972512797689c8022da288a5f2e06";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -2863,7 +3059,7 @@ var TOOL_GROUPS = [
   { id: "files_shell", order: 1, title: "Files and shell", owner: "core" },
   { id: "os_control", order: 2, title: "Computer control", owner: "core" },
   { id: "personal_automation", order: 3, title: "Personal apps and automation", owner: "core" },
-  { id: "tools_service", order: 4, title: "Documents, OCR and entities", owner: "python_tools" },
+  { id: "tools_service", order: 4, title: "Web, documents, OCR and entities", owner: "python_tools" },
   { id: "ml_service", order: 5, title: "Speech", owner: "python_ml" },
   { id: "windows_admin", order: 6, title: "Windows administration", owner: "core" }
 ];
@@ -2879,6 +3075,7 @@ 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: "desktop_git", group: "files_shell", state: "planned", path: "device_op", ops: ["git.status", "git.diff", "git.log", "git.add", "git.commit", "git.push", "git.pull", "git.branch", "git.stash", "git.clone"], platforms: ALL, summary: "Git: status, diff, log, commit, branches, push and pull" },
   { 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" },
@@ -2903,6 +3100,7 @@ var TOOL_CATALOG = [
   { name: "desktop_net", group: "personal_automation", state: "planned", path: "device_op", ops: ["net.info", "net.wifi", "net.bluetooth", "net.devices", "net.mdns", "net.scan", "net.download"], platforms: ALL, summary: "Local network and downloads" },
   // ── 4. Python `tools` service ────────────────────────────────────────────────────────────────
   { name: "desktop_documents", group: "tools_service", state: "planned", path: "device_op", ops: ["tools.pdf_extract", "tools.office_generate", "tools.ocr", "tools.image_resize"], platforms: ALL, summary: "PDF text, Office files, OCR, images" },
+  { name: "desktop_web", group: "tools_service", state: "planned", path: "device_op", ops: ["web.fetch", "web.scrape", "web.search", "web.fetch_with_browser"], platforms: ALL, summary: "Fetch, scrape and search the web from this computer's own connection" },
   { name: "desktop_entities", group: "tools_service", state: "planned", path: "device_op", ops: ["tools.ner", "tools.pii"], platforms: ALL, summary: "Names and private data, found on the device" },
   // ── 5. Python `ml` service ───────────────────────────────────────────────────────────────────
   // Built: models.transcribe through local_proxy's POST /op/{cap.op} (matrx-ai implementations/desktop.py).
@@ -2975,10 +3173,10 @@ var LEGACY_ACTIONS = {
   "local_browser.eval": dropped("The browser agent is the extension (matrx-extend) and the cloud browser"),
   "local_browser.tabs": dropped("The browser agent is the extension (matrx-extend) and the cloud browser"),
   "local_browser.close": dropped("The browser agent is the extension (matrx-extend) and the cloud browser"),
-  "local_web.fetch": dropped(CLOUD_SCRAPER),
-  "local_web.fetch_with_browser": dropped(CLOUD_SCRAPER),
-  "local_web.scrape": dropped(CLOUD_SCRAPER),
-  "local_web.search": dropped(CLOUD_SCRAPER),
+  "local_web.fetch": tool("desktop_web"),
+  "local_web.fetch_with_browser": tool("desktop_web"),
+  "local_web.scrape": tool("desktop_web"),
+  "local_web.search": tool("desktop_web"),
   "local_web.research": dropped(CLOUD_SCRAPER),
   "local_web.download": tool("desktop_net"),
   "local_web.upload": dropped("Uploads are cloud files (matrx-files) and file sync, one upload path"),
@@ -3388,6 +3586,25 @@ export {
   FsWatchStopResult,
   FsWriteParams,
   FsWriteResult,
+  GIT_MAX_OUTPUT_CHARS,
+  GitAddParams,
+  GitBranchParams,
+  GitBranchResult,
+  GitCloneParams,
+  GitCommitParams,
+  GitCommitResult,
+  GitDiffParams,
+  GitDiffResult,
+  GitLogCommit,
+  GitLogParams,
+  GitLogResult,
+  GitOutputResult,
+  GitPullParams,
+  GitPushParams,
+  GitStashParams,
+  GitStatusFile,
+  GitStatusParams,
+  GitStatusResult,
   HelloMsg,
   InputHotkeyParams,
   InputHotkeyResult,
@@ -3560,10 +3777,25 @@ export {
   ToolPlatform,
   ToolResultsFile,
   ToolTransport,
+  ToolsServiceProgress,
+  ToolsWebSearchParams,
   TranscriptSegment,
   TranscriptionModelId,
   TranscriptionModelInfo,
   VERSIONED_RESULT_OPS,
+  WEB_MAX_TEXT_CHARS,
+  WebBrowserFetchParams,
+  WebBrowserFetchResult,
+  WebFetchParams,
+  WebFetchResult,
+  WebHeader,
+  WebScrapePage,
+  WebScrapeParams,
+  WebScrapeResult,
+  WebSearchHit,
+  WebSearchParams,
+  WebSearchQueryResult,
+  WebSearchResult,
   Welcome,
   WindowFocusParams,
   WindowFocusResult,