reasonix 0.0.5 → 0.0.6

package/README.md

@@ -73,11 +73,18 @@ Measured on live DeepSeek API:
 ### CLI
 
 ```bash
-npx reasonix chat                # just chat — everything else is inside
+npx reasonix chat                # auto-saves to session 'default'; resumes next time
+npx reasonix chat --session work # use a different named session
+npx reasonix chat --no-session   # ephemeral — nothing persisted
 npx reasonix run "ask anything"  # one-shot, streams to stdout
 npx reasonix stats session.jsonl # read back a saved transcript
 ```
 
+Sessions live as JSONL under `~/.reasonix/sessions/<name>.jsonl` — every
+turn's message log is appended atomically, so killing the CLI never loses
+context. Inside the TUI: `/sessions` to list, `/forget` to delete the
+current one.
+
 ### Inside the chat — slash commands
 
 A command strip runs under the input box so you don't have to memorize

package/dist/cli/index.js

@@ -783,6 +783,93 @@ function signature2(call) {
   return `${call.function?.name ?? ""}::${call.function?.arguments ?? ""}`;
 }
 
+// src/session.ts
+import {
+  appendFileSync,
+  chmodSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  readdirSync,
+  statSync,
+  unlinkSync
+} from "fs";
+import { homedir } from "os";
+import { dirname, join } from "path";
+function sessionsDir() {
+  return join(homedir(), ".reasonix", "sessions");
+}
+function sessionPath(name) {
+  return join(sessionsDir(), `${sanitizeName(name)}.jsonl`);
+}
+function sanitizeName(name) {
+  const cleaned = name.replace(/[^\w\-\u4e00-\u9fa5]/g, "_").slice(0, 64);
+  return cleaned || "default";
+}
+function loadSessionMessages(name) {
+  const path = sessionPath(name);
+  if (!existsSync(path)) return [];
+  try {
+    const raw = readFileSync(path, "utf8");
+    const out = [];
+    for (const line of raw.split(/\r?\n/)) {
+      const trimmed = line.trim();
+      if (!trimmed) continue;
+      try {
+        const msg = JSON.parse(trimmed);
+        if (msg && typeof msg === "object" && "role" in msg) out.push(msg);
+      } catch {
+      }
+    }
+    return out;
+  } catch {
+    return [];
+  }
+}
+function appendSessionMessage(name, message) {
+  const path = sessionPath(name);
+  mkdirSync(dirname(path), { recursive: true });
+  appendFileSync(path, `${JSON.stringify(message)}
+`, "utf8");
+  try {
+    chmodSync(path, 384);
+  } catch {
+  }
+}
+function listSessions() {
+  const dir = sessionsDir();
+  if (!existsSync(dir)) return [];
+  try {
+    const files = readdirSync(dir).filter((f) => f.endsWith(".jsonl"));
+    return files.map((file) => {
+      const path = join(dir, file);
+      const stat = statSync(path);
+      const name = file.replace(/\.jsonl$/, "");
+      const messageCount = countLines(path);
+      return { name, path, size: stat.size, messageCount, mtime: stat.mtime };
+    }).sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+  } catch {
+    return [];
+  }
+}
+function deleteSession(name) {
+  const path = sessionPath(name);
+  try {
+    unlinkSync(path);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function countLines(path) {
+  try {
+    const raw = readFileSync(path, "utf8");
+    return raw.split(/\r?\n/).filter((l) => l.trim()).length;
+  } catch {
+    return 0;
+  }
+}
+
 // src/telemetry.ts
 var DEEPSEEK_PRICING = {
   "deepseek-chat": { inputCacheHit: 0.07, inputCacheMiss: 0.27, output: 1.1 },
@@ -939,6 +1026,9 @@ var CacheFirstLoop = class {
   harvestOptions;
   branchEnabled;
   branchOptions;
+  sessionName;
+  /** Number of messages that were pre-loaded from the session file. */
+  resumedMessageCount;
   _turn = 0;
   _streamPreference;
   constructor(opts) {
@@ -962,6 +1052,23 @@ var CacheFirstLoop = class {
     this.stream = this.branchEnabled ? false : this._streamPreference;
     const allowedNames = /* @__PURE__ */ new Set([...this.prefix.toolSpecs.map((s) => s.function.name)]);
     this.repair = new ToolCallRepair({ allowedToolNames: allowedNames });
+    this.sessionName = opts.session ?? null;
+    if (this.sessionName) {
+      const prior = loadSessionMessages(this.sessionName);
+      for (const msg of prior) this.log.append(msg);
+      this.resumedMessageCount = prior.length;
+    } else {
+      this.resumedMessageCount = 0;
+    }
+  }
+  appendAndPersist(message) {
+    this.log.append(message);
+    if (this.sessionName) {
+      try {
+        appendSessionMessage(this.sessionName, message);
+      } catch {
+      }
+    }
   }
   /**
    * Reconfigure model/harvest/branch/stream mid-session. The loop's log,
@@ -1149,7 +1256,7 @@ var CacheFirstLoop = class {
       }
       const turnStats = this.stats.record(this._turn, this.model, usage ?? new Usage());
       if (pendingUser !== null) {
-        this.log.append({ role: "user", content: pendingUser });
+        this.appendAndPersist({ role: "user", content: pendingUser });
         pendingUser = null;
       }
       this.scratch.reasoning = reasoningContent || null;
@@ -1158,7 +1265,7 @@ var CacheFirstLoop = class {
         toolCalls,
         reasoningContent || null
       );
-      this.log.append(this.assistantMessage(assistantContent, repairedCalls));
+      this.appendAndPersist(this.assistantMessage(assistantContent, repairedCalls));
       yield {
         turn: this._turn,
         role: "assistant_final",
@@ -1176,7 +1283,7 @@ var CacheFirstLoop = class {
         const name = call.function?.name ?? "";
         const args = call.function?.arguments ?? "{}";
         const result = await this.tools.dispatch(name, args);
-        this.log.append({
+        this.appendAndPersist({
           role: "tool",
           tool_call_id: call.id ?? "",
           name,
@@ -1212,12 +1319,12 @@ function summarizeBranch(chosen, samples) {
 }
 
 // src/env.ts
-import { readFileSync } from "fs";
+import { readFileSync as readFileSync2 } from "fs";
 import { resolve } from "path";
 function loadDotenv(path = ".env") {
   let raw;
   try {
-    raw = readFileSync(resolve(process.cwd(), path), "utf8");
+    raw = readFileSync2(resolve(process.cwd(), path), "utf8");
   } catch {
     return;
   }
@@ -1236,15 +1343,15 @@ function loadDotenv(path = ".env") {
 }
 
 // src/config.ts
-import { chmodSync, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
-import { homedir } from "os";
-import { dirname, join } from "path";
+import { chmodSync as chmodSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync3, writeFileSync } from "fs";
+import { homedir as homedir2 } from "os";
+import { dirname as dirname2, join as join2 } from "path";
 function defaultConfigPath() {
-  return join(homedir(), ".reasonix", "config.json");
+  return join2(homedir2(), ".reasonix", "config.json");
 }
 function readConfig(path = defaultConfigPath()) {
   try {
-    const raw = readFileSync2(path, "utf8");
+    const raw = readFileSync3(path, "utf8");
     const parsed = JSON.parse(raw);
     if (parsed && typeof parsed === "object") return parsed;
   } catch {
@@ -1252,10 +1359,10 @@ function readConfig(path = defaultConfigPath()) {
   return {};
 }
 function writeConfig(cfg, path = defaultConfigPath()) {
-  mkdirSync(dirname(path), { recursive: true });
+  mkdirSync2(dirname2(path), { recursive: true });
   writeFileSync(path, JSON.stringify(cfg, null, 2), "utf8");
   try {
-    chmodSync(path, 384);
+    chmodSync2(path, 384);
   } catch {
   }
 }
@@ -1629,15 +1736,51 @@ function handleSlash(cmd, args, loop) {
           "  /model <id>              deepseek-chat or deepseek-reasoner",
           "  /harvest [on|off]        Pillar 2: structured plan-state extraction",
           "  /branch <N|off>          run N parallel samples (N>=2), pick most confident",
-          "  /clear                   clear displayed history (log is kept)",
+          "  /sessions                list saved sessions (current is marked with \u25B8)",
+          "  /forget                  delete the current session from disk",
+          "  /clear                   clear displayed history (log + session kept)",
           "  /exit                    quit",
           "",
           "Presets:",
           "  fast   deepseek-chat   no harvest  no branch    ~1\xA2/100turns  \u2190 default",
           "  smart  reasoner        harvest                  ~10x cost, slower",
-          "  max    reasoner        harvest     branch 3     ~30x cost, slowest"
+          "  max    reasoner        harvest     branch 3     ~30x cost, slowest",
+          "",
+          "Sessions (auto-enabled by default, named 'default'):",
+          "  reasonix chat --session <name>   use a different named session",
+          "  reasonix chat --no-session       disable persistence for this run"
         ].join("\n")
       };
+    case "sessions": {
+      const items = listSessions();
+      if (items.length === 0) {
+        return {
+          info: "no saved sessions yet \u2014 chat normally and your messages will be saved automatically"
+        };
+      }
+      const lines = ["Saved sessions:"];
+      for (const s of items) {
+        const sizeKb = (s.size / 1024).toFixed(1);
+        const when = s.mtime.toISOString().replace("T", " ").slice(0, 16);
+        const marker = s.name === loop.sessionName ? "\u25B8" : " ";
+        lines.push(
+          `  ${marker} ${s.name.padEnd(22)} ${String(s.messageCount).padStart(5)} msgs  ${sizeKb.padStart(7)} KB  ${when}`
+        );
+      }
+      lines.push("");
+      lines.push("Resume with: reasonix chat --session <name>");
+      return { info: lines.join("\n") };
+    }
+    case "forget": {
+      if (!loop.sessionName) {
+        return { info: "not in a session \u2014 nothing to forget" };
+      }
+      const name = loop.sessionName;
+      const ok = deleteSession(name);
+      return {
+        info: ok ? `\u25B8 deleted session "${name}" \u2014 current screen still shows the conversation, but next launch starts fresh` : `could not delete session "${name}" (already gone?)`
+      };
+    }
     case "status": {
       const branchBudget = loop.branchOptions.budget ?? 1;
       return {
@@ -1697,7 +1840,7 @@ function handleSlash(cmd, args, loop) {
 
 // src/cli/ui/App.tsx
 var FLUSH_INTERVAL_MS = 60;
-function App({ model, system, transcript, harvest: harvest2, branch }) {
+function App({ model, system, transcript, harvest: harvest2, branch, session }) {
   const { exit } = useApp();
   const [historical, setHistorical] = useState2([]);
   const [streaming, setStreaming] = useState2(null);
@@ -1724,10 +1867,43 @@ function App({ model, system, transcript, harvest: harvest2, branch }) {
     if (loopRef.current) return loopRef.current;
     const client = new DeepSeekClient();
     const prefix = new ImmutablePrefix({ system });
-    const l = new CacheFirstLoop({ client, prefix, model, harvest: harvest2, branch });
+    const l = new CacheFirstLoop({ client, prefix, model, harvest: harvest2, branch, session });
     loopRef.current = l;
     return l;
-  }, [model, system, harvest2, branch]);
+  }, [model, system, harvest2, branch, session]);
+  const sessionBannerShown = useRef(false);
+  useEffect2(() => {
+    if (sessionBannerShown.current) return;
+    sessionBannerShown.current = true;
+    if (!session) {
+      setHistorical((prev) => [
+        ...prev,
+        {
+          id: `sys-session-${Date.now()}`,
+          role: "info",
+          text: "\u25B8 ephemeral chat (no session persistence) \u2014 drop --no-session to enable"
+        }
+      ]);
+    } else if (loop.resumedMessageCount > 0) {
+      setHistorical((prev) => [
+        ...prev,
+        {
+          id: `sys-resume-${Date.now()}`,
+          role: "info",
+          text: `\u25B8 resumed session "${session}" with ${loop.resumedMessageCount} prior messages \xB7 /forget to start over \xB7 /sessions to list`
+        }
+      ]);
+    } else {
+      setHistorical((prev) => [
+        ...prev,
+        {
+          id: `sys-newsession-${Date.now()}`,
+          role: "info",
+          text: `\u25B8 session "${session}" (new) \u2014 auto-saved as you chat \xB7 /forget to delete \xB7 /sessions to list`
+        }
+      ]);
+    }
+  }, [session, loop]);
   const prefixHash = loop.prefix.fingerprint;
   const writeTranscript = useCallback((ev) => {
     transcriptRef.current?.write(
@@ -1873,7 +2049,7 @@ function App({ model, system, transcript, harvest: harvest2, branch }) {
   ), /* @__PURE__ */ React5.createElement(Static, { items: historical }, (item) => /* @__PURE__ */ React5.createElement(EventRow, { key: item.id, event: item })), streaming ? /* @__PURE__ */ React5.createElement(Box5, { marginY: 1 }, /* @__PURE__ */ React5.createElement(EventRow, { event: streaming })) : null, /* @__PURE__ */ React5.createElement(PromptInput, { value: input, onChange: setInput, onSubmit: handleSubmit, disabled: busy }), /* @__PURE__ */ React5.createElement(CommandStrip, null));
 }
 function CommandStrip() {
-  return /* @__PURE__ */ React5.createElement(Box5, { paddingX: 2 }, /* @__PURE__ */ React5.createElement(Text5, { dimColor: true }, "/help \xB7 /preset ", "<fast|smart|max>", " \xB7 /model \xB7 /harvest \xB7 /branch \xB7 /clear \xB7 /exit"));
+  return /* @__PURE__ */ React5.createElement(Box5, { paddingX: 2 }, /* @__PURE__ */ React5.createElement(Text5, { dimColor: true }, "/help \xB7 /preset ", "<fast|smart|max>", " \xB7 /sessions \xB7 /model \xB7 /harvest \xB7 /branch \xB7 /clear \xB7 /exit"));
 }
 function describeRepair(repair) {
   const parts = [];
@@ -1944,7 +2120,8 @@ function Root({ initialKey, ...appProps }) {
       system: appProps.system,
       transcript: appProps.transcript,
       harvest: appProps.harvest,
-      branch: appProps.branch
+      branch: appProps.branch,
+      session: appProps.session
     }
   );
 }
@@ -2017,13 +2194,13 @@ async function runCommand(opts) {
 }
 
 // src/cli/commands/stats.ts
-import { existsSync, readFileSync as readFileSync3 } from "fs";
+import { existsSync as existsSync2, readFileSync as readFileSync4 } from "fs";
 function statsCommand(opts) {
-  if (!existsSync(opts.transcript)) {
+  if (!existsSync2(opts.transcript)) {
     console.error(`no such transcript: ${opts.transcript}`);
     process.exit(1);
   }
-  const lines = readFileSync3(opts.transcript, "utf8").split(/\r?\n/).filter(Boolean);
+  const lines = readFileSync4(opts.transcript, "utf8").split(/\r?\n/).filter(Boolean);
   let assistantTurns = 0;
   let toolCalls = 0;
   let lastTurn = 0;
@@ -2058,13 +2235,25 @@ program.command("chat").description("Interactive Ink TUI with live cache/cost pa
   "--branch <n>",
   "Self-consistency: run N parallel samples per turn and pick the most confident (disables streaming; enables harvest)",
   (v) => Number.parseInt(v, 10)
-).action(async (opts) => {
+).option(
+  "--session <name>",
+  "Use a named session (default: 'default'). Resume the same session next time."
+).option("--no-session", "Disable session persistence for this run (ephemeral chat)").action(async (opts) => {
+  let session;
+  if (opts.session === false) {
+    session = void 0;
+  } else if (typeof opts.session === "string" && opts.session.length > 0) {
+    session = opts.session;
+  } else {
+    session = "default";
+  }
   await chatCommand({
     model: opts.model,
     system: opts.system,
     transcript: opts.transcript,
     harvest: !!opts.harvest,
-    branch: Number.isFinite(opts.branch) && opts.branch > 1 ? opts.branch : void 0
+    branch: Number.isFinite(opts.branch) && opts.branch > 1 ? opts.branch : void 0,
+    session
   });
 });
 program.command("run <task>").description("Run a single task non-interactively, streaming output.").option("-m, --model <id>", "DeepSeek model id", "deepseek-chat").option("-s, --system <prompt>", "System prompt", DEFAULT_SYSTEM).action(async (task, opts) => {