@wrongstack/tui 0.5.6 → 0.6.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import * as _wrongstack_core from '@wrongstack/core';
 import { Agent, SlashCommandRegistry, AttachmentStore, EventBus, TokenCounter, QueueStore, Director } from '@wrongstack/core';
 import { VisionAdapters } from '@wrongstack/runtime/vision';
 import React from 'react';
@@ -29,7 +30,19 @@ interface RunTuiOptions {
     /** Query live YOLO state from the permission policy. */
     getYolo?: () => boolean;
     /** Query the live autonomy mode. */
-    getAutonomy?: () => 'off' | 'suggest' | 'auto';
+    getAutonomy?: () => 'off' | 'suggest' | 'auto' | 'eternal';
+    /**
+     * Access the eternal-autonomy engine. When autonomy mode flips to
+     * 'eternal' the TUI drives `runOneIteration()` from the post-slash hook
+     * so the engine and TUI never race for the shared Context.
+     */
+    getEternalEngine?: () => _wrongstack_core.EternalAutonomyEngine | null;
+    /**
+     * Subscribe to live per-iteration events from the eternal engine.
+     * Returns an unsubscribe function. TUI uses this to render each
+     * iteration as a live timeline entry as it lands.
+     */
+    subscribeEternalIteration?: (fn: (entry: _wrongstack_core.JournalEntry) => void) => () => void;
     /** Renders in the startup banner. Read from the CLI's package.json. */
     appVersion?: string;
     /** Provider id for the startup banner ("openai", "anthropic", ...). */
@@ -88,6 +101,12 @@ interface RunTuiOptions {
     fleetRoster?: Record<string, {
         name: string;
     }>;
+    /**
+     * Shared controller for the `/fleet stream on|off` toggle. The slash
+     * command runs in the CLI process and needs to flip TUI reducer state;
+     * the App installs a dispatch-backed `setEnabled` here on mount so
+     * both sides stay synchronized.
+     */
     /**
      * Shared controller for the `/fleet stream on|off` toggle. The slash
      * command runs in the CLI process and needs to flip TUI reducer state;
@@ -98,6 +117,14 @@ interface RunTuiOptions {
         enabled: boolean;
         setEnabled: (enabled: boolean) => void;
     };
+    /**
+     * Controller for status bar hidden items. App installs a dispatch-backed
+     * setter on mount so the /statusline slash command can update the TUI's
+     * visible bar without a round-trip. The initial value is loaded from
+     * the config file before App mounts.
+     */
+    statuslineHiddenItems: Array<'todos' | 'plan' | 'fleet' | 'git' | 'elapsed' | 'context' | 'cost'>;
+    setStatuslineHiddenItems: (items: Array<'todos' | 'plan' | 'fleet' | 'git' | 'elapsed' | 'context' | 'cost'>) => void;
     /**
      * If set, the App boots straight into goal mode — the text is wrapped
      * in the GOAL preamble and submitted as the first turn. Lets users
@@ -133,4 +160,32 @@ interface RunTuiOptions {
 }
 declare function runTui(opts: RunTuiOptions): Promise<number>;
 
-export { type RunTuiOptions, runTui };
+/**
+ * `/goal <description>` preamble — the "no force can stop this" mode.
+ *
+ * Unlike STEERING (which redirects mid-flight), GOAL is a contract:
+ * the user hands over a problem, the agent commits to verifiably
+ * finishing it, and every iteration re-reads this preamble from the
+ * conversation history. The hardening is entirely prompt-level —
+ * the system has already removed implicit budget caps, so this
+ * preamble's job is to remove the MODEL's tendency to hedge, ask
+ * permission, or declare premature success.
+ *
+ * The four sections are intentional:
+ *   1. AUTHORITY — explicit grant of unbounded fan-out + model
+ *      switching. Without this the model self-throttles ("I shouldn't
+ *      spawn too many…") even when budgets are unlimited.
+ *   2. DONE — concrete bar for completion. Forces a verifiable
+ *      artifact (test passing, file written, bug re-run clean).
+ *      Without this the model returns "I believe it's fixed" and
+ *      counts that as done.
+ *   3. NOT DONE — explicit anti-patterns. Each item is something we
+ *      saw real agents do as a "completion" that wasn't.
+ *   4. PERSISTENCE — three-angle rule for blockers. Stops the model
+ *      from giving up on the first tool failure.
+ *
+ * Exported for the test that pins the structural guarantees.
+ */
+declare function buildGoalPreamble(goal: string): string;
+
+export { type RunTuiOptions, buildGoalPreamble, runTui };

package/dist/index.js

@@ -1,9 +1,10 @@
 import { render, useApp, Box, useStdout, Static, Text, useInput, useStdin } from 'ink';
-import React2, { useState, useReducer, useRef, useEffect, useMemo } from 'react';
+import React2, { useState, useEffect, useReducer, useRef, useMemo } from 'react';
 import * as fs2 from 'fs/promises';
 import * as path2 from 'path';
 import { InputBuilder, DefaultSessionRewinder, formatTodosList, buildChildEnv } from '@wrongstack/core';
 import { routeImagesForModel } from '@wrongstack/runtime/vision';
+import { getProcessRegistry } from '@wrongstack/tools';
 import { readClipboardImage } from '@wrongstack/runtime/clipboard';
 import { jsxs, jsx, Fragment } from 'react/jsx-runtime';
 import { spawn } from 'child_process';
@@ -1630,8 +1631,11 @@ function StatusBar({
   git,
   subagentCount = 0,
   context,
-  projectName
+  projectName,
+  processCount,
+  hiddenItems
 }) {
+  const hiddenSet = new Set(hiddenItems);
   const usage = tokenCounter?.total();
   const cost = tokenCounter?.estimateCost();
   const cache2 = tokenCounter?.cacheStats();
@@ -1695,6 +1699,15 @@ function StatusBar({
               queueCount
             ] })
           ] }) : null,
