@ai-matrx/desktop-protocol 0.17.1 → 0.17.3

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.17.3
+### (protocol 1.7)
+
+- **A window names the application that owns it.** `WindowInfo` gains `app` (the owning
+  application's display name, absent when the OS does not say) and `pid` (absent when unknown), on
+  `window.list`, `window.focus` and `window.move`. Both are optional on read (an older app omits
+  them) and `forPeer` strips them for a peer that negotiated below 1.7. Guard:
+  `src/versioning.test.ts` ("a window names its app from 1.7 …").
+
+Consumer action: none (new optional fields; Matrx 2 core and its Windows screen read them).
+
+## 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
@@ -14,6 +31,11 @@ Consumer action: none.
   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 …").
@@ -295,3 +317,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 };
@@ -126,7 +143,7 @@ var import_zod2 = require("zod");
 // src/schema/primitives.ts
 var import_zod = require("zod");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 6;
+var PROTOCOL_MINOR = 7;
 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_-]+$/);
@@ -944,7 +961,15 @@ var WindowInfo = import_zod15.z.strictObject({
   x: import_zod15.z.int(),
   y: import_zod15.z.int(),
   width: import_zod15.z.int().min(0),
-  height: import_zod15.z.int().min(0)
+  height: import_zod15.z.int().min(0),
+  /**
+   * The application that owns the window, by the name the OS shows people; absent when the OS does
+   * not say. Optional (never null, the schema rule) because it was added in protocol 1.7: an older
+   * app's answer has no such field (FIELDS_SINCE).
+   */
+  app: import_zod15.z.string().max(256).optional(),
+  /** The owning process id; absent when the OS does not say. Added in protocol 1.7. */
+  pid: import_zod15.z.int().min(0).optional()
 });
 var WindowListParams = import_zod15.z.strictObject({
   /** Case-insensitive substring of the window title. */