zas-agent 0.6.1 → 0.6.2

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.2] - 2026-09-04
+
+### Added
+
+- The trace records the peer connection state, not only the ICE state.
+  ICE `connected` means a candidate pair answered; the peer connection
+  reaches `connected` only once DTLS completes. A session that holds an ICE
+  path and sends nothing over it used to look the same as one that never
+  found a path at all.
+- A failure that had a working ICE pair is now `channel_never_opened`, not
+  `connect_timeout`. Same clock, different fault: one is the candidate hunt,
+  the other is the handshake above it.
+- The verdict line carries the peer connection state and the data channel's
+  own state, so a stalled DTLS handshake and a stalled SCTP association can
+  be told apart from one line.
+- The selected candidate pair is read when ICE connects, not only when the
+  data channel opens. A run that connected and then went quiet reported
+  `pair=none` and looked as if it had never selected one.
+- `onicecandidateerror` is traced, by URL shape and error code only. A
+  gather that ends with no relay candidate now says whether the allocation
+  was refused or never answered.
+
 ## [0.6.1] - 2026-09-04
 
 ### Added
@@ -183,7 +205,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   two separate identities that cannot read each other's keys.
 - Install snippets for Claude Code and Codex, printed by `zas-agent pair`.
 
-[Unreleased]: https://github.com/soke1556/zas-agent/compare/v0.6.1...HEAD
+[Unreleased]: https://github.com/soke1556/zas-agent/compare/v0.6.2...HEAD
+[0.6.2]: https://github.com/soke1556/zas-agent/compare/v0.6.1...v0.6.2
 [0.6.1]: https://github.com/soke1556/zas-agent/compare/v0.6.0...v0.6.1
 [0.6.0]: https://github.com/soke1556/zas-agent/compare/v0.5.1...v0.6.0
 [0.5.1]: https://github.com/soke1556/zas-agent/compare/v0.5.0...v0.5.1

package/dist/cli.js

@@ -969,14 +969,17 @@ function traceAdd(diag, line) {
   const at = t0 === void 0 ? 0 : (Date.now() - t0) / 1e3;
   diag.trace.push(`${at.toFixed(2)} ${line}`);
 }
