@ai-matrx/desktop-protocol 0.17.5 → 0.17.7

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.17.7
+### (protocol 1.11)
+
+- **The rest of the coding app's tools.** New ops `apps.chats.cold` (chats waiting with a warm
+  prompt cache: when each goes cold and what waking it costs; recently cold), `apps.chats.open`
+  (show one chat in its window, never sending it anything), `apps.spend` (today / 7 days at API list
+  prices per account, model and chat; helpers running now; idle cache re-saves; helper starting
+  sizes; alarms), `apps.sync.status` / `apps.sync.run` (the chat sync's health check, and run it
+  now), `apps.windows.processes` (what must quit before an app update), `apps.windows.add` and
+  `apps.windows.save_names`. New ops only.
+
+Consumer action: none for older peers.
+
+## 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)
 

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 = 9;
+var PROTOCOL_MINOR = 11;
 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). */
@@ -1523,7 +1528,9 @@ var AppsChatsListResult = import_zod24.z.strictObject({
   /** 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()
+  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 });
@@ -1577,6 +1584,186 @@ 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) });
+var ColdChat = import_zod25.z.strictObject({
+  id: ChatId,
+  title: import_zod25.z.string().max(1e3),
+  repo: import_zod25.z.string().max(200).nullable(),
+  window: import_zod25.z.string().max(64).nullable(),
+  account: import_zod25.z.string().max(320).nullable(),
+  model_name: import_zod25.z.string().max(120).nullable(),
+  context_tokens: nonNegInt,
+  cold_at_ms: epochMs,
+  /** Waking it once the cache is cold. */
+  cold_cost: import_zod25.z.number().nullable(),
+  /** Waking it while the cache is warm. */
+  warm_cost: import_zod25.z.number().nullable(),
+  /** Its account is on extra usage (a 5-minute cache, and real money). */
+  extra_usage: import_zod25.z.boolean(),
+  /** A scheduled routine's run. */
+  scheduled: import_zod25.z.boolean(),
+  /** It can be shown in its window (started in the desktop app). */
+  openable: import_zod25.z.boolean(),
+  /** How its window was decided, or why it can't be opened. */
+  how: import_zod25.z.string().max(200).nullable()
+});
+var AppsChatsColdParams = import_zod25.z.strictObject({ app_key: AppKey });
+var AppsChatsColdResult = import_zod25.z.strictObject({
+  app_key: AppKey,
+  /** Waiting for the person with a warm cache, most urgent first. */
+  waiting: import_zod25.z.array(ColdChat).max(2e3),
+  /** Went cold in the last while. */
+  recently_cold: import_zod25.z.array(ColdChat).max(2e3),
+  /** Chats working right now (not waiting). */
+  working: nonNegInt
+});
+var AppsChatsOpenParams = import_zod25.z.strictObject({ app_key: AppKey, chat_id: ChatId, window: ChatPlace.optional() });
+var SpendSplit = import_zod25.z.strictObject({ main: import_zod25.z.number(), helpers: import_zod25.z.number() });
+var SpendScopes = import_zod25.z.strictObject({ today: SpendSplit, week: SpendSplit });
+var SpendAccount = import_zod25.z.strictObject({
+  account: import_zod25.z.string().max(320),
+  spend: SpendScopes,
+  last_hour: import_zod25.z.number().nullable(),
+  last_5h: import_zod25.z.number().nullable(),
+  five_hour: import_zod25.z.number().nullable(),
+  weekly: import_zod25.z.number().nullable(),
+  as_of_ms: epochMs.nullable(),
+  weekly_resets_at_ms: epochMs.nullable(),
+  /** When the 5-hour or weekly limit is projected to be reached at the current burn. */
+  five_hour_full_at_ms: epochMs.nullable(),
+  weekly_full_at_ms: epochMs.nullable(),
+  /** The reading is too old to project. */
+  stale: import_zod25.z.boolean()
+});
+var SpendModel = import_zod25.z.strictObject({ model: import_zod25.z.string().max(120), name: import_zod25.z.string().max(120), spend: SpendScopes });
+var SpendChat = import_zod25.z.strictObject({
+  id: ChatId,
+  title: import_zod25.z.string().max(1e3),
+  repo: import_zod25.z.string().max(200).nullable(),
+  window: import_zod25.z.string().max(64).nullable(),
+  spend: SpendScopes,
+  helpers: nonNegInt
+});
+var SpendHelper = import_zod25.z.strictObject({ model: import_zod25.z.string().max(120), steps: nonNegInt, over_steps: import_zod25.z.boolean(), description: import_zod25.z.string().max(400) });
+var SpendLive = import_zod25.z.strictObject({ id: ChatId, title: import_zod25.z.string().max(1e3), window: import_zod25.z.string().max(64).nullable(), helpers: import_zod25.z.array(SpendHelper).max(200) });
+var SpendIdleScope = import_zod25.z.strictObject({ count: nonNegInt, tokens: nonNegInt, cost: import_zod25.z.number(), avoidable: import_zod25.z.number() });
+var SpendIdle = import_zod25.z.strictObject({ id: ChatId, chat: import_zod25.z.string().max(1e3), who: import_zod25.z.string().max(400), today: SpendIdleScope, week: SpendIdleScope, last_ms: epochMs });
+var SpendStart = import_zod25.z.strictObject({ repo: import_zod25.z.string().max(200), count: nonNegInt, median: nonNegInt, latest: import_zod25.z.array(nonNegInt).max(20), alarm: import_zod25.z.string().max(400).nullable() });
+var AppsSpendParams = import_zod25.z.strictObject({ app_key: AppKey });
+var AppsSpendResult = import_zod25.z.strictObject({
+  app_key: AppKey,
+  /** False while older chats are still being read. */
+  complete: import_zod25.z.boolean(),
+  today_total: import_zod25.z.number(),
+  week_total: import_zod25.z.number(),
+  idle_today: import_zod25.z.number(),
+  idle_week: import_zod25.z.number(),
+  /** Models with no known list price. */
+  unpriced: import_zod25.z.array(import_zod25.z.string().max(120)).max(100),
+  /** Helpers past their step budget, unusual starting sizes. */
+  alarms: import_zod25.z.array(import_zod25.z.string().max(400)).max(200),
+  live: import_zod25.z.array(SpendLive).max(200),
+  accounts: import_zod25.z.array(SpendAccount).max(200),
+  models: import_zod25.z.array(SpendModel).max(100),
+  chats: import_zod25.z.array(SpendChat).max(500),
+  idle: import_zod25.z.array(SpendIdle).max(500),
+  starts: import_zod25.z.array(SpendStart).max(200)
+});
+var AppsSyncStatusParams = import_zod25.z.strictObject({ app_key: AppKey });
+var AppsSyncStatusResult = import_zod25.z.strictObject({
+  healthy: import_zod25.z.boolean(),
+  summary: import_zod25.z.string().max(400),
+  problems: import_zod25.z.array(import_zod25.z.string().max(400)).max(200),
+  warnings: import_zod25.z.array(import_zod25.z.string().max(400)).max(200),
+  /** Accounts seen with no saved name yet (Save account names fixes them). */
+  unnamed_accounts: import_zod25.z.array(import_zod25.z.string().max(80)).max(200),
+  /** The full report. */
+  output: import_zod25.z.string().max(2e5)
+});
+var AppsSyncRunParams = import_zod25.z.strictObject({ app_key: AppKey });
+var AppsWindowsProcessesParams = import_zod25.z.strictObject({ app_key: AppKey });
+var AppsWindowsProcessesResult = import_zod25.z.strictObject({ processes: import_zod25.z.array(import_zod25.z.string().max(2e3)).max(2e3) });
+var AppsWindowsAddParams = import_zod25.z.strictObject({ app_key: AppKey, window: ChatPlace, email: import_zod25.z.string().min(3).max(320) });
+var AppsWindowsSaveNamesParams = import_zod25.z.strictObject({ app_key: AppKey });
+
 // src/schema/registry.ts
 var FS_ERR = ["NOT_FOUND", "PERMISSION_DENIED_OS", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"];
 var OPS = {
@@ -1623,6 +1810,26 @@ var OPS = {
   "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"] },
+  // 1.11: Going cold, Spend, sync health, windows upkeep.
+  "apps.chats.cold": { params: AppsChatsColdParams, result: AppsChatsColdResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.chats.open": { params: AppsChatsOpenParams, result: AppsWindowActionResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "CONFLICT", "TIMEOUT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.spend": { params: AppsSpendParams, result: AppsSpendResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.sync.status": { params: AppsSyncStatusParams, result: AppsSyncStatusResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.sync.run": { params: AppsSyncRunParams, result: AppsWindowActionResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.windows.processes": { params: AppsWindowsProcessesParams, result: AppsWindowsProcessesResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.windows.add": { params: AppsWindowsAddParams, result: AppsWindowActionResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.windows.save_names": { params: AppsWindowsSaveNamesParams, result: AppsWindowActionResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "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"] },