zas-agent 0.6.2 → 0.6.3

package/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.3] - 2026-09-04
+
+### Fixed
+
+- The selected candidate pair is read from the transport, which names its
+  own pair on every engine. A transfer that connected and carried its whole
+  file could report `pair=none`, because the browser at the other end does
+  not mark a pair `nominated` on the controlled side. The empty field was
+  read as a missing pair and sent two rounds of diagnosis after a
+  connection that had been there all along.
+- A peer connection state of `failed` has to hold before the engine acts on
+  it. Chrome reports `failed` while it is still gathering and returns to
+  `connecting` in the same millisecond; acting on the first one killed a
+  receiver at 0.88 s with pairs still waiting to be tried. The settle window
+  is shorter than the ICE grace, so a connection that really is dead still
+  gives up sooner than it did before.
+
+### Added
+
+- The trace counts candidate pairs by check state just before the verdict:
+  `checks failed=24 in-progress=4`, or `checks none`. No pair selected could
+  not tell a run that formed no pairs from one that formed pairs and lost
+  every check, and those are different faults.
+- A candidate the peer refuses is traced as `ice apply rejected <type>
+  <ErrorName>`. The rejection used to be swallowed, so a refused candidate
+  looked exactly like one the network lost.
+
 ## [0.6.2] - 2026-09-04
 
 ### Added
@@ -205,7 +232,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.2...HEAD
+[Unreleased]: https://github.com/soke1556/zas-agent/compare/v0.6.3...HEAD
+[0.6.3]: https://github.com/soke1556/zas-agent/compare/v0.6.2...v0.6.3
 [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

package/dist/cli.js

@@ -854,6 +854,8 @@ function directFallbackCipherSize(size) {
 }
 var DIRECT_CONNECT_TIMEOUT_MS = 30 * 1e3;
 var DIRECT_STALL_GRACE_MS = 5 * 1e3;
+var DIRECT_CENSUS_WAIT_MS = 250;
+var DIRECT_CONN_FAILED_SETTLE_MS = 1500;
 var DIRECT_SIGNAL_WAIT_MS = 90 * 1e3;
 
 // src/shared/direct-engine.ts
@@ -1022,17 +1024,36 @@ function countTurnUrls(servers) {
 }
 function pairFromStats(stats) {
   let pair;
+  let selectedId;
   stats.forEach((s) => {
+    if (s.type === "transport" && typeof s.selectedCandidatePairId === "string") {
+      selectedId = s.selectedCandidatePairId;
+    }
     if (s.type === "candidate-pair" && s.state === "succeeded" && (s.nominated || s.selected)) {
       pair = s;
     }
   });
+  if (selectedId) {
+    const named = stats.get(selectedId);
+    if (named?.localCandidateId && named.remoteCandidateId) pair = named;
+  }
   if (!pair?.localCandidateId || !pair.remoteCandidateId) return void 0;
   const local = stats.get(pair.localCandidateId);
   const remote = stats.get(pair.remoteCandidateId);
   if (!local?.candidateType || !remote?.candidateType) return void 0;
   return { local: local.candidateType, remote: remote.candidateType };
 }
+function checkCensus(stats) {
+  const counts = /* @__PURE__ */ new Map();
+  stats.forEach((s) => {
+    if (s.type !== "candidate-pair") return;
+    const state = String(s.state ?? "?");
+    counts.set(state, (counts.get(state) ?? 0) + 1);
+  });
+  if (counts.size === 0) return "checks none";
+  const parts = [...counts].map(([state, n]) => `${state}=${n}`);
+  return `checks ${parts.join(" ")}`;
+}
 function pathOf(pair) {
   if (pair.local === "relay" || pair.remote === "relay") return "relay";
   return pair.local === "host" && pair.remote === "host" ? "lan" : "wan";
@@ -1059,6 +1080,7 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
   let phase = "connecting";
   let disconnectTimer;
   let restartTimer;
+  let connFailTimer;
   let stallState = "idle";
   const startedAt = Date.now();
   const diag = {
@@ -1086,7 +1108,20 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
   };
   const connState = () => String(pc.connectionState ?? "");
   pc.onconnectionstatechange = () => {
-    traceAdd(diag, `conn ${connState()}`);
+    const state = connState();
+    traceAdd(diag, `conn ${state}`);
+    if (state !== "failed") {
+      clearTimeout(connFailTimer);
+      connFailTimer = void 0;
+      return;
+    }
+    if (connFailTimer !== void 0) return;
+    connFailTimer = setTimeout(() => {
+      connFailTimer = void 0;
+      if (connState() !== "failed") return;
+      if (diag.msConnect !== void 0 && onStall) stalled();
+      else failWithCensus("ice_failed");
+    }, DIRECT_CONN_FAILED_SETTLE_MS);
   };
   let channel;
   pc.onicecandidateerror = (e) => {
@@ -1095,6 +1130,7 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
   };
   const cleanup = () => {
     clearTimeout(waitTimer);
+    clearTimeout(connFailTimer);
     clearTimeout(connectTimer);
     clearTimeout(disconnectTimer);
     clearTimeout(restartTimer);
@@ -1134,6 +1170,20 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
     }
     setPhase("failed");
   };
+  const failWithCensus = (reason) => {
+    if (phase === "done" || phase === "failed") return;
+    let reported = false;
+    const report2 = () => {
+      if (reported) return;
+      reported = true;
+      fail(reason);
+    };
+    const guard = setTimeout(report2, DIRECT_CENSUS_WAIT_MS);
+    void pc.getStats().then((stats) => traceAdd(diag, checkCensus(stats))).catch(() => void 0).then(() => {
+      clearTimeout(guard);
+      report2();
+    });
+  };
   const waitTimer = setTimeout(() => fail("peer_silent"), DIRECT_SIGNAL_WAIT_MS);
   let connectTimer;
   let heard = false;
@@ -1143,7 +1193,7 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
     clearTimeout(waitTimer);
     connectTimer = setTimeout(() => {
       const iceUp = pc.iceConnectionState === "connected" || pc.iceConnectionState === "completed";
-      fail(iceUp ? "channel_never_opened" : "connect_timeout");
+      failWithCensus(iceUp ? "channel_never_opened" : "connect_timeout");
     }, DIRECT_CONNECT_TIMEOUT_MS);
   };
   let onStall;
