@ai-matrx/desktop-protocol 0.21.27 → 0.21.29

package/dist/index.cjs

@@ -124,6 +124,8 @@ __export(src_exports, {
   AudioRecordParams: () => AudioRecordParams,
   AudioRecordResult: () => AudioRecordResult,
   AudioSetLevelsParams: () => AudioSetLevelsParams,
+  AutomationScriptParams: () => AutomationScriptParams,
+  AutomationScriptResult: () => AutomationScriptResult,
   BEARER_PREFIX: () => BEARER_PREFIX,
   BROADCAST_CID: () => BROADCAST_CID,
   BrowserCallError: () => BrowserCallError,
@@ -135,6 +137,9 @@ __export(src_exports, {
   BrowserDisconnectResult: () => BrowserDisconnectResult,
   BrowserInvokeEvent: () => BrowserInvokeEvent,
   BrowserKind: () => BrowserKind,
+  BrowserLogMessage: () => BrowserLogMessage,
+  BrowserLogParams: () => BrowserLogParams,
+  BrowserLogResult: () => BrowserLogResult,
   BrowserPairCodeParams: () => BrowserPairCodeParams,
   BrowserPairCodeResult: () => BrowserPairCodeResult,
   BrowserPairRequest: () => BrowserPairRequest,
@@ -145,6 +150,8 @@ __export(src_exports, {
   BrowserProgressResult: () => BrowserProgressResult,
   BrowserRegisterParams: () => BrowserRegisterParams,
   BrowserRegisterResult: () => BrowserRegisterResult,
+  BrowserResetCountersParams: () => BrowserResetCountersParams,
+  BrowserResetCountersResult: () => BrowserResetCountersResult,
   BrowserResultParams: () => BrowserResultParams,
   BrowserResultResult: () => BrowserResultResult,
   BrowserSession: () => BrowserSession,
@@ -154,8 +161,16 @@ __export(src_exports, {
   BrowserSessionsResult: () => BrowserSessionsResult,
   BrowserSetEnabledParams: () => BrowserSetEnabledParams,
   BrowserSetEnabledResult: () => BrowserSetEnabledResult,
+  BrowserToolMetric: () => BrowserToolMetric,
+  BrowserToolMetricsParams: () => BrowserToolMetricsParams,
+  BrowserToolMetricsResult: () => BrowserToolMetricsResult,
   CLOSE_RULES: () => CLOSE_RULES,
   CONTRACT_SHA256: () => CONTRACT_SHA256,
+  CalendarCreateParams: () => CalendarCreateParams,
+  CalendarCreateResult: () => CalendarCreateResult,
+  CalendarEvent: () => CalendarEvent,
+  CalendarListParams: () => CalendarListParams,
+  CalendarListResult: () => CalendarListResult,
   CancelMsg: () => CancelMsg,
   ChatAppProject: () => ChatAppProject,
   ChatFamily: () => ChatFamily,
@@ -189,6 +204,13 @@ __export(src_exports, {
   CodingServiceCredentials: () => CodingServiceCredentials,
   CodingServiceProgress: () => CodingServiceProgress,
   ColdChat: () => ColdChat,
+  ContactDetail: () => ContactDetail,
+  ContactLabeled: () => ContactLabeled,
+  ContactSummary: () => ContactSummary,
+  ContactsGetParams: () => ContactsGetParams,
+  ContactsGetResult: () => ContactsGetResult,
+  ContactsSearchParams: () => ContactsSearchParams,
+  ContactsSearchResult: () => ContactsSearchResult,
   ContractHash: () => ContractHash,
   CoreToClientMsg: () => CoreToClientMsg,
   CoreToServiceMsg: () => CoreToServiceMsg,
@@ -197,6 +219,7 @@ __export(src_exports, {
   DEFAULT_MAX_MESSAGE_BYTES: () => DEFAULT_MAX_MESSAGE_BYTES,
   DEFAULT_WINDOW_BYTES: () => DEFAULT_WINDOW_BYTES,
   DISCOVERY_FILE: () => DISCOVERY_FILE,
+  DOCUMENTS_MAX_TEXT_CHARS: () => DOCUMENTS_MAX_TEXT_CHARS,
   DesktopHealth: () => DesktopHealth,
   DesktopProtocolError: () => DesktopProtocolError,
   DeviceId: () => DeviceId,
@@ -209,10 +232,27 @@ __export(src_exports, {
   DiagErrorsReportParams: () => DiagErrorsReportParams,
   DiagErrorsReportResult: () => DiagErrorsReportResult,
   DiagProcess: () => DiagProcess,
+  DocumentsImageResizeParams: () => DocumentsImageResizeParams,
+  DocumentsImageResizeResult: () => DocumentsImageResizeResult,
+  DocumentsOcrLine: () => DocumentsOcrLine,
+  DocumentsOcrParams: () => DocumentsOcrParams,
+  DocumentsOcrResult: () => DocumentsOcrResult,
+  DocumentsOfficeGenerateParams: () => DocumentsOfficeGenerateParams,
+  DocumentsOfficeGenerateResult: () => DocumentsOfficeGenerateResult,
+  DocumentsParagraph: () => DocumentsParagraph,
+  DocumentsPdfPage: () => DocumentsPdfPage,
+  DocumentsPdfTextParams: () => DocumentsPdfTextParams,
+  DocumentsPdfTextResult: () => DocumentsPdfTextResult,
+  DocumentsSheet: () => DocumentsSheet,
   EVENTS: () => EVENTS,
   EXCLUDED_TOOLS: () => EXCLUDED_TOOLS,
   EndMsg: () => EndMsg,
   EndReason: () => EndReason,
+  EntitiesNerParams: () => EntitiesNerParams,
+  EntitiesNerResult: () => EntitiesNerResult,
+  EntitiesPiiParams: () => EntitiesPiiParams,
+  EntitiesPiiResult: () => EntitiesPiiResult,
+  EntitySpan: () => EntitySpan,
   ErrorCode: () => ErrorCode,
   ErrorMsg: () => ErrorMsg,
   ErrorReason: () => ErrorReason,
@@ -333,7 +373,25 @@ __export(src_exports, {
   Limits: () => Limits,
   LlmRunning: () => LlmRunning,
   LlmServerState: () => LlmServerState,
+  LocationGetParams: () => LocationGetParams,
+  LocationGetResult: () => LocationGetResult,
   MATRX_EXTENSION_IDS: () => MATRX_EXTENSION_IDS,
+  MailAccount: () => MailAccount,
+  MailAccountsParams: () => MailAccountsParams,
+  MailAccountsResult: () => MailAccountsResult,
+  MailListParams: () => MailListParams,
+  MailListResult: () => MailListResult,
+  MailMessage: () => MailMessage,
+  MailSendParams: () => MailSendParams,
+  MailSendResult: () => MailSendResult,
+  MessagesChat: () => MessagesChat,
+  MessagesChatsParams: () => MessagesChatsParams,
+  MessagesChatsResult: () => MessagesChatsResult,
+  MessagesListParams: () => MessagesListParams,
+  MessagesListResult: () => MessagesListResult,
+  MessagesMessage: () => MessagesMessage,
+  MessagesSendParams: () => MessagesSendParams,
+  MessagesSendResult: () => MessagesSendResult,
   MlInstallPhase: () => MlInstallPhase,
   MlInstallProgress: () => MlInstallProgress,
   MlProgress: () => MlProgress,
@@ -359,6 +417,39 @@ __export(src_exports, {
   ModelsTranscribeResult: () => ModelsTranscribeResult,
   NAMED_SCHEMAS: () => NAMED_SCHEMAS,
   NULL_SINCE: () => NULL_SINCE,
+  NetAddress: () => NetAddress,
+  NetBluetoothDevice: () => NetBluetoothDevice,
+  NetBluetoothParams: () => NetBluetoothParams,
+  NetBluetoothResult: () => NetBluetoothResult,
+  NetDevice: () => NetDevice,
+  NetDevicesParams: () => NetDevicesParams,
+  NetDevicesResult: () => NetDevicesResult,
+  NetDownloadParams: () => NetDownloadParams,
+  NetDownloadResult: () => NetDownloadResult,
+  NetInfoParams: () => NetInfoParams,
+  NetInfoResult: () => NetInfoResult,
+  NetInterface: () => NetInterface,
+  NetMdnsParams: () => NetMdnsParams,
+  NetMdnsResult: () => NetMdnsResult,
+  NetMdnsService: () => NetMdnsService,
+  NetScanParams: () => NetScanParams,
+  NetScanResult: () => NetScanResult,
+  NetWifiNetwork: () => NetWifiNetwork,
+  NetWifiParams: () => NetWifiParams,
+  NetWifiResult: () => NetWifiResult,
+  NoteEntry: () => NoteEntry,
+  NotesFolder: () => NotesFolder,
+  NotesFoldersParams: () => NotesFoldersParams,
+  NotesFoldersResult: () => NotesFoldersResult,
+  NotesListParams: () => NotesListParams,
+  NotesListResult: () => NotesListResult,
+  NotesMatch: () => NotesMatch,
+  NotesReadParams: () => NotesReadParams,
+  NotesReadResult: () => NotesReadResult,
+  NotesSearchParams: () => NotesSearchParams,
+  NotesSearchResult: () => NotesSearchResult,
+  NotesWriteParams: () => NotesWriteParams,
+  NotesWriteResult: () => NotesWriteResult,
   OPS: () => OPS,
   OpDescriptor: () => OpDescriptor,
   OsPermissionName: () => OsPermissionName,
@@ -367,6 +458,12 @@ __export(src_exports, {
   PROTOCOL_MAJOR: () => PROTOCOL_MAJOR,
   PROTOCOL_MINOR: () => PROTOCOL_MINOR,
   PROTOCOL_VERSION: () => PROTOCOL_VERSION,
+  Photo: () => Photo,
+  PhotosGetParams: () => PhotosGetParams,
+  PhotosGetResult: () => PhotosGetResult,
+  PhotosSearchParams: () => PhotosSearchParams,
+  PhotosSearchResult: () => PhotosSearchResult,
+  PiiKind: () => PiiKind,
   PowerEnergy: () => PowerEnergy,
   PowerHistoryParams: () => PowerHistoryParams,
   PowerHistoryPoint: () => PowerHistoryPoint,
@@ -395,6 +492,8 @@ __export(src_exports, {
   RELAY_CALL_HELLO_ID: () => RELAY_CALL_HELLO_ID,
   RELAY_CALL_REQUEST_ID: () => RELAY_CALL_REQUEST_ID,
   RELAY_CALL_VERSION_HEADER: () => RELAY_CALL_VERSION_HEADER,
+  RegistryValue: () => RegistryValue,
+  RegistryValueType: () => RegistryValueType,
   RelayAuthExpiringEvent: () => RelayAuthExpiringEvent,
   RelayCallEnvelope: () => RelayCallEnvelope,
   RelayCallHello: () => RelayCallHello,
@@ -405,6 +504,11 @@ __export(src_exports, {
   RelayHopEnvelopeHeader: () => RelayHopEnvelopeHeader,
   RelayMsg: () => RelayMsg,
   RelayStatusResponse: () => RelayStatusResponse,
+  Reminder: () => Reminder,
+  RemindersCreateParams: () => RemindersCreateParams,
+  RemindersCreateResult: () => RemindersCreateResult,
+  RemindersListParams: () => RemindersListParams,
+  RemindersListResult: () => RemindersListResult,
   RequestId: () => RequestId,
   RequestMsg: () => RequestMsg,
   ResourceId: () => ResourceId,
@@ -430,6 +534,14 @@ __export(src_exports, {
   SERVICES: () => SERVICES,
   SERVICE_MAX_FRAME_BYTES: () => SERVICE_MAX_FRAME_BYTES,
   SUBPROTOCOL: () => SUBPROTOCOL,
+  ScheduleCancelParams: () => ScheduleCancelParams,
+  ScheduleCancelResult: () => ScheduleCancelResult,
+  ScheduleCreateParams: () => ScheduleCreateParams,
+  ScheduleCreateResult: () => ScheduleCreateResult,
+  ScheduleListParams: () => ScheduleListParams,
+  ScheduleListResult: () => ScheduleListResult,
+  ScheduleRun: () => ScheduleRun,
+  ScheduledTask: () => ScheduledTask,
   ScreenCaptureParams: () => ScreenCaptureParams,
   ScreenCaptureResult: () => ScreenCaptureResult,
   ScreenDisplay: () => ScreenDisplay,
@@ -485,6 +597,7 @@ __export(src_exports, {
   StackStateResult: () => StackStateResult,
   StackStopParams: () => StackStopParams,
   StackTone: () => StackTone,
+  StaleTitleWindow: () => StaleTitleWindow,
   StreamMeta: () => StreamMeta,
   StreamMsg: () => StreamMsg,
   SysinfoGetParams: () => SysinfoGetParams,
@@ -547,6 +660,21 @@ __export(src_exports, {
   WindowMinimizeResult: () => WindowMinimizeResult,
   WindowMoveParams: () => WindowMoveParams,
   WindowMoveResult: () => WindowMoveResult,
+  WindowsEvent: () => WindowsEvent,
+  WindowsEventLogParams: () => WindowsEventLogParams,
+  WindowsEventLogResult: () => WindowsEventLogResult,
+  WindowsFeature: () => WindowsFeature,
+  WindowsFeaturesParams: () => WindowsFeaturesParams,
+  WindowsFeaturesResult: () => WindowsFeaturesResult,
+  WindowsRegistryReadParams: () => WindowsRegistryReadParams,
+  WindowsRegistryReadResult: () => WindowsRegistryReadResult,
+  WindowsRegistryWriteParams: () => WindowsRegistryWriteParams,
+  WindowsRegistryWriteResult: () => WindowsRegistryWriteResult,
+  WindowsService: () => WindowsService,
+  WindowsServiceControlParams: () => WindowsServiceControlParams,
+  WindowsServiceControlResult: () => WindowsServiceControlResult,
+  WindowsServicesParams: () => WindowsServicesParams,
+  WindowsServicesResult: () => WindowsServicesResult,
   announcedVersion: () => announcedVersion,
   assertFrameHeader: () => assertFrameHeader,
   buildToolStatus: () => buildToolStatus,
@@ -581,7 +709,7 @@ module.exports = __toCommonJS(src_exports);
 var import_zod = require("zod");
 var import_uuid = require("@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 = import_zod.z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = import_zod.z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -665,8 +793,11 @@ var ErrorReason = import_zod2.z.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 = import_zod2.z.strictObject({ edit_index: nonNegInt, reason: import_zod2.z.string().max(300) });
 var ProtocolErrorBody = import_zod2.z.strictObject({
@@ -1967,6 +2098,10 @@ var AppsProjectsToWindowParams = import_zod14.z.strictObject({
   group: import_zod14.z.boolean().default(false),
   /** 1.32: also pin them in that window (now if closed, else when it next closes). */
   pin: import_zod14.z.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: import_zod14.z.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: import_zod14.z.boolean().default(false)
 });
 var AppsProjectsToWindowResult = import_zod14.z.strictObject({
@@ -2033,6 +2168,12 @@ var TitleMismatch = import_zod14.z.strictObject({
   windows: import_zod14.z.array(ChatPlace).max(200),
   differs_in: import_zod14.z.array(TitleCopies).max(200)
 });
+var StaleTitleWindow = import_zod14.z.strictObject({
+  window: ChatPlace,
+  /** First and latest time (ms) it was seen writing an old name back. */
+  since_ms: nonNegInt,
+  last_ms: nonNegInt
+});
 var AppsChatsTitlesCheckParams = import_zod14.z.strictObject({ app_key: AppKey });
 var AppsChatsTitlesCheckResult = import_zod14.z.strictObject({
   app_key: AppKey,
@@ -2041,7 +2182,9 @@ var AppsChatsTitlesCheckResult = import_zod14.z.strictObject({
   /** Chats with a different name in some window (or in Matrx). */
   chats_with_a_different_name: nonNegInt,
   copies_to_write: nonNegInt,
-  chats: import_zod14.z.array(TitleMismatch).max(5e3)
+  chats: import_zod14.z.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: import_zod14.z.array(StaleTitleWindow).max(200).optional()
 });
 var AppsChatsTitlesPushParams = import_zod14.z.strictObject({ app_key: AppKey, chat_id: ChatId.optional(), dry_run: import_zod14.z.boolean().optional() });
 var AppsChatsTitlesPushResult = import_zod14.z.strictObject({
@@ -2462,7 +2605,9 @@ var SystemSettingsPane = import_zod21.z.enum([
   "energy",
   "about",
   "storage",
-  "system_report"
+  "system_report",
+  /** (1.35) Privacy & Security › Microphone: where the person allows Matrx 2 the microphone. */
+  "microphone"
 ]);
 var SystemOpenSettingsParams = import_zod21.z.strictObject({ pane: SystemSettingsPane });
 var SystemOpenSettingsResult = import_zod21.z.strictObject({ pane: SystemSettingsPane });
@@ -3321,6 +3466,41 @@ var BrowserCallResult = import_zod33.z.strictObject({
   result: import_zod33.z.unknown(),
   duration_ms: nonNegInt
 });
+var BrowserToolMetricsParams = import_zod33.z.strictObject({ client_instance: BrowserClientInstance });
+var BrowserToolMetric = import_zod33.z.strictObject({
+  tool: import_zod33.z.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: import_zod33.z.string().max(2048).nullable()
+});
+var BrowserToolMetricsResult = import_zod33.z.strictObject({ client_instance: import_zod33.z.string(), tools: import_zod33.z.array(BrowserToolMetric) });
+var BrowserResetCountersParams = import_zod33.z.strictObject({ client_instance: BrowserClientInstance });
+var BrowserResetCountersResult = import_zod33.z.strictObject({ reset: import_zod33.z.boolean() });
+var BrowserLogParams = import_zod33.z.strictObject({
+  /** Only messages after this seq (0: from the oldest kept; the core keeps the last 500). */
+  after_seq: nonNegInt.default(0),
+  limit: import_zod33.z.int().min(1).max(500).default(500)
+});
+var BrowserLogMessage = import_zod33.z.strictObject({
+  seq: nonNegInt,
+  at_ms: epochMs,
+  direction: import_zod33.z.enum(["to_browser", "from_browser", "core"]),
+  client_instance: import_zod33.z.string(),
+  kind: import_zod33.z.enum(["register", "invoke", "result", "progress", "timeout", "closed"]),
+  tool: import_zod33.z.string().nullable(),
+  call_id: import_zod33.z.string().nullable(),
+  ok: import_zod33.z.boolean().nullable(),
+  detail: import_zod33.z.string().max(1024)
+});
+var BrowserLogResult = import_zod33.z.strictObject({
+  messages: import_zod33.z.array(BrowserLogMessage),
+  /** The newest seq the core has written (pass it back as after_seq to follow the log). */
+  last_seq: nonNegInt
+});
 var BrowserInvokeEvent = import_zod33.z.strictObject({
   call_id: import_zod33.z.string().min(1).max(64),
   tool: import_zod33.z.string().min(1).max(96),
@@ -3350,6 +3530,575 @@ var MATRX_EXTENSION_IDS = {
 };
 var DISCOVERY_FILE = { live: "matrx2.json", development: "matrx2-dev.json" };
 
+// src/schema/net.ts
+var import_zod34 = require("zod");
+var NetInfoParams = import_zod34.z.strictObject({});
+var NetAddress = import_zod34.z.strictObject({
+  address: import_zod34.z.string(),
+  family: import_zod34.z.enum(["ipv4", "ipv6"]),
+  netmask: import_zod34.z.string().nullable(),
+  /** CIDR form ("192.168.1.20/24"); null where the OS gives no prefix. */
+  cidr: import_zod34.z.string().nullable()
+});
+var NetInterface = import_zod34.z.strictObject({
+  name: import_zod34.z.string(),
+  mac: import_zod34.z.string().nullable(),
+  /** Loopback and other internal interfaces. */
+  internal: import_zod34.z.boolean(),
+  addresses: import_zod34.z.array(NetAddress)
+});
+var NetInfoResult = import_zod34.z.strictObject({
+  hostname: import_zod34.z.string(),
+  interfaces: import_zod34.z.array(NetInterface),
+  /** The default route's gateway; null when the OS does not say (or there is none). */
+  gateway: import_zod34.z.string().nullable(),
+  /** The DNS servers the OS uses; empty when it does not say. */
+  dns: import_zod34.z.array(import_zod34.z.string())
+});
+var NetWifiParams = import_zod34.z.strictObject({});
+var NetWifiNetwork = import_zod34.z.strictObject({
+  /** null: the OS hides the name (macOS without Location Services for this app). */
+  ssid: import_zod34.z.string().nullable(),
+  /** dBm; null where the OS does not say. */
+  rssi: import_zod34.z.int().nullable(),
+  channel: import_zod34.z.string().nullable(),
+  security: import_zod34.z.string().nullable()
+});
+var NetWifiResult = import_zod34.z.strictObject({
+  /** Whether the computer has a Wi-Fi interface at all. */
+  available: import_zod34.z.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: import_zod34.z.array(NetWifiNetwork)
+});
+var NetBluetoothParams = import_zod34.z.strictObject({});
+var NetBluetoothDevice = import_zod34.z.strictObject({
+  name: import_zod34.z.string(),
+  address: import_zod34.z.string().nullable(),
+  connected: import_zod34.z.boolean(),
+  /** What it is, in the OS's words ("Headphones", "Keyboard"); null where it does not say. */
+  kind: import_zod34.z.string().nullable(),
+  /** Battery percent, where the OS reports it. */
+  battery: import_zod34.z.int().min(0).max(100).nullable()
+});
+var NetBluetoothResult = import_zod34.z.strictObject({
+  /** Bluetooth is on; null where the OS does not say. */
+  powered: import_zod34.z.boolean().nullable(),
+  devices: import_zod34.z.array(NetBluetoothDevice)
+});
+var NetDevicesParams = import_zod34.z.strictObject({});
+var NetDevice = import_zod34.z.strictObject({
+  ip: import_zod34.z.string(),
+  mac: import_zod34.z.string().nullable(),
+  interface: import_zod34.z.string().nullable(),
+  /** The name the local network gives it (reverse DNS / mDNS), when the table carries one. */
+  hostname: import_zod34.z.string().nullable()
+});
+var NetDevicesResult = import_zod34.z.strictObject({ devices: import_zod34.z.array(NetDevice) });
+var NetMdnsParams = import_zod34.z.strictObject({
+  /** A service type ("_http._tcp"); absent lists the service types found. */
+  service_type: import_zod34.z.string().min(1).max(64).regex(/^_[A-Za-z0-9-]+\._(tcp|udp)$/).optional(),
+  /** How long to listen. */
+  timeout_s: import_zod34.z.int().min(1).max(30).default(3)
+});
+var NetMdnsService = import_zod34.z.strictObject({
+  name: import_zod34.z.string(),
+  type: import_zod34.z.string(),
+  domain: import_zod34.z.string(),
+  interface: import_zod34.z.string().nullable()
+});
+var NetMdnsResult = import_zod34.z.strictObject({ services: import_zod34.z.array(NetMdnsService) });
+var NetScanParams = import_zod34.z.strictObject({
+  /** A host name or address; a private or loopback address unless `allow_public`. */
+  host: import_zod34.z.string().min(1).max(253),
+  ports: import_zod34.z.array(import_zod34.z.int().min(1).max(65535)).min(1).max(1024),
+  timeout_ms: import_zod34.z.int().min(50).max(1e4).default(800),
+  /** Scanning a host on the public internet needs saying so. */
+  allow_public: import_zod34.z.boolean().default(false)
+});
+var NetScanResult = import_zod34.z.strictObject({
+  host: import_zod34.z.string(),
+  /** The address the host resolved to. */
+  address: import_zod34.z.string(),
+  open: import_zod34.z.array(import_zod34.z.int().min(1).max(65535)),
+  closed: nonNegInt,
+  elapsed_ms: nonNegInt
+});
+var NetDownloadParams = import_zod34.z.strictObject({
+  url: import_zod34.z.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: import_zod34.z.boolean().default(false),
+  timeout_s: import_zod34.z.int().min(1).max(3600).default(300),
+  /** Refuse anything larger. */
+  max_bytes: import_zod34.z.int().min(1).max(10737418240).default(2147483648)
+});
+var NetDownloadResult = import_zod34.z.strictObject({
+  path: import_zod34.z.string(),
+  bytes: nonNegInt,
+  content_type: import_zod34.z.string().nullable(),
+  /** The final URL after redirects. */
+  url: import_zod34.z.string(),
+  elapsed_ms: nonNegInt
+});
+
+// src/schema/personal.ts
+var import_zod35 = require("zod");
+var Text = import_zod35.z.string().max(65536);
+var AutomationScriptParams = import_zod35.z.strictObject({
+  /** applescript and jxa: macOS (osascript); powershell: Windows (and pwsh where installed). */
+  language: import_zod35.z.enum(["applescript", "jxa", "powershell"]),
+  script: import_zod35.z.string().min(1).max(262144),
+  timeout_s: import_zod35.z.int().min(1).max(600).default(60)
+});
+var AutomationScriptResult = import_zod35.z.strictObject({
+  stdout: import_zod35.z.string(),
+  stderr: import_zod35.z.string(),
+  exit_code: import_zod35.z.int(),
+  timed_out: import_zod35.z.boolean(),
+  /** stdout or stderr was cut at 1 MiB. */
+  truncated: import_zod35.z.boolean(),
+  elapsed_ms: nonNegInt
+});
+var MailAccountsParams = import_zod35.z.strictObject({});
+var MailAccount = import_zod35.z.strictObject({ name: import_zod35.z.string(), emails: import_zod35.z.array(import_zod35.z.string()), enabled: import_zod35.z.boolean() });
+var MailAccountsResult = import_zod35.z.strictObject({ accounts: import_zod35.z.array(MailAccount) });
+var MailListParams = import_zod35.z.strictObject({
+  /** The account's name in Mail; absent: every account. */
+  account: import_zod35.z.string().min(1).max(256).optional(),
+  /** The mailbox's name ("INBOX", "Sent Messages"). */
+  mailbox: import_zod35.z.string().min(1).max(256).default("INBOX"),
+  unread_only: import_zod35.z.boolean().default(false),
+  limit: import_zod35.z.int().min(1).max(200).default(25)
+});
+var MailMessage = import_zod35.z.strictObject({
+  id: import_zod35.z.string(),
+  subject: import_zod35.z.string(),
+  sender: import_zod35.z.string(),
+  received_at_ms: epochMs.nullable(),
+  read: import_zod35.z.boolean(),
+  account: import_zod35.z.string(),
+  mailbox: import_zod35.z.string(),
+  /** The first lines of the message's text. */
+  preview: import_zod35.z.string()
+});
+var MailListResult = import_zod35.z.strictObject({ messages: import_zod35.z.array(MailMessage) });
+var MailSendParams = import_zod35.z.strictObject({
+  to: import_zod35.z.array(import_zod35.z.string().min(3).max(320)).min(1).max(50),
+  cc: import_zod35.z.array(import_zod35.z.string().min(3).max(320)).max(50).default([]),
+  subject: import_zod35.z.string().max(998),
+  body: Text,
+  /** The sending account's address; absent: Mail's default. */
+  from: import_zod35.z.string().min(3).max(320).optional(),
+  /** false leaves it open in Mail as a draft for the person to send. */
+  send: import_zod35.z.boolean().default(true)
+});
+var MailSendResult = import_zod35.z.strictObject({ sent: import_zod35.z.boolean() });
+var MessagesChatsParams = import_zod35.z.strictObject({ limit: import_zod35.z.int().min(1).max(200).default(25) });
+var MessagesChat = import_zod35.z.strictObject({
+  chat_id: import_zod35.z.string(),
+  name: import_zod35.z.string().nullable(),
+  participants: import_zod35.z.array(import_zod35.z.string()),
+  last_message_at_ms: epochMs.nullable(),
+  service: import_zod35.z.string().nullable()
+});
+var MessagesChatsResult = import_zod35.z.strictObject({ chats: import_zod35.z.array(MessagesChat) });
+var MessagesListParams = import_zod35.z.strictObject({
+  /** One chat (messages.chats' chat_id); absent: the newest across all. */
+  chat_id: import_zod35.z.string().min(1).max(512).optional(),
+  limit: import_zod35.z.int().min(1).max(500).default(50)
+});
+var MessagesMessage = import_zod35.z.strictObject({
+  id: import_zod35.z.string(),
+  chat_id: import_zod35.z.string().nullable(),
+  text: import_zod35.z.string(),
+  from_me: import_zod35.z.boolean(),
+  /** The other person's handle (phone or email); null for the person's own messages. */
+  sender: import_zod35.z.string().nullable(),
+  sent_at_ms: epochMs.nullable()
+});
+var MessagesListResult = import_zod35.z.strictObject({ messages: import_zod35.z.array(MessagesMessage) });
+var MessagesSendParams = import_zod35.z.strictObject({
+  /** A phone number or email the person can message. */
+  to: import_zod35.z.string().min(3).max(320),
+  text: import_zod35.z.string().min(1).max(2e4)
+});
+var MessagesSendResult = import_zod35.z.strictObject({ sent: import_zod35.z.boolean() });
+var ContactsSearchParams = import_zod35.z.strictObject({
+  /** Matched against names, organizations, emails and phone numbers. */
+  query: import_zod35.z.string().min(1).max(256),
+  limit: import_zod35.z.int().min(1).max(200).default(25)
+});
+var ContactLabeled = import_zod35.z.strictObject({ label: import_zod35.z.string().nullable(), value: import_zod35.z.string() });
+var ContactSummary = import_zod35.z.strictObject({
+  id: import_zod35.z.string(),
+  name: import_zod35.z.string(),
+  organization: import_zod35.z.string().nullable(),
+  emails: import_zod35.z.array(ContactLabeled),
+  phones: import_zod35.z.array(ContactLabeled)
+});
+var ContactsSearchResult = import_zod35.z.strictObject({ contacts: import_zod35.z.array(ContactSummary) });
+var ContactsGetParams = import_zod35.z.strictObject({ id: import_zod35.z.string().min(1).max(256) });
+var ContactDetail = import_zod35.z.strictObject({
+  id: import_zod35.z.string(),
+  name: import_zod35.z.string(),
+  organization: import_zod35.z.string().nullable(),
+  job_title: import_zod35.z.string().nullable(),
+  emails: import_zod35.z.array(ContactLabeled),
+  phones: import_zod35.z.array(ContactLabeled),
+  addresses: import_zod35.z.array(ContactLabeled),
+  birthday: import_zod35.z.string().nullable(),
+  note: import_zod35.z.string().nullable()
+});
+var ContactsGetResult = import_zod35.z.strictObject({ contact: ContactDetail });
+var CalendarListParams = import_zod35.z.strictObject({
+  from_ms: epochMs,
+  to_ms: epochMs,
+  /** One calendar's name; absent: every calendar. */
+  calendar: import_zod35.z.string().min(1).max(256).optional(),
+  limit: import_zod35.z.int().min(1).max(500).default(100)
+});
+var CalendarEvent = import_zod35.z.strictObject({
+  id: import_zod35.z.string(),
+  title: import_zod35.z.string(),
+  start_ms: epochMs,
+  end_ms: epochMs,
+  all_day: import_zod35.z.boolean(),
+  calendar: import_zod35.z.string(),
+  location: import_zod35.z.string().nullable(),
+  notes: import_zod35.z.string().nullable()
+});
+var CalendarListResult = import_zod35.z.strictObject({ events: import_zod35.z.array(CalendarEvent) });
+var CalendarCreateParams = import_zod35.z.strictObject({
+  title: import_zod35.z.string().min(1).max(1024),
+  start_ms: epochMs,
+  end_ms: epochMs,
+  all_day: import_zod35.z.boolean().default(false),
+  /** The calendar's name; absent: the first writable calendar. */
+  calendar: import_zod35.z.string().min(1).max(256).optional(),
+  location: import_zod35.z.string().max(1024).optional(),
+  notes: Text.optional()
+});
+var CalendarCreateResult = import_zod35.z.strictObject({ id: import_zod35.z.string(), calendar: import_zod35.z.string() });
+var RemindersListParams = import_zod35.z.strictObject({
+  /** One list's name; absent: every list. */
+  list: import_zod35.z.string().min(1).max(256).optional(),
+  include_completed: import_zod35.z.boolean().default(false),
+  limit: import_zod35.z.int().min(1).max(500).default(100)
+});
+var Reminder = import_zod35.z.strictObject({
+  id: import_zod35.z.string(),
+  title: import_zod35.z.string(),
+  list: import_zod35.z.string(),
+  due_ms: epochMs.nullable(),
+  completed: import_zod35.z.boolean(),
+  notes: import_zod35.z.string().nullable()
+});
+var RemindersListResult = import_zod35.z.strictObject({ reminders: import_zod35.z.array(Reminder) });
+var RemindersCreateParams = import_zod35.z.strictObject({
+  title: import_zod35.z.string().min(1).max(1024),
+  due_ms: epochMs.optional(),
+  list: import_zod35.z.string().min(1).max(256).optional(),
+  notes: Text.optional()
+});
+var RemindersCreateResult = import_zod35.z.strictObject({ id: import_zod35.z.string(), list: import_zod35.z.string() });
+var PhotosSearchParams = import_zod35.z.strictObject({
+  /** Matched against file names, titles, descriptions and keywords; absent: the newest. */
+  query: import_zod35.z.string().min(1).max(256).optional(),
+  from_ms: epochMs.optional(),
+  to_ms: epochMs.optional(),
+  favorites_only: import_zod35.z.boolean().default(false),
+  limit: import_zod35.z.int().min(1).max(200).default(25)
+});
+var Photo = import_zod35.z.strictObject({
+  id: import_zod35.z.string(),
+  filename: import_zod35.z.string(),
+  taken_at_ms: epochMs.nullable(),
+  width: nonNegInt.nullable(),
+  height: nonNegInt.nullable(),
+  favorite: import_zod35.z.boolean(),
+  title: import_zod35.z.string().nullable()
+});
+var PhotosSearchResult = import_zod35.z.strictObject({ photos: import_zod35.z.array(Photo) });
+var PhotosGetParams = import_zod35.z.strictObject({
+  id: import_zod35.z.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: import_zod35.z.boolean().default(false)
+});
+var PhotosGetResult = import_zod35.z.strictObject({ photo: Photo, path: import_zod35.z.string().nullable() });
+var LocationGetParams = import_zod35.z.strictObject({ timeout_s: import_zod35.z.int().min(1).max(60).default(15) });
+var LocationGetResult = import_zod35.z.strictObject({
+  latitude: import_zod35.z.number().min(-90).max(90),
+  longitude: import_zod35.z.number().min(-180).max(180),
+  /** Metres; null where the OS does not say. */
+  accuracy_m: import_zod35.z.number().min(0).nullable(),
+  at_ms: epochMs,
+  /** Who answered: the OS's own location service. */
+  source: import_zod35.z.enum(["corelocation", "windows", "geoclue"])
+});
+
+// src/schema/windows.ts
+var import_zod36 = require("zod");
+var RegistryKey = import_zod36.z.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 = import_zod36.z.enum(["REG_SZ", "REG_EXPAND_SZ", "REG_MULTI_SZ", "REG_DWORD", "REG_QWORD", "REG_BINARY", "REG_NONE"]);
+var WindowsRegistryReadParams = import_zod36.z.strictObject({
+  key: RegistryKey,
+  /** One value's name ("" is the key's default value); absent: every value and the subkeys. */
+  name: import_zod36.z.string().max(16383).optional()
+});
+var RegistryValue = import_zod36.z.strictObject({ name: import_zod36.z.string(), type: RegistryValueType, data: import_zod36.z.string() });
+var WindowsRegistryReadResult = import_zod36.z.strictObject({
+  key: import_zod36.z.string(),
+  exists: import_zod36.z.boolean(),
+  values: import_zod36.z.array(RegistryValue),
+  subkeys: import_zod36.z.array(import_zod36.z.string())
+});
+var WindowsRegistryWriteParams = import_zod36.z.strictObject({
+  key: RegistryKey,
+  name: import_zod36.z.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: import_zod36.z.string().max(1048576),
+  /** Remove the value instead of writing it. */
+  delete: import_zod36.z.boolean().default(false)
+});
+var WindowsRegistryWriteResult = import_zod36.z.strictObject({ key: import_zod36.z.string(), name: import_zod36.z.string(), deleted: import_zod36.z.boolean() });
+var WindowsServicesParams = import_zod36.z.strictObject({
+  /** Matched against the service's name and display name. */
+  filter: import_zod36.z.string().min(1).max(256).optional(),
+  limit: import_zod36.z.int().min(1).max(1e3).default(200)
+});
+var WindowsService = import_zod36.z.strictObject({
+  name: import_zod36.z.string(),
+  display_name: import_zod36.z.string(),
+  /** Running, Stopped, Paused… as Windows says it. */
+  status: import_zod36.z.string(),
+  /** Automatic, Manual, Disabled…; null where Windows does not say. */
+  start_type: import_zod36.z.string().nullable()
+});
+var WindowsServicesResult = import_zod36.z.strictObject({ services: import_zod36.z.array(WindowsService) });
+var WindowsServiceControlParams = import_zod36.z.strictObject({
+  name: import_zod36.z.string().min(1).max(256),
+  action: import_zod36.z.enum(["start", "stop", "restart"])
+});
+var WindowsServiceControlResult = import_zod36.z.strictObject({ name: import_zod36.z.string(), status: import_zod36.z.string() });
+var WindowsEventLogParams = import_zod36.z.strictObject({
+  log: import_zod36.z.string().min(1).max(256).default("System"),
+  /** Only these levels; absent: all. */
+  levels: import_zod36.z.array(import_zod36.z.enum(["critical", "error", "warning", "information", "verbose"])).max(5).optional(),
+  since_ms: epochMs.optional(),
+  limit: import_zod36.z.int().min(1).max(500).default(50)
+});
+var WindowsEvent = import_zod36.z.strictObject({
+  id: import_zod36.z.int(),
+  level: import_zod36.z.string(),
+  source: import_zod36.z.string(),
+  at_ms: epochMs,
+  message: import_zod36.z.string()
+});
+var WindowsEventLogResult = import_zod36.z.strictObject({ log: import_zod36.z.string(), events: import_zod36.z.array(WindowsEvent) });
+var WindowsFeaturesParams = import_zod36.z.strictObject({ filter: import_zod36.z.string().min(1).max(256).optional() });
+var WindowsFeature = import_zod36.z.strictObject({ name: import_zod36.z.string(), state: import_zod36.z.string() });
+var WindowsFeaturesResult = import_zod36.z.strictObject({ features: import_zod36.z.array(WindowsFeature) });
+
+// src/schema/schedule.ts
+var import_zod37 = require("zod");
+var OpRef = import_zod37.z.string().min(3).max(128).regex(/^[a-z_]+(\.[a-z_]+)+$/);
+var ScheduleCreateParams = import_zod37.z.strictObject({
+  name: import_zod37.z.string().min(1).max(200),
+  op: OpRef,
+  /** The op's params, exactly as the op takes them; checked when the task is created. */
+  params: import_zod37.z.record(import_zod37.z.string(), import_zod37.z.unknown()).default({}),
+  interval_s: import_zod37.z.int().min(10).max(2592e3),
+  /** Stop after this many runs; absent: until cancelled. */
+  max_runs: import_zod37.z.int().min(1).max(1e5).optional(),
+  /** Run once now, before the first interval. */
+  run_now: import_zod37.z.boolean().default(false)
+});
+var ScheduleRun = import_zod37.z.strictObject({
+  at_ms: epochMs,
+  ok: import_zod37.z.boolean(),
+  elapsed_ms: nonNegInt,
+  /** The error's code and message when the run failed. */
+  error: import_zod37.z.string().nullable(),
+  /** The start of the answer, as JSON (cut at 4 KiB). */
+  result_preview: import_zod37.z.string().nullable()
+});
+var ScheduledTask = import_zod37.z.strictObject({
+  id: import_zod37.z.string(),
+  name: import_zod37.z.string(),
+  op: import_zod37.z.string(),
+  params: import_zod37.z.record(import_zod37.z.string(), import_zod37.z.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: import_zod37.z.enum(["active", "done", "cancelled"]),
+  /** The newest runs, newest first (at most 10). */
+  recent: import_zod37.z.array(ScheduleRun)
+});
+var ScheduleCreateResult = import_zod37.z.strictObject({ task: ScheduledTask });
+var ScheduleListParams = import_zod37.z.strictObject({ include_finished: import_zod37.z.boolean().default(false) });
+var ScheduleListResult = import_zod37.z.strictObject({ tasks: import_zod37.z.array(ScheduledTask) });
+var ScheduleCancelParams = import_zod37.z.strictObject({ id: import_zod37.z.string().min(1).max(64) });
+var ScheduleCancelResult = import_zod37.z.strictObject({ task: ScheduledTask });
+
+// src/schema/notes.ts
+var import_zod38 = require("zod");
+var NoteFolder = import_zod38.z.string().min(1).max(512).regex(/^[^/\\:*?"<>|][^\\:*?"<>|]*$/);
+var NotePath = import_zod38.z.string().min(4).max(1024).regex(/^[^/\\:*?"<>|][^\\:*?"<>|]*\.md$/);
+var NotesFoldersParams = import_zod38.z.strictObject({});
+var NotesFolder = import_zod38.z.strictObject({ folder: import_zod38.z.string(), notes: nonNegInt });
+var NotesFoldersResult = import_zod38.z.strictObject({
+  /** The notes root on this computer. */
+  root: import_zod38.z.string(),
+  folders: import_zod38.z.array(NotesFolder)
+});
+var NotesListParams = import_zod38.z.strictObject({
+  folder: NoteFolder.optional(),
+  limit: import_zod38.z.int().min(1).max(2e3).default(500)
+});
+var NoteEntry = import_zod38.z.strictObject({
+  path: import_zod38.z.string(),
+  label: import_zod38.z.string(),
+  folder: import_zod38.z.string(),
+  bytes: nonNegInt,
+  modified_at_ms: epochMs
+});
+var NotesListResult = import_zod38.z.strictObject({ root: import_zod38.z.string(), notes: import_zod38.z.array(NoteEntry), total: nonNegInt });
+var NotesReadParams = import_zod38.z.strictObject({ path: NotePath });
+var NotesReadResult = import_zod38.z.strictObject({
+  path: import_zod38.z.string(),
+  content: import_zod38.z.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: import_zod38.z.string()
+});
+var NotesWriteParams = import_zod38.z.strictObject({
+  folder: NoteFolder.default("General"),
+  /** The note's name, without ".md". */
+  label: import_zod38.z.string().min(1).max(200).regex(/^[^/\\:*?"<>|]+$/),
+  content: import_zod38.z.string().max(10485760),
+  /** Write only when the note is still this version (notes.read's hash); a change since answers CONFLICT. */
+  if_hash: import_zod38.z.string().length(64).optional()
+});
+var NotesWriteResult = import_zod38.z.strictObject({ path: import_zod38.z.string(), bytes: nonNegInt, created: import_zod38.z.boolean(), hash: import_zod38.z.string() });
+var NotesSearchParams = import_zod38.z.strictObject({
+  query: import_zod38.z.string().min(1).max(512),
+  limit: import_zod38.z.int().min(1).max(200).default(50)
+});
+var NotesMatch = import_zod38.z.strictObject({
+  path: import_zod38.z.string(),
+  label: import_zod38.z.string(),
+  folder: import_zod38.z.string(),
+  /** The matching lines (at most five), trimmed. */
+  lines: import_zod38.z.array(import_zod38.z.string())
+});
+var NotesSearchResult = import_zod38.z.strictObject({ matches: import_zod38.z.array(NotesMatch), total: nonNegInt });
+
+// src/schema/documents.ts
+var import_zod39 = require("zod");
+var DOCUMENTS_MAX_TEXT_CHARS = 1048576;
+var DocumentsPdfTextParams = import_zod39.z.strictObject({
+  path: AbsPath,
+  /** 1-based, inclusive. */
+  first_page: import_zod39.z.int().min(1).optional(),
+  last_page: import_zod39.z.int().min(1).optional(),
+  max_chars: import_zod39.z.int().min(1).max(DOCUMENTS_MAX_TEXT_CHARS).default(2e5)
+});
+var DocumentsPdfPage = import_zod39.z.strictObject({ page: import_zod39.z.int().min(1), text: import_zod39.z.string() });
+var DocumentsPdfTextResult = import_zod39.z.strictObject({
+  pages: nonNegInt,
+  /** Each page read, in order (an image-only page has empty text: OCR it). */
+  read: import_zod39.z.array(DocumentsPdfPage),
+  truncated: import_zod39.z.boolean(),
+  title: import_zod39.z.string().nullable(),
+  author: import_zod39.z.string().nullable()
+});
+var DocumentsOcrParams = import_zod39.z.strictObject({
+  path: AbsPath,
+  /** BCP-47 language hints ("en-US", "fr-FR"); absent: the OS's own choice. */
+  languages: import_zod39.z.array(import_zod39.z.string().min(2).max(16)).max(8).optional(),
+  /** Faster, less accurate. */
+  fast: import_zod39.z.boolean().default(false)
+});
+var DocumentsOcrLine = import_zod39.z.strictObject({
+  text: import_zod39.z.string(),
+  /** 0–1; null where the engine does not say. */
+  confidence: import_zod39.z.number().min(0).max(1).nullable()
+});
+var DocumentsOcrResult = import_zod39.z.strictObject({
+  text: import_zod39.z.string(),
+  lines: import_zod39.z.array(DocumentsOcrLine),
+  truncated: import_zod39.z.boolean(),
+  /** Which engine read it ("vision" on macOS, "windows-ocr", "tesseract"). */
+  engine: import_zod39.z.string()
+});
+var DocumentsImageResizeParams = import_zod39.z.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: import_zod39.z.int().min(1).max(32768).optional(),
+  format: import_zod39.z.enum(["png", "jpeg", "tiff", "heic", "bmp", "gif"]).optional(),
+  overwrite: import_zod39.z.boolean().default(false)
+});
+var DocumentsImageResizeResult = import_zod39.z.strictObject({
+  path: import_zod39.z.string(),
+  width: nonNegInt,
+  height: nonNegInt,
+  bytes: nonNegInt
+});
+var DocumentsParagraph = import_zod39.z.strictObject({
+  style: import_zod39.z.enum(["title", "heading1", "heading2", "heading3", "body", "bullet", "numbered", "quote", "code"]).default("body"),
+  text: import_zod39.z.string().max(1e5)
+});
+var DocumentsSheet = import_zod39.z.strictObject({
+  name: import_zod39.z.string().min(1).max(31),
+  /** Rows of cells; the first row is the header when `header` is true. */
+  rows: import_zod39.z.array(import_zod39.z.array(import_zod39.z.union([import_zod39.z.string().max(32767), import_zod39.z.number(), import_zod39.z.boolean(), import_zod39.z.null()])).max(16384)).max(1e5),
+  header: import_zod39.z.boolean().default(true)
+});
+var DocumentsOfficeGenerateParams = import_zod39.z.strictObject({
+  kind: import_zod39.z.enum(["docx", "xlsx"]),
+  path: AbsPath,
+  title: import_zod39.z.string().max(1024).optional(),
+  /** docx: the document's paragraphs, in order. */
+  paragraphs: import_zod39.z.array(DocumentsParagraph).max(5e4).optional(),
+  /** xlsx: the workbook's sheets, in order. */
+  sheets: import_zod39.z.array(DocumentsSheet).min(1).max(64).optional(),
+  overwrite: import_zod39.z.boolean().default(false)
+});
+var DocumentsOfficeGenerateResult = import_zod39.z.strictObject({ path: import_zod39.z.string(), bytes: nonNegInt });
+var EntitiesNerParams = import_zod39.z.strictObject({
+  text: import_zod39.z.string().min(1).max(DOCUMENTS_MAX_TEXT_CHARS),
+  /** Which kinds to keep; absent: all three. */
+  labels: import_zod39.z.array(import_zod39.z.enum(["person", "place", "organization"])).min(1).max(3).optional()
+});
+var EntitySpan = import_zod39.z.strictObject({
+  text: import_zod39.z.string(),
+  label: import_zod39.z.string(),
+  /** Character offsets into the text (UTF-16, as JavaScript counts). */
+  start: nonNegInt,
+  end: nonNegInt
+});
+var EntitiesNerResult = import_zod39.z.strictObject({ entities: import_zod39.z.array(EntitySpan), engine: import_zod39.z.string() });
+var PiiKind = import_zod39.z.enum(["email", "phone", "credit_card", "us_ssn", "iban", "ip_address", "url", "api_key"]);
+var EntitiesPiiParams = import_zod39.z.strictObject({
+  text: import_zod39.z.string().min(1).max(DOCUMENTS_MAX_TEXT_CHARS),
+  kinds: import_zod39.z.array(PiiKind).min(1).max(8).optional(),
+  /** Also answer the text with each finding replaced by its kind ("[email]"). */
+  redact: import_zod39.z.boolean().default(false)
+});
+var EntitiesPiiResult = import_zod39.z.strictObject({
+  findings: import_zod39.z.array(import_zod39.z.strictObject({ kind: PiiKind, text: import_zod39.z.string(), start: nonNegInt, end: nonNegInt })),
+  redacted: import_zod39.z.string().nullable()
+});
+
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
@@ -3514,7 +4263,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,
@@ -3940,6 +4737,7 @@ var NAMED_SCHEMAS = {
   AppsChatsOpenParams,
   TitleCopies,
   TitleMismatch,
+  StaleTitleWindow,
   AppsChatsTitlesCheckParams,
   AppsChatsTitlesCheckResult,
   AppsChatsTitlesPushParams,
@@ -4042,7 +4840,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
@@ -4064,8 +4988,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 }
@@ -4082,7 +5007,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"];
@@ -4201,7 +5127,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 = {
@@ -4265,25 +5191,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"
@@ -4372,15 +5300,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"),