reasonix 0.47.0 → 0.47.1

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { ConfirmationChoice, PlanVerdict, CheckpointVerdict, RevisionVerdict, ChoiceVerdict } from '@reasonix/core-utils';
 import { SpawnOptions } from 'node:child_process';
 import { WriteStream } from 'node:fs';
 
@@ -153,6 +154,10 @@ declare class DeepSeekClient {
     constructor(opts?: DeepSeekClientOptions);
     private waitForChatRateLimit;
     private buildPayload;
+    /** Azure OpenAI-compatible endpoints do not accept DeepSeek's proprietary
+     *  `extra_body.thinking` field (they reject the request with 400).  We still
+     *  send `reasoning_effort`, which Azure *does* support. */
+    private _isAzureEndpoint;
     /** Returns null on failure so callers can degrade — session must keep working without balance UI. */
     getBalance(opts?: {
         signal?: AbortSignal;
@@ -166,49 +171,7 @@ declare class DeepSeekClient {
 }
 
 /** Generic pause gate — bridges tool functions and the App's modals via Promises. */
-type ConfirmationChoice = {
-    type: "deny";
-    denyContext?: string;
-} | {
-    type: "run_once";
-} | {
-    type: "always_allow";
-    prefix: string;
-};
-type PlanVerdict = {
-    type: "approve";
-    feedback?: string;
-} | {
-    type: "refine";
-    feedback?: string;
-} | {
-    type: "cancel";
-    feedback?: string;
-};
-type CheckpointVerdict = {
-    type: "continue";
-} | {
-    type: "revise";
-    feedback?: string;
-} | {
-    type: "stop";
-};
-type RevisionVerdict = {
-    type: "accepted";
-} | {
-    type: "rejected";
-} | {
-    type: "cancelled";
-};
-type ChoiceVerdict = {
-    type: "pick";
-    optionId: string;
-} | {
-    type: "text";
-    text: string;
-} | {
-    type: "cancel";
-};
+
 type ToolConfirmationAuditEvent = {
     type: "tool.confirm.allow";
     kind: "run_command" | "run_background";
@@ -722,10 +685,13 @@ declare class ToolRegistry {
     private readonly _autoFlatten;
     private _planMode;
     private _interceptor;
+    private readonly _interceptors;
     private _auditListener;
     private _resultAugmenter;
     /** Per-tool fingerprint of the last call that failed schema validation. Cleared by any successful validation for that tool. */
     private readonly _lastMalformed;
+    /** Per-tool fingerprint of the last host-side interceptor rejection. */
+    private readonly _lastInterceptorRejection;
     constructor(opts?: ToolRegistryOptions);
     /** Enable / disable plan-mode enforcement at dispatch. */
     setPlanMode(on: boolean): void;
@@ -733,6 +699,8 @@ declare class ToolRegistry {
     get planMode(): boolean;
     /** At most one interceptor active; calling twice replaces. */
     setToolInterceptor(fn: ToolInterceptor | null): void;
+    /** Ordered host-side interceptors. They run before the legacy single interceptor. */
+    addToolInterceptor(id: string, fn: ToolInterceptor): () => void;
     setAuditListener(fn: ToolCallAuditListener | null): void;
     /** Final-stage post-processor; replaces previous augmenter when called twice. Pass null to clear. */
     setResultAugmenter(fn: ToolResultAugmenter | null): void;
@@ -756,8 +724,10 @@ declare class ToolRegistry {
         /** Inject a mock PauseGate for tests. */
         confirmationGate?: PauseGate;
     }): Promise<string>;
+    private _augmentResult;
     /** Records the failed call's fingerprint; on the 2nd consecutive identical malformed call to the same tool, returns a sharper error that tells the model to stop retrying. */
     private _noteMalformed;
+    private _noteInterceptorRejection;
 }
 
 interface CacheFirstLoopOptions {
@@ -1089,6 +1059,7 @@ 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 EngineeringLifecycleMode = "off" | "strict";
 type EmbeddingProvider = "ollama" | "openai-compat";
 interface OllamaEmbeddingUserConfig {
     baseUrl?: string;
@@ -1218,6 +1189,14 @@ interface ReasonixConfig {
     };
     pricingOverride?: Record<string, PricingOverride>;
     rateLimit?: RateLimitConfig;
+    /** Host-enforced engineering lifecycle. Defaults to off so opt-outs pay zero prefix cost. */
+    engineeringLifecycle?: {
+        mode?: EngineeringLifecycleMode;
+    };
+    filesystem?: {
+        /** read_file flips to outline mode for files above this. Default 64 KiB — keeps the cache prefix slim while covering ~99% of source files. Raise to 524288 (512 KiB) for the pre-0.46.0 "trust the cache" behavior. */
+        outlineThresholdBytes?: number;
+    };
     /** QQ Bot configuration */
     qq?: QQBotConfig;
 }
@@ -1338,7 +1317,7 @@ interface FilesystemToolsOptions {
     rootDir: string;
     /** false → register only read-side tools. Default true. */
     allowWriting?: boolean;
-    /** Files at or under this size get full content; larger go to outline mode. Default 512 KiB. */
+    /** Files at or under this size get full content; larger go to outline mode. Default 64 KiB. */
     outlineThresholdBytes?: number;
     /** Cap on total bytes from listing/grep tools — bounds tree-as-one-string accidents. */
     maxListBytes?: number;
@@ -1385,6 +1364,16 @@ interface PlanStep {
     title: string;
     action: string;
     risk?: PlanStepRisk;
+    targets?: string[];
+    acceptance?: string;
+    verification?: string[];
+}
+type StepEvidenceKind = "verification" | "diff" | "checkpoint" | "manual";
+interface StepEvidence {
+    kind: StepEvidenceKind;
+    summary: string;
+    command?: string;
+    paths?: string[];
 }
 interface StepCompletion {
     kind: "step_completed";
@@ -1392,6 +1381,7 @@ interface StepCompletion {
     title?: string;
     result: string;
     notes?: string;
+    evidence?: StepEvidence[];
 }
 
 /** Plan-mode errors carry `toToolResult` so dispatch serializes structured payloads the TUI parses to mount pickers. */
@@ -1426,6 +1416,10 @@ interface PlanToolOptions {
     onPlanSubmitted?: (plan: string, steps?: PlanStep[]) => void;
     onStepCompleted?: (update: StepCompletion) => void;
     onPlanRevisionProposed?: (reason: string, remainingSteps: PlanStep[], summary?: string) => void;
+    requireStepEvidence?: (args: {
+        stepId: string;
+        title?: string;
+    }) => string | null | undefined;
 }
 declare function registerPlanTool(registry: ToolRegistry, opts?: PlanToolOptions): ToolRegistry;
 
@@ -1739,10 +1733,6 @@ interface WebToolsOptions {
     defaultTopK?: number;
     /** Byte cap for `web_fetch` extracted text. */
     maxFetchChars?: number;
-    /** Backend engine: "mojeek" (default, scrapes Mojeek), "searxng" (self-hosted SearXNG), "metaso" (Metaso API), or "tavily" (LLM-friendly API). */
-    webSearchEngine?: "mojeek" | "searxng" | "metaso" | "tavily";
-    /** Base URL for SearXNG (default http://localhost:8080). */
-    webSearchEndpoint?: string;
 }
 declare function registerWebTools(registry: ToolRegistry, opts?: WebToolsOptions): ToolRegistry;
 declare function formatSearchResults(query: string, results: SearchResult[]): string;
@@ -2391,6 +2381,8 @@ interface CodeSystemPromptOptions {
     systemAppendFile?: string;
     /** Model the loop will run on — interpolated into the escalation contract so the model can name itself correctly when asked (#582). */
     modelId?: string;
+    /** Include the lifecycle contract only for users who explicitly opt in. */
+    engineeringLifecycleMode?: "off" | "strict";
 }
 declare function codeSystemPrompt(rootDir: string, opts?: CodeSystemPromptOptions): string;