@ai-matrx/desktop-protocol 0.21.45 → 0.21.47

package/CHANGELOG.md

@@ -1,10 +1,36 @@
 # Changelog
 
-## 0.21.45
+## 0.21.47
 
 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.46
+### Unreleased
+
+- **Protocol 1.52 — Remote Control says when it is wrong.** `WindowRemoteControl` gains optional
+  `problem` (a plain sentence: the settings file is damaged, or why a queued change failed to land) and
+  `setting` gains `"unreadable"` (a damaged file, not the app's default). `forPeer` never sends a 1.50/1.51
+  peer `problem`, and gives a window with a damaged file no `remote_control` (apps.windows.list and
+  apps.windows.set_remote_control are now wired into it, which 1.50 missed). Consumer action: none; show
+  `problem` as a warning and disable the switch for "unreadable".
+- **Protocol 1.50 — a window's Remote Control (phone) setting.** `AppWindowInfo` gains optional
+  `remote_control` (`WindowRemoteControl`: `setting` on/off/default as the window's settings file holds
+  it, `serving` from its live state, `pending` a change queued for its next close). New op
+  `apps.windows.set_remote_control` (`{app_key, window, enabled}` → `{message, when, remote_control}`):
+  a closed window is written now, an open one is queued and written on its next close or Restart.
+  Consumer action: none; a 1.49 core omits the field and answers UNKNOWN_OPERATION.
+
+## 0.21.45
+
+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 de1c78033b 8a91ee5592 -- apps/shared/desktop-protocol/src`
+
+Changed shipped source files (2):
+- `apps/shared/desktop-protocol/src/contract.ts`
+- `apps/shared/desktop-protocol/src/schema/models.ts`
+
 ## 0.21.44
 ### Unreleased
 

package/README.md

@@ -51,7 +51,7 @@ term.write("ls\n");
   those, never on messages. A dropped socket rejects unary work with `DEVICE_OFFLINE` (retryable).
 - **Terminal closes** (`4010` revoked, `4003` forbidden, `4004` not found, `4009` replaced, `4426`
   upgrade) end the client for good; everything else reconnects with the shared
-  `@ai-matrx/realtime` backoff (stability reset + jitter) — including `1006` (a relay deploy drops
+  `@ai-matrx/data/realtime` backoff (stability reset + jitter) — including `1006` (a relay deploy drops
   every socket without a close frame) and `1012` (the relay's "the device reconnected": hello and
   reattach against the new core session).
 - **Coming back:** `client.wake()` (or `bindDesktopWake(client)` / `useDesktopWake()`, which call it

package/dist/client.cjs

@@ -31,7 +31,7 @@ __export(client_exports, {
 module.exports = __toCommonJS(client_exports);
 
 // src/client/client.ts
-var import_realtime = require("@ai-matrx/realtime");
+var import_realtime = require("@ai-matrx/data/realtime");
 
 // src/error.ts
 var DesktopProtocolError = class _DesktopProtocolError extends Error {
@@ -144,7 +144,7 @@ var import_zod2 = require("zod");
 var import_zod = require("zod");
 var import_uuid = require("@ai-matrx/kit/uuid");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 49;
+var PROTOCOL_MINOR = 52;
 var PROTOCOL_VERSION = `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
 var ProtocolVersion = import_zod.z.string().regex(/^[1-9][0-9]{0,2}\.[0-9]{1,3}$/);
 var RequestId = import_zod.z.string().min(1).max(64).regex(/^[A-Za-z0-9_-]+$/);
@@ -3043,6 +3043,23 @@ var AppsChatsStarResult = import_zod30.z.strictObject({ chat: ChatRow });
 
 // src/schema/apps-accounts.ts
 var import_zod31 = require("zod");
+var WindowRemoteControl = import_zod31.z.strictObject({
+  /**
+   * As the window's settings file holds it: on, off, or never set (the app's default). 1.52:
+   * "unreadable" = the file is there but damaged, so the setting is not known (`problem` says why).
+   */
+  setting: import_zod31.z.enum(["on", "off", "default", "unreadable"]),
+  /** The window serves Remote Control now (its live state says "on"); null: not known (closed, or no state file). */
+  serving: import_zod31.z.boolean().nullable(),
+  /** A change queued until the window next closes (or restarts); null: none. */
+  pending: import_zod31.z.enum(["on", "off"]).nullable(),
+  /**
+   * 1.52: why the setting cannot be trusted, as a plain sentence for the person: the settings file is
+   * damaged ("unreadable"), or a queued change failed to land (it stays queued; asking again retries).
+   * Absent: nothing wrong. An older core omits it.
+   */
+  problem: import_zod31.z.string().max(300).optional()
+});
 var AppWindowInfo = import_zod31.z.strictObject({
   key: ChatPlace,
   /** The app's default profile (Claude: main, which may sign into any account). */
@@ -3059,7 +3076,9 @@ var AppWindowInfo = import_zod31.z.strictObject({
   /** Open now. */
   running: import_zod31.z.boolean(),
   /** Chats open in it now (a process resuming each one). */
-  open_chats: nonNegInt
+  open_chats: nonNegInt,
+  /** 1.50: its Remote Control (phone) setting; absent from an older core, or an app without one. */
+  remote_control: WindowRemoteControl.optional()
 });
 var AccountUsage = import_zod31.z.strictObject({
   /** The account's email, or "org <8 chars>" when no window has ever sampled that org. */
@@ -3139,6 +3158,13 @@ var AppsWindowsShownResult = import_zod31.z.strictObject({
   sections: import_zod31.z.array(ShownSection).max(200),
   problem: import_zod31.z.string().max(400).nullable()
 });
+var AppsWindowsSetRemoteControlParams = import_zod31.z.strictObject({ app_key: AppKey, window: ChatPlace, enabled: import_zod31.z.boolean() });
+var AppsWindowsSetRemoteControlResult = import_zod31.z.strictObject({
+  message: import_zod31.z.string().max(400),
+  /** "now" = written into the closed window; "next_close" = queued until it closes. */
+  when: import_zod31.z.enum(["now", "next_close"]),
+  remote_control: WindowRemoteControl
+});
 var AppsWindowsRestartParams = import_zod31.z.strictObject({ app_key: AppKey, window: ChatPlace, force: import_zod31.z.boolean().default(false) });
 var AppsWindowsRefreshUsageParams = import_zod31.z.strictObject({ app_key: AppKey, window: ChatPlace });
 var AppsProjectsMoveParams = import_zod31.z.strictObject({
@@ -3482,19 +3508,23 @@ var AppAccount = import_zod32.z.strictObject({
   last_seen_ms: epochMs.nullable(),
   missing: import_zod32.z.array(AccountGap).max(3)
 });
-var AppsInstancesListParams = import_zod32.z.strictObject({ app_key: AppKey });
+var AppsInstancesListParams = import_zod32.z.strictObject({ app_key: AppKey, fresh: import_zod32.z.boolean().optional() });
 var AppsInstancesListResult = import_zod32.z.strictObject({
   app_key: AppKey,
   install: AppInstall.nullable(),
   instances: import_zod32.z.array(AppInstance).max(200),
   /** The rows are right but something around them failed; shown, never hidden. */
-  problem: import_zod32.z.string().max(400).optional()
+  problem: import_zod32.z.string().max(400).optional(),
+  as_of_ms: epochMs.optional(),
+  refreshing: import_zod32.z.boolean().optional()
 });
-var AppsAccountsListParams = import_zod32.z.strictObject({ app_key: AppKey });
+var AppsAccountsListParams = import_zod32.z.strictObject({ app_key: AppKey, fresh: import_zod32.z.boolean().optional() });
 var AppsAccountsListResult = import_zod32.z.strictObject({
   app_key: AppKey,
   accounts: import_zod32.z.array(AppAccount).max(500),
-  problem: import_zod32.z.string().max(400).optional()
+  problem: import_zod32.z.string().max(400).optional(),
+  as_of_ms: epochMs.optional(),
+  refreshing: import_zod32.z.boolean().optional()
 });
 
 // src/schema/browser.ts
@@ -4334,6 +4364,8 @@ var OPS = {
   "apps.windows.open": { params: AppsWindowsOpenParams, result: AppsWindowActionResult, kind: "unary", since: "1.10", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.windows.reload": { params: AppsWindowsReloadParams, result: AppsWindowActionResult, kind: "unary", since: "1.10", errors: ["NOT_FOUND", "CONFLICT", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.windows.restart": { params: AppsWindowsRestartParams, result: AppsWindowActionResult, kind: "unary", since: "1.10", errors: ["NOT_FOUND", "CONFLICT", "TIMEOUT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  // 1.50: a window's Remote Control (phone) setting, written while closed or queued for its next close.
+  "apps.windows.set_remote_control": { params: AppsWindowsSetRemoteControlParams, result: AppsWindowsSetRemoteControlResult, kind: "unary", since: "1.50", errors: ["NOT_FOUND", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.windows.refresh_usage": { params: AppsWindowsRefreshUsageParams, result: AppsWindowActionResult, kind: "unary", since: "1.10", errors: ["NOT_FOUND", "TIMEOUT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.accounts.usage": { params: AppsAccountsUsageParams, result: AppsAccountsUsageResult, kind: "unary", since: "1.10", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.accounts.resets": { params: AppsAccountsResetsParams, result: AppsAccountsResetsResult, kind: "unary", since: "1.10", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
@@ -4600,7 +4632,9 @@ var NESTED_RESULTS = /* @__PURE__ */ new Map([
   ["web.scrape", [["pages", "WebScrapePage"]]],
   ["sysinfo.get", [["permissions", "SysinfoGetResult.permissions[]"]]],
   ["models.downloads.list", [["downloads", "DownloadRow"]]],
-  ["apps.projects.to_window", [["group", "ProjectMoveGroup"]]]
+  ["apps.projects.to_window", [["group", "ProjectMoveGroup"]]],
+  ["apps.windows.list", [["windows", "AppWindowInfo"]]],
+  ["apps.windows.set_remote_control", [["remote_control", "WindowRemoteControl"]]]
 ]);
 var WINDOW_RESULTS = /* @__PURE__ */ new Map([
   ["window.list", "windows"],