@corenel/cli 0.3.1 → 0.3.2

package/README.md

@@ -7,7 +7,33 @@ transport). Early/beta: the headless proof the kernel runs outside the browser.
 npx @corenel/cli
 ```
 
-Requires Node 18+. Bring your provider key via the environment. More verbs
-(`run` / `ask` / `chat` / `login`, and `start --sidecar`) are in progress.
+Requires Node 18+. Bring your provider key via the environment.
+
+Running `corenel` with no command opens an interactive agent in the current
+directory. On a terminal it opens the full terminal face; when output is piped,
+under `TERM=dumb`, in CI, or with `--no-tui`, it falls back to a plain
+line-by-line loop. `--tui` demands the full face and fails rather than falling
+back. `--resume` reopens the last conversation.
+
+Assistant replies render as markdown. More verbs (`run` / `ask` / `chat` /
+`login`, and `start --sidecar`) are in progress.
+
+## Releasing
+
+`@corenel/term` (the terminal face) is a real runtime dependency, not bundled
+into `dist/cli.js` -- see the note at the top of `build.mjs`. It therefore has
+to be published FIRST; publishing `@corenel/cli` against an unpublished
+`@corenel/term` yields a package that cannot install at all, so `npx
+@corenel/cli` fails before any verb runs.
+
+    pnpm --filter @corenel/term build && pnpm --filter @corenel/term publish
+    pnpm --filter @corenel/cli  build && pnpm --filter @corenel/cli  publish
+
+Publish with **pnpm, never npm**: this CLI depends on `@corenel/term` as
+`workspace:*`, and pnpm rewrites the `workspace:` protocol to a real version at
+pack/publish time while npm ships it verbatim -- an `npm publish` from this
+workspace produces a manifest whose install fails with
+`EUNSUPPORTEDPROTOCOL / Unsupported URL Type "workspace:"`, which is the very
+breakage this section exists to prevent.
 
 Licensed under Elastic-2.0.

package/dist/cli.js

@@ -20356,6 +20356,7 @@ function nodeToolCtx(signal, opts = {}) {
     kv: inMemoryKv(),
     search: nullSearch,
     confirm: async () => true,
+    ...opts.ask ? { ask: opts.ask } : {},
     ...opts.files ? { files: opts.files, fileMeta: { kind: opts.files.kind, label: opts.files.label, isLocalDisk: opts.files.isLocalDisk, writable: opts.files.writable } } : {}
   };
 }
@@ -20936,11 +20937,11 @@ async function runExtension(ext, rest, look = {}) {
 // src/commands.ts
 var COMMANDS = [
   { name: "", args: "", summary: "with no command: an interactive agent in this directory" },
-  { name: "run", args: '"<prompt>"', summary: "one-shot turn, then exit" },
+  { name: "run", args: '"<prompt>" [--session ID]', summary: "one-shot turn, then exit (--session runs it inside a sandbox)" },
   { name: "run-agent", args: '<name> --input "<text>"', summary: "run a crew agent; events as JSON Lines on stdout" },
   { name: "sidecar", args: "[start] [flags]", summary: "run the sidecar on this machine" },
   { name: "acp", args: "<agent> [flags]", summary: "proxy an external coding agent under Corenel policy" },
-  { name: "sessions", args: "[list|show <id>]", summary: "list and inspect local sandbox sessions" },
+  { name: "sessions", args: "[list|show|create|run]", summary: "create, list and run in local sandbox sessions" },
   { name: "login", args: "[--base URL]", summary: "sign in through your browser (device flow)" },
   { name: "auth", summary: "show whether you are signed in, and as what" },
   { name: "logout", summary: "forget the stored token" },
@@ -20972,10 +20973,18 @@ function helpText(version2) {
     "  --model <id>     model for this turn (default gpt-4o-mini)",
     "  --base <url>     API base (default https://api.corenel.ai/api, or CORENEL_API_BASE)",
     "  --allow-shell    run commands without asking each time",
+    "  --no-tui         plain line-by-line mode (automatic when output is piped)",
+    "  --tui            force the full terminal face, and fail if it cannot start",
+    "  --resume [id]    reopen the last conversation, or the one named",
     "  --debug          trace every agent step (also CORENEL_DEBUG=1)",
     "  --version, -v    print the version",
     "  --help, -h       print this",
     "",
+    "--resume reopens a CONVERSATION (this face's own chat log, saved under",
+    ".corenel/sessions/) -- not the same thing as `run --session ID` or the",
+    "`sessions` command below, which forward into a sandbox on the sidecar.",
+    "Same word, two different nouns.",
+    "",
     "sidecar, acp and sessions are provided by @corenel/sidecar, installed separately.",
     "Each takes its own flags: `corenel sidecar --help`.",
     ""
@@ -21140,35 +21149,38 @@ ${failed.length} problem${failed.length > 1 ? "s" : ""} above.
 
 // src/repl.ts
 import { createInterface } from "node:readline";
+import { TermSession } from "@corenel/term/session";
+import { describeToolCall } from "@corenel/term/describe";
 function isQuit(line) {
   const t = line.trim().toLowerCase();
   return t === "/exit" || t === "/quit" || t === "exit" || t === "quit";
 }
-function isClear(line) {
-  return line.trim().toLowerCase() === "/clear";
-}
-function isToolsCmd(line) {
-  const t = line.trim().toLowerCase();
-  return t === "/tools" || t === "/help";
+function nextShownCursor(itemsLength, shown) {
+  return itemsLength < shown ? 0 : shown;
 }
-function formatTools2(tools) {
-  const w = Math.max(...tools.map((t) => t.name.length));
-  const line = (t) => {
-    const what = t.means ?? t.description.split(". ")[0];
-    return `  ${t.name.padEnd(w)}  ${t.mutates ? "*" : " "} ${what}`;
-  };
-  return [
-    `${tools.length} tools available (* = can change things, and will ask first):`,
-    ...[...tools].sort((a, b) => a.name.localeCompare(b.name)).map(line)
-  ].join("\n");
+function formatQuestion(q) {
+  const lines = [`  ${q.header}  ${q.question}`];
+  q.options.forEach((o, i) => {
+    lines.push(`    ${i + 1}) ${o.label}`);
+  });
+  return `${lines.join("\n")}
+`;
 }
-function describeToolCall(name, args) {
-  const a = args ?? {};
-  const subject = a.path ?? a.file ?? a.command ?? a.cmd ?? a.query ?? a.pattern ?? a.url;
-  const text = typeof subject === "string" ? subject : "";
-  const trimmed = text.length > 68 ? `${text.slice(0, 67)}\u2026` : text;
-  return trimmed ? `${name} ${trimmed}` : name;
+function parseQuestionAnswer(q, line) {
+  if (line === null) return null;
+  const t = line.trim();
+  if (!t) return null;
+  if (/^\d+$/.test(t)) {
+    const n = Number(t);
+    if (n >= 1 && n <= q.options.length) return { [q.header]: [q.options[n - 1].label] };
+  }
+  return { [q.header]: [t] };
 }
+var REPL_BANNER = (model, cwd) => [
+  `corenel \u2014 ${model}, working in ${cwd}`,
+  "Type a request. /clear forgets the conversation, /exit leaves, Ctrl-C stops a turn.",
+  ""
+].join("\n");
 function makeEventRenderer(write) {
   let streaming = false;
   const endStream = () => {
@@ -21183,23 +21195,15 @@ function makeEventRenderer(write) {
         streaming = true;
         write(e.delta);
         break;
-      case "tool-call":
+      case "tool-call": {
         endStream();
-        write(`  \xB7 ${describeToolCall(e.name, e.args)}
+        const subject = describeToolCall(e.name, e.args);
+        write(`  \xB7 ${e.name}${subject ? ` ${subject}` : ""}
 `);
         break;
