@ai-matrx/desktop-protocol 0.21.35 → 0.21.37

package/dist/index.cjs

@@ -340,6 +340,8 @@ __export(src_exports, {
   DocumentsPdfTextParams: () => DocumentsPdfTextParams,
   DocumentsPdfTextResult: () => DocumentsPdfTextResult,
   DocumentsSheet: () => DocumentsSheet,
+  DownloadKind: () => DownloadKind,
+  DownloadRow: () => DownloadRow,
   EVENTS: () => EVENTS,
   EXCLUDED_TOOLS: () => EXCLUDED_TOOLS,
   EndMsg: () => EndMsg,
@@ -496,6 +498,10 @@ __export(src_exports, {
   MlServiceStatus: () => MlServiceStatus,
   MlStatusParams: () => MlStatusParams,
   MlStatusResult: () => MlStatusResult,
+  ModelsDownloadsCancelParams: () => ModelsDownloadsCancelParams,
+  ModelsDownloadsCancelResult: () => ModelsDownloadsCancelResult,
+  ModelsDownloadsListParams: () => ModelsDownloadsListParams,
+  ModelsDownloadsListResult: () => ModelsDownloadsListResult,
   ModelsInstallParams: () => ModelsInstallParams,
   ModelsInstallResult: () => ModelsInstallResult,
   ModelsLlmInstallParams: () => ModelsLlmInstallParams,
@@ -714,6 +720,7 @@ __export(src_exports, {
   StreamMsg: () => StreamMsg,
   SysinfoGetParams: () => SysinfoGetParams,
   SysinfoGetResult: () => SysinfoGetResult,
+  SysinfoGraphicsAdapter: () => SysinfoGraphicsAdapter,
   SysinfoHardwareParams: () => SysinfoHardwareParams,
   SysinfoHardwareResult: () => SysinfoHardwareResult,
   SystemNotifyParams: () => SystemNotifyParams,
@@ -838,6 +845,7 @@ __export(src_exports, {
   hasFlag: () => hasFlag,
   isConnectionEnd: () => isConnectionEnd,
   isDesktopProtocolError: () => isDesktopProtocolError,
+  isInconclusive: () => isInconclusive,
   isTerminalClose: () => isTerminalClose,
   knows: () => knows,
   negotiate: () => negotiate,
@@ -858,7 +866,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 = 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_-]+$/);
@@ -1305,6 +1313,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". */
@@ -1320,7 +1336,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
@@ -1763,6 +1782,29 @@ var ModelsLlmStartParams = import_zod10.z.strictObject({
 var ModelsLlmStartResult = import_zod10.z.strictObject({ running: LlmRunning, elapsed_ms: nonNegInt });
 var ModelsLlmStopParams = import_zod10.z.strictObject({});
 var ModelsLlmStopResult = import_zod10.z.strictObject({ stopped: import_zod10.z.boolean() });
+var DownloadKind = import_zod10.z.enum(["speech_model", "text_model", "runtime"]);
+var DownloadRow = import_zod10.z.strictObject({
+  /** The job's key in the service: "model:base", "llm:smollm2-135m", "llm-server", "runtime". */
+  key: import_zod10.z.string().max(64),
+  kind: DownloadKind,
+  /** The model id for a model download; null for a runtime. */
+  model: import_zod10.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_zod10.z.enum(["running", "stopped"]),
+  /** What it is doing now ("download", "verify", …); null when stopped. */
+  step: import_zod10.z.string().max(32).nullable(),
+  bytes_done: nonNegInt,
+  bytes_total: nonNegInt.nullable(),
+  fraction: import_zod10.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_zod10.z.string().max(1024).nullable()
+});
+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 MlServiceState = import_zod10.z.enum(["starting", "ready", "restarting", "failed", "stopped"]);
 var MlServiceStatus = import_zod10.z.strictObject({
   state: MlServiceState,
@@ -2637,7 +2679,13 @@ var ToolLevelResult = import_zod16.z.strictObject({
   suite: import_zod16.z.string().min(1).max(200),
   /** The test case inside the suite. */
   test: import_zod16.z.string().min(1).max(300),
-  run_at_ms: import_zod16.z.int().min(0)
+  run_at_ms: import_zod16.z.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: import_zod16.z.int().min(0).optional()
 });
 var ToolResultsFile = import_zod16.z.strictObject({
   schema: import_zod16.z.literal("matrx.tool-results.v1"),
@@ -5057,6 +5105,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"] },
@@ -5314,7 +5364,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: {
@@ -5373,6 +5425,7 @@ var NAMED_SCHEMAS = {
   SysinfoGetResult,
   SysinfoHardwareParams,
   SysinfoHardwareResult,
+  SysinfoGraphicsAdapter,
   FsKind,
   FsEntry,
   FsListParams,
@@ -5465,6 +5518,12 @@ var NAMED_SCHEMAS = {
   ModelsLlmStartResult,
   ModelsLlmStopParams,
   ModelsLlmStopResult,
+  DownloadKind,
+  DownloadRow,
+  ModelsDownloadsListParams,
+  ModelsDownloadsListResult,
+  ModelsDownloadsCancelParams,
+  ModelsDownloadsCancelResult,
   CodingServiceCredentials,
   CodingHistoryBlocked,
   CodingHistoryFailure,
@@ -6124,7 +6183,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 }
@@ -6210,6 +6270,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([
@@ -6288,7 +6349,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 = {
@@ -6542,6 +6603,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: [
@@ -6554,18 +6618,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) => {
@@ -6580,7 +6648,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);
     }
   }