@ai-matrx/desktop-protocol 0.17.6 → 0.17.8

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## 0.17.8
+### (protocol 1.12)
+
+- `apps.accounts.usage` and `apps.accounts.resets` gain optional `problem` (the rows are right, something around them failed, e.g. a newly read reset time could not be saved), stripped for peers below 1.12 (guard: versioning.test.ts "apps accounts 1.12").
+
+Consumer action: none for older peers.
+
+## 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)
 

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 = 10;
+var PROTOCOL_MINOR = 12;
 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_-]+$/);
@@ -1643,9 +1643,19 @@ var AccountReset = import_zod25.z.strictObject({
 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 AppsAccountsUsageResult = import_zod25.z.strictObject({
+  app_key: AppKey,
+  accounts: import_zod25.z.array(AccountUsage).max(500),
+  /** 1.12: the rows are right but something around them failed (a newly read reset time could not be saved); shown, never hidden. */
+  problem: import_zod25.z.string().max(400).optional()
+});
 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 AppsAccountsResetsResult = import_zod25.z.strictObject({
+  app_key: AppKey,
+  resets: import_zod25.z.array(AccountReset).max(200),
+  /** 1.12: as on `apps.accounts.usage`. */
+  problem: import_zod25.z.string().max(400).optional()
+});
 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 });
@@ -1663,6 +1673,106 @@ var AppsProjectsCreateParams = import_zod25.z.strictObject({ app_key: AppKey, na
 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"];
@@ -1721,6 +1831,15 @@ var OPS = {
   "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"] },