@ai-matrx/desktop-protocol 0.21.64 → 0.21.66

package/CHANGELOG.md

@@ -1,7 +1,9 @@
 # Changelog
 
-### Unreleased
+## 0.21.66
 
+- **Protocol 1.67 — Matrx Local's local_mac_apps and local_windows_ps contracts, carried whole (2026-10-21).** Every parameter and result field those two dispatchers had now has a home: `mail.send` `bcc`; `mail.accounts` `mailboxes`; `messages.list` `contact` / `unread_only` (+ `read`, `service`, `chat_name`); `messages.chats` `last_message`; `contacts.search` without a `query` (the first `limit`); `calendar.list` `calendars` (+ `url`); `reminders.list` `lists` (+ `priority`, `completed_at_ms`); `photos.search` `media_type` (+ `media_type`, `duration_s`); `photos.get` `thumbnail_size` (+ `thumbnail_png_base64`); `location.get` `altitude_m`, `vertical_accuracy_m`, `speed_mps`, `course_deg`; `windows.services` `status`; `windows.service_control` `pause` / `resume`; `windows.event_log` `source`; `windows.features` `installed_only`. Optional; result fields stripped for a 1.66 peer by `forPeer`. Consumer action: Matrx 2's core serves them (matrx-desktop test/unit/legacy-contract-parity.test.ts).
+- **Protocol 1.66 — matrx-local's window and audio contracts on Matrx 2 (2026-10-21).** `window.list` takes `app` (owning app name substring, local_window's app_filter); `window.minimize` takes `mode` minimize / maximize / restore (local_window's window_action) and echoes it; `audio.record` takes `channels` and `sample_rate` and reports both; `audio.play` takes `device_id` (an output from audio.devices). Optional fields only, in FIELDS_SINCE; an older core refuses the new params as INVALID_PARAMS. Consumer action: none.
 - **Protocol 1.65 — "Continued from <account>" is a transcript item (2026-10-21).** `CodingTranscriptItem` gains `continued` (`id`, `from`, `text`, `at`): the line across a coding chat where it moved from another account (@ai-matrx/coding-sessions emits it where it used to emit an info `notice`). `forPeer` sends a 1.64 peer's `coding.history` / `coding.transcript.read` each as that `notice`, so its strict union never refuses the whole transcript. Consumer action: draw it as a divider at its place (the coding-sessions screen does).
 - **Protocol 1.64 — agent versions in Matrx 2 (2026-10-21).** New ops `account.agents.versions` (an agent's saved versions: number, age, note; the current version), `account.agents.version_diff` (one version and the current one as agent-definition records for `@ai-matrx/agents/versions/react` AgentDiffViewer) and `account.agents.restore_version` (`agx_promote_version`). New ops only; an older peer never sees them. Consumer action: none.
 - **Protocol 1.63 — a chat's instance, and what an instance record lacks (2026-10-21).** `ChatRow.home` (`ChatPlace`): the instance whose folder holds the chat, read only (Claude: the side window holding its newest record copy, else main; Codex: the home whose database holds it). `AppInstance.missing` (`InstanceGap[]`: account / email / version): what the record still lacks after Matrx filled what it remembered (Matrx 2 ledger D10). Optional; stripped for a 1.62 peer by `forPeer`. Consumer action: none.
@@ -11,8 +13,17 @@
 
 ## 0.21.64
 
-UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
-Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/desktop-protocol/src`.
+SOURCE CHANGED WITH NO RELEASE NOTE. This release shipped source changes that nobody described in an Unreleased entry,
+so they may include breaking API changes. Consumer action is UNKNOWN: read the diff before upgrading.
+Diff: `git diff 920791a7ff 8d4dfed0d7 -- apps/shared/desktop-protocol/src`
+
+Changed shipped source files (6):
+- `apps/shared/desktop-protocol/src/contract.ts`
+- `apps/shared/desktop-protocol/src/schema/account.ts`
+- `apps/shared/desktop-protocol/src/schema/coding-sessions.ts`
+- `apps/shared/desktop-protocol/src/schema/primitives.ts`
+- `apps/shared/desktop-protocol/src/schema/registry.ts`
+- `apps/shared/desktop-protocol/src/versioning.ts`
 
 ## 0.21.62
 

package/dist/{chunk-server-B5W6NL7W.js → chunk-server-33UKFIXH.js}

@@ -6,7 +6,7 @@ import {
 import { z } from "zod";
 import { UUID_SHAPE_PATTERN } from "@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 = z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -2512,6 +2512,8 @@ var WindowInfo = z24.strictObject({
 var WindowListParams = z24.strictObject({
   /** Case-insensitive substring of the window title. */
   title: z24.string().min(1).max(256).optional(),
+  /** (1.66) Case-insensitive substring of the owning application's name (matrx-local's app_filter). */
+  app: z24.string().min(1).max(256).optional(),
   limit: z24.int().min(1).max(500).default(100)
 });
 var WindowListResult = z24.strictObject({
@@ -2531,8 +2533,17 @@ var WindowMoveParams = z24.strictObject({
   height: z24.int().min(50).max(16384).optional()
 });
 var WindowMoveResult = z24.strictObject({ window: WindowInfo });
-var WindowMinimizeParams = z24.strictObject({ id: nonNegInt });
-var WindowMinimizeResult = z24.strictObject({ id: nonNegInt });
+var WindowState = z24.enum(["minimize", "maximize", "restore"]);
+var WindowMinimizeParams = z24.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 = z24.strictObject({
+  id: nonNegInt,
+  /** (1.66) What was done. */
+  mode: WindowState.optional()
+});
 
 // src/schema/input.ts
 import { z as z25 } from "zod";
@@ -3044,16 +3055,27 @@ var AudioRecordParams = z30.strictObject({
   /** The microphone (from audio.devices); the default input when absent. */
   device_id: z30.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: z30.int().min(1).max(2).optional(),
+  /** (1.66) Samples per second; the device's own rate when absent. */
+  sample_rate: z30.int().min(8e3).max(192e3).optional()
 });
 var AudioRecordResult = z30.strictObject({
   path: AbsPath,
   seconds: z30.number().min(0),
   bytes: nonNegInt,
   /** Loudest sample, 0–1: 0 means the device gave silence. */
-  peak: z30.number().min(0).max(1)
+  peak: z30.number().min(0).max(1),
+  /** (1.66) The file's channels and sample rate, as written. */
+  channels: z30.int().min(1).max(8).optional(),
+  sample_rate: z30.int().min(1).max(768e3).optional()
+});
+var AudioPlayParams = z30.strictObject({
+  path: AbsPath,
+  /** (1.66) The speaker or output (its id from audio.devices' outputs); the system's output when absent. */
+  device_id: z30.string().min(1).max(256).optional()
 });
-var AudioPlayParams = z30.strictObject({ path: AbsPath });
 var AudioPlayResult = z30.strictObject({ path: AbsPath, seconds: z30.number().min(0) });
 var AudioLevelsParams = z30.strictObject({});
 var AudioLevelsResult = z30.strictObject({
@@ -3935,7 +3957,13 @@ var AutomationScriptResult = z37.strictObject({
   elapsed_ms: nonNegInt
 });
 var MailAccountsParams = z37.strictObject({});
-var MailAccount = z37.strictObject({ name: z37.string(), emails: z37.array(z37.string()), enabled: z37.boolean() });
+var MailAccount = z37.strictObject({
+  name: z37.string(),
+  emails: z37.array(z37.string()),
+  enabled: z37.boolean(),
+  /** (1.67) The account's mailboxes by name (Matrx Local's email_accounts listed them). */
+  mailboxes: z37.array(z37.string()).optional()
+});
 var MailAccountsResult = z37.strictObject({ accounts: z37.array(MailAccount) });
 var MailListParams = z37.strictObject({
   /** The account's name in Mail; absent: every account. */
@@ -3960,6 +3988,8 @@ var MailListResult = z37.strictObject({ messages: z37.array(MailMessage) });
 var MailSendParams = z37.strictObject({
   to: z37.array(z37.string().min(3).max(320)).min(1).max(50),
   cc: z37.array(z37.string().min(3).max(320)).max(50).default([]),
+  /** (1.67) Blind copies (Matrx Local's send_email bcc). */
+  bcc: z37.array(z37.string().min(3).max(320)).max(50).optional(),
   subject: z37.string().max(998),
   body: Text,
   /** The sending account's address; absent: Mail's default. */
@@ -4038,13 +4068,19 @@ var MessagesChat = z37.strictObject({
   name: z37.string().nullable(),
   participants: z37.array(z37.string()),
   last_message_at_ms: epochMs.nullable(),
-  service: z37.string().nullable()
+  service: z37.string().nullable(),
+  /** (1.67) The newest message's text (Matrx Local's list_conversations preview); absent when it has none. */
+  last_message: z37.string().optional()
 });
 var MessagesChatsResult = z37.strictObject({ chats: z37.array(MessagesChat) });
 var MessagesListParams = z37.strictObject({
   /** One chat (messages.chats' chat_id); absent: the newest across all. */
   chat_id: z37.string().min(1).max(512).optional(),
-  limit: z37.int().min(1).max(500).default(50)
+  limit: z37.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: z37.string().min(1).max(320).optional(),
+  /** (1.67) Only messages not yet read. */
+  unread_only: z37.boolean().optional()
 });
 var MessagesMessage = z37.strictObject({
   id: z37.string(),
@@ -4053,7 +4089,13 @@ var MessagesMessage = z37.strictObject({
   from_me: z37.boolean(),
   /** The other person's handle (phone or email); null for the person's own messages. */
   sender: z37.string().nullable(),
-  sent_at_ms: epochMs.nullable()
+  sent_at_ms: epochMs.nullable(),
+  /** (1.67) Whether it has been read. */
+  read: z37.boolean().optional(),
+  /** (1.67) iMessage, SMS or RCS, as the Messages database says. */
+  service: z37.string().optional(),
+  /** (1.67) The chat's name (group chats); absent for a one-to-one chat. */
+  chat_name: z37.string().optional()
 });
 var MessagesListResult = z37.strictObject({ messages: z37.array(MessagesMessage) });
 var MessagesSendParams = z37.strictObject({
@@ -4068,8 +4110,8 @@ var MessagesSendParams = z37.strictObject({
 });
 var MessagesSendResult = z37.strictObject({ sent: z37.boolean() });
 var ContactsSearchParams = z37.strictObject({
-  /** Matched against names, organizations, emails and phone numbers. */
-  query: z37.string().min(1).max(256),
+  /** Matched against names, organizations, emails and phone numbers; absent (1.67): the first `limit` contacts. */
+  query: z37.string().min(1).max(256).optional(),
   limit: z37.int().min(1).max(200).default(25)
 });
 var ContactLabeled = z37.strictObject({ label: z37.string().nullable(), value: z37.string() });
@@ -4099,6 +4141,8 @@ var CalendarListParams = z37.strictObject({
   to_ms: epochMs,
   /** One calendar's name; absent: every calendar. */
   calendar: z37.string().min(1).max(256).optional(),
+  /** (1.67) Several calendars by name (Matrx Local's calendar_names); with `calendar`, both count. */
+  calendars: z37.array(z37.string().min(1).max(256)).min(1).max(100).optional(),
   limit: z37.int().min(1).max(500).default(100)
 });
 var CalendarEvent = z37.strictObject({
@@ -4109,7 +4153,9 @@ var CalendarEvent = z37.strictObject({
   all_day: z37.boolean(),
   calendar: z37.string(),
   location: z37.string().nullable(),
-  notes: z37.string().nullable()
+  notes: z37.string().nullable(),
+  /** (1.67) The event's link; absent when it has none. */
+  url: z37.string().optional()
 });
 var CalendarListResult = z37.strictObject({ events: z37.array(CalendarEvent) });
 var CalendarCreateParams = z37.strictObject({
@@ -4126,6 +4172,8 @@ var CalendarCreateResult = z37.strictObject({ id: z37.string(), calendar: z37.st
 var RemindersListParams = z37.strictObject({
   /** One list's name; absent: every list. */
   list: z37.string().min(1).max(256).optional(),
+  /** (1.67) Several lists by name (Matrx Local's list_names); with `list`, both count. */
+  lists: z37.array(z37.string().min(1).max(256)).min(1).max(100).optional(),
   include_completed: z37.boolean().default(false),
   limit: z37.int().min(1).max(500).default(100)
 });
@@ -4135,7 +4183,11 @@ var Reminder = z37.strictObject({
   list: z37.string(),
   due_ms: epochMs.nullable(),
   completed: z37.boolean(),
-  notes: z37.string().nullable()
+  notes: z37.string().nullable(),
+  /** (1.67) 0 none, 1 high … 9 low (EventKit's scale). */
+  priority: z37.int().min(0).max(9).optional(),
+  /** (1.67) When it was completed; absent while open. */
+  completed_at_ms: epochMs.optional()
 });
 var RemindersListResult = z37.strictObject({ reminders: z37.array(Reminder) });
 var RemindersCreateParams = z37.strictObject({
@@ -4151,6 +4203,8 @@ var PhotosSearchParams = z37.strictObject({
   from_ms: epochMs.optional(),
   to_ms: epochMs.optional(),
   favorites_only: z37.boolean().default(false),
+  /** (1.67) image, video or all (Matrx Local's media_type); absent: all. */
+  media_type: z37.enum(["image", "video", "all"]).optional(),
   limit: z37.int().min(1).max(200).default(25)
 });
 var Photo = z37.strictObject({
@@ -4160,15 +4214,26 @@ var Photo = z37.strictObject({
   width: nonNegInt.nullable(),
   height: nonNegInt.nullable(),
   favorite: z37.boolean(),
-  title: z37.string().nullable()
+  title: z37.string().nullable(),
+  /** (1.67) What the asset is. */
+  media_type: z37.enum(["image", "video", "audio", "unknown"]).optional(),
+  /** (1.67) A video's length in seconds; absent for a still. */
+  duration_s: z37.number().min(0).optional()
 });
 var PhotosSearchResult = z37.strictObject({ photos: z37.array(Photo) });
 var PhotosGetParams = z37.strictObject({
   id: z37.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: z37.boolean().default(false)
+  export: z37.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: z37.int().min(64).max(2048).optional()
+});
+var PhotosGetResult = z37.strictObject({
+  photo: Photo,
+  path: z37.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: z37.string().optional()
 });
-var PhotosGetResult = z37.strictObject({ photo: Photo, path: z37.string().nullable() });
 var LocationGetParams = z37.strictObject({ timeout_s: z37.int().min(1).max(60).default(15) });
 var LocationGetResult = z37.strictObject({
   latitude: z37.number().min(-90).max(90),
@@ -4177,7 +4242,12 @@ var LocationGetResult = z37.strictObject({
   accuracy_m: z37.number().min(0).nullable(),
   at_ms: epochMs,
   /** Who answered: the OS's own location service. */
-  source: z37.enum(["corelocation", "windows", "geoclue"])
+  source: z37.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: z37.number().optional(),
+  vertical_accuracy_m: z37.number().min(0).optional(),
+  speed_mps: z37.number().min(0).optional(),
+  course_deg: z37.number().min(0).max(360).optional()
 });
 
 // src/schema/windows.ts
@@ -4209,6 +4279,8 @@ var WindowsRegistryWriteResult = z38.strictObject({ key: z38.string(), name: z38
 var WindowsServicesParams = z38.strictObject({
   /** Matched against the service's name and display name. */
   filter: z38.string().min(1).max(256).optional(),
+  /** (1.67) Only services in this state (Matrx Local's service_list status). */
+  status: z38.enum(["running", "stopped", "paused"]).optional(),
   limit: z38.int().min(1).max(1e3).default(200)
 });
 var WindowsService = z38.strictObject({
@@ -4222,7 +4294,8 @@ var WindowsService = z38.strictObject({
 var WindowsServicesResult = z38.strictObject({ services: z38.array(WindowsService) });
 var WindowsServiceControlParams = z38.strictObject({
   name: z38.string().min(1).max(256),
-  action: z38.enum(["start", "stop", "restart"])
+  /** pause and resume since 1.67 (Matrx Local's service_control). */
+  action: z38.enum(["start", "stop", "restart", "pause", "resume"])
 });
 var WindowsServiceControlResult = z38.strictObject({ name: z38.string(), status: z38.string() });
 var WindowsEventLogParams = z38.strictObject({
@@ -4230,6 +4303,8 @@ var WindowsEventLogParams = z38.strictObject({
   /** Only these levels; absent: all. */
   levels: z38.array(z38.enum(["critical", "error", "warning", "information", "verbose"])).max(5).optional(),
   since_ms: epochMs.optional(),
+  /** (1.67) Only events whose source (provider) name contains this. */
+  source: z38.string().min(1).max(256).optional(),
   limit: z38.int().min(1).max(500).default(50)
 });
 var WindowsEvent = z38.strictObject({
@@ -4240,7 +4315,11 @@ var WindowsEvent = z38.strictObject({
   message: z38.string()
 });
 var WindowsEventLogResult = z38.strictObject({ log: z38.string(), events: z38.array(WindowsEvent) });
-var WindowsFeaturesParams = z38.strictObject({ filter: z38.string().min(1).max(256).optional() });
+var WindowsFeaturesParams = z38.strictObject({
+  filter: z38.string().min(1).max(256).optional(),
+  /** (1.67) Only features that are on (Matrx Local's windows_features installed_only). */
+  installed_only: z38.boolean().optional()
+});
 var WindowsFeature = z38.strictObject({ name: z38.string(), state: z38.string() });
 var WindowsFeaturesResult = z38.strictObject({ features: z38.array(WindowsFeature) });
 
@@ -5106,6 +5185,7 @@ var NAMED_SCHEMAS = {
   WindowMoveResult,
   WindowMinimizeParams,
   WindowMinimizeResult,
+  WindowState,
   InputKey,
   InputKeyboardSettingsParams,
   InputKeyboardSettingsResult,
@@ -5625,6 +5705,12 @@ var FIELDS_SINCE = {
   ResourcesDisk: { name: "1.17" },
   StackServer: { cpu_percent: "1.18", memory_bytes: "1.18" },
   AudioDevice: { kind: "1.24" },
+  AudioRecordParams: { channels: "1.66", sample_rate: "1.66" },
+  AudioRecordResult: { channels: "1.66", sample_rate: "1.66" },
+  AudioPlayParams: { device_id: "1.66" },
+  WindowListParams: { app: "1.66" },
+  WindowMinimizeParams: { mode: "1.66" },
+  WindowMinimizeResult: { mode: "1.66" },
   ScreenDisplay: { rotation: "1.24", refresh_hz: "1.24", builtin: "1.24" },
   PowerStatusResult: { energy: "1.24" },
   AppsSpendResult: { days: "1.24" },
@@ -5641,6 +5727,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" }
@@ -5725,7 +5829,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"]]],
@@ -5749,6 +5856,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"]]],
@@ -6378,6 +6493,7 @@ export {
   WindowFocusResult,
   WindowMoveParams,
   WindowMoveResult,
+  WindowState,
   WindowMinimizeParams,
   WindowMinimizeResult,
   InputKey,
@@ -6758,4 +6874,4 @@ export {
   closeRule,
   isTerminalClose
 };
-//# sourceMappingURL=chunk-server-B5W6NL7W.js.map
+//# sourceMappingURL=chunk-server-33UKFIXH.js.map