+          typeof processCount === "number" && processCount > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\u2502" }),
+            /* @__PURE__ */ jsxs(Text, { color: "red", children: [
+              "\u26A1 ",
+              processCount,
+              " process",
+              processCount === 1 ? "" : "es"
+            ] })
+          ] }) : null,
           hint ? /* @__PURE__ */ jsxs(Fragment, { children: [
             /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\u2502" }),
             /* @__PURE__ */ jsx(Text, { dimColor: true, children: hint })
@@ -1704,12 +1717,19 @@ function StatusBar({
           yolo ? /* @__PURE__ */ jsx(Text, { color: "red", bold: true, children: "\u26A0 YOLO" }) : null,
           autonomy && autonomy !== "off" ? /* @__PURE__ */ jsxs(Fragment, { children: [
             yolo ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\u2502" }) : null,
-            /* @__PURE__ */ jsxs(Text, { color: autonomy === "auto" ? "yellow" : "cyan", bold: true, children: [
-              "\u221E ",
-              autonomy.toUpperCase()
-            ] })
+            /* @__PURE__ */ jsxs(
+              Text,
+              {
+                color: autonomy === "eternal" ? "red" : autonomy === "auto" ? "yellow" : "cyan",
+                bold: true,
+                children: [
+                  "\u221E ",
+                  autonomy.toUpperCase()
+                ]
+              }
+            )
           ] }) : null,
-          elapsedMs !== void 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          elapsedMs !== void 0 && !hiddenSet.has("elapsed") ? /* @__PURE__ */ jsxs(Fragment, { children: [
             yolo ? /* @__PURE__ */ jsx(Text, { dimColor: true, children: "\u2502" }) : null,
             /* @__PURE__ */ jsxs(Text, { dimColor: true, children: [
               "\u23F1 ",
@@ -2092,6 +2112,101 @@ function oneLine(s, max) {
   const collapsed = s.replace(/\s+/g, " ").trim();
   return collapsed.length <= max ? collapsed : `${collapsed.slice(0, max - 1)}\u2026`;
 }
+var USAGE2 = "Usage:\n  /kill             \u2014 list active processes + breaker state\n  /kill list        \u2014 same as /kill\n  /kill all         \u2014 kill all tracked processes (SIGTERM \u2192 SIGKILL)\n  /kill force       \u2014 kill all with SIGKILL immediately\n  /kill reset       \u2014 reset the circuit breaker to closed\n  /kill <pid>       \u2014 kill a specific process by PID";
+function createKillSlashCommand() {
+  return {
+    name: "kill",
+    description: "List or kill active bash/exec processes managed by the process registry.",
+    async run(args) {
+      const trimmed = args.trim();
+      const parts = trimmed.split(/\s+/);
+      const sub = parts[0]?.toLowerCase() ?? "";
+      if (sub === "" || sub === "list") {
+        return { message: renderList2() };
+      }
+      if (sub === "all") {
+        const pids = getProcessRegistry().killAll();
+        if (pids.length === 0) return { message: "No processes to kill." };
+        return { message: `Killed ${pids.length} process${pids.length === 1 ? "" : "es"}: ${pids.join(", ")}` };
+      }
+      if (sub === "force") {
+        getProcessRegistry().forceBreakerOpen();
+        const pids = getProcessRegistry().killAll({ force: true });
+        if (pids.length === 0) return { message: "Circuit breaker forced open. No processes to kill." };
+        return { message: `Force-killed ${pids.length} process${pids.length === 1 ? "" : "es"}: ${pids.join(", ")}` };
+      }
+      if (sub === "reset") {
+        getProcessRegistry().forceBreakerReset();
+        return { message: "Circuit breaker reset to closed. Bash/exec calls allowed." };
+      }
+      const pid = Number.parseInt(sub, 10);
+      if (!Number.isNaN(pid) && pid > 0) {
+        const found = getProcessRegistry().kill(pid);
+        if (found) return { message: `Killed process ${pid}.` };
+        return { message: `Process ${pid} not found in registry.` };
+      }
+      return { message: `Unknown subcommand "${sub}".
+${USAGE2}` };
+    }
+  };
+}
+function renderList2() {
+  const registry = getProcessRegistry();
+  const stats = registry.stats();
+  const all = registry.list();
+  const breaker = stats.breaker;
+  const stateLabel = breaker.state === "closed" ? "\u{1F7E2} closed" : breaker.state === "half-open" ? "\u{1F7E1} half-open" : `\u{1F534} open (cooldown ${breaker.cooldownRemainingMs !== null ? `${(breaker.cooldownRemainingMs / 1e3).toFixed(0)}s` : "\u2014"})`;
+  const breakerLine = [
+    `  Circuit breaker: ${stateLabel}`,
+    `    consecutive failures: ${breaker.consecutiveFailures}/5`,
+    `    slow calls in window: ${breaker.slowCallsInWindow}/3`,
+    `    calls in window: ${breaker.callsInWindow}/30`
+  ].join("\n");
+  if (all.length === 0) {
+    return `No active processes.
+
+${breakerLine}`;
+  }
+  const now = Date.now();
+  const lines = [`Active processes (${all.length}):`];
+  for (const p of all) {
+    const age = ((now - p.startedAt) / 1e3).toFixed(1);
+    const killedTag = p.killed ? " [killed]" : "";
+    const cmd = p.command.length > 80 ? p.command.slice(0, 77) + "\u2026" : p.command;
+    lines.push(`  ${p.pid}  ${p.name}  ${age}s  ${cmd}${killedTag}`);
+  }
+  return [...lines, "", breakerLine].join("\n");
+}
+function createPsSlashCommand() {
+  return {
+    name: "ps",
+    description: "List all active bash/exec processes tracked by the process registry.",
+    async run(_args) {
+      return { message: renderList3() };
+    }
+  };
+}
+function renderList3() {
+  const registry = getProcessRegistry();
+  const stats = registry.stats();
+  const all = registry.list();
+  if (all.length === 0) return "No active processes.";
+  const breaker = stats.breaker;
+  const stateLabel = breaker.state === "closed" ? "\u{1F7E2} closed" : breaker.state === "half-open" ? "\u{1F7E1} half-open" : `\u{1F534} open`;
+  const now = Date.now();
+  const lines = [
+    `Active processes (${all.length}) \u2014 breaker ${stateLabel}`,
+    `  failure=${breaker.consecutiveFailures}/5  slow=${breaker.slowCallsInWindow}/3  rate=${breaker.callsInWindow}/30`,
+    ""
+  ];
+  for (const p of all) {
+    const age = ((now - p.startedAt) / 1e3).toFixed(1);
+    const killedTag = p.killed ? " [killed]" : "";
+    const cmd = p.command.length > 80 ? p.command.slice(0, 77) + "\u2026" : p.command;
+    lines.push(`  ${p.pid}  ${p.name}  ${age}s  ${cmd}${killedTag}`);
+  }
+  return lines.join("\n");
+}
 function selectedSlashCommandLine(picker) {
   if (!picker.open || picker.matches.length === 0) return null;
   const picked = picker.matches[picker.selected];
@@ -2670,6 +2785,8 @@ function App({
   yolo = false,
   getYolo,
   getAutonomy,
+  getEternalEngine,
+  subscribeEternalIteration,
   getSDDContext,
   onSDDOutput,
   appVersion,
@@ -2684,6 +2801,8 @@ function App({
   fleetRoster,
   onClearHistory,
   fleetStreamController,
+  statuslineHiddenItems,
+  setStatuslineHiddenItems,
   initialGoal,
   initialAsk,
   sessionsDir
@@ -2693,6 +2812,13 @@ function App({
   const [liveProvider, setLiveProvider] = useState(provider ?? "agent");
   const [yoloLive, setYoloLive] = useState(yolo);
   const [autonomyLive, setAutonomyLive] = useState(getAutonomy?.() ?? "off");
+  const [hiddenItems, setHiddenItems] = useState(statuslineHiddenItems);
+  useEffect(() => {
+    setHiddenItems(statuslineHiddenItems);
+  }, [statuslineHiddenItems]);
+  useEffect(() => {
+    setStatuslineHiddenItems(hiddenItems);
+  }, [setStatuslineHiddenItems]);
   const [state, dispatch] = useReducer(reducer, {
     entries: banner ? [
       {
@@ -3072,6 +3198,19 @@ function App({
       slashRegistry.unregister("queue");
     };
   }, [slashRegistry]);
+  useEffect(() => {
+    slashRegistry.register(createKillSlashCommand());
+    slashRegistry.register(createPsSlashCommand());
+    return () => {
+      slashRegistry.unregister("kill");
+      slashRegistry.unregister("ps");
+    };
+  }, [slashRegistry]);
+  useEffect(() => {
+    return () => {
+      getProcessRegistry().killAll();
+    };
+  }, []);
   useEffect(() => {
     const ALT_OFF = "\x1B[?1049l";
     const ALT_ON = "\x1B[?1049h";
@@ -3194,39 +3333,6 @@ function App({
       slashRegistry.unregister("rewind");
     };
   }, [slashRegistry, handleRewindTo]);
-  useEffect(() => {
-    const cmd = {
-      name: "goal",
-      description: "Lock in a goal \u2014 no budgets, no hedging, no premature done. /goal <description>",
-      help: [
-        "Usage: /goal <description>",
-        "",
-        "Hands the agent a task it must drive to a verifiable finish.",
-        "Adds a preamble to the next turn that grants full autonomy",
-        "(unlimited subagents, any provider/model, retry-until-it-works),",
-        'spells out what "done" actually means, and forbids hedge-style',
-        'completions ("I believe this works", "should I continue?").',
-        "",
-        "Combine with /steer to redirect mid-goal, or Ctrl+C / /fleet kill",
-        "to bail out \u2014 only the user can stop a /goal."
-      ].join("\n"),
-      async run(args) {
-        const goal = args.trim();
-        if (!goal) return { message: "Usage: /goal <description>" };
-        const preamble = buildGoalPreamble(goal);
-        const shortGoal = goal.length > 80 ? `${goal.slice(0, 80)}\u2026` : goal;
-        return {
-          message: `\u{1F3AF} Goal locked: ${shortGoal}
-   Agent will work until verifiably complete. Esc / /steer to redirect, Ctrl+C to stop.`,
-          runText: preamble
-        };
-      }
-    };
-    slashRegistry.register(cmd);
-    return () => {
-      slashRegistry.unregister("goal");
-    };
-  }, [slashRegistry]);
   useEffect(() => {
     if (!getPickableProviders || !switchProviderAndModel) return;
     const cmd = {
@@ -3651,6 +3757,7 @@ function App({
     const onSigint = () => {
       const current = stateRef.current;
       if (current.interrupts >= 1) {
+        getProcessRegistry().killAll({ force: true });
         if (current.interrupts >= 2) {
           process.exit(130);
         }
@@ -3688,6 +3795,8 @@ function App({
           });
           void Promise.race([director.terminateAll().catch(() => void 0), cap]);
         }
+        const killed = getProcessRegistry().killAll();
+        const procTag = killed.length > 0 ? ` + killed ${killed.length} process${killed.length === 1 ? "" : "es"}` : "";
         const droppedCount = stateRef.current.queue.length;
         if (droppedCount > 0) {
           dispatch({ type: "queueClear" });
@@ -3695,7 +3804,7 @@ function App({
             type: "addEntry",
             entry: {
               kind: "warn",
-              text: `Iteration cancelled${director ? " + fleet terminated" : ""}. Dropped ${droppedCount} queued message${droppedCount === 1 ? "" : "s"}. Press Ctrl+C again to exit.`
+              text: `Iteration cancelled${director ? " + fleet terminated" : ""}${procTag}. Dropped ${droppedCount} queued message${droppedCount === 1 ? "" : "s"}. Press Ctrl+C again to exit.`
             }
           });
         } else {
@@ -3703,14 +3812,16 @@ function App({
             type: "addEntry",
             entry: {
               kind: "warn",
-              text: `Iteration cancelled${director ? " + fleet terminated" : ""}. Press Ctrl+C again to exit.`
+              text: `Iteration cancelled${director ? " + fleet terminated" : ""}${procTag}. Press Ctrl+C again to exit.`
             }
           });
         }
       } else {
+        const killed = getProcessRegistry().killAll();
+        const procTag = killed.length > 0 ? ` Killed ${killed.length} process${killed.length === 1 ? "" : "es"}.` : "";
         dispatch({
           type: "addEntry",
-          entry: { kind: "warn", text: "Press Ctrl+C again to exit." }
+          entry: { kind: "warn", text: `Press Ctrl+C again to exit.${procTag}` }
         });
       }
     };
@@ -4100,6 +4211,46 @@ function App({
   };
   const runBlocksRef = useRef(runBlocks);
   runBlocksRef.current = runBlocks;
+  const runEternalLoop = async () => {
+    const engine = getEternalEngine?.();
+    if (!engine) return;
+    if (eternalLoopRunningRef.current) return;
+    eternalLoopRunningRef.current = true;
+    try {
+      while (true) {
+        const liveMode = getAutonomy?.() ?? "off";
+        if (liveMode !== "eternal") break;
+        if (engine.currentState === "stopped") break;
+        dispatch({ type: "status", status: "running" });
+        try {
+          await engine.runOneIteration();
+        } catch (err) {
+          dispatch({
+            type: "addEntry",
+            entry: { kind: "error", text: `[eternal] ${err instanceof Error ? err.message : String(err)}` }
+          });
+        }
+        dispatch({ type: "status", status: "idle" });
+        await new Promise((r) => setTimeout(r, 200));
+      }
+    } finally {
+      eternalLoopRunningRef.current = false;
+    }
+  };
+  const eternalLoopRunningRef = useRef(false);
+  const runEternalLoopRef = useRef(runEternalLoop);
+  runEternalLoopRef.current = runEternalLoop;
+  useEffect(() => {
+    if (!subscribeEternalIteration) return;
+    const unsub = subscribeEternalIteration((entry) => {
+      const mark = entry.status === "success" ? "\u2713" : entry.status === "failure" ? "\u2717" : entry.status === "aborted" ? "\u2298" : "\xB7";
+      const cost = typeof entry.costUsd === "number" ? ` ($${entry.costUsd.toFixed(4)})` : "";
+      const note = entry.note ? ` \u2014 ${entry.note.slice(0, 80)}` : "";
+      const text = `#${entry.iteration} ${mark} [${entry.source}] ${entry.task}${cost}${note}`;
+      dispatch({ type: "addEntry", entry: { kind: "info", text } });
+    });
+    return unsub;
+  }, [subscribeEternalIteration]);
   const submit = async (overrideRaw) => {
     const raw = overrideRaw ?? draftRef.current.buffer;
     const trimmed = raw.trim();
@@ -4134,6 +4285,9 @@ function App({
         if (getAutonomy) {
           const currentAutonomy = getAutonomy();
           if (currentAutonomy !== autonomyLive) setAutonomyLive(currentAutonomy);
+          if (currentAutonomy === "eternal" && getEternalEngine) {
+            void runEternalLoopRef.current();
+          }
         }
         if (res?.exit) {
           exit();
@@ -4325,7 +4479,9 @@ User message:
         git: gitInfo,
         context: contextWindow,
         projectName,
-        subagentCount: Object.keys(state.fleet).length
+        subagentCount: Object.keys(state.fleet).length,
+        processCount: getProcessRegistry().activeCount,
+        hiddenItems
       }
     ),
     director ? /* @__PURE__ */ jsx(FleetPanel, { entries: state.fleet, totalCost: state.fleetCost, roster: fleetRoster }) : null
@@ -4453,6 +4609,8 @@ async function runTui(opts) {
           yolo: opts.yolo,
           getYolo: opts.getYolo,
           getAutonomy: opts.getAutonomy,
+          getEternalEngine: opts.getEternalEngine,
+          subscribeEternalIteration: opts.subscribeEternalIteration,
           appVersion: opts.appVersion,
           provider: opts.provider,
           family: opts.family,
@@ -4465,6 +4623,8 @@ async function runTui(opts) {
           fleetRoster: opts.fleetRoster,
           onClearHistory: opts.onClearHistory ? (dispatch) => opts.onClearHistory(dispatch) : void 0,
           fleetStreamController: opts.fleetStreamController,
+          statuslineHiddenItems: opts.statuslineHiddenItems,
+          setStatuslineHiddenItems: opts.setStatuslineHiddenItems,
           initialGoal: opts.initialGoal,
           initialAsk: opts.initialAsk,
           getSDDContext: opts.getSDDContext,
@@ -4502,6 +4662,6 @@ async function runTui(opts) {
   });
 }
 
-export { runTui };
+export { buildGoalPreamble, runTui };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map