@ai-matrx/desktop-protocol 0.21.61 → 0.21.64

package/CHANGELOG.md

@@ -2,15 +2,45 @@
 
 ### Unreleased
 
+- **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.61
+## 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`.
 
+## 0.21.62
+
+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
+
+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-B5W6NL7W.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 = 65;
 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),
@@ -1251,7 +1281,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 +1827,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 +1853,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"]);
@@ -3302,6 +3341,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({
@@ -4611,6 +4652,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"] },
@@ -4749,6 +4793,7 @@ var NAMED_SCHEMAS = {
   AppsChatsProbeParams,
   AppsChatsProbeResult,
   InstanceStatus,
+  InstanceGap,
   AppInstall,
   AppInstance,
   AccountResetSource,
@@ -5369,6 +5414,13 @@ var NAMED_SCHEMAS = {
   AccountAgentsRunsResult,
   AccountAgentsFavoriteParams,
   AccountAgentsFavoriteResult,
+  AccountAgentVersion,
+  AccountAgentsVersionsParams,
+  AccountAgentsVersionsResult,
+  AccountAgentsVersionDiffParams,
+  AccountAgentsVersionDiffResult,
+  AccountAgentsRestoreVersionParams,
+  AccountAgentsRestoreVersionResult,
   AppsWindowsUpdateStateParams,
   AppsWindowsUpdateStateResult,
   AppsWindowsReopenParams,
@@ -5560,6 +5612,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 +5620,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 +5746,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.
@@ -5762,6 +5817,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"],
@@ -5790,6 +5857,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;
@@ -6020,6 +6088,13 @@ export {
   AccountAgentsRunsResult,
   AccountAgentsFavoriteParams,
   AccountAgentsFavoriteResult,
+  AccountAgentVersion,
+  AccountAgentsVersionsParams,
+  AccountAgentsVersionsResult,
+  AccountAgentsVersionDiffParams,
+  AccountAgentsVersionDiffResult,
+  AccountAgentsRestoreVersionParams,
+  AccountAgentsRestoreVersionResult,
   VaultItemKind,
   VaultFieldSummary,
   VaultItemSummary,
@@ -6161,6 +6236,7 @@ export {
   AppsChatsCopyToAccountResult,
   InstanceStatus,
   AppInstall,
+  InstanceGap,
   AppInstance,
   AccountResetSource,
   AccountGap,
@@ -6682,4 +6758,4 @@ export {
   closeRule,
   isTerminalClose
 };
-//# sourceMappingURL=chunk-server-OQM4XFUL.js.map
+//# sourceMappingURL=chunk-server-B5W6NL7W.js.map