@ai-matrx/desktop-protocol 0.21.73 → 0.21.75

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-ClCrYsEt.cjs';
-export { i as isDesktopProtocolError } from './models-ClCrYsEt.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-GpUhHLRw.cjs';
+export { i as isDesktopProtocolError } from './models-GpUhHLRw.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-ClCrYsEt.js';
-export { i as isDesktopProtocolError } from './models-ClCrYsEt.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-GpUhHLRw.js';
+export { i as isDesktopProtocolError } from './models-GpUhHLRw.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-MK77KDKS.js";
+} from "./chunk-server-FBLTGJJA.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,
@@ -127,6 +130,8 @@ __export(src_exports, {
   AppsProjectsUnfileResult: () => AppsProjectsUnfileResult,
   AppsProjectsUpdateParams: () => AppsProjectsUpdateParams,
   AppsProjectsUpdateResult: () => AppsProjectsUpdateResult,
+  AppsSetupListParams: () => AppsSetupListParams,
+  AppsSetupListResult: () => AppsSetupListResult,
   AppsSpendParams: () => AppsSpendParams,
   AppsSpendResult: () => AppsSpendResult,
   AppsSyncRunParams: () => AppsSyncRunParams,
@@ -520,6 +525,8 @@ __export(src_exports, {
   LlamaServerBuild: () => LlamaServerBuild,
   LlmRunning: () => LlmRunning,
   LlmServerState: () => LlmServerState,
+  LocalModelKind: () => LocalModelKind,
+  LocalModelRow: () => LocalModelRow,
   LocationGetParams: () => LocationGetParams,
   LocationGetResult: () => LocationGetResult,
   MATRX_EXTENSION_IDS: () => MATRX_EXTENSION_IDS,
@@ -531,6 +538,8 @@ __export(src_exports, {
   MailMessage: () => MailMessage,
   MailSendParams: () => MailSendParams,
   MailSendResult: () => MailSendResult,
+  McpServerRow: () => McpServerRow,
+  McpTransport: () => McpTransport,
   MessagesChat: () => MessagesChat,
   MessagesChatsParams: () => MessagesChatsParams,
   MessagesChatsResult: () => MessagesChatsResult,
@@ -564,6 +573,10 @@ __export(src_exports, {
   ModelsLlmStatusResult: () => ModelsLlmStatusResult,
   ModelsLlmStopParams: () => ModelsLlmStopParams,
   ModelsLlmStopResult: () => ModelsLlmStopResult,
+  ModelsLocalListParams: () => ModelsLocalListParams,
+  ModelsLocalListResult: () => ModelsLocalListResult,
+  ModelsLocalRemoveParams: () => ModelsLocalRemoveParams,
+  ModelsLocalRemoveResult: () => ModelsLocalRemoveResult,
   ModelsProgressEvent: () => ModelsProgressEvent,
   ModelsStatusParams: () => ModelsStatusParams,
   ModelsStatusResult: () => ModelsStatusResult,
@@ -741,6 +754,9 @@ __export(src_exports, {
   SessionListResult: () => SessionListResult,
   SessionReleaseParams: () => SessionReleaseParams,
   SessionReleaseResult: () => SessionReleaseResult,
+  SetupFact: () => SetupFact,
+  SetupItem: () => SetupItem,
+  SetupItemKind: () => SetupItemKind,
   Sha256Hex: () => Sha256Hex,
   ShownSection: () => ShownSection,
   Signal: () => Signal,
@@ -925,7 +941,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 = 72;
+var PROTOCOL_MINOR = 74;
 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_-]+$/);
@@ -1940,6 +1956,36 @@ var ModelsDownloadsListParams = import_zod10.z.strictObject({});
 var ModelsDownloadsListResult = import_zod10.z.strictObject({ downloads: import_zod10.z.array(DownloadRow).max(64) });
 var ModelsDownloadsCancelParams = import_zod10.z.strictObject({ key: import_zod10.z.string().max(64) });
 var ModelsDownloadsCancelResult = import_zod10.z.strictObject({ cancelled: import_zod10.z.boolean() });
+var LocalModelKind = import_zod10.z.enum(["text", "speech"]);
+var LocalModelRow = import_zod10.z.strictObject({
+  kind: LocalModelKind,
+  model: ModelKey,
+  /** Its folder in the service's store. */
+  path: import_zod10.z.string().max(1024),
+  /** Every file of the model, as installed. */
+  size_bytes: nonNegInt,
+  /** What Remove frees: the files only Matrx 2 holds. A file linked from the person's own folder frees nothing. */
+  freed_bytes: nonNegInt,
+  /** True when any file is a link to a file elsewhere (used in place): Remove then never deletes that file. */
+  in_place: import_zod10.z.boolean(),
+  /** The folder the person's files stay in (in place), when the service can tell; null otherwise. */
+  source: import_zod10.z.string().max(1024).nullable(),
+  /** The language model the server runs now (Remove stops it first). */
+  running: import_zod10.z.boolean()
+});
+var ModelsLocalListParams = import_zod10.z.strictObject({});
+var ModelsLocalListResult = import_zod10.z.strictObject({ models: import_zod10.z.array(LocalModelRow).max(1024) });
+var ModelsLocalRemoveParams = import_zod10.z.strictObject({ kind: LocalModelKind, model: ModelKey });
+var ModelsLocalRemoveResult = import_zod10.z.strictObject({
+  kind: LocalModelKind,
+  model: ModelKey,
+  /** Bytes of disk the removal gave back (0 for a model used in place). */
+  freed_bytes: nonNegInt,
+  /** True when it was the running model and the server was stopped first. */
+  stopped: import_zod10.z.boolean(),
+  /** Where the person's files stay (a model used in place); null when nothing was kept. */
+  kept: import_zod10.z.string().max(1024).nullable()
+});
 var MlServiceState = import_zod10.z.enum(["starting", "ready", "restarting", "failed", "stopped"]);
 var MlServiceStatus = import_zod10.z.strictObject({
   state: MlServiceState,
@@ -2522,7 +2568,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,
@@ -2980,6 +3028,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. */
@@ -3009,7 +3076,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({
@@ -3043,6 +3116,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");
@@ -5690,6 +5804,8 @@ var OPS = {
   "models.llm.stop": { params: ModelsLlmStopParams, result: ModelsLlmStopResult, kind: "unary", since: "1.31", errors: ["INTERNAL"] },
   "models.downloads.list": { params: ModelsDownloadsListParams, result: ModelsDownloadsListResult, kind: "unary", since: "1.45", errors: ["INTERNAL"] },
   "models.downloads.cancel": { params: ModelsDownloadsCancelParams, result: ModelsDownloadsCancelResult, kind: "unary", since: "1.45", errors: ["NOT_FOUND", "INTERNAL"] },
+  "models.local.list": { params: ModelsLocalListParams, result: ModelsLocalListResult, kind: "unary", since: "1.74", errors: ["INTERNAL"] },
+  "models.local.remove": { params: ModelsLocalRemoveParams, result: ModelsLocalRemoveResult, kind: "unary", since: "1.74", errors: ["NOT_FOUND", "INVALID_PARAMS", "RESOURCE_BUSY", "INTERNAL"] },
   // Desktop apps and their profiles (SPEC §6 apps); profiles are rows in users.desktop_app_profile.
   "apps.list": { params: AppsListParams, result: AppsListResult, kind: "unary", since: "1.2", errors: ["INTERNAL"] },
   "apps.profiles.list": { params: AppsProfilesListParams, result: AppsProfilesListResult, kind: "unary", since: "1.2", errors: ["NOT_FOUND", "INVALID_PARAMS", "INTERNAL"] },
@@ -5719,6 +5835,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"] },
@@ -5969,6 +6086,8 @@ var SERVICES = {
       "ml.llm_stop": { params: ModelsLlmStopParams, result: ModelsLlmStopResult },
       "ml.downloads": { params: ModelsDownloadsListParams, result: ModelsDownloadsListResult },
       "ml.download_cancel": { params: ModelsDownloadsCancelParams, result: ModelsDownloadsCancelResult },
+      "ml.local_list": { params: ModelsLocalListParams, result: ModelsLocalListResult },
+      "ml.local_remove": { params: ModelsLocalRemoveParams, result: ModelsLocalRemoveResult },
       "ml.catalog_set": { params: MlCatalogSetParams, result: MlCatalogSetResult }
     }
   },
@@ -6015,6 +6134,16 @@ var NAMED_SCHEMAS = {
   AppsInstancesListResult,
   AppsAccountsListParams,
   AppsAccountsListResult,
+  AccountReadSource,
+  AccountProfile,
+  McpTransport,
+  McpServerRow,
+  SetupFact,
+  SetupItemKind,
+  SetupItem,
+  AppSetup,
+  AppsSetupListParams,
+  AppsSetupListResult,
   ProtocolVersion,
   RequestId,
   ResourceId,
@@ -6157,6 +6286,12 @@ var NAMED_SCHEMAS = {
   ModelsDownloadsListResult,
   ModelsDownloadsCancelParams,
   ModelsDownloadsCancelResult,
+  LocalModelKind,
+  LocalModelRow,
+  ModelsLocalListParams,
+  ModelsLocalListResult,
+  ModelsLocalRemoveParams,
+  ModelsLocalRemoveResult,
   CodingServiceCredentials,
   CodingHistoryBlocked,
   CodingHistoryFailure,
@@ -6845,7 +6980,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" },
@@ -7136,7 +7272,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 = "1d36d53c7f7370a8baa0577961ea9f59d46fa08e5786180c17f378bf7c4fb5f6";
+var CONTRACT_SHA256 = "37ce31c865512882841181ce3e174f89fcc134f5aab983df8ededdab363b08bd";
 
 // src/close-policy.ts
 var CLOSE_RULES = {