@ai-matrx/desktop-protocol 0.21.27 → 0.21.29

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 = 32;
+var PROTOCOL_MINOR = 37;
 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_-]+$/);
@@ -86,8 +86,11 @@ var ErrorReason = z2.enum([
   // AUTH_FORBIDDEN: the named browser is signed in to another account
   "browser_connection_off",
   // AUTH_FORBIDDEN: the person turned Browser connection off
-  "awaiting_confirmation"
+  "awaiting_confirmation",
   // TIMEOUT: the person did not answer the browser's confirmation in time
+  // 1.34 (REASONS_SINCE): the per-device tool policy (src/tools/policy.ts)
+  "tool_disabled_on_device"
+  // AUTH_FORBIDDEN: the person turned this tool off for agents on this computer (Agents › Tools)
 ]);
 var FsPatchEditFailure = z2.strictObject({ edit_index: nonNegInt, reason: z2.string().max(300) });
 var ProtocolErrorBody = z2.strictObject({
@@ -1388,6 +1391,10 @@ var AppsProjectsToWindowParams = z14.strictObject({
   group: z14.boolean().default(false),
   /** 1.32: also pin them in that window (now if closed, else when it next closes). */
   pin: z14.boolean().optional(),
+  /** 1.36: a batch: exactly these chats of the project and no other (a reused marker is a label, never a sweep). */
+  chat_ids: z14.array(ChatId).min(1).max(5e3).optional(),
+  /** 1.36: take them off this one side window only (a Move's origin), never main or another window that lists them. */
+  take_off_from: ChatPlace.optional(),
   dry_run: z14.boolean().default(false)
 });
 var AppsProjectsToWindowResult = z14.strictObject({
@@ -1454,6 +1461,12 @@ var TitleMismatch = z14.strictObject({
   windows: z14.array(ChatPlace).max(200),
   differs_in: z14.array(TitleCopies).max(200)
 });
+var StaleTitleWindow = z14.strictObject({
+  window: ChatPlace,
+  /** First and latest time (ms) it was seen writing an old name back. */
+  since_ms: nonNegInt,
+  last_ms: nonNegInt
+});
 var AppsChatsTitlesCheckParams = z14.strictObject({ app_key: AppKey });
 var AppsChatsTitlesCheckResult = z14.strictObject({
   app_key: AppKey,
@@ -1462,7 +1475,9 @@ var AppsChatsTitlesCheckResult = z14.strictObject({
   /** Chats with a different name in some window (or in Matrx). */
   chats_with_a_different_name: nonNegInt,
   copies_to_write: nonNegInt,
-  chats: z14.array(TitleMismatch).max(5e3)
+  chats: z14.array(TitleMismatch).max(5e3),
+  /** Windows that keep writing old names back (each is fixed every pass; reloading it, Cmd+R, stops it). Since 1.33. */
+  stale_windows: z14.array(StaleTitleWindow).max(200).optional()
 });
 var AppsChatsTitlesPushParams = z14.strictObject({ app_key: AppKey, chat_id: ChatId.optional(), dry_run: z14.boolean().optional() });
 var AppsChatsTitlesPushResult = z14.strictObject({
@@ -1883,7 +1898,9 @@ var SystemSettingsPane = z21.enum([
   "energy",
   "about",
   "storage",
-  "system_report"
+  "system_report",
+  /** (1.35) Privacy & Security › Microphone: where the person allows Matrx 2 the microphone. */
+  "microphone"
 ]);
 var SystemOpenSettingsParams = z21.strictObject({ pane: SystemSettingsPane });
 var SystemOpenSettingsResult = z21.strictObject({ pane: SystemSettingsPane });
@@ -2742,6 +2759,41 @@ var BrowserCallResult = z33.strictObject({
   result: z33.unknown(),
   duration_ms: nonNegInt
 });
+var BrowserToolMetricsParams = z33.strictObject({ client_instance: BrowserClientInstance });
+var BrowserToolMetric = z33.strictObject({
+  tool: z33.string().max(256),
+  calls: nonNegInt,
+  errors: nonNegInt,
+  /** Over the last 200 answered calls; null before the first answer. */
+  p50_ms: nonNegInt.nullable(),
+  p95_ms: nonNegInt.nullable(),
+  last_call_at_ms: epochMs.nullable(),
+  last_error: z33.string().max(2048).nullable()
+});
+var BrowserToolMetricsResult = z33.strictObject({ client_instance: z33.string(), tools: z33.array(BrowserToolMetric) });
+var BrowserResetCountersParams = z33.strictObject({ client_instance: BrowserClientInstance });
+var BrowserResetCountersResult = z33.strictObject({ reset: z33.boolean() });
+var BrowserLogParams = z33.strictObject({
+  /** Only messages after this seq (0: from the oldest kept; the core keeps the last 500). */
+  after_seq: nonNegInt.default(0),
+  limit: z33.int().min(1).max(500).default(500)
+});
+var BrowserLogMessage = z33.strictObject({
+  seq: nonNegInt,
+  at_ms: epochMs,
+  direction: z33.enum(["to_browser", "from_browser", "core"]),
+  client_instance: z33.string(),
+  kind: z33.enum(["register", "invoke", "result", "progress", "timeout", "closed"]),
+  tool: z33.string().nullable(),
+  call_id: z33.string().nullable(),
+  ok: z33.boolean().nullable(),
+  detail: z33.string().max(1024)
+});
+var BrowserLogResult = z33.strictObject({
+  messages: z33.array(BrowserLogMessage),
+  /** The newest seq the core has written (pass it back as after_seq to follow the log). */
+  last_seq: nonNegInt
+});
 var BrowserInvokeEvent = z33.strictObject({
   call_id: z33.string().min(1).max(64),
   tool: z33.string().min(1).max(96),
@@ -2771,6 +2823,575 @@ var MATRX_EXTENSION_IDS = {
 };
 var DISCOVERY_FILE = { live: "matrx2.json", development: "matrx2-dev.json" };
 
+// src/schema/net.ts
+import { z as z34 } from "zod";
+var NetInfoParams = z34.strictObject({});
+var NetAddress = z34.strictObject({
+  address: z34.string(),
+  family: z34.enum(["ipv4", "ipv6"]),
+  netmask: z34.string().nullable(),
+  /** CIDR form ("192.168.1.20/24"); null where the OS gives no prefix. */
+  cidr: z34.string().nullable()
+});
+var NetInterface = z34.strictObject({
+  name: z34.string(),
+  mac: z34.string().nullable(),
+  /** Loopback and other internal interfaces. */
+  internal: z34.boolean(),
+  addresses: z34.array(NetAddress)
+});
+var NetInfoResult = z34.strictObject({
+  hostname: z34.string(),
+  interfaces: z34.array(NetInterface),
+  /** The default route's gateway; null when the OS does not say (or there is none). */
+  gateway: z34.string().nullable(),
+  /** The DNS servers the OS uses; empty when it does not say. */
+  dns: z34.array(z34.string())
+});
+var NetWifiParams = z34.strictObject({});
+var NetWifiNetwork = z34.strictObject({
+  /** null: the OS hides the name (macOS without Location Services for this app). */
+  ssid: z34.string().nullable(),
+  /** dBm; null where the OS does not say. */
+  rssi: z34.int().nullable(),
+  channel: z34.string().nullable(),
+  security: z34.string().nullable()
+});
+var NetWifiResult = z34.strictObject({
+  /** Whether the computer has a Wi-Fi interface at all. */
+  available: z34.boolean(),
+  /** The network the computer is on; null when it is on none. */
+  current: NetWifiNetwork.nullable(),
+  /** Networks in range (may be empty where the OS lists none to apps). */
+  networks: z34.array(NetWifiNetwork)
+});
+var NetBluetoothParams = z34.strictObject({});
+var NetBluetoothDevice = z34.strictObject({
+  name: z34.string(),
+  address: z34.string().nullable(),
+  connected: z34.boolean(),
+  /** What it is, in the OS's words ("Headphones", "Keyboard"); null where it does not say. */
+  kind: z34.string().nullable(),
+  /** Battery percent, where the OS reports it. */
+  battery: z34.int().min(0).max(100).nullable()
+});
+var NetBluetoothResult = z34.strictObject({
+  /** Bluetooth is on; null where the OS does not say. */
+  powered: z34.boolean().nullable(),
+  devices: z34.array(NetBluetoothDevice)
+});
+var NetDevicesParams = z34.strictObject({});
+var NetDevice = z34.strictObject({
+  ip: z34.string(),
+  mac: z34.string().nullable(),
+  interface: z34.string().nullable(),
+  /** The name the local network gives it (reverse DNS / mDNS), when the table carries one. */
+  hostname: z34.string().nullable()
+});
+var NetDevicesResult = z34.strictObject({ devices: z34.array(NetDevice) });
+var NetMdnsParams = z34.strictObject({
+  /** A service type ("_http._tcp"); absent lists the service types found. */
+  service_type: z34.string().min(1).max(64).regex(/^_[A-Za-z0-9-]+\._(tcp|udp)$/).optional(),
+  /** How long to listen. */
+  timeout_s: z34.int().min(1).max(30).default(3)
+});
+var NetMdnsService = z34.strictObject({
+  name: z34.string(),
+  type: z34.string(),
+  domain: z34.string(),
+  interface: z34.string().nullable()
+});
+var NetMdnsResult = z34.strictObject({ services: z34.array(NetMdnsService) });
+var NetScanParams = z34.strictObject({
+  /** A host name or address; a private or loopback address unless `allow_public`. */
+  host: z34.string().min(1).max(253),
+  ports: z34.array(z34.int().min(1).max(65535)).min(1).max(1024),
+  timeout_ms: z34.int().min(50).max(1e4).default(800),
+  /** Scanning a host on the public internet needs saying so. */
+  allow_public: z34.boolean().default(false)
+});
+var NetScanResult = z34.strictObject({
+  host: z34.string(),
+  /** The address the host resolved to. */
+  address: z34.string(),
+  open: z34.array(z34.int().min(1).max(65535)),
+  closed: nonNegInt,
+  elapsed_ms: nonNegInt
+});
+var NetDownloadParams = z34.strictObject({
+  url: z34.string().min(1).max(8192).regex(/^https?:\/\//),
+  /** Where to save it: an absolute path (a folder keeps the URL's file name). */
+  path: AbsPath,
+  overwrite: z34.boolean().default(false),
+  timeout_s: z34.int().min(1).max(3600).default(300),
+  /** Refuse anything larger. */
+  max_bytes: z34.int().min(1).max(10737418240).default(2147483648)
+});
+var NetDownloadResult = z34.strictObject({
+  path: z34.string(),
+  bytes: nonNegInt,
+  content_type: z34.string().nullable(),
+  /** The final URL after redirects. */
+  url: z34.string(),
+  elapsed_ms: nonNegInt
+});
+
+// src/schema/personal.ts
+import { z as z35 } from "zod";
+var Text = z35.string().max(65536);
+var AutomationScriptParams = z35.strictObject({
+  /** applescript and jxa: macOS (osascript); powershell: Windows (and pwsh where installed). */
+  language: z35.enum(["applescript", "jxa", "powershell"]),
+  script: z35.string().min(1).max(262144),
+  timeout_s: z35.int().min(1).max(600).default(60)
+});
+var AutomationScriptResult = z35.strictObject({
+  stdout: z35.string(),
+  stderr: z35.string(),
+  exit_code: z35.int(),
+  timed_out: z35.boolean(),
+  /** stdout or stderr was cut at 1 MiB. */
+  truncated: z35.boolean(),
+  elapsed_ms: nonNegInt
+});
+var MailAccountsParams = z35.strictObject({});
+var MailAccount = z35.strictObject({ name: z35.string(), emails: z35.array(z35.string()), enabled: z35.boolean() });
+var MailAccountsResult = z35.strictObject({ accounts: z35.array(MailAccount) });
+var MailListParams = z35.strictObject({
+  /** The account's name in Mail; absent: every account. */
+  account: z35.string().min(1).max(256).optional(),
+  /** The mailbox's name ("INBOX", "Sent Messages"). */
+  mailbox: z35.string().min(1).max(256).default("INBOX"),
+  unread_only: z35.boolean().default(false),
+  limit: z35.int().min(1).max(200).default(25)
+});
+var MailMessage = z35.strictObject({
+  id: z35.string(),
+  subject: z35.string(),
+  sender: z35.string(),
+  received_at_ms: epochMs.nullable(),
+  read: z35.boolean(),
+  account: z35.string(),
+  mailbox: z35.string(),
+  /** The first lines of the message's text. */
+  preview: z35.string()
+});
+var MailListResult = z35.strictObject({ messages: z35.array(MailMessage) });
+var MailSendParams = z35.strictObject({
+  to: z35.array(z35.string().min(3).max(320)).min(1).max(50),
+  cc: z35.array(z35.string().min(3).max(320)).max(50).default([]),
+  subject: z35.string().max(998),
+  body: Text,
+  /** The sending account's address; absent: Mail's default. */
+  from: z35.string().min(3).max(320).optional(),
+  /** false leaves it open in Mail as a draft for the person to send. */
+  send: z35.boolean().default(true)
+});
+var MailSendResult = z35.strictObject({ sent: z35.boolean() });
+var MessagesChatsParams = z35.strictObject({ limit: z35.int().min(1).max(200).default(25) });
+var MessagesChat = z35.strictObject({
+  chat_id: z35.string(),
+  name: z35.string().nullable(),
+  participants: z35.array(z35.string()),
+  last_message_at_ms: epochMs.nullable(),
+  service: z35.string().nullable()
+});
+var MessagesChatsResult = z35.strictObject({ chats: z35.array(MessagesChat) });
+var MessagesListParams = z35.strictObject({
+  /** One chat (messages.chats' chat_id); absent: the newest across all. */
+  chat_id: z35.string().min(1).max(512).optional(),
+  limit: z35.int().min(1).max(500).default(50)
+});
+var MessagesMessage = z35.strictObject({
+  id: z35.string(),
+  chat_id: z35.string().nullable(),
+  text: z35.string(),
+  from_me: z35.boolean(),
+  /** The other person's handle (phone or email); null for the person's own messages. */
+  sender: z35.string().nullable(),
+  sent_at_ms: epochMs.nullable()
+});
+var MessagesListResult = z35.strictObject({ messages: z35.array(MessagesMessage) });
+var MessagesSendParams = z35.strictObject({
+  /** A phone number or email the person can message. */
+  to: z35.string().min(3).max(320),
+  text: z35.string().min(1).max(2e4)
+});
+var MessagesSendResult = z35.strictObject({ sent: z35.boolean() });
+var ContactsSearchParams = z35.strictObject({
+  /** Matched against names, organizations, emails and phone numbers. */
+  query: z35.string().min(1).max(256),
+  limit: z35.int().min(1).max(200).default(25)
+});
+var ContactLabeled = z35.strictObject({ label: z35.string().nullable(), value: z35.string() });
+var ContactSummary = z35.strictObject({
+  id: z35.string(),
+  name: z35.string(),
+  organization: z35.string().nullable(),
+  emails: z35.array(ContactLabeled),
+  phones: z35.array(ContactLabeled)
+});
+var ContactsSearchResult = z35.strictObject({ contacts: z35.array(ContactSummary) });
+var ContactsGetParams = z35.strictObject({ id: z35.string().min(1).max(256) });
+var ContactDetail = z35.strictObject({
+  id: z35.string(),
+  name: z35.string(),
+  organization: z35.string().nullable(),
+  job_title: z35.string().nullable(),
+  emails: z35.array(ContactLabeled),
+  phones: z35.array(ContactLabeled),
+  addresses: z35.array(ContactLabeled),
+  birthday: z35.string().nullable(),
+  note: z35.string().nullable()
+});
+var ContactsGetResult = z35.strictObject({ contact: ContactDetail });
+var CalendarListParams = z35.strictObject({
+  from_ms: epochMs,
+  to_ms: epochMs,
+  /** One calendar's name; absent: every calendar. */
+  calendar: z35.string().min(1).max(256).optional(),
+  limit: z35.int().min(1).max(500).default(100)
+});
+var CalendarEvent = z35.strictObject({
+  id: z35.string(),
+  title: z35.string(),
+  start_ms: epochMs,
+  end_ms: epochMs,
+  all_day: z35.boolean(),
+  calendar: z35.string(),
+  location: z35.string().nullable(),
+  notes: z35.string().nullable()
+});
+var CalendarListResult = z35.strictObject({ events: z35.array(CalendarEvent) });
+var CalendarCreateParams = z35.strictObject({
+  title: z35.string().min(1).max(1024),
+  start_ms: epochMs,
+  end_ms: epochMs,
+  all_day: z35.boolean().default(false),
+  /** The calendar's name; absent: the first writable calendar. */
+  calendar: z35.string().min(1).max(256).optional(),
+  location: z35.string().max(1024).optional(),
+  notes: Text.optional()
+});
+var CalendarCreateResult = z35.strictObject({ id: z35.string(), calendar: z35.string() });
+var RemindersListParams = z35.strictObject({
+  /** One list's name; absent: every list. */
+  list: z35.string().min(1).max(256).optional(),
+  include_completed: z35.boolean().default(false),
+  limit: z35.int().min(1).max(500).default(100)
+});
+var Reminder = z35.strictObject({
+  id: z35.string(),
+  title: z35.string(),
+  list: z35.string(),
+  due_ms: epochMs.nullable(),
+  completed: z35.boolean(),
+  notes: z35.string().nullable()
+});
+var RemindersListResult = z35.strictObject({ reminders: z35.array(Reminder) });
+var RemindersCreateParams = z35.strictObject({
+  title: z35.string().min(1).max(1024),
+  due_ms: epochMs.optional(),
+  list: z35.string().min(1).max(256).optional(),
+  notes: Text.optional()
+});
+var RemindersCreateResult = z35.strictObject({ id: z35.string(), list: z35.string() });
+var PhotosSearchParams = z35.strictObject({
+  /** Matched against file names, titles, descriptions and keywords; absent: the newest. */
+  query: z35.string().min(1).max(256).optional(),
+  from_ms: epochMs.optional(),
+  to_ms: epochMs.optional(),
+  favorites_only: z35.boolean().default(false),
+  limit: z35.int().min(1).max(200).default(25)
+});
+var Photo = z35.strictObject({
+  id: z35.string(),
+  filename: z35.string(),
+  taken_at_ms: epochMs.nullable(),
+  width: nonNegInt.nullable(),
+  height: nonNegInt.nullable(),
+  favorite: z35.boolean(),
+  title: z35.string().nullable()
+});
+var PhotosSearchResult = z35.strictObject({ photos: z35.array(Photo) });
+var PhotosGetParams = z35.strictObject({
+  id: z35.string().min(1).max(256),
+  /** Copy the original into a folder Matrx 2 owns and answer its path (then fs_read or desktop_documents reads it). */
+  export: z35.boolean().default(false)
+});
+var PhotosGetResult = z35.strictObject({ photo: Photo, path: z35.string().nullable() });
+var LocationGetParams = z35.strictObject({ timeout_s: z35.int().min(1).max(60).default(15) });
+var LocationGetResult = z35.strictObject({
+  latitude: z35.number().min(-90).max(90),
+  longitude: z35.number().min(-180).max(180),
+  /** Metres; null where the OS does not say. */
+  accuracy_m: z35.number().min(0).nullable(),
+  at_ms: epochMs,
+  /** Who answered: the OS's own location service. */
+  source: z35.enum(["corelocation", "windows", "geoclue"])
+});
+
+// src/schema/windows.ts
+import { z as z36 } from "zod";
+var RegistryKey = z36.string().min(6).max(1024).regex(/^(HKLM|HKCU|HKCR|HKU|HKCC|HKEY_LOCAL_MACHINE|HKEY_CURRENT_USER|HKEY_CLASSES_ROOT|HKEY_USERS|HKEY_CURRENT_CONFIG)(\\.*)?$/);
+var RegistryValueType = z36.enum(["REG_SZ", "REG_EXPAND_SZ", "REG_MULTI_SZ", "REG_DWORD", "REG_QWORD", "REG_BINARY", "REG_NONE"]);
+var WindowsRegistryReadParams = z36.strictObject({
+  key: RegistryKey,
+  /** One value's name ("" is the key's default value); absent: every value and the subkeys. */
+  name: z36.string().max(16383).optional()
+});
+var RegistryValue = z36.strictObject({ name: z36.string(), type: RegistryValueType, data: z36.string() });
+var WindowsRegistryReadResult = z36.strictObject({
+  key: z36.string(),
+  exists: z36.boolean(),
+  values: z36.array(RegistryValue),
+  subkeys: z36.array(z36.string())
+});
+var WindowsRegistryWriteParams = z36.strictObject({
+  key: RegistryKey,
+  name: z36.string().max(16383),
+  type: RegistryValueType.default("REG_SZ"),
+  /** As reg.exe takes it: text, a number, hex for binary, \\0 between the strings of a multi-string. */
+  data: z36.string().max(1048576),
+  /** Remove the value instead of writing it. */
+  delete: z36.boolean().default(false)
+});
+var WindowsRegistryWriteResult = z36.strictObject({ key: z36.string(), name: z36.string(), deleted: z36.boolean() });
+var WindowsServicesParams = z36.strictObject({
+  /** Matched against the service's name and display name. */
+  filter: z36.string().min(1).max(256).optional(),
+  limit: z36.int().min(1).max(1e3).default(200)
+});
+var WindowsService = z36.strictObject({
+  name: z36.string(),
+  display_name: z36.string(),
+  /** Running, Stopped, Paused… as Windows says it. */
+  status: z36.string(),
+  /** Automatic, Manual, Disabled…; null where Windows does not say. */
+  start_type: z36.string().nullable()
+});
+var WindowsServicesResult = z36.strictObject({ services: z36.array(WindowsService) });
+var WindowsServiceControlParams = z36.strictObject({
+  name: z36.string().min(1).max(256),
+  action: z36.enum(["start", "stop", "restart"])
+});
+var WindowsServiceControlResult = z36.strictObject({ name: z36.string(), status: z36.string() });
+var WindowsEventLogParams = z36.strictObject({
+  log: z36.string().min(1).max(256).default("System"),
+  /** Only these levels; absent: all. */
+  levels: z36.array(z36.enum(["critical", "error", "warning", "information", "verbose"])).max(5).optional(),
+  since_ms: epochMs.optional(),
+  limit: z36.int().min(1).max(500).default(50)
+});
+var WindowsEvent = z36.strictObject({
+  id: z36.int(),
+  level: z36.string(),
+  source: z36.string(),
+  at_ms: epochMs,
+  message: z36.string()
+});
+var WindowsEventLogResult = z36.strictObject({ log: z36.string(), events: z36.array(WindowsEvent) });
+var WindowsFeaturesParams = z36.strictObject({ filter: z36.string().min(1).max(256).optional() });
+var WindowsFeature = z36.strictObject({ name: z36.string(), state: z36.string() });
+var WindowsFeaturesResult = z36.strictObject({ features: z36.array(WindowsFeature) });
+
+// src/schema/schedule.ts
+import { z as z37 } from "zod";
+var OpRef = z37.string().min(3).max(128).regex(/^[a-z_]+(\.[a-z_]+)+$/);
+var ScheduleCreateParams = z37.strictObject({
+  name: z37.string().min(1).max(200),
+  op: OpRef,
+  /** The op's params, exactly as the op takes them; checked when the task is created. */
+  params: z37.record(z37.string(), z37.unknown()).default({}),
+  interval_s: z37.int().min(10).max(2592e3),
+  /** Stop after this many runs; absent: until cancelled. */
+  max_runs: z37.int().min(1).max(1e5).optional(),
+  /** Run once now, before the first interval. */
+  run_now: z37.boolean().default(false)
+});
+var ScheduleRun = z37.strictObject({
+  at_ms: epochMs,
+  ok: z37.boolean(),
+  elapsed_ms: nonNegInt,
+  /** The error's code and message when the run failed. */
+  error: z37.string().nullable(),
+  /** The start of the answer, as JSON (cut at 4 KiB). */
+  result_preview: z37.string().nullable()
+});
+var ScheduledTask = z37.strictObject({
+  id: z37.string(),
+  name: z37.string(),
+  op: z37.string(),
+  params: z37.record(z37.string(), z37.unknown()),
+  interval_s: nonNegInt,
+  max_runs: nonNegInt.nullable(),
+  runs: nonNegInt,
+  created_at_ms: epochMs,
+  next_run_at_ms: epochMs.nullable(),
+  /** active, done (ran max_runs), cancelled. */
+  state: z37.enum(["active", "done", "cancelled"]),
+  /** The newest runs, newest first (at most 10). */
+  recent: z37.array(ScheduleRun)
+});
+var ScheduleCreateResult = z37.strictObject({ task: ScheduledTask });
+var ScheduleListParams = z37.strictObject({ include_finished: z37.boolean().default(false) });
+var ScheduleListResult = z37.strictObject({ tasks: z37.array(ScheduledTask) });
+var ScheduleCancelParams = z37.strictObject({ id: z37.string().min(1).max(64) });
+var ScheduleCancelResult = z37.strictObject({ task: ScheduledTask });
+
+// src/schema/notes.ts
+import { z as z38 } from "zod";
+var NoteFolder = z38.string().min(1).max(512).regex(/^[^/\\:*?"<>|][^\\:*?"<>|]*$/);
+var NotePath = z38.string().min(4).max(1024).regex(/^[^/\\:*?"<>|][^\\:*?"<>|]*\.md$/);
+var NotesFoldersParams = z38.strictObject({});
+var NotesFolder = z38.strictObject({ folder: z38.string(), notes: nonNegInt });
+var NotesFoldersResult = z38.strictObject({
+  /** The notes root on this computer. */
+  root: z38.string(),
+  folders: z38.array(NotesFolder)
+});
+var NotesListParams = z38.strictObject({
+  folder: NoteFolder.optional(),
+  limit: z38.int().min(1).max(2e3).default(500)
+});
+var NoteEntry = z38.strictObject({
+  path: z38.string(),
+  label: z38.string(),
+  folder: z38.string(),
+  bytes: nonNegInt,
+  modified_at_ms: epochMs
+});
+var NotesListResult = z38.strictObject({ root: z38.string(), notes: z38.array(NoteEntry), total: nonNegInt });
+var NotesReadParams = z38.strictObject({ path: NotePath });
+var NotesReadResult = z38.strictObject({
+  path: z38.string(),
+  content: z38.string(),
+  bytes: nonNegInt,
+  modified_at_ms: epochMs,
+  /** SHA-256 of the content: pass it back as `if_hash` to write only over this version. */
+  hash: z38.string()
+});
+var NotesWriteParams = z38.strictObject({
+  folder: NoteFolder.default("General"),
+  /** The note's name, without ".md". */
+  label: z38.string().min(1).max(200).regex(/^[^/\\:*?"<>|]+$/),
+  content: z38.string().max(10485760),
+  /** Write only when the note is still this version (notes.read's hash); a change since answers CONFLICT. */
+  if_hash: z38.string().length(64).optional()
+});
+var NotesWriteResult = z38.strictObject({ path: z38.string(), bytes: nonNegInt, created: z38.boolean(), hash: z38.string() });
+var NotesSearchParams = z38.strictObject({
+  query: z38.string().min(1).max(512),
+  limit: z38.int().min(1).max(200).default(50)
+});
+var NotesMatch = z38.strictObject({
+  path: z38.string(),
+  label: z38.string(),
+  folder: z38.string(),
+  /** The matching lines (at most five), trimmed. */
+  lines: z38.array(z38.string())
+});
+var NotesSearchResult = z38.strictObject({ matches: z38.array(NotesMatch), total: nonNegInt });
+
+// src/schema/documents.ts
+import { z as z39 } from "zod";
+var DOCUMENTS_MAX_TEXT_CHARS = 1048576;
+var DocumentsPdfTextParams = z39.strictObject({
+  path: AbsPath,
+  /** 1-based, inclusive. */
+  first_page: z39.int().min(1).optional(),
+  last_page: z39.int().min(1).optional(),
+  max_chars: z39.int().min(1).max(DOCUMENTS_MAX_TEXT_CHARS).default(2e5)
+});
+var DocumentsPdfPage = z39.strictObject({ page: z39.int().min(1), text: z39.string() });
+var DocumentsPdfTextResult = z39.strictObject({
+  pages: nonNegInt,
+  /** Each page read, in order (an image-only page has empty text: OCR it). */
+  read: z39.array(DocumentsPdfPage),
+  truncated: z39.boolean(),
+  title: z39.string().nullable(),
+  author: z39.string().nullable()
+});
+var DocumentsOcrParams = z39.strictObject({
+  path: AbsPath,
+  /** BCP-47 language hints ("en-US", "fr-FR"); absent: the OS's own choice. */
+  languages: z39.array(z39.string().min(2).max(16)).max(8).optional(),
+  /** Faster, less accurate. */
+  fast: z39.boolean().default(false)
+});
+var DocumentsOcrLine = z39.strictObject({
+  text: z39.string(),
+  /** 0–1; null where the engine does not say. */
+  confidence: z39.number().min(0).max(1).nullable()
+});
+var DocumentsOcrResult = z39.strictObject({
+  text: z39.string(),
+  lines: z39.array(DocumentsOcrLine),
+  truncated: z39.boolean(),
+  /** Which engine read it ("vision" on macOS, "windows-ocr", "tesseract"). */
+  engine: z39.string()
+});
+var DocumentsImageResizeParams = z39.strictObject({
+  path: AbsPath,
+  /** Where to write it; absent: next to the original, "<name>-resized.<ext>". */
+  out_path: AbsPath.optional(),
+  /** The longest side, kept in proportion; absent: the size stays (a format change only). */
+  max_size: z39.int().min(1).max(32768).optional(),
+  format: z39.enum(["png", "jpeg", "tiff", "heic", "bmp", "gif"]).optional(),
+  overwrite: z39.boolean().default(false)
+});
+var DocumentsImageResizeResult = z39.strictObject({
+  path: z39.string(),
+  width: nonNegInt,
+  height: nonNegInt,
+  bytes: nonNegInt
+});
+var DocumentsParagraph = z39.strictObject({
+  style: z39.enum(["title", "heading1", "heading2", "heading3", "body", "bullet", "numbered", "quote", "code"]).default("body"),
+  text: z39.string().max(1e5)
+});
+var DocumentsSheet = z39.strictObject({
+  name: z39.string().min(1).max(31),
+  /** Rows of cells; the first row is the header when `header` is true. */
+  rows: z39.array(z39.array(z39.union([z39.string().max(32767), z39.number(), z39.boolean(), z39.null()])).max(16384)).max(1e5),
+  header: z39.boolean().default(true)
+});
+var DocumentsOfficeGenerateParams = z39.strictObject({
+  kind: z39.enum(["docx", "xlsx"]),
+  path: AbsPath,
+  title: z39.string().max(1024).optional(),
+  /** docx: the document's paragraphs, in order. */
+  paragraphs: z39.array(DocumentsParagraph).max(5e4).optional(),
+  /** xlsx: the workbook's sheets, in order. */
+  sheets: z39.array(DocumentsSheet).min(1).max(64).optional(),
+  overwrite: z39.boolean().default(false)
+});
+var DocumentsOfficeGenerateResult = z39.strictObject({ path: z39.string(), bytes: nonNegInt });
+var EntitiesNerParams = z39.strictObject({
+  text: z39.string().min(1).max(DOCUMENTS_MAX_TEXT_CHARS),
+  /** Which kinds to keep; absent: all three. */
+  labels: z39.array(z39.enum(["person", "place", "organization"])).min(1).max(3).optional()
+});
+var EntitySpan = z39.strictObject({
+  text: z39.string(),
+  label: z39.string(),
+  /** Character offsets into the text (UTF-16, as JavaScript counts). */
+  start: nonNegInt,
+  end: nonNegInt
+});
+var EntitiesNerResult = z39.strictObject({ entities: z39.array(EntitySpan), engine: z39.string() });
+var PiiKind = z39.enum(["email", "phone", "credit_card", "us_ssn", "iban", "ip_address", "url", "api_key"]);
+var EntitiesPiiParams = z39.strictObject({
+  text: z39.string().min(1).max(DOCUMENTS_MAX_TEXT_CHARS),
+  kinds: z39.array(PiiKind).min(1).max(8).optional(),
+  /** Also answer the text with each finding replaced by its kind ("[email]"). */
+  redact: z39.boolean().default(false)
+});
+var EntitiesPiiResult = z39.strictObject({
+  findings: z39.array(z39.strictObject({ kind: PiiKind, text: z39.string(), start: nonNegInt, end: nonNegInt })),
+  redacted: z39.string().nullable()
+});
+
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
@@ -2935,7 +3556,55 @@ var OPS = {
   "browser.set_enabled": { params: BrowserSetEnabledParams, result: BrowserSetEnabledResult, kind: "unary", since: "1.28", errors: ["AUTH_FORBIDDEN", "INTERNAL"] },
   "browser.pair_code": { params: BrowserPairCodeParams, result: BrowserPairCodeResult, kind: "unary", since: "1.28", errors: ["AUTH_FORBIDDEN", "INTERNAL"] },
   "browser.pair_reset": { params: BrowserPairResetParams, result: BrowserPairCodeResult, kind: "unary", since: "1.28", errors: ["AUTH_FORBIDDEN", "INTERNAL"] },
-  "browser.call": { params: BrowserCallParams, result: BrowserCallResult, kind: "unary", since: "1.28", errors: ["NOT_FOUND", "CONFLICT", "AUTH_FORBIDDEN", "INVALID_PARAMS", "TIMEOUT", "CANCELLED", "RESOURCE_GONE", "PAYLOAD_TOO_LARGE", "INTERNAL"] }
+  "browser.tool_metrics": { params: BrowserToolMetricsParams, result: BrowserToolMetricsResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS"] },
+  "browser.reset_counters": { params: BrowserResetCountersParams, result: BrowserResetCountersResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS"] },
+  "browser.log": { params: BrowserLogParams, result: BrowserLogResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS"] },
+  "browser.call": { params: BrowserCallParams, result: BrowserCallResult, kind: "unary", since: "1.28", errors: ["NOT_FOUND", "CONFLICT", "AUTH_FORBIDDEN", "INVALID_PARAMS", "TIMEOUT", "CANCELLED", "RESOURCE_GONE", "PAYLOAD_TOO_LARGE", "INTERNAL"] },
+  // 1.37: Matrx Local's remaining sidecar tools in the core (net, automation, the person's apps,
+  // Windows administration, schedules, local notes, documents and entities).
+  "net.info": { params: NetInfoParams, result: NetInfoResult, kind: "unary", since: "1.37", errors: ["PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "net.wifi": { params: NetWifiParams, result: NetWifiResult, kind: "unary", since: "1.37", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "net.bluetooth": { params: NetBluetoothParams, result: NetBluetoothResult, kind: "unary", since: "1.37", errors: ["PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "net.devices": { params: NetDevicesParams, result: NetDevicesResult, kind: "unary", since: "1.37", errors: ["PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "net.mdns": { params: NetMdnsParams, result: NetMdnsResult, kind: "unary", since: "1.37", errors: ["PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "net.scan": { params: NetScanParams, result: NetScanResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "AUTH_FORBIDDEN", "TIMEOUT", "INTERNAL"] },
+  "net.download": { params: NetDownloadParams, result: NetDownloadResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "CONFLICT", "PERMISSION_DENIED_OS", "PAYLOAD_TOO_LARGE", "TIMEOUT", "INTERNAL"] },
+  "automation.script": { params: AutomationScriptParams, result: AutomationScriptResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "mail.accounts": { params: MailAccountsParams, result: MailAccountsResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "mail.list": { params: MailListParams, result: MailListResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "mail.send": { params: MailSendParams, result: MailSendResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "messages.chats": { params: MessagesChatsParams, result: MessagesChatsResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "messages.list": { params: MessagesListParams, result: MessagesListResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "messages.send": { params: MessagesSendParams, result: MessagesSendResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "contacts.search": { params: ContactsSearchParams, result: ContactsSearchResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "contacts.get": { params: ContactsGetParams, result: ContactsGetResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "calendar.list": { params: CalendarListParams, result: CalendarListResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "calendar.create": { params: CalendarCreateParams, result: CalendarCreateResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "reminders.list": { params: RemindersListParams, result: RemindersListResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "reminders.create": { params: RemindersCreateParams, result: RemindersCreateResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "photos.search": { params: PhotosSearchParams, result: PhotosSearchResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "photos.get": { params: PhotosGetParams, result: PhotosGetResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "location.get": { params: LocationGetParams, result: LocationGetResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "windows.registry_read": { params: WindowsRegistryReadParams, result: WindowsRegistryReadResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "windows.registry_write": { params: WindowsRegistryWriteParams, result: WindowsRegistryWriteResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "windows.services": { params: WindowsServicesParams, result: WindowsServicesResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "windows.service_control": { params: WindowsServiceControlParams, result: WindowsServiceControlResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "windows.event_log": { params: WindowsEventLogParams, result: WindowsEventLogResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "windows.features": { params: WindowsFeaturesParams, result: WindowsFeaturesResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "schedule.create": { params: ScheduleCreateParams, result: ScheduleCreateResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "INTERNAL"] },
+  "schedule.list": { params: ScheduleListParams, result: ScheduleListResult, kind: "unary", since: "1.37", errors: ["INTERNAL"] },
+  "schedule.cancel": { params: ScheduleCancelParams, result: ScheduleCancelResult, kind: "unary", since: "1.37", errors: ["NOT_FOUND", "INTERNAL"] },
+  "notes.folders": { params: NotesFoldersParams, result: NotesFoldersResult, kind: "unary", since: "1.37", errors: ["INTERNAL"] },
+  "notes.list": { params: NotesListParams, result: NotesListResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "INTERNAL"] },
+  "notes.read": { params: NotesReadParams, result: NotesReadResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "INTERNAL"] },
+  "notes.write": { params: NotesWriteParams, result: NotesWriteResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "CONFLICT", "PERMISSION_DENIED_OS", "INTERNAL"] },
+  "notes.search": { params: NotesSearchParams, result: NotesSearchResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "INTERNAL"] },
+  "documents.pdf_text": { params: DocumentsPdfTextParams, result: DocumentsPdfTextResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "documents.ocr": { params: DocumentsOcrParams, result: DocumentsOcrResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "documents.image_resize": { params: DocumentsImageResizeParams, result: DocumentsImageResizeResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "CONFLICT", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "documents.office_generate": { params: DocumentsOfficeGenerateParams, result: DocumentsOfficeGenerateResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "NOT_FOUND", "CONFLICT", "PERMISSION_DENIED_OS", "INTERNAL"] },
+  "entities.ner": { params: EntitiesNerParams, result: EntitiesNerResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "TIMEOUT", "INTERNAL"] },
+  "entities.pii": { params: EntitiesPiiParams, result: EntitiesPiiResult, kind: "unary", since: "1.37", errors: ["INVALID_PARAMS", "INTERNAL"] }
 };
 var EVENTS = {
   "fs.changed": FsChangedEvent,
@@ -3361,6 +4030,7 @@ var NAMED_SCHEMAS = {
   AppsChatsOpenParams,
   TitleCopies,
   TitleMismatch,
+  StaleTitleWindow,
   AppsChatsTitlesCheckParams,
   AppsChatsTitlesCheckResult,
   AppsChatsTitlesPushParams,
@@ -3463,7 +4133,133 @@ var NAMED_SCHEMAS = {
   BrowserProgressEvent,
   DesktopHealth,
   BrowserPairRequest,
-  BrowserPairResult
+  BrowserPairResult,
+  BrowserToolMetricsParams,
+  BrowserToolMetric,
+  BrowserToolMetricsResult,
+  BrowserResetCountersParams,
+  BrowserResetCountersResult,
+  BrowserLogParams,
+  BrowserLogMessage,
+  BrowserLogResult,
+  NetInfoParams,
+  NetAddress,
+  NetInterface,
+  NetInfoResult,
+  NetWifiParams,
+  NetWifiNetwork,
+  NetWifiResult,
+  NetBluetoothParams,
+  NetBluetoothDevice,
+  NetBluetoothResult,
+  NetDevicesParams,
+  NetDevice,
+  NetDevicesResult,
+  NetMdnsParams,
+  NetMdnsService,
+  NetMdnsResult,
+  NetScanParams,
+  NetScanResult,
+  NetDownloadParams,
+  NetDownloadResult,
+  AutomationScriptParams,
+  AutomationScriptResult,
+  MailAccountsParams,
+  MailAccount,
+  MailAccountsResult,
+  MailListParams,
+  MailMessage,
+  MailListResult,
+  MailSendParams,
+  MailSendResult,
+  MessagesChatsParams,
+  MessagesChat,
+  MessagesChatsResult,
+  MessagesListParams,
+  MessagesMessage,
+  MessagesListResult,
+  MessagesSendParams,
+  MessagesSendResult,
+  ContactsSearchParams,
+  ContactLabeled,
+  ContactSummary,
+  ContactsSearchResult,
+  ContactsGetParams,
+  ContactDetail,
+  ContactsGetResult,
+  CalendarListParams,
+  CalendarEvent,
+  CalendarListResult,
+  CalendarCreateParams,
+  CalendarCreateResult,
+  RemindersListParams,
+  Reminder,
+  RemindersListResult,
+  RemindersCreateParams,
+  RemindersCreateResult,
+  PhotosSearchParams,
+  Photo,
+  PhotosSearchResult,
+  PhotosGetParams,
+  PhotosGetResult,
+  LocationGetParams,
+  LocationGetResult,
+  RegistryValueType,
+  WindowsRegistryReadParams,
+  RegistryValue,
+  WindowsRegistryReadResult,
+  WindowsRegistryWriteParams,
+  WindowsRegistryWriteResult,
+  WindowsServicesParams,
+  WindowsService,
+  WindowsServicesResult,
+  WindowsServiceControlParams,
+  WindowsServiceControlResult,
+  WindowsEventLogParams,
+  WindowsEvent,
+  WindowsEventLogResult,
+  WindowsFeaturesParams,
+  WindowsFeature,
+  WindowsFeaturesResult,
+  ScheduleCreateParams,
+  ScheduleRun,
+  ScheduledTask,
+  ScheduleCreateResult,
+  ScheduleListParams,
+  ScheduleListResult,
+  ScheduleCancelParams,
+  ScheduleCancelResult,
+  NotesFoldersParams,
+  NotesFolder,
+  NotesFoldersResult,
+  NotesListParams,
+  NoteEntry,
+  NotesListResult,
+  NotesReadParams,
+  NotesReadResult,
+  NotesWriteParams,
+  NotesWriteResult,
+  NotesSearchParams,
+  NotesMatch,
+  NotesSearchResult,
+  DocumentsPdfTextParams,
+  DocumentsPdfPage,
+  DocumentsPdfTextResult,
+  DocumentsOcrParams,
+  DocumentsOcrLine,
+  DocumentsOcrResult,
+  DocumentsImageResizeParams,
+  DocumentsImageResizeResult,
+  DocumentsParagraph,
+  DocumentsSheet,
+  DocumentsOfficeGenerateParams,
+  DocumentsOfficeGenerateResult,
+  EntitiesNerParams,
+  EntitySpan,
+  EntitiesNerResult,
+  PiiKind,
+  EntitiesPiiParams,
+  EntitiesPiiResult
 };
 
 // src/versioning.ts
@@ -3485,8 +4281,9 @@ var FIELDS_SINCE = {
   PowerStatusResult: { energy: "1.24" },
   AppsSpendResult: { days: "1.24" },
   AppsWindowsUpdateStateResult: { closed_by_update: "1.27" },
-  AppsProjectsToWindowParams: { pin: "1.32" },
-  AppsProjectsToWindowResult: { pin: "1.32" }
+  AppsProjectsToWindowParams: { pin: "1.32", chat_ids: "1.36", take_off_from: "1.36" },
+  AppsProjectsToWindowResult: { pin: "1.32" },
+  AppsChatsTitlesCheckResult: { stale_windows: "1.33" }
 };
 var NULL_SINCE = {
   "RelayDeviceStatusEvent.since_ms": { since: "1.1", olderPeersGet: 0 }
@@ -3503,7 +4300,8 @@ var REASONS_SINCE = {
   browser_ambiguous: "1.28",
   browser_account_mismatch: "1.28",
   browser_connection_off: "1.28",
-  awaiting_confirmation: "1.28"
+  awaiting_confirmation: "1.28",
+  tool_disabled_on_device: "1.34"
 };
 function statusForPeer(status, version) {
   const rule = NULL_SINCE["RelayDeviceStatusEvent.since_ms"];
@@ -3622,7 +4420,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 = "ee8e6c98c76f3557f832157e3b2b21bb23ebb74b67b79151f3b9ff788f5273ee";
+var CONTRACT_SHA256 = "1091ef68a5cb45a35a85998fc34560b4ddc035fe67d2d34594e935e92a2081dd";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -3686,25 +4484,27 @@ var TOOL_CATALOG = [
   { name: "desktop_power", group: "os_control", state: "built", path: "device_op", ops: ["power.status", "power.history", "power.prevent_sleep"], platforms: ALL, summary: "Battery and keep awake" },
   { name: "desktop_resources", group: "os_control", state: "built", path: "device_op", ops: ["resources.snapshot", "resources.activity", "resources.stop_job", "resources.incidents"], platforms: ALL, summary: "CPU, memory and disk use; what is using them, grouped into jobs; stop a job; the slowdown log" },
   { 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" },
-  { name: "desktop_messages", group: "personal_automation", state: "planned", path: "device_op", ops: ["messages.conversations", "messages.list", "messages.send"], platforms: ["darwin"], summary: "The Messages app" },
-  { name: "desktop_contacts", group: "personal_automation", state: "planned", path: "device_op", ops: ["contacts.search", "contacts.get"], platforms: ["darwin"], summary: "Contacts" },
-  { name: "desktop_calendar", group: "personal_automation", state: "planned", path: "device_op", ops: ["calendar.list", "calendar.create", "reminders.list", "reminders.create"], platforms: ["darwin"], summary: "Calendar and reminders" },
-  { name: "desktop_photos", group: "personal_automation", state: "planned", path: "device_op", ops: ["photos.search", "photos.get"], platforms: ["darwin"], summary: "Photos library" },
-  { name: "desktop_location", group: "personal_automation", state: "planned", path: "device_op", ops: ["location.get"], platforms: ["darwin", "win32"], summary: "Where the computer is" },
-  { 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" },
+  // ── 3. Personal apps and automation (1.37: the core's `automation`, `personal`, `net` and `schedule` owners) ──
+  { name: "desktop_automation", group: "personal_automation", state: "built", path: "device_op", ops: ["automation.script"], platforms: ["darwin", "win32"], summary: "AppleScript or JavaScript for Automation on a Mac, PowerShell on Windows" },
+  { name: "desktop_mail", group: "personal_automation", state: "built", path: "device_op", ops: ["mail.accounts", "mail.list", "mail.send"], platforms: ["darwin"], summary: "The Mail app: accounts, messages, send" },
+  { name: "desktop_messages", group: "personal_automation", state: "built", path: "device_op", ops: ["messages.chats", "messages.list", "messages.send"], platforms: ["darwin"], summary: "The Messages app: chats, messages, send" },
+  { name: "desktop_contacts", group: "personal_automation", state: "built", path: "device_op", ops: ["contacts.search", "contacts.get"], platforms: ["darwin"], summary: "Contacts: search, one card" },
+  { name: "desktop_calendar", group: "personal_automation", state: "built", path: "device_op", ops: ["calendar.list", "calendar.create", "reminders.list", "reminders.create"], platforms: ["darwin"], summary: "Calendar and Reminders: list and add" },
+  { name: "desktop_photos", group: "personal_automation", state: "built", path: "device_op", ops: ["photos.search", "photos.get"], platforms: ["darwin"], summary: "The Photos library: find, export an original" },
+  { name: "desktop_location", group: "personal_automation", state: "built", path: "device_op", ops: ["location.get"], platforms: ["darwin", "win32"], summary: "Where the computer is (the OS's location service)" },
+  { name: "desktop_net", group: "personal_automation", state: "built", path: "device_op", ops: ["net.info", "net.wifi", "net.bluetooth", "net.devices", "net.mdns", "net.scan", "net.download"], platforms: ALL, summary: "Local network, Wi-Fi, Bluetooth, open ports and downloads" },
+  { name: "desktop_schedule", group: "personal_automation", state: "built", path: "device_op", ops: ["schedule.create", "schedule.list", "schedule.cancel"], platforms: ALL, summary: "Run a tool's op on this computer on an interval; list and cancel" },
+  // ── 4. Documents, notes and entities (1.37: the core's `documents` and `notes` owners; desktop_web is the `tools` service) ──
+  { name: "desktop_documents", group: "tools_service", state: "built", path: "device_op", ops: ["documents.pdf_text", "documents.ocr", "documents.image_resize", "documents.office_generate"], platforms: ALL, summary: "PDF text, OCR, images, Word and Excel files" },
   { name: "desktop_web", group: "tools_service", state: "built", 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" },
+  { name: "desktop_entities", group: "tools_service", state: "built", path: "device_op", ops: ["entities.ner", "entities.pii"], platforms: ALL, summary: "Names, places, organizations and private data, found on the device" },
+  { name: "desktop_notes", group: "files_shell", state: "built", path: "device_op", ops: ["notes.folders", "notes.list", "notes.read", "notes.write", "notes.search"], platforms: ALL, summary: "The person's local notes (Documents/Matrx/Notes): list, read, write, search" },
   // ── 5. Python `ml` service ───────────────────────────────────────────────────────────────────
   // Built: models.transcribe through local_proxy's POST /op/{cap.op} (matrx-ai implementations/desktop.py).
   // Whisper detects the language itself, so matrx-local's speech_locales needs no op of its own.
   { name: "desktop_transcribe", group: "ml_service", state: "built", path: "device_op", ops: ["models.transcribe"], platforms: ALL, summary: "Speech to text on the device" },
   // ── 6. Windows administration ────────────────────────────────────────────────────────────────
-  { name: "desktop_windows_admin", group: "windows_admin", state: "planned", path: "device_op", ops: ["windows.registry_read", "windows.registry_write", "windows.services", "windows.service_control", "windows.event_log", "windows.features"], platforms: ["win32"], summary: "Registry, services, event log" }
+  { name: "desktop_windows_admin", group: "windows_admin", state: "built", path: "device_op", ops: ["windows.registry_read", "windows.registry_write", "windows.services", "windows.service_control", "windows.event_log", "windows.features"], platforms: ["win32"], summary: "Registry, services, event log, optional features" }
 ];
 var EXCLUDED_TOOLS = {
   git_ingest: "Runs on the server: it ingests repository URLs. A local path on a bound computer or sandbox is refused with the fs_* and shell remedy, since the server cannot see it"
@@ -3793,15 +4593,17 @@ var LEGACY_ACTIONS = {
   "local_monitor.watch_events": tool("fs_watch"),
   "local_monitor.stop_watch": tool("fs_watch"),
   "local_monitor.heartbeat": dropped("The relay's device status replaces the heartbeat"),
-  "local_schedule.create": dropped("One scheduler: the platform's runs the agent on time and reaches the device through the relay"),
-  "local_schedule.list": dropped("One scheduler: the platform's runs the agent on time and reaches the device through the relay"),
-  "local_schedule.cancel": dropped("One scheduler: the platform's runs the agent on time and reaches the device through the relay"),
+  // Matrx Local's scheduler ran one of its tools on an interval; desktop_schedule runs an op so.
+  "local_schedule.create": tool("desktop_schedule"),
+  "local_schedule.list": tool("desktop_schedule"),
+  "local_schedule.cancel": tool("desktop_schedule"),
   "local_schedule.prevent_sleep": tool("desktop_power"),
-  "local_documents.list": dropped("matrx-local's private document store is gone; documents are files (fs_*) or cloud Knowledge"),
-  "local_documents.folders": dropped("matrx-local's private document store is gone; documents are files (fs_*) or cloud Knowledge"),
-  "local_documents.read": dropped("matrx-local's private document store is gone; documents are files (fs_*) or cloud Knowledge"),
-  "local_documents.write": dropped("matrx-local's private document store is gone; documents are files (fs_*) or cloud Knowledge"),
-  "local_documents.search": dropped("matrx-local's private document store is gone; documents are files (fs_*) or cloud Knowledge"),
+  // Matrx Local's documents are the Markdown notes in Documents/Matrx/Notes; desktop_notes reads and writes them.
+  "local_documents.list": tool("desktop_notes"),
+  "local_documents.folders": tool("desktop_notes"),
+  "local_documents.read": tool("desktop_notes"),
+  "local_documents.write": tool("desktop_notes"),
+  "local_documents.search": tool("desktop_notes"),
   "local_media.ocr": tool("desktop_documents"),
   "local_media.resize": tool("desktop_documents"),
   "local_media.pdf_extract": tool("desktop_documents"),
@@ -4094,6 +4896,8 @@ export {
   AudioRecordParams,
   AudioRecordResult,
   AudioSetLevelsParams,
+  AutomationScriptParams,
+  AutomationScriptResult,
   BEARER_PREFIX,
   BROADCAST_CID,
   BrowserCallError,
@@ -4105,6 +4909,9 @@ export {
   BrowserDisconnectResult,
   BrowserInvokeEvent,
   BrowserKind,
+  BrowserLogMessage,
+  BrowserLogParams,
+  BrowserLogResult,
   BrowserPairCodeParams,
   BrowserPairCodeResult,
   BrowserPairRequest,
@@ -4115,6 +4922,8 @@ export {
   BrowserProgressResult,
   BrowserRegisterParams,
   BrowserRegisterResult,
+  BrowserResetCountersParams,
+  BrowserResetCountersResult,
   BrowserResultParams,
   BrowserResultResult,
   BrowserSession,
@@ -4124,8 +4933,16 @@ export {
   BrowserSessionsResult,
   BrowserSetEnabledParams,
   BrowserSetEnabledResult,
+  BrowserToolMetric,
+  BrowserToolMetricsParams,
+  BrowserToolMetricsResult,
   CLOSE_RULES,
   CONTRACT_SHA256,
+  CalendarCreateParams,
+  CalendarCreateResult,
+  CalendarEvent,
+  CalendarListParams,
+  CalendarListResult,
   CancelMsg,
   ChatAppProject,
   ChatFamily,
@@ -4159,6 +4976,13 @@ export {
   CodingServiceCredentials,
   CodingServiceProgress,
   ColdChat,
+  ContactDetail,
+  ContactLabeled,
+  ContactSummary,
+  ContactsGetParams,
+  ContactsGetResult,
+  ContactsSearchParams,
+  ContactsSearchResult,
   ContractHash,
   CoreToClientMsg,
   CoreToServiceMsg,
@@ -4167,6 +4991,7 @@ export {
   DEFAULT_MAX_MESSAGE_BYTES,
   DEFAULT_WINDOW_BYTES,
   DISCOVERY_FILE,
+  DOCUMENTS_MAX_TEXT_CHARS,
   DesktopHealth,
   DesktopProtocolError,
   DeviceId,
@@ -4179,10 +5004,27 @@ export {
   DiagErrorsReportParams,
   DiagErrorsReportResult,
   DiagProcess,
+  DocumentsImageResizeParams,
+  DocumentsImageResizeResult,
+  DocumentsOcrLine,
+  DocumentsOcrParams,
+  DocumentsOcrResult,
+  DocumentsOfficeGenerateParams,
+  DocumentsOfficeGenerateResult,
+  DocumentsParagraph,
+  DocumentsPdfPage,
+  DocumentsPdfTextParams,
+  DocumentsPdfTextResult,
+  DocumentsSheet,
   EVENTS,
   EXCLUDED_TOOLS,
   EndMsg,
   EndReason,
+  EntitiesNerParams,
+  EntitiesNerResult,
+  EntitiesPiiParams,
+  EntitiesPiiResult,
+  EntitySpan,
   ErrorCode,
   ErrorMsg,
   ErrorReason,
@@ -4303,7 +5145,25 @@ export {
   Limits,
   LlmRunning,
   LlmServerState,
+  LocationGetParams,
+  LocationGetResult,
   MATRX_EXTENSION_IDS,
+  MailAccount,
+  MailAccountsParams,
+  MailAccountsResult,
+  MailListParams,
+  MailListResult,
+  MailMessage,
+  MailSendParams,
+  MailSendResult,
+  MessagesChat,
+  MessagesChatsParams,
+  MessagesChatsResult,
+  MessagesListParams,
+  MessagesListResult,
+  MessagesMessage,
+  MessagesSendParams,
+  MessagesSendResult,
   MlInstallPhase,
   MlInstallProgress,
   MlProgress,
@@ -4329,6 +5189,39 @@ export {
   ModelsTranscribeResult,
   NAMED_SCHEMAS,
   NULL_SINCE,
+  NetAddress,
+  NetBluetoothDevice,
+  NetBluetoothParams,
+  NetBluetoothResult,
+  NetDevice,
+  NetDevicesParams,
+  NetDevicesResult,
+  NetDownloadParams,
+  NetDownloadResult,
+  NetInfoParams,
+  NetInfoResult,
+  NetInterface,
+  NetMdnsParams,
+  NetMdnsResult,
+  NetMdnsService,
+  NetScanParams,
+  NetScanResult,
+  NetWifiNetwork,
+  NetWifiParams,
+  NetWifiResult,
+  NoteEntry,
+  NotesFolder,
+  NotesFoldersParams,
+  NotesFoldersResult,
+  NotesListParams,
+  NotesListResult,
+  NotesMatch,
+  NotesReadParams,
+  NotesReadResult,
+  NotesSearchParams,
+  NotesSearchResult,
+  NotesWriteParams,
+  NotesWriteResult,
   OPS,
   OpDescriptor,
   OsPermissionName,
@@ -4337,6 +5230,12 @@ export {
   PROTOCOL_MAJOR,
   PROTOCOL_MINOR,
   PROTOCOL_VERSION,
+  Photo,
+  PhotosGetParams,
+  PhotosGetResult,
+  PhotosSearchParams,
+  PhotosSearchResult,
+  PiiKind,
   PowerEnergy,
   PowerHistoryParams,
   PowerHistoryPoint,
@@ -4365,6 +5264,8 @@ export {
   RELAY_CALL_HELLO_ID,
   RELAY_CALL_REQUEST_ID,
   RELAY_CALL_VERSION_HEADER,
+  RegistryValue,
+  RegistryValueType,
   RelayAuthExpiringEvent,
   RelayCallEnvelope,
   RelayCallHello,
@@ -4375,6 +5276,11 @@ export {
   RelayHopEnvelopeHeader,
   RelayMsg,
   RelayStatusResponse,
+  Reminder,
+  RemindersCreateParams,
+  RemindersCreateResult,
+  RemindersListParams,
+  RemindersListResult,
   RequestId,
   RequestMsg,
   ResourceId,
@@ -4400,6 +5306,14 @@ export {
   SERVICES,
   SERVICE_MAX_FRAME_BYTES,
   SUBPROTOCOL,
+  ScheduleCancelParams,
+  ScheduleCancelResult,
+  ScheduleCreateParams,
+  ScheduleCreateResult,
+  ScheduleListParams,
+  ScheduleListResult,
+  ScheduleRun,
+  ScheduledTask,
   ScreenCaptureParams,
   ScreenCaptureResult,
   ScreenDisplay,
@@ -4455,6 +5369,7 @@ export {
   StackStateResult,
   StackStopParams,
   StackTone,
+  StaleTitleWindow,
   StreamMeta,
   StreamMsg,
   SysinfoGetParams,
@@ -4517,6 +5432,21 @@ export {
   WindowMinimizeResult,
   WindowMoveParams,
   WindowMoveResult,
+  WindowsEvent,
+  WindowsEventLogParams,
+  WindowsEventLogResult,
+  WindowsFeature,
+  WindowsFeaturesParams,
+  WindowsFeaturesResult,
+  WindowsRegistryReadParams,
+  WindowsRegistryReadResult,
+  WindowsRegistryWriteParams,
+  WindowsRegistryWriteResult,
+  WindowsService,
+  WindowsServiceControlParams,
+  WindowsServiceControlResult,
+  WindowsServicesParams,
+  WindowsServicesResult,
   announcedVersion,
   assertFrameHeader,
   buildToolStatus,