@ai-matrx/desktop-protocol 0.17.4 → 0.17.6

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.17.6
+### (protocol 1.10)
+
+- **A coding app's windows and accounts.** New ops `apps.windows.list` (each window: meant-for
+  account, signed-in account, mismatch, open, chats open), `apps.windows.open` (bring to front, or
+  open), `apps.windows.reload` (⌘R: re-read the chat list, chats keep running),
+  `apps.windows.restart` (CONFLICT while chats are open unless `force`), `apps.windows.refresh_usage`
+  (open in the background for a fresh reading, then close); `apps.accounts.usage` (5-hour, weekly,
+  extra per account; org → account by sample vote with `account_certain`; weekly reset time and
+  whether it is official) and `apps.accounts.resets` (next weekly reset per window: claude /
+  usage_history / your_list). Chats: `apps.projects.move`, `apps.projects.create`,
+  `apps.projects.import_pins` (Refresh pins), and `apps.chats.list` gains optional `families`
+  (fork of / copy of), stripped for peers below 1.10 (guard: versioning.test.ts "apps chats 1.10").
+
+Consumer action: none for older peers.
+
+## 0.17.5
+### (protocol 1.9)
+
+- `apps.chats.place` (place / take_off / hold, with the engine's guards), `apps.projects.file_many`,
+  `apps.projects.update` (rename, archive, restore), `apps.projects.copy`; event
+  `apps.chats.watch_state {app_key, live, updating, reason}`; `apps.chats.list` gains optional
+  `updating` and `live`, stripped for peers below 1.9 (guard: versioning.test.ts "apps chats 1.9").
+
+Consumer action: none for older peers.
+
 ## 0.17.4
 ### (protocol 1.8)
 

package/dist/client.cjs

@@ -143,7 +143,7 @@ var import_zod2 = require("zod");
 // src/schema/primitives.ts
 var import_zod = require("zod");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 8;
+var PROTOCOL_MINOR = 10;
 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_-]+$/);
@@ -1506,6 +1506,11 @@ var ChatRow = import_zod24.z.strictObject({
   warnings: import_zod24.z.array(import_zod24.z.string().max(400)).max(20),
   last_use: ChatLastUse.nullable()
 });
