@ai-matrx/desktop-protocol 0.21.73 → 0.21.75

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # Changelog
 
+## 0.21.75
+### Protocol 1.74 — the models on this computer, and Remove
+
+- New op `models.local.list` (service op `ml.local_list`): every model the ml service holds — language
+  models (the person's own adopted models included) and speech models — as `LocalModelRow`: `kind`
+  (`text` | `speech`), `model`, `path`, `size_bytes`, `freed_bytes` (what Remove gives back),
+  `in_place`, `source` (the folder the person's files stay in) and `running`.
+- New op `models.local.remove` (service op `ml.local_remove`, `kind` + `model`): deletes only the files
+  Matrx 2 holds; a link to the person's own file is unlinked, never the file. The running model is
+  stopped first. Answers `freed_bytes`, `stopped` and `kept`.
+- New ops since 1.74. Consumer action: none for an older client.
+
+## 0.21.74
+
+SOURCE CHANGED WITH NO RELEASE NOTE. This release shipped source changes that nobody described in an Unreleased entry,
+so they may include breaking API changes. Consumer action is UNKNOWN: read the diff before upgrading.
+Diff: `git diff aa4f979a76 3165453310 -- apps/shared/desktop-protocol/src`
+
+Changed shipped source files (6):
+- `apps/shared/desktop-protocol/src/contract.ts`
+- `apps/shared/desktop-protocol/src/schema/apps-accounts.ts`
+- `apps/shared/desktop-protocol/src/schema/apps-instances.ts`
+- `apps/shared/desktop-protocol/src/schema/primitives.ts`
+- `apps/shared/desktop-protocol/src/schema/registry.ts`
+- `apps/shared/desktop-protocol/src/versioning.ts`
+
 ## 0.21.73
 ### Protocol 1.72 — ours pushed into the apps
 
@@ -224,6 +250,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-FBLTGJJA.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 = 74;
 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_-]+$/);
@@ -894,6 +894,36 @@ var ModelsDownloadsListParams = z10.strictObject({});
 var ModelsDownloadsListResult = z10.strictObject({ downloads: z10.array(DownloadRow).max(64) });
 var ModelsDownloadsCancelParams = z10.strictObject({ key: z10.string().max(64) });
 var ModelsDownloadsCancelResult = z10.strictObject({ cancelled: z10.boolean() });
+var LocalModelKind = z10.enum(["text", "speech"]);
+var LocalModelRow = z10.strictObject({
+  kind: LocalModelKind,
+  model: ModelKey,
+  /** Its folder in the service's store. */
+  path: z10.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: z10.boolean(),
+  /** The folder the person's files stay in (in place), when the service can tell; null otherwise. */
+  source: z10.string().max(1024).nullable(),
+  /** The language model the server runs now (Remove stops it first). */
+  running: z10.boolean()
+});
+var ModelsLocalListParams = z10.strictObject({});
+var ModelsLocalListResult = z10.strictObject({ models: z10.array(LocalModelRow).max(1024) });
+var ModelsLocalRemoveParams = z10.strictObject({ kind: LocalModelKind, model: ModelKey });
+var ModelsLocalRemoveResult = z10.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: z10.boolean(),
+  /** Where the person's files stay (a model used in place); null when nothing was kept. */
+  kept: z10.string().max(1024).nullable()
+});
 var MlServiceState = z10.enum(["starting", "ready", "restarting", "failed", "stopped"]);
 var MlServiceStatus = z10.strictObject({
   state: MlServiceState,
@@ -1476,7 +1506,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 +1966,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 +2014,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 +2054,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 +4742,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"] },
@@ -4673,6 +4773,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"] },
@@ -4923,6 +5024,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 }
     }
   },
@@ -4969,6 +5072,16 @@ var NAMED_SCHEMAS = {
   AppsInstancesListResult,
   AppsAccountsListParams,
   AppsAccountsListResult,
+  AccountReadSource,
+  AccountProfile,
+  McpTransport,
+  McpServerRow,
+  SetupFact,
+  SetupItemKind,
+  SetupItem,
+  AppSetup,
+  AppsSetupListParams,
+  AppsSetupListResult,
   ProtocolVersion,
   RequestId,
   ResourceId,
@@ -5111,6 +5224,12 @@ var NAMED_SCHEMAS = {
   ModelsDownloadsListResult,
   ModelsDownloadsCancelParams,
   ModelsDownloadsCancelResult,
+  LocalModelKind,
+  LocalModelRow,
+  ModelsLocalListParams,
+  ModelsLocalListResult,
+  ModelsLocalRemoveParams,
+  ModelsLocalRemoveResult,
   CodingServiceCredentials,
   CodingHistoryBlocked,
   CodingHistoryFailure,
@@ -5799,7 +5918,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" },
@@ -6283,6 +6403,12 @@ export {
   ModelsDownloadsListResult,
   ModelsDownloadsCancelParams,
   ModelsDownloadsCancelResult,
+  LocalModelKind,
+  LocalModelRow,
+  ModelsLocalListParams,
+  ModelsLocalListResult,
+  ModelsLocalRemoveParams,
+  ModelsLocalRemoveResult,
   MlServiceState,
   MlServiceStatus,
   ModelsStatusParams,
@@ -6465,6 +6591,8 @@ export {
   ElsewhereInstance,
   AccountResetSource,
   AccountGap,
+  AccountReadSource,
+  AccountProfile,
   AppAccount,
   AppsInstancesListParams,
   AppsInstancesListResult,
@@ -6476,6 +6604,14 @@ export {
   ProbeSource,
   AppsChatsProbeParams,
   AppsChatsProbeResult,
+  McpTransport,
+  McpServerRow,
+  SetupFact,
+  SetupItemKind,
+  SetupItem,
+  AppSetup,
+  AppsSetupListParams,
+  AppsSetupListResult,
   SERVICE_MAX_FRAME_BYTES,
   ServiceName,
   ContractHash,
@@ -6984,4 +7120,4 @@ export {
   closeRule,
   isTerminalClose
 };
-//# sourceMappingURL=chunk-server-MK77KDKS.js.map
+//# sourceMappingURL=chunk-server-FBLTGJJA.js.map