@ai-matrx/desktop-protocol 0.17.1 → 0.17.3

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-Dj_B9wHj.cjs';
-export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as MlInstallPhase, A as MlInstallProgress, f as MlProgress, G as MlRuntimeState, I as MlServiceState, J as MlServiceStatus, K as MlStatusParams, N as MlStatusResult, P as ModelsInstallParams, Q as ModelsInstallResult, R as ModelsProgressEvent, U as ModelsStatusParams, V as ModelsStatusResult, X as ModelsTranscribeParams, M as ModelsTranscribeResult, Y as NAMED_SCHEMAS, Z as NamedSchemaId, c as OPS, _ as OpDescriptor, a as OpParams, b as OpResult, $ as OpSpec, a0 as PING_TEXT, a1 as PONG_TEXT, a2 as ProtocolErrorBody, a3 as RelayMsg, a4 as RequestMsg, a5 as ResponseMsg, a6 as SERVICES, a7 as SUBPROTOCOL, a8 as ServiceId, a9 as ServiceOpName, aa as ServiceOpSpec, ab as ServiceSpec, S as StreamMeta, ac as StreamMsg, ad as TranscriptSegment, T as TranscriptionModelId, ae as TranscriptionModelInfo, W as Welcome, af as closeRule, i as isDesktopProtocolError, ag as isTerminalClose } from './models-Dj_B9wHj.cjs';
+import { O as OpName } from './models-BiquRLLO.cjs';
+export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as MlInstallPhase, A as MlInstallProgress, f as MlProgress, G as MlRuntimeState, I as MlServiceState, J as MlServiceStatus, K as MlStatusParams, N as MlStatusResult, P as ModelsInstallParams, Q as ModelsInstallResult, R as ModelsProgressEvent, U as ModelsStatusParams, V as ModelsStatusResult, X as ModelsTranscribeParams, M as ModelsTranscribeResult, Y as NAMED_SCHEMAS, Z as NamedSchemaId, c as OPS, _ as OpDescriptor, a as OpParams, b as OpResult, $ as OpSpec, a0 as PING_TEXT, a1 as PONG_TEXT, a2 as ProtocolErrorBody, a3 as RelayMsg, a4 as RequestMsg, a5 as ResponseMsg, a6 as SERVICES, a7 as SUBPROTOCOL, a8 as ServiceId, a9 as ServiceOpName, aa as ServiceOpSpec, ab as ServiceSpec, S as StreamMeta, ac as StreamMsg, ad as TranscriptSegment, T as TranscriptionModelId, ae as TranscriptionModelInfo, W as Welcome, af as closeRule, i as isDesktopProtocolError, ag as isTerminalClose } from './models-BiquRLLO.cjs';
 export { BROADCAST_CID, DecodedFrame, FRAME_HEADER_BYTES, FRAME_STRUCT_FORMAT, FRAME_VERSION, FrameChannel, FrameChannelValue, FrameFlag, assertFrameHeader, connectionEndFrame, decodeFrame, encodeFrame, hasFlag, isConnectionEnd, readCid, stampCid } from './frame.cjs';
 
 /** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
@@ -19,10 +19,11 @@ declare const PROTOCOL_MAJOR: 1;
  *   1.5 — `coding.history.import_missing`: Claude Code history the platform lacks, imported by the
  *         `coding` Python service.
  *   1.6 — the `audio` capability: devices, record a clip to a WAV file, play a file.
+ *   1.7 — a window names its owning application and process (WindowInfo `app`, `pid`).
  */
