@ai-matrx/desktop-protocol 0.21.45 → 0.21.47

package/dist/index.js

@@ -2,7 +2,7 @@
 import { z } from "zod";
 import { UUID_SHAPE_PATTERN } from "@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 = 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_-]+$/);
@@ -1421,6 +1421,23 @@ var AppsChatsStarResult = z13.strictObject({ chat: ChatRow });
 
 // src/schema/apps-accounts.ts
 import { z as z14 } from "zod";
+var WindowRemoteControl = z14.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: z14.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: z14.boolean().nullable(),
+  /** A change queued until the window next closes (or restarts); null: none. */
+  pending: z14.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: z14.string().max(300).optional()
+});
 var AppWindowInfo = z14.strictObject({
   key: ChatPlace,
   /** The app's default profile (Claude: main, which may sign into any account). */
@@ -1437,7 +1454,9 @@ var AppWindowInfo = z14.strictObject({
   /** Open now. */
   running: z14.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 = z14.strictObject({
   /** The account's email, or "org <8 chars>" when no window has ever sampled that org. */
@@ -1517,6 +1536,13 @@ var AppsWindowsShownResult = z14.strictObject({
   sections: z14.array(ShownSection).max(200),
   problem: z14.string().max(400).nullable()
 });
+var AppsWindowsSetRemoteControlParams = z14.strictObject({ app_key: AppKey, window: ChatPlace, enabled: z14.boolean() });
+var AppsWindowsSetRemoteControlResult = z14.strictObject({
+  message: z14.string().max(400),
+  /** "now" = written into the closed window; "next_close" = queued until it closes. */
+  when: z14.enum(["now", "next_close"]),
+  remote_control: WindowRemoteControl
+});
 var AppsWindowsRestartParams = z14.strictObject({ app_key: AppKey, window: ChatPlace, force: z14.boolean().default(false) });
 var AppsWindowsRefreshUsageParams = z14.strictObject({ app_key: AppKey, window: ChatPlace });
 var AppsProjectsMoveParams = z14.strictObject({
@@ -1860,19 +1886,23 @@ var AppAccount = z15.strictObject({
   last_seen_ms: epochMs.nullable(),
   missing: z15.array(AccountGap).max(3)
 });
-var AppsInstancesListParams = z15.strictObject({ app_key: AppKey });
+var AppsInstancesListParams = z15.strictObject({ app_key: AppKey, fresh: z15.boolean().optional() });
 var AppsInstancesListResult = z15.strictObject({
   app_key: AppKey,
   install: AppInstall.nullable(),
   instances: z15.array(AppInstance).max(200),
   /** The rows are right but something around them failed; shown, never hidden. */
-  problem: z15.string().max(400).optional()
+  problem: z15.string().max(400).optional(),
+  as_of_ms: epochMs.optional(),
+  refreshing: z15.boolean().optional()
 });
-var AppsAccountsListParams = z15.strictObject({ app_key: AppKey });
+var AppsAccountsListParams = z15.strictObject({ app_key: AppKey, fresh: z15.boolean().optional() });
 var AppsAccountsListResult = z15.strictObject({
   app_key: AppKey,
   accounts: z15.array(AppAccount).max(500),
-  problem: z15.string().max(400).optional()
+  problem: z15.string().max(400).optional(),
+  as_of_ms: epochMs.optional(),
+  refreshing: z15.boolean().optional()
 });
 
 // src/schema/service.ts
@@ -4389,6 +4419,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"] },
@@ -5109,6 +5141,9 @@ var NAMED_SCHEMAS = {
   AppsProjectsCopyResult,
   ChatFamily,
   AppWindowInfo,
+  WindowRemoteControl,
+  AppsWindowsSetRemoteControlParams,
+  AppsWindowsSetRemoteControlResult,
   AccountUsage,
   AccountReset,
   AppsWindowsListParams,
@@ -5445,6 +5480,12 @@ var FIELDS_SINCE = {
   "RelayCallResponse|0": { protocol_version: "1.1" },
   "RelayCallResponse|1": { protocol_version: "1.1" },
   WindowInfo: { app: "1.7", pid: "1.7" },
+  AppWindowInfo: { remote_control: "1.50" },
+  WindowRemoteControl: { problem: "1.52" },
+  AppsInstancesListParams: { fresh: "1.51" },
+  AppsInstancesListResult: { as_of_ms: "1.51", refreshing: "1.51" },
+  AppsAccountsListParams: { fresh: "1.51" },
+  AppsAccountsListResult: { as_of_ms: "1.51", refreshing: "1.51" },
   AppsChatsListResult: { updating: "1.9", live: "1.9", families: "1.10" },
   AppsAccountsUsageResult: { problem: "1.12" },
   AppsAccountsResetsResult: { problem: "1.12" },
@@ -5574,7 +5615,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"]]]
 ]);
 function stripNested(value, nested, version) {
   if (value === null || typeof value !== "object" || Array.isArray(value)) return value;
@@ -5593,6 +5636,23 @@ function stripNested(value, nested, version) {
   }
   return body;
 }
+function windowListRemoteControlForPeer(value, version) {
+  if (knows(version, "1.52") || value === null || typeof value !== "object") return value;
+  const body = value;
+  if (!Array.isArray(body.windows)) return value;
+  const windows = body.windows;
+  const next = windows.map((w) => {
+    const rc = w?.remote_control;
+    if (rc === null || typeof rc !== "object") return w;
+    if (rc.setting === "unreadable") {
+      const { remote_control: _dropped, ...rest } = w;
+      return rest;
+    }
+    const kept = strip(rc, FIELDS_SINCE.WindowRemoteControl, version);
+    return kept === rc ? w : { ...w, remote_control: kept };
+  });
+  return next.some((w, i) => w !== windows[i]) ? { ...body, windows: next } : value;
+}
 var WINDOW_RESULTS = /* @__PURE__ */ new Map([
   ["window.list", "windows"],
   ["window.focus", "window"],
@@ -5619,7 +5679,8 @@ function forPeer(op, part, value, version) {
     const known = op === "sysinfo.get" ? permissionsForPeer(value, version) : value;
     const top = path ? strip(known, FIELDS_SINCE[path], version) : known;
     const nested = op ? NESTED_RESULTS.get(op) : void 0;
-    return nested ? stripNested(top, nested, version) : top;
+    const stripped = nested ? stripNested(top, nested, version) : top;
+    return op === "apps.windows.list" ? windowListRemoteControlForPeer(stripped, version) : stripped;
   }
   if (value === null || typeof value !== "object") return value;
   const body = value;
@@ -5636,7 +5697,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [.../* @__PURE__ */ new Set([...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys(), ...NESTED_RESULTS.keys()])];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "ac576512b0292490d7aa8b1561ccbf2dde677d94150c52d473f58b0d381ba150";
+var CONTRACT_SHA256 = "e9eba8289b9f07b90d920f5a44b038473fae8597e5b43c1f37a2bbda391edcbd";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -6142,6 +6203,8 @@ export {
   AppsWindowsReopenResult,
   AppsWindowsRestartParams,
   AppsWindowsSaveNamesParams,
+  AppsWindowsSetRemoteControlParams,
+  AppsWindowsSetRemoteControlResult,
   AppsWindowsShownParams,
   AppsWindowsShownResult,
   AppsWindowsUpdateAndReopenParams,
@@ -6845,6 +6908,7 @@ export {
   WindowMinimizeResult,
   WindowMoveParams,
   WindowMoveResult,
+  WindowRemoteControl,
   WindowsEvent,
   WindowsEventLogParams,
   WindowsEventLogResult,