@bahulam/code 2.6.0

package/src/terminal/repl-state.mjs

@@ -0,0 +1,103 @@
+/**
+ * REPL shared state.
+ *
+ * Extracted from repl.mjs so other repl-* modules can import mutable state
+ * without depending on the giant repl.mjs (which is being split incrementally).
+ *
+ * These objects are mutated in place — importers read and write properties
+ * directly. That preserves the current single-source-of-truth pattern the
+ * REPL relied on when everything lived in one file.
+ */
+
+// Ref holder for the Mission Control orbit state machine. The REPL loop
+// creates the orbit at startup and assigns `orbitRef.current = createOrbit()`.
+// Other modules read via orbitRef.current and can null it out during flows
+// like previewResumeSession() that need to temporarily suppress state updates.
+export const orbitRef = { current: null };
+
+// Ref holder for the SessionManager. The REPL loop instantiates it and
+// assigns `sessionMgrRef.current = new SessionManager(...)`. Resume/preview
+// flows null it out temporarily to suppress transcript writes during the
+// preview overlay, then restore it.
+export const sessionMgrRef = { current: null };
+
+// Per-turn runtime state — content streaming buffers, spinner interval,
+// pending tool-head, explore-run counters, block-boundary tracker. All
+// mutated in place by tool renderers, event handlers, and the streaming
+// pipeline. Grouped into one object so consumers can `import { runtime }`
+// once instead of pulling twelve individual let-bindings across modules.
+export const runtime = {
+  // Content streaming (SSE partials that flush as a single markdown block).
+  streamBuffer: '',
+  streamedPartialText: '',
+  streamTimer: null,
+  renderedContentThisTurn: false,
+  contentHeaderPrinted: false,
+  afterContentFlush: null,   // callback fired after each flushContent()
+
+  // Tool head + block-boundary tracking (single-line vs 2-line card emit).
+  pendingHead: null,          // { callId, head, indent } buffered until result arrives
+  lastRenderedBlock: null,    // 'tool' | 'content' | 'thinking' | 'status' | 'plan' | null
+  renderedToolResults: new Set(),
+
+  // Explore-run collapse (read/list/search/index bursts as concise progress).
+  exploreRun: { counts: {}, recent: [], lineActive: false, lastPrintedSummary: '', lastPrintedTotal: 0, lastPrintedAt: 0 },
+
+  // Animated spinner state (single shared interval; text/frame drive inPlace).
+  spinInterval: null,
+  spinText: '',
+  spinFrame: 0,
+};
+
+// Full session state for the current CLI process. Set by the REPL loop
+// as backend events (session_info, complete, etc.) arrive. Fields that
+// look "server-authoritative" (subscriptionTier, credits*) come from
+// session_info + complete payloads; the rest is CLI-local bookkeeping.
+export const session = {
+  id: null,                  // set by backend on first turn via session_info event
+  startTime: Date.now(),
+  inputTokens: 0,
+  outputTokens: 0,
+  toolCalls: 0,        // primary-agent tool calls in the current turn
+  subAgentToolCalls: 0,// forwarded internal sub-agent tool calls in the current turn
+  totalToolCalls: 0,   // across all turns
+  totalPrimaryToolCalls: 0,
+  totalSubAgentToolCalls: 0,
+  turns: 0,
+  history: [],         // display transcript (can include reconstructed tool entries)
+  agentHistory: [],    // backend continuity payload (compact or full)
+  inputHistory: [],    // previous prompts (for Up/Down)
+  user: null,          // { github_username, email, role }
+  model: null,         // from backend user profile
+  modelLimits: {},     // role -> {model, context_length, max_output, source}
+  blockedOps: 0,       // safety guardrail blocks
+  delegations: [],     // agent delegation events: { from, to, time }
+  phases: [],          // phase history: { name, time }
+  inSubAgent: false,   // true while a sub-agent is running (for indented tool display)
+  filesChanged: [],    // files modified this session
+  filesRead: [],       // files read this turn
+  lastTurnDuration: 0,
+  toolCounts: {},      // per-tool histogram (mission report)
+  subAgentCounts: {},  // per-sub-agent histogram (mission report)
+  savedUsd: 0,         // total sub-agent cost (for "saved by routing")
+  lastTask: '',        // most recent user prompt (mission report title)
+  lastReasoning: '',   // captured from agent for /why
+  budgetUsd: null,     // /budget cap, null = unlimited
+  budgetExceeded: false,
+  costBreakdown: [],   // per-model usage: [{ model, role, input_tokens, output_tokens, cost }]
+  totalCost: 0,        // accumulated session cost (USD)
+  costAccurate: false, // true if backend provides per-model breakdown
+  modelOverrides: {},  // session-local role -> model overrides sent to backend
+  isByok: false,       // set from session_info; hides cost + credits when true
+  // ── Subscription / credit state (server-authoritative; set from
+  //    session_info + complete events) ──
+  subscriptionTier: null,        // 'free' | 'cli' | 'pro' | 'pro_plus' | 'enterprise'
+  creditsTotal: null,            // remaining credits (included + purchased)
+  creditsIncluded: null,         // remaining included credits this period
+  creditsPurchased: null,        // remaining purchased credits
+  creditsLimit: null,            // per-period included credits limit
+  creditsCharged: 0,             // session-cumulative server-reported charges
+  creditsLowWarned: false,       // emit the low-balance hint only once per turn
+  rateLimit: null,               // rolling message-window state from backend
+  msgsLowWarned: false,          // emit the low-window hint only once per turn
+};

package/src/terminal/repl-utils.mjs

@@ -0,0 +1,34 @@
+/**
+ * Small utilities shared across the split repl-* modules.
+ *
+ * Kept intentionally minimal — anything with real complexity or state
+ * belongs in its own module.
+ */
+
+import { c } from './ansi.mjs';
+
+// Cached cwd for recovery when the working directory is deleted mid-session.
+let _cachedCwd = null;
+
+/**
+ * Return process.cwd(), recovering if the current directory was removed
+ * out from under us (a nasty Node.js failure mode when the user rm -rf's
+ * a directory the shell is sitting in). On recovery, chdir to the cached
+ * previous cwd, then HOME, then /tmp — whichever works first.
+ */
+export function safeCwd() {
+  try {
+    _cachedCwd = process.cwd();
+    return _cachedCwd;
+  } catch {
+    const fallback = _cachedCwd || process.env.HOME || '/tmp';
+    try {
+      process.chdir(fallback);
+      process.stderr.write(`  ${c.yellow('Working directory was deleted. Recovered to: ' + fallback)}\n`);
+      _cachedCwd = fallback;
+      return fallback;
+    } catch {
+      return process.env.HOME || '/tmp';
+    }
+  }
+}