@ai-matrx/desktop-protocol 0.21.35 → 0.21.36

package/CHANGELOG.md

@@ -1,9 +1,26 @@
 # Changelog
 
+## 0.21.36
+### Unreleased
+
+- `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
+  chat turn that answered in prose (0/0 calls) turned 15 proven macOS tools red. Additive; no
+  consumer action, except harnesses should now send `calls_made` on chat results.
+
 ## 0.21.35
 
-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`.
+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 6782472662 9e65b0b7ac -- apps/shared/desktop-protocol/src`
+
+Changed shipped source files (5):
+- `apps/shared/desktop-protocol/src/contract.ts`
+- `apps/shared/desktop-protocol/src/schema/personal.ts`
+- `apps/shared/desktop-protocol/src/schema/primitives.ts`
+- `apps/shared/desktop-protocol/src/schema/registry.ts`
+- `apps/shared/desktop-protocol/src/tools/catalog.ts`
 
 ## 0.21.34
 

package/dist/client.d.cts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-Sz1BEet6.cjs';
-export { i as isDesktopProtocolError } from './models-Sz1BEet6.cjs';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-MgdG4k-4.cjs';
+export { i as isDesktopProtocolError } from './models-MgdG4k-4.cjs';
 import { FrameHeader } from './frame.cjs';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/client.d.ts

@@ -1,8 +1,8 @@
 import { BackoffOptions } from '@ai-matrx/realtime';
 export { RECONNECT_ALARM_ATTEMPTS } from '@ai-matrx/realtime';
 import { z } from 'zod';
-import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-Sz1BEet6.js';
-export { i as isDesktopProtocolError } from './models-Sz1BEet6.js';
+import { W as Welcome, D as DesktopProtocolError, C as CloseOutcome, O as OpName, a as OpParams, b as OpResult, c as OPS, S as StreamMeta, E as EndReason, d as EVENTS, e as ClientType, M as ModelsTranscribeResult, T as TranscriptionModelId, f as MlProgress } from './models-MgdG4k-4.js';
+export { i as isDesktopProtocolError } from './models-MgdG4k-4.js';
 import { FrameHeader } from './frame.js';
 
 /** The subset of the WHATWG WebSocket the client uses — browser, React Native, `ws` and Workers all fit. */

package/dist/index.cjs

@@ -838,6 +838,7 @@ __export(src_exports, {
   hasFlag: () => hasFlag,
   isConnectionEnd: () => isConnectionEnd,
   isDesktopProtocolError: () => isDesktopProtocolError,
+  isInconclusive: () => isInconclusive,
   isTerminalClose: () => isTerminalClose,
   knows: () => knows,
   negotiate: () => negotiate,
@@ -2637,7 +2638,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"),
@@ -6288,7 +6295,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 = "43847f57bce65d9ec349363f4a27cf88bf6bf627931a077e3c0a97b7317ca9c0";
 
 // src/close-policy.ts
 var CLOSE_RULES = {
@@ -6542,6 +6549,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 +6564,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 +6594,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);
     }
   }