@ai-matrx/desktop-protocol 0.17.0 → 0.17.2

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.17.2
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/desktop-protocol/v0.17.1..npm/desktop-protocol/v0.17.2 -- apps/shared/desktop-protocol`).
+No source changes intended and no consumer action required.
+
+## 0.17.1
+
+- buildToolStatus: a uuid in a test name (the agent a chat proof ran) is not part of the proof's
+  identity, so the same proof under a new test agent replaces the old agent's result instead of
+  standing beside it forever.
+
+Consumer action: none.
+
+## Unreleased
+
+- **`useDesktopRequest(op, params, { refreshMs })`: live data without a hand-rolled poller.** Re-runs
+  every `refreshMs` while the page is visible, never while hidden, and at once on return. Matrx 2's
+  screens each carried their own `setInterval` loop (five shapes); this is the one. Guard:
+  `src/react.test.tsx` ("refreshMs polls while visible …").
+- **Errors keep their code across built entries.** `DesktopProtocolError.from(caught)` recognises an
+  error thrown by a sibling entry's copy of the class (each built entry carries its own), so a
+  real `NOT_FOUND` "No file at that path" no longer surfaces as a generic `INTERNAL`. The hooks use
+  it, and `useDesktopAction` treats `CANCELLED` (the person pressed Stop) as no error. Guard:
+  `src/react.test.tsx` ("an error from another copy …").
+- **`useDesktopAction({ onDone })`: a screen's writes.** One `busy` flag and one typed error for
+  create/save/remove/open, with a refetch after each success. Replaces the per-screen
+  `busy`/`error` `useState` pairs. Guard: `src/react.test.tsx` ("useDesktopAction tracks busy …").
+
 ## 0.17.0 (protocol 1.6)
 
 - The `audio` capability: `audio.devices` (microphones and speakers), `audio.record` (a clip to a
@@ -277,3 +306,4 @@ Defects found in the draft and fixed here (not preserved):
 
 None — new package.
 
+

package/dist/client.cjs

@@ -34,7 +34,7 @@ module.exports = __toCommonJS(client_exports);
 var import_realtime = require("@ai-matrx/realtime");
 
 // src/error.ts
-var DesktopProtocolError = class extends Error {
+var DesktopProtocolError = class _DesktopProtocolError extends Error {
   code;
   retryable;
   data;
@@ -45,6 +45,23 @@ var DesktopProtocolError = class extends Error {
     this.retryable = options.retryable ?? false;
     this.data = options.data;
   }
+  /**
+   * Any thrown value as a DesktopProtocolError, keeping its code, message and data. Each built entry
+   * (`.`, `./client`, `./react`) carries its own copy of this class, so `instanceof` alone misses an
+   * error thrown by a sibling entry and reports a real NOT_FOUND as INTERNAL; this checks the shape.
+   */
+  static from(caught) {
+    if (caught instanceof _DesktopProtocolError) return caught;
+    const e = caught;
+    if (e && typeof e === "object" && e.name === "DesktopProtocolError" && typeof e.code === "string") {
+      return new _DesktopProtocolError(e.code, typeof e.message === "string" ? e.message : String(e.code), {
+        retryable: e.retryable === true,
+        ...e.data && typeof e.data === "object" ? { data: e.data } : {},
+        cause: caught
+      });
+    }
+    return new _DesktopProtocolError("INTERNAL", caught instanceof Error ? caught.message : String(caught), { cause: caught });
+  }
   /** The wire body (ProtocolErrorBody) — what a core or relay sends for this error. */
   toBody() {
     return this.data === void 0 ? { code: this.code, message: this.message, retryable: this.retryable } : { code: this.code, message: this.message, retryable: this.retryable, data: this.data };