@clawos-dev/clawd 0.2.583 → 0.2.584

package/dist/cli.cjs

@@ -53313,6 +53313,23 @@ function stringValue(value) {
   return typeof value === "string" && value.length > 0 ? value : void 0;
 }
 
+// src/tools/first-byte.ts
+var VISIBLE = /* @__PURE__ */ new Set(["thinking", "tool_call", "text"]);
+function createFirstByteClock(now = Date.now) {
+  let at3 = null;
+  return {
+    reset() {
+      at3 = null;
+    },
+    see(events) {
+      if (at3 === null && events.some((e) => VISIBLE.has(e.kind))) at3 = now();
+    },
+    afterFirstByteMs() {
+      return at3 === null ? void 0 : Math.max(0, Math.round(now() - at3));
+    }
+  };
+}
+
 // src/tools/codex-app-server-params.ts
 function resolveApprovalPolicy(ctx) {
   if (ctx.personaMode === "owner" || ctx.personaMode === "guest") return "never";
@@ -53448,6 +53465,7 @@ function driveCodexThread(opts) {
   let threadId = ctx.toolSessionId;
   let turnId;
   let turnOpen = false;
+  const firstByte = createFirstByteClock(opts.now);
   const approvalIds = /* @__PURE__ */ new Map();
   const subagents = new CodexSubagentTracker();
   const effort = ctx.effort;
@@ -53479,10 +53497,13 @@ function driveCodexThread(opts) {
         ...subagents.handleParentNotification(method, params),
         ...translateNotification(method, params)
       ] : [];
-      if (events.length) sink.pushEvents(events);
+      if (events.length) {
+        if (turnOpen) firstByte.see(events);
+        sink.pushEvents(events);
+      }
       if (route === "foreground" && method === "turn/completed") {
         turnOpen = false;
-        opts.onTurnCompleted?.(turnOutcomeOf(params));
+        opts.onTurnCompleted?.(turnOutcomeOf(params), firstByte.afterFirstByteMs());
       }
     },
     onServerRequest: (id, method, params) => {
@@ -53531,6 +53552,7 @@ function driveCodexThread(opts) {
           const opened = !turnOpen;
           if (opened) {
             turnOpen = true;
+            firstByte.reset();
             opts.onTurnStarting?.();
           }
           void client.request("turn/start", {
@@ -53547,7 +53569,7 @@ function driveCodexThread(opts) {
             ]);
             if (!opened) return;
             turnOpen = false;
-            opts.onTurnCompleted?.("failure");
+            opts.onTurnCompleted?.("failure", firstByte.afterFirstByteMs());
           });
         }
       });
@@ -64007,7 +64029,7 @@ function openHttpLineStream(opts) {
     if (closed || !sessionId) return;
     const url = gatewayUrl + GATEWAY_ROUTES.sessionMirror(personaId2, sessionId);
     try {
-      const res = await fetchImpl(url, { method: "POST", headers, body: turn ? JSON.stringify({ turn: { outcome: turn.outcome } }) : "" });
+      const res = await fetchImpl(url, { method: "POST", headers, body: turn ? JSON.stringify({ turn: { outcome: turn.outcome, ...turn.afterFirstByteMs !== void 0 ? { afterFirstByteMs: turn.afterFirstByteMs } : {} } }) : "" });
       if (!res.ok) logger?.warn("cloud session mirror failed", { status: res.status });
     } catch (e) {
       if (!closed) logger?.warn("cloud session mirror error", { message: e.message });
@@ -64226,7 +64248,9 @@ function createCloudCodexSession(ctx, sink, deps) {
     kill: () => stream.close(),
     // 云 persona 运行看板（design 2026-09-23-cloud-persona-metrics §3.7）：提问那一行带「一轮开始」头，轮末镜像顺带报这一轮的结果
     onTurnStarting: () => channel?.markNextLineTurnStart(),
-    onTurnCompleted: (outcome) => void channel?.mirror({ outcome })
+    // 轮末镜像带上这一轮的结果与首字节（design 2026-09-23-cloud-persona-metrics §3.7）
+    onTurnCompleted: (outcome, afterFirstByteMs) => void channel?.mirror({ outcome, ...afterFirstByteMs !== void 0 ? { afterFirstByteMs } : {} }),
+    now: deps.now
   });
   if (!personaId2) {
     queueMicrotask(() => {
@@ -64563,6 +64587,7 @@ function drivePiSession(opts) {
   let turnErrored = false;
   let turnInterrupted = false;
   let turnOpen = false;
+  const firstByte = createFirstByteClock(opts.now);
   let handshakeFailed = false;
   let exited = false;
   const finish = (code) => {
@@ -64574,7 +64599,7 @@ function drivePiSession(opts) {
     sink.pushEvents([{ kind: "error", message }, { kind: "turn_end", reason: "completed" }]);
     if (!opened) return;
     turnOpen = false;
-    opts.onTurnCompleted?.("failure");
+    opts.onTurnCompleted?.("failure", firstByte.afterFirstByteMs());
   };
   const handleUiRequest = (ev) => {
     const method = str2(ev.method);
@@ -64601,14 +64626,17 @@ function drivePiSession(opts) {
         return;
       }
       const events = translatePiEvent(ev, st2);
-      if (events.length) sink.pushEvents(events);
+      if (events.length) {
+        if (turnOpen) firstByte.see(events);
+        sink.pushEvents(events);
+      }
       for (const e of events) {
         if (e.kind === "error") turnErrored = true;
         if (e.kind === "turn_end" && e.reason === "interrupted") turnInterrupted = true;
       }
       if (ev.type === "agent_settled") {
         turnOpen = false;
-        opts.onTurnCompleted?.(turnInterrupted ? "interrupted" : turnErrored ? "failure" : "success");
+        opts.onTurnCompleted?.(turnInterrupted ? "interrupted" : turnErrored ? "failure" : "success", firstByte.afterFirstByteMs());
       }
     },
     onClose: () => finish(opts.exitCodeOnClose?.() ?? null)
@@ -64644,6 +64672,7 @@ function drivePiSession(opts) {
         opened = !turnOpen;
         if (opened) {
           turnOpen = true;
+          firstByte.reset();
           opts.onTurnStarting?.();
         }
         const r2 = await client.request({
@@ -64949,7 +64978,9 @@ function createCloudPiSession(ctx, sink, deps) {
     kill: () => stream.close(),
     // 云 persona 运行看板（design 2026-09-23-cloud-persona-metrics §3.7）：提问那一行带「一轮开始」头，轮末镜像顺带报这一轮的结果
     onTurnStarting: () => channel?.markNextLineTurnStart(),
-    onTurnCompleted: (outcome) => void channel?.mirror({ outcome })
+    // 轮末镜像带上这一轮的结果与首字节（design 2026-09-23-cloud-persona-metrics §3.7）
+    onTurnCompleted: (outcome, afterFirstByteMs) => void channel?.mirror({ outcome, ...afterFirstByteMs !== void 0 ? { afterFirstByteMs } : {} }),
+    now: deps.now
   });
   if (!personaId2) {
     queueMicrotask(() => {
@@ -72253,7 +72284,7 @@ function computeMethodAccess(args) {
 }
 
 // src/version.ts
-var version = "0.2.583".length > 0 ? "0.2.583" : "dev";
+var version = "0.2.584".length > 0 ? "0.2.584" : "dev";
 
 // src/cli-probe/probe.ts
 var fs80 = __toESM(require("fs"), 1);