@ai-matrx/desktop-protocol 0.21.65 → 0.21.67

package/dist/client.d.cts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/data/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/data/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-Bz990hcd.cjs';
-export { i as isDesktopProtocolError } from './models-Bz990hcd.cjs';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-C0Jgv2ev.cjs';
+export { i as isDesktopProtocolError } from './models-C0Jgv2ev.cjs';
 import { FrameHeader } from './frame.cjs';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/client.d.ts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/data/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/data/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-Bz990hcd.js';
-export { i as isDesktopProtocolError } from './models-Bz990hcd.js';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-C0Jgv2ev.js';
+export { i as isDesktopProtocolError } from './models-C0Jgv2ev.js';
 import { FrameHeader } from './frame.js';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/client.js

@@ -12,7 +12,7 @@ import {
   Welcome,
   closeRule,
   knows
-} from "./chunk-server-K7IQDLLV.js";
+} from "./chunk-server-AHS5QIQV.js";
 import {
   DesktopProtocolError,
   FRAME_VERSION,

package/dist/index.cjs

@@ -915,7 +915,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 = 66;
+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_-]+$/);
@@ -4094,7 +4094,7 @@ var AudioRecordParams = import_zod30.z.strictObject({
   path: AbsPath.optional(),
   /** (1.66) 1 (mono, the default) or 2 (stereo). */
   channels: import_zod30.z.int().min(1).max(2).optional(),
-  /** (1.66) Samples per second; the device's own rate when absent. */
+  /** (1.66) Samples per second; 16000 when absent (the rate Whisper reads). */
   sample_rate: import_zod30.z.int().min(8e3).max(192e3).optional()
 });
 var AudioRecordResult = import_zod30.z.strictObject({
@@ -4993,7 +4993,13 @@ var AutomationScriptResult = import_zod37.z.strictObject({
   elapsed_ms: nonNegInt
 });
 var MailAccountsParams = import_zod37.z.strictObject({});
-var MailAccount = import_zod37.z.strictObject({ name: import_zod37.z.string(), emails: import_zod37.z.array(import_zod37.z.string()), enabled: import_zod37.z.boolean() });
+var MailAccount = import_zod37.z.strictObject({
+  name: import_zod37.z.string(),
+  emails: import_zod37.z.array(import_zod37.z.string()),
+  enabled: import_zod37.z.boolean(),
+  /** (1.67) The account's mailboxes by name (Matrx Local's email_accounts listed them). */
+  mailboxes: import_zod37.z.array(import_zod37.z.string()).optional()
+});
 var MailAccountsResult = import_zod37.z.strictObject({ accounts: import_zod37.z.array(MailAccount) });
 var MailListParams = import_zod37.z.strictObject({
   /** The account's name in Mail; absent: every account. */
@@ -5018,6 +5024,8 @@ var MailListResult = import_zod37.z.strictObject({ messages: import_zod37.z.arra
 var MailSendParams = import_zod37.z.strictObject({
   to: import_zod37.z.array(import_zod37.z.string().min(3).max(320)).min(1).max(50),
   cc: import_zod37.z.array(import_zod37.z.string().min(3).max(320)).max(50).default([]),
+  /** (1.67) Blind copies (Matrx Local's send_email bcc). */
+  bcc: import_zod37.z.array(import_zod37.z.string().min(3).max(320)).max(50).optional(),
   subject: import_zod37.z.string().max(998),
   body: Text,
   /** The sending account's address; absent: Mail's default. */
@@ -5096,13 +5104,19 @@ var MessagesChat = import_zod37.z.strictObject({
   name: import_zod37.z.string().nullable(),
   participants: import_zod37.z.array(import_zod37.z.string()),
   last_message_at_ms: epochMs.nullable(),
-  service: import_zod37.z.string().nullable()
+  service: import_zod37.z.string().nullable(),
+  /** (1.67) The newest message's text (Matrx Local's list_conversations preview); absent when it has none. */
+  last_message: import_zod37.z.string().optional()
 });
 var MessagesChatsResult = import_zod37.z.strictObject({ chats: import_zod37.z.array(MessagesChat) });
 var MessagesListParams = import_zod37.z.strictObject({
   /** One chat (messages.chats' chat_id); absent: the newest across all. */
   chat_id: import_zod37.z.string().min(1).max(512).optional(),
-  limit: import_zod37.z.int().min(1).max(500).default(50)
+  limit: import_zod37.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_zod37.z.string().min(1).max(320).optional(),
+  /** (1.67) Only messages not yet read. */
+  unread_only: import_zod37.z.boolean().optional()
 });
 var MessagesMessage = import_zod37.z.strictObject({
   id: import_zod37.z.string(),
@@ -5111,7 +5125,13 @@ var MessagesMessage = import_zod37.z.strictObject({
   from_me: import_zod37.z.boolean(),
   /** The other person's handle (phone or email); null for the person's own messages. */
   sender: import_zod37.z.string().nullable(),
-  sent_at_ms: epochMs.nullable()
+  sent_at_ms: epochMs.nullable(),
+  /** (1.67) Whether it has been read. */
+  read: import_zod37.z.boolean().optional(),
+  /** (1.67) iMessage, SMS or RCS, as the Messages database says. */
+  service: import_zod37.z.string().optional(),
+  /** (1.67) The chat's name (group chats); absent for a one-to-one chat. */
+  chat_name: import_zod37.z.string().optional()
 });
 var MessagesListResult = import_zod37.z.strictObject({ messages: import_zod37.z.array(MessagesMessage) });
 var MessagesSendParams = import_zod37.z.strictObject({
@@ -5126,8 +5146,8 @@ var MessagesSendParams = import_zod37.z.strictObject({
 });
 var MessagesSendResult = import_zod37.z.strictObject({ sent: import_zod37.z.boolean() });
 var ContactsSearchParams = import_zod37.z.strictObject({
-  /** Matched against names, organizations, emails and phone numbers. */
-  query: import_zod37.z.string().min(1).max(256),
+  /** Matched against names, organizations, emails and phone numbers; absent (1.67): the first `limit` contacts. */
+  query: import_zod37.z.string().min(1).max(256).optional(),
   limit: import_zod37.z.int().min(1).max(200).default(25)
 });
 var ContactLabeled = import_zod37.z.strictObject({ label: import_zod37.z.string().nullable(), value: import_zod37.z.string() });
@@ -5157,6 +5177,8 @@ var CalendarListParams = import_zod37.z.strictObject({
   to_ms: epochMs,
   /** One calendar's name; absent: every calendar. */
   calendar: import_zod37.z.string().min(1).max(256).optional(),
+  /** (1.67) Several calendars by name (Matrx Local's calendar_names); with `calendar`, both count. */
+  calendars: import_zod37.z.array(import_zod37.z.string().min(1).max(256)).min(1).max(100).optional(),
   limit: import_zod37.z.int().min(1).max(500).default(100)
 });
 var CalendarEvent = import_zod37.z.strictObject({
@@ -5167,7 +5189,9 @@ var CalendarEvent = import_zod37.z.strictObject({
   all_day: import_zod37.z.boolean(),
   calendar: import_zod37.z.string(),
   location: import_zod37.z.string().nullable(),
-  notes: import_zod37.z.string().nullable()
+  notes: import_zod37.z.string().nullable(),
+  /** (1.67) The event's link; absent when it has none. */
+  url: import_zod37.z.string().optional()
 });
 var CalendarListResult = import_zod37.z.strictObject({ events: import_zod37.z.array(CalendarEvent) });
 var CalendarCreateParams = import_zod37.z.strictObject({
@@ -5184,6 +5208,8 @@ var CalendarCreateResult = import_zod37.z.strictObject({ id: import_zod37.z.stri
 var RemindersListParams = import_zod37.z.strictObject({
   /** One list's name; absent: every list. */
   list: import_zod37.z.string().min(1).max(256).optional(),
+  /** (1.67) Several lists by name (Matrx Local's list_names); with `list`, both count. */
+  lists: import_zod37.z.array(import_zod37.z.string().min(1).max(256)).min(1).max(100).optional(),
   include_completed: import_zod37.z.boolean().default(false),
   limit: import_zod37.z.int().min(1).max(500).default(100)
 });
@@ -5193,7 +5219,11 @@ var Reminder = import_zod37.z.strictObject({
   list: import_zod37.z.string(),
   due_ms: epochMs.nullable(),
   completed: import_zod37.z.boolean(),
-  notes: import_zod37.z.string().nullable()
+  notes: import_zod37.z.string().nullable(),
+  /** (1.67) 0 none, 1 high … 9 low (EventKit's scale). */
+  priority: import_zod37.z.int().min(0).max(9).optional(),
+  /** (1.67) When it was completed; absent while open. */
+  completed_at_ms: epochMs.optional()
 });
 var RemindersListResult = import_zod37.z.strictObject({ reminders: import_zod37.z.array(Reminder) });
 var RemindersCreateParams = import_zod37.z.strictObject({
@@ -5209,6 +5239,8 @@ var PhotosSearchParams = import_zod37.z.strictObject({
   from_ms: epochMs.optional(),
   to_ms: epochMs.optional(),
   favorites_only: import_zod37.z.boolean().default(false),
+  /** (1.67) image, video or all (Matrx Local's media_type); absent: all. */
+  media_type: import_zod37.z.enum(["image", "video", "all"]).optional(),
   limit: import_zod37.z.int().min(1).max(200).default(25)
 });
 var Photo = import_zod37.z.strictObject({
@@ -5218,15 +5250,26 @@ var Photo = import_zod37.z.strictObject({
   width: nonNegInt.nullable(),
   height: nonNegInt.nullable(),
   favorite: import_zod37.z.boolean(),
-  title: import_zod37.z.string().nullable()
+  title: import_zod37.z.string().nullable(),
+  /** (1.67) What the asset is. */
+  media_type: import_zod37.z.enum(["image", "video", "audio", "unknown"]).optional(),
+  /** (1.67) A video's length in seconds; absent for a still. */
+  duration_s: import_zod37.z.number().min(0).optional()
 });
 var PhotosSearchResult = import_zod37.z.strictObject({ photos: import_zod37.z.array(Photo) });
 var PhotosGetParams = import_zod37.z.strictObject({
   id: import_zod37.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_zod37.z.boolean().default(false)
+  export: import_zod37.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_zod37.z.int().min(64).max(2048).optional()
+});
+var PhotosGetResult = import_zod37.z.strictObject({
+  photo: Photo,
+  path: import_zod37.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_zod37.z.string().optional()
 });
-var PhotosGetResult = import_zod37.z.strictObject({ photo: Photo, path: import_zod37.z.string().nullable() });
 var LocationGetParams = import_zod37.z.strictObject({ timeout_s: import_zod37.z.int().min(1).max(60).default(15) });
 var LocationGetResult = import_zod37.z.strictObject({
   latitude: import_zod37.z.number().min(-90).max(90),
@@ -5235,7 +5278,12 @@ var LocationGetResult = import_zod37.z.strictObject({
   accuracy_m: import_zod37.z.number().min(0).nullable(),
   at_ms: epochMs,
   /** Who answered: the OS's own location service. */
-  source: import_zod37.z.enum(["corelocation", "windows", "geoclue"])
+  source: import_zod37.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_zod37.z.number().optional(),
+  vertical_accuracy_m: import_zod37.z.number().min(0).optional(),
+  speed_mps: import_zod37.z.number().min(0).optional(),
+  course_deg: import_zod37.z.number().min(0).max(360).optional()
 });
 
 // src/schema/windows.ts
@@ -5267,6 +5315,8 @@ var WindowsRegistryWriteResult = import_zod38.z.strictObject({ key: import_zod38
 var WindowsServicesParams = import_zod38.z.strictObject({
   /** Matched against the service's name and display name. */
   filter: import_zod38.z.string().min(1).max(256).optional(),
+  /** (1.67) Only services in this state (Matrx Local's service_list status). */
+  status: import_zod38.z.enum(["running", "stopped", "paused"]).optional(),
   limit: import_zod38.z.int().min(1).max(1e3).default(200)
 });
 var WindowsService = import_zod38.z.strictObject({
@@ -5280,7 +5330,8 @@ var WindowsService = import_zod38.z.strictObject({
 var WindowsServicesResult = import_zod38.z.strictObject({ services: import_zod38.z.array(WindowsService) });
 var WindowsServiceControlParams = import_zod38.z.strictObject({
   name: import_zod38.z.string().min(1).max(256),
-  action: import_zod38.z.enum(["start", "stop", "restart"])
+  /** pause and resume since 1.67 (Matrx Local's service_control). */
+  action: import_zod38.z.enum(["start", "stop", "restart", "pause", "resume"])
 });
 var WindowsServiceControlResult = import_zod38.z.strictObject({ name: import_zod38.z.string(), status: import_zod38.z.string() });
 var WindowsEventLogParams = import_zod38.z.strictObject({
@@ -5288,6 +5339,8 @@ var WindowsEventLogParams = import_zod38.z.strictObject({
   /** Only these levels; absent: all. */
   levels: import_zod38.z.array(import_zod38.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_zod38.z.string().min(1).max(256).optional(),
   limit: import_zod38.z.int().min(1).max(500).default(50)
 });
 var WindowsEvent = import_zod38.z.strictObject({
@@ -5298,7 +5351,11 @@ var WindowsEvent = import_zod38.z.strictObject({
   message: import_zod38.z.string()
 });
 var WindowsEventLogResult = import_zod38.z.strictObject({ log: import_zod38.z.string(), events: import_zod38.z.array(WindowsEvent) });
-var WindowsFeaturesParams = import_zod38.z.strictObject({ filter: import_zod38.z.string().min(1).max(256).optional() });
+var WindowsFeaturesParams = import_zod38.z.strictObject({
+  filter: import_zod38.z.string().min(1).max(256).optional(),
+  /** (1.67) Only features that are on (Matrx Local's windows_features installed_only). */
+  installed_only: import_zod38.z.boolean().optional()
+});
 var WindowsFeature = import_zod38.z.strictObject({ name: import_zod38.z.string(), state: import_zod38.z.string() });
 var WindowsFeaturesResult = import_zod38.z.strictObject({ features: import_zod38.z.array(WindowsFeature) });
 
@@ -6706,6 +6763,24 @@ var FIELDS_SINCE = {
   SysinfoGetResult: { requirements: "1.41" },
   "SysinfoGetResult.permissions[]": { detail: "1.41" },
   MessagesSendParams: { service: "1.42" },
+  // 1.67: Matrx Local's local_mac_apps and local_windows_ps contracts, carried whole.
+  MailAccount: { mailboxes: "1.67" },
+  MailSendParams: { bcc: "1.67" },
+  MessagesChat: { last_message: "1.67" },
+  MessagesListParams: { contact: "1.67", unread_only: "1.67" },
+  MessagesMessage: { read: "1.67", service: "1.67", chat_name: "1.67" },
+  CalendarListParams: { calendars: "1.67" },
+  CalendarEvent: { url: "1.67" },
+  RemindersListParams: { lists: "1.67" },
+  Reminder: { priority: "1.67", completed_at_ms: "1.67" },
+  PhotosSearchParams: { media_type: "1.67" },
+  Photo: { media_type: "1.67", duration_s: "1.67" },
+  PhotosGetParams: { thumbnail_size: "1.67" },
+  PhotosGetResult: { thumbnail_png_base64: "1.67" },
+  LocationGetResult: { altitude_m: "1.67", vertical_accuracy_m: "1.67", speed_mps: "1.67", course_deg: "1.67" },
+  WindowsServicesParams: { status: "1.67" },
+  WindowsEventLogParams: { source: "1.67" },
+  WindowsFeaturesParams: { installed_only: "1.67" },
   SysinfoHardwareResult: { graphics: "1.45" },
   DownloadRow: { error: "1.46" },
   CopyRestart: { reopened: "1.60" }
@@ -6790,7 +6865,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"]]],
@@ -6814,6 +6892,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"]]],
@@ -6940,7 +7026,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 = "12cce30e22d7106e7344708176202949a2b2fea7eede2c570f663d46d3cedf34";
+var CONTRACT_SHA256 = "256927253d8ef5d1d79a347a7cefe6198ca2364b582a0b74b9ceb0fb53d4e183";
 
 // src/close-policy.ts
 var CLOSE_RULES = {