+      }
       case "tool-result":
         if (e.isError) write(`  ! ${e.name} failed
-`);
-        break;
-      case "policy-violation":
-        endStream();
-        write(`  ! ${e.action === "stop" ? "blocked" : "warning"}: ${e.message}
-`);
-        break;
-      case "error":
-        endStream();
-        write(`  ! ${e.message}
 `);
         break;
       case "done":
@@ -21210,18 +21214,53 @@ function makeEventRenderer(write) {
     }
   };
 }
-var REPL_BANNER = (model, cwd) => [
-  `corenel \u2014 ${model}, working in ${cwd}`,
-  "Type a request. /clear forgets the conversation, /exit leaves, Ctrl-C stops a turn.",
-  ""
-].join("\n");
 async function runRepl(deps) {
   const input = deps.input ?? process.stdin;
   const output = deps.output ?? process.stdout;
+  let atLineStart = true;
   const write = (s) => {
     output.write(s);
+    if (s.length > 0) atLineStart = s.endsWith("\n");
+  };
+  const writeLine = (s) => {
+    if (!atLineStart) write("\n");
+    write(s);
   };
   write(REPL_BANNER(deps.model, deps.cwd));
+  const render = makeEventRenderer(write);
+  const session = new TermSession({
+    cwd: deps.cwd,
+    model: deps.model,
+    system: deps.system,
+    client: deps.client,
+    tools: deps.tools,
+    toolCtx: (signal, askUser) => deps.toolCtx(signal, askUser),
+    onEvent: render,
+    ...deps.runner ? { runner: deps.runner } : {},
+    ...deps.approveAll ? { approveAll: true } : {},
+    ...deps.persistence ? { persistence: deps.persistence } : {}
+  });
+  let shown = 0;
+  session.subscribe(() => {
+    const items = session.getSnapshot().committed;
+    shown = nextShownCursor(items.length, shown);
+    for (; shown < items.length; shown++) {
+      const it = items[shown];
+      if (it.kind !== "note") continue;
+      writeLine(`  ${it.level === "info" ? "" : "! "}${it.text}
+`);
+      if (it.detail) write(`${it.detail}
+`);
+    }
+  });
+  if (deps.resume) {
+    await session.resume(deps.resume.id);
+    const restored = session.getSnapshot();
+    if (restored.session) {
+      writeLine(`  resumed ${restored.session.id} - ${restored.committed.length} messages
+`);
+    }
+  }
   const rl = createInterface({ input, output });
   let closed = false;
   rl.on("close", () => {
@@ -21235,13 +21274,10 @@ async function runRepl(deps) {
       resolve2(answer);
     });
   });
