@ai-matrx/desktop-protocol 0.21.72 → 0.21.74

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.21.74
+
+UNVERIFIED: this release has no Unreleased entry and the source comparison could not be made (the caller supplied no source comparison). Whether source changed is unknown; consumer action is unknown.
+Check the package's gitHead on npm against this version's gitHead: `git diff <previous gitHead> <this gitHead> -- apps/shared/desktop-protocol/src`.
+
+## 0.21.73
+### Protocol 1.72 — ours pushed into the apps
+
+- `ChatRow`: optional `pin_sync` (a `ChatTitleSync`): whether our star is the app's pin for this chat;
+  `synced` only where a test proved the app takes and keeps the pin Matrx writes.
+- New op `apps.chats.bring_back` (`app_key`, `chat_id`, `dry_run?`): one chat home from its move
+  records, never a project; answers the to-window result with `project_id` null.
+- New op `apps.chats.tidy_up` (`dry_run`, `restart_windows?`): pushes ours (titles, pins) into every
+  app whose facet can take it; answers per app and facet (`TidyUpFacet`), the Claude windows that
+  would keep an old name until reopened (`restart`, `TidyUpRestart`) and those it reopened.
+- Optional field in FIELDS_SINCE, new ops since 1.72. Consumer action: none for an older client.
+
 ## 0.21.72
 ### Protocol 1.71 — coding-app accounts and instances in the database
 
@@ -19,6 +36,15 @@
   hidden state the call changed.
 - Optional field in FIELDS_SINCE, new op since 1.70. Consumer action: none for an older client.
 
+## 0.21.71
+### Protocol 1.70 — our Hide for chats
+
+- `ChatRow`: optional `hidden` — the person hid the chat from Matrx's lists. Kept by Matrx, never
+  written into the app; the app's own hidden facts stay `hidden_in`, `archived`, `hidden_from_main`.
+- New op `apps.chats.hide` (`app_key`, `chat_ids` 1–500, `hidden`) answers `changed`: the chats whose
+  hidden state the call changed.
+- Optional field in FIELDS_SINCE, new op since 1.70. Consumer action: none for an older client.
+
 ## 0.21.70
 ### Protocol 1.69 — every local language model is listed, with why one cannot run
 
@@ -203,6 +229,17 @@ Changed shipped source files (2):
 
 ## 0.21.52
 ### Unreleased
+### Protocol 1.73 — what each coding app keeps besides chats
+
+- `AppAccount`: optional `profile` (`AccountProfile`: name, organization and role, seat and
+  rate-limit tiers, billing, trial end, Cursor's subscription status, where read and when), optional
+  `read_source` (`AccountReadSource`: `app` or `claude_code`, Claude Code's live-usage file read with
+  no network) and `session_cost_usd`. `AccountUsage`: optional `read_source`.
+- New op `apps.setup.list` (`app_key?`): each app instance's settings (`SetupFact`), models,
+  plugins, marketplaces and extensions (`SetupItem`), and every MCP server (`McpServerRow`: name,
+  transport, URL or command, scope, on/off, file) — allow-listed fields only, never env or headers.
+- Optional fields in FIELDS_SINCE, a new op since 1.73. Consumer action: none for an older client.
+
 ### Protocol 1.57 — the account a coding record belongs to, and each sign-in's usage
 
 - `accountId` (optional) on `CodingSessionRecord`, `CodingDiscoveredChat`, `CodingRecentRow` and

package/dist/{chunk-server-FFLYSQUY.js → chunk-server-3L5JNEHY.js}

@@ -6,7 +6,7 @@ import {
 import { z } from "zod";
 import { UUID_SHAPE_PATTERN } from "@ai-matrx/kit/uuid";
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 71;
+var PROTOCOL_MINOR = 73;
 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_-]+$/);
