@ai-matrx/desktop-protocol 0.21.62 → 0.21.65

package/CHANGELOG.md

@@ -1,16 +1,42 @@
 # 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.
 - **Protocol 1.62 — moves as records (2026-10-20).** `ChatRow.moved` (`ChatMove[]`, newest first: `kind` move / copy, `from`, `to`, `at_ms`, `back_at_ms`): every Move and Copy of a chat between instances as Matrx recorded it, so a screen reads where a chat went and whether it came back from the record, never from a project named "From X". Optional; stripped for a 1.61 peer by `forPeer`. Consumer action: none.
 - **Protocol 1.61 — where a chat's title shows (2026-10-20).** `ChatRow.title_sync` (`ChatTitleSync`: `state` synced / not_synced / unsupported, and a `note`): the title facet's sync state for the chat's app, so a screen can say honestly whether the app shows the person's name. Optional; stripped for a 1.60 peer by `forPeer`. Consumer action: none.
 - **Shared code ships once per side (2026-10-18).** Built `splitting: false`, the root, `/frame` and `/client` each carried their own copy of 44 shared modules. ESM now builds them in one split pass (`chunk-server-*.js`, no banner); `/react` builds alone, stamped. CJS unsplit; declarations per group. ESM JS 610,843 -> 398,722 bytes; root + `/client` together 597 KB -> 390 KB; `/frame` stays zod-free (6 KB); every entry's export names identical (ESM and CJS). Guard: `../scripts/check-ships-once.mjs`, run in `build`. Consumer action: none.
 
+## 0.21.64
+
+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
 
-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 e86170a22e 920791a7ff -- apps/shared/desktop-protocol/src`
+
+Changed shipped source files (6):
+- `apps/shared/desktop-protocol/src/contract.ts`
+- `apps/shared/desktop-protocol/src/schema/apps-chats.ts`
+- `apps/shared/desktop-protocol/src/schema/apps-instances.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.61
 

package/dist/{chunk-server-EQCCXWD7.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 = 63;
+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_-]+$/);
@@ -1002,6 +1002,36 @@ var AccountAgentsRunsResult = z11.strictObject({
 });
 var AccountAgentsFavoriteParams = z11.strictObject({ agent_id: AccountRowId, favorite: z11.boolean() });
 var AccountAgentsFavoriteResult = z11.strictObject({ favorite: z11.boolean() });
