@ai-matrx/desktop-protocol 0.21.79 → 0.21.81

package/dist/client.cjs

@@ -144,7 +144,7 @@ var import_zod2 = require("zod");
 var import_zod = require("zod");
 var import_uuid = require("@ai-matrx/kit/uuid");
 var PROTOCOL_MAJOR = 1;
-var PROTOCOL_MINOR = 77;
+var PROTOCOL_MINOR = 78;
 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_-]+$/);
@@ -3564,7 +3564,9 @@ var ColdChat = import_zod31.z.strictObject({
   /** It can be shown in its window (started in the desktop app). */
   openable: import_zod31.z.boolean(),
   /** How its window was decided, or why it can't be opened. */
-  how: import_zod31.z.string().max(200).nullable()
+  how: import_zod31.z.string().max(200).nullable(),
+  /** 1.78: the person hid this chat from Matrx's lists (our Hide, as on ChatRow.hidden); absent = shown. */
+  hidden: import_zod31.z.boolean().optional()
 });
 var AppsChatsColdParams = import_zod31.z.strictObject({ app_key: AppKey });
 var AppsChatsColdResult = import_zod31.z.strictObject({
@@ -3647,12 +3649,30 @@ var SpendChat = import_zod31.z.strictObject({
   repo: import_zod31.z.string().max(200).nullable(),
   window: import_zod31.z.string().max(64).nullable(),
   spend: SpendScopes,
-  helpers: nonNegInt
+  helpers: nonNegInt,
+  /** 1.78: the person hid this chat from Matrx's lists (our Hide, as on ChatRow.hidden); absent = shown. */
+  hidden: import_zod31.z.boolean().optional()
 });
 var SpendHelper = import_zod31.z.strictObject({ model: import_zod31.z.string().max(120), steps: nonNegInt, over_steps: import_zod31.z.boolean(), description: import_zod31.z.string().max(400) });
-var SpendLive = import_zod31.z.strictObject({ id: ChatId, title: import_zod31.z.string().max(1e3), window: import_zod31.z.string().max(64).nullable(), helpers: import_zod31.z.array(SpendHelper).max(200) });
+var SpendLive = import_zod31.z.strictObject({
+  id: ChatId,
+  title: import_zod31.z.string().max(1e3),
+  window: import_zod31.z.string().max(64).nullable(),
+  helpers: import_zod31.z.array(SpendHelper).max(200),
+  /** 1.78: the person hid this chat from Matrx's lists (our Hide, as on ChatRow.hidden); absent = shown. */
+  hidden: import_zod31.z.boolean().optional()
+});
 var SpendIdleScope = import_zod31.z.strictObject({ count: nonNegInt, tokens: nonNegInt, cost: import_zod31.z.number(), avoidable: import_zod31.z.number() });
-var SpendIdle = import_zod31.z.strictObject({ id: ChatId, chat: import_zod31.z.string().max(1e3), who: import_zod31.z.string().max(400), today: SpendIdleScope, week: SpendIdleScope, last_ms: epochMs });
+var SpendIdle = import_zod31.z.strictObject({
+  id: ChatId,
+  chat: import_zod31.z.string().max(1e3),
+  who: import_zod31.z.string().max(400),
+  today: SpendIdleScope,
+  week: SpendIdleScope,
+  last_ms: epochMs,
+  /** 1.78: the person hid this chat from Matrx's lists (our Hide, as on ChatRow.hidden); absent = shown. */
+  hidden: import_zod31.z.boolean().optional()
+});
 var SpendStart = import_zod31.z.strictObject({ repo: import_zod31.z.string().max(200), count: nonNegInt, median: nonNegInt, latest: import_zod31.z.array(nonNegInt).max(20), alarm: import_zod31.z.string().max(400).nullable() });
 var SpendDay = import_zod31.z.strictObject({ date: import_zod31.z.string().regex(/^\d{4}-\d{2}-\d{2}$/), main: import_zod31.z.number(), helpers: import_zod31.z.number() });
 var AppsSpendParams = import_zod31.z.strictObject({ app_key: AppKey });
@@ -5130,6 +5150,9 @@ var NESTED_RESULTS = /* @__PURE__ */ new Map([
   ["apps.projects.unfile", [["chat", "ChatRow"]]],
   ["apps.projects.move", [["chat", "ChatRow"]]],
   ["apps.chats.star", [["chat", "ChatRow"]]],
+  // 1.78: our Hide on the cold and spend rows.
+  ["apps.chats.cold", [["waiting", "ColdChat"], ["recently_cold", "ColdChat"]]],
+  ["apps.spend", [["chats", "SpendChat"], ["live", "SpendLive"], ["idle", "SpendIdle"]]],
   ["apps.chats.place", [["chat", "ChatRow"]]],
   ["apps.accounts.usage", [["accounts", "AccountUsage"]]],
   ["resources.snapshot", [["disks", "ResourcesDisk"]]],
@@ -5206,6 +5229,7 @@ function createDesktopClient(options) {
   const makeSocket = options.webSocket ?? defaultWebSocket();
   const heartbeatMs = options.heartbeatMs ?? 25e3;
   const requestTimeoutMs = options.requestTimeoutMs ?? 7e4;
+  const firstFrameMs = options.firstFrameMs ?? requestTimeoutMs;
   const protocolVersion = options.protocolVersion ?? `${PROTOCOL_MAJOR}.${PROTOCOL_MINOR}`;
   const backoff = (0, import_realtime.createBackoff)({ ...options.backoff, now: timers.now });
   const diagnose = options.onDiagnostic ?? ((d) => {
@@ -5243,6 +5267,7 @@ function createDesktopClient(options) {
   let probeTimer = null;
   let lastHeardAt = 0;
   let heardCount = 0;
+  let pongs = 0;
   let closedByUser = false;
   const newId = (prefix) => `${prefix}${(++nextId).toString(36)}`;
   function setState(patch) {
@@ -5290,6 +5315,7 @@ function createDesktopClient(options) {
     ws.onopen = () => {
       if (generation !== socketGeneration) return;
       lastHeardAt = timers.now();
+      pongs = 0;
       helloId = newId("h");
       setState({ status: "handshaking" });
       sendJson({ type: "hello", id: helloId, protocolVersion, clientType: options.clientType, clientVersion: options.clientVersion });
@@ -5305,6 +5331,8 @@ function createDesktopClient(options) {
     };
     ws.onclose = (event) => {
       if (generation !== socketGeneration) return;
+      const ev = event;
+      reportClose(ev.code, ev.reason ?? "", ev.wasClean ?? false);
       onSocketGone(generation, event.code, null);
     };
   }
@@ -5316,6 +5344,7 @@ function createDesktopClient(options) {
       const silentMs = timers.now() - lastHeardAt;
       if (silentMs >= heartbeatMs * 2) {
         diagnose({ kind: "heartbeat_timeout", silentMs });
+        reportClose(null, "heartbeat timeout", false);
         const dead = socket;
         onSocketGone(generation, null, new DesktopProtocolError("TIMEOUT", "Connection went silent", { retryable: true }));
         try {
@@ -5328,6 +5357,9 @@ function createDesktopClient(options) {
       scheduleHeartbeat(generation);
     }, heartbeatMs);
   }
+  function reportClose(code, reason, wasClean) {
+    diagnose({ kind: "socket_closed", code, reason: reason.slice(0, 120), wasClean, idleSinceLastRxMs: Math.max(0, timers.now() - lastHeardAt), pongs });
+  }
   function onSocketGone(generation, code, error) {
     if (generation !== socketGeneration) return;
     socketGeneration++;
@@ -5416,7 +5448,10 @@ function createDesktopClient(options) {
   }
   function onMessage(data) {
     if (typeof data === "string") {
-      if (data === PONG_TEXT) return;
+      if (data === PONG_TEXT) {
+        pongs++;
+        return;
+      }
       let json;
       try {
         json = JSON.parse(data);
@@ -5447,6 +5482,10 @@ function createDesktopClient(options) {
     onFrame(frame.header, frame.payload);
   }
   function onEnvelope(msg) {
+    if (msg.type !== "event") {
+      const heard = streams.get(msg.id);
+      if (heard) clearFirstFrame(heard);
+    }
     switch (msg.type) {
       case "response": {
         if (msg.id === helloId) return onWelcome(msg.result);
@@ -5588,6 +5627,7 @@ function createDesktopClient(options) {
       diagnose({ kind: "unknown_stream", sid: header.sid });
       return;
     }
+    clearFirstFrame(s);
     const isData = header.channel === FrameChannel.DATA || header.channel === FrameChannel.STDERR;
     const isSnapshot = header.channel === FrameChannel.SNAPSHOT;
     if (!isData && !isSnapshot) {
@@ -5633,8 +5673,29 @@ function createDesktopClient(options) {
       socket.send(encodeFrame({ version: FRAME_VERSION, flags: 0, channel: FrameChannel.STDIN, cid: 0, sid: s.sid, seq: s.sendSeq }, chunk));
     }
   }
+  function clearFirstFrame(s) {
+    if (s.firstFrameTimer === null) return;
+    timers.clearTimeout(s.firstFrameTimer);
+    s.firstFrameTimer = null;
+  }
+  function armFirstFrame(s) {
+    clearFirstFrame(s);
+    const waitMs = s.options.firstFrameMs ?? firstFrameMs;
+    const id = s.id;
+    s.firstFrameTimer = timers.setTimeout(() => {
+      s.firstFrameTimer = null;
+      if (s.ended || s.id !== id) return;
+      diagnose({ kind: "first_frame_timeout", id, op: s.op, waitedMs: waitMs });
+      streams.delete(id);
+      if (s.sid !== null) bySid.delete(s.sid);
+      abandon(id);
+      endStream(s, null, new DesktopProtocolError("TIMEOUT", `${s.op}: no answer within ${waitMs} ms`, { retryable: true }));
+      wake();
+    }, waitMs);
+  }
   function endStream(s, reason, error) {
     if (s.ended) return;
+    clearFirstFrame(s);
     s.ended = true;
     s.sendQueue = [];
     if (!s.resultSettled) {
@@ -5657,7 +5718,7 @@ function createDesktopClient(options) {
     const params = { resource_id: s.resourceId, mode: s.options.mode ?? "control" };
     if (s.lastSeq > 0) params.since_seq = s.lastSeq;
     if (s.options.windowBytes !== void 0) params.window_bytes = s.options.windowBytes;
-    sendJson({ id, type: "request", cap: "session", op: "attach", params });
+    if (sendJson({ id, type: "request", cap: "session", op: "attach", params })) armFirstFrame(s);
   }
   function safeCall(where, fn) {
     try {
@@ -5766,7 +5827,8 @@ function createDesktopClient(options) {
       resolveDone,
       rejectDone,
       ended: false,
-      reattaching: false
+      reattaching: false,
+      firstFrameTimer: null
     };
     const start = async () => {
       let welcome;
@@ -5785,7 +5847,9 @@ function createDesktopClient(options) {
       if (!sendJson({ id: s.id, type: "request", ...capOf(op), params: wire })) {
         streams.delete(s.id);
         endStream(s, null, new DesktopProtocolError("DEVICE_OFFLINE", "Connection lost", { retryable: true }));
+        return;
       }
+      armFirstFrame(s);
     };
     void start();
     opts.signal?.addEventListener("abort", () => handle.cancel(), { once: true });
@@ -5861,6 +5925,7 @@ function createDesktopClient(options) {
       if (heardCount > heardBefore) return;
       const silentMs = timers.now() - lastHeardAt;
       diagnose({ kind: "heartbeat_timeout", silentMs });
+      reportClose(null, "wake probe timeout", false);
       const dead = socket;
       onSocketGone(generation, null, new DesktopProtocolError("TIMEOUT", "Connection went silent", { retryable: true }));
       try {