@ai-matrx/desktop-protocol 0.21.36 → 0.21.38

package/CHANGELOG.md

@@ -1,8 +1,34 @@
 # Changelog
 
+## 0.21.38
+### Unreleased
+
+- Protocol 1.46 (additive): `DownloadRow.error` (optional) — a failed model download stays in
+  models.downloads.list with why it stopped. Stripped for 1.45 peers.
+
+## 0.21.37
+
+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 6776a9a814 aa17cdaf9c -- apps/shared/desktop-protocol/src`
+
+Changed shipped source files (6):
+- `apps/shared/desktop-protocol/src/contract.ts`
+- `apps/shared/desktop-protocol/src/schema/models.ts`
+- `apps/shared/desktop-protocol/src/schema/primitives.ts`
+- `apps/shared/desktop-protocol/src/schema/registry.ts`
+- `apps/shared/desktop-protocol/src/schema/sysinfo.ts`
+- `apps/shared/desktop-protocol/src/versioning.ts`
+
 ## 0.21.36
 ### Unreleased
 
+- Protocol 1.45 (additive). `sysinfo.hardware` gains optional `graphics`
+  (`SysinfoGraphicsAdapter`: name, vendor, memory_bytes, memory_approximate, unified), stripped for
+  older peers. New ops `models.downloads.list` / `models.downloads.cancel` (key only), forwarded to
+  the ml service's new `ml.downloads` / `ml.download_cancel`. Consumer action: Matrx 2 regenerates
+  its Python contract (`node scripts/python-contract.mjs`) and implements the two service ops.
+
 - `ToolLevelResult.calls_made` (optional): at the chat level, how many tool calls the agent's turn
   made. `buildToolStatus` never lets a result that made zero calls, or a `skip`, replace a decisive
   pass or fail: such a run never exercised the tool, so it is no evidence about it. Before this, one

package/dist/client.cjs

@@ -144,7 +144,7 @@ var import_zod2 = require("zod");
 var import_zod = require("zod");
 var import_uuid = require("@ai-matrx/kit/uuid");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 44;
+var PROTOCOL_MINOR = 46;
 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_-]+$/);
@@ -482,6 +482,14 @@ var SysinfoGetResult = import_zod5.z.strictObject({
     })
   ).optional()
 });
+var SysinfoGraphicsAdapter = import_zod5.z.strictObject({
+  name: import_zod5.z.string().max(128),
+  vendor: import_zod5.z.string().max(64).nullable(),
+  memory_bytes: nonNegInt.nullable(),
+  /** True when the OS gives only an approximate size (Windows AdapterRAM, capped at 4 GB). */
+  memory_approximate: import_zod5.z.boolean(),
+  unified: import_zod5.z.boolean()
+});
 var SysinfoHardwareParams = import_zod5.z.strictObject({});
 var SysinfoHardwareResult = import_zod5.z.strictObject({
   /** "Mac Studio", "MacBook Pro", "ThinkPad X1 Carbon". */
@@ -497,7 +505,10 @@ var SysinfoHardwareResult = import_zod5.z.strictObject({
   os_name: import_zod5.z.string().max(64).nullable(),
   /** "26.6.2". */
   os_version: import_zod5.z.string().max(64).nullable(),
-  os_build: import_zod5.z.string().max(64).nullable()
+  os_build: import_zod5.z.string().max(64).nullable(),
+  /** (1.45) Every graphics adapter, as System Information's Graphics/Displays lists them. Optional:
+   *  a core older than 1.45 omits it. */
+  graphics: import_zod5.z.array(SysinfoGraphicsAdapter).max(16).optional()
 });
 
 // src/schema/fs.ts
@@ -888,6 +899,31 @@ var ModelsLlmStartParams = import_zod9.z.strictObject({
 var ModelsLlmStartResult = import_zod9.z.strictObject({ running: LlmRunning, elapsed_ms: nonNegInt });
 var ModelsLlmStopParams = import_zod9.z.strictObject({});
 var ModelsLlmStopResult = import_zod9.z.strictObject({ stopped: import_zod9.z.boolean() });
+var DownloadKind = import_zod9.z.enum(["speech_model", "text_model", "runtime"]);
+var DownloadRow = import_zod9.z.strictObject({
+  /** The job's key in the service: "model:base", "llm:smollm2-135m", "llm-server", "runtime". */
+  key: import_zod9.z.string().max(64),
+  kind: DownloadKind,
+  /** The model id for a model download; null for a runtime. */
+  model: import_zod9.z.string().max(64).nullable(),
+  /** "running" while it downloads; "stopped" when only its half-done file is left (Resume re-runs the install). */
+  state: import_zod9.z.enum(["running", "stopped"]),
+  /** What it is doing now ("download", "verify", …); null when stopped. */
+  step: import_zod9.z.string().max(32).nullable(),
+  bytes_done: nonNegInt,
+  bytes_total: nonNegInt.nullable(),
+  fraction: import_zod9.z.number().min(0).max(1).nullable(),
+  /** Unix ms; null when stopped. */
+  started_at: nonNegInt.nullable(),
+  /** The folder it downloads into (Show in Finder). */
+  path: import_zod9.z.string().max(1024).nullable(),
+  /** (1.46) Why it stopped, when it failed (one human line); absent otherwise. */
+  error: import_zod9.z.string().max(300).optional()
+});
+var ModelsDownloadsListParams = import_zod9.z.strictObject({});
+var ModelsDownloadsListResult = import_zod9.z.strictObject({ downloads: import_zod9.z.array(DownloadRow).max(64) });
+var ModelsDownloadsCancelParams = import_zod9.z.strictObject({ key: import_zod9.z.string().max(64) });
+var ModelsDownloadsCancelResult = import_zod9.z.strictObject({ cancelled: import_zod9.z.boolean() });
 var MlServiceState = import_zod9.z.enum(["starting", "ready", "restarting", "failed", "stopped"]);
 var MlServiceStatus = import_zod9.z.strictObject({
   state: MlServiceState,
@@ -4152,6 +4188,8 @@ var OPS = {
   "models.llm.install": { params: ModelsLlmInstallParams, result: ModelsLlmInstallResult, kind: "unary", since: "1.31", errors: ["RESOURCE_BUSY", "RESOURCE_GONE", "TIMEOUT", "CANCELLED", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "models.llm.start": { params: ModelsLlmStartParams, result: ModelsLlmStartResult, kind: "unary", since: "1.31", errors: ["NOT_FOUND", "RESOURCE_BUSY", "RESOURCE_GONE", "TIMEOUT", "CANCELLED", "PLATFORM_UNSUPPORTED", "INTERNAL"] },
   "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"] },
   // 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"] },
@@ -4417,6 +4455,7 @@ var RESULT_PATH = /* @__PURE__ */ new Map([
   ["apps.windows.update_state", "AppsWindowsUpdateStateResult"],
   ["web.fetch_with_browser", "WebBrowserFetchResult"],
   ["sysinfo.get", "SysinfoGetResult"],
+  ["sysinfo.hardware", "SysinfoHardwareResult"],
   ["apps.projects.to_window", "AppsProjectsToWindowResult"]
 ]);
 var NESTED_RESULTS = /* @__PURE__ */ new Map([
@@ -4433,6 +4472,7 @@ var NESTED_RESULTS = /* @__PURE__ */ new Map([
   ["account.agents.list", [["agents", "AccountAgent"]]],
   ["web.scrape", [["pages", "WebScrapePage"]]],
   ["sysinfo.get", [["permissions", "SysinfoGetResult.permissions[]"]]],
+  ["models.downloads.list", [["downloads", "DownloadRow"]]],
   ["apps.projects.to_window", [["group", "ProjectMoveGroup"]]]
 ]);
 var WINDOW_RESULTS = /* @__PURE__ */ new Map([