@ai-matrx/desktop-protocol 0.21.35 → 0.21.37

package/dist/index.js

@@ -2,7 +2,7 @@
 import { z } from "zod";
 import { UUID_SHAPE_PATTERN } from "@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 = 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_-]+$/);
@@ -449,6 +449,14 @@ var SysinfoGetResult = z5.strictObject({
     })
   ).optional()
 });
+var SysinfoGraphicsAdapter = z5.strictObject({
+  name: z5.string().max(128),
+  vendor: z5.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: z5.boolean(),
+  unified: z5.boolean()
+});
 var SysinfoHardwareParams = z5.strictObject({});
 var SysinfoHardwareResult = z5.strictObject({
   /** "Mac Studio", "MacBook Pro", "ThinkPad X1 Carbon". */
@@ -464,7 +472,10 @@ var SysinfoHardwareResult = z5.strictObject({
   os_name: z5.string().max(64).nullable(),
   /** "26.6.2". */
   os_version: z5.string().max(64).nullable(),
-  os_build: z5.string().max(64).nullable()
+  os_build: z5.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: z5.array(SysinfoGraphicsAdapter).max(16).optional()
 });
 
 // src/schema/fs.ts
@@ -907,6 +918,29 @@ var ModelsLlmStartParams = z10.strictObject({
 var ModelsLlmStartResult = z10.strictObject({ running: LlmRunning, elapsed_ms: nonNegInt });
 var ModelsLlmStopParams = z10.strictObject({});
 var ModelsLlmStopResult = z10.strictObject({ stopped: z10.boolean() });
+var DownloadKind = z10.enum(["speech_model", "text_model", "runtime"]);
+var DownloadRow = z10.strictObject({
+  /** The job's key in the service: "model:base", "llm:smollm2-135m", "llm-server", "runtime". */
+  key: z10.string().max(64),
+  kind: DownloadKind,
+  /** The model id for a model download; null for a runtime. */
+  model: z10.string().max(64).nullable(),
+  /** "running" while it downloads; "stopped" when only its half-done file is left (Resume re-runs the install). */
+  state: z10.enum(["running", "stopped"]),
+  /** What it is doing now ("download", "verify", …); null when stopped. */
+  step: z10.string().max(32).nullable(),
+  bytes_done: nonNegInt,
+  bytes_total: nonNegInt.nullable(),
+  fraction: z10.number().min(0).max(1).nullable(),
+  /** Unix ms; null when stopped. */
+  started_at: nonNegInt.nullable(),
+  /** The folder it downloads into (Show in Finder). */
+  path: z10.string().max(1024).nullable()
+});
+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 MlServiceState = z10.enum(["starting", "ready", "restarting", "failed", "stopped"]);
 var MlServiceStatus = z10.strictObject({
   state: MlServiceState,
@@ -1781,7 +1815,13 @@ var ToolLevelResult = z16.strictObject({
   suite: z16.string().min(1).max(200),
   /** The test case inside the suite. */
   test: z16.string().min(1).max(300),
-  run_at_ms: z16.int().min(0)
+  run_at_ms: z16.int().min(0),
+  /**
+   * Chat level: how many tool calls the agent's turn made, of any tool. `0` means the turn never
+   * exercised a tool (the model answered in prose, or the chat request failed), so the result is
+   * no evidence about the tool: it never turns a cell red. Absent on older results.
+   */
+  calls_made: z16.int().min(0).optional()
 });
 var ToolResultsFile = z16.strictObject({
   schema: z16.literal("matrx.tool-results.v1"),
@@ -4201,6 +4241,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"] },
@@ -4458,7 +4500,9 @@ var SERVICES = {
       "ml.llm_status": { params: ModelsLlmStatusParams, result: ModelsLlmStatusResult },
       "ml.llm_install": { params: ModelsLlmInstallParams, result: ModelsLlmInstallResult },
       "ml.llm_start": { params: ModelsLlmStartParams, result: ModelsLlmStartResult },
-      "ml.llm_stop": { params: ModelsLlmStopParams, result: ModelsLlmStopResult }
+      "ml.llm_stop": { params: ModelsLlmStopParams, result: ModelsLlmStopResult },
+      "ml.downloads": { params: ModelsDownloadsListParams, result: ModelsDownloadsListResult },
+      "ml.download_cancel": { params: ModelsDownloadsCancelParams, result: ModelsDownloadsCancelResult }
     }
   },
   coding: {
@@ -4517,6 +4561,7 @@ var NAMED_SCHEMAS = {
   SysinfoGetResult,
   SysinfoHardwareParams,
   SysinfoHardwareResult,
+  SysinfoGraphicsAdapter,
   FsKind,
   FsEntry,
   FsListParams,
@@ -4609,6 +4654,12 @@ var NAMED_SCHEMAS = {
   ModelsLlmStartResult,
   ModelsLlmStopParams,
   ModelsLlmStopResult,
+  DownloadKind,
+  DownloadRow,
+  ModelsDownloadsListParams,
+  ModelsDownloadsListResult,
+  ModelsDownloadsCancelParams,
+  ModelsDownloadsCancelResult,
   CodingServiceCredentials,
   CodingHistoryBlocked,
   CodingHistoryFailure,
@@ -5268,7 +5319,8 @@ var FIELDS_SINCE = {
   WebBrowserFetchResult: { source: "1.40" },
   SysinfoGetResult: { requirements: "1.41" },
   "SysinfoGetResult.permissions[]": { detail: "1.41" },
-  MessagesSendParams: { service: "1.42" }
+  MessagesSendParams: { service: "1.42" },
+  SysinfoHardwareResult: { graphics: "1.45" }
 };
 var NULL_SINCE = {
   "RelayDeviceStatusEvent.since_ms": { since: "1.1", olderPeersGet: 0 }
@@ -5354,6 +5406,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([
@@ -5432,7 +5485,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 = "0024b25ed8c4984e38962ec31d70ee685f0cf158efdfb12ac7695d192045bc37";
+var CONTRACT_SHA256 = "5de0c64447e01d6ff3a467492e9ea725b42091ddcb039eb8001f4ff0413f84c6";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -5686,6 +5739,9 @@ function builtOps() {
 var TOOL_LEVELS = ["programmatic", "protocol", "chat"];
 var TOOL_PLATFORMS = ["darwin", "win32", "linux"];
 var UUID_IN_NAME = /[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi;
+function isInconclusive(e) {
+  return e.outcome === "skip" || e.calls_made === 0;
+}
 var REQUIRED = {
   programmatic: [{ label: "in process", ok: (e) => e.transport === "in_process" }],
   protocol: [
@@ -5698,18 +5754,22 @@ var REQUIRED = {
 function cellFor(tool2, platform, level, evidence) {
   if (!tool2.platforms.includes(platform)) return { state: "unsupported", missing: [], last_run_at_ms: null, evidence: [] };
   const latest = /* @__PURE__ */ new Map();
+  const latestInconclusive = /* @__PURE__ */ new Map();
   for (const e of evidence) {
     const key = `${e.suite}\0${e.test.replace(UUID_IN_NAME, "<id>")}\0${e.transport}\0${e.remote_network}`;
-    const prev = latest.get(key);
-    if (!prev || prev.run_at_ms < e.run_at_ms) latest.set(key, e);
+    const into = isInconclusive(e) ? latestInconclusive : latest;
+    const prev = into.get(key);
+    if (!prev || prev.run_at_ms < e.run_at_ms) into.set(key, e);
   }
-  const runs = [...latest.values()].filter((e) => e.outcome !== "skip").sort((a, b) => b.run_at_ms - a.run_at_ms);
+  const runs = [...latest.values()].sort((a, b) => b.run_at_ms - a.run_at_ms);
+  const unproven = [...latestInconclusive].filter(([k, e]) => (latest.get(k)?.run_at_ms ?? -1) < e.run_at_ms).map(([, e]) => e);
+  const shown = [...runs, ...unproven].sort((a, b) => b.run_at_ms - a.run_at_ms);
   const last = runs[0]?.run_at_ms ?? null;
   if (tool2.state === "planned" && runs.length === 0) return { state: "not_built", missing: [], last_run_at_ms: null, evidence: [] };
-  if (runs.length === 0) return { state: "untested", missing: REQUIRED[level].map((r) => r.label), last_run_at_ms: null, evidence: [...latest.values()] };
-  if (runs.some((e) => e.outcome === "fail")) return { state: "fail", missing: [], last_run_at_ms: last, evidence: runs };
+  if (runs.length === 0) return { state: "untested", missing: REQUIRED[level].map((r) => r.label), last_run_at_ms: null, evidence: shown };
+  if (runs.some((e) => e.outcome === "fail")) return { state: "fail", missing: [], last_run_at_ms: last, evidence: shown };
   const missing = REQUIRED[level].filter((r) => !runs.some((e) => e.outcome === "pass" && r.ok(e))).map((r) => r.label);
-  return { state: missing.length === 0 ? "pass" : "partial", missing, last_run_at_ms: last, evidence: runs };
+  return { state: missing.length === 0 ? "pass" : "partial", missing, last_run_at_ms: last, evidence: shown };
 }
 function buildToolStatus(files, opts) {
   const parsed = files.map((f, i) => {
@@ -5724,7 +5784,17 @@ function buildToolStatus(files, opts) {
       if (!known.has(r.tool)) throw new Error(`a result names ${r.tool}, which is not in the tool catalog`);
       const key = `${r.tool}|${r.platform}|${r.level}`;
       const list = byKey.get(key) ?? [];
-      list.push({ suite: r.suite, test: r.test, transport: r.transport, outcome: r.outcome, remote_network: r.remote_network, commit: file.commit, run_at_ms: r.run_at_ms, detail: r.detail });
+      list.push({
+        suite: r.suite,
+        test: r.test,
+        transport: r.transport,
+        outcome: r.outcome,
+        remote_network: r.remote_network,
+        commit: file.commit,
+        run_at_ms: r.run_at_ms,
+        detail: r.detail,
+        ...r.calls_made === void 0 ? {} : { calls_made: r.calls_made }
+      });
       byKey.set(key, list);
     }
   }
@@ -6131,6 +6201,8 @@ export {
   DocumentsPdfTextParams,
   DocumentsPdfTextResult,
   DocumentsSheet,
+  DownloadKind,
+  DownloadRow,
   EVENTS,
   EXCLUDED_TOOLS,
   EndMsg,
@@ -6287,6 +6359,10 @@ export {
   MlServiceStatus,
   MlStatusParams,
   MlStatusResult,
+  ModelsDownloadsCancelParams,
+  ModelsDownloadsCancelResult,
+  ModelsDownloadsListParams,
+  ModelsDownloadsListResult,
   ModelsInstallParams,
   ModelsInstallResult,
   ModelsLlmInstallParams,
@@ -6505,6 +6581,7 @@ export {
   StreamMsg,
   SysinfoGetParams,
   SysinfoGetResult,
+  SysinfoGraphicsAdapter,
   SysinfoHardwareParams,
   SysinfoHardwareResult,
   SystemNotifyParams,
@@ -6629,6 +6706,7 @@ export {
   hasFlag,
   isConnectionEnd,
   isDesktopProtocolError,
+  isInconclusive,
   isTerminalClose,
   knows,
   negotiate,