reasonix 0.3.0-alpha.4 → 0.3.1

package/dist/index.d.ts

@@ -244,6 +244,14 @@ declare class AppendOnlyLog {
     private _entries;
     append(message: ChatMessage): void;
     extend(messages: ChatMessage[]): void;
+    /**
+     * Bulk-replace entries. Intentionally named to be hard to reach for —
+     * this is the one mutation path that breaks the log's append-only
+     * spirit, reserved for compaction flows (`/compact`) and recovery
+     * where the caller has consciously decided to drop old history. Any
+     * other use is almost certainly wrong; append() is what you want.
+     */
+    compactInPlace(replacement: ChatMessage[]): void;
     get entries(): readonly ChatMessage[];
     toMessages(): ChatMessage[];
     get length(): number;
@@ -379,6 +387,13 @@ interface SessionSummary {
     claudeEquivalentUsd: number;
     savingsVsClaudePct: number;
     cacheHitRatio: number;
+    /**
+     * Most recent turn's prompt-token count. Used by the TUI's context
+     * gauge: we can't know the next call's cost without making it, but
+     * the last turn's prompt tokens is the floor (next call is last
+     * prompt + user delta + any new tool outputs).
+     */
+    lastPromptTokens: number;
 }
 declare class SessionStats {
     readonly turns: TurnStats[];
@@ -514,6 +529,21 @@ declare class CacheFirstLoop {
     private _turn;
     private _streamPreference;
     constructor(opts: CacheFirstLoopOptions);
+    /**
+     * Shrink the log by re-truncating oversized tool results to a tighter
+     * cap, and persist the result back to disk so the next launch doesn't
+     * re-inherit a fat session file. Returns a summary the TUI can
+     * display.
+     *
+     * Only tool-role messages are touched (same rationale as
+     * {@link healLoadedMessages}). User and assistant messages carry
+     * authored intent we can't mechanically shrink without losing
+     * meaning.
+     */
+    compact(tightCapChars?: number): {
+        healedCount: number;
+        charsSaved: number;
+    };
     private appendAndPersist;
     /**
      * Reconfigure model/harvest/branch/stream mid-session. The loop's log,
@@ -524,9 +554,30 @@ declare class CacheFirstLoop {
     configure(opts: ReconfigurableOptions): void;
     private buildMessages;
     step(userInput: string): AsyncGenerator<LoopEvent>;
+    private forceSummaryAfterIterLimit;
     run(userInput: string, onEvent?: (ev: LoopEvent) => void): Promise<string>;
     private assistantMessage;
 }
+/**
+ * Truncate any tool-role message whose content exceeds the cap. User
+ * and assistant messages are left alone because (a) they're almost
+ * always small, (b) truncating user prompts would corrupt conversational
+ * intent in a way the user didn't author. Exported for tests.
+ */
+declare function healLoadedMessages(messages: ChatMessage[], maxChars: number): {
+    messages: ChatMessage[];
+    healedCount: number;
+    healedFrom: number;
+};
+/**
+ * Annotate the `DeepSeek 400: … maximum context length …` error the API
+ * returns when a session's history has grown past 131,072 tokens. The
+ * raw message is a JSON blob; we surface a short actionable hint on top
+ * so the user knows to `/forget` or `/clear` rather than parsing the
+ * JSON themselves. Other errors pass through unchanged — the loop's
+ * error channel already formats them well enough.
+ */
+declare function formatLoopError(err: Error): string;
 
 /**
  * Session persistence.
@@ -1069,7 +1120,26 @@ interface BridgeOptions {
     registry?: ToolRegistry;
     /** Auto-flatten deep schemas (Pillar 3). Defaults to the registry's own default (true). */
     autoFlatten?: boolean;
+    /**
+     * Per-tool-call result cap, in characters. If a tool returns more than
+     * this, the result is truncated and a `[…truncated N chars…]` marker is
+     * appended before the last KB so the model still sees a useful tail.
+     * Defaults to {@link DEFAULT_MAX_RESULT_CHARS}.
+     *
+     * Why this exists: DeepSeek V3's context is 131,072 tokens. A single
+     * `read_file` against a big source file can return >3 MB of text
+     * (~900k tokens) and permanently poison the session — every subsequent
+     * turn rebuilds the history and 400s. This cap is a floor. Users who
+     * legitimately want bigger payloads can raise it explicitly.
+     */
+    maxResultChars?: number;
 }
+/**
+ * 32,000 chars ≈ 8k English tokens, or ~16k CJK tokens. Small enough to
+ * fit comfortably in history even across 5–10 tool calls, large enough
+ * that most file reads and directory listings fit un-truncated.
+ */
+declare const DEFAULT_MAX_RESULT_CHARS = 32000;
 interface BridgeResult {
     registry: ToolRegistry;
     /** Names actually registered (may differ from MCP names when a prefix is applied). */
@@ -1088,6 +1158,10 @@ interface BridgeResult {
  * they fit Reasonix's existing tool-dispatch contract.
  */
 declare function bridgeMcpTools(client: McpClient, opts?: BridgeOptions): Promise<BridgeResult>;
+interface FlattenOptions {
+    /** Cap the flattened string at this many characters. Default: no cap. */
+    maxChars?: number;
+}
 /**
  * Turn an MCP CallToolResult into a string — the contract Reasonix's
  * ToolRegistry.dispatch returns. We:
@@ -1097,8 +1171,19 @@ declare function bridgeMcpTools(client: McpClient, opts?: BridgeOptions): Promis
  *     prompts later)
  *   - prefix error results with "ERROR: " so the calling model sees the
  *     failure clearly even through JSON mode
+ *   - optionally truncate to `maxChars` so a single oversized tool result
+ *     (e.g. a big `read_file`) can't poison the session by blowing past
+ *     the model's context window
  */
-declare function flattenMcpResult(result: CallToolResult): string;
+declare function flattenMcpResult(result: CallToolResult, opts?: FlattenOptions): string;
+/**
+ * Keep the head AND a short tail so the model sees both "what the tool
+ * started returning" and "how it ended". Head-only loses file endings
+ * (e.g. an error message appended at the bottom of a stack trace); the
+ * 1KB tail window covers that while costing almost nothing. Exported for
+ * tests and reuse by non-MCP tool adapters that want the same policy.
+ */
+declare function truncateForModel(s: string, maxChars: number): string;
 
 /**
  * Parse the `--mcp` CLI argument into a transport-tagged spec.
@@ -1149,10 +1234,36 @@ declare function parseMcpSpec(input: string): McpSpec;
  * The library itself never touches the config file — it only reads
  * `DEEPSEEK_API_KEY` from the environment. The CLI is responsible for
  * pulling from the config file and exposing it via env var to the loop.
+ *
+ * Beyond the API key, the config also remembers the user's *defaults*
+ * from `reasonix setup`: preset, MCP servers, session. This is what
+ * makes `reasonix chat` with no flags "just work" after first-run.
  */
+/** One of the preset bundles (model + harvest + branch combo). */
+type PresetName = "fast" | "smart" | "max";
 interface ReasonixConfig {
     apiKey?: string;
     baseUrl?: string;
+    /**
+     * Default preset for `reasonix chat` / `reasonix run` when no flags override.
+     * Maps to model + harvest + branch combos (see presets.ts). Missing → "fast".
+     */
+    preset?: PresetName;
+    /**
+     * Default MCP server specs to bridge on every `reasonix chat`, in the
+     * same `"name=cmd args..."` format that `--mcp` takes. Stored as strings
+     * so `reasonix setup` stays symmetrical with the flag — one parser, one
+     * format in the config file, grep-friendly.
+     */
+    mcp?: string[];
+    /**
+     * Default session name (null/missing → "default", which is what the
+     * CLI has been doing anyway). `reasonix setup` lets users pick a name
+     * or opt into ephemeral.
+     */
+    session?: string | null;
+    /** Marks that `reasonix setup` has completed at least once. */
+    setupCompleted?: boolean;
 }
 declare function defaultConfigPath(): string;
 declare function readConfig(path?: string): ReasonixConfig;
@@ -1166,6 +1277,6 @@ declare function redactKey(key: string): string;
 
 /** Reasonix — DeepSeek-native agent framework. Library entry point. */
 
-declare const VERSION = "0.3.0-alpha.4";
+declare const VERSION = "0.3.1";
 
-export { AppendOnlyLog, type BranchOptions, type BranchProgress, type BranchResult, type BranchSample, type BranchSelector, type BranchSummary, type BridgeOptions, type BridgeResult, CacheFirstLoop, type CacheFirstLoopOptions, type CallToolResult, type ChatMessage, type ChatResponse, DeepSeekClient, type DeepSeekClientOptions, type RenderOptions as DiffRenderOptions, type DiffReport, type DiffSide, type EventRole, type FlattenDecision, type HarvestOptions, ImmutablePrefix, type ImmutablePrefixOptions, type InitializeResult, type JSONSchema, type JsonRpcMessage, type JsonRpcRequest, type JsonRpcResponse, type ListToolsResult, type LoopEvent, MCP_PROTOCOL_VERSION, McpClient, type McpClientOptions, type McpContentBlock, type McpSpec, type McpTool, type McpToolSchema, type McpTransport, type ReadTranscriptResult, type ReasonixConfig, type ReconfigurableOptions, type RepairReport, type ReplayStats, type RetryInfo, type RetryOptions, type Role, type ScavengeOptions, type ScavengeResult, type SessionInfo, SessionStats, type SessionSummary, type SseMcpSpec, SseTransport, type SseTransportOptions, type StdioMcpSpec, StdioTransport, type StdioTransportOptions, StormBreaker, type StreamChunk, type ToolCall, ToolCallRepair, type ToolCallRepairOptions, type ToolDefinition, type ToolFunctionSpec, ToolRegistry, type ToolSpec, type TranscriptMeta, type TranscriptRecord, type TruncationRepairResult, type TurnPair, type TurnStats, type TypedPlanState, Usage, VERSION, VolatileScratch, aggregateBranchUsage, analyzeSchema, appendSessionMessage, bridgeMcpTools, claudeEquivalentCost, computeReplayStats, costUsd, defaultConfigPath, defaultSelector, deleteSession, diffTranscripts, emptyPlanState, fetchWithRetry, flattenMcpResult, flattenSchema, harvest, isJsonRpcError, isPlanStateEmpty, isPlausibleKey, listSessions, loadApiKey, loadDotenv, loadSessionMessages, nestArguments, openTranscriptFile, parseMcpSpec, parseTranscript, readConfig, readTranscript, recordFromLoopEvent, redactKey, renderMarkdown as renderDiffMarkdown, renderSummaryTable as renderDiffSummary, repairTruncatedJson, replayFromFile, runBranches, sanitizeName as sanitizeSessionName, saveApiKey, scavengeToolCalls, sessionPath, sessionsDir, similarity, writeConfig, writeMeta, writeRecord };
+export { AppendOnlyLog, type BranchOptions, type BranchProgress, type BranchResult, type BranchSample, type BranchSelector, type BranchSummary, type BridgeOptions, type BridgeResult, CacheFirstLoop, type CacheFirstLoopOptions, type CallToolResult, type ChatMessage, type ChatResponse, DEFAULT_MAX_RESULT_CHARS, DeepSeekClient, type DeepSeekClientOptions, type RenderOptions as DiffRenderOptions, type DiffReport, type DiffSide, type EventRole, type FlattenDecision, type FlattenOptions, type HarvestOptions, ImmutablePrefix, type ImmutablePrefixOptions, type InitializeResult, type JSONSchema, type JsonRpcMessage, type JsonRpcRequest, type JsonRpcResponse, type ListToolsResult, type LoopEvent, MCP_PROTOCOL_VERSION, McpClient, type McpClientOptions, type McpContentBlock, type McpSpec, type McpTool, type McpToolSchema, type McpTransport, type ReadTranscriptResult, type ReasonixConfig, type ReconfigurableOptions, type RepairReport, type ReplayStats, type RetryInfo, type RetryOptions, type Role, type ScavengeOptions, type ScavengeResult, type SessionInfo, SessionStats, type SessionSummary, type SseMcpSpec, SseTransport, type SseTransportOptions, type StdioMcpSpec, StdioTransport, type StdioTransportOptions, StormBreaker, type StreamChunk, type ToolCall, ToolCallRepair, type ToolCallRepairOptions, type ToolDefinition, type ToolFunctionSpec, ToolRegistry, type ToolSpec, type TranscriptMeta, type TranscriptRecord, type TruncationRepairResult, type TurnPair, type TurnStats, type TypedPlanState, Usage, VERSION, VolatileScratch, aggregateBranchUsage, analyzeSchema, appendSessionMessage, bridgeMcpTools, claudeEquivalentCost, computeReplayStats, costUsd, defaultConfigPath, defaultSelector, deleteSession, diffTranscripts, emptyPlanState, fetchWithRetry, flattenMcpResult, flattenSchema, formatLoopError, harvest, healLoadedMessages, isJsonRpcError, isPlanStateEmpty, isPlausibleKey, listSessions, loadApiKey, loadDotenv, loadSessionMessages, nestArguments, openTranscriptFile, parseMcpSpec, parseTranscript, readConfig, readTranscript, recordFromLoopEvent, redactKey, renderMarkdown as renderDiffMarkdown, renderSummaryTable as renderDiffSummary, repairTruncatedJson, replayFromFile, runBranches, sanitizeName as sanitizeSessionName, saveApiKey, scavengeToolCalls, sessionPath, sessionsDir, similarity, truncateForModel, writeConfig, writeMeta, writeRecord };