@kodax-ai/kodax 0.7.56 → 0.7.57

package/dist/types-chunks/{base.d-CwPfI8WQ.d.ts → base.d-BnjQrSVf.d.ts}

@@ -1,4 +1,4 @@
-import { s as KodaXProviderConfig, n as KodaXMessage, Y as KodaXToolDefinition, G as KodaXReasoningRequest, A as KodaXProviderStreamOptions, L as KodaXStreamResult, a2 as KodaXVerifyCredentialResult, o as KodaXModelDescriptor, r as KodaXProviderCapabilityProfile, D as KodaXReasoningCapability, F as KodaXReasoningOverride } from './types.d-BJmoMf5H.js';
+import { p as KodaXProviderConfig, j as KodaXMessage, _ as KodaXToolDefinition, G as KodaXReasoningRequest, x as KodaXProviderStreamOptions, M as KodaXStreamResult, a4 as KodaXVerifyCredentialResult, k as KodaXModelDescriptor, o as KodaXProviderCapabilityProfile, A as KodaXReasoningCapability, F as KodaXReasoningProfile, m as KodaXNormalizedReasoningRequest, a6 as KodaXWireReasoningEffort } from './types.d-6VOXvF88.js';
 
 /**
  * Retry-After header parsing — FEATURE_130 (v0.7.36).
@@ -89,6 +89,27 @@ declare function extractHeadersFromError(error: unknown): HeadersLike;
  * Provider 抽象基类 - 所有 Provider 的公共基础
  */
 
+/**
+ * Passive-learning guard threaded into `withRateLimit`: when the request fails
+ * with a reasoning-effort rejection, fire `onRejected` (so the REPL records it)
+ * and surface a typed error. `effort` is the value that was on the wire (used
+ * when the provider error doesn't echo a value).
+ */
+interface ReasoningRejectionGuard {
+    readonly model: string;
+    readonly effort?: string;
+    readonly onRejected?: (event: {
+        provider: string;
+        model: string;
+        effort: string;
+    }) => void;
+}
+
+interface ResolvedV2ReasoningIntent {
+    readonly disabled: boolean;
+    readonly effort?: KodaXWireReasoningEffort;
+    readonly requestedEffort?: KodaXWireReasoningEffort;
+}
 /**
  * FEATURE_130 (v0.7.36): structured payload fired through
  * `KodaXEvents.onRetryAfter` whenever a provider's `withRateLimit`
@@ -121,6 +142,14 @@ declare abstract class KodaXBaseProvider {
      *      returns `stop_reason: max_tokens`. See `coding/src/agent.ts`.
      */
     protected maxOutputTokensOverride?: number;
+    /**
+     * One-shot flag for the passive-learning self-heal: when a request is
+     * rejected for its reasoning-effort value, `withRateLimit` flips this true
+     * and retries the SAME turn. The reasoning-application path then drops the
+     * effort param so the retry uses the provider default and the user's turn
+     * still completes — no interruption, no re-typed query. Cleared on success.
+     */
+    protected suppressReasoningEffort: boolean;
     /**
      * Public setter for the one-shot override above. Callers outside the
      * provider package (notably the agent loop's escalation branch) use this
@@ -165,6 +194,7 @@ declare abstract class KodaXBaseProvider {
      * layer sets it — matches third-party Anthropic-compat behavior.
      */
     getEffectiveStrictThinkingSignature(model?: string): boolean;
+    protected getEffectiveThinkingBudgetCap(model?: string): number | undefined;
     abstract stream(messages: KodaXMessage[], tools: KodaXToolDefinition[], system: string, reasoning?: boolean | KodaXReasoningRequest, streamOptions?: KodaXProviderStreamOptions, signal?: AbortSignal): Promise<KodaXStreamResult>;
     supportsNonStreamingFallback(): boolean;
     complete(_messages: KodaXMessage[], _tools: KodaXToolDefinition[], _system: string, _reasoning?: boolean | KodaXReasoningRequest, _streamOptions?: KodaXProviderStreamOptions, _signal?: AbortSignal): Promise<KodaXStreamResult>;