+var AccountAgentVersion = z11.strictObject({
+  version_id: AccountRowId,
+  version_number: z11.int().min(1),
+  changed_at_ms: epochMs,
+  /** The change note the person wrote when saving, when they wrote one. */
+  note: z11.string().max(1e3).nullable()
+});
+var AccountAgentsVersionsParams = z11.strictObject({
+  agent_id: AccountRowId,
+  offset: z11.int().min(0).max(1e5).optional(),
+  limit: z11.int().min(1).max(200).optional()
+});
+var AccountAgentsVersionsResult = z11.strictObject({
+  state: AccountReadState,
+  problem: z11.string().max(300).nullable(),
+  /** The version the agent is at now (null: no saved version yet). */
+  current_version: z11.int().min(1).nullable(),
+  rows: z11.array(AccountAgentVersion).max(200)
+});
+var AccountAgentsVersionDiffParams = z11.strictObject({ agent_id: AccountRowId, version_number: z11.int().min(1) });
+var AccountAgentsVersionDiffResult = z11.strictObject({
+  state: AccountReadState,
+  problem: z11.string().max(300).nullable(),
+  version_number: z11.int().min(1),
+  current_version: z11.int().min(1).nullable(),
+  old: z11.record(z11.string().max(200), z11.unknown()).nullable(),
+  current: z11.record(z11.string().max(200), z11.unknown()).nullable()
+});
+var AccountAgentsRestoreVersionParams = z11.strictObject({ agent_id: AccountRowId, version_number: z11.int().min(1) });
+var AccountAgentsRestoreVersionResult = z11.strictObject({ restored_version: z11.int().min(1) });
 var VaultItemKind = z11.enum(["login", "passkey", "key", "other"]);
 var VaultFieldSummary = z11.strictObject({
   key: z11.string().min(1).max(120),
@@ -2482,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({
@@ -2501,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";
@@ -3014,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({
@@ -3311,6 +3363,8 @@ var CodingTranscriptItem = z34.discriminatedUnion("kind", [
   }),
   z34.strictObject({ kind: z34.literal("usage"), usage: CodingRunUsage, costUsd: z34.number().nullable() }),
   z34.strictObject({ kind: z34.literal("notice"), id: z34.string().max(200), level: z34.enum(["info", "warning"]), text: z34.string() }),
+  /** "Continue on <account>": the line across the transcript where the chat moved from `from`. */
+  z34.strictObject({ kind: z34.literal("continued"), id: z34.string().max(200), from: z34.string().max(300), text: z34.string(), at: IsoTime.nullable() }),
   z34.strictObject({ kind: z34.literal("error"), id: z34.string().max(200), text: z34.string() })
 ]);
 var CodingHistoryRecord = z34.strictObject({
@@ -4620,6 +4674,9 @@ var OPS = {
   "account.agents.get": { params: AccountAgentsGetParams, result: AccountAgentsGetResult, kind: "unary", since: "1.39", errors: ["INVALID_PARAMS", "INTERNAL"] },
   "account.agents.runs": { params: AccountAgentsRunsParams, result: AccountAgentsRunsResult, kind: "unary", since: "1.39", errors: ["INVALID_PARAMS", "INTERNAL"] },
   "account.agents.favorite": { params: AccountAgentsFavoriteParams, result: AccountAgentsFavoriteResult, kind: "unary", since: "1.39", errors: ["AUTH_REQUIRED", "NOT_FOUND", "INVALID_PARAMS", "DEVICE_OFFLINE", "INTERNAL"] },
+  "account.agents.versions": { params: AccountAgentsVersionsParams, result: AccountAgentsVersionsResult, kind: "unary", since: "1.64", errors: ["INVALID_PARAMS", "INTERNAL"] },
+  "account.agents.version_diff": { params: AccountAgentsVersionDiffParams, result: AccountAgentsVersionDiffResult, kind: "unary", since: "1.64", errors: ["INVALID_PARAMS", "INTERNAL"] },
+  "account.agents.restore_version": { params: AccountAgentsRestoreVersionParams, result: AccountAgentsRestoreVersionResult, kind: "unary", since: "1.64", errors: ["AUTH_REQUIRED", "NOT_FOUND", "INVALID_PARAMS", "DEVICE_OFFLINE", "INTERNAL"] },
   // 1.26: the app's own update (it installs only once every window quit) and bringing the windows back.
   "apps.windows.update_state": { params: AppsWindowsUpdateStateParams, result: AppsWindowsUpdateStateResult, kind: "unary", since: "1.26", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.windows.reopen": { params: AppsWindowsReopenParams, result: AppsWindowsReopenResult, kind: "unary", since: "1.26", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
@@ -5071,6 +5128,7 @@ var NAMED_SCHEMAS = {
   WindowMoveResult,
   WindowMinimizeParams,
   WindowMinimizeResult,
+  WindowState,
   InputKey,
   InputKeyboardSettingsParams,
   InputKeyboardSettingsResult,
@@ -5379,6 +5437,13 @@ var NAMED_SCHEMAS = {
   AccountAgentsRunsResult,
   AccountAgentsFavoriteParams,
   AccountAgentsFavoriteResult,
+  AccountAgentVersion,
+  AccountAgentsVersionsParams,
+  AccountAgentsVersionsResult,
+  AccountAgentsVersionDiffParams,
+  AccountAgentsVersionDiffResult,
+  AccountAgentsRestoreVersionParams,
+  AccountAgentsRestoreVersionResult,
   AppsWindowsUpdateStateParams,
   AppsWindowsUpdateStateResult,
   AppsWindowsReopenParams,
@@ -5583,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" },
@@ -5775,6 +5846,18 @@ function providersForPeer(value, version) {
   });
   return next.some((p, i) => p !== providers[i]) ? { ...body, providers: next } : value;
 }
+function transcriptItemsForPeer(value, version) {
+  if (knows(version, "1.65") || value === null || typeof value !== "object") return value;
+  const body = value;
+  if (!Array.isArray(body.items)) return value;
+  const items = body.items;
+  const next = items.map((item) => {
+    const it = item;
+    if (it?.kind !== "continued") return item;
+    return { kind: "notice", id: it.id, level: "info", text: it.text };
+  });
+  return next.some((it, i) => it !== items[i]) ? { ...body, items: next } : value;
+}
 var WINDOW_RESULTS = /* @__PURE__ */ new Map([
   ["window.list", "windows"],
   ["window.focus", "window"],
@@ -5803,6 +5886,7 @@ function forPeer(op, part, value, version) {
     const nested = op ? NESTED_RESULTS.get(op) : void 0;
     const stripped = nested ? stripNested(top, nested, version) : top;
     if (op === "coding.providers") return providersForPeer(stripped, version);
+    if (op === "coding.history" || op === "coding.transcript.read") return transcriptItemsForPeer(stripped, version);
     return op === "apps.windows.list" ? windowListRemoteControlForPeer(stripped, version) : stripped;
   }
   if (value === null || typeof value !== "object") return value;
@@ -6033,6 +6117,13 @@ export {
   AccountAgentsRunsResult,
   AccountAgentsFavoriteParams,
   AccountAgentsFavoriteResult,
+  AccountAgentVersion,
+  AccountAgentsVersionsParams,
+  AccountAgentsVersionsResult,
+  AccountAgentsVersionDiffParams,
+  AccountAgentsVersionDiffResult,
+  AccountAgentsRestoreVersionParams,
+  AccountAgentsRestoreVersionResult,
   VaultItemKind,
   VaultFieldSummary,
   VaultItemSummary,
@@ -6316,6 +6407,7 @@ export {
   WindowFocusResult,
   WindowMoveParams,
   WindowMoveResult,
+  WindowState,
   WindowMinimizeParams,
   WindowMinimizeResult,
   InputKey,
@@ -6696,4 +6788,4 @@ export {
   closeRule,
   isTerminalClose
 };
-//# sourceMappingURL=chunk-server-EQCCXWD7.js.map
+//# sourceMappingURL=chunk-server-K7IQDLLV.js.map