reasonix 0.12.16 → 0.12.20

package/dist/index.d.ts

@@ -392,6 +392,13 @@ interface HookOutcome {
     /** Captured stderr (trimmed). The block / warn message comes from here. */
     stderr: string;
     durationMs: number;
+    /**
+     * True when stdout or stderr crossed the per-stream byte cap and was
+     * truncated. The hook still completed; the loop just sees a clipped
+     * view of its output. Surfaced via `formatHookOutcomeMessage` so the
+     * user knows their script wrote more than Reasonix kept.
+     */
+    truncated?: boolean;
 }
 /** Aggregate report for `runHooks`. */
 interface HookReport {
@@ -455,6 +462,14 @@ interface HookSpawnResult {
     timedOut: boolean;
     /** True iff spawn() itself failed (ENOENT, EACCES, …). */
     spawnError?: Error;
+    /**
+     * True iff stdout or stderr was capped at the byte limit. The hook
+     * still ran to completion / timeout, but downstream consumers see a
+     * truncated view of its output. Surface this in the UI so a hook
+     * author who relies on long output knows the loop didn't see all
+     * of it.
+     */
+    truncated?: boolean;
 }
 type HookSpawner = (input: HookSpawnInput) => Promise<HookSpawnResult>;
 /**
@@ -502,6 +517,23 @@ declare class ImmutablePrefix {
      */
     private _toolSpecs;
     readonly fewShots: readonly ChatMessage[];
+    /**
+     * Cached SHA-256 of the prefix payload. Computed lazily on first
+     * `fingerprint` access, invalidated only by mutations that go
+     * through `addTool` (the one legitimate post-construction mutation
+     * path). The TUI reads `fingerprint` on every render — without the
+     * cache, that means a fresh `JSON.stringify` + sha256 over the
+     * full prefix (system prompt + tools list + few-shots, typically
+     * 5-10KB) on every keystroke.
+     *
+     * The lazy-init also acts as a cheap drift guard: if some future
+     * code path mutates `_toolSpecs` directly without going through
+     * `addTool`, `fingerprint` will return the stale cached value
+     * while the actual prefix sent to DeepSeek diverges — the cache
+     * miss would be the first symptom. {@link verifyFingerprint}
+     * lets dev / test code assert the cache matches reality.
+     */
+    private _fingerprintCache;
     constructor(opts: ImmutablePrefixOptions);
     get toolSpecs(): readonly ToolSpec[];
     toMessages(): ChatMessage[];
@@ -514,6 +546,16 @@ declare class ImmutablePrefix {
      */
     addTool(spec: ToolSpec): boolean;
     get fingerprint(): string;
+    /**
+     * Recompute the fingerprint from scratch and assert it matches the
+     * cached value. Returns the freshly-computed hash on success; throws
+     * with a diff if the cache drifted, which always indicates a bug —
+     * either a non-`addTool` mutation path was added, or `addTool`
+     * forgot to invalidate the cache. Dev / test only; the live loop
+     * doesn't call this on the hot path.
+     */
+    verifyFingerprint(): string;
+    private computeFingerprint;
 }
 declare class AppendOnlyLog {
     private _entries;
@@ -951,6 +993,18 @@ interface CacheFirstLoopOptions {
      * presets pass `false` to lock the running session to one model.
      */
     autoEscalate?: boolean;
+    /**
+     * Soft USD budget for the entire session. When set, the loop:
+     *   - Emits a one-shot warning event when cumulative cost crosses 80%
+     *   - Refuses to run the next turn once cumulative cost ≥ budget,
+     *     yielding an error that explains how to bump or clear the cap
+     *
+     * Default `undefined` — no cap, no warnings. Reasonix is the cost-
+     * focused agent; the budget is opt-in so users new to the tool
+     * don't get blocked at $0.50 wondering what happened, but heavy /
+     * headless / CI users have a clean circuit breaker available.
+     */
+    budgetUsd?: number;
     /**
      * 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
@@ -1029,6 +1083,19 @@ declare class CacheFirstLoop {
      * flip it live alongside `model`.
      */
     autoEscalate: boolean;
+    /**
+     * Soft USD budget — see {@link CacheFirstLoopOptions.budgetUsd}.
+     * Mutable so `/budget` slash can set / change / clear it mid-session.
+     * `null` (the default) disables all budget checks.
+     */
+    budgetUsd: number | null;
+    /**
+     * Set the first time a turn crosses 80% of the budget so the warning
+     * doesn't repeat every turn afterwards. Cleared by `setBudget` (any
+     * change re-arms the warning, including raising the cap above the
+     * current spend).
+     */
+    private _budgetWarned;
     sessionName: string | null;
     /**
      * Hook list, mutable so `/hooks reload` can swap it without
@@ -1185,6 +1252,13 @@ declare class CacheFirstLoop {
      * flip a knob between turns.
      */
     configure(opts: ReconfigurableOptions): void;
+    /**
+     * Set / change / clear the soft USD budget. `null` (or any non-
+     * positive number) disables the cap entirely. Re-arms the 80%
+     * warning so a user who bumps the cap mid-session sees a fresh
+     * threshold message at the new boundary.
+     */
+    setBudget(usd: number | null): void;
     /**
      * Arm pro for the next turn (consumed at turn start). Called by
      * `/pro`. Idempotent — repeated calls stay armed, `disarmPro()`
@@ -1435,6 +1509,19 @@ interface FileWithStats {
  * recency sort).
  */
 declare function listFilesWithStatsSync(root: string, opts?: ListFilesOptions): FileWithStats[];
+/**
+ * Async variant of {@link listFilesWithStatsSync}. Same walk semantics
+ * (DFS, alphabetical, respects ignore + maxResults), but each
+ * directory's entries are stat'd in parallel via `Promise.all`,
+ * which slashes wall-clock time on Windows where individual stat
+ * syscalls are 3-5x slower than Linux.
+ *
+ * Use this from the TUI mount path so a 500-file repo doesn't add
+ * 200-300ms of synchronous block to first paint. Sync variant is
+ * kept for paths where the caller can't `await` (server APIs,
+ * test scaffolding).
+ */
+declare function listFilesWithStatsAsync(root: string, opts?: ListFilesOptions): Promise<FileWithStats[]>;
 /**
  * Prefix pattern used by the `@` picker to detect an IN-PROGRESS
  * mention at the END of the input buffer. Captures the partial path
@@ -3873,6 +3960,12 @@ interface AppendUsageInput {
  * Returns the record that was written (or would have been written
  * if the disk had cooperated) so tests / callers can assert on the
  * computed cost fields without a round trip through the log file.
+ *
+ * On every Nth append the log is checked for size; if it crosses
+ * {@link USAGE_COMPACTION_THRESHOLD_BYTES} we drop records older
+ * than {@link USAGE_RETENTION_DAYS}. Cheaper than a startup-time
+ * scan because most processes don't reach the threshold; the size
+ * check is one statSync regardless.
  */
 declare function appendUsage(input: AppendUsageInput): UsageRecord;
 /**
@@ -3962,4 +4055,4 @@ declare function aggregateUsage(records: UsageRecord[], opts?: AggregateOptions)
 /** File-size helper for the stats header — "1.2 MB" etc. Returns "" if missing. */
 declare function formatLogSize(path?: string): string;
 
-export { AT_MENTION_PATTERN, AT_PICKER_PREFIX, type AggregateOptions, AppendOnlyLog, type AppendUsageInput, type ApplyResult, type ApplyStatus, type AtMentionExpansion, type AtMentionOptions, type BranchOptions, type BranchProgress, type BranchResult, type BranchSample, type BranchSelector, type BranchSummary, type BridgeOptions, type BridgeResult, CODE_SYSTEM_PROMPT, CacheFirstLoop, type CacheFirstLoopOptions, type CallToolResult, type ChatMessage, type ChatResponse, type ChoiceOption, ChoiceRequestedError, type ChoiceToolOptions, DEFAULT_AT_MENTION_MAX_BYTES, DEFAULT_MAX_RESULT_CHARS, DEFAULT_MAX_RESULT_TOKENS, DEFAULT_PICKER_IGNORE_DIRS, DeepSeekClient, type DeepSeekClientOptions, type RenderOptions as DiffRenderOptions, type DiffReport, type DiffSide, type EditBlock, type EditSnapshot, type EventRole, type FileWithStats, type FilesystemToolsOptions, type FlattenDecision, type FlattenOptions, type GetLatestVersionOptions, type GetPromptResult, HOOK_EVENTS, HOOK_SETTINGS_DIRNAME, HOOK_SETTINGS_FILENAME, type HarvestOptions, type HookConfig, type HookEvent, type HookOutcome, type HookPayload, type HookReport, type HookScope, type HookSettings, type HookSpawnInput, type HookSpawnResult, type HookSpawner, ImmutablePrefix, type ImmutablePrefixOptions, type InitializeResult, type InspectionReport, type JSONSchema, type JsonRpcMessage, type JsonRpcRequest, type JsonRpcResponse, LATEST_CACHE_TTL_MS, LATEST_FETCH_TIMEOUT_MS, type ListFilesOptions, type ListPromptsResult, type ListResourcesResult, type ListToolsResult, type LoadHookSettingsOptions, type LoopEvent, MCP_PROTOCOL_VERSION, MEMORY_INDEX_FILE, MEMORY_INDEX_MAX_CHARS, McpClient, type McpClientOptions, type McpContentBlock, type McpProgressHandler, type McpProgressInfo, type McpPrompt, type McpPromptArgument, type McpPromptMessage, type McpPromptResourceBlock, type McpResource, type McpResourceContents, type McpResourceContentsBlob, type McpResourceContentsText, type McpSpec, type McpTool, type McpToolSchema, type McpTransport, type MemoryEntry, type MemoryScope, MemoryStore, type MemoryStoreOptions, type MemoryToolsOptions, type MemoryType, type WriteInput as MemoryWriteInput, NeedsConfirmationError, PROJECT_MEMORY_FILE, PROJECT_MEMORY_MAX_CHARS, type PageContent, type PickerCandidate, PlanCheckpointError, PlanProposedError, PlanRevisionProposedError, type PlanStep, type PlanStepRisk, type PlanToolOptions, type ProgressNotificationParams, type ProjectMemory, type RankPickerOptions, type ReadResourceResult, type ReadTranscriptResult, type ReasonixConfig, type ReconfigurableOptions, type RepairReport, type ReplayStats, type ResolvedHook, type RetryInfo, type RetryOptions, type Role, type RunCommandResult, type RunHooksOptions, type ScavengeOptions, type ScavengeResult, type SearchResult, type SectionResult, type SessionInfo, SessionStats, type SessionSummary, type ShellToolsOptions, type SseMcpSpec, SseTransport, type SseTransportOptions, type StdioMcpSpec, StdioTransport, type StdioTransportOptions, type StepCompletion, StormBreaker, type StreamChunk, type StreamableHttpMcpSpec, StreamableHttpTransport, type StreamableHttpTransportOptions, type SubagentEvent, type SubagentSink, type SubagentToolOptions, type ToolCall, type ToolCallContext, ToolCallRepair, type ToolCallRepairOptions, type ToolDefinition, type ToolFunctionSpec, ToolRegistry, type ToolSpec, type TranscriptMeta, type TranscriptRecord, type TruncationRepairResult, type TurnPair, type TurnStats, type TypedPlanState, USER_MEMORY_DIR, Usage, type UsageAggregate, type UsageBucket, type UsageRecord, VERSION, VolatileScratch, type WebFetchOptions, type WebSearchOptions, type WebToolsOptions, aggregateBranchUsage, aggregateUsage, analyzeSchema, appendSessionMessage, appendUsage, applyEditBlock, applyEditBlocks, applyMemoryStack, applyProjectMemory, applyUserMemory, bridgeMcpTools, bucketCacheHitRatio, bucketSavingsFraction, claudeEquivalentCost, codeSystemPrompt, compareVersions, computeReplayStats, costUsd, decideOutcome, defaultConfigPath, defaultSelector, defaultUsageLogPath, deleteSession, detectAtPicker, detectShellOperator, diffTranscripts, emptyPlanState, expandAtMentions, fetchWithRetry, fixToolCallPairing, flattenMcpResult, flattenSchema, forkRegistryExcluding, formatCommandResult, formatHookOutcomeMessage, formatLogSize, formatLoopError, formatSearchResults, getLatestVersion, globalSettingsPath, harvest, healLoadedMessages, healLoadedMessagesByTokens, htmlToText, injectPowerShellUtf8, inputCostUsd, inspectMcpServer, isAllowed, isJsonRpcError, isNpxInstall, isPlanStateEmpty, isPlausibleKey, listFilesSync, listFilesWithStatsSync, listSessions, loadApiKey, loadDotenv, loadHooks, loadSessionMessages, matchesTool, memoryEnabled, nestArguments, openTranscriptFile, outputCostUsd, parseEditBlocks, parseMcpSpec, parseMojeekResults, parseTranscript, prepareSpawn, projectHash, projectSettingsPath, quoteForCmdExe, rankPickerCandidates, readConfig, readProjectMemory, readTranscript, readUsageLog, recordFromLoopEvent, redactKey, registerChoiceTool, registerFilesystemTools, registerMemoryTools, registerPlanTool, registerShellTools, registerSubagentTool, registerWebTools, renderMarkdown as renderDiffMarkdown, renderSummaryTable as renderDiffSummary, repairTruncatedJson, replayFromFile, resolveExecutable, restoreSnapshots, runBranches, runCommand, runHooks, sanitizeMemoryName, sanitizeName as sanitizeSessionName, saveApiKey, scavengeToolCalls, sessionPath, sessionsDir, similarity, snapshotBeforeEdits, stripHallucinatedToolMarkup, tokenizeCommand, truncateForModel, truncateForModelByTokens, webFetch, webSearch, withUtf8Codepage, writeConfig, writeMeta, writeRecord };
+export { AT_MENTION_PATTERN, AT_PICKER_PREFIX, type AggregateOptions, AppendOnlyLog, type AppendUsageInput, type ApplyResult, type ApplyStatus, type AtMentionExpansion, type AtMentionOptions, type BranchOptions, type BranchProgress, type BranchResult, type BranchSample, type BranchSelector, type BranchSummary, type BridgeOptions, type BridgeResult, CODE_SYSTEM_PROMPT, CacheFirstLoop, type CacheFirstLoopOptions, type CallToolResult, type ChatMessage, type ChatResponse, type ChoiceOption, ChoiceRequestedError, type ChoiceToolOptions, DEFAULT_AT_MENTION_MAX_BYTES, DEFAULT_MAX_RESULT_CHARS, DEFAULT_MAX_RESULT_TOKENS, DEFAULT_PICKER_IGNORE_DIRS, DeepSeekClient, type DeepSeekClientOptions, type RenderOptions as DiffRenderOptions, type DiffReport, type DiffSide, type EditBlock, type EditSnapshot, type EventRole, type FileWithStats, type FilesystemToolsOptions, type FlattenDecision, type FlattenOptions, type GetLatestVersionOptions, type GetPromptResult, HOOK_EVENTS, HOOK_SETTINGS_DIRNAME, HOOK_SETTINGS_FILENAME, type HarvestOptions, type HookConfig, type HookEvent, type HookOutcome, type HookPayload, type HookReport, type HookScope, type HookSettings, type HookSpawnInput, type HookSpawnResult, type HookSpawner, ImmutablePrefix, type ImmutablePrefixOptions, type InitializeResult, type InspectionReport, type JSONSchema, type JsonRpcMessage, type JsonRpcRequest, type JsonRpcResponse, LATEST_CACHE_TTL_MS, LATEST_FETCH_TIMEOUT_MS, type ListFilesOptions, type ListPromptsResult, type ListResourcesResult, type ListToolsResult, type LoadHookSettingsOptions, type LoopEvent, MCP_PROTOCOL_VERSION, MEMORY_INDEX_FILE, MEMORY_INDEX_MAX_CHARS, McpClient, type McpClientOptions, type McpContentBlock, type McpProgressHandler, type McpProgressInfo, type McpPrompt, type McpPromptArgument, type McpPromptMessage, type McpPromptResourceBlock, type McpResource, type McpResourceContents, type McpResourceContentsBlob, type McpResourceContentsText, type McpSpec, type McpTool, type McpToolSchema, type McpTransport, type MemoryEntry, type MemoryScope, MemoryStore, type MemoryStoreOptions, type MemoryToolsOptions, type MemoryType, type WriteInput as MemoryWriteInput, NeedsConfirmationError, PROJECT_MEMORY_FILE, PROJECT_MEMORY_MAX_CHARS, type PageContent, type PickerCandidate, PlanCheckpointError, PlanProposedError, PlanRevisionProposedError, type PlanStep, type PlanStepRisk, type PlanToolOptions, type ProgressNotificationParams, type ProjectMemory, type RankPickerOptions, type ReadResourceResult, type ReadTranscriptResult, type ReasonixConfig, type ReconfigurableOptions, type RepairReport, type ReplayStats, type ResolvedHook, type RetryInfo, type RetryOptions, type Role, type RunCommandResult, type RunHooksOptions, type ScavengeOptions, type ScavengeResult, type SearchResult, type SectionResult, type SessionInfo, SessionStats, type SessionSummary, type ShellToolsOptions, type SseMcpSpec, SseTransport, type SseTransportOptions, type StdioMcpSpec, StdioTransport, type StdioTransportOptions, type StepCompletion, StormBreaker, type StreamChunk, type StreamableHttpMcpSpec, StreamableHttpTransport, type StreamableHttpTransportOptions, type SubagentEvent, type SubagentSink, type SubagentToolOptions, type ToolCall, type ToolCallContext, ToolCallRepair, type ToolCallRepairOptions, type ToolDefinition, type ToolFunctionSpec, ToolRegistry, type ToolSpec, type TranscriptMeta, type TranscriptRecord, type TruncationRepairResult, type TurnPair, type TurnStats, type TypedPlanState, USER_MEMORY_DIR, Usage, type UsageAggregate, type UsageBucket, type UsageRecord, VERSION, VolatileScratch, type WebFetchOptions, type WebSearchOptions, type WebToolsOptions, aggregateBranchUsage, aggregateUsage, analyzeSchema, appendSessionMessage, appendUsage, applyEditBlock, applyEditBlocks, applyMemoryStack, applyProjectMemory, applyUserMemory, bridgeMcpTools, bucketCacheHitRatio, bucketSavingsFraction, claudeEquivalentCost, codeSystemPrompt, compareVersions, computeReplayStats, costUsd, decideOutcome, defaultConfigPath, defaultSelector, defaultUsageLogPath, deleteSession, detectAtPicker, detectShellOperator, diffTranscripts, emptyPlanState, expandAtMentions, fetchWithRetry, fixToolCallPairing, flattenMcpResult, flattenSchema, forkRegistryExcluding, formatCommandResult, formatHookOutcomeMessage, formatLogSize, formatLoopError, formatSearchResults, getLatestVersion, globalSettingsPath, harvest, healLoadedMessages, healLoadedMessagesByTokens, htmlToText, injectPowerShellUtf8, inputCostUsd, inspectMcpServer, isAllowed, isJsonRpcError, isNpxInstall, isPlanStateEmpty, isPlausibleKey, listFilesSync, listFilesWithStatsAsync, listFilesWithStatsSync, listSessions, loadApiKey, loadDotenv, loadHooks, loadSessionMessages, matchesTool, memoryEnabled, nestArguments, openTranscriptFile, outputCostUsd, parseEditBlocks, parseMcpSpec, parseMojeekResults, parseTranscript, prepareSpawn, projectHash, projectSettingsPath, quoteForCmdExe, rankPickerCandidates, readConfig, readProjectMemory, readTranscript, readUsageLog, recordFromLoopEvent, redactKey, registerChoiceTool, registerFilesystemTools, registerMemoryTools, registerPlanTool, registerShellTools, registerSubagentTool, registerWebTools, renderMarkdown as renderDiffMarkdown, renderSummaryTable as renderDiffSummary, repairTruncatedJson, replayFromFile, resolveExecutable, restoreSnapshots, runBranches, runCommand, runHooks, sanitizeMemoryName, sanitizeName as sanitizeSessionName, saveApiKey, scavengeToolCalls, sessionPath, sessionsDir, similarity, snapshotBeforeEdits, stripHallucinatedToolMarkup, tokenizeCommand, truncateForModel, truncateForModelByTokens, webFetch, webSearch, withUtf8Codepage, writeConfig, writeMeta, writeRecord };