march-cli 0.1.17 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "march-cli",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "March CLI — terminal-native coding agent with context reconstruction",
   "type": "module",
   "main": "./src/main.mjs",

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

@@ -0,0 +1,75 @@
+import { getOpenAICodexWebSocketDebugStats } from "@earendil-works/pi-ai/openai-codex-responses";
+
+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));
+}
+
+function isCodexTransportDebugEnabled() {
+  const value = process.env.MARCH_CODEX_TRANSPORT_DEBUG;
+  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,
+    hasStats: Boolean(after),
+  };
+}
+
+function formatCodexTransportDebugLines(fields) {
+  if (!fields.hasStats) return [`[codex-transport] sessionId=${fields.sessionId} no Codex WebSocket stats`];
+  return [
+    `[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}`,
+  ];
+}
+
+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);
+}

package/src/agent/runner.mjs

@@ -12,6 +12,7 @@ import { createRunnerRuntimeHost } from "./runtime/runner-runtime-host.mjs";
 import { createRuntimeUiBridge } from "./runtime/ui-event-bridge.mjs";
 import { getRunnerSessionStats, syncEngineSessionState } from "./runner/runner-session-state.mjs";
 import { notifyTurnEndBestEffort, notifyTurnEndDetached, providerContextToPayload } from "./runner/runner-utils.mjs";
+import { dumpCodexTransportDebug, getCodexTransportDebugSnapshot } from "./runner/codex-transport-debug.mjs";
 import { resolveRunnerSessionOptions } from "./session/session-options.mjs";
 import { createSessionBinding } from "./session/session-binding.mjs";
 import { maybeAutoNameSession } from "./session/session-auto-name.mjs";
@@ -110,6 +111,7 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
       currentTurnContextMode = contextMode;
       nextTurnContextMode = "rebuild";
       const turnStartedAt = Date.now();
+      const codexTransportStatsBefore = getCodexTransportDebugSnapshot(sessionBinding.get());
       const turnLog = beginLoggedTurn({ logger, engine, modelId, provider, contextMode, userMessage, userRecallHints, startedAt: turnStartedAt }); currentTurnId = turnLog.turnId;
       try {
         const result = await runRunnerTurn({
@@ -140,6 +142,7 @@ export async function createRunner({ cwd, modelId = null, provider = null, provi
         turnLog.endError(err);
         throw err;
       } finally {
+        dumpCodexTransportDebug({ before: codexTransportStatsBefore, session: sessionBinding.get(), ui: runtimeUi, logger });
         currentTurnId = null;
         currentTurnContextMode = "rebuild";
       }

package/src/agent/runtime/remote-ui-client.mjs

@@ -12,6 +12,7 @@ export function createRemoteRuntimeUiClient(peer) {
     retryStart: (event) => peer.notify("uiEvent", { type: "retry_start", ...event }),
     retryEnd: (event) => peer.notify("uiEvent", { type: "retry_end", ...event }),
     status: (text) => peer.notify("uiEvent", { type: "status", text }),
+    debugLines: (lines) => peer.notify("uiEvent", { type: "debug_lines", lines }),
     memoryHint: ({ source, hints }) => peer.notify("uiEvent", { type: "memory_hint", source, hints }),
     editDiff: (path, diffLines) => peer.notify("uiEvent", { type: "edit_diff", path, diffLines }),
     requestPermission: (request) => peer.call("uiRequest", { type: "permission_request", ...request }),

package/src/agent/runtime/ui-event-bridge.mjs

@@ -49,6 +49,7 @@ export function createRuntimeUiClient(eventBus) {
     retryStart: (event) => eventBus.emit({ type: "retry_start", ...event }),
     retryEnd: (event) => eventBus.emit({ type: "retry_end", ...event }),
     status: (text) => eventBus.emit({ type: "status", text }),
+    debugLines: (lines) => eventBus.emit({ type: "debug_lines", lines }),
     memoryHint: ({ source, hints }) => eventBus.emit({ type: "memory_hint", source, hints }),
     editDiff: (path, diffLines) => eventBus.emit({ type: "edit_diff", path, diffLines }),
     requestPermission: (request) => eventBus.request({ type: "permission_request", ...request }),
@@ -69,6 +70,7 @@ export function dispatchRuntimeUiEvent(ui, event) {
     case "retry_start": return ui.retryStart?.(pickRetryStart(event));
     case "retry_end": return ui.retryEnd?.(pickRetryEnd(event));
     case "status": return ui.status?.(event.text);
+    case "debug_lines": return writeDebugLines(ui, event.lines);
     case "memory_hint": return ui.memoryHint?.({ source: event.source, hints: event.hints });
     case "edit_diff": return ui.editDiff?.(event.path, event.diffLines);
     case "permission_request": return ui.requestPermission?.({ toolName: event.toolName, params: event.params, category: event.category });
@@ -76,6 +78,14 @@ export function dispatchRuntimeUiEvent(ui, event) {
   }
 }
 
+function writeDebugLines(ui, lines) {
+  if (!Array.isArray(lines)) return undefined;
+  if (ui?.debugLines) return ui.debugLines(lines);
+  if (!ui?.writeln) return undefined;
+  for (const line of lines) ui.writeln(line);
+  return undefined;
+}
+
 function pickRetryStart({ attempt, maxAttempts, delayMs, errorMessage }) {
   return { attempt, maxAttempts, delayMs, errorMessage };
 }