@ai-matrx/desktop-protocol 0.21.36 → 0.21.37

package/CHANGELOG.md

@@ -1,8 +1,19 @@
 # Changelog
 
+## 0.21.37
+
+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.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 = 45;
 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,29 @@ 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()
+});
+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 +4186,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 +4453,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([