march-cli 0.1.21 → 0.1.23

package/src/agent/runner/codex-transport-compression.mjs

@@ -1,180 +1,180 @@
-import zlib from "node:zlib";
-import WsWebSocket from "ws";
-
-const FETCH_INSTALLED = Symbol.for("march.codex.transportCompression.fetchInstalled");
-const WEBSOCKET_INSTALLED = Symbol.for("march.codex.transportCompression.websocketInstalled");
-const ORIGINAL_FETCH = Symbol.for("march.codex.transportCompression.originalFetch");
-const ORIGINAL_WEBSOCKET = Symbol.for("march.codex.transportCompression.originalWebSocket");
-const STATS = Symbol.for("march.codex.transportCompression.stats");
-const DEFAULT_MIN_ZSTD_BYTES = 1024;
-
-export function installCodexTransportCompression() {
-  if (!isCompressionEnabled()) return;
-  installCodexHttpCompression();
-  installCodexWebSocketCompression();
-}
-
-export function getCodexTransportCompressionStats() {
-  return globalThis[STATS] ?? null;
-}
-
-function installCodexHttpCompression() {
-  if (!isHttpCompressionEnabled() || globalThis[FETCH_INSTALLED]) return;
-  const originalFetch = globalThis.fetch;
-  if (typeof originalFetch !== "function" || typeof zlib.zstdCompressSync !== "function") return;
-  globalThis[ORIGINAL_FETCH] = originalFetch;
-  globalThis.fetch = async function marchCodexCompressedFetch(input, init = {}) {
-    if (!isCodexResponsesHttpRequest(input, init) || hasHeader(init.headers ?? input?.headers, "content-encoding")) {
-      return originalFetch.call(this, input, init);
-    }
-    const body = init?.body;
-    const plain = toBuffer(body);
-    if (!plain || plain.byteLength < getMinZstdBytes()) return originalFetch.call(this, input, init);
-
-    const compressed = zlib.zstdCompressSync(plain, {
-      params: { [zlib.constants.ZSTD_c_compressionLevel]: 3 },
-    });
-    const headers = new Headers(init.headers ?? input?.headers ?? {});
-    headers.set("content-encoding", "zstd");
-    headers.set("content-type", headers.get("content-type") ?? "application/json");
-    recordHttpCompression(plain.byteLength, compressed.byteLength);
-    return originalFetch.call(this, input, { ...init, headers, body: compressed });
-  };
-  globalThis[FETCH_INSTALLED] = true;
-}
-
-function installCodexWebSocketCompression() {
-  if (!isWebSocketCompressionEnabled() || globalThis[WEBSOCKET_INSTALLED]) return;
-  const OriginalWebSocket = globalThis.WebSocket;
-  if (typeof OriginalWebSocket !== "function") return;
-  globalThis[ORIGINAL_WEBSOCKET] = OriginalWebSocket;
-
-  class MarchCodexCompressedWebSocket extends WsWebSocket {
-    constructor(url, protocolsOrOptions, maybeOptions) {
-      if (!isCodexResponsesWebSocketUrl(url)) {
-        return new OriginalWebSocket(url, protocolsOrOptions, maybeOptions);
-      }
-      const { protocols, options } = normalizeWebSocketArgs(protocolsOrOptions, maybeOptions);
-      super(url, protocols, {
-        ...options,
-        perMessageDeflate: options.perMessageDeflate ?? true,
-      });
-      recordWebSocketCompression();
-    }
-  }
-  copyReadyStateConstants(MarchCodexCompressedWebSocket, OriginalWebSocket);
-  globalThis.WebSocket = MarchCodexCompressedWebSocket;
-  globalThis[WEBSOCKET_INSTALLED] = true;
-}
-
-function normalizeWebSocketArgs(protocolsOrOptions, maybeOptions) {
-  if (isOptionsObject(protocolsOrOptions) && maybeOptions === undefined) {
-    return { protocols: [], options: protocolsOrOptions };
-  }
-  return { protocols: protocolsOrOptions ?? [], options: maybeOptions ?? {} };
-}
-
-function isOptionsObject(value) {
-  if (!value || typeof value !== "object") return false;
-  if (Array.isArray(value) || value instanceof String) return false;
-  return "headers" in value || "perMessageDeflate" in value || "handshakeTimeout" in value;
-}
-
-function copyReadyStateConstants(Target, OriginalWebSocket) {
-  for (const key of ["CONNECTING", "OPEN", "CLOSING", "CLOSED"]) {
-    const value = OriginalWebSocket[key] ?? WsWebSocket[key];
-    if (typeof value === "number") Object.defineProperty(Target, key, { value, enumerable: true });
-  }
-}
-
-function isCompressionEnabled() {
-  return isEnabled(process.env.MARCH_CODEX_TRANSPORT_COMPRESSION, true);
-}
-
-function isHttpCompressionEnabled() {
-  return isEnabled(process.env.MARCH_CODEX_HTTP_COMPRESSION, true);
-}
-
-function isWebSocketCompressionEnabled() {
-  return isEnabled(process.env.MARCH_CODEX_WS_COMPRESSION, true);
-}
-
-function isEnabled(value, fallback) {
-  if (value === undefined) return fallback;
-  return value !== "0" && value !== "false" && value !== "no";
-}
-
-function getMinZstdBytes() {
-  const raw = process.env.MARCH_CODEX_HTTP_COMPRESSION_MIN_BYTES;
-  const parsed = raw ? Number.parseInt(raw, 10) : DEFAULT_MIN_ZSTD_BYTES;
-  return Number.isFinite(parsed) && parsed >= 0 ? parsed : DEFAULT_MIN_ZSTD_BYTES;
-}
-
-function isCodexResponsesHttpRequest(input, init) {
-  const url = getRequestUrl(input);
-  if (!url || !url.includes("/codex/responses")) return false;
-  const method = init?.method ?? input?.method ?? "GET";
-  if (String(method).toUpperCase() !== "POST") return false;
-  return headerValue(init?.headers ?? input?.headers, "accept").includes("text/event-stream")
-    || headerValue(init?.headers ?? input?.headers, "OpenAI-Beta").includes("responses=experimental");
-}
-
-function isCodexResponsesWebSocketUrl(url) {
-  const raw = getRequestUrl(url);
-  if (!raw || !raw.includes("/codex/responses")) return false;
-  return raw.startsWith("ws://") || raw.startsWith("wss://");
-}
-
-function getRequestUrl(input) {
-  if (typeof input === "string") return input;
-  if (input instanceof URL) return input.toString();
-  if (input && typeof input.url === "string") return input.url;
-  return "";
-}
-
-function toBuffer(body) {
-  if (typeof body === "string") return Buffer.from(body);
-  if (body instanceof Uint8Array) return Buffer.from(body.buffer, body.byteOffset, body.byteLength);
-  if (body instanceof ArrayBuffer) return Buffer.from(body);
-  return null;
-}
-
-function hasHeader(headers, name) {
-  return headerValue(headers, name).length > 0;
-}
-
-function headerValue(headers, name) {
-  if (!headers) return "";
-  if (typeof headers.get === "function") return headers.get(name) ?? headers.get(name.toLowerCase()) ?? "";
-  const lowerName = name.toLowerCase();
-  for (const [key, value] of Object.entries(headers)) {
-    if (key.toLowerCase() === lowerName) return String(value ?? "");
-  }
-  return "";
-}
-
-function recordHttpCompression(preBytes, postBytes) {
-  const stats = ensureStats();
-  stats.httpZstdRequests += 1;
-  stats.lastHttpPreBytes = preBytes;
-  stats.lastHttpPostBytes = postBytes;
-  stats.lastHttpRatio = Number((postBytes / preBytes).toFixed(4));
-}
-
-function recordWebSocketCompression() {
-  const stats = ensureStats();
-  stats.wsCompressedConnections += 1;
-  stats.wsPerMessageDeflate = true;
-}
-
-function ensureStats() {
-  globalThis[STATS] = globalThis[STATS] ?? {
-    httpZstdRequests: 0,
-    lastHttpPreBytes: 0,
-    lastHttpPostBytes: 0,
-    lastHttpRatio: 0,
-    wsCompressedConnections: 0,
-    wsPerMessageDeflate: false,
-  };
-  return globalThis[STATS];
-}
+import zlib from "node:zlib";
+import WsWebSocket from "ws";
+
+const FETCH_INSTALLED = Symbol.for("march.codex.transportCompression.fetchInstalled");
+const WEBSOCKET_INSTALLED = Symbol.for("march.codex.transportCompression.websocketInstalled");
+const ORIGINAL_FETCH = Symbol.for("march.codex.transportCompression.originalFetch");
+const ORIGINAL_WEBSOCKET = Symbol.for("march.codex.transportCompression.originalWebSocket");
+const STATS = Symbol.for("march.codex.transportCompression.stats");
+const DEFAULT_MIN_ZSTD_BYTES = 1024;
+
+export function installCodexTransportCompression() {
+  if (!isCompressionEnabled()) return;
+  installCodexHttpCompression();
+  installCodexWebSocketCompression();
+}
+
+export function getCodexTransportCompressionStats() {
+  return globalThis[STATS] ?? null;
+}
+
+function installCodexHttpCompression() {
+  if (!isHttpCompressionEnabled() || globalThis[FETCH_INSTALLED]) return;
+  const originalFetch = globalThis.fetch;
+  if (typeof originalFetch !== "function" || typeof zlib.zstdCompressSync !== "function") return;
+  globalThis[ORIGINAL_FETCH] = originalFetch;
+  globalThis.fetch = async function marchCodexCompressedFetch(input, init = {}) {
+    if (!isCodexResponsesHttpRequest(input, init) || hasHeader(init.headers ?? input?.headers, "content-encoding")) {
+      return originalFetch.call(this, input, init);
+    }
+    const body = init?.body;
+    const plain = toBuffer(body);
+    if (!plain || plain.byteLength < getMinZstdBytes()) return originalFetch.call(this, input, init);
+
+    const compressed = zlib.zstdCompressSync(plain, {
+      params: { [zlib.constants.ZSTD_c_compressionLevel]: 3 },
+    });
+    const headers = new Headers(init.headers ?? input?.headers ?? {});
+    headers.set("content-encoding", "zstd");
+    headers.set("content-type", headers.get("content-type") ?? "application/json");
+    recordHttpCompression(plain.byteLength, compressed.byteLength);
+    return originalFetch.call(this, input, { ...init, headers, body: compressed });
+  };
+  globalThis[FETCH_INSTALLED] = true;
+}
+
+function installCodexWebSocketCompression() {
+  if (!isWebSocketCompressionEnabled() || globalThis[WEBSOCKET_INSTALLED]) return;
+  const OriginalWebSocket = globalThis.WebSocket;
+  if (typeof OriginalWebSocket !== "function") return;
+  globalThis[ORIGINAL_WEBSOCKET] = OriginalWebSocket;
+
+  class MarchCodexCompressedWebSocket extends WsWebSocket {
+    constructor(url, protocolsOrOptions, maybeOptions) {
+      if (!isCodexResponsesWebSocketUrl(url)) {
+        return new OriginalWebSocket(url, protocolsOrOptions, maybeOptions);
+      }
+      const { protocols, options } = normalizeWebSocketArgs(protocolsOrOptions, maybeOptions);
+      super(url, protocols, {
+        ...options,
+        perMessageDeflate: options.perMessageDeflate ?? true,
+      });
+      recordWebSocketCompression();
+    }
+  }
+  copyReadyStateConstants(MarchCodexCompressedWebSocket, OriginalWebSocket);
+  globalThis.WebSocket = MarchCodexCompressedWebSocket;
+  globalThis[WEBSOCKET_INSTALLED] = true;
+}
+
+function normalizeWebSocketArgs(protocolsOrOptions, maybeOptions) {
+  if (isOptionsObject(protocolsOrOptions) && maybeOptions === undefined) {
+    return { protocols: [], options: protocolsOrOptions };
+  }
+  return { protocols: protocolsOrOptions ?? [], options: maybeOptions ?? {} };
+}
+
+function isOptionsObject(value) {
+  if (!value || typeof value !== "object") return false;
+  if (Array.isArray(value) || value instanceof String) return false;
+  return "headers" in value || "perMessageDeflate" in value || "handshakeTimeout" in value;
+}
+
+function copyReadyStateConstants(Target, OriginalWebSocket) {
+  for (const key of ["CONNECTING", "OPEN", "CLOSING", "CLOSED"]) {
+    const value = OriginalWebSocket[key] ?? WsWebSocket[key];
+    if (typeof value === "number") Object.defineProperty(Target, key, { value, enumerable: true });
+  }
+}
+
+function isCompressionEnabled() {
+  return isEnabled(process.env.MARCH_CODEX_TRANSPORT_COMPRESSION, true);
+}
+
+function isHttpCompressionEnabled() {
+  return isEnabled(process.env.MARCH_CODEX_HTTP_COMPRESSION, true);
+}
+
+function isWebSocketCompressionEnabled() {
+  return isEnabled(process.env.MARCH_CODEX_WS_COMPRESSION, true);
+}
+
+function isEnabled(value, fallback) {
+  if (value === undefined) return fallback;
+  return value !== "0" && value !== "false" && value !== "no";
+}
+
+function getMinZstdBytes() {
+  const raw = process.env.MARCH_CODEX_HTTP_COMPRESSION_MIN_BYTES;
+  const parsed = raw ? Number.parseInt(raw, 10) : DEFAULT_MIN_ZSTD_BYTES;
+  return Number.isFinite(parsed) && parsed >= 0 ? parsed : DEFAULT_MIN_ZSTD_BYTES;
+}
+
+function isCodexResponsesHttpRequest(input, init) {
+  const url = getRequestUrl(input);
+  if (!url || !url.includes("/codex/responses")) return false;
+  const method = init?.method ?? input?.method ?? "GET";
+  if (String(method).toUpperCase() !== "POST") return false;
+  return headerValue(init?.headers ?? input?.headers, "accept").includes("text/event-stream")
+    || headerValue(init?.headers ?? input?.headers, "OpenAI-Beta").includes("responses=experimental");
+}
+
+function isCodexResponsesWebSocketUrl(url) {
+  const raw = getRequestUrl(url);
+  if (!raw || !raw.includes("/codex/responses")) return false;
+  return raw.startsWith("ws://") || raw.startsWith("wss://");
+}
+
+function getRequestUrl(input) {
+  if (typeof input === "string") return input;
+  if (input instanceof URL) return input.toString();
+  if (input && typeof input.url === "string") return input.url;
+  return "";
+}
+
+function toBuffer(body) {
+  if (typeof body === "string") return Buffer.from(body);
+  if (body instanceof Uint8Array) return Buffer.from(body.buffer, body.byteOffset, body.byteLength);
+  if (body instanceof ArrayBuffer) return Buffer.from(body);
+  return null;
+}
+
+function hasHeader(headers, name) {
+  return headerValue(headers, name).length > 0;
+}
+
+function headerValue(headers, name) {
+  if (!headers) return "";
+  if (typeof headers.get === "function") return headers.get(name) ?? headers.get(name.toLowerCase()) ?? "";
+  const lowerName = name.toLowerCase();
+  for (const [key, value] of Object.entries(headers)) {
+    if (key.toLowerCase() === lowerName) return String(value ?? "");
+  }
+  return "";
+}
+
+function recordHttpCompression(preBytes, postBytes) {
+  const stats = ensureStats();
+  stats.httpZstdRequests += 1;
+  stats.lastHttpPreBytes = preBytes;
+  stats.lastHttpPostBytes = postBytes;
+  stats.lastHttpRatio = Number((postBytes / preBytes).toFixed(4));
+}
+
+function recordWebSocketCompression() {
+  const stats = ensureStats();
+  stats.wsCompressedConnections += 1;
+  stats.wsPerMessageDeflate = true;
+}
+
+function ensureStats() {
+  globalThis[STATS] = globalThis[STATS] ?? {
+    httpZstdRequests: 0,
+    lastHttpPreBytes: 0,
+    lastHttpPostBytes: 0,
+    lastHttpRatio: 0,
+    wsCompressedConnections: 0,
+    wsPerMessageDeflate: false,
+  };
+  return globalThis[STATS];
+}

