@ai-matrx/desktop-protocol 0.21.64 → 0.21.65

package/CHANGELOG.md

@@ -1,7 +1,8 @@
 # Changelog
 
-### Unreleased
+## 0.21.65
 
+- **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 +12,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-K7IQDLLV.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 = 66;
 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({
@@ -5106,6 +5128,7 @@ var NAMED_SCHEMAS = {
   WindowMoveResult,
   WindowMinimizeParams,
   WindowMinimizeResult,
+  WindowState,
   InputKey,
   InputKeyboardSettingsParams,
   InputKeyboardSettingsResult,
@@ -5625,6 +5648,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" },
@@ -6378,6 +6407,7 @@ export {
   WindowFocusResult,
   WindowMoveParams,
   WindowMoveResult,
+  WindowState,
   WindowMinimizeParams,
   WindowMinimizeResult,
   InputKey,
@@ -6758,4 +6788,4 @@ export {
   closeRule,
   isTerminalClose
 };
-//# sourceMappingURL=chunk-server-B5W6NL7W.js.map
+//# sourceMappingURL=chunk-server-K7IQDLLV.js.map