@ai-matrx/desktop-protocol 0.21.72 → 0.21.74

package/dist/client.d.cts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/data/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/data/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-BSiPIgIc.cjs';
-export { i as isDesktopProtocolError } from './models-BSiPIgIc.cjs';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-BRm_O6a-.cjs';
+export { i as isDesktopProtocolError } from './models-BRm_O6a-.cjs';
 import { FrameHeader } from './frame.cjs';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/client.d.ts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/data/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/data/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-BSiPIgIc.js';
-export { i as isDesktopProtocolError } from './models-BSiPIgIc.js';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-BRm_O6a-.js';
+export { i as isDesktopProtocolError } from './models-BRm_O6a-.js';
 import { FrameHeader } from './frame.js';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/client.js

@@ -12,7 +12,7 @@ import {
   Welcome,
   closeRule,
   knows
-} from "./chunk-server-FFLYSQUY.js";
+} from "./chunk-server-3L5JNEHY.js";
 import {
   DesktopProtocolError,
   FRAME_VERSION,

package/dist/index.cjs

@@ -43,6 +43,8 @@ __export(src_exports, {
   AccountAgentsVersionsParams: () => AccountAgentsVersionsParams,
   AccountAgentsVersionsResult: () => AccountAgentsVersionsResult,
   AccountGap: () => AccountGap,
+  AccountProfile: () => AccountProfile,
+  AccountReadSource: () => AccountReadSource,
   AccountReadState: () => AccountReadState,
   AccountReset: () => AccountReset,
   AccountResetSource: () => AccountResetSource,
@@ -61,6 +63,7 @@ __export(src_exports, {
   AppProfile: () => AppProfile,
   AppProfileId: () => AppProfileId,
   AppProfileLocator: () => AppProfileLocator,
+  AppSetup: () => AppSetup,
   AppSupport: () => AppSupport,
   AppUsageReading: () => AppUsageReading,
   AppWindowInfo: () => AppWindowInfo,
@@ -70,6 +73,8 @@ __export(src_exports, {
   AppsAccountsResetsResult: () => AppsAccountsResetsResult,
   AppsAccountsUsageParams: () => AppsAccountsUsageParams,
   AppsAccountsUsageResult: () => AppsAccountsUsageResult,
+  AppsChatsBringBackParams: () => AppsChatsBringBackParams,
+  AppsChatsBringBackResult: () => AppsChatsBringBackResult,
   AppsChatsChangedEvent: () => AppsChatsChangedEvent,
   AppsChatsColdParams: () => AppsChatsColdParams,
   AppsChatsColdResult: () => AppsChatsColdResult,
@@ -86,6 +91,8 @@ __export(src_exports, {
   AppsChatsProbeResult: () => AppsChatsProbeResult,
   AppsChatsStarParams: () => AppsChatsStarParams,
   AppsChatsStarResult: () => AppsChatsStarResult,
+  AppsChatsTidyUpParams: () => AppsChatsTidyUpParams,
+  AppsChatsTidyUpResult: () => AppsChatsTidyUpResult,
   AppsChatsTitlesCheckParams: () => AppsChatsTitlesCheckParams,
   AppsChatsTitlesCheckResult: () => AppsChatsTitlesCheckResult,
   AppsChatsTitlesPushParams: () => AppsChatsTitlesPushParams,
@@ -123,6 +130,8 @@ __export(src_exports, {
   AppsProjectsUnfileResult: () => AppsProjectsUnfileResult,
   AppsProjectsUpdateParams: () => AppsProjectsUpdateParams,
   AppsProjectsUpdateResult: () => AppsProjectsUpdateResult,
+  AppsSetupListParams: () => AppsSetupListParams,
+  AppsSetupListResult: () => AppsSetupListResult,
   AppsSpendParams: () => AppsSpendParams,
   AppsSpendResult: () => AppsSpendResult,
   AppsSyncRunParams: () => AppsSyncRunParams,
@@ -527,6 +536,8 @@ __export(src_exports, {
   MailMessage: () => MailMessage,
   MailSendParams: () => MailSendParams,
   MailSendResult: () => MailSendResult,
+  McpServerRow: () => McpServerRow,
+  McpTransport: () => McpTransport,
   MessagesChat: () => MessagesChat,
   MessagesChatsParams: () => MessagesChatsParams,
   MessagesChatsResult: () => MessagesChatsResult,
@@ -737,6 +748,9 @@ __export(src_exports, {
   SessionListResult: () => SessionListResult,
   SessionReleaseParams: () => SessionReleaseParams,
   SessionReleaseResult: () => SessionReleaseResult,
+  SetupFact: () => SetupFact,
+  SetupItem: () => SetupItem,
+  SetupItemKind: () => SetupItemKind,
   Sha256Hex: () => Sha256Hex,
   ShownSection: () => ShownSection,
   Signal: () => Signal,
@@ -789,6 +803,8 @@ __export(src_exports, {
   TOOL_PLATFORMS: () => TOOL_PLATFORMS,
   TextModelId: () => TextModelId,
   TextModelInfo: () => TextModelInfo,
+  TidyUpFacet: () => TidyUpFacet,
+  TidyUpRestart: () => TidyUpRestart,
   TitleCopies: () => TitleCopies,
   TitleMismatch: () => TitleMismatch,
   ToolLevel: () => ToolLevel,
@@ -919,7 +935,7 @@ module.exports = __toCommonJS(src_exports);
 var import_zod = require("zod");
 var import_uuid = require("@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 = 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_-]+$/);
@@ -2345,6 +2361,11 @@ var ChatRow = import_zod13.z.strictObject({
   prior_sessions: import_zod13.z.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: import_zod13.z.array(ChatMove).max(50).optional(),
   /**
@@ -2511,7 +2532,9 @@ var AccountUsage = import_zod14.z.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: import_zod14.z.enum(["app", "claude_code"]).optional()
 });
 var AccountReset = import_zod14.z.strictObject({
   window: ChatPlace,
@@ -2661,6 +2684,30 @@ var AppsProjectsToWindowResult = import_zod14.z.strictObject({
   chats: import_zod14.z.array(ProjectMoveOutcome).max(5e3).optional(),
   message: import_zod14.z.string().max(400)
 });
+var AppsChatsBringBackParams = import_zod14.z.strictObject({ app_key: AppKey, chat_id: ChatId, dry_run: import_zod14.z.boolean().optional() });
+var AppsChatsBringBackResult = AppsProjectsToWindowResult.extend({ project_id: ChatProjectId.nullable() });
+var TidyUpFacet = import_zod14.z.strictObject({
+  app_key: AppKey,
+  facet: import_zod14.z.enum(["title", "pin"]),
+  state: import_zod14.z.enum(["synced", "not_synced", "unsupported"]),
+  note: import_zod14.z.string().max(400),
+  to_push: nonNegInt,
+  pushed: nonNegInt,
+  already: nonNegInt,
+  waiting: nonNegInt,
+  failed: nonNegInt
+});
+var TidyUpRestart = import_zod14.z.strictObject({ window: ChatPlace, why: import_zod14.z.string().max(400) });
+var AppsChatsTidyUpParams = import_zod14.z.strictObject({ dry_run: import_zod14.z.boolean(), restart_windows: import_zod14.z.array(ChatPlace).max(64).optional() });
+var AppsChatsTidyUpResult = import_zod14.z.strictObject({
+  dry_run: import_zod14.z.boolean(),
+  facets: import_zod14.z.array(TidyUpFacet).max(32),
+  /** Claude windows that would keep an old name until they reopen (the plan lists them; nothing is quit unasked). */
+  restart: import_zod14.z.array(TidyUpRestart).max(64),
+  /** The windows this run quit and reopened. */
+  restarted: import_zod14.z.array(ChatPlace).max(64),
+  message: import_zod14.z.string().max(600)
+});
 var ColdChat = import_zod14.z.strictObject({
   id: ChatId,
   title: import_zod14.z.string().max(1e3),
@@ -2945,6 +2992,25 @@ var ElsewhereInstance = import_zod15.z.strictObject({
 });
 var AccountResetSource = import_zod15.z.enum(["app", "usage_history", "your_list"]);
 var AccountGap = import_zod15.z.enum(["email", "plan", "usage"]);
+var AccountReadSource = import_zod15.z.enum(["app", "claude_code"]);
+var AccountProfile = import_zod15.z.strictObject({
+  /** The person's name on the account. */
+  name: import_zod15.z.string().max(200).nullable(),
+  /** The organization the sign-in is in, and the person's role there. */
+  org_name: import_zod15.z.string().max(200).nullable(),
+  org_role: import_zod15.z.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: import_zod15.z.string().max(80).nullable(),
+  rate_limit_tier: import_zod15.z.string().max(120).nullable(),
+  billing: import_zod15.z.string().max(80).nullable(),
+  trial_ends_ms: epochMs.nullable(),
+  /** Cursor: whether the subscription is active ("active", "canceled", …) as Cursor records it. */
+  subscription: import_zod15.z.string().max(80).nullable(),
+  /** Where these facts were read (a short label: "Claude Code's sign-in"). */
+  source: import_zod15.z.string().max(200),
+  /** When the app last fetched them, when it says. */
+  as_of_ms: epochMs.nullable()
+});
 var AppAccount = import_zod15.z.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. */
@@ -2974,7 +3040,13 @@ var AppAccount = import_zod15.z.strictObject({
   instances: import_zod15.z.array(ChatPlace).max(200),
   first_seen_ms: epochMs.nullable(),
   last_seen_ms: epochMs.nullable(),
-  missing: import_zod15.z.array(AccountGap).max(3)
+  missing: import_zod15.z.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: import_zod15.z.number().nonnegative().optional()
 });
 var AppsInstancesListParams = import_zod15.z.strictObject({ app_key: AppKey, fresh: import_zod15.z.boolean().optional() });
 var AppsInstancesListResult = import_zod15.z.strictObject({
@@ -3008,6 +3080,47 @@ var ProbeFact = import_zod15.z.strictObject({ key: import_zod15.z.string().max(2
 var ProbeSource = import_zod15.z.strictObject({ source: import_zod15.z.string().max(120), instance: import_zod15.z.string().max(64).nullable(), facts: import_zod15.z.array(ProbeFact).max(500) });
 var AppsChatsProbeParams = import_zod15.z.strictObject({ app_key: AppKey, chat_id: import_zod15.z.string().regex(/^[A-Za-z0-9][A-Za-z0-9._-]{0,127}$/) });
 var AppsChatsProbeResult = import_zod15.z.strictObject({ app_key: AppKey, chat_id: import_zod15.z.string().max(128), sources: import_zod15.z.array(ProbeSource).max(200) });
+var McpTransport = import_zod15.z.enum(["stdio", "http", "sse", "unknown"]);
+var McpServerRow = import_zod15.z.strictObject({
+  app_key: AppKey,
+  /** The app's instance whose settings hold it ("main", a home's name). */
+  instance: import_zod15.z.string().max(120),
+  name: import_zod15.z.string().max(200),
+  transport: McpTransport,
+  /** The URL (scheme, host and path only) or the command and its arguments (secret-looking ones blanked). */
+  target: import_zod15.z.string().max(400).nullable(),
+  /** "user" (every folder), "desktop" (the desktop app), or the folder it is set up for. */
+  scope: import_zod15.z.string().max(400),
+  /** Turned on or off in the app, when it records it. */
+  enabled: import_zod15.z.boolean().nullable(),
+  /** The settings file it was read from. */
+  where: import_zod15.z.string().max(400)
+});
+var SetupFact = import_zod15.z.strictObject({ name: import_zod15.z.string().max(80), value: import_zod15.z.string().max(300) });
+var SetupItemKind = import_zod15.z.enum(["extension", "plugin", "marketplace", "model"]);
+var SetupItem = import_zod15.z.strictObject({
+  kind: SetupItemKind,
+  name: import_zod15.z.string().max(200),
+  version: import_zod15.z.string().max(80).nullable(),
+  /** Turned on or off, when the app records it. */
+  enabled: import_zod15.z.boolean().nullable()
+});
+var AppSetup = import_zod15.z.strictObject({
+  app_key: AppKey,
+  instance: import_zod15.z.string().max(120),
+  /** The folder its settings were read from. */
+  where: import_zod15.z.string().max(400),
+  facts: import_zod15.z.array(SetupFact).max(60),
+  items: import_zod15.z.array(SetupItem).max(2e3),
+  /** What could not be read there (shown, never hidden). */
+  problems: import_zod15.z.array(import_zod15.z.string().max(300)).max(20)
+});
+var AppsSetupListParams = import_zod15.z.strictObject({ app_key: AppKey.optional() });
+var AppsSetupListResult = import_zod15.z.strictObject({
+  setups: import_zod15.z.array(AppSetup).max(200),
+  mcp: import_zod15.z.array(McpServerRow).max(2e3),
+  problem: import_zod15.z.string().max(400).optional()
+});
 
 // src/schema/service.ts
 var import_zod16 = require("zod");
@@ -5684,6 +5797,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"] },
@@ -5699,6 +5813,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"] },
@@ -5978,6 +6094,16 @@ var NAMED_SCHEMAS = {
   AppsInstancesListResult,
   AppsAccountsListParams,
   AppsAccountsListResult,
+  AccountReadSource,
+  AccountProfile,
+  McpTransport,
+  McpServerRow,
+  SetupFact,
+  SetupItemKind,
+  SetupItem,
+  AppSetup,
+  AppsSetupListParams,
+  AppsSetupListResult,
   ProtocolVersion,
   RequestId,
   ResourceId,
@@ -6482,6 +6608,12 @@ var NAMED_SCHEMAS = {
   AppsChatsTitlesCheckResult,
   AppsChatsTitlesPushParams,
   AppsChatsTitlesPushResult,
+  AppsChatsBringBackParams,
+  AppsChatsBringBackResult,
+  AppsChatsTidyUpParams,
+  AppsChatsTidyUpResult,
+  TidyUpFacet,
+  TidyUpRestart,
   SpendSplit,
   SpendScopes,
   SpendAccount,
@@ -6801,8 +6933,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" },
@@ -7093,7 +7226,7 @@ function forPeer(op, part, value, version) {
 var VERSIONED_RESULT_OPS = [.../* @__PURE__ */ new Set([...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys(), ...NESTED_RESULTS.keys()])];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "d7962e1bed0f5ee4ffc1ccdf8b6c3694cfdced1904cc6b8c819f366e19af0ffe";
+var CONTRACT_SHA256 = "04ac1530a836288982a2d3bf35d5b7c6b0413cdf51fa1fb5bfd4de7cbe32adf8";
 
 // src/close-policy.ts
 var CLOSE_RULES = {