-declare const PROTOCOL_MINOR: 6;
+declare const PROTOCOL_MINOR: 7;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.6";
+declare const PROTOCOL_VERSION: "1.7";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -209,8 +210,8 @@ declare const FsListParams: z.ZodObject<{
     page_token: z.ZodOptional<z.ZodString>;
     show_hidden: z.ZodDefault<z.ZodBoolean>;
     sort: z.ZodDefault<z.ZodEnum<{
-        kind: "kind";
         name: "name";
+        kind: "kind";
         size: "size";
         mtime: "mtime";
     }>>;
@@ -1861,6 +1862,8 @@ declare const WindowInfo: z.ZodObject<{
     y: z.ZodInt;
     width: z.ZodInt;
     height: z.ZodInt;
+    app: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodInt>;
 }, z.core.$strict>;
 type WindowInfo = z.output<typeof WindowInfo>;
 declare const WindowListParams: z.ZodObject<{
@@ -1876,6 +1879,8 @@ declare const WindowListResult: z.ZodObject<{
         y: z.ZodInt;
         width: z.ZodInt;
         height: z.ZodInt;
+        app: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>>;
     total: z.ZodInt;
     truncated: z.ZodBoolean;
@@ -1893,6 +1898,8 @@ declare const WindowFocusResult: z.ZodObject<{
         y: z.ZodInt;
         width: z.ZodInt;
         height: z.ZodInt;
+        app: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 type WindowFocusResult = z.output<typeof WindowFocusResult>;
@@ -1912,6 +1919,8 @@ declare const WindowMoveResult: z.ZodObject<{
         y: z.ZodInt;
         width: z.ZodInt;
         height: z.ZodInt;
+        app: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 type WindowMoveResult = z.output<typeof WindowMoveResult>;
@@ -2672,6 +2681,10 @@ declare const FIELDS_SINCE: {
     readonly "RelayCallResponse|1": {
         readonly protocol_version: "1.1";
     };
+    readonly WindowInfo: {
+        readonly app: "1.7";
+        readonly pid: "1.7";
+    };
 };
 type FieldsSincePath = keyof typeof FIELDS_SINCE;
 /**
@@ -2726,7 +2739,7 @@ declare function forPeer(op: OpName | null, part: "error", value: unknown, versi
 declare const VERSIONED_RESULT_OPS: readonly OpName[];
 
 /** SHA-256 of generated/desktop-protocol.schema.json: the contract both sides of a service connection were built from. */
-declare const CONTRACT_SHA256: "2cbf3c7589a30141305f6f0f38c4d4a32bf9ef2a890f7572d9c7bd15c398d4b9";
+declare const CONTRACT_SHA256: "5525674072a767340a8bd75a4e4b98c588577a866b4d381edeb377401729e14d";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { z } from 'zod';
-import { O as OpName } from './models-Dj_B9wHj.js';
-export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as MlInstallPhase, A as MlInstallProgress, f as MlProgress, G as MlRuntimeState, I as MlServiceState, J as MlServiceStatus, K as MlStatusParams, N as MlStatusResult, P as ModelsInstallParams, Q as ModelsInstallResult, R as ModelsProgressEvent, U as ModelsStatusParams, V as ModelsStatusResult, X as ModelsTranscribeParams, M as ModelsTranscribeResult, Y as NAMED_SCHEMAS, Z as NamedSchemaId, c as OPS, _ as OpDescriptor, a as OpParams, b as OpResult, $ as OpSpec, a0 as PING_TEXT, a1 as PONG_TEXT, a2 as ProtocolErrorBody, a3 as RelayMsg, a4 as RequestMsg, a5 as ResponseMsg, a6 as SERVICES, a7 as SUBPROTOCOL, a8 as ServiceId, a9 as ServiceOpName, aa as ServiceOpSpec, ab as ServiceSpec, S as StreamMeta, ac as StreamMsg, ad as TranscriptSegment, T as TranscriptionModelId, ae as TranscriptionModelInfo, W as Welcome, af as closeRule, i as isDesktopProtocolError, ag as isTerminalClose } from './models-Dj_B9wHj.js';
+import { O as OpName } from './models-BiquRLLO.js';
+export { B as BEARER_PREFIX, g as CLOSE_RULES, h as CancelMsg, j as ClientToCoreMsg, e as ClientType, k as CloseAction, l as CloseCode, m as CloseCodeValue, C as CloseOutcome, n as CloseRule, o as CoreToClientMsg, p as CreditMsg, D as DesktopProtocolError, d as EVENTS, q as EndMsg, E as EndReason, r as ErrorCode, s as ErrorCodeName, t as ErrorData, u as ErrorMsg, v as ErrorReason, w as ErrorReasonName, x as EventMsg, y as EventName, F as FsPatchEditFailure, H as HelloMsg, L as Limits, z as MlInstallPhase, A as MlInstallProgress, f as MlProgress, G as MlRuntimeState, I as MlServiceState, J as MlServiceStatus, K as MlStatusParams, N as MlStatusResult, P as ModelsInstallParams, Q as ModelsInstallResult, R as ModelsProgressEvent, U as ModelsStatusParams, V as ModelsStatusResult, X as ModelsTranscribeParams, M as ModelsTranscribeResult, Y as NAMED_SCHEMAS, Z as NamedSchemaId, c as OPS, _ as OpDescriptor, a as OpParams, b as OpResult, $ as OpSpec, a0 as PING_TEXT, a1 as PONG_TEXT, a2 as ProtocolErrorBody, a3 as RelayMsg, a4 as RequestMsg, a5 as ResponseMsg, a6 as SERVICES, a7 as SUBPROTOCOL, a8 as ServiceId, a9 as ServiceOpName, aa as ServiceOpSpec, ab as ServiceSpec, S as StreamMeta, ac as StreamMsg, ad as TranscriptSegment, T as TranscriptionModelId, ae as TranscriptionModelInfo, W as Welcome, af as closeRule, i as isDesktopProtocolError, ag as isTerminalClose } from './models-BiquRLLO.js';
 export { BROADCAST_CID, DecodedFrame, FRAME_HEADER_BYTES, FRAME_STRUCT_FORMAT, FRAME_VERSION, FrameChannel, FrameChannelValue, FrameFlag, assertFrameHeader, connectionEndFrame, decodeFrame, encodeFrame, hasFlag, isConnectionEnd, readCid, stampCid } from './frame.js';
 
 /** @ai-matrx/desktop-protocol — version and primitive schemas. Schema source: lint-enforced rules in scripts/check-schema-source.mjs. */
@@ -19,10 +19,11 @@ declare const PROTOCOL_MAJOR: 1;
  *   1.5 — `coding.history.import_missing`: Claude Code history the platform lacks, imported by the
  *         `coding` Python service.
  *   1.6 — the `audio` capability: devices, record a clip to a WAV file, play a file.
+ *   1.7 — a window names its owning application and process (WindowInfo `app`, `pid`).
  */
-declare const PROTOCOL_MINOR: 6;
+declare const PROTOCOL_MINOR: 7;
 /** This package's version as the wire spells it ("major.minor"): hello, welcome, relay status. */
-declare const PROTOCOL_VERSION: "1.6";
+declare const PROTOCOL_VERSION: "1.7";
 /** Internal building blocks — deliberately unnamed in $defs (inlined wherever used). */
 declare const u32: z.ZodInt;
 declare const nonNegInt: z.ZodInt;
@@ -209,8 +210,8 @@ declare const FsListParams: z.ZodObject<{
     page_token: z.ZodOptional<z.ZodString>;
     show_hidden: z.ZodDefault<z.ZodBoolean>;
     sort: z.ZodDefault<z.ZodEnum<{
-        kind: "kind";
         name: "name";
+        kind: "kind";
         size: "size";
         mtime: "mtime";
     }>>;
@@ -1861,6 +1862,8 @@ declare const WindowInfo: z.ZodObject<{
     y: z.ZodInt;
     width: z.ZodInt;
     height: z.ZodInt;
+    app: z.ZodOptional<z.ZodString>;
+    pid: z.ZodOptional<z.ZodInt>;
 }, z.core.$strict>;
 type WindowInfo = z.output<typeof WindowInfo>;
 declare const WindowListParams: z.ZodObject<{
@@ -1876,6 +1879,8 @@ declare const WindowListResult: z.ZodObject<{
         y: z.ZodInt;
         width: z.ZodInt;
         height: z.ZodInt;
+        app: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>>;
     total: z.ZodInt;
     truncated: z.ZodBoolean;
@@ -1893,6 +1898,8 @@ declare const WindowFocusResult: z.ZodObject<{
         y: z.ZodInt;
         width: z.ZodInt;
         height: z.ZodInt;
+        app: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 type WindowFocusResult = z.output<typeof WindowFocusResult>;
@@ -1912,6 +1919,8 @@ declare const WindowMoveResult: z.ZodObject<{
         y: z.ZodInt;
         width: z.ZodInt;
         height: z.ZodInt;
+        app: z.ZodOptional<z.ZodString>;
+        pid: z.ZodOptional<z.ZodInt>;
     }, z.core.$strict>;
 }, z.core.$strict>;
 type WindowMoveResult = z.output<typeof WindowMoveResult>;
@@ -2672,6 +2681,10 @@ declare const FIELDS_SINCE: {
     readonly "RelayCallResponse|1": {
         readonly protocol_version: "1.1";
     };
+    readonly WindowInfo: {
+        readonly app: "1.7";
+        readonly pid: "1.7";
+    };
 };
 type FieldsSincePath = keyof typeof FIELDS_SINCE;
 /**
@@ -2726,7 +2739,7 @@ declare function forPeer(op: OpName | null, part: "error", value: unknown, versi
 declare const VERSIONED_RESULT_OPS: readonly OpName[];
 
 /** SHA-256 of generated/desktop-protocol.schema.json: the contract both sides of a service connection were built from. */
-declare const CONTRACT_SHA256: "2cbf3c7589a30141305f6f0f38c4d4a32bf9ef2a890f7572d9c7bd15c398d4b9";
+declare const CONTRACT_SHA256: "5525674072a767340a8bd75a4e4b98c588577a866b4d381edeb377401729e14d";
 
 /**
  * The local tool catalog (SPEC §10): every tool a platform agent calls on a person's computer, the

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/schema/primitives.ts
 import { z } from "zod";
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 6;
+var PROTOCOL_MINOR = 7;
 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_-]+$/);
@@ -106,7 +106,7 @@ var ProtocolErrorBody = z2.strictObject({
 import { z as z3 } from "zod";
 
 // src/error.ts
-var DesktopProtocolError = class extends Error {
+var DesktopProtocolError = class _DesktopProtocolError extends Error {
   code;
   retryable;
   data;
@@ -117,6 +117,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 };
@@ -1080,7 +1097,15 @@ var WindowInfo = z18.strictObject({
   x: z18.int(),
   y: z18.int(),
   width: z18.int().min(0),
-  height: z18.int().min(0)
+  height: z18.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: z18.string().max(256).optional(),
+  /** The owning process id; absent when the OS does not say. Added in protocol 1.7. */
+  pid: z18.int().min(0).optional()
 });
 var WindowListParams = z18.strictObject({
   /** Case-insensitive substring of the window title. */
@@ -1797,7 +1822,8 @@ var FIELDS_SINCE = {
   FsPatchResult: { edits_applied: "1.1", edits_failed: "1.1" },
   "ProtocolErrorBody.data": { edits_failed: "1.1" },
   "RelayCallResponse|0": { protocol_version: "1.1" },
-  "RelayCallResponse|1": { protocol_version: "1.1" }
+  "RelayCallResponse|1": { protocol_version: "1.1" },
+  WindowInfo: { app: "1.7", pid: "1.7" }
 };
 var NULL_SINCE = {
   "RelayDeviceStatusEvent.since_ms": { since: "1.1", olderPeersGet: 0 }
@@ -1851,8 +1877,28 @@ function strip(value, fields, version) {
   return out ?? value;
 }
 var RESULT_PATH = /* @__PURE__ */ new Map([["fs.patch", "FsPatchResult"]]);
+var WINDOW_RESULTS = /* @__PURE__ */ new Map([
+  ["window.list", "windows"],
+  ["window.focus", "window"],
+  ["window.move", "window"]
+]);
+function stripWindows(value, key, version) {
+  if (value === null || typeof value !== "object") return value;
+  const body = value;
+  const inner = body[key];
+  if (inner === void 0) return value;
+  const fields = FIELDS_SINCE.WindowInfo;
+  if (Array.isArray(inner)) {
+    const next2 = inner.map((w) => strip(w, fields, version));
+    return next2.some((w, i) => w !== inner[i]) ? { ...body, [key]: next2 } : value;
+  }
+  const next = strip(inner, fields, version);
+  return next === inner ? value : { ...body, [key]: next };
+}
 function forPeer(op, part, value, version) {
   if (part === "result") {
+    const windowKey = op ? WINDOW_RESULTS.get(op) : void 0;
+    if (windowKey) return stripWindows(value, windowKey, version);
     const path = op ? RESULT_PATH.get(op) : void 0;
     return path ? strip(value, FIELDS_SINCE[path], version) : value;
   }
@@ -1868,10 +1914,10 @@ function forPeer(op, part, value, version) {
   }
   return data === body.data ? value : { ...body, data };
 }
-var VERSIONED_RESULT_OPS = [...RESULT_PATH.keys()];
+var VERSIONED_RESULT_OPS = [...RESULT_PATH.keys(), ...WINDOW_RESULTS.keys()];
 
 // src/contract.ts
-var CONTRACT_SHA256 = "2cbf3c7589a30141305f6f0f38c4d4a32bf9ef2a890f7572d9c7bd15c398d4b9";
+var CONTRACT_SHA256 = "5525674072a767340a8bd75a4e4b98c588577a866b4d381edeb377401729e14d";
 
 // src/close-policy.ts
 var CLOSE_RULES = {