@kodax-ai/kodax 0.7.52 → 0.7.54

package/dist/types-chunks/{bash-prefix-extractor.d-DBFZEwop.d.ts → bash-prefix-extractor.d-CBLoD2Jk.d.ts}

@@ -1,5 +1,5 @@
-import { U as KodaXGoalState, f as AgentMessage, b0 as StopHookFn, a4 as KodaXSessionLineage, a9 as KodaXSessionScope, aa as KodaXSessionStorage, W as KodaXJsonValue, 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, o as KodaXMessage, G as KodaXReasoningMode, 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 { 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 { C as CapabilityKind, b as CapabilityResult } from './capability.d-3C62G8Eq.js';
 import { a as CostTracker } from './cost-tracker.d-wRtyEW9d.js';
@@ -872,7 +872,7 @@ declare function buildGoalRuntimeBinding(deps: GoalRuntimeBindingDeps): GoalRunt
  * configure / install / troubleshoot KodaX?" questions. Pure data + a
  * deterministic resolver — no RAG, no vector store, no network fetch.
  */
-type KodaXManualTopicId = 'overview' | 'install' | 'quickstart' | 'providers' | 'custom-providers' | 'config' | 'permissions' | 'commands' | 'tools' | 'agents' | 'skills' | 'mcp' | 'repo-intelligence' | 'sessions' | 'doctor' | 'sdk' | 'troubleshooting';
+type KodaXManualTopicId = 'overview' | 'install' | 'quickstart' | 'providers' | 'custom-providers' | 'config' | 'permissions' | 'commands' | 'tools' | 'agents' | 'skills' | 'extensions' | 'mcp' | 'repo-intelligence' | 'sessions' | 'doctor' | 'sdk' | 'troubleshooting';
 /** A pointer to the code/doc the topic is derived from (for traceability). */
 interface KodaXManualSource {
     readonly label: string;
@@ -918,22 +918,46 @@ interface ResolveKodaXManualResult {
 }
 
 /**
- * FEATURE_093 (v0.7.24): minimal contract interface for the coding extension
+ * 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: only the methods that `KodaXOptions.extensionRuntime` and
- * `KodaXToolExecutionContext.extensionRuntime` consumers actually invoke.
- * The concrete `KodaXExtensionRuntime` class in `./runtime.ts` implements
- * this contract plus ~40 additional internal methods that are not exposed
- * through Options/Context fields.
+ * 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). Capability types come from `@kodax-ai/core`.
+ * breaking). Shared capability/session value types come from `@kodax-ai/agent`.
  */
 
-interface ExtensionRuntimeContract {
+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;
@@ -945,6 +969,11 @@ interface ExtensionRuntimeContract {
     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)
@@ -1233,6 +1262,26 @@ interface KodaXActivityEventMeta extends KodaXWorkflowEventMeta {
 interface KodaXToolEventMeta extends KodaXActivityEventMeta {
     readonly toolId?: string;
 }
+interface KodaXSidecarMessageEvent {
+    readonly source: 'sidecar-verifier';
+    readonly verdict: 'revise' | 'blocked';
+    readonly recipient: 'main-agent' | 'user';
+    readonly delivery: 'synthetic-user-message' | 'budget-exhausted' | 'terminal-block';
+    /** Exact actionable text from the sidecar. `budget-exhausted` means it was not injected. */
+    readonly content: string;
+    readonly suggestedFix?: string;
+    readonly trace?: string;
+}
+interface KodaXTodoDriftWarningEvent {
+    readonly kind: 'work_started_without_claimed_todo';
+    readonly toolName: string;
+    readonly toolCallId?: string;
+    readonly count: number;
+    readonly pendingCount: number;
+    readonly openCount: number;
+    readonly firstPendingTodoId?: string;
+    readonly firstPendingTodoSubject?: string;
+}
 interface KodaXEvents {
     /** FEATURE_229: correlates child-agent SDK callbacks back to a workflow run/item. */
     workflowCorrelation?: WorkflowEventCorrelation;
@@ -1347,6 +1396,16 @@ interface KodaXEvents {
         maxAttempts: number;
     }, meta?: KodaXActivityEventMeta) => void;
     onRepoIntelligenceTrace?: (event: KodaXRepoIntelligenceTraceEvent) => void;
+    /**
+     * Fired when the Sidecar Verifier produces an actionable message.
+     *
+     * `revise` is usually injected back into the main agent as a synthetic user
+     * message; if the reanimate budget is already exhausted, the same verdict is
+     * surfaced with `delivery: "budget-exhausted"` and no injection occurs.
+     * `blocked` is surfaced terminally to the user. Accept remains silent here
+     * because there is no sidecar-to-agent reply to show.
+     */
+    onSidecarMessage?: (event: KodaXSidecarMessageEvent) => void;
     /**
      * FEATURE_097 (v0.7.34): emitted whenever the Scout-seeded todo list
      * changes — initial seed at `emit_scout_verdict`, per-item updates from
@@ -1357,6 +1416,13 @@ interface KodaXEvents {
      * (FEATURE_086 onRepoIntelligenceTrace single-rail precedent).
      */
     onTodoUpdate?: (items: TodoList) => void;
+    /**
+     * Warn-only telemetry: a successful real work tool completed while the
+     * visible todo list had pending items but no item marked in_progress.
+     * The runner does not mutate the todo list for this signal; it only
+     * nudges the next model turn to call todo_update explicitly.
+     */
+    onTodoDriftWarning?: (event: KodaXTodoDriftWarningEvent) => void;
     /** Structured provider recovery event (Feature 045) */
     onProviderRecovery?: (event: ProviderRecoveryEvent, meta?: KodaXActivityEventMeta) => void;
     onComplete?: () => void;
@@ -1455,6 +1521,10 @@ interface KodaXSessionOptions {
     tag?: string;
     storage?: KodaXSessionStorage;
     initialMessages?: KodaXMessage[];
+    /** Host-provided extension state paired with initialMessages, avoiding a full storage load. */
+    initialExtensionState?: KodaXExtensionSessionState;
+    /** Host-provided extension records paired with initialMessages, avoiding a full storage load. */
+    initialExtensionRecords?: KodaXExtensionSessionRecord[];
     /**
      * Persistence ownership signal (FEATURE_173 dual-writer fix).
      *
@@ -2227,6 +2297,12 @@ interface KodaXManagedTaskRuntimeState {
     reviewFilesOrAreas?: string[];
     toolOutputTruncated?: boolean;
     toolOutputTruncationNotes?: string[];
+    /**
+     * Warn-only todo hygiene telemetry: successful real work started while
+     * pending todos existed and no item was marked in_progress. The runner
+     * never mutates todo state from this signal.
+     */
+    todoDriftWarnings?: KodaXTodoDriftWarningEvent[];
     managedTimeline?: KodaXManagedLiveEvent[];
     evidenceAcquisitionMode?: 'overview' | 'diff-bundle' | 'diff-slice' | 'file-read';
     consecutiveEvidenceOnlyIterations?: number;
@@ -2290,6 +2366,10 @@ type KodaXScoutSuspiciousSignal = 'mutation-expected-but-none' | 'budget-exhaust
 interface KodaXManagedProtocolPayload {
     verdict?: KodaXManagedVerdictPayload;
 }
+interface KodaXRuntimeSessionSnapshot {
+    extensionState?: KodaXExtensionSessionState;
+    extensionRecords?: KodaXExtensionSessionRecord[];
+}
 interface KodaXResult {
     success: boolean;
     lastText: string;
@@ -2310,6 +2390,8 @@ interface KodaXResult {
     contextTokenSnapshot?: KodaXContextTokenSnapshot;
     /** Latest provider usage when the caller has it directly. */
     usage?: KodaXTokenUsage;
+    /** Serializable runtime-owned session state for host-owned persistence. */
+    runtimeSessionSnapshot?: KodaXRuntimeSessionSnapshot;
     /**
      * FEATURE_076: artifact ledger pre-extracted before round-boundary reshape.
      * Populated when the reshape replaces `messages` with a clean {user, assistant}
@@ -2349,7 +2431,7 @@ interface KodaXToolExecutionContext {
      */
     workflowWorktreeBaseDir?: string;
     /** Shared extension capability runtime used by retrieval-family tools. */
-    extensionRuntime?: ExtensionRuntimeContract;
+    extensionRuntime?: CapabilityRuntimeContract;
     /** Ask user a question interactively (select mode) - 交互式向用户提问 (Issue 069) */
     askUser?: (options: AskUserQuestionOptions) => Promise<string>;
     /** Ask user multiple independent questions sequentially - 多问题顺序提问 */
@@ -2781,5 +2863,5 @@ interface CreateBashPrefixExtractorOptions {
  */
 declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
 
-export { BASH_POLICY_SPEC as B, buildGoalRuntimeBinding as aQ, createBashPrefixExtractor as aR, decideWorkflowInvocation as aS, extractCommandPrefix as aT, getDefaultLspService as aU, makeDisabledGoalToolsContext as aV, shutdownDefaultLspService as aW, withGoalBeforeNextTurn as aX, withGoalStopHook as aY, workflowStartOutcomeConsumesTurn as aZ, LSP_SERVERS as ap, LspService as ar };
-export type { KodaXRuntimeVerificationContract as $, KodaXManagedBudgetSnapshot as A, ChildSnapshotEvent as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXManagedProtocolPayload as H, KodaXManagedTask as I, KodaXManagedTaskRuntimeState as J, KodaXActivityEventMeta as K, KodaXManagedTaskStatusEvent as L, KodaXManualTopicId as M, KodaXManualTopicInput as N, KodaXMemoryStrategy as O, KodaXOptions as P, KodaXOrchestrationVerdict as Q, KodaXParentReductionContract as R, KodaXProviderPolicyHints as S, KodaXRepoIntelligenceCapability as T, KodaXRepoIntelligenceMode as U, KodaXRepoIntelligenceResolvedMode as V, KodaXRepoIntelligenceTrace as W, KodaXRepoIntelligenceTraceEvent as X, KodaXRepoRoutingSignals as Y, KodaXResult as Z, KodaXRoleRoundSummary as _, BashPrefixExtractor as a, KodaXSelfManualConfig as a0, KodaXSessionControl as a1, KodaXSessionMutators as a2, KodaXSessionOptions as a3, KodaXSkillInvocationContext as a4, KodaXSkillMap as a5, KodaXSkillProjectionConfidence as a6, KodaXTaskCapabilityHint as a7, KodaXTaskContract as a8, KodaXTaskEvidenceArtifact as a9, RecoveryResult as aA, ResilienceClassification as aB, ResilienceErrorClass as aC, ResolveKodaXManualInput as aD, ResolveKodaXManualOptions as aE, ResolveKodaXManualResult as aF, TodoItem as aG, TodoList as aH, TodoStatus as aI, WorkflowHostPolicy as aJ, WorkflowInvocationAction as aK, WorkflowInvocationPolicyDecision as aL, WorkflowInvocationPolicyInput as aM, WorkflowInvocationSource as aN, WorkflowInvocationTrigger as aO, WorkflowStartOutcome as aP, KodaXTaskEvidenceBundle as aa, KodaXTaskEvidenceEntry as ab, KodaXTaskRole as ac, KodaXTaskRoleAssignment as ad, KodaXTaskStatus as ae, KodaXTaskSurface as af, KodaXTaskToolPolicy as ag, KodaXTaskVerificationContract as ah, KodaXTaskVerificationCriterion as ai, KodaXTaskWorkItem as aj, KodaXToolEventMeta as ak, KodaXToolExecutionContext as al, KodaXVerificationScorecard as am, KodaXVerificationScorecardCriterion as an, KodaXWorkflowEventMeta as ao, LspServerInfo as aq, LspServiceConfig as as, ProviderExecutionState as at, ProviderRecoveryEvent as au, ProviderResilienceConfig as av, ProviderResiliencePolicy as aw, RecoveryAction as ax, RecoveryDecision as ay, RecoveryLadderStep as az, BashPrefixResult as b, CreateBashPrefixExtractorOptions as c, ExtractCommandPrefixOptions as d, GoalCompleteResult as e, GoalCreateInput as f, GoalLifecycleContext as g, GoalRuntimeBinding as h, GoalRuntimeBindingDeps as i, GoalToolsContext as j, KodaXAgentMode as k, KodaXBudgetDisclosureZone as l, KodaXBudgetExtensionRequest as m, KodaXChildAgentResult as n, KodaXChildContextBundle as o, KodaXChildExecutionResult as p, KodaXCompactionOverride as q, KodaXContextOptions as r, KodaXContextTokenSnapshot as s, KodaXEvents as t, KodaXFanoutBranchLifecycle as u, KodaXFanoutBranchRecord as v, KodaXFanoutBranchTransition as w, KodaXFanoutSchedulerInput as x, KodaXFanoutSchedulerPlan as y, KodaXInputArtifact as z };
+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 };

package/dist/types-chunks/{sdk-session-D4tqRl0_.d.ts → sdk-session-DrPxcDuO.d.ts}

@@ -1,6 +1,6 @@
-import { b as PermissionMode, S as SessionData, F as FileSessionStorage } from './storage.d-CabW10Nt.js';
+import { b as PermissionMode, S as SessionData, F as FileSessionStorage } from './storage.d-DoA3NvdD.js';
 import { G as KodaXReasoningMode, o as KodaXMessage, h as KodaXContentBlock } from './base.d-BBNUF9nz.js';
-import { k as KodaXAgentMode } from './bash-prefix-extractor.d-DBFZEwop.js';
+import { m as KodaXAgentMode } from './bash-prefix-extractor.d-CBLoD2Jk.js';
 import { ac as KodaXSessionUiHistoryItem, ag as KodaXSessionUiToolCall } from './process.d-Bj82oJhD.js';
 
 /**

package/dist/types-chunks/{storage.d-CabW10Nt.d.ts → storage.d-DoA3NvdD.d.ts}

@@ -1,4 +1,4 @@
-import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-DBFZEwop.js';
+import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-CBLoD2Jk.js';
 import { $ as KodaXSessionData, a4 as KodaXSessionLineage, a7 as KodaXSessionNavigationOptions, a8 as KodaXSessionRuntimeInfo, aa as KodaXSessionStorage } from './process.d-Bj82oJhD.js';
 
 /**

package/dist/types-chunks/{utils.d-23Gn14zP.d.ts → utils.d-DSqmMq7l.d.ts}

@@ -1,6 +1,6 @@
-import { P as KodaXOptions, s as KodaXContextTokenSnapshot, k as KodaXAgentMode, U as KodaXRepoIntelligenceMode, a4 as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-DBFZEwop.js';
-import { c as SessionStorage$1, b as PermissionMode } from './storage.d-CabW10Nt.js';
-import { aa as KodaXSessionStorage, $ as KodaXSessionData, ac as KodaXSessionUiHistoryItem, a4 as KodaXSessionLineage, Y as KodaXSessionArtifactLedgerEntry, a8 as KodaXSessionRuntimeInfo, bD as WorkflowProcessSource } from './process.d-Bj82oJhD.js';
+import { R as KodaXOptions, u as KodaXContextTokenSnapshot, m as KodaXAgentMode, W as KodaXRepoIntelligenceMode, a7 as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-CBLoD2Jk.js';
+import { c as SessionStorage$1, b as PermissionMode } from './storage.d-DoA3NvdD.js';
+import { ac as KodaXSessionUiHistoryItem, a4 as KodaXSessionLineage, Y as KodaXSessionArtifactLedgerEntry, Q as KodaXExtensionSessionState, P as KodaXExtensionSessionRecord, a8 as KodaXSessionRuntimeInfo, aa as KodaXSessionStorage, $ as KodaXSessionData, bD as WorkflowProcessSource } from './process.d-Bj82oJhD.js';
 import { o as KodaXMessage, G as KodaXReasoningMode, t as KodaXProviderCapabilityProfile, H as KodaXReasoningOverride, i as KodaXCustomProviderConfig } from './base.d-BBNUF9nz.js';
 import { A as AgentsFile, f as AutoModeStats, l as KodaXMcpServersConfig } from './guardrail.d-B18oO1gt.js';
 import * as readline from 'readline';
@@ -27,21 +27,6 @@ interface InkREPLOptions extends KodaXOptions {
  */
 declare function runInkInteractiveMode(options: InkREPLOptions): Promise<void>;
 
-interface SessionStorage extends KodaXSessionStorage {
-    list(gitRoot?: string): Promise<Array<{
-        id: string;
-        title: string;
-        msgCount: number;
-        tag?: string;
-        runtimeInfo?: KodaXSessionData['runtimeInfo'];
-    }>>;
-}
-interface RepLOptions extends KodaXOptions {
-    storage?: SessionStorage;
-}
-declare function runInteractiveMode(options: RepLOptions): Promise<void>;
-declare function processSpecialSyntax(input: string): Promise<string>;
-
 /**
  * KodaX Interactive Context Management - 交互式上下文管理
  */
@@ -53,6 +38,10 @@ interface InteractiveContext {
     contextTokenSnapshot?: KodaXContextTokenSnapshot;
     lineage?: KodaXSessionLineage;
     artifactLedger?: KodaXSessionArtifactLedgerEntry[];
+    extensionState?: KodaXExtensionSessionState;
+    extensionRecords?: KodaXExtensionSessionRecord[];
+    extensionStateDirty?: boolean;
+    extensionRecordsDirty?: boolean;
     sessionId: string;
     title: string;
     gitRoot?: string;
@@ -68,9 +57,26 @@ declare function createInteractiveContext(options: {
     existingUiHistory?: KodaXSessionUiHistoryItem[];
     existingLineage?: KodaXSessionLineage;
     existingArtifactLedger?: KodaXSessionArtifactLedgerEntry[];
+    existingExtensionState?: KodaXExtensionSessionState;
+    existingExtensionRecords?: KodaXExtensionSessionRecord[];
 }): Promise<InteractiveContext>;
 declare function touchContext(context: InteractiveContext): void;
 
+interface SessionStorage extends KodaXSessionStorage {
+    list(gitRoot?: string): Promise<Array<{
+        id: string;
+        title: string;
+        msgCount: number;
+        tag?: string;
+        runtimeInfo?: KodaXSessionData['runtimeInfo'];
+    }>>;
+}
+interface RepLOptions extends KodaXOptions {
+    storage?: SessionStorage;
+}
+declare function runInteractiveMode(options: RepLOptions): Promise<void>;
+declare function processSpecialSyntax(input: string): Promise<string>;
+
 /**
  * UI Context Interface - UI 交互上下文接口
  *
@@ -164,6 +170,7 @@ type SessionLoadStatus = 'loaded' | 'missing' | 'blocked';
 type SessionBranchSwitchStatus = 'switched' | 'missing' | 'blocked';
 type SessionForkStatus = 'forked' | 'failed' | 'blocked';
 type SessionRewindStatus = 'rewound' | 'failed' | 'blocked';
+type SessionRecoverStatus = 'recovered' | 'empty' | 'failed' | 'blocked';
 interface CommandCallbacks {
     exit: () => void | Promise<void>;
     saveSession: () => Promise<void>;
@@ -236,6 +243,7 @@ interface CommandCallbacks {
     switchSessionBranch?: (selector: string) => Promise<SessionBranchSwitchStatus>;
     labelSessionBranch?: (selector: string, label?: string) => Promise<boolean>;
     forkSession?: (selector?: string) => Promise<SessionForkStatus>;
+    recoverSession?: (prompt?: string) => Promise<SessionRecoverStatus>;
     rewindSession?: (selector?: string) => Promise<SessionRewindStatus>;
     getCostReport?: () => string | null;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodax-ai/kodax",
-  "version": "0.7.52",
+  "version": "0.7.54",
   "description": "极致轻量化 Coding Agent - TypeScript 实现，支持 12 个 LLM 提供商，可发布为免 Node 单文件二进制",
   "type": "module",
   "private": false,

package/dist/chunks/argument-completer-VMH6VZ4X.js

@@ -1,2 +0,0 @@
-// @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{sa as a,ta as b}from"./chunk-7X7SOVER.js";import"./chunk-BFXFSEHK.js";import"./chunk-JJTUBNQX.js";import"./chunk-4RVSFOUT.js";import"./chunk-5USNUSTL.js";import"./chunk-LE6STNVN.js";import"./chunk-HMATTIU6.js";import"./chunk-V4WSBIXB.js";export{a as ArgumentCompleter,b as createArgumentCompleter};