@ai-matrx/desktop-protocol 0.21.73 → 0.21.74

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # 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
 
@@ -224,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-MK77KDKS.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 = 72;
+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_-]+$/);
@@ -1476,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,
@@ -1934,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. */
@@ -1963,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({
@@ -1997,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";
@@ -4673,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"] },
@@ -4969,6 +5038,16 @@ var NAMED_SCHEMAS = {
   AppsInstancesListResult,
   AppsAccountsListParams,
   AppsAccountsListResult,
+  AccountReadSource,
+  AccountProfile,
+  McpTransport,
+  McpServerRow,
+  SetupFact,
+  SetupItemKind,
+  SetupItem,
+  AppSetup,
+  AppsSetupListParams,
+  AppsSetupListResult,
   ProtocolVersion,
   RequestId,
   ResourceId,
@@ -5799,7 +5878,8 @@ var FIELDS_SINCE = {
   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", pin_sync: "1.72" },
-  AccountUsage: { plan: "1.13", credits: "1.13", five_hour_resets_by_ms: "1.25" },
+  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" },
@@ -6465,6 +6545,8 @@ export {
   ElsewhereInstance,
   AccountResetSource,
   AccountGap,
+  AccountReadSource,
+  AccountProfile,
   AppAccount,
   AppsInstancesListParams,
   AppsInstancesListResult,
@@ -6476,6 +6558,14 @@ export {
   ProbeSource,
   AppsChatsProbeParams,
   AppsChatsProbeResult,
+  McpTransport,
+  McpServerRow,
+  SetupFact,
+  SetupItemKind,
+  SetupItem,
+  AppSetup,
+  AppsSetupListParams,
+  AppsSetupListResult,
   SERVICE_MAX_FRAME_BYTES,
   ServiceName,
   ContractHash,
@@ -6984,4 +7074,4 @@ export {
   closeRule,
   isTerminalClose
 };
-//# sourceMappingURL=chunk-server-MK77KDKS.js.map
+//# sourceMappingURL=chunk-server-3L5JNEHY.js.map