u1s1-cli 1.14.1 → 1.14.2

package/dist/device-auth.d.ts

@@ -54,6 +54,22 @@ interface SigningProxy {
 /** Attach a fresh (self-healing) attestation header to an outbound proxy request. */
 export declare function attachAttestationHeader(holder: AttestationHolder, headers: Headers): Promise<void>;
 export type ClientSurface = "terminal" | "web" | "desktop" | "cloud";
+/** What a failed gateway fetch looked like at the socket level; never carries request content. */
+export interface GatewayFetchFailure {
+    /** Node/undici error code such as ECONNRESET or UND_ERR_CONNECT_TIMEOUT; "unknown" when absent. */
+    code: string;
+    /** One-line message for the user and the retry classifier, e.g. "fetch failed (ECONNRESET: read ECONNRESET)". */
+    detail: string;
+}
+/**
+ * undici reports every transport failure as a bare "fetch failed" and puts the
+ * real reason (reset, DNS, TLS, connect timeout) in `cause`, sometimes as an
+ * AggregateError from happy eyeballs. Keep the original message first so the
+ * agent's retry patterns still match.
+ */
+export declare function describeFetchFailure(error: unknown): GatewayFetchFailure;
+/** One listener per process (telemetry); failures are reported only when the local caller is still waiting. */
+export declare function onGatewayFetchFailure(listener: ((failure: GatewayFetchFailure) => void) | undefined): void;
 /**
  * pi accepts static provider headers only. Keep it behind a loopback proxy that
  * replaces the local bearer credential with a fresh DPoP proof per request.

package/dist/device-auth.js

@@ -209,6 +209,36 @@ function clientSurface(fallback) {
     }
     return process.versions.electron ? "desktop" : fallback;
 }
+/**
+ * undici reports every transport failure as a bare "fetch failed" and puts the
+ * real reason (reset, DNS, TLS, connect timeout) in `cause`, sometimes as an
+ * AggregateError from happy eyeballs. Keep the original message first so the
+ * agent's retry patterns still match.
+ */
+export function describeFetchFailure(error) {
+    const message = error instanceof Error ? error.message : "signing proxy failed";
+    let cause = error instanceof Error ? error.cause : undefined;
+    if (cause instanceof AggregateError && cause.errors.length)
+        cause = cause.errors[0];
+    const causeRecord = typeof cause === "object" && cause !== null ? cause : {};
+    const code = typeof causeRecord.code === "string" && causeRecord.code
+        ? causeRecord.code
+        : typeof error?.code === "string"
+            ? error.code
+            : "unknown";
+    const causeMessage = typeof causeRecord.message === "string" ? causeRecord.message.split("\n")[0].slice(0, 200) : "";
+    if (!causeMessage && code === "unknown")
+        return { code, detail: message };
+    const reason = causeMessage && !causeMessage.includes(code) && code !== "unknown"
+        ? `${code}: ${causeMessage}`
+        : causeMessage || code;
+    return { code, detail: `${message} (${reason})` };
+}
+let gatewayFetchFailureListener;
+/** One listener per process (telemetry); failures are reported only when the local caller is still waiting. */
+export function onGatewayFetchFailure(listener) {
+    gatewayFetchFailureListener = listener;
+}
 /**
  * pi accepts static provider headers only. Keep it behind a loopback proxy that
  * replaces the local bearer credential with a fresh DPoP proof per request.
@@ -289,7 +319,14 @@ export async function ensureSigningProxy(cfg, fallbackClient = "terminal", attes
             res.writeHead(502, { "content-type": "application/json" });
             // 说明放前面给用户看;原始英文错误保留在括号里,pi 的重试分类正则
             // (fetch failed / timeout 等)和排查都还认得
-            const raw = error instanceof Error ? error.message : "signing proxy failed";
+            const failure = describeFetchFailure(error);
+            try {
+                gatewayFetchFailureListener?.(failure);
+            }
+            catch {
+                // Diagnostics must never change the response the agent sees.
+            }
+            const raw = failure.detail;
             const message = tr(`连不上 u1s1 服务器,检查一下网络?(${raw})`, `Can't reach the u1s1 server. Check your network? (${raw})`);
             res.end(JSON.stringify({ error: { message } }));
         }

package/dist/index.js

@@ -10,7 +10,7 @@ import { ensureSearchTools } from "./search-tools.js";
 import { ensureUsableShell } from "./shell-doctor.js";
 import { applyBrandUi, setAnnouncement, setUpdateNotice } from "./style.js";
 import { AccessDeniedError, AuthError, fetchModels, loadCustomEndpoints, readJsonResponseCapped } from "./api.js";
-import { ensureSigningProxy } from "./device-auth.js";
+import { ensureSigningProxy, onGatewayFetchFailure } from "./device-auth.js";
 import { installChildEnvGuard } from "./secret-env.js";
 import { deployHintText, markNudge, shouldShowDeployHint } from "./nudges.js";
 import { createGatewayTelemetry } from "./telemetry.js";
@@ -282,6 +282,8 @@ async function runAgent(cfg, args) {
     let firstTaskDoneSent = false;
     let sessionEndSent = false;
     telemetry.track("session_start", { surface: "terminal" });
+    // 「连不上 u1s1 服务器」只在用户本机可见;记下底层错误码,网络恢复后随批次上报
+    onGatewayFetchFailure((failure) => telemetry.track("gateway_unreachable", { code: failure.code, surface: "terminal" }));
     const trackSessionEnd = () => {
         if (sessionEndSent)
             return;

package/dist/telemetry.d.ts

@@ -1,14 +1,14 @@
 import { type CliConfig } from "./config.js";
 /**
  * 客户端事件上报(运营清单 C1):只报「会话开始/结束、首次工具成功、首次任务
- * 完成、部署完成」几个节点,不采任何内容。事件先在内存排队,每 30 秒或退出时
+ * 完成、部署完成、连不上网关(只带错误码)」几个节点,不采任何内容。事件先在内存排队,每 30 秒或退出时
  * 批量 POST /v1/telemetry(每批最多 20 条),失败静默丢弃,绝不阻塞界面、
  * 绝不拖慢退出(退出冲刷最多等 1 秒)。
  *
  * 关闭方式:环境变量 U1S1_TELEMETRY=0,或 ~/.u1s1/agent/settings.json 里
  * "telemetry": false。关闭后 track 直接丢,不打印任何东西。
  */
-export type TelemetryEventName = "session_start" | "session_end" | "first_tool_success" | "first_task_done" | "deploy_done";
+export type TelemetryEventName = "session_start" | "session_end" | "first_tool_success" | "first_task_done" | "deploy_done" | "gateway_unreachable";
 export interface TelemetryEvent {
     name: TelemetryEventName;
     /** epoch ms */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "u1s1-cli",
-  "version": "1.14.1",
+  "version": "1.14.2",
   "description": "u1s1 — 有一说一,最省心的 AI 编程搭子。终端里用中文说需求,AI 帮你读文件、改代码、跑命令。",
   "type": "module",
   "bin": {