reasonix 0.0.5 → 0.0.6

package/dist/index.d.ts

@@ -463,6 +463,12 @@ interface CacheFirstLoopOptions {
      * since the default selector scores samples by plan-state uncertainty.
      */
     branch?: number | BranchOptions;
+    /**
+     * Session name. When set, the loop pre-loads the session's prior messages
+     * into its log on construction, and appends every new log entry to
+     * `~/.reasonix/sessions/<name>.jsonl` so the next run can resume.
+     */
+    session?: string;
 }
 /**
  * Pillar 1 — Cache-First Loop.
@@ -494,9 +500,13 @@ declare class CacheFirstLoop {
     harvestOptions: HarvestOptions;
     branchEnabled: boolean;
     branchOptions: BranchOptions;
+    sessionName: string | null;
+    /** Number of messages that were pre-loaded from the session file. */
+    readonly resumedMessageCount: number;
     private _turn;
     private _streamPreference;
     constructor(opts: CacheFirstLoopOptions);
+    private appendAndPersist;
     /**
      * Reconfigure model/harvest/branch/stream mid-session. The loop's log,
      * scratch, and stats are preserved — only the per-turn behavior changes.
@@ -510,6 +520,38 @@ declare class CacheFirstLoop {
     private assistantMessage;
 }
 
+/**
+ * Session persistence.
+ *
+ * Every turn's log entries (user / assistant / tool messages) are appended to
+ * a JSONL file under `~/.reasonix/sessions/<name>.jsonl`. Next time the user
+ * starts the CLI with the same session name, the loop pre-loads the file
+ * into its AppendOnlyLog so the new turn has full prior context.
+ *
+ * Design notes:
+ *   - JSONL rather than JSON so concurrent writes don't corrupt.
+ *   - 0600 permissions on Unix (chmod no-ops on Windows).
+ *   - Name sanitization keeps paths safe: only [\w-] and CJK letters pass;
+ *     anything else is replaced with underscore, max 64 chars.
+ *   - The loop's stats/session aren't persisted — only the message log.
+ *     Cost accounting resets each run (by design — old costs are sunk).
+ */
+
+interface SessionInfo {
+    name: string;
+    path: string;
+    size: number;
+    messageCount: number;
+    mtime: Date;
+}
+declare function sessionsDir(): string;
+declare function sessionPath(name: string): string;
+declare function sanitizeName(name: string): string;
+declare function loadSessionMessages(name: string): ChatMessage[];
+declare function appendSessionMessage(name: string, message: ChatMessage): void;
+declare function listSessions(): SessionInfo[];
+declare function deleteSession(name: string): boolean;
+
 /**
  * Minimal `.env` loader; no dependency on dotenv.
  *
@@ -548,4 +590,4 @@ declare function redactKey(key: string): string;
 
 declare const VERSION = "0.0.1";
 
-export { AppendOnlyLog, type BranchOptions, type BranchProgress, type BranchResult, type BranchSample, type BranchSelector, type BranchSummary, CacheFirstLoop, type CacheFirstLoopOptions, type ChatMessage, type ChatResponse, DeepSeekClient, type DeepSeekClientOptions, type EventRole, type FlattenDecision, type HarvestOptions, ImmutablePrefix, type ImmutablePrefixOptions, type JSONSchema, type LoopEvent, type ReasonixConfig, type ReconfigurableOptions, type RepairReport, type RetryInfo, type RetryOptions, type Role, type ScavengeOptions, type ScavengeResult, SessionStats, type SessionSummary, StormBreaker, type StreamChunk, type ToolCall, ToolCallRepair, type ToolCallRepairOptions, type ToolDefinition, type ToolFunctionSpec, ToolRegistry, type ToolSpec, type TruncationRepairResult, type TurnStats, type TypedPlanState, Usage, VERSION, VolatileScratch, aggregateBranchUsage, analyzeSchema, claudeEquivalentCost, costUsd, defaultConfigPath, defaultSelector, emptyPlanState, fetchWithRetry, flattenSchema, harvest, isPlanStateEmpty, isPlausibleKey, loadApiKey, loadDotenv, nestArguments, readConfig, redactKey, repairTruncatedJson, runBranches, saveApiKey, scavengeToolCalls, writeConfig };
+export { AppendOnlyLog, type BranchOptions, type BranchProgress, type BranchResult, type BranchSample, type BranchSelector, type BranchSummary, CacheFirstLoop, type CacheFirstLoopOptions, type ChatMessage, type ChatResponse, DeepSeekClient, type DeepSeekClientOptions, type EventRole, type FlattenDecision, type HarvestOptions, ImmutablePrefix, type ImmutablePrefixOptions, type JSONSchema, type LoopEvent, type ReasonixConfig, type ReconfigurableOptions, type RepairReport, type RetryInfo, type RetryOptions, type Role, type ScavengeOptions, type ScavengeResult, type SessionInfo, SessionStats, type SessionSummary, StormBreaker, type StreamChunk, type ToolCall, ToolCallRepair, type ToolCallRepairOptions, type ToolDefinition, type ToolFunctionSpec, ToolRegistry, type ToolSpec, type TruncationRepairResult, type TurnStats, type TypedPlanState, Usage, VERSION, VolatileScratch, aggregateBranchUsage, analyzeSchema, appendSessionMessage, claudeEquivalentCost, costUsd, defaultConfigPath, defaultSelector, deleteSession, emptyPlanState, fetchWithRetry, flattenSchema, harvest, isPlanStateEmpty, isPlausibleKey, listSessions, loadApiKey, loadDotenv, loadSessionMessages, nestArguments, readConfig, redactKey, repairTruncatedJson, runBranches, sanitizeName as sanitizeSessionName, saveApiKey, scavengeToolCalls, sessionPath, sessionsDir, writeConfig };

package/dist/index.js

@@ -778,6 +778,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 },
@@ -934,6 +1021,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) {
@@ -957,6 +1047,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,
@@ -1144,7 +1251,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;
@@ -1153,7 +1260,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",
@@ -1171,7 +1278,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,
@@ -1207,12 +1314,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;
   }
@@ -1231,15 +1338,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 {
@@ -1247,10 +1354,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 {
   }
 }
@@ -1289,25 +1396,32 @@ export {
   VolatileScratch,
   aggregateBranchUsage,
   analyzeSchema,
+  appendSessionMessage,
   claudeEquivalentCost,
   costUsd,
   defaultConfigPath,
   defaultSelector,
+  deleteSession,
   emptyPlanState,
   fetchWithRetry,
   flattenSchema,
   harvest,
   isPlanStateEmpty,
   isPlausibleKey,
+  listSessions,
   loadApiKey,
   loadDotenv,
+  loadSessionMessages,
   nestArguments,
   readConfig,
   redactKey,
   repairTruncatedJson,
   runBranches,
+  sanitizeName as sanitizeSessionName,
   saveApiKey,
   scavengeToolCalls,
+  sessionPath,
+  sessionsDir,
   writeConfig
 };
 //# sourceMappingURL=index.js.map