@ai-matrx/desktop-protocol 0.21.64 → 0.21.66

package/dist/client.cjs

@@ -144,7 +144,7 @@ var import_zod2 = require("zod");
 var import_zod = require("zod");
 var import_uuid = require("@ai-matrx/kit/uuid");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 65;
+var PROTOCOL_MINOR = 67;
 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_-]+$/);
@@ -1745,6 +1745,8 @@ var WindowInfo = import_zod18.z.strictObject({
 var WindowListParams = import_zod18.z.strictObject({
   /** Case-insensitive substring of the window title. */
   title: import_zod18.z.string().min(1).max(256).optional(),
+  /** (1.66) Case-insensitive substring of the owning application's name (matrx-local's app_filter). */
+  app: import_zod18.z.string().min(1).max(256).optional(),
   limit: import_zod18.z.int().min(1).max(500).default(100)
 });
 var WindowListResult = import_zod18.z.strictObject({
@@ -1764,8 +1766,17 @@ var WindowMoveParams = import_zod18.z.strictObject({
   height: import_zod18.z.int().min(50).max(16384).optional()
 });
 var WindowMoveResult = import_zod18.z.strictObject({ window: WindowInfo });
-var WindowMinimizeParams = import_zod18.z.strictObject({ id: nonNegInt });
-var WindowMinimizeResult = import_zod18.z.strictObject({ id: nonNegInt });
+var WindowState = import_zod18.z.enum(["minimize", "maximize", "restore"]);
+var WindowMinimizeParams = import_zod18.z.strictObject({
+  id: nonNegInt,
+  /** (1.66) minimize (the default), maximize (fill its display), or restore (bring a minimized or maximized window back). */
+  mode: WindowState.optional()
+});
+var WindowMinimizeResult = import_zod18.z.strictObject({
+  id: nonNegInt,
+  /** (1.66) What was done. */
+  mode: WindowState.optional()
+});
 
 // src/schema/input.ts
 var import_zod19 = require("zod");
@@ -1968,16 +1979,27 @@ var AudioRecordParams = import_zod21.z.strictObject({
   /** The microphone (from audio.devices); the default input when absent. */
   device_id: import_zod21.z.string().min(1).max(256).optional(),
   /** Where the WAV file goes; a new file in the temp folder when absent. */
-  path: AbsPath.optional()
+  path: AbsPath.optional(),
+  /** (1.66) 1 (mono, the default) or 2 (stereo). */
+  channels: import_zod21.z.int().min(1).max(2).optional(),
+  /** (1.66) Samples per second; the device's own rate when absent. */
+  sample_rate: import_zod21.z.int().min(8e3).max(192e3).optional()
 });
 var AudioRecordResult = import_zod21.z.strictObject({
   path: AbsPath,
   seconds: import_zod21.z.number().min(0),
   bytes: nonNegInt,
   /** Loudest sample, 0–1: 0 means the device gave silence. */
-  peak: import_zod21.z.number().min(0).max(1)
+  peak: import_zod21.z.number().min(0).max(1),
+  /** (1.66) The file's channels and sample rate, as written. */
+  channels: import_zod21.z.int().min(1).max(8).optional(),
+  sample_rate: import_zod21.z.int().min(1).max(768e3).optional()
+});
+var AudioPlayParams = import_zod21.z.strictObject({
+  path: AbsPath,
+  /** (1.66) The speaker or output (its id from audio.devices' outputs); the system's output when absent. */
+  device_id: import_zod21.z.string().min(1).max(256).optional()
 });
-var AudioPlayParams = import_zod21.z.strictObject({ path: AbsPath });
 var AudioPlayResult = import_zod21.z.strictObject({ path: AbsPath, seconds: import_zod21.z.number().min(0) });
 var AudioLevelsParams = import_zod21.z.strictObject({});
 var AudioLevelsResult = import_zod21.z.strictObject({
@@ -4003,7 +4025,13 @@ var AutomationScriptResult = import_zod35.z.strictObject({
   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 MailAccount = import_zod35.z.strictObject({
+  name: import_zod35.z.string(),
+  emails: import_zod35.z.array(import_zod35.z.string()),
+  enabled: import_zod35.z.boolean(),
+  /** (1.67) The account's mailboxes by name (Matrx Local's email_accounts listed them). */
+  mailboxes: import_zod35.z.array(import_zod35.z.string()).optional()
+});
 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. */
@@ -4028,6 +4056,8 @@ var MailListResult = import_zod35.z.strictObject({ messages: import_zod35.z.arra
 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([]),
+  /** (1.67) Blind copies (Matrx Local's send_email bcc). */
+  bcc: import_zod35.z.array(import_zod35.z.string().min(3).max(320)).max(50).optional(),
   subject: import_zod35.z.string().max(998),
   body: Text,
   /** The sending account's address; absent: Mail's default. */
@@ -4106,13 +4136,19 @@ var MessagesChat = import_zod35.z.strictObject({
   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()
+  service: import_zod35.z.string().nullable(),
+  /** (1.67) The newest message's text (Matrx Local's list_conversations preview); absent when it has none. */
+  last_message: import_zod35.z.string().optional()
 });
 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)
+  limit: import_zod35.z.int().min(1).max(500).default(50),
+  /** (1.67) Only messages with this handle or chat name in them (partial: a phone, an email, a name). */
+  contact: import_zod35.z.string().min(1).max(320).optional(),
+  /** (1.67) Only messages not yet read. */
+  unread_only: import_zod35.z.boolean().optional()
 });
 var MessagesMessage = import_zod35.z.strictObject({
   id: import_zod35.z.string(),
@@ -4121,7 +4157,13 @@ var MessagesMessage = import_zod35.z.strictObject({
   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()
+  sent_at_ms: epochMs.nullable(),
+  /** (1.67) Whether it has been read. */
+  read: import_zod35.z.boolean().optional(),
+  /** (1.67) iMessage, SMS or RCS, as the Messages database says. */
+  service: import_zod35.z.string().optional(),
+  /** (1.67) The chat's name (group chats); absent for a one-to-one chat. */
+  chat_name: import_zod35.z.string().optional()
 });
 var MessagesListResult = import_zod35.z.strictObject({ messages: import_zod35.z.array(MessagesMessage) });
 var MessagesSendParams = import_zod35.z.strictObject({
@@ -4136,8 +4178,8 @@ var MessagesSendParams = import_zod35.z.strictObject({
 });
 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),
+  /** Matched against names, organizations, emails and phone numbers; absent (1.67): the first `limit` contacts. */
+  query: import_zod35.z.string().min(1).max(256).optional(),
   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() });
@@ -4167,6 +4209,8 @@ var CalendarListParams = import_zod35.z.strictObject({
   to_ms: epochMs,
   /** One calendar's name; absent: every calendar. */
   calendar: import_zod35.z.string().min(1).max(256).optional(),
+  /** (1.67) Several calendars by name (Matrx Local's calendar_names); with `calendar`, both count. */
+  calendars: import_zod35.z.array(import_zod35.z.string().min(1).max(256)).min(1).max(100).optional(),
   limit: import_zod35.z.int().min(1).max(500).default(100)
 });
 var CalendarEvent = import_zod35.z.strictObject({
@@ -4177,7 +4221,9 @@ var CalendarEvent = import_zod35.z.strictObject({
   all_day: import_zod35.z.boolean(),
   calendar: import_zod35.z.string(),
   location: import_zod35.z.string().nullable(),
-  notes: import_zod35.z.string().nullable()
+  notes: import_zod35.z.string().nullable(),
+  /** (1.67) The event's link; absent when it has none. */
+  url: import_zod35.z.string().optional()
 });
 var CalendarListResult = import_zod35.z.strictObject({ events: import_zod35.z.array(CalendarEvent) });
 var CalendarCreateParams = import_zod35.z.strictObject({
@@ -4194,6 +4240,8 @@ var CalendarCreateResult = import_zod35.z.strictObject({ id: import_zod35.z.stri
 var RemindersListParams = import_zod35.z.strictObject({
   /** One list's name; absent: every list. */
   list: import_zod35.z.string().min(1).max(256).optional(),
+  /** (1.67) Several lists by name (Matrx Local's list_names); with `list`, both count. */
+  lists: import_zod35.z.array(import_zod35.z.string().min(1).max(256)).min(1).max(100).optional(),
   include_completed: import_zod35.z.boolean().default(false),
   limit: import_zod35.z.int().min(1).max(500).default(100)
 });
@@ -4203,7 +4251,11 @@ var Reminder = import_zod35.z.strictObject({
   list: import_zod35.z.string(),
   due_ms: epochMs.nullable(),
   completed: import_zod35.z.boolean(),
-  notes: import_zod35.z.string().nullable()
+  notes: import_zod35.z.string().nullable(),
+  /** (1.67) 0 none, 1 high … 9 low (EventKit's scale). */
+  priority: import_zod35.z.int().min(0).max(9).optional(),
+  /** (1.67) When it was completed; absent while open. */
+  completed_at_ms: epochMs.optional()
 });
 var RemindersListResult = import_zod35.z.strictObject({ reminders: import_zod35.z.array(Reminder) });
 var RemindersCreateParams = import_zod35.z.strictObject({
@@ -4219,6 +4271,8 @@ var PhotosSearchParams = import_zod35.z.strictObject({
   from_ms: epochMs.optional(),
   to_ms: epochMs.optional(),
   favorites_only: import_zod35.z.boolean().default(false),
+  /** (1.67) image, video or all (Matrx Local's media_type); absent: all. */
+  media_type: import_zod35.z.enum(["image", "video", "all"]).optional(),
   limit: import_zod35.z.int().min(1).max(200).default(25)
 });
 var Photo = import_zod35.z.strictObject({
@@ -4228,15 +4282,26 @@ var Photo = import_zod35.z.strictObject({
   width: nonNegInt.nullable(),
   height: nonNegInt.nullable(),
   favorite: import_zod35.z.boolean(),
-  title: import_zod35.z.string().nullable()
+  title: import_zod35.z.string().nullable(),
+  /** (1.67) What the asset is. */
+  media_type: import_zod35.z.enum(["image", "video", "audio", "unknown"]).optional(),
+  /** (1.67) A video's length in seconds; absent for a still. */
+  duration_s: import_zod35.z.number().min(0).optional()
 });
 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)
+  export: import_zod35.z.boolean().default(false),
+  /** (1.67) Also answer a PNG thumbnail no larger than this many pixels a side (Matrx Local's get_photo thumbnail). */
+  thumbnail_size: import_zod35.z.int().min(64).max(2048).optional()
+});
+var PhotosGetResult = import_zod35.z.strictObject({
+  photo: Photo,
+  path: import_zod35.z.string().nullable(),
+  /** (1.67) The thumbnail as base64 PNG, when thumbnail_size asked for one; absent when it could not be drawn. */
+  thumbnail_png_base64: import_zod35.z.string().optional()
 });
-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),
@@ -4245,7 +4310,12 @@ var LocationGetResult = import_zod35.z.strictObject({
   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"])
+  source: import_zod35.z.enum(["corelocation", "windows", "geoclue"]),
+  /** (1.67) Metres above sea level, its accuracy, speed (m/s) and course (degrees); absent where the OS does not say. */
+  altitude_m: import_zod35.z.number().optional(),
+  vertical_accuracy_m: import_zod35.z.number().min(0).optional(),
+  speed_mps: import_zod35.z.number().min(0).optional(),
+  course_deg: import_zod35.z.number().min(0).max(360).optional()
 });
 
 // src/schema/windows.ts
@@ -4277,6 +4347,8 @@ var WindowsRegistryWriteResult = import_zod36.z.strictObject({ key: import_zod36
 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(),
+  /** (1.67) Only services in this state (Matrx Local's service_list status). */
+  status: import_zod36.z.enum(["running", "stopped", "paused"]).optional(),
   limit: import_zod36.z.int().min(1).max(1e3).default(200)
 });
 var WindowsService = import_zod36.z.strictObject({
@@ -4290,7 +4362,8 @@ var WindowsService = import_zod36.z.strictObject({
 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"])
+  /** pause and resume since 1.67 (Matrx Local's service_control). */
+  action: import_zod36.z.enum(["start", "stop", "restart", "pause", "resume"])
 });
 var WindowsServiceControlResult = import_zod36.z.strictObject({ name: import_zod36.z.string(), status: import_zod36.z.string() });
 var WindowsEventLogParams = import_zod36.z.strictObject({
@@ -4298,6 +4371,8 @@ var WindowsEventLogParams = import_zod36.z.strictObject({
   /** 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(),
+  /** (1.67) Only events whose source (provider) name contains this. */
+  source: import_zod36.z.string().min(1).max(256).optional(),
   limit: import_zod36.z.int().min(1).max(500).default(50)
 });
 var WindowsEvent = import_zod36.z.strictObject({
@@ -4308,7 +4383,11 @@ var WindowsEvent = import_zod36.z.strictObject({
   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 WindowsFeaturesParams = import_zod36.z.strictObject({
+  filter: import_zod36.z.string().min(1).max(256).optional(),
+  /** (1.67) Only features that are on (Matrx Local's windows_features installed_only). */
+  installed_only: import_zod36.z.boolean().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) });
 
@@ -4828,7 +4907,10 @@ var RESULT_PATH = /* @__PURE__ */ new Map([
   ["web.fetch_with_browser", "WebBrowserFetchResult"],
   ["sysinfo.get", "SysinfoGetResult"],
   ["sysinfo.hardware", "SysinfoHardwareResult"],
-  ["apps.projects.to_window", "AppsProjectsToWindowResult"]
+  ["apps.projects.to_window", "AppsProjectsToWindowResult"],
+  // 1.67: Matrx Local's local_mac_apps result fields.
+  ["photos.get", "PhotosGetResult"],
+  ["location.get", "LocationGetResult"]
 ]);
 var NESTED_RESULTS = /* @__PURE__ */ new Map([
   ["apps.chats.list", [["chats", "ChatRow"]]],
@@ -4852,6 +4934,14 @@ var NESTED_RESULTS = /* @__PURE__ */ new Map([
   // 1.63: what an instance record still lacks.
   ["apps.instances.list", [["instances", "AppInstance"]]],
   ["apps.windows.set_remote_control", [["remote_control", "WindowRemoteControl"]]],
+  // 1.67: Matrx Local's local_mac_apps result fields.
+  ["mail.accounts", [["accounts", "MailAccount"]]],
+  ["messages.chats", [["chats", "MessagesChat"]]],
+  ["messages.list", [["messages", "MessagesMessage"]]],
+  ["calendar.list", [["events", "CalendarEvent"]]],
+  ["reminders.list", [["reminders", "Reminder"]]],
+  ["photos.search", [["photos", "Photo"]]],
+  ["photos.get", [["photo", "Photo"]]],
   ["coding.providers", [["providers", "CodingProviderStatus"]]],
   // 1.57: the account a coding record belongs to.
   ["coding.sessions.list", [["sessions", "CodingSessionRecord"], ["recent", "CodingRecentRow"]]],