-  let history = [];
-  let turn = null;
+  let turnActive = false;
   const onSigint = () => {
-    if (turn) {
-      turn.abort();
-      write("\n(stopped)\n");
-    } else {
+    if (turnActive) session.abort();
+    else {
       write("\n");
       rl.close();
     }
@@ -21261,57 +21297,46 @@ async function runRepl(deps) {
       }
     }
   });
+  session.attachPermission(permission);
+  let questionOpen = false;
+  session.subscribe(() => {
+    const modal = session.getSnapshot().modal;
+    if (!modal || modal.kind !== "user") {
+      questionOpen = false;
+      return;
+    }
+    if (questionOpen) return;
+    questionOpen = true;
+    const q = modal.questions[0];
+    if (!q) {
+      session.answer(null);
+      return;
+    }
+    writeLine(formatQuestion(q));
+    void ask("  answer (number, text, or empty to skip): ").then((line) => {
+      if (session.getSnapshot().modal?.kind !== "user") return;
+      session.answer(parseQuestionAnswer(q, line));
+    });
+  });
   for (; ; ) {
     const line = await ask("\u203A ");
     if (line === null) break;
     const text = line.trim();
     if (!text) continue;
     if (isQuit(text)) break;
-    if (isClear(text)) {
-      history = [];
-      write("(conversation cleared)\n");
-      continue;
-    }
-    if (isToolsCmd(text)) {
-      write(`${formatTools2(deps.tools)}
-`);
-      continue;
-    }
-    history.push({ role: "user", content: text });
-    turn = new AbortController();
-    try {
-      let streamed = false;
-      const render = makeEventRenderer((s) => {
-        if (s.trim()) streamed = true;
-        write(s);
-      });
-      const result = await runAgent({
-        client: deps.client,
-        model: deps.model,
-        system: deps.system,
-        messages: history,
-        tools: deps.tools,
-        toolCtx: deps.toolCtx(turn.signal),
-        signal: turn.signal,
-        permission,
-        onEvent: render
-      });
-      history = result.messages;
-      if (!streamed && result.text) write(`${result.text}
-`);
-    } catch (e) {
-      if (!turn.signal.aborted) write(`error: ${e instanceof Error ? e.message : String(e)}
-`);
-      history = history.slice(0, -1);
-    } finally {
-      turn = null;
-    }
+    turnActive = true;
+    await session.submit(text);
+    turnActive = false;
+    if (session.wantsExit) break;
   }
   rl.off("SIGINT", onSigint);
   rl.close();
   return 0;
 }
 
+// src/cli.ts
+import { createSessionPersistence } from "@corenel/term/persist";
+
 // src/shellTool.ts
 import { spawn as spawn2 } from "node:child_process";
 var MAX_OUTPUT = 3e4;
@@ -21417,6 +21442,31 @@ function shellTool(cwd) {
   };
 }
 
