reasonix 0.31.0 → 0.32.0

package/dist/index.d.ts

@@ -159,65 +159,6 @@ declare class DeepSeekClient {
     stream(opts: ChatRequestOptions): AsyncGenerator<StreamChunk>;
 }
 
-/** Harvest failures return an empty state — main turn must never abort on a hiccup here. */
-
-interface TypedPlanState {
-    subgoals: string[];
-    hypotheses: string[];
-    uncertainties: string[];
-    rejectedPaths: string[];
-}
-interface HarvestOptions {
-    /** Model used for the extraction call. Defaults to the cheap chat model. */
-    model?: string;
-    /** Cap on how many items land in each array. Default 5. */
-    maxItems?: number;
-    /** Per-item character cap. Default 80. */
-    maxItemLen?: number;
-    /** Abort the extraction if R1 reasoning is shorter than this. Default 40. */
-    minReasoningLen?: number;
-}
-declare function emptyPlanState(): TypedPlanState;
-declare function isPlanStateEmpty(s: TypedPlanState | null | undefined): boolean;
-declare function harvest(reasoningContent: string | null | undefined, client?: DeepSeekClient, options?: HarvestOptions, signal?: AbortSignal): Promise<TypedPlanState>;
-
-/** N parallel samples; selector picks fewest uncertainties with shorter-answer tie-break (Occam prior). */
-
-interface BranchSample {
-    index: number;
-    temperature: number;
-    response: ChatResponse;
-    planState: TypedPlanState;
-}
-type BranchSelector = (samples: BranchSample[]) => BranchSample;
-interface BranchOptions {
-    /** Number of parallel samples. 1 disables branching. Default 1. */
-    budget?: number;
-    /** Temperatures for each branch. Default spreads across [0, 1]. */
-    temperatures?: readonly number[];
-    /** Harvest options; the selector needs harvest to score samples. */
-    harvestOptions?: HarvestOptions;
-    /** Custom selector. Default: min uncertainties, tie-break shortest answer. */
-    selector?: BranchSelector;
-    /** Not awaited; exceptions swallowed. Fires when sample's main + harvest both complete. */
-    onSampleDone?: (sample: BranchSample) => void;
-}
-interface BranchResult {
-    chosen: BranchSample;
-    samples: BranchSample[];
-}
-/** Default: fewest uncertainties wins, ties broken by shorter answer content. */
-declare const defaultSelector: BranchSelector;
-declare function runBranches(client: DeepSeekClient, request: ChatRequestOptions, opts?: BranchOptions): Promise<BranchResult>;
-/** Sum usage across branch samples for telemetry purposes. */
-declare function aggregateBranchUsage(samples: readonly BranchSample[]): {
-    promptTokens: number;
-    completionTokens: number;
-    totalTokens: number;
-    promptCacheHitTokens: number;
-    promptCacheMissTokens: number;
-};
-
 /** Generic pause gate — bridges tool functions and the App's modals via Promises. */
 type ConfirmationChoice = {
     type: "deny";
@@ -624,20 +565,7 @@ type EventRole = "assistant_delta" | "assistant_final"
 /** Pre-dispatch ping so the TUI can show a spinner during long tool awaits. */
  | "tool_start" | "tool" | "done" | "error" | "warning"
 /** Transient indicator for silent phases; UI clears on next primary event. */
- | "status" | "branch_start" | "branch_progress" | "branch_done";
-interface BranchSummary {
-    budget: number;
-    chosenIndex: number;
-    uncertainties: number[];
-    temperatures: number[];
-}
-interface BranchProgress {
-    completed: number;
-    total: number;
-    latestIndex: number;
-    latestTemperature: number;
-    latestUncertainties: number;
-}
+ | "status";
 interface LoopEvent {
     turn: number;
     role: EventRole;
@@ -653,10 +581,7 @@ interface LoopEvent {
     /** Count of tool calls whose args have parsed as valid JSON (UI progress, not dispatch gate). */
     toolCallReadyCount?: number;
     stats?: TurnStats;
-    planState?: TypedPlanState;
     repair?: RepairReport;
-    branch?: BranchSummary;
-    branchProgress?: BranchProgress;
     error?: string;
     /** Display-only — code-mode applier MUST skip SEARCH/REPLACE in forced-summary text. */
     forcedSummary?: boolean;
@@ -774,9 +699,6 @@ interface CacheFirstLoopOptions {
     model?: string;
     maxToolIters?: number;
     stream?: boolean;
-    harvest?: boolean | HarvestOptions;
-    /** Branching disables streaming (need all samples) and force-enables harvest (selector input). */
-    branch?: number | BranchOptions;
     reasoningEffort?: "high" | "max";
     autoEscalate?: boolean;
     /** Soft USD cap — warns at 80%, refuses next turn at 100%. Opt-in (default no cap). */
@@ -791,8 +713,6 @@ interface CacheFirstLoopOptions {
 }
 interface ReconfigurableOptions {
     model?: string;
-    harvest?: boolean | HarvestOptions;
-    branch?: number | BranchOptions;
     stream?: boolean;
     /** V4 thinking mode only; deepseek-chat ignores. */
     reasoningEffort?: "high" | "max";
@@ -810,10 +730,6 @@ declare class CacheFirstLoop {
     readonly repair: ToolCallRepair;
     model: string;
     stream: boolean;
-    harvestEnabled: boolean;
-    harvestOptions: HarvestOptions;
-    branchEnabled: boolean;
-    branchOptions: BranchOptions;
     reasoningEffort: "high" | "max";
     autoEscalate: boolean;
     budgetUsd: number | null;
@@ -883,6 +799,8 @@ declare class CacheFirstLoop {
 /** Expand `@path` mentions inline. Paths must resolve inside rootDir; escapes / oversize get a skip note, not content. */
 /** Caps match tool-result dispatch truncation (0.5.2). */
 declare const DEFAULT_AT_MENTION_MAX_BYTES: number;
+/** Cap on entries returned for a `@<dir>` listing. ~200 paths × ~50 chars ≈ 10 KB — fits inside DEFAULT_AT_MENTION_MAX_BYTES with room for the rest of the prompt. */
+declare const DEFAULT_AT_DIR_MAX_ENTRIES = 200;
 /** Universally-uninteresting build / VCS dirs. Framework-specific dirs (Pods, target, …) live in .gitignore. */
 declare const DEFAULT_PICKER_IGNORE_DIRS: readonly string[];
 interface ListFilesOptions {
@@ -928,17 +846,32 @@ interface AtMentionExpansion {
     path: string;
     /** True if the content was inlined. False = skipped (reason in `skip`). */
     ok: boolean;
-    /** Bytes read (only for ok=true). */
+    /** Bytes read (only for ok=true and isDirectory=false). */
     bytes?: number;
+    /** True when the mention resolved to a directory (ok=true). Block uses `<directory>` instead of `<file>`. */
+    isDirectory?: boolean;
+    /** Number of files listed when isDirectory=true. */
+    entries?: number;
+    /** True iff the directory listing was clipped at maxDirEntries. */
+    truncated?: boolean;
     /** Why the mention was skipped. Set when ok=false. */
     skip?: "missing" | "not-file" | "too-large" | "escape" | "read-error";
 }
 interface AtMentionOptions {
     /** Max file size in bytes before a mention is skipped. */
     maxBytes?: number;
+    /** Cap on entries returned for a `@<dir>` listing. Default {@link DEFAULT_AT_DIR_MAX_ENTRIES}. */
+    maxDirEntries?: number;
     fs?: {
         exists: (path: string) => boolean;
         isFile: (path: string) => boolean;
+        /** Optional — when omitted, directories are skipped as `not-file`. */
+        isDir?: (path: string) => boolean;
+        /** Optional — receives the directory's absolute path and the project root, returns relative paths and a truncated flag. */
+        listDir?: (dirAbs: string, root: string, max: number) => {
+            files: string[];
+            truncated: boolean;
+        };
         size: (path: string) => number;
         read: (path: string) => string;
     };
@@ -1417,8 +1350,6 @@ interface TranscriptRecord {
     model?: string;
     /** Lets diff attribute cache-hit delta to log stability vs prompt change. */
     prefixHash?: string;
-    /** Absent means "no data", not "empty plan". */
-    planState?: TypedPlanState;
     /** Optional error message (role === "error"). */
     error?: string;
 }
@@ -1468,12 +1399,6 @@ interface ReplayStats extends SessionSummary {
     userTurns: number;
     /** Count of tool-role records (tool calls executed). */
     toolCalls: number;
-    /** Count of assistant_final records that carry a non-empty planState (harvest signal). */
-    harvestedTurns: number;
-    /** Sum of uncertainties across all harvested turns — a proxy for "how much did R1 hedge?" */
-    totalUncertainties: number;
-    /** Sum of subgoals across all harvested turns. */
-    totalSubgoals: number;
 }
 declare function replayFromFile(path: string): {
     parsed: ReadTranscriptResult;
@@ -2038,6 +1963,22 @@ type PresetName = "auto" | "flash" | "pro" | "fast" | "smart" | "max";
 /** Single trust dial: review queues edits + gates shell; auto applies + gates shell; yolo skips both gates. */
 type EditMode = "review" | "auto" | "yolo";
 type ReasoningEffort = "high" | "max";
+type EmbeddingProvider = "ollama" | "openai-compat";
+interface OllamaEmbeddingUserConfig {
+    baseUrl?: string;
+    model?: string;
+}
+interface OpenAICompatEmbeddingUserConfig {
+    baseUrl?: string;
+    apiKey?: string;
+    model?: string;
+    extraBody?: Record<string, unknown>;
+}
+interface SemanticEmbeddingUserConfig {
+    provider?: EmbeddingProvider;
+    ollama?: OllamaEmbeddingUserConfig;
+    openaiCompat?: OpenAICompatEmbeddingUserConfig;
+}
 interface ReasonixConfig {
     apiKey?: string;
     baseUrl?: string;
@@ -2063,6 +2004,7 @@ interface ReasonixConfig {
         };
     };
     index?: IndexUserConfig;
+    semantic?: SemanticEmbeddingUserConfig;
 }
 declare function defaultConfigPath(): string;
 declare function readConfig(path?: string): ReasonixConfig;
@@ -2213,4 +2155,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, type CodeSystemPromptOptions, 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, 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, parseSearxngHtmlResults, 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 BridgeOptions, type BridgeResult, CODE_SYSTEM_PROMPT, CacheFirstLoop, type CacheFirstLoopOptions, type CallToolResult, type ChatMessage, type ChatResponse, type ChoiceOption, ChoiceRequestedError, type ChoiceToolOptions, type CodeSystemPromptOptions, DEFAULT_AT_DIR_MAX_ENTRIES, 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 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, 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, USER_MEMORY_DIR, Usage, type UsageAggregate, type UsageBucket, type UsageRecord, VERSION, VolatileScratch, type WebFetchOptions, type WebSearchOptions, type WebToolsOptions, aggregateUsage, analyzeSchema, appendSessionMessage, appendUsage, applyEditBlock, applyEditBlocks, applyMemoryStack, applyProjectMemory, applyUserMemory, bridgeMcpTools, bucketCacheHitRatio, bucketSavingsFraction, claudeEquivalentCost, codeSystemPrompt, compareVersions, computeReplayStats, costUsd, decideOutcome, defaultConfigPath, defaultUsageLogPath, deleteSession, detectAtPicker, detectShellOperator, diffTranscripts, expandAtMentions, fetchWithRetry, fixToolCallPairing, flattenMcpResult, flattenSchema, forkRegistryExcluding, formatCommandResult, formatHookOutcomeMessage, formatLogSize, formatLoopError, formatSearchResults, getLatestVersion, globalSettingsPath, healLoadedMessages, healLoadedMessagesByTokens, htmlToText, injectPowerShellUtf8, inputCostUsd, inspectMcpServer, isAllowed, isJsonRpcError, isNpxInstall, isPlausibleKey, listFilesSync, listFilesWithStatsAsync, listFilesWithStatsSync, listSessions, loadApiKey, loadDotenv, loadHooks, loadSessionMessages, matchesTool, memoryEnabled, nestArguments, openTranscriptFile, outputCostUsd, parseEditBlocks, parseMcpSpec, parseMojeekResults, parseSearxngHtmlResults, 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, runCommand, runHooks, sanitizeMemoryName, sanitizeName as sanitizeSessionName, saveApiKey, scavengeToolCalls, sessionPath, sessionsDir, similarity, snapshotBeforeEdits, stripHallucinatedToolMarkup, tokenizeCommand, truncateForModel, truncateForModelByTokens, webFetch, webSearch, withUtf8Codepage, writeConfig, writeMeta, writeRecord };