@ai-matrx/desktop-protocol 0.21.61 → 0.21.62

package/CHANGELOG.md

@@ -2,15 +2,29 @@
 
 ### Unreleased
 
+- **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.61
+## 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`.
 
+## 0.21.61
+
+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 97978bd752 e86170a22e -- apps/shared/desktop-protocol/src`
+
+Changed shipped source files (5):
+- `apps/shared/desktop-protocol/src/contract.ts`
+- `apps/shared/desktop-protocol/src/schema/apps-chats.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.60
 
 SOURCE CHANGED WITH NO RELEASE NOTE. This release shipped source changes that nobody described in an Unreleased entry,

package/dist/{chunk-server-OQM4XFUL.js → chunk-server-EQCCXWD7.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 = 62;
+var PROTOCOL_MINOR = 63;
 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_-]+$/);
@@ -1251,7 +1251,13 @@ var ChatRow = z13.strictObject({
   /** 1.61: where the title shows (the title facet's sync state for this chat's app). */
   title_sync: ChatTitleSync.optional(),
   /** 1.62: every Move and Copy of this chat between instances, newest first (absent = never moved or copied). */
-  moved: z13.array(ChatMove).max(50).optional()
+  moved: z13.array(ChatMove).max(50).optional(),
+  /**
+   * 1.63: the instance the chat belongs to: the one whose folder holds it (read only; nothing is
+   * moved). Claude: the side window holding its newest record copy (main mirrors every window), else
+   * main; Codex: the home whose database holds it. Absent = only Matrx's holder keeps it.
+   */
+  home: ChatPlace.optional()
 });
 var ChatFamily = z13.strictObject({
   id: ChatId,
@@ -1791,6 +1797,7 @@ var AppInstall = z15.strictObject({
   location: z15.string().max(1024),
   version: z15.string().max(80).nullable()
 });
+var InstanceGap = z15.enum(["account", "email", "version"]);
 var AppInstance = z15.strictObject({
   app_key: AppKey,
   /** "main", or the instance's name: the same key every window action takes. */
@@ -1816,7 +1823,9 @@ var AppInstance = z15.strictObject({
   open_chats: nonNegInt,
   launched_ms: epochMs.nullable(),
   quit_ms: epochMs.nullable(),
-  first_launch_ms: epochMs.nullable()
+  first_launch_ms: epochMs.nullable(),
+  /** 1.63: what this record still lacks after Matrx filled what it remembered (absent = nothing). */
+  missing: z15.array(InstanceGap).max(3).optional()
 });
 var AccountResetSource = z15.enum(["app", "usage_history", "your_list"]);
 var AccountGap = z15.enum(["email", "plan", "usage"]);
@@ -4749,6 +4758,7 @@ var NAMED_SCHEMAS = {
   AppsChatsProbeParams,
   AppsChatsProbeResult,
   InstanceStatus,
+  InstanceGap,
   AppInstall,
   AppInstance,
   AccountResetSource,
@@ -5560,6 +5570,7 @@ var FIELDS_SINCE = {
   CodingDiscoveredChat: { accountId: "1.57" },
   CodingRecentRow: { accountId: "1.57" },
   CodingSearchHit: { accountId: "1.57" },
+  AppInstance: { missing: "1.63" },
   AppsInstancesListParams: { fresh: "1.51" },
   AppsInstancesListResult: { as_of_ms: "1.51", refreshing: "1.51" },
   AppsAccountsListParams: { fresh: "1.51" },
@@ -5567,7 +5578,7 @@ var FIELDS_SINCE = {
   AppsChatsListResult: { updating: "1.9", live: "1.9", families: "1.10" },
   AppsAccountsUsageResult: { problem: "1.12" },
   AppsAccountsResetsResult: { problem: "1.12" },
-  ChatRow: { app_project: "1.13", tokens: "1.13", original_title: "1.14", title_source: "1.14", title_override: "1.14", archived: "1.15", session_id: "1.59", app_groups: "1.59", parent: "1.59", prior_sessions: "1.59", title_sync: "1.61", moved: "1.62" },
+  ChatRow: { app_project: "1.13", tokens: "1.13", original_title: "1.14", title_source: "1.14", title_override: "1.14", archived: "1.15", session_id: "1.59", app_groups: "1.59", parent: "1.59", prior_sessions: "1.59", title_sync: "1.61", moved: "1.62", home: "1.63" },
   AccountUsage: { plan: "1.13", credits: "1.13", five_hour_resets_by_ms: "1.25" },
   ResourcesDisk: { name: "1.17" },
   StackServer: { cpu_percent: "1.18", memory_bytes: "1.18" },
@@ -5693,6 +5704,8 @@ var NESTED_RESULTS = /* @__PURE__ */ new Map([
   // 1.60: each closed window's reopen outcome in a restart_verify copy.
   ["apps.chats.copy_to_account", [["restart", "CopyRestart"]]],
   ["apps.windows.list", [["windows", "AppWindowInfo"]]],
+  // 1.63: what an instance record still lacks.
+  ["apps.instances.list", [["instances", "AppInstance"]]],
   ["apps.windows.set_remote_control", [["remote_control", "WindowRemoteControl"]]],
   ["coding.providers", [["providers", "CodingProviderStatus"]]],
   // 1.57: the account a coding record belongs to.
@@ -6161,6 +6174,7 @@ export {
   AppsChatsCopyToAccountResult,
   InstanceStatus,
   AppInstall,
+  InstanceGap,
   AppInstance,
   AccountResetSource,
   AccountGap,
@@ -6682,4 +6696,4 @@ export {
   closeRule,
   isTerminalClose
 };
-//# sourceMappingURL=chunk-server-OQM4XFUL.js.map
+//# sourceMappingURL=chunk-server-EQCCXWD7.js.map