@ai-matrx/desktop-protocol 0.21.44 → 0.21.46

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.21.46
+### Unreleased
+
+- **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 = 51;
 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_-]+$/);
@@ -935,8 +935,8 @@ var MlCatalogSetParams = import_zod9.z.strictObject({
   transcription: import_zod9.z.array(CatalogModelEntry).max(64),
   /** Null where the catalog has no build for this os/arch (installs then say so). */
   llama_server: LlamaServerBuild.nullable(),
-  /** The knob desktop.models/default_transcription_model. */
-  default_transcription: TranscriptionModelId,
+  /** The knob desktop.models/default_transcription_model; null when the knob could not be read (a transcribe naming no model then says so). */
+  default_transcription: TranscriptionModelId.nullable(),
   /** When the catalog was last changed (catalog_updated_at), for the service's log. */
   catalog_updated_at: import_zod9.z.string().max(40)
 });
@@ -3043,6 +3043,14 @@ 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). */
+  setting: import_zod31.z.enum(["on", "off", "default"]),
+  /** 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()
+});
 var AppWindowInfo = import_zod31.z.strictObject({
   key: ChatPlace,
   /** The app's default profile (Claude: main, which may sign into any account). */
@@ -3059,7 +3067,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 +3149,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 +3499,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 +4355,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"] },