@ai-matrx/desktop-protocol 0.21.62 → 0.21.64

package/CHANGELOG.md

@@ -2,16 +2,32 @@
 
 ### 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.62
+## 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,

package/dist/{chunk-server-EQCCXWD7.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 = 63;
+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),
@@ -3311,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({
@@ -4620,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"] },
@@ -5379,6 +5414,13 @@ var NAMED_SCHEMAS = {
   AccountAgentsRunsResult,
   AccountAgentsFavoriteParams,
   AccountAgentsFavoriteResult,
+  AccountAgentVersion,
+  AccountAgentsVersionsParams,
+  AccountAgentsVersionsResult,
+  AccountAgentsVersionDiffParams,
+  AccountAgentsVersionDiffResult,
+  AccountAgentsRestoreVersionParams,
+  AccountAgentsRestoreVersionResult,
   AppsWindowsUpdateStateParams,
   AppsWindowsUpdateStateResult,
   AppsWindowsReopenParams,
@@ -5775,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"],
@@ -5803,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;
@@ -6033,6 +6088,13 @@ export {
   AccountAgentsRunsResult,
   AccountAgentsFavoriteParams,
   AccountAgentsFavoriteResult,
+  AccountAgentVersion,
+  AccountAgentsVersionsParams,
+  AccountAgentsVersionsResult,
+  AccountAgentsVersionDiffParams,
+  AccountAgentsVersionDiffResult,
+  AccountAgentsRestoreVersionParams,
+  AccountAgentsRestoreVersionResult,
   VaultItemKind,
   VaultFieldSummary,
   VaultItemSummary,
@@ -6696,4 +6758,4 @@ export {
   closeRule,
   isTerminalClose
 };
-//# sourceMappingURL=chunk-server-EQCCXWD7.js.map
+//# sourceMappingURL=chunk-server-B5W6NL7W.js.map