package/src/agent/runner/codex-transport-debug.mjs

@@ -1,113 +1,113 @@
-import { getOpenAICodexWebSocketDebugStats } from "@earendil-works/pi-ai/openai-codex-responses";
-import { getCodexTransportCompressionStats } from "./codex-transport-compression.mjs";
-import { getCodexWebSocketLastEvent } from "./codex-websocket-event-debug.mjs";
-
-export function getCodexTransportDebugSnapshot(session) {
-  if (!isCodexTransportDebugEnabled()) return null;
-  const sessionId = session?.sessionId;
-  return sessionId ? (getOpenAICodexWebSocketDebugStats(sessionId) ?? null) : null;
-}
-
-export function dumpCodexTransportDebug({ before, session, ui, logger }) {
-  if (!isCodexTransportDebugEnabled()) return;
-  const sessionId = session?.sessionId;
-  const after = sessionId ? (getOpenAICodexWebSocketDebugStats(sessionId) ?? null) : null;
-  const fields = formatCodexTransportDebugFields(sessionId, before, after);
-  logger?.event("codex.transport", fields);
-  writeCodexTransportDebug(ui, formatCodexTransportDebugLines(fields, logger?.path));
-}
-
-function isCodexTransportDebugEnabled() {
-  const value = process.env.MARCH_CODEX_TRANSPORT_DEBUG;
-  return value === "1" || value === "true" || value === "yes";
-}
-
-function isCodexTransportDebugEventsVisible() {
-  const value = process.env.MARCH_CODEX_TRANSPORT_DEBUG_EVENTS;
-  return value === "1" || value === "true" || value === "yes";
-}
-
-function formatCodexTransportDebugFields(sessionId, before, after) {
-  const delta = (key) => (after?.[key] ?? 0) - (before?.[key] ?? 0);
-  return {
-    sessionId: sessionId ?? "unknown",
-    requests: delta("requests"),
-    totalRequests: after?.requests ?? 0,
-    connectionsCreated: delta("connectionsCreated"),
-    connectionsReused: delta("connectionsReused"),
-    cachedContextRequests: delta("cachedContextRequests"),
-    storeTrueRequests: delta("storeTrueRequests"),
-    fullContextRequests: delta("fullContextRequests"),
-    deltaRequests: delta("deltaRequests"),
-    websocketFailures: delta("websocketFailures"),
-    sseFallbacks: delta("sseFallbacks"),
-    websocketFallbackActive: Boolean(after?.websocketFallbackActive),
-    lastInputItems: after?.lastInputItems ?? 0,
-    lastDeltaInputItems: after?.lastDeltaInputItems ?? 0,
-    lastWebSocketError: after?.lastWebSocketError ?? null,
-    compression: getCodexTransportCompressionStats(),
-    lastWebSocketEvent: getCodexWebSocketLastEvent(sessionId),
-    hasStats: Boolean(after),
-  };
-}
-
-function formatCodexTransportDebugLines(fields, logPath) {
-  if (!fields.hasStats) return [`[codex-transport] sessionId=${fields.sessionId} no Codex WebSocket stats`];
-  const lines = [
-    `[codex-transport] sessionId=${fields.sessionId}`,
-    `  requests=${fields.requests} totalRequests=${fields.totalRequests}`,
-    `  wsConnections created=${fields.connectionsCreated} reused=${fields.connectionsReused}`,
-    `  modes full=${fields.fullContextRequests} delta=${fields.deltaRequests} cached=${fields.cachedContextRequests} storeTrue=${fields.storeTrueRequests}`,
-    `  fallback websocketFailures=${fields.websocketFailures} sseFallbacks=${fields.sseFallbacks} active=${fields.websocketFallbackActive}`,
-    `  error lastWebSocketError=${formatDebugValue(fields.lastWebSocketError)}`,
-    `  lastInputItems=${fields.lastInputItems} lastDeltaInputItems=${fields.lastDeltaInputItems}`,
-    `  compression httpZstd=${formatDebugValue(fields.compression?.httpZstdRequests ?? 0)} lastBytes=${formatDebugValue(fields.compression ? `${fields.compression.lastHttpPreBytes}->${fields.compression.lastHttpPostBytes}` : null)} ratio=${formatDebugValue(fields.compression?.lastHttpRatio)} wsDeflate=${formatDebugValue(fields.compression?.wsPerMessageDeflate)} wsConnections=${formatDebugValue(fields.compression?.wsCompressedConnections ?? 0)}`,
-  ];
-  if (isCodexTransportDebugEventsVisible()) {
-    lines.push(...formatWebSocketEventLines(fields.lastWebSocketEvent));
-  } else if (fields.lastWebSocketEvent && logPath) {
-    lines.push(`  rawWebSocketEventLog=${formatDebugValue(logPath)}`);
-  }
-  return lines;
-}
-
-function formatWebSocketEventLines(events) {
-  if (!events) return ["  wsEvent none"];
-  return [
-    ...formatSingleWebSocketEvent("wsEvent", events.lastEvent),
-    ...formatSingleWebSocketEvent("wsError", events.lastErrorEvent),
-    ...formatSingleWebSocketCloseEvent(events.lastCloseEvent),
-  ];
-}
-
-function formatSingleWebSocketEvent(prefix, event) {
-  if (!event) return [`  ${prefix} none`];
-  return [
-    `  ${prefix} phase=${formatDebugValue(event.phase)} type=${formatDebugValue(event.type)} keys=${formatDebugValue(event.eventKeys)} readyState=${formatDebugValue(event.readyState)}`,
-    `  ${prefix} errorName=${formatDebugValue(event.errorName)} errorMessage=${formatDebugValue(event.errorMessage)} errorCode=${formatDebugValue(event.errorCode)} errorString=${formatDebugValue(event.errorString)} eventMessage=${formatDebugValue(event.eventMessage)}`,
-  ];
-}
-
-function formatSingleWebSocketCloseEvent(event) {
-  if (!event) return ["  wsClose none"];
-  return [`  wsClose code=${formatDebugValue(event.closeCode)} reason=${formatDebugValue(event.closeReason)} wasClean=${formatDebugValue(event.closeWasClean)} readyState=${formatDebugValue(event.readyState)}`];
-}
-
-function formatDebugValue(value) {
-  if (value === null || value === undefined || value === "") return "none";
-  if (typeof value === "string") return JSON.stringify(value);
-  try {
-    return JSON.stringify(value);
-  } catch {
-    return JSON.stringify(String(value));
-  }
-}
-
-function writeCodexTransportDebug(ui, lines) {
-  if (ui?.debugLines) {
-    ui.debugLines(lines);
-    return;
-  }
-  if (!ui?.writeln) return;
-  for (const line of lines) ui.writeln(line);
-}
+import { getOpenAICodexWebSocketDebugStats } from "@earendil-works/pi-ai/openai-codex-responses";
+import { getCodexTransportCompressionStats } from "./codex-transport-compression.mjs";
+import { getCodexWebSocketLastEvent } from "./codex-websocket-event-debug.mjs";
+
+export function getCodexTransportDebugSnapshot(session) {
+  if (!isCodexTransportDebugEnabled()) return null;
+  const sessionId = session?.sessionId;
+  return sessionId ? (getOpenAICodexWebSocketDebugStats(sessionId) ?? null) : null;
+}
+
+export function dumpCodexTransportDebug({ before, session, ui, logger }) {
+  if (!isCodexTransportDebugEnabled()) return;
+  const sessionId = session?.sessionId;
+  const after = sessionId ? (getOpenAICodexWebSocketDebugStats(sessionId) ?? null) : null;
+  const fields = formatCodexTransportDebugFields(sessionId, before, after);
+  logger?.event("codex.transport", fields);
+  writeCodexTransportDebug(ui, formatCodexTransportDebugLines(fields, logger?.path));
+}
+
+function isCodexTransportDebugEnabled() {
+  const value = process.env.MARCH_CODEX_TRANSPORT_DEBUG;
+  return value === "1" || value === "true" || value === "yes";
+}
+
+function isCodexTransportDebugEventsVisible() {
+  const value = process.env.MARCH_CODEX_TRANSPORT_DEBUG_EVENTS;
+  return value === "1" || value === "true" || value === "yes";
+}
+
+function formatCodexTransportDebugFields(sessionId, before, after) {
+  const delta = (key) => (after?.[key] ?? 0) - (before?.[key] ?? 0);
+  return {
+    sessionId: sessionId ?? "unknown",
+    requests: delta("requests"),
+    totalRequests: after?.requests ?? 0,
+    connectionsCreated: delta("connectionsCreated"),
+    connectionsReused: delta("connectionsReused"),
+    cachedContextRequests: delta("cachedContextRequests"),
+    storeTrueRequests: delta("storeTrueRequests"),
+    fullContextRequests: delta("fullContextRequests"),
+    deltaRequests: delta("deltaRequests"),
+    websocketFailures: delta("websocketFailures"),
+    sseFallbacks: delta("sseFallbacks"),
+    websocketFallbackActive: Boolean(after?.websocketFallbackActive),
+    lastInputItems: after?.lastInputItems ?? 0,
+    lastDeltaInputItems: after?.lastDeltaInputItems ?? 0,
+    lastWebSocketError: after?.lastWebSocketError ?? null,
+    compression: getCodexTransportCompressionStats(),
+    lastWebSocketEvent: getCodexWebSocketLastEvent(sessionId),
+    hasStats: Boolean(after),
+  };
+}
+
+function formatCodexTransportDebugLines(fields, logPath) {
+  if (!fields.hasStats) return [`[codex-transport] sessionId=${fields.sessionId} no Codex WebSocket stats`];
+  const lines = [
+    `[codex-transport] sessionId=${fields.sessionId}`,
+    `  requests=${fields.requests} totalRequests=${fields.totalRequests}`,
+    `  wsConnections created=${fields.connectionsCreated} reused=${fields.connectionsReused}`,
+    `  modes full=${fields.fullContextRequests} delta=${fields.deltaRequests} cached=${fields.cachedContextRequests} storeTrue=${fields.storeTrueRequests}`,
+    `  fallback websocketFailures=${fields.websocketFailures} sseFallbacks=${fields.sseFallbacks} active=${fields.websocketFallbackActive}`,
+    `  error lastWebSocketError=${formatDebugValue(fields.lastWebSocketError)}`,
+    `  lastInputItems=${fields.lastInputItems} lastDeltaInputItems=${fields.lastDeltaInputItems}`,
+    `  compression httpZstd=${formatDebugValue(fields.compression?.httpZstdRequests ?? 0)} lastBytes=${formatDebugValue(fields.compression ? `${fields.compression.lastHttpPreBytes}->${fields.compression.lastHttpPostBytes}` : null)} ratio=${formatDebugValue(fields.compression?.lastHttpRatio)} wsDeflate=${formatDebugValue(fields.compression?.wsPerMessageDeflate)} wsConnections=${formatDebugValue(fields.compression?.wsCompressedConnections ?? 0)}`,
+  ];
+  if (isCodexTransportDebugEventsVisible()) {
+    lines.push(...formatWebSocketEventLines(fields.lastWebSocketEvent));
+  } else if (fields.lastWebSocketEvent && logPath) {
+    lines.push(`  rawWebSocketEventLog=${formatDebugValue(logPath)}`);
+  }
+  return lines;
+}
+
+function formatWebSocketEventLines(events) {
+  if (!events) return ["  wsEvent none"];
+  return [
+    ...formatSingleWebSocketEvent("wsEvent", events.lastEvent),
+    ...formatSingleWebSocketEvent("wsError", events.lastErrorEvent),
+    ...formatSingleWebSocketCloseEvent(events.lastCloseEvent),
+  ];
+}
+
+function formatSingleWebSocketEvent(prefix, event) {
+  if (!event) return [`  ${prefix} none`];
+  return [
+    `  ${prefix} phase=${formatDebugValue(event.phase)} type=${formatDebugValue(event.type)} keys=${formatDebugValue(event.eventKeys)} readyState=${formatDebugValue(event.readyState)}`,
+    `  ${prefix} errorName=${formatDebugValue(event.errorName)} errorMessage=${formatDebugValue(event.errorMessage)} errorCode=${formatDebugValue(event.errorCode)} errorString=${formatDebugValue(event.errorString)} eventMessage=${formatDebugValue(event.eventMessage)}`,
+  ];
+}
+
+function formatSingleWebSocketCloseEvent(event) {
+  if (!event) return ["  wsClose none"];
+  return [`  wsClose code=${formatDebugValue(event.closeCode)} reason=${formatDebugValue(event.closeReason)} wasClean=${formatDebugValue(event.closeWasClean)} readyState=${formatDebugValue(event.readyState)}`];
+}
+
+function formatDebugValue(value) {
+  if (value === null || value === undefined || value === "") return "none";
+  if (typeof value === "string") return JSON.stringify(value);
+  try {
+    return JSON.stringify(value);
+  } catch {
+    return JSON.stringify(String(value));
+  }
+}
+
+function writeCodexTransportDebug(ui, lines) {
+  if (ui?.debugLines) {
+    ui.debugLines(lines);
+    return;
+  }
+  if (!ui?.writeln) return;
+  for (const line of lines) ui.writeln(line);
+}