+var ChatFamily = import_zod24.z.strictObject({
+  id: ChatId,
+  fork_of: ChatId.nullable(),
+  copy_of: ChatId.nullable()
+});
 var AppsChatsListParams = import_zod24.z.strictObject({
   app_key: AppKey,
   /** Only these chats (a live update re-reads just what changed). */
@@ -1519,7 +1524,13 @@ var AppsChatsListResult = import_zod24.z.strictObject({
   projects: import_zod24.z.array(ChatProject).max(5e3),
   chats: import_zod24.z.array(ChatRow).max(2e4),
   /** How long a chat in no project counts as new. */
-  new_window_ms: nonNegInt
+  new_window_ms: nonNegInt,
+  /** 1.9: this is the copy saved at the last read, shown while everything is read again. */
+  updating: import_zod24.z.boolean().optional(),
+  /** 1.9: false while the folder watches are down (changes are not arriving); `apps.chats.watch_state` says when it changes. */
+  live: import_zod24.z.boolean().optional(),
+  /** 1.10: every listed chat that is a fork or a copy of another (read from the conversations' first lines). */
+  families: import_zod24.z.array(ChatFamily).max(2e4).optional()
 });
 var AppsChatsWatchParams = import_zod24.z.strictObject({ app_key: AppKey });
 var AppsChatsWatchResult = import_zod24.z.strictObject({ resource_id: ResourceId, version: nonNegInt });
@@ -1529,6 +1540,38 @@ var AppsChatsChangedEvent = import_zod24.z.strictObject({
   ids: import_zod24.z.array(ChatId).max(1e3),
   all: import_zod24.z.boolean()
 });
+var AppsChatsWatchStateEvent = import_zod24.z.strictObject({
+  app_key: AppKey,
+  live: import_zod24.z.boolean(),
+  updating: import_zod24.z.boolean(),
+  reason: import_zod24.z.string().max(300).nullable()
+});
+var AppsChatsPlaceParams = import_zod24.z.strictObject({
+  app_key: AppKey,
+  chat_id: ChatId,
+  action: import_zod24.z.enum(["place", "take_off", "hold"]),
+  /** The window (for place and take_off). */
+  window: ChatPlace.optional(),
+  /** take_off where it is open: stop it there first (the person confirmed). */
+  stop_if_open: import_zod24.z.boolean().default(false)
+});
+var AppsChatsPlaceResult = import_zod24.z.strictObject({ chat: ChatRow, message: import_zod24.z.string().max(400) });
+var AppsProjectsFileManyParams = import_zod24.z.strictObject({
+  app_key: AppKey,
+  chat_ids: import_zod24.z.array(ChatId).min(1).max(500),
+  project_id: ChatProjectId.optional(),
+  new_project_name: import_zod24.z.string().min(1).max(200).optional()
+});
+var AppsProjectsFileManyResult = import_zod24.z.strictObject({ chats: import_zod24.z.array(ChatRow).max(500), project: ChatProject });
+var AppsProjectsUpdateParams = import_zod24.z.strictObject({
+  app_key: AppKey,
+  project_id: ChatProjectId,
+  name: import_zod24.z.string().min(1).max(200).optional(),
+  archived: import_zod24.z.boolean().optional()
+});
+var AppsProjectsUpdateResult = import_zod24.z.strictObject({ project: ChatProject });
+var AppsProjectsCopyParams = import_zod24.z.strictObject({ app_key: AppKey, project_id: ChatProjectId, new_project_name: import_zod24.z.string().min(1).max(200) });
+var AppsProjectsCopyResult = import_zod24.z.strictObject({ project: ChatProject });
 var AppsProjectsFileParams = import_zod24.z.strictObject({
   app_key: AppKey,
   chat_id: ChatId,
@@ -1541,6 +1584,86 @@ var AppsProjectsUnfileResult = import_zod24.z.strictObject({ chat: ChatRow });
 var AppsChatsStarParams = import_zod24.z.strictObject({ app_key: AppKey, chat_id: ChatId, starred: import_zod24.z.boolean() });
 var AppsChatsStarResult = import_zod24.z.strictObject({ chat: ChatRow });
 
+// src/schema/apps-accounts.ts
+var import_zod25 = require("zod");
+var AppWindowInfo = import_zod25.z.strictObject({
+  key: ChatPlace,
+  /** The app's default profile (Claude: main, which may sign into any account). */
+  main: import_zod25.z.boolean(),
+  /** The account the window is meant for (null for main). */
+  account: import_zod25.z.string().max(320).nullable(),
+  /** The account signed in there now: an email, or the account id while it has no saved name. */
+  signed_in: import_zod25.z.string().max(320).nullable(),
+  signed_in_is_email: import_zod25.z.boolean(),
+  /** Signed into another account than the one it is meant for. */
+  mismatch: import_zod25.z.boolean(),
+  /** Its folder exists. */
+  created: import_zod25.z.boolean(),
+  /** Open now. */
+  running: import_zod25.z.boolean(),
+  /** Chats open in it now (a process resuming each one). */
+  open_chats: nonNegInt
+});
+var AccountUsage = import_zod25.z.strictObject({
+  /** The account's email, or "org <8 chars>" when no window has ever sampled that org. */
+  account: import_zod25.z.string().max(320),
+  org: import_zod25.z.string().max(80).nullable(),
+  /** False when the org was sampled in several accounts' windows and the vote is not clear (≥ 75 %). */
+  account_certain: import_zod25.z.boolean(),
+  /** 5-hour use in percent (0 once the reading is over 5 hours old). */
+  five_hour: import_zod25.z.number().nullable(),
+  five_hour_reset_since: import_zod25.z.boolean(),
+  /** Weekly use in percent (0 once the week reset after the reading). */
+  weekly: import_zod25.z.number().nullable(),
+  weekly_reset_since: import_zod25.z.boolean(),
+  /** Extra-usage spend in percent of its cap, when on. */
+  extra_usage: import_zod25.z.number().nullable(),
+  extra_usage_as_of_ms: epochMs.nullable(),
+  as_of_ms: epochMs,
+  /** The windows meant for this account (and main when main took the reading). */
+  windows: import_zod25.z.array(ChatPlace).max(200),
+  /** The window that took the reading is open now and the reading is under 30 minutes old. */
+  live: import_zod25.z.boolean(),
+  /** The next weekly reset, when known. */
+  weekly_resets_at_ms: epochMs.nullable(),
+  /** That reset time is Claude's own (its reading, or a reset seen in its usage history). */
+  weekly_reset_official: import_zod25.z.boolean().nullable()
+});
+var AccountReset = import_zod25.z.strictObject({
+  window: ChatPlace,
+  account: import_zod25.z.string().max(320).nullable(),
+  next_reset_ms: epochMs.nullable(),
+  /** claude: the app's own reading; usage_history: a weekly drop seen in its usage record; your_list: the person's own entry. */
+  source: import_zod25.z.enum(["claude", "usage_history", "your_list"]).nullable(),
+  /** claude or usage_history. */
+  official: import_zod25.z.boolean(),
+  /** Set when the person's list disagrees with the official time. */
+  note: import_zod25.z.string().max(200).nullable()
+});
+var AppsWindowsListParams = import_zod25.z.strictObject({ app_key: AppKey });
+var AppsWindowsListResult = import_zod25.z.strictObject({ app_key: AppKey, windows: import_zod25.z.array(AppWindowInfo).max(200) });
+var AppsAccountsUsageParams = import_zod25.z.strictObject({ app_key: AppKey });
+var AppsAccountsUsageResult = import_zod25.z.strictObject({ app_key: AppKey, accounts: import_zod25.z.array(AccountUsage).max(500) });
+var AppsAccountsResetsParams = import_zod25.z.strictObject({ app_key: AppKey });
+var AppsAccountsResetsResult = import_zod25.z.strictObject({ app_key: AppKey, resets: import_zod25.z.array(AccountReset).max(200) });
+var AppsWindowActionResult = import_zod25.z.strictObject({ message: import_zod25.z.string().max(400) });
+var AppsWindowsOpenParams = import_zod25.z.strictObject({ app_key: AppKey, window: ChatPlace });
+var AppsWindowsReloadParams = import_zod25.z.strictObject({ app_key: AppKey, window: ChatPlace });
+var AppsWindowsRestartParams = import_zod25.z.strictObject({ app_key: AppKey, window: ChatPlace, force: import_zod25.z.boolean().default(false) });
+var AppsWindowsRefreshUsageParams = import_zod25.z.strictObject({ app_key: AppKey, window: ChatPlace });
+var AppsProjectsMoveParams = import_zod25.z.strictObject({
+  app_key: AppKey,
+  chat_id: ChatId,
+  from_project_id: ChatProjectId,
+  to_project_id: ChatProjectId.optional(),
+  new_project_name: import_zod25.z.string().min(1).max(200).optional()
+});
+var AppsProjectsMoveResult = import_zod25.z.strictObject({ chat: ChatRow, project: ChatProject });
+var AppsProjectsCreateParams = import_zod25.z.strictObject({ app_key: AppKey, name: import_zod25.z.string().min(1).max(200) });
+var AppsProjectsCreateResult = import_zod25.z.strictObject({ project: ChatProject });
+var AppsProjectsImportPinsParams = import_zod25.z.strictObject({ app_key: AppKey });
+var AppsProjectsImportPinsResult = import_zod25.z.strictObject({ message: import_zod25.z.string().max(400) });
+
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
@@ -1582,7 +1705,22 @@ var OPS = {
   "apps.chats.watch": { params: AppsChatsWatchParams, result: AppsChatsWatchResult, kind: "resource", since: "1.8", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "RESOURCE_BUSY", "INTERNAL"] },
   "apps.chats.star": { params: AppsChatsStarParams, result: AppsChatsStarResult, kind: "unary", since: "1.8", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.projects.file": { params: AppsProjectsFileParams, result: AppsProjectsFileResult, kind: "unary", since: "1.8", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.chats.place": { params: AppsChatsPlaceParams, result: AppsChatsPlaceResult, kind: "unary", since: "1.9", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.projects.file_many": { params: AppsProjectsFileManyParams, result: AppsProjectsFileManyResult, kind: "unary", since: "1.9", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.projects.update": { params: AppsProjectsUpdateParams, result: AppsProjectsUpdateResult, kind: "unary", since: "1.9", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.projects.copy": { params: AppsProjectsCopyParams, result: AppsProjectsCopyResult, kind: "unary", since: "1.9", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.projects.unfile": { params: AppsProjectsUnfileParams, result: AppsProjectsUnfileResult, kind: "unary", since: "1.8", errors: ["NOT_FOUND", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  // 1.10: the app's windows and accounts (usage by vote, weekly resets, window actions), project move/create, Refresh pins.
+  "apps.windows.list": { params: AppsWindowsListParams, result: AppsWindowsListResult, kind: "unary", since: "1.10", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "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"] },
+  "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"] },
+  "apps.projects.move": { params: AppsProjectsMoveParams, result: AppsProjectsMoveResult, kind: "unary", since: "1.10", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.projects.create": { params: AppsProjectsCreateParams, result: AppsProjectsCreateResult, kind: "unary", since: "1.10", errors: ["INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.projects.import_pins": { params: AppsProjectsImportPinsParams, result: AppsProjectsImportPinsResult, kind: "unary", since: "1.10", errors: ["CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "proc.list": { params: ProcListParams, result: ProcListResult, kind: "unary", since: "1.3", errors: ["INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "proc.ports": { params: ProcPortsParams, result: ProcPortsResult, kind: "unary", since: "1.3", errors: ["INVALID_PARAMS", "PERMISSION_DENIED_OS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "proc.kill": { params: ProcKillParams, result: ProcKillResult, kind: "unary", since: "1.3", errors: ["NOT_FOUND", "AUTH_FORBIDDEN", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "INTERNAL"] },
@@ -1620,6 +1758,7 @@ var OPS = {
 var EVENTS = {
   "fs.changed": FsChangedEvent,
   "apps.chats.changed": AppsChatsChangedEvent,
+  "apps.chats.watch_state": AppsChatsWatchStateEvent,
   "exec.exited": ExecExitedEvent,
   "exec.title": ExecTitleEvent,
   "exec.cwd": ExecCwdEvent,