+// src/tuiChoice.ts
+function chooseFace(env) {
+  if (env.argv.includes("--no-tui")) return "readline";
+  if (env.argv.includes("--tui")) return "tui";
+  if (!env.stdinTty || !env.stdoutTty) return "readline";
+  if (env.term === "dumb") return "readline";
+  if (env.ci) return "readline";
+  return "tui";
+}
+var TuiUnavailableError = class extends Error {
+  constructor(cause) {
+    super(`the terminal face could not start: ${cause instanceof Error ? cause.message : String(cause)}`);
+    this.name = "TuiUnavailableError";
+  }
+};
+function currentFaceEnv(argv) {
+  return {
+    stdinTty: process.stdin.isTTY === true,
+    stdoutTty: process.stdout.isTTY === true,
+    term: process.env.TERM,
+    ci: Boolean(process.env.CI),
+    argv
+  };
+}
+
 // src/cli.ts
 function flag(argv, name, fallback) {
   const i = argv.indexOf(`--${name}`);
@@ -21469,9 +21519,15 @@ async function agentSetup(argv) {
 async function run(argv) {
   const prompt = promptOf(argv);
   if (!prompt) {
-    process.stderr.write('usage: corenel run "<prompt>" [--model M] [--base URL]\n');
+    process.stderr.write('usage: corenel run "<prompt>" [--model M] [--base URL] [--session ID]\n');
     process.exit(2);
   }
+  const session = flag(argv, "session", "");
+  if (session) {
+    const ext = findExtension("sessions");
+    process.exitCode = ext ? await runExtension(ext, ["run", session, prompt]) : 2;
+    return;
+  }
   const { client, model, system, tools } = await agentSetup(argv);
   const ac = new AbortController();
   const result = await runAgent({
@@ -21487,16 +21543,47 @@ async function run(argv) {
 }
 async function interactive(argv) {
   const { client, model, system, tools } = await agentSetup(argv);
+  const approveAll = argv.includes("--allow-shell");
+  const cwd = process.cwd();
+  const files = new NodeFileService(cwd);
+  const persistence = createSessionPersistence(files);
+  const resumeAt = argv.indexOf("--resume");
+  const resumeId = resumeAt >= 0 && argv[resumeAt + 1] && !argv[resumeAt + 1].startsWith("--") ? argv[resumeAt + 1] : void 0;
+  const resume = resumeAt >= 0 ? { id: resumeId } : void 0;
+  if (chooseFace(currentFaceEnv(argv)) === "tui") {
+    try {
+      const { runTui } = await import("@corenel/term/ink");
+      process.exitCode = await runTui({
+        cwd,
+        model,
+        system,
+        client,
+        tools,
+        version: version(),
+        toolCtx: (signal, ask) => nodeToolCtx(signal, { files, ask }),
+        ...approveAll ? { approveAll: true } : {},
+        persistence,
+        ...resume ? { resume } : {}
+      });
+      return;
+    } catch (e) {
+      if (argv.includes("--tui")) throw new TuiUnavailableError(e);
+      process.stderr.write(`corenel: terminal face unavailable, falling back (${e instanceof Error ? e.message : String(e)})
+`);
+    }
+  }
   process.exitCode = await runRepl({
     client,
     model,
     system,
     tools,
-    toolCtx: (signal) => nodeToolCtx(signal, { files: new NodeFileService(process.cwd()) }),
-    cwd: process.cwd(),
+    toolCtx: (signal, ask) => nodeToolCtx(signal, { files, ...ask ? { ask } : {} }),
+    cwd,
     // --allow-shell skips the per-command prompt. Named after the sidecar's
     // flag, which grants the same thing.
-    approveAll: argv.includes("--allow-shell")
+    approveAll,
+    persistence,
+    ...resume ? { resume } : {}
   });
 }
 async function main() {

package/package.json

@@ -1,30 +1,24 @@
 {
   "name": "@corenel/cli",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "type": "module",
   "description": "Corenel CLI — runs the harness in node, in-proc, no transport. The headless proof the kernel is host-agnostic. (corenel run/ask/chat/login + start --sidecar to follow.)",
   "bin": {
     "corenel": "dist/cli.js"
   },
-  "scripts": {
-    "typecheck": "tsc --noEmit",
-    "start": "tsx src/cli.ts",
-    "verify": "tsx src/verify.ts",
-    "build": "node build.mjs",
-    "prepublishOnly": "node build.mjs"
-  },
   "dependencies": {
-    "openai": "^4.77.0"
+    "openai": "^4.77.0",
+    "@corenel/term": "0.1.0"
   },
   "devDependencies": {
-    "@corenel/crew": "workspace:*",
-    "@corenel/harness": "workspace:*",
-    "@corenel/protocol": "workspace:*",
-    "@corenel/tools-node": "workspace:*",
     "esbuild": "^0.21.5",
     "@types/node": "^24.13.1",
     "tsx": "^4.19.2",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "@corenel/crew": "0.0.0",
+    "@corenel/protocol": "0.3.2",
+    "@corenel/harness": "0.3.2",
+    "@corenel/tools-node": "0.2.0"
   },
   "publishConfig": {
     "access": "public"
@@ -36,5 +30,11 @@
   ],
   "engines": {
     "node": ">=18"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "start": "tsx src/cli.ts",
+    "verify": "tsx src/verify.ts",
+    "build": "node build.mjs"
   }
-}
+}