@@ -1153,7 +1203,7 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
     clearTimeout(disconnectTimer);
     if (stallState === "restarting") return;
     if (diag.msConnect === void 0 || !onStall) {
-      fail("disconnected");
+      failWithCensus(diag.msConnect === void 0 ? "ice_failed" : "disconnected");
       return;
     }
     stallState = "restarting";
@@ -1168,7 +1218,7 @@ function session(ice, onPhase, onDiag, iceTransportPolicy = "all") {
     traceAdd(diag, `ice ${String(s ?? "")}`);
     if (s === "failed") {
       if (diag.msConnect !== void 0 && onStall) stalled();
-      else fail("ice_failed");
+      else failWithCensus("ice_failed");
     }
     if (s === "disconnected" && stallState === "idle") {
       stallState = "grace";
@@ -1231,8 +1281,14 @@ function signalPlumbing(pc, send, onSendError, diag) {
       generation: localGeneration
     }).catch(onSendError);
   };
+  let applyRejects = 0;
   const apply = (candidate) => {
-    void pc.addIceCandidate(candidate ?? void 0).catch(() => void 0);
+    void pc.addIceCandidate(candidate ?? void 0).catch((e) => {
+      if (applyRejects >= 3) return;
+      applyRejects++;
+      const name = e?.name || "Error";
+      traceAdd(diag, `ice apply rejected ${candidate ? candType(candidate) : "end"} ${name}`);
+    });
   };
   const applyIce = (candidate, generation) => {
     countCand(diag, "remote", candidate);
@@ -3928,7 +3984,7 @@ async function report(client, properties) {
 
 // src/server.ts
 function agentVersion() {
-  return true ? "0.6.2" : "0.0.0-dev";
+  return true ? "0.6.3" : "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.2",
+  "version": "0.6.3",
   "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",