+function urlShape(url) {
+  const scheme = /^(stuns?|turns?):/i.exec(url)?.[1]?.toLowerCase() ?? "other";
+  const transport = /[?&]transport=(\w+)/i.exec(url)?.[1]?.toLowerCase();
+  return transport ? `${scheme}/${transport}` : scheme;
+}
 function iceShapes(servers) {
   const seen = /* @__PURE__ */ new Map();
   for (const server of servers ?? []) {
     const urls = typeof server.urls === "string" ? [server.urls] : server.urls;
     for (const url of urls ?? []) {
-      const scheme = /^(stuns?|turns?):/i.exec(url)?.[1]?.toLowerCase() ?? "other";
-      const transport = /[?&]transport=(\w+)/i.exec(url)?.[1]?.toLowerCase();
-      const shape = transport ? `${scheme}/${transport}` : scheme;
+      const shape = urlShape(url);
       seen.set(shape, (seen.get(shape) ?? 0) + 1);
     }
   }
@@ -1081,6 +1084,15 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
   pc.onicegatheringstatechange = () => {
     traceAdd(diag, `gather ${String(pc.iceGatheringState ?? "")}`);
   };
+  const connState = () => String(pc.connectionState ?? "");
+  pc.onconnectionstatechange = () => {
+    traceAdd(diag, `conn ${connState()}`);
+  };
+  let channel;
+  pc.onicecandidateerror = (e) => {
+    const err = e;
+    traceAdd(diag, `ice error ${err.url ? urlShape(err.url) : "?"} code=${err.errorCode ?? "?"}`);
+  };
   const cleanup = () => {
     clearTimeout(waitTimer);
     clearTimeout(connectTimer);
@@ -1089,6 +1101,8 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
     pc.onicecandidate = null;
     pc.oniceconnectionstatechange = null;
     pc.onicegatheringstatechange = null;
+    pc.onicecandidateerror = null;
+    pc.onconnectionstatechange = null;
     pc.close();
   };
   const setPhase = (p) => {
@@ -1100,7 +1114,10 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
       diag.gatherState = String(pc.iceGatheringState ?? "");
       diag.hadRemoteDesc = hasRemoteDescription(pc);
       diag.turnUrlsConfigured = countTurnUrls(pc.getConfiguration().iceServers);
-      traceAdd(diag, `${p}${diag.reason ? ` ${diag.reason}` : ""} ice=${diag.iceState} gather=${diag.gatherState}`);
+      traceAdd(
+        diag,
+        `${p}${diag.reason ? ` ${diag.reason}` : ""} ice=${diag.iceState} gather=${diag.gatherState} conn=${connState()} chan=${channel === void 0 ? "-" : String(channel.readyState ?? "")}`
+      );
       onDiag?.(diag);
       onPhase(p);
       cleanup();
@@ -1124,7 +1141,10 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
     if (heard) return;
     heard = true;
     clearTimeout(waitTimer);
-    connectTimer = setTimeout(() => fail("connect_timeout"), DIRECT_CONNECT_TIMEOUT_MS);
+    connectTimer = setTimeout(() => {
+      const iceUp = pc.iceConnectionState === "connected" || pc.iceConnectionState === "completed";
+      fail(iceUp ? "channel_never_opened" : "connect_timeout");
+    }, DIRECT_CONNECT_TIMEOUT_MS);
   };
   let onStall;
   let stallWindowMs = DIRECT_CONNECT_TIMEOUT_MS;
@@ -1158,6 +1178,13 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
       clearTimeout(disconnectTimer);
       clearTimeout(restartTimer);
       stallState = "idle";
+      void pc.getStats().then((stats) => {
+        const pair = pairFromStats(stats);
+        if (!pair || diag.pairLocal) return;
+        diag.pairLocal = pair.local;
+        diag.pairRemote = pair.remote;
+        traceAdd(diag, `pair ${pair.local}/${pair.remote}`);
+      }).catch(() => void 0);
     }
   };
   return {
@@ -1176,6 +1203,7 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
       }
     },
     isTerminal: () => phase === "done" || phase === "failed",
+    setChannel: (dc) => void (channel = dc),
     setStall: (fn, windowMs) => {
       onStall = fn;
       stallWindowMs = windowMs;
@@ -1267,6 +1295,7 @@ function startSender(opts) {
     })().catch((e) => s.fail("signaling", e));
   }, DIRECT_CONNECT_TIMEOUT_MS);
   const dc = pc.createDataChannel("zas-direct", { ordered: true });
+  s.setChannel(dc);
   dc.binaryType = "arraybuffer";
   dc.bufferedAmountLowThreshold = DIRECT_BUFFERED_HIGH / 8;
   const waitLow = () => new Promise((resolve2) => {
@@ -1415,6 +1444,7 @@ function startReceiver(opts) {
   let finished = false;
   pc.ondatachannel = (e) => {
     dc = e.channel;
+    s.setChannel(dc);
     dc.binaryType = "arraybuffer";
     dc.onopen = () => {
       s.connected();
@@ -3898,7 +3928,7 @@ async function report(client, properties) {
 
 // src/server.ts
 function agentVersion() {
-  return true ? "0.6.1" : "0.0.0-dev";
+  return true ? "0.6.2" : "0.0.0-dev";
 }
 var AGENT_CUE = " The owner sees every item this agent sends with the >_ agent mark and this agent's name, on every device.";
 var PAIR_ANNOUNCE_MS = 15e3;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zas-agent",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "MCP server that lets a coding agent send files and notes into your Zas channels, and send or receive files live through Directo.",
   "type": "module",
   "license": "MIT",