@kodax-ai/kodax 0.7.55 → 0.7.57

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

@@ -1,7 +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-Bj82oJhD.js';
-import { _ as KodaXTokenUsage, G as KodaXReasoningMode, o as KodaXMessage, l as KodaXHarnessProfile, V as KodaXTaskWorkIntent, M as KodaXReviewScale, R as KodaXTaskComplexity, a as KodaXAmaFanoutClass, T as KodaXTaskRoutingDecision, U as KodaXTaskType, N as KodaXRiskLevel, j as KodaXExecutionMode, c as KodaXAmaProfile, d as KodaXAmaTactic, b as KodaXAmaFanoutPolicy, f as KodaXBaseProvider } from './base.d-BBNUF9nz.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-BnjQrSVf.js';
 import { a as CostTracker } from './cost-tracker.d-wRtyEW9d.js';
 
 /**
@@ -523,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. */
@@ -595,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
@@ -602,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')`. */
@@ -917,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)
  *
@@ -1106,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
@@ -1202,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[];
@@ -1215,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;
@@ -1376,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".
      *
@@ -1395,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.
@@ -1469,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: {
@@ -1658,7 +1713,7 @@ interface KodaXTaskToolPolicy {
 }
 interface KodaXChildContextBundle {
     id: string;
-    fanoutClass: KodaXAmaFanoutClass;
+    fanoutClass: KodaXChildFanoutClass;
     objective: string;
     scopeSummary?: string;
     evidenceRefs: string[];
@@ -1699,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:
@@ -1713,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;
@@ -1766,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';
@@ -1836,7 +1853,7 @@ interface KodaXManagedTaskStatusEvent {
     harnessProfile: KodaXHarnessProfile;
     activeWorkerId?: string;
     activeWorkerTitle?: string;
-    childFanoutClass?: KodaXAmaFanoutClass;
+    childFanoutClass?: KodaXChildFanoutClass;
     childFanoutCount?: number;
     currentRound?: number;
     maxRounds?: number;
@@ -1877,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;
 }
@@ -1943,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;
 }
@@ -1981,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.
@@ -2116,6 +2151,7 @@ interface KodaXOptions {
     provider: string;
     model?: string;
     modelOverride?: string;
+    effort?: KodaXWireReasoningEffort;
     thinking?: boolean;
     reasoningMode?: KodaXReasoningMode;
     agentMode?: KodaXAgentMode;
@@ -2155,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.
@@ -2225,13 +2267,34 @@ interface KodaXTaskEvidenceArtifact {
     path: string;
     description?: string;
 }
-interface KodaXInputArtifact {
-    kind: 'image';
-    path: string;
-    mediaType?: string;
-    source: 'user-inline';
-    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';
+    readonly path: string;
+    readonly mediaType?: KodaXImageMediaType;
+    readonly source?: KodaXInputArtifactSource;
+    readonly description?: string;
+}
+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;
@@ -2261,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';
@@ -2323,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';
@@ -2412,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;
@@ -2436,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: {
@@ -2478,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.
@@ -2558,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
@@ -2865,5 +2924,5 @@ interface CreateBashPrefixExtractorOptions {
  */
 declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
 
-export { BASH_POLICY_SPEC as B, withGoalBeforeNextTurn as a$, buildGoalRuntimeBinding as aU, createBashPrefixExtractor as aV, decideWorkflowInvocation as aW, extractCommandPrefix as aX, getDefaultLspService as aY, makeDisabledGoalToolsContext as aZ, shutdownDefaultLspService as a_, LSP_SERVERS as as, LspService as au, withGoalStopHook as b0, workflowStartOutcomeConsumesTurn as b1 };
-export type { KodaXResult as $, KodaXFanoutSchedulerPlan as A, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXInputArtifact 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, RecoveryAction as aA, RecoveryDecision as aB, RecoveryLadderStep as aC, RecoveryResult as aD, ResilienceClassification as aE, ResilienceErrorClass as aF, ResolveKodaXManualInput as aG, ResolveKodaXManualOptions as aH, ResolveKodaXManualResult as aI, RuntimeDefaultsSnapshot as aJ, TodoItem as aK, TodoList as aL, TodoStatus as aM, WorkflowHostPolicy as aN, WorkflowInvocationAction as aO, WorkflowInvocationPolicyDecision as aP, WorkflowInvocationPolicyInput as aQ, WorkflowInvocationSource as aR, WorkflowInvocationTrigger as aS, WorkflowStartOutcome as aT, 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, KodaXToolEventMeta as an, KodaXToolExecutionContext as ao, KodaXVerificationScorecard as ap, KodaXVerificationScorecardCriterion as aq, KodaXWorkflowEventMeta as ar, LspServerInfo as at, LspServiceConfig as av, ProviderExecutionState as aw, ProviderRecoveryEvent as ax, ProviderResilienceConfig as ay, ProviderResiliencePolicy 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 };

package/dist/types-chunks/{capsule.d-CNonpwAZ.d.ts → capsule.d-DwJp5r63.d.ts}

@@ -1,6 +1,6 @@
-import { o as KodaXMessage } from './base.d-BBNUF9nz.js';
-import { Q as QueueEventListener, e as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-D4jL-gAA.js';
-import { f as AgentMessage, aM as SessionEntry, aK as Session, aO as SessionExtension, a4 as KodaXSessionLineage, W as KodaXJsonValue, p as CompactionDetails, O as KodaXCompactMemorySeed, a0 as KodaXSessionEntry, ab as KodaXSessionTreeNode, a3 as KodaXSessionLabelEntry, a2 as KodaXSessionGoalEntry, a7 as KodaXSessionNavigationOptions, Y as KodaXSessionArtifactLedgerEntry, x as FileOperations, br as WorkflowMeta, bs as WorkflowModelHint, bt as WorkflowModule } from './process.d-Bj82oJhD.js';
+import { j as KodaXMessage } from './types.d-6VOXvF88.js';
+import { Q as QueueEventListener, c as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-D8WcfrOD.js';
+import { f as AgentMessage, aM as SessionEntry, aK as Session, aO as SessionExtension, a4 as KodaXSessionLineage, W as KodaXJsonValue, p as CompactionDetails, O as KodaXCompactMemorySeed, a0 as KodaXSessionEntry, ab as KodaXSessionTreeNode, a3 as KodaXSessionLabelEntry, a2 as KodaXSessionGoalEntry, a7 as KodaXSessionNavigationOptions, Y as KodaXSessionArtifactLedgerEntry, x as FileOperations, br as WorkflowMeta, bs as WorkflowModelHint, bt as WorkflowModule } from './process.d-BZncyzEj.js';
 
 /**
  * @kodax-ai/agent Constants
@@ -188,8 +188,8 @@ declare class DefaultSummaryCompaction implements CompactionPolicy {
  *      before any subsystem reads the path.
  *   2. **`KODAX_HOME` env var** — middle priority. Used by shell / CI /
  *      test isolation / multi-tenant shared machines. (Already honored
- *      historically by `@kodax-ai/llm/src/reasoning-overrides.ts`; this
- *      helper makes it the canonical path for all packages.)
+ *      historically by the llm-layer config helpers; this helper makes it
+ *      the canonical path for all packages.)
  *   3. **`~/.kodax/`** — lowest priority. Default for the standalone
  *      kodax CLI. With DI not set + env not set, the resolver returns
  *      the same byte sequence as the prior hardcoded
@@ -209,9 +209,9 @@ declare class DefaultSummaryCompaction implements CompactionPolicy {
  * `~/.opsagent/` simultaneously).
  *
  * NOT migrated:
- *   - `@kodax-ai/llm/src/reasoning-overrides.ts:49` keeps its inline
+ *   - llm-layer config helpers keep their inline
  *     `process.env.KODAX_HOME ?? path.join(os.homedir(), '.kodax')`
- *     fallback because moving it to this helper would create an
+ *     fallback because moving them to this helper would create an
  *     `@kodax-ai/llm → @kodax-ai/agent` dependency cycle (agent already
  *     imports ai). The two implementations have identical observable
  *     behavior at the env / default tiers; the programmatic override
@@ -382,8 +382,10 @@ declare function _resetMessageQueueForTests(): void;
  *     history and fixes mis-pairings on both sides — orphan `tool_use` in
  *     assistant messages, orphan `tool_result` in user messages, and ensures
  *     no message becomes empty after stripping (Kimi specifically rejects
- *     empty assistant messages with 400, so we inject a `'...'` placeholder
- *     when stripping would empty an assistant message).
+ *     empty assistant messages with 400, so we inject an EMPTY text-block
+ *     marker when stripping would empty an assistant message — the visible
+ *     `'...'` is synthesized wire-only by the provider serializer, never
+ *     persisted into history).
  *
  * Migration history: extracted from `agent.ts` (originally lines 517–758)
  * during FEATURE_100 P2. Both `agent.ts` and `task-engine/runner-driven.ts`
@@ -407,8 +409,9 @@ declare function _resetMessageQueueForTests(): void;
  *     message → removed
  *   - user `tool_result` with empty / missing tool_use_id → removed
  *   - assistant message that becomes content-empty after stripping → inject
- *     a `'...'` placeholder text block (preserves message-alternation invariant
- *     downstream providers like Kimi require)
+ *     an EMPTY text-block marker (preserves message-alternation invariant
+ *     downstream providers like Kimi require; the visible '...' is added
+ *     wire-only by the serializer, never persisted)
  */
 declare function validateAndFixToolHistory(messages: KodaXMessage[]): KodaXMessage[];
 /**