@@ -1305,6 +1305,11 @@ var ChatRow = z13.strictObject({
   prior_sessions: z13.array(ChatId).max(50).optional(),
   /** 1.61: where the title shows (the title facet's sync state for this chat's app). */
   title_sync: ChatTitleSync.optional(),
+  /**
+   * 1.72: whether our star is the app's pin for this chat (the pin facet's sync state: `synced` only
+   * where a test proved the app takes and keeps the pin Matrx writes; `not_synced` says why).
+   */
+  pin_sync: ChatTitleSync.optional(),
   /** 1.62: every Move and Copy of this chat between instances, newest first (absent = never moved or copied). */
   moved: z13.array(ChatMove).max(50).optional(),
   /**
@@ -1471,7 +1476,9 @@ var AccountUsage = z14.strictObject({
    * window's use (its usage history), so the real reset is at or before it. Absent when no 5-hour
    * window is running (no use in the last reading, or the reading is over 5 hours old).
    */
-  five_hour_resets_by_ms: epochMs.optional()
+  five_hour_resets_by_ms: epochMs.optional(),
+  /** 1.73: where the reading came from (absent = the app itself). */
+  read_source: z14.enum(["app", "claude_code"]).optional()
 });
 var AccountReset = z14.strictObject({
   window: ChatPlace,
@@ -1621,6 +1628,30 @@ var AppsProjectsToWindowResult = z14.strictObject({
   chats: z14.array(ProjectMoveOutcome).max(5e3).optional(),
   message: z14.string().max(400)
 });
+var AppsChatsBringBackParams = z14.strictObject({ app_key: AppKey, chat_id: ChatId, dry_run: z14.boolean().optional() });
+var AppsChatsBringBackResult = AppsProjectsToWindowResult.extend({ project_id: ChatProjectId.nullable() });
+var TidyUpFacet = z14.strictObject({
+  app_key: AppKey,
+  facet: z14.enum(["title", "pin"]),
+  state: z14.enum(["synced", "not_synced", "unsupported"]),
+  note: z14.string().max(400),
+  to_push: nonNegInt,
+  pushed: nonNegInt,
+  already: nonNegInt,
+  waiting: nonNegInt,
+  failed: nonNegInt
+});
+var TidyUpRestart = z14.strictObject({ window: ChatPlace, why: z14.string().max(400) });
+var AppsChatsTidyUpParams = z14.strictObject({ dry_run: z14.boolean(), restart_windows: z14.array(ChatPlace).max(64).optional() });
+var AppsChatsTidyUpResult = z14.strictObject({
+  dry_run: z14.boolean(),
+  facets: z14.array(TidyUpFacet).max(32),
+  /** Claude windows that would keep an old name until they reopen (the plan lists them; nothing is quit unasked). */
+  restart: z14.array(TidyUpRestart).max(64),
+  /** The windows this run quit and reopened. */
+  restarted: z14.array(ChatPlace).max(64),
+  message: z14.string().max(600)
+});
 var ColdChat = z14.strictObject({
   id: ChatId,
   title: z14.string().max(1e3),
@@ -1905,6 +1936,25 @@ var ElsewhereInstance = z15.strictObject({
 });
 var AccountResetSource = z15.enum(["app", "usage_history", "your_list"]);
 var AccountGap = z15.enum(["email", "plan", "usage"]);
+var AccountReadSource = z15.enum(["app", "claude_code"]);
+var AccountProfile = z15.strictObject({
+  /** The person's name on the account. */
+  name: z15.string().max(200).nullable(),
+  /** The organization the sign-in is in, and the person's role there. */
+  org_name: z15.string().max(200).nullable(),
+  org_role: z15.string().max(80).nullable(),
+  /** Claude: the seat tier of a team plan, the rate-limit tier, how it is billed, when a trial ends. */
+  seat_tier: z15.string().max(80).nullable(),
+  rate_limit_tier: z15.string().max(120).nullable(),
+  billing: z15.string().max(80).nullable(),
+  trial_ends_ms: epochMs.nullable(),
+  /** Cursor: whether the subscription is active ("active", "canceled", …) as Cursor records it. */
+  subscription: z15.string().max(80).nullable(),
+  /** Where these facts were read (a short label: "Claude Code's sign-in"). */
+  source: z15.string().max(200),
+  /** When the app last fetched them, when it says. */
+  as_of_ms: epochMs.nullable()
+});
 var AppAccount = z15.strictObject({
   app_key: AppKey,
   /** The provider's own account id (Claude's account uuid, ChatGPT's account id); `org:<uuid>` when only its organization is known. */
@@ -1934,7 +1984,13 @@ var AppAccount = z15.strictObject({
   instances: z15.array(ChatPlace).max(200),
   first_seen_ms: epochMs.nullable(),
   last_seen_ms: epochMs.nullable(),
-  missing: z15.array(AccountGap).max(3)
+  missing: z15.array(AccountGap).max(3),
+  /** 1.73: who the account is beyond its email (plan details, role, tiers), when the app records it. */
+  profile: AccountProfile.optional(),
+  /** 1.73: where the newest reading came from (absent = the app itself). */
+  read_source: AccountReadSource.optional(),
+  /** 1.73: Claude Code: the running session's cost as Claude Code estimates it (US dollars), with a Claude Code reading. */
+  session_cost_usd: z15.number().nonnegative().optional()
 });
 var AppsInstancesListParams = z15.strictObject({ app_key: AppKey, fresh: z15.boolean().optional() });
 var AppsInstancesListResult = z15.strictObject({
@@ -1968,6 +2024,47 @@ var ProbeFact = z15.strictObject({ key: z15.string().max(200), value: z15.string
 var ProbeSource = z15.strictObject({ source: z15.string().max(120), instance: z15.string().max(64).nullable(), facts: z15.array(ProbeFact).max(500) });
 var AppsChatsProbeParams = z15.strictObject({ app_key: AppKey, chat_id: z15.string().regex(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/) });
 var AppsChatsProbeResult = z15.strictObject({ app_key: AppKey, chat_id: z15.string().max(128), sources: z15.array(ProbeSource).max(200) });
+var McpTransport = z15.enum(["stdio", "http", "sse", "unknown"]);
+var McpServerRow = z15.strictObject({
+  app_key: AppKey,
+  /** The app's instance whose settings hold it ("main", a home's name). */
+  instance: z15.string().max(120),
+  name: z15.string().max(200),
+  transport: McpTransport,
+  /** The URL (scheme, host and path only) or the command and its arguments (secret-looking ones blanked). */
+  target: z15.string().max(400).nullable(),
+  /** "user" (every folder), "desktop" (the desktop app), or the folder it is set up for. */
+  scope: z15.string().max(400),
+  /** Turned on or off in the app, when it records it. */
+  enabled: z15.boolean().nullable(),
+  /** The settings file it was read from. */
+  where: z15.string().max(400)
+});
+var SetupFact = z15.strictObject({ name: z15.string().max(80), value: z15.string().max(300) });
+var SetupItemKind = z15.enum(["extension", "plugin", "marketplace", "model"]);
+var SetupItem = z15.strictObject({
+  kind: SetupItemKind,
+  name: z15.string().max(200),
+  version: z15.string().max(80).nullable(),
+  /** Turned on or off, when the app records it. */
+  enabled: z15.boolean().nullable()
+});
+var AppSetup = z15.strictObject({
+  app_key: AppKey,
+  instance: z15.string().max(120),
+  /** The folder its settings were read from. */
+  where: z15.string().max(400),
+  facts: z15.array(SetupFact).max(60),
+  items: z15.array(SetupItem).max(2e3),
+  /** What could not be read there (shown, never hidden). */
+  problems: z15.array(z15.string().max(300)).max(20)
+});
+var AppsSetupListParams = z15.strictObject({ app_key: AppKey.optional() });
+var AppsSetupListResult = z15.strictObject({
+  setups: z15.array(AppSetup).max(200),
+  mcp: z15.array(McpServerRow).max(2e3),
+  problem: z15.string().max(400).optional()
+});
 
 // src/schema/service.ts
 import { z as z16 } from "zod";
@@ -4644,6 +4741,7 @@ var OPS = {
   // 1.47: instances and accounts kept apart — an account's usage is the account's, every instance shows it by id.
   "apps.instances.list": { params: AppsInstancesListParams, result: AppsInstancesListResult, kind: "unary", since: "1.47", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.accounts.list": { params: AppsAccountsListParams, result: AppsAccountsListResult, kind: "unary", since: "1.47", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.setup.list": { params: AppsSetupListParams, result: AppsSetupListResult, kind: "unary", since: "1.73", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   // 1.56: an instance's kept-for account and forgetting it (the app's own tool writes both); every raw fact about one chat.
   "apps.windows.set_account": { params: AppsWindowsSetAccountParams, result: AppsWindowActionResult, kind: "unary", since: "1.56", errors: ["NOT_FOUND", "INVALID_PARAMS", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.windows.forget": { params: AppsWindowsForgetParams, result: AppsWindowActionResult, kind: "unary", since: "1.56", errors: ["NOT_FOUND", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
@@ -4659,6 +4757,8 @@ var OPS = {
   "apps.chats.open": { params: AppsChatsOpenParams, result: AppsWindowActionResult, kind: "unary", since: "1.11", errors: ["NOT_FOUND", "CONFLICT", "TIMEOUT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.chats.titles_check": { params: AppsChatsTitlesCheckParams, result: AppsChatsTitlesCheckResult, kind: "unary", since: "1.29", errors: ["NOT_FOUND", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "apps.chats.titles_push": { params: AppsChatsTitlesPushParams, result: AppsChatsTitlesPushResult, kind: "unary", since: "1.29", errors: ["NOT_FOUND", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.chats.bring_back": { params: AppsChatsBringBackParams, result: AppsChatsBringBackResult, kind: "unary", since: "1.72", errors: ["NOT_FOUND", "INVALID_PARAMS", "CONFLICT", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
+  "apps.chats.tidy_up": { params: AppsChatsTidyUpParams, result: AppsChatsTidyUpResult, kind: "unary", since: "1.72", errors: ["INVALID_PARAMS", "NOT_FOUND", "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"] },
@@ -4938,6 +5038,16 @@ var NAMED_SCHEMAS = {
   AppsInstancesListResult,
   AppsAccountsListParams,
   AppsAccountsListResult,
+  AccountReadSource,
+  AccountProfile,
+  McpTransport,
+  McpServerRow,
+  SetupFact,
+  SetupItemKind,
+  SetupItem,
+  AppSetup,
+  AppsSetupListParams,
+  AppsSetupListResult,
   ProtocolVersion,
   RequestId,
   ResourceId,
@@ -5442,6 +5552,12 @@ var NAMED_SCHEMAS = {
   AppsChatsTitlesCheckResult,
   AppsChatsTitlesPushParams,
   AppsChatsTitlesPushResult,
+  AppsChatsBringBackParams,
+  AppsChatsBringBackResult,
+  AppsChatsTidyUpParams,
+  AppsChatsTidyUpResult,
+  TidyUpFacet,
+  TidyUpRestart,
   SpendSplit,
   SpendScopes,
   SpendAccount,
@@ -5761,8 +5877,9 @@ var FIELDS_SINCE = {
   AppsChatsListResult: { updating: "1.9", live: "1.9", families: "1.10" },
   AppsAccountsUsageResult: { problem: "1.12" },
   AppsAccountsResetsResult: { problem: "1.12" },
-  ChatRow: { app_project: "1.13", tokens: "1.13", original_title: "1.14", title_source: "1.14", title_override: "1.14", archived: "1.15", session_id: "1.59", app_groups: "1.59", parent: "1.59", prior_sessions: "1.59", title_sync: "1.61", moved: "1.62", home: "1.63", hidden: "1.70" },
-  AccountUsage: { plan: "1.13", credits: "1.13", five_hour_resets_by_ms: "1.25" },
+  ChatRow: { app_project: "1.13", tokens: "1.13", original_title: "1.14", title_source: "1.14", title_override: "1.14", archived: "1.15", session_id: "1.59", app_groups: "1.59", parent: "1.59", prior_sessions: "1.59", title_sync: "1.61", moved: "1.62", home: "1.63", hidden: "1.70", pin_sync: "1.72" },
+  AccountUsage: { plan: "1.13", credits: "1.13", five_hour_resets_by_ms: "1.25", read_source: "1.73" },
+  AppAccount: { profile: "1.73", read_source: "1.73", session_cost_usd: "1.73" },
   ResourcesDisk: { name: "1.17" },
   StackServer: { cpu_percent: "1.18", memory_bytes: "1.18" },
   AudioDevice: { kind: "1.24" },
@@ -6373,6 +6490,12 @@ export {
   ProjectMovePin,
   AppsProjectsToWindowParams,
   AppsProjectsToWindowResult,
+  AppsChatsBringBackParams,
+  AppsChatsBringBackResult,
+  TidyUpFacet,
+  TidyUpRestart,
+  AppsChatsTidyUpParams,
+  AppsChatsTidyUpResult,
   ColdChat,
   AppsChatsColdParams,
   AppsChatsColdResult,
@@ -6422,6 +6545,8 @@ export {
   ElsewhereInstance,
   AccountResetSource,
   AccountGap,
+  AccountReadSource,
+  AccountProfile,
   AppAccount,
   AppsInstancesListParams,
   AppsInstancesListResult,
@@ -6433,6 +6558,14 @@ export {
   ProbeSource,
   AppsChatsProbeParams,
   AppsChatsProbeResult,
+  McpTransport,
+  McpServerRow,
+  SetupFact,
+  SetupItemKind,
+  SetupItem,
+  AppSetup,
+  AppsSetupListParams,
+  AppsSetupListResult,
   SERVICE_MAX_FRAME_BYTES,
   ServiceName,
   ContractHash,
@@ -6941,4 +7074,4 @@ export {
   closeRule,
   isTerminalClose
 };
-//# sourceMappingURL=chunk-server-FFLYSQUY.js.map
+//# sourceMappingURL=chunk-server-3L5JNEHY.js.map