@@ -194,9 +224,7 @@ declare abstract class KodaXBaseProvider {
     getCapabilityProfile(): KodaXProviderCapabilityProfile;
     getConfiguredReasoningCapability(modelOverride?: string): KodaXReasoningCapability;
     getReasoningCapability(modelOverride?: string): KodaXReasoningCapability;
-    getReasoningOverride(modelOverride?: string): KodaXReasoningOverride | undefined;
-    getReasoningOverrideKey(modelOverride?: string): string;
-    protected persistReasoningCapabilityOverride(capability: KodaXReasoningCapability, modelOverride?: string): void;
+    getReasoningProfile(modelOverride?: string): KodaXReasoningProfile | undefined;
     protected shouldFallbackForReasoningError(error: unknown, ...terms: string[]): boolean;
     protected shouldFallbackForSpecificReasoningError(error: unknown, ...terms: string[]): boolean;
     protected shouldFallbackForForcedToolChoiceError(error: unknown): boolean;
@@ -225,7 +253,9 @@ declare abstract class KodaXBaseProvider {
     protected getApiKey(): string;
     protected shouldLogStreamDiagnostics(): boolean;
     protected logStreamDiagnostic(...args: unknown[]): void;
-    protected normalizeReasoning(reasoning?: boolean | KodaXReasoningRequest): Required<KodaXReasoningRequest>;
+    protected normalizeReasoning(reasoning?: boolean | KodaXReasoningRequest): KodaXNormalizedReasoningRequest;
+    protected validateExplicitReasoningEffort(reasoning: KodaXNormalizedReasoningRequest, modelOverride?: string): void;
+    protected resolveReasoningProfileIntent(reasoning: KodaXNormalizedReasoningRequest, capability: KodaXReasoningProfile, modelOverride?: string): ResolvedV2ReasoningIntent;
     /**
      * Called when ECONNRESET/EPIPE is detected, indicating a stale keep-alive
      * socket.  Subclasses should override to rebuild their HTTP client with a
@@ -264,7 +294,7 @@ declare abstract class KodaXBaseProvider {
      */
     protected parseContextOverflow(error: unknown): number | undefined;
     protected isContextOverflowError(error: unknown): boolean;
-    protected withRateLimit<T>(fn: () => Promise<T>, signal?: AbortSignal, retries?: number, onRateLimit?: (attempt: number, maxRetries: number, delayMs: number) => void, onRetryAfter?: KodaXOnRetryAfterCallback): Promise<T>;
+    protected withRateLimit<T>(fn: () => Promise<T>, signal?: AbortSignal, retries?: number, onRateLimit?: (attempt: number, maxRetries: number, delayMs: number) => void, onRetryAfter?: KodaXOnRetryAfterCallback, reasoningGuard?: ReasoningRejectionGuard): Promise<T>;
 }
 
 export { KodaXBaseProvider as K, extractHeadersFromError as e, parseRetryAfter as p };

package/dist/types-chunks/{bash-prefix-extractor.d-DZF1gDDz.d.ts → bash-prefix-extractor.d-BgvMbfq6.d.ts}

@@ -1,8 +1,8 @@
-import { U as KodaXGoalState, f as AgentMessage, b0 as StopHookFn, a4 as KodaXSessionLineage, W as KodaXJsonValue, P as KodaXExtensionSessionRecord, a9 as KodaXSessionScope, aa as KodaXSessionStorage, Q as KodaXExtensionSessionState, C as ChildTaskRegistry, bl as WorkflowEventCorrelation, s as CompactionUpdate, bx as WorkflowProcessEvent, m as AskUserQuestionOptions, k as AskUserMultiOptions, y as Guardrail, bo as WorkflowIsolation, Y as KodaXSessionArtifactLedgerEntry, aN as SessionErrorMetadata, v as DiscoveredInstance, b4 as TaskAbortRegistry } from './process.d-BdiIUr8T.js';
-import { X as KodaXTokenUsage, E as KodaXReasoningMode, n as KodaXMessage, k as KodaXHarnessProfile, S as KodaXTaskWorkIntent, I as KodaXReviewScale, O as KodaXTaskComplexity, a as KodaXAmaFanoutClass, Q as KodaXTaskRoutingDecision, R as KodaXTaskType, J as KodaXRiskLevel, i as KodaXExecutionMode, c as KodaXAmaProfile, d as KodaXAmaTactic, b as KodaXAmaFanoutPolicy } from './types.d-BJmoMf5H.js';
-import { Diagnostic, Position, Location, Hover, DocumentSymbol, SymbolInformation } from 'vscode-languageserver-protocol';
+import { U as KodaXGoalState, f as AgentMessage, b0 as StopHookFn, a4 as KodaXSessionLineage, W as KodaXJsonValue, P as KodaXExtensionSessionRecord, a9 as KodaXSessionScope, aa as KodaXSessionStorage, Q as KodaXExtensionSessionState, C as ChildTaskRegistry, bl as WorkflowEventCorrelation, s as CompactionUpdate, bx as WorkflowProcessEvent, m as AskUserQuestionOptions, k as AskUserMultiOptions, y as Guardrail, bo as WorkflowIsolation, Y as KodaXSessionArtifactLedgerEntry, aN as SessionErrorMetadata, v as DiscoveredInstance, b4 as TaskAbortRegistry } from './process.d-BZncyzEj.js';
+import { Z as KodaXTokenUsage, j as KodaXMessage, a6 as KodaXWireReasoningEffort, E as KodaXReasoningMode, g as KodaXHarnessProfile, T as KodaXTaskWorkIntent, I as KodaXReviewScale, P as KodaXTaskComplexity, b as KodaXChildFanoutClass, R as KodaXTaskRoutingDecision, S as KodaXTaskType, J as KodaXRiskLevel, e as KodaXExecutionMode } from './types.d-6VOXvF88.js';
+import { Diagnostic, Position, Location, Hover, DocumentSymbol, SymbolInformation, WorkspaceSymbol, CallHierarchyItem, CallHierarchyIncomingCall, CallHierarchyOutgoingCall } from 'vscode-languageserver-protocol';
 import { C as CapabilityKind, b as CapabilityResult } from './capability.d-3C62G8Eq.js';
-import { K as KodaXBaseProvider } from './base.d-CwPfI8WQ.js';
+import { K as KodaXBaseProvider } from './base.d-BnjQrSVf.js';
 import { a as CostTracker } from './cost-tracker.d-wRtyEW9d.js';
 
 /**
@@ -524,6 +524,16 @@ interface LspClient {
     references(file: string, position: Position): Promise<Location[]>;
     /** The document's symbol outline. */
     documentSymbols(file: string): Promise<Array<DocumentSymbol | SymbolInformation>>;
+    /** Project-wide symbols matching a query string. */
+    workspaceSymbols(query: string): Promise<Array<SymbolInformation | WorkspaceSymbol>>;
+    /** Implementation site(s) of the symbol at a position. */
+    implementation(file: string, position: Position): Promise<Location[]>;
+    /** Prepare the call hierarchy item(s) for a symbol at a position. */
+    prepareCallHierarchy(file: string, position: Position): Promise<CallHierarchyItem[]>;
+    /** Incoming callers for a prepared call hierarchy item. */
+    incomingCalls(item: CallHierarchyItem): Promise<CallHierarchyIncomingCall[]>;
+    /** Outgoing callees for a prepared call hierarchy item. */
+    outgoingCalls(item: CallHierarchyItem): Promise<CallHierarchyOutgoingCall[]>;
     /** Graceful shutdown (await server exit so the OS releases handles). */
     shutdown(): Promise<void>;
     /** Synchronous best-effort kill, for a `process.on('exit')` last resort. */
@@ -596,6 +606,16 @@ declare class LspService {
     getReferences(file: string, position: Position, request?: DiagnosticsRequest): Promise<string>;
     /** The file's symbol outline, as indented text. */
     getDocumentSymbols(file: string, request?: DiagnosticsRequest): Promise<string>;
+    /** Project-wide symbols matching `query`, across all available language servers. */
+    getWorkspaceSymbols(query: string, request?: DiagnosticsRequest): Promise<string>;
+    /** Implementation site(s) of the symbol at `position` (0-based), as text. */
+    getImplementation(file: string, position: Position, request?: DiagnosticsRequest): Promise<string>;
+    /** Prepared call hierarchy item(s) for the symbol at `position` (0-based). */
+    getPrepareCallHierarchy(file: string, position: Position, request?: DiagnosticsRequest): Promise<string>;
+    /** Incoming callers of the symbol at `position` (0-based). */
+    getIncomingCalls(file: string, position: Position, request?: DiagnosticsRequest): Promise<string>;
+    /** Outgoing callees of the symbol at `position` (0-based). */
+    getOutgoingCalls(file: string, position: Position, request?: DiagnosticsRequest): Promise<string>;
     /**
      * Resolve the primary client for a navigation request, opening the file so
      * the server has current content. Returns guidance text when no server is
@@ -603,6 +623,7 @@ declare class LspService {
      * NOT silent), or an unsupported message for non-LSP file types.
      */
     private navClient;
+    private workspaceClients;
     /** Shut down all spawned servers gracefully (call on session teardown). */
     shutdownAll(): Promise<void>;
     /** Synchronous best-effort kill of all servers — for `process.on('exit')`. */
@@ -918,64 +939,6 @@ interface ResolveKodaXManualResult {
     readonly nextTopics: readonly string[];
 }
 
-/**
- * FEATURE_093 (v0.7.24): minimal contract interfaces for the coding extension
- * runtime. Extracted so `@kodax-ai/coding/src/types.ts` can reference the
- * extension runtime at the type level without importing `./extensions/runtime.js`,
- * which in turn imports from `types.ts` — a cycle that lasted since v0.7.20.
- *
- * Scope: the capability methods that tool execution consumes, plus optional
- * session lifecycle hooks that the coding run loop uses when the runtime
- * supports them.
- *
- * File must have NO imports from `../types.js` (that is the cycle we are
- * breaking). Shared capability/session value types come from `@kodax-ai/agent`.
- */
-
-interface ExtensionRuntimeModelSelection {
-    provider?: string;
-    model?: string;
-}
-interface RuntimeDefaultsSnapshot {
-    activeTools?: string[];
-    modelSelection: ExtensionRuntimeModelSelection;
-    thinkingLevel?: KodaXReasoningMode;
-}
-interface BoundExtensionRuntimeController {
-    queueUserMessage(message: string | KodaXMessage): void;
-    getSessionState<T = KodaXJsonValue>(extensionId: string, key: string): T | undefined;
-    setSessionState(extensionId: string, key: string, value: KodaXJsonValue | undefined): void;
-    getSessionStateSnapshot(extensionId: string): Record<string, KodaXJsonValue>;
-    appendSessionRecord(extensionId: string, type: string, data?: KodaXJsonValue, options?: {
-        dedupeKey?: string;
-    }): KodaXExtensionSessionRecord;
-    listSessionRecords(extensionId: string, type?: string): KodaXExtensionSessionRecord[];
-    clearSessionRecords(extensionId: string, type?: string): number;
-    getActiveTools(): string[];
-    setActiveTools(toolNames: string[]): void;
-    getModelSelection(): ExtensionRuntimeModelSelection;
-    setModelSelection(next: ExtensionRuntimeModelSelection): void;
-    getThinkingLevel(): KodaXReasoningMode | undefined;
-    setThinkingLevel(level: KodaXReasoningMode): void;
-}
-interface CapabilityRuntimeContract {
-    searchCapabilities(providerId: string, query: string, options?: {
-        kind?: CapabilityKind;
-        limit?: number;
-        server?: string;
-    }): Promise<unknown[]>;
-    describeCapability(providerId: string, capabilityId: string): Promise<unknown>;
-    executeCapability(providerId: string, capabilityId: string, input: Record<string, unknown>): Promise<CapabilityResult>;
-    readCapability(providerId: string, capabilityId: string, options?: Record<string, unknown>): Promise<CapabilityResult>;
-    getCapabilityPrompt(providerId: string, capabilityId: string, args?: Record<string, unknown>): Promise<unknown>;
-    getCapabilityPromptContext(providerId: string): Promise<string | undefined>;
-}
-interface ExtensionRuntimeContract extends CapabilityRuntimeContract {
-    getDefaults?(): RuntimeDefaultsSnapshot;
-    bindController?(controller: BoundExtensionRuntimeController): (() => void) | void;
-    hydrateSession?(sessionId: string): Promise<void>;
-}
-
 /**
  * KodaX Provider Resilience Types (Feature 045)
  *
@@ -1107,6 +1070,92 @@ interface ProviderResiliencePolicy extends ProviderResilienceConfig {
     provider: string;
 }
 
+interface KodaXLlmTimeoutConfig {
+    /** Main provider request hard timeout, in seconds. Default 600s. */
+    readonly requestTimeoutSec?: number;
+    /** Idle timeout between stream deltas, in seconds. Set 0 to disable. Default 0. */
+    readonly streamIdleTimeoutSec?: number;
+    /** Per stream chunk timeout, in seconds. Default 30s. */
+    readonly chunkTimeoutSec?: number;
+    /** Maximum retry delay, in seconds. Default 60s. */
+    readonly maxRetryDelaySec?: number;
+}
+interface KodaXWorkflowTimeoutConfig {
+    /** Workflow harness generation LLM call timeout, in seconds. Default 120s. */
+    readonly generationTimeoutSec?: number;
+}
+/**
+ * Public timeout budgets for user-facing waits. Internal cleanup and
+ * resource-protection watchdogs intentionally stay outside this SDK contract.
+ */
+interface KodaXTimeoutConfig {
+    readonly llm?: KodaXLlmTimeoutConfig;
+    readonly workflow?: KodaXWorkflowTimeoutConfig;
+}
+declare function timeoutSecToMs(value: number | undefined, label: string, opts?: {
+    readonly allowZero?: boolean;
+}): number | undefined;
+declare function parseTimeoutSecEnvMs(raw: string | undefined): number | undefined;
+declare function providerResilienceConfigFromTimeouts(timeouts: KodaXTimeoutConfig | undefined): ProviderResilienceConfig | undefined;
+
+/**
+ * FEATURE_093 (v0.7.24): minimal contract interfaces for the coding extension
+ * runtime. Extracted so `@kodax-ai/coding/src/types.ts` can reference the
+ * extension runtime at the type level without importing `./extensions/runtime.js`,
+ * which in turn imports from `types.ts` — a cycle that lasted since v0.7.20.
+ *
+ * Scope: the capability methods that tool execution consumes, plus optional
+ * session lifecycle hooks that the coding run loop uses when the runtime
+ * supports them.
+ *
+ * File must have NO imports from `../types.js` (that is the cycle we are
+ * breaking). Shared capability/session value types come from `@kodax-ai/agent`.
+ */
+
+interface ExtensionRuntimeModelSelection {
+    provider?: string;
+    model?: string;
+}
+interface RuntimeDefaultsSnapshot {
+    activeTools?: string[];
+    modelSelection: ExtensionRuntimeModelSelection;
+    thinkingLevel?: KodaXWireReasoningEffort;
+}
+interface BoundExtensionRuntimeController {
+    queueUserMessage(message: string | KodaXMessage): void;
+    getSessionState<T = KodaXJsonValue>(extensionId: string, key: string): T | undefined;
+    setSessionState(extensionId: string, key: string, value: KodaXJsonValue | undefined): void;
+    getSessionStateSnapshot(extensionId: string): Record<string, KodaXJsonValue>;
+    appendSessionRecord(extensionId: string, type: string, data?: KodaXJsonValue, options?: {
+        dedupeKey?: string;
+    }): KodaXExtensionSessionRecord;
+    listSessionRecords(extensionId: string, type?: string): KodaXExtensionSessionRecord[];
+    clearSessionRecords(extensionId: string, type?: string): number;
+    getActiveTools(): string[];
+    setActiveTools(toolNames: string[]): void;
+    getModelSelection(): ExtensionRuntimeModelSelection;
+    setModelSelection(next: ExtensionRuntimeModelSelection): void;
+    getThinkingLevel(): KodaXWireReasoningEffort | undefined;
+    setThinkingLevel(level: KodaXWireReasoningEffort): void;
+}
+interface CapabilityRuntimeContract {
+    searchCapabilities(providerId: string, query: string, options?: {
+        kind?: CapabilityKind;
+        limit?: number;
+        server?: string;
+    }): Promise<unknown[]>;
+    describeCapability(providerId: string, capabilityId: string): Promise<unknown>;
+    executeCapability(providerId: string, capabilityId: string, input: Record<string, unknown>): Promise<CapabilityResult>;
+    readCapability(providerId: string, capabilityId: string, options?: Record<string, unknown>): Promise<CapabilityResult>;
+    getCapabilityPrompt(providerId: string, capabilityId: string, args?: Record<string, unknown>): Promise<unknown>;
+    getCapabilityPromptContext(providerId: string): Promise<string | undefined>;
+}
+interface ExtensionRuntimeContract extends CapabilityRuntimeContract {
+    getDefaults?(): RuntimeDefaultsSnapshot;
+    bindController?(controller: BoundExtensionRuntimeController): (() => void) | void;
+    hydrateSession?(sessionId: string): Promise<void>;
+}
+
 /**
  * FEATURE_200 Phase F (v0.7.45) — Todo domain types extracted from types.ts.
  * Self-contained (no other coding-type deps); re-exported from ../types.ts
@@ -1203,12 +1252,11 @@ type TodoList = readonly TodoItem[];
  * from types.ts. Self-contained; re-exported from ../types.ts (and 4 members
  * re-imported there for internal use). `../types` importers unaffected.
  */
-type KodaXRepoIntelligenceMode = 'auto' | 'off' | 'oss' | 'premium-shared' | 'premium-native';
-type KodaXRepoIntelligenceResolvedMode = 'off' | 'oss' | 'premium-shared' | 'premium-native';
+type KodaXRepoIntelligenceMode = 'auto' | 'off' | 'light' | 'full';
+type KodaXRepoIntelligenceResolvedMode = 'off' | 'light' | 'full';
 interface KodaXRepoIntelligenceCapability {
     mode: KodaXRepoIntelligenceResolvedMode;
-    engine: 'oss' | 'premium';
-    bridge: 'none' | 'shared' | 'native';
+    engine: 'light' | 'full';
     level: 'basic' | 'enhanced';
     status: 'ok' | 'limited' | 'unavailable' | 'warming';
     warnings: string[];
@@ -1216,12 +1264,9 @@ interface KodaXRepoIntelligenceCapability {
 }
 interface KodaXRepoIntelligenceTrace {
     mode: KodaXRepoIntelligenceResolvedMode;
-    engine: 'oss' | 'premium';
-    bridge: 'none' | 'shared' | 'native';
+    engine: 'light' | 'full';
     triggeredAt: string;
-    source: 'fallback' | 'premium';
-    daemonLatencyMs?: number;
-    cliLatencyMs?: number;
+    source: 'light' | 'full';
     cacheHit?: boolean;
     capsuleBytes?: number;
     capsuleEstimatedTokens?: number;
@@ -1377,8 +1422,7 @@ interface KodaXEvents {
      * Fires whenever a provider's `withRateLimit` loop catches a 429 /
      * 503 / 529 (overloaded) response and decides to wait before
      * retrying. Supersedes the legacy `onProviderRateLimit` (kept for
-     * back-compat) by carrying the parsed source of the wait duration —
-     * UI layers (InkREPL spinner, cost tracker) can surface the
+     * back-compat) by carrying the parsed source of the wait duration —   * UI layers (InkREPL spinner, cost tracker) can surface the
      * difference between "provider told us to wait 45s" and "no header,
      * we're guessing 4s exp-backoff".
      *
@@ -1396,6 +1440,16 @@ interface KodaXEvents {
         attempt: number;
         maxAttempts: number;
     }, meta?: KodaXActivityEventMeta) => void;
+    /**
+     * Passive capability learning — fired when a provider HARD-rejects a
+     * reasoning-effort value. The REPL records it in `capability-cache.json` so
+     * the rung is narrowed out of the ladder and never offered/sent again.
+     */
+    onReasoningEffortRejected?: (event: {
+        provider: string;
+        model: string;
+        effort: string;
+    }) => void;
     onRepoIntelligenceTrace?: (event: KodaXRepoIntelligenceTraceEvent) => void;
     /**
      * Fired when the Sidecar Verifier produces an actionable message.
@@ -1470,7 +1524,7 @@ interface KodaXEvents {
     beforeToolExecute?: (tool: string, input: Record<string, unknown>, meta?: KodaXToolEventMeta) => Promise<boolean | string>;
     /** Ask user a question interactively - Issue 069 - 交互式向用户提问 */
     askUser?: (options: AskUserQuestionOptions, meta?: KodaXToolEventMeta) => Promise<string>;
-    /** Ask user multiple independent questions sequentially - 多问题顺序提问 */
+    /** Ask user multiple independent questions sequentially - 澶氶棶棰橀『搴忔彁闂?*/
     askUserMulti?: (options: AskUserMultiOptions, meta?: KodaXToolEventMeta) => Promise<Record<string, string> | undefined>;
     /** Ask user for free-text input - 自由文本输入 (Issue 112) */
     askUserInput?: (options: {
@@ -1659,7 +1713,7 @@ interface KodaXTaskToolPolicy {
 }
 interface KodaXChildContextBundle {
     id: string;
-    fanoutClass: KodaXAmaFanoutClass;
+    fanoutClass: KodaXChildFanoutClass;
     objective: string;
     scopeSummary?: string;
     evidenceRefs: string[];
@@ -1700,6 +1754,8 @@ interface KodaXChildContextBundle {
      */
     provider?: string;
     model?: string;
+    /** Optional per-dispatch reasoning effort. Omit to inherit the parent effort. */
+    effort?: KodaXWireReasoningEffort;
 }
 /**
  * FEATURE_120 v0.7.39 Phase 4 — model tier hint. Tier semantics:
@@ -1714,7 +1770,7 @@ interface KodaXChildContextBundle {
 type KodaXChildModelHint = 'fast' | 'balanced' | 'deep';
 interface KodaXChildAgentResult {
     childId: string;
-    fanoutClass: KodaXAmaFanoutClass;
+    fanoutClass: KodaXChildFanoutClass;
     status: 'completed' | 'blocked' | 'failed';
     disposition: 'candidate' | 'valid' | 'false-positive' | 'needs-more-evidence';
     summary: string;
@@ -1767,46 +1823,6 @@ interface KodaXChildFinding {
     readonly evidence: readonly string[];
     readonly artifacts: readonly string[];
 }
-interface KodaXFanoutSchedulerInput {
-    profile: KodaXAmaProfile;
-    fanoutClass: KodaXAmaFanoutClass;
-    maxChildren?: number;
-    bundles: KodaXChildContextBundle[];
-    reductionStrategy: KodaXParentReductionContract['strategy'];
-}
-type KodaXFanoutBranchLifecycle = 'scheduled' | 'deferred' | 'completed' | 'cancelled';
-interface KodaXFanoutBranchRecord {
-    bundleId: string;
-    status: KodaXFanoutBranchLifecycle;
-    workerId?: string;
-    childId?: string;
-    reason?: string;
-}
-type KodaXFanoutBranchTransition = {
-    type: 'assign';
-    bundleId: string;
-    workerId: string;
-} | {
-    type: 'complete';
-    bundleId: string;
-    childId?: string;
-} | {
-    type: 'cancel';
-    bundleId: string;
-    reason: string;
-};
-interface KodaXFanoutSchedulerPlan {
-    enabled: boolean;
-    profile: KodaXAmaProfile;
-    fanoutClass: KodaXAmaFanoutClass;
-    branches: KodaXFanoutBranchRecord[];
-    scheduledBundleIds: string[];
-    deferredBundleIds: string[];
-    maxParallel: number;
-    mergeStrategy: KodaXParentReductionContract['strategy'];
-    cancellationPolicy: 'none' | 'winner-cancel' | 'budget-cancel';
-    reason: string;
-}
 type KodaXAgentMode = 'ama' | 'sa' | 'amaw';
 type KodaXMemoryStrategy = 'continuous' | 'compact' | 'reset-handoff';
 type KodaXBudgetDisclosureZone = 'green' | 'yellow' | 'orange' | 'red';
@@ -1837,7 +1853,7 @@ interface KodaXManagedTaskStatusEvent {
     harnessProfile: KodaXHarnessProfile;
     activeWorkerId?: string;
     activeWorkerTitle?: string;
-    childFanoutClass?: KodaXAmaFanoutClass;
+    childFanoutClass?: KodaXChildFanoutClass;
     childFanoutCount?: number;
     currentRound?: number;
     maxRounds?: number;
@@ -1878,8 +1894,7 @@ interface KodaXManagedTaskStatusEvent {
      * can tell how many outstanding pieces of work are pending. 0 with
      * `idleWaiting=true` is the transitional "background banner queued,
      * registry already drained" state (fast-child race recovery path,
-     * see FEATURE_155 hotfix follow-up #2) and renders as "idle —
-     * resuming".
+     * see FEATURE_155 hotfix follow-up #2) and renders as "idle —   * resuming".
      */
     idleWaitingPendingCount?: number;
 }
@@ -1944,10 +1959,30 @@ interface KodaXManagedBudgetSnapshot {
     extensionDenied?: boolean;
     extensionReason?: string;
 }
-/** Mutable tracker for Scout mutation scope — shared between worker events and protocol tool. */
+/** Mutable tracker for filesystem/shell mutations observed during managed Worker execution. */
 interface ManagedMutationTracker {
     readonly files: Map<string, number>;
     totalOps: number;
+    /**
+     * Count of high-risk shell mutations (git push/commit/rm, npm install/publish,
+     * rm/mv/cp, etc.) the Worker ran via `bash`. Tracked separately from `totalOps`
+     * because bash writes are a blind spot — we cannot know which file / how many
+     * lines a shell command touched — so the Verifier gate fires conservatively on
+     * any risky shell op rather than inferring risk back out of `totalOps`.
+     * Optional: defaults to 0 when absent (read as `riskyShellOps ?? 0`).
+     */
+    riskyShellOps?: number;
+    /**
+     * Count of filesystem mutations whose touched file could NOT be attributed
+     * from the tool input (the path is computed inside the handler): `undo`,
+     * `worktree_create` / `worktree_remove`, `stage_construction` /
+     * `stage_agent_construction`, or `stage_self_modify`. These bump `totalOps`
+     * but leave `files` empty,
+     * so without a separate count they would look like trivial no-op work to the
+     * Verifier gate. Like `riskyShellOps`, an unattributable write is a blind spot
+     * the gate fires on conservatively. Optional: read as `unattributedWriteOps ?? 0`.
+     */
+    unattributedWriteOps?: number;
     /** Set to true after scope reflection has been injected once. Prevents repeated injection. */
     reflectionInjected?: boolean;
 }
@@ -1982,8 +2017,7 @@ interface KodaXContextOptions {
     /**
      * FEATURE_087/088 (v0.7.28): when true, the prompt builder injects a
      * Tool Construction section that orients the LLM to the
-     * scaffold_tool → validate_tool → stage_construction → test_tool →
-     * activate_tool staircase. Off by default; the surrounding agent (REPL
+     * scaffold_tool → validate_tool → stage_construction → test_tool →   * activate_tool staircase. Off by default; the surrounding agent (REPL
      * config or task router) flips this on when self-construction is
      * authorized for the session. The corresponding builtin tool handlers
      * are still gated independently by the active-tool set.
@@ -2117,6 +2151,7 @@ interface KodaXOptions {
     provider: string;
     model?: string;
     modelOverride?: string;
+    effort?: KodaXWireReasoningEffort;
     thinking?: boolean;
     reasoningMode?: KodaXReasoningMode;
     agentMode?: KodaXAgentMode;
@@ -2156,6 +2191,12 @@ interface KodaXOptions {
      * and `~/.kodax/config.json`. See {@link KodaXCompactionOverride}.
      */
     compaction?: KodaXCompactionOverride;
+    /**
+     * SDK-consumer timeout budgets for user-facing waits. Values are seconds at
+     * the public API boundary; KodaX converts them to milliseconds internally.
+     * This does not control internal cleanup/resource-protection watchdogs.
+     */
+    timeouts?: KodaXTimeoutConfig;
 }
 /**
  * Low-level mutators handed to a `KodaXSessionControl` by the substrate.
@@ -2227,6 +2268,7 @@ interface KodaXTaskEvidenceArtifact {
     description?: string;
 }
 type KodaXImageMediaType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';
+type KodaXVideoMediaType = 'video/mp4' | 'video/mpeg' | 'video/quicktime' | 'video/x-msvideo' | 'video/x-flv' | 'video/webm' | 'video/x-ms-wmv' | 'video/3gpp';
 type KodaXInputArtifactSource = 'user-inline' | 'clipboard' | 'drag-drop' | 'file-picker';
 interface KodaXImageInputArtifact {
     readonly kind: 'image';
@@ -2235,7 +2277,24 @@ interface KodaXImageInputArtifact {
     readonly source?: KodaXInputArtifactSource;
     readonly description?: string;
 }
-type KodaXInputArtifact = KodaXImageInputArtifact;
+interface KodaXFileInputArtifact {
+    readonly kind: 'file';
+    readonly path: string;
+    readonly mediaType?: string;
+    readonly mimeType?: string;
+    readonly name?: string;
+    readonly source?: KodaXInputArtifactSource;
+    readonly description?: string;
+}
+interface KodaXVideoInputArtifact {
+    readonly kind: 'video';
+    readonly path: string;
+    readonly mediaType: KodaXVideoMediaType;
+    readonly name?: string;
+    readonly source?: KodaXInputArtifactSource;
+    readonly description?: string;
+}
+type KodaXInputArtifact = KodaXImageInputArtifact | KodaXFileInputArtifact | KodaXVideoInputArtifact;
 interface KodaXTaskEvidenceEntry {
     assignmentId: string;
     role: KodaXTaskRole;
@@ -2265,14 +2324,9 @@ interface KodaXOrchestrationVerdict {
     disposition?: 'complete' | 'blocked' | 'needs_continuation';
 }
 interface KodaXManagedTaskRuntimeState {
-    amaProfile?: KodaXAmaProfile;
-    amaTactics?: KodaXAmaTactic[];
-    amaFanout?: KodaXAmaFanoutPolicy;
-    amaControllerReason?: string;
     childContextBundles?: KodaXChildContextBundle[];
     childAgentResults?: KodaXChildAgentResult[];
     parentReductionContract?: KodaXParentReductionContract;
-    fanoutSchedulerPlan?: KodaXFanoutSchedulerPlan;
     budget?: KodaXManagedBudgetSnapshot;
     scorecard?: KodaXVerificationScorecard;
     qualityAssuranceMode?: 'required' | 'optional';
@@ -2327,8 +2381,7 @@ interface KodaXManagedTask {
     runtime?: KodaXManagedTaskRuntimeState;
 }
 interface KodaXManagedVerdictPayload {
-    /** FEATURE_184 (v0.7.45): `'sidecar'` is the new architectural source —
-     *  Sidecar Verifier replaces the in-chain Evaluator role. `'evaluator'`
+    /** FEATURE_184 (v0.7.45): `'sidecar'` is the new architectural source —   *  Sidecar Verifier replaces the in-chain Evaluator role. `'evaluator'`
      *  / `'worker'` are retained for backward-compat reads of session jsonl
      *  written before v0.7.45. New writes use `'sidecar'`. */
     source: 'evaluator' | 'worker' | 'sidecar';
@@ -2416,7 +2469,7 @@ interface KodaXResult {
 interface KodaXToolExecutionContext {
     /** File backups for undo functionality - 文件备份用于撤销功能 */
     backups: Map<string, string>;
-    /** Git root directory - Git 根目录 */
+    /** Git root directory - Git 鏍圭洰褰?*/
     gitRoot?: string;
     /** FEATURE_221: SDK-consumer self-manual injection, forwarded from KodaXOptions. */
     selfManual?: KodaXSelfManualConfig;
@@ -2440,7 +2493,7 @@ interface KodaXToolExecutionContext {
     extensionRuntime?: CapabilityRuntimeContract;
     /** Ask user a question interactively (select mode) - 交互式向用户提问 (Issue 069) */
     askUser?: (options: AskUserQuestionOptions) => Promise<string>;
-    /** Ask user multiple independent questions sequentially - 多问题顺序提问 */
+    /** Ask user multiple independent questions sequentially - 澶氶棶棰橀『搴忔彁闂?*/
     askUserMulti?: (options: AskUserMultiOptions) => Promise<Record<string, string> | undefined>;
     /** Ask user for free-text input - 自由文本输入 (Issue 112) */
     askUserInput?: (options: {
@@ -2482,6 +2535,9 @@ interface KodaXToolExecutionContext {
         readonly provider: string;
         readonly model?: string;
         readonly reasoningMode?: KodaXReasoningMode;
+        readonly effort?: KodaXWireReasoningEffort;
+        readonly repoIntelligenceMode?: KodaXRepoIntelligenceMode;
+        readonly repoIntelligenceTrace?: boolean;
     };
     /**
      * Parent SDK/REPL callback surface available to child-dispatch tools.
@@ -2562,7 +2618,6 @@ interface KodaXToolExecutionContext {
      * child's `Runner.run` via `KodaXOptions.guardrails`. Sharing the SAME
      * guardrail instance means the auto-mode `engine` + `denialTracker` +
      * `circuitBreaker` state is observed across the parent/child boundary —
-     * design doc "防绕阈值" defense (a child can't escape the parent's
      * rate-limit by hitting the threshold from a fresh tracker).
      *
      * Single-process / single-thread execution makes the shared mutable state
@@ -2869,5 +2924,5 @@ interface CreateBashPrefixExtractorOptions {
  */
 declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
 
-export { BASH_POLICY_SPEC as B, getDefaultLspService as a$, buildGoalRuntimeBinding as aX, createBashPrefixExtractor as aY, decideWorkflowInvocation as aZ, extractCommandPrefix as a_, LSP_SERVERS as av, LspService as ax, makeDisabledGoalToolsContext as b0, shutdownDefaultLspService as b1, withGoalBeforeNextTurn as b2, withGoalStopHook as b3, workflowStartOutcomeConsumesTurn as b4 };
-export type { KodaXRepoIntelligenceTrace as $, KodaXFanoutSchedulerPlan as A, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXImageInputArtifact as H, KodaXImageMediaType as I, KodaXInputArtifact as J, KodaXActivityEventMeta as K, KodaXInputArtifactSource as L, KodaXManagedBudgetSnapshot as M, KodaXManagedProtocolPayload as N, KodaXManagedTask as O, KodaXManagedTaskRuntimeState as P, KodaXManagedTaskStatusEvent as Q, KodaXManualTopicId as R, KodaXManualTopicInput as S, KodaXMemoryStrategy as T, KodaXOptions as U, KodaXOrchestrationVerdict as V, KodaXParentReductionContract as W, KodaXProviderPolicyHints as X, KodaXRepoIntelligenceCapability as Y, KodaXRepoIntelligenceMode as Z, KodaXRepoIntelligenceResolvedMode as _, BashPrefixExtractor as a, KodaXRepoIntelligenceTraceEvent as a0, KodaXRepoRoutingSignals as a1, KodaXResult as a2, KodaXRoleRoundSummary as a3, KodaXRuntimeVerificationContract as a4, KodaXSelfManualConfig as a5, KodaXSessionControl as a6, KodaXSessionMutators as a7, KodaXSessionOptions as a8, KodaXSidecarMessageEvent as a9, ProviderRecoveryEvent as aA, ProviderResilienceConfig as aB, ProviderResiliencePolicy as aC, RecoveryAction as aD, RecoveryDecision as aE, RecoveryLadderStep as aF, RecoveryResult as aG, ResilienceClassification as aH, ResilienceErrorClass as aI, ResolveKodaXManualInput as aJ, ResolveKodaXManualOptions as aK, ResolveKodaXManualResult as aL, RuntimeDefaultsSnapshot as aM, TodoItem as aN, TodoList as aO, TodoStatus as aP, WorkflowHostPolicy as aQ, WorkflowInvocationAction as aR, WorkflowInvocationPolicyDecision as aS, WorkflowInvocationPolicyInput as aT, WorkflowInvocationSource as aU, WorkflowInvocationTrigger as aV, WorkflowStartOutcome as aW, KodaXSkillInvocationContext as aa, KodaXSkillMap as ab, KodaXSkillProjectionConfidence as ac, KodaXTaskCapabilityHint as ad, KodaXTaskContract as ae, KodaXTaskEvidenceArtifact as af, KodaXTaskEvidenceBundle as ag, KodaXTaskEvidenceEntry as ah, KodaXTaskRole as ai, KodaXTaskRoleAssignment as aj, KodaXTaskStatus as ak, KodaXTaskSurface as al, KodaXTaskToolPolicy as am, KodaXTaskVerificationContract as an, KodaXTaskVerificationCriterion as ao, KodaXTaskWorkItem as ap, KodaXToolEventMeta as aq, KodaXToolExecutionContext as ar, KodaXVerificationScorecard as as, KodaXVerificationScorecardCriterion as at, KodaXWorkflowEventMeta as au, LspServerInfo as aw, LspServiceConfig as ay, ProviderExecutionState as az, BashPrefixResult as b, BoundExtensionRuntimeController as c, ChildSnapshotEvent as d, CreateBashPrefixExtractorOptions as e, ExtractCommandPrefixOptions as f, GoalCompleteResult as g, GoalCreateInput as h, GoalLifecycleContext as i, GoalRuntimeBinding as j, GoalRuntimeBindingDeps as k, GoalToolsContext as l, KodaXAgentMode as m, KodaXBudgetDisclosureZone as n, KodaXBudgetExtensionRequest as o, KodaXChildAgentResult as p, KodaXChildContextBundle as q, KodaXChildExecutionResult as r, KodaXCompactionOverride as s, KodaXContextOptions as t, KodaXContextTokenSnapshot as u, KodaXEvents as v, KodaXFanoutBranchLifecycle as w, KodaXFanoutBranchRecord as x, KodaXFanoutBranchTransition as y, KodaXFanoutSchedulerInput as z };
+export { BASH_POLICY_SPEC as B, extractCommandPrefix as a$, buildGoalRuntimeBinding as aY, createBashPrefixExtractor as aZ, decideWorkflowInvocation as a_, LSP_SERVERS as aw, LspService as ay, getDefaultLspService as b0, makeDisabledGoalToolsContext as b1, parseTimeoutSecEnvMs as b2, providerResilienceConfigFromTimeouts as b3, shutdownDefaultLspService as b4, timeoutSecToMs as b5, withGoalBeforeNextTurn as b6, withGoalStopHook as b7, workflowStartOutcomeConsumesTurn as b8 };
+export type { KodaXResult as $, KodaXInputArtifactSource as A, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXLlmTimeoutConfig as H, KodaXManagedBudgetSnapshot as I, KodaXManagedProtocolPayload as J, KodaXActivityEventMeta as K, KodaXManagedTask as L, KodaXManagedTaskRuntimeState as M, KodaXManagedTaskStatusEvent as N, KodaXManualTopicId as O, KodaXManualTopicInput as P, KodaXMemoryStrategy as Q, KodaXOptions as R, KodaXOrchestrationVerdict as S, KodaXParentReductionContract as T, KodaXProviderPolicyHints as U, KodaXRepoIntelligenceCapability as V, KodaXRepoIntelligenceMode as W, KodaXRepoIntelligenceResolvedMode as X, KodaXRepoIntelligenceTrace as Y, KodaXRepoIntelligenceTraceEvent as Z, KodaXRepoRoutingSignals as _, BashPrefixExtractor as a, KodaXRoleRoundSummary as a0, KodaXRuntimeVerificationContract as a1, KodaXSelfManualConfig as a2, KodaXSessionControl as a3, KodaXSessionMutators as a4, KodaXSessionOptions as a5, KodaXSidecarMessageEvent as a6, KodaXSkillInvocationContext as a7, KodaXSkillMap as a8, KodaXSkillProjectionConfidence as a9, ProviderExecutionState as aA, ProviderRecoveryEvent as aB, ProviderResilienceConfig as aC, ProviderResiliencePolicy as aD, RecoveryAction as aE, RecoveryDecision as aF, RecoveryLadderStep as aG, RecoveryResult as aH, ResilienceClassification as aI, ResilienceErrorClass as aJ, ResolveKodaXManualInput as aK, ResolveKodaXManualOptions as aL, ResolveKodaXManualResult as aM, RuntimeDefaultsSnapshot as aN, TodoItem as aO, TodoList as aP, TodoStatus as aQ, WorkflowHostPolicy as aR, WorkflowInvocationAction as aS, WorkflowInvocationPolicyDecision as aT, WorkflowInvocationPolicyInput as aU, WorkflowInvocationSource as aV, WorkflowInvocationTrigger as aW, WorkflowStartOutcome as aX, KodaXTaskCapabilityHint as aa, KodaXTaskContract as ab, KodaXTaskEvidenceArtifact as ac, KodaXTaskEvidenceBundle as ad, KodaXTaskEvidenceEntry as ae, KodaXTaskRole as af, KodaXTaskRoleAssignment as ag, KodaXTaskStatus as ah, KodaXTaskSurface as ai, KodaXTaskToolPolicy as aj, KodaXTaskVerificationContract as ak, KodaXTaskVerificationCriterion as al, KodaXTaskWorkItem as am, KodaXTimeoutConfig as an, KodaXToolEventMeta as ao, KodaXToolExecutionContext as ap, KodaXVerificationScorecard as aq, KodaXVerificationScorecardCriterion as ar, KodaXVideoInputArtifact as as, KodaXVideoMediaType as at, KodaXWorkflowEventMeta as au, KodaXWorkflowTimeoutConfig as av, LspServerInfo as ax, LspServiceConfig as az, BashPrefixResult as b, BoundExtensionRuntimeController as c, ChildSnapshotEvent as d, CreateBashPrefixExtractorOptions as e, ExtractCommandPrefixOptions as f, GoalCompleteResult as g, GoalCreateInput as h, GoalLifecycleContext as i, GoalRuntimeBinding as j, GoalRuntimeBindingDeps as k, GoalToolsContext as l, KodaXAgentMode as m, KodaXBudgetDisclosureZone as n, KodaXBudgetExtensionRequest as o, KodaXChildAgentResult as p, KodaXChildContextBundle as q, KodaXChildExecutionResult as r, KodaXCompactionOverride as s, KodaXContextOptions as t, KodaXContextTokenSnapshot as u, KodaXEvents as v, KodaXFileInputArtifact as w, KodaXImageInputArtifact as x, KodaXImageMediaType as y, KodaXInputArtifact as z };