@kodax-ai/kodax 0.7.63 → 0.7.67

package/dist/types-chunks/{bash-prefix-extractor.d-CZW9fRoa.d.ts → bash-prefix-extractor.d-D57Gt6n8.d.ts}

@@ -1,5 +1,5 @@
-import { _ as KodaXGoalState, h as AgentMessage, bM as StopHookFn, af as KodaXSessionLineage, a4 as KodaXJsonValue, U as KodaXExtensionSessionRecord, f as Agent, c8 as WorkflowIsolation, V as KodaXExtensionSessionState, a6 as KodaXSessionArtifactLedgerEntry, bx as SessionErrorMetadata, al as KodaXSessionScope, am as KodaXSessionStorage, a2 as KodaXInputArtifact, C as ChildTaskRegistry, c5 as WorkflowEventCorrelation, x as CompactionUpdate, ch as WorkflowProcessEvent, c4 as WorkflowEvent, q as AskUserQuestionOptions, m as AskUserAnswer, o as AskUserMultiOptions, b0 as MemoryReviewPlan, b1 as MemoryReviewRunner, J as Guardrail, B as DiscoveredInstance, bQ as TaskAbortRegistry } from './process.d-CY2g03Mb.js';
-import { $ as KodaXTokenUsage, j as KodaXMessage, a8 as KodaXWireReasoningEffort, T as KodaXTaskRoutingDecision, U as KodaXTaskType, V as KodaXTaskWorkIntent, P as KodaXTaskComplexity, J as KodaXRiskLevel, g as KodaXHarnessProfile, e as KodaXExecutionMode, b as KodaXChildFanoutClass, E as KodaXReasoningMode, I as KodaXReviewScale } from './types.d-Bp4Lm1jv.js';
+import { aN as KodaXGoalState, I as AgentMessage, cB as StopHookFn, b2 as KodaXSessionLineage, aT as KodaXJsonValue, aH as KodaXExtensionSessionRecord, f as Agent, cZ as WorkflowIsolation, aI as KodaXExtensionSessionState, aV as KodaXSessionArtifactLedgerEntry, cm as SessionErrorMetadata, b8 as KodaXSessionScope, b9 as KodaXSessionStorage, aR as KodaXInputArtifact, B as AgentExecutorPlaneBinding, a6 as ChildTaskRegistry, cW as WorkflowEventCorrelation, ac as CompactionUpdate, d6 as WorkflowProcessEvent, cV as WorkflowEvent, a3 as AskUserQuestionOptions, $ as AskUserAnswer, a1 as AskUserMultiOptions, bR as MemoryReviewPlan, bS as MemoryReviewRunner, aw as Guardrail, ah as DiscoveredInstance, cF as TaskAbortRegistry } from './types.d-DG9B4SMm.js';
+import { $ as KodaXTokenUsage, j as KodaXMessage, a0 as KodaXToolDefinition, a8 as KodaXWireReasoningEffort, T as KodaXTaskRoutingDecision, U as KodaXTaskType, V as KodaXTaskWorkIntent, P as KodaXTaskComplexity, J as KodaXRiskLevel, g as KodaXHarnessProfile, e as KodaXExecutionMode, b as KodaXChildFanoutClass, E as KodaXReasoningMode, I as KodaXReviewScale } from './types.d-Bp4Lm1jv.js';
 import { d as SkillDynamicContextExecutor } from './types.d-vJExiRje.js';
 import { Diagnostic, Position, Location, Hover, DocumentSymbol, SymbolInformation, WorkspaceSymbol, CallHierarchyItem, CallHierarchyIncomingCall, CallHierarchyOutgoingCall } from 'vscode-languageserver-protocol';
 import { K as KodaXLlmTimeoutConfig, a as CostTracker } from './cost-tracker.d-CBLk1fiD.js';
@@ -1130,6 +1130,134 @@ interface KodaXTimeoutConfig {
 }
 declare function providerResilienceConfigFromTimeouts(timeouts: KodaXTimeoutConfig | undefined): ProviderResilienceConfig | undefined;
 
+type RuntimeContextOptimizationProfile = 'off' | 'report_only' | 'balanced' | 'small_window' | 'aggressive';
+type RuntimeContextPressure = 'low' | 'medium' | 'high' | 'critical';
+interface RuntimeContextBudgetBreakdown {
+    readonly systemPrompt: number;
+    readonly toolSchemas: number;
+    readonly skillCatalog: number;
+    readonly mcpCatalog: number;
+    readonly transcript: number;
+    readonly pendingInput: number;
+    readonly recentToolResults: number;
+    readonly reservedResponse: number;
+    readonly total: number;
+}
+interface RuntimeContextBudgetSnapshot {
+    readonly sessionId?: string;
+    readonly runId?: string;
+    readonly turnId?: string;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly profile: RuntimeContextOptimizationProfile;
+    readonly contextWindow: number;
+    readonly smallWindow: boolean;
+    readonly pressure: RuntimeContextPressure;
+    readonly tokenBreakdown: RuntimeContextBudgetBreakdown;
+    readonly usedTokens: number;
+    readonly availableTokens: number;
+    readonly usedRatio: number;
+    readonly toolSchemaRatio: number;
+    readonly recommendations: readonly RuntimeContextBudgetRecommendation[];
+    readonly createdAt: string;
+}
+type RuntimeContextBudgetRecommendation = 'prefer_progressive_tool_exposure' | 'compact_or_summarize_history' | 'trim_recent_tool_results' | 'reserve_response_budget';
+interface RuntimeContextBudgetSnapshotInput {
+    readonly sessionId?: string;
+    readonly runId?: string;
+    readonly turnId?: string;
+    readonly provider?: string;
+    readonly model?: string;
+    readonly profile?: RuntimeContextOptimizationProfile;
+    readonly contextWindow: number;
+    readonly systemPrompt?: string;
+    readonly toolDefinitions?: readonly KodaXToolDefinition[];
+    readonly skillCatalogText?: string;
+    readonly mcpCatalogText?: string;
+    readonly messages?: readonly KodaXMessage[];
+    readonly pendingInput?: string;
+    readonly recentToolResults?: readonly string[];
+    readonly reservedResponseTokens?: number;
+    readonly now?: () => Date;
+}
+declare function estimateToolSchemaTokens(definition: KodaXToolDefinition, descriptionOverride?: string): number;
+declare function createRuntimeContextBudgetSnapshot(input: RuntimeContextBudgetSnapshotInput): RuntimeContextBudgetSnapshot;
+
+type RuntimeToolExposureMode = 'resident' | 'hint' | 'bridge' | 'native_deferred' | 'hidden';
+type RuntimeToolExposureReason = 'profile_off' | 'protected_core' | 'already_unlocked' | 'low_pressure' | 'deferred_hint' | 'portable_bridge' | 'native_deferred' | 'bridge_unavailable';
+interface RuntimeToolExposureDecision {
+    readonly toolName: string;
+    readonly mode: RuntimeToolExposureMode;
+    readonly recommendedMode: RuntimeToolExposureMode;
+    readonly reason: RuntimeToolExposureReason;
+    readonly estimatedTokensBefore: number;
+    readonly estimatedTokensAfter: number;
+    readonly estimatedTokensIfApplied: number;
+    readonly modelVisible: boolean;
+}
+interface RuntimeToolExposurePlan {
+    readonly profile: RuntimeContextOptimizationProfile;
+    readonly reportOnly: boolean;
+    readonly pressure: RuntimeContextPressure;
+    readonly bridgeAvailable: boolean;
+    readonly nativeDeferredAvailable: boolean;
+    readonly decisions: readonly RuntimeToolExposureDecision[];
+    readonly modelVisibleToolNames: readonly string[];
+    readonly estimatedToolSchemaTokensBefore: number;
+    readonly estimatedToolSchemaTokensAfter: number;
+    readonly estimatedToolSchemaTokensIfApplied: number;
+    readonly estimatedTokensSaved: number;
+    readonly estimatedTokensSavedIfApplied: number;
+    readonly residentToolCount: number;
+    readonly hintedToolCount: number;
+    readonly bridgeToolCount: number;
+    readonly nativeDeferredToolCount: number;
+    readonly hiddenToolCount: number;
+}
+interface RuntimeToolExposurePlanInput {
+    readonly tools: readonly KodaXToolDefinition[];
+    readonly budget: RuntimeContextBudgetSnapshot;
+    readonly profile?: RuntimeContextOptimizationProfile;
+    readonly bridgeAvailable?: boolean;
+    readonly nativeDeferredAvailable?: boolean;
+    readonly unlockedDeferredTools?: ReadonlySet<string>;
+}
+declare const ALWAYS_RESIDENT_TOOL_NAMES: ReadonlySet<string>;
+declare function planToolExposure(input: RuntimeToolExposurePlanInput): RuntimeToolExposurePlan;
+
+interface CompactionAntiThrashState {
+    readonly lowSavingsStreak: number;
+    readonly cooldownTurnsRemaining: number;
+}
+interface CompactionSavingsSample {
+    readonly tokensBefore: number;
+    readonly tokensAfter: number;
+}
+interface CompactionAntiThrashConfig {
+    readonly lowSavingsRatio?: number;
+    readonly lowSavingsStreakLimit?: number;
+    readonly cooldownTurns?: number;
+}
+interface CompactionSavingsDecision {
+    readonly state: CompactionAntiThrashState;
+    readonly savingsRatio: number;
+    readonly lowSavings: boolean;
+    readonly enteredCooldown: boolean;
+}
+type CompactionSkipReason = 'low_savings_cooldown';
+interface RuntimeCompactionSkippedEvent {
+    readonly reason: CompactionSkipReason;
+    readonly currentTokens: number;
+    readonly contextWindow: number;
+    readonly triggerPercent: number;
+    readonly cooldownTurnsRemaining: number;
+    readonly lowSavingsStreak: number;
+}
+declare function createCompactionAntiThrashState(): CompactionAntiThrashState;
+declare function shouldSkipLlmCompaction(state: CompactionAntiThrashState | undefined): boolean;
+declare function consumeCompactionCooldown(state: CompactionAntiThrashState | undefined): CompactionAntiThrashState;
+declare function recordCompactionSavings(state: CompactionAntiThrashState | undefined, sample: CompactionSavingsSample, config?: CompactionAntiThrashConfig): CompactionSavingsDecision;
+
 /**
  * FEATURE_093 (v0.7.24): minimal contract interfaces for the coding extension
  * runtime. Extracted so `@kodax-ai/coding/src/types.ts` can reference the
@@ -1709,6 +1837,12 @@ interface KodaXEvents {
         effort: string;
     } & Partial<KodaXLiveEventMeta>) => void;
     onRepoIntelligenceTrace?: (event: KodaXRepoIntelligenceTraceEvent & Partial<KodaXLiveEventMeta>) => void;
+    /** Optional bounded context diagnostics. Emitted only when context.contextDiagnostics is true. */
+    onContextBudgetSnapshot?: (event: RuntimeContextBudgetSnapshot & Partial<KodaXLiveEventMeta>) => void;
+    /** Optional bounded tool-exposure diagnostics. Emitted only when context.contextDiagnostics is true. */
+    onToolExposurePlanned?: (event: RuntimeToolExposurePlan & Partial<KodaXLiveEventMeta>) => void;
+    /** Optional bounded compaction-pressure diagnostics. Emitted only when context.contextDiagnostics is true. */
+    onContextCompactionSkipped?: (event: RuntimeCompactionSkippedEvent & Partial<KodaXLiveEventMeta>) => void;
     /**
      * Fired when the Sidecar Verifier produces an actionable message.
      *
@@ -2039,14 +2173,9 @@ interface KodaXChildContextBundle {
     constraints: string[];
     readOnly: boolean;
     /**
-     * FEATURE_120 v0.7.39 Phase 4 — optional model tier hint that the
-     * dispatching agent provides as a UX signal. Routing is a **no-op**
-     * for now: every child runs on the parent's model regardless of
-     * hint. FEATURE_102 (v0.7.45 capability profile) is the planned
-     * consumer that will translate `'fast' | 'balanced' | 'deep'` to a
-     * concrete provider/model selection. The field is surfaced + parsed
-     * now so prompt-eval data starts accumulating; the routing wire-up
-     * lands separately.
+     * FEATURE_102 / FEATURE_259 — semantic model tier intent. The runtime maps
+     * configured `fast`/`deep` tiers to concrete routes and safely inherits the
+     * parent when a tier is unavailable or ineligible.
      */
     modelHint?: KodaXChildModelHint;
     /**
@@ -2082,6 +2211,11 @@ interface KodaXChildContextBundle {
      * one bounded repair turn) and surfaces it on `KodaXChildAgentResult.structured`.
      */
     outputSchema?: unknown;
+    /** Trusted host provenance plus the generated script's terse-result declaration. */
+    workflowOutputContract?: {
+        readonly kodaxAuthored: boolean;
+        readonly terseResult: boolean;
+    };
 }
 /**
  * FEATURE_120 v0.7.39 Phase 4 — model tier hint. Tier semantics:
@@ -2094,6 +2228,26 @@ interface KodaXChildContextBundle {
  * unknown values silently with a tolerant fallback to `undefined`).
  */
 type KodaXChildModelHint = 'fast' | 'balanced' | 'deep';
+type KodaXChildTierOutcome = 'applied' | 'balanced-parent' | 'fast-write-ineligible' | 'unconfigured' | 'shadowed-by-selector' | 'inherited';
+type KodaXChildRouteSource = 'explicit' | 'specialist' | 'tier' | 'parent' | 'default';
+interface KodaXChildRouteFacts {
+    readonly requestedTier: KodaXChildModelHint | 'inherited';
+    readonly tierOutcome: KodaXChildTierOutcome;
+    readonly providerSource: KodaXChildRouteSource;
+    readonly modelSource?: Exclude<KodaXChildRouteSource, 'default'>;
+    readonly initialProvider?: string;
+    readonly initialModel?: string;
+    readonly finalProvider?: string;
+    readonly finalModel?: string;
+    readonly resolvedEffort?: string;
+    readonly fallbackReason?: string;
+    readonly iterations?: number;
+    readonly inputTokens?: number;
+    readonly cacheReadTokens?: number;
+    readonly outputTokens?: number;
+    readonly digestTokens?: number;
+    readonly durationMs?: number;
+}
 interface KodaXChildAgentResult {
     childId: string;
     fanoutClass: KodaXChildFanoutClass;
@@ -2117,6 +2271,17 @@ interface KodaXChildAgentResult {
     actualIterations?: number;
     /** Best-known token usage for this child run. Used by workflow budget accounting. */
     totalTokensUsed?: number;
+    /** Token usage attributable only to the optional presentation digest call. */
+    digestTokensUsed?: number;
+    /** Provider-reported usage for the optional digest call (diagnostic subset of totalTokensUsed). */
+    digestUsage?: {
+        readonly inputTokens?: number;
+        readonly outputTokens?: number;
+        readonly totalTokens?: number;
+        readonly cacheReadTokens?: number;
+    };
+    /** Correlated model-tier and fallback facts for cost/quality reporting. */
+    routeFacts?: KodaXChildRouteFacts;
     /** True when the child exhausted its iteration budget before completing. */
     limitReached?: boolean;
     /**
@@ -2397,6 +2562,11 @@ interface KodaXContextOptions {
     repoIntelligenceMode?: KodaXRepoIntelligenceMode;
     /** Optional repo-intelligence trace toggle for this run. */
     repoIntelligenceTrace?: boolean;
+    /**
+     * Optional runtime-context diagnostics for SDK/daemon hosts. When false or
+     * omitted, no extra budget/exposure calculation is performed.
+     */
+    contextDiagnostics?: boolean;
     disableAutoTaskReroute?: boolean;
     /**
      * FEATURE_087/088 (v0.7.28): when true, the prompt builder injects a
@@ -2423,6 +2593,8 @@ interface KodaXContextOptions {
      * lookups use the legacy process-global registry.
      */
     agentScope?: KodaXAgentScope;
+    /** FEATURE_258: host-bound external-agent plane and non-model dispatch context. */
+    agentExecutorPlane?: AgentExecutorPlaneBinding;
     /** Optional task-engine surface label used to track managed tasks across UX entry points. */
     taskSurface?: KodaXTaskSurface;
     /**
@@ -2974,6 +3146,8 @@ interface KodaXToolExecutionContext {
     agentProfile?: KodaXAgentProfile;
     /** Scoped specialist-agent resolver inherited from KodaXOptions.context. */
     agentScope?: KodaXAgentScope;
+    /** FEATURE_258: external dispatch capability; absent keeps the tool surface unchanged. */
+    agentExecutorPlane?: AgentExecutorPlaneBinding;
     /** FEATURE_221: SDK-consumer self-manual injection, forwarded from KodaXOptions. */
     selfManual?: KodaXSelfManualConfig;
     /** FEATURE_222 skill security — host policy for skill `!`cmd`` dynamic-context,
@@ -3539,5 +3713,5 @@ interface CreateBashPrefixExtractorOptions {
  */
 declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
 
-export { BASH_POLICY_SPEC as B, LSP_SERVERS as aC, LspService as aE, buildGoalRuntimeBinding as b7, createBashPrefixExtractor as b8, decideWorkflowInvocation as b9, drainPendingSwaps as ba, extractCommandPrefix as bb, getDefaultLspService as bc, hasPendingSwap as bd, makeDisabledGoalToolsContext as be, providerResilienceConfigFromTimeouts as bf, resolveConstructedAgent as bg, shutdownDefaultLspService as bh, withGoalBeforeNextTurn as bi, withGoalStopHook as bj, workflowStartOutcomeConsumesTurn as bk };
-export type { KodaXResult as $, KodaXManagedBudgetSnapshot as A, CapabilityRuntimeContract 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, KodaXManualSource as M, KodaXManualTopic 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, WorkflowInvocationPolicyInput as a$, KodaXRoleRoundSummary as a0, KodaXRuntimeVerificationContract as a1, KodaXSelfManualConfig as a2, KodaXSessionControl as a3, KodaXSessionMutators as a4, KodaXSessionOptions as a5, KodaXSidecarMessageEvent as a6, KodaXSkillDynamicContextPolicy as a7, KodaXSkillInvocationContext as a8, KodaXSkillMap as a9, KodaXWorkflowEventMeta as aA, KodaXWorkflowTimeoutConfig as aB, LspServerInfo as aD, LspServiceConfig as aF, ProviderExecutionState as aG, ProviderRecoveryEvent as aH, ProviderResilienceConfig as aI, ProviderResiliencePolicy as aJ, RecoveryAction as aK, RecoveryDecision as aL, RecoveryLadderStep as aM, RecoveryResult as aN, ResilienceClassification as aO, ResilienceErrorClass as aP, ResolveKodaXManualInput as aQ, ResolveKodaXManualOptions as aR, ResolveKodaXManualResult as aS, RuntimeDefaultsSnapshot as aT, TodoItem as aU, TodoList as aV, TodoStatus as aW, ToolSideEffect as aX, WorkflowHostPolicy as aY, WorkflowInvocationAction as aZ, WorkflowInvocationPolicyDecision as a_, KodaXSkillProjectionConfidence as aa, KodaXTaskCapabilityHint as ab, KodaXTaskContract as ac, KodaXTaskEvidenceArtifact as ad, KodaXTaskEvidenceBundle as ae, KodaXTaskEvidenceEntry as af, KodaXTaskRole as ag, KodaXTaskRoleAssignment as ah, KodaXTaskStatus as ai, KodaXTaskSurface as aj, KodaXTaskToolPolicy as ak, KodaXTaskVerificationContract as al, KodaXTaskVerificationCriterion as am, KodaXTaskWorkItem as an, KodaXTimeoutConfig as ao, KodaXToolEventMeta as ap, KodaXToolExecutionContext as aq, KodaXToolVisibilityMeta as ar, KodaXToolVisibilityPolicy as as, KodaXTurnCompletedEvent as at, KodaXTurnDeliveryKind as au, KodaXTurnFailedEvent as av, KodaXTurnStartedEvent as aw, KodaXVerificationScorecard as ax, KodaXVerificationScorecardCriterion as ay, KodaXWorkflowAgentDigestEvent as az, BashPrefixResult as b, WorkflowInvocationSource as b0, WorkflowRunProgressView as b1, WorkflowStartOutcome as b2, WorkflowToolHost as b3, WorkflowToolHostInlineInput as b4, WorkflowToolHostResult as b5, WorkflowToolHostStartResult as b6, 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, KodaXAgentProfile as n, KodaXAgentScope as o, KodaXBudgetDisclosureZone as p, KodaXBudgetExtensionRequest as q, KodaXChildAgentResult as r, KodaXChildContextBundle as s, KodaXChildExecutionResult as t, KodaXCompactionOverride as u, KodaXContextOptions as v, KodaXContextTokenSnapshot as w, KodaXEffectiveTaskConfig as x, KodaXEvents as y, KodaXLiveEventMeta as z };
+export { ALWAYS_RESIDENT_TOOL_NAMES as A, BASH_POLICY_SPEC as B, LSP_SERVERS as aI, LspService as aK, makeDisabledGoalToolsContext as bA, planToolExposure as bB, providerResilienceConfigFromTimeouts as bC, recordCompactionSavings as bD, resolveConstructedAgent as bE, shouldSkipLlmCompaction as bF, shutdownDefaultLspService as bG, withGoalBeforeNextTurn as bH, withGoalStopHook as bI, workflowStartOutcomeConsumesTurn as bJ, buildGoalRuntimeBinding as bp, consumeCompactionCooldown as bq, createBashPrefixExtractor as br, createCompactionAntiThrashState as bs, createRuntimeContextBudgetSnapshot as bt, decideWorkflowInvocation as bu, drainPendingSwaps as bv, estimateToolSchemaTokens as bw, extractCommandPrefix as bx, getDefaultLspService as by, hasPendingSwap as bz };
+export type { KodaXRepoIntelligenceCapability as $, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXContextOptions as H, KodaXContextTokenSnapshot as I, KodaXEffectiveTaskConfig as J, KodaXActivityEventMeta as K, KodaXEvents as L, KodaXLiveEventMeta as M, KodaXManagedBudgetSnapshot as N, KodaXManagedProtocolPayload as O, KodaXManagedTask as P, KodaXManagedTaskRuntimeState as Q, KodaXManagedTaskStatusEvent as R, KodaXManualSource as S, KodaXManualTopic as T, KodaXManualTopicId as U, KodaXManualTopicInput as V, KodaXMemoryStrategy as W, KodaXOptions as X, KodaXOrchestrationVerdict as Y, KodaXParentReductionContract as Z, KodaXProviderPolicyHints as _, BashPrefixExtractor as a, RuntimeContextBudgetRecommendation as a$, KodaXRepoIntelligenceMode as a0, KodaXRepoIntelligenceResolvedMode as a1, KodaXRepoIntelligenceTrace as a2, KodaXRepoIntelligenceTraceEvent as a3, KodaXRepoRoutingSignals as a4, KodaXResult as a5, KodaXRoleRoundSummary as a6, KodaXRuntimeVerificationContract as a7, KodaXSelfManualConfig as a8, KodaXSessionControl as a9, KodaXTurnDeliveryKind as aA, KodaXTurnFailedEvent as aB, KodaXTurnStartedEvent as aC, KodaXVerificationScorecard as aD, KodaXVerificationScorecardCriterion as aE, KodaXWorkflowAgentDigestEvent as aF, KodaXWorkflowEventMeta as aG, KodaXWorkflowTimeoutConfig as aH, LspServerInfo as aJ, LspServiceConfig as aL, ProviderExecutionState as aM, ProviderRecoveryEvent as aN, ProviderResilienceConfig as aO, ProviderResiliencePolicy as aP, RecoveryAction as aQ, RecoveryDecision as aR, RecoveryLadderStep as aS, RecoveryResult as aT, ResilienceClassification as aU, ResilienceErrorClass as aV, ResolveKodaXManualInput as aW, ResolveKodaXManualOptions as aX, ResolveKodaXManualResult as aY, RuntimeCompactionSkippedEvent as aZ, RuntimeContextBudgetBreakdown as a_, KodaXSessionMutators as aa, KodaXSessionOptions as ab, KodaXSidecarMessageEvent as ac, KodaXSkillDynamicContextPolicy as ad, KodaXSkillInvocationContext as ae, KodaXSkillMap as af, KodaXSkillProjectionConfidence as ag, KodaXTaskCapabilityHint as ah, KodaXTaskContract as ai, KodaXTaskEvidenceArtifact as aj, KodaXTaskEvidenceBundle as ak, KodaXTaskEvidenceEntry as al, KodaXTaskRole as am, KodaXTaskRoleAssignment as an, KodaXTaskStatus as ao, KodaXTaskSurface as ap, KodaXTaskToolPolicy as aq, KodaXTaskVerificationContract as ar, KodaXTaskVerificationCriterion as as, KodaXTaskWorkItem as at, KodaXTimeoutConfig as au, KodaXToolEventMeta as av, KodaXToolExecutionContext as aw, KodaXToolVisibilityMeta as ax, KodaXToolVisibilityPolicy as ay, KodaXTurnCompletedEvent as az, BashPrefixResult as b, RuntimeContextBudgetSnapshot as b0, RuntimeContextBudgetSnapshotInput as b1, RuntimeContextOptimizationProfile as b2, RuntimeContextPressure as b3, RuntimeDefaultsSnapshot as b4, RuntimeToolExposureDecision as b5, RuntimeToolExposureMode as b6, RuntimeToolExposurePlan as b7, RuntimeToolExposurePlanInput as b8, RuntimeToolExposureReason as b9, TodoItem as ba, TodoList as bb, TodoStatus as bc, ToolSideEffect as bd, WorkflowHostPolicy as be, WorkflowInvocationAction as bf, WorkflowInvocationPolicyDecision as bg, WorkflowInvocationPolicyInput as bh, WorkflowInvocationSource as bi, WorkflowRunProgressView as bj, WorkflowStartOutcome as bk, WorkflowToolHost as bl, WorkflowToolHostInlineInput as bm, WorkflowToolHostResult as bn, WorkflowToolHostStartResult as bo, BoundExtensionRuntimeController as c, ChildSnapshotEvent as d, CompactionAntiThrashConfig as e, CompactionAntiThrashState as f, CompactionSavingsDecision as g, CompactionSavingsSample as h, CompactionSkipReason as i, CreateBashPrefixExtractorOptions as j, ExtractCommandPrefixOptions as k, GoalCompleteResult as l, GoalCreateInput as m, GoalLifecycleContext as n, GoalRuntimeBinding as o, GoalRuntimeBindingDeps as p, GoalToolsContext as q, KodaXAgentMode as r, KodaXAgentProfile as s, KodaXAgentScope as t, KodaXBudgetDisclosureZone as u, KodaXBudgetExtensionRequest as v, KodaXChildAgentResult as w, KodaXChildContextBundle as x, KodaXChildExecutionResult as y, KodaXCompactionOverride as z };

package/dist/types-chunks/{run-manager.d-CYTnWhZY.d.ts → capsule.d-BZmqu_HL.d.ts}

@@ -1,6 +1,6 @@
 import { j as KodaXMessage } from './types.d-Bp4Lm1jv.js';
-import { Q as QueueEventListener, f as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-1CnTg7Sd.js';
-import { h as AgentMessage, bw as SessionEntry, bu as Session, by as SessionExtension, af as KodaXSessionLineage, a4 as KodaXJsonValue, u as CompactionDetails, T as KodaXCompactMemorySeed, ab as KodaXSessionEntry, an as KodaXSessionTreeNode, ae as KodaXSessionLabelEntry, ad as KodaXSessionGoalEntry, a8 as KodaXSessionClientNoticeEntry, aj as KodaXSessionRewindMarkerEntry, ai as KodaXSessionNavigationOptions, a6 as KodaXSessionArtifactLedgerEntry, H as FileOperations, cb as WorkflowMeta, cc as WorkflowModelHint, cd as WorkflowModule, ct as WorkflowProcessTrackerOptions, c4 as WorkflowEvent, cn as WorkflowProcessSnapshot, ch as WorkflowProcessEvent } from './process.d-CY2g03Mb.js';
+import { Q as QueueEventListener, c as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-DU9lLkmE.js';
+import { I as AgentMessage, cl as SessionEntry, cj as Session, cn as SessionExtension, b2 as KodaXSessionLineage, aT as KodaXJsonValue, a9 as CompactionDetails, aG as KodaXCompactMemorySeed, a_ as KodaXSessionEntry, ba as KodaXSessionTreeNode, b1 as KodaXSessionLabelEntry, b0 as KodaXSessionGoalEntry, aX as KodaXSessionClientNoticeEntry, b6 as KodaXSessionRewindMarkerEntry, b5 as KodaXSessionNavigationOptions, aV as KodaXSessionArtifactLedgerEntry, au as FileOperations, d0 as WorkflowMeta, d1 as WorkflowModelHint, d2 as WorkflowModule } from './types.d-DG9B4SMm.js';
 
 /**
  * @kodax-ai/agent Constants
@@ -33,7 +33,7 @@ declare const PROMISE_PATTERN: RegExp;
  * - 内容文本
  * - 工具调用和结果
  */
-declare function estimateTokens(messages: KodaXMessage[]): number;
+declare function estimateTokens(messages: readonly KodaXMessage[]): number;
 /**
  * 计算单个文本的 token 数量（便捷函数）
  */
@@ -831,92 +831,5 @@ declare function buildWorkflowCapsuleIntent(manifest: {
     readonly originalRequest?: string;
 }): WorkflowCapsuleIntent;
 
-/**
- * FEATURE_246 Part A0 (ADR-046) — neutral workflow run lifecycle manager.
- *
- * Domain-neutral run registry + lifecycle (pause / resume / stop), process-event
- * tracking, and terminal settle — lifted out of `@kodax-ai/coding` so any agent
- * (including non-coding SDK hosts) can host and manage workflow runs.
- *
- * It never knows HOW a run executes: the caller injects a `runFn` thunk that
- * receives lifecycle hooks (`onEvent` / `signal` / `beforeSpawn`) and returns a
- * caller-shaped outcome, plus a `classify` mapping that outcome to a neutral
- * terminal status and an `onError` that synthesizes a failure outcome. The
- * coding layer wires `runFn` to its `runWorkflowModule` / `runWorkflowFromOptions`
- * (backend + run-graph + worktrees); SDK hosts wire their own. Dependency arrows
- * therefore point only coding → agent — no cycle.
- */
-
-type ManagedWorkflowStatus = 'running' | 'paused' | 'completed' | 'failed' | 'denied' | 'stopped';
-/** Provenance/display metadata for a run's process tracker. */
-type WorkflowProcessMetadata = Pick<WorkflowProcessTrackerOptions, 'displayName' | 'goal' | 'source' | 'savedWorkflowName' | 'sourceRunId' | 'sourceWorkflowName' | 'revisionOf' | 'resumedFromRunId' | 'hostMetadata'>;
-interface ManagedWorkflowSnapshot {
-    readonly runId: string;
-    readonly workflow: string;
-    readonly status: ManagedWorkflowStatus;
-    readonly totalSpawned: number;
-    readonly eventCount: number;
-    readonly startedAt: number;
-    readonly endedAt?: number;
-    readonly error?: string;
-    readonly resultText?: string;
-}
-interface ManagedWorkflowRun<TOutcome = unknown> {
-    readonly runId: string;
-    readonly done: Promise<TOutcome>;
-    getSnapshot(): ManagedWorkflowSnapshot | undefined;
-    getProcessSnapshot(): WorkflowProcessSnapshot | undefined;
-}
-/** Lifecycle hooks the manager injects into the caller's `runFn`. */
-interface ManagedRunHooks {
-    /** Forward every workflow event so the manager can track spawn/progress. */
-    readonly onEvent: (event: WorkflowEvent) => void;
-    /** Abort signal owned by the manager (fires on stop()). */
-    readonly signal: AbortSignal;
-    /** Await before launching each agent so pause() can gate new spawns. */
-    readonly beforeSpawn: () => Promise<void>;
-}
-/** Neutral terminal classification of a caller-shaped outcome. */
-interface ManagedRunClassification {
-    readonly status: 'completed' | 'failed' | 'denied';
-    readonly error?: Error;
-    readonly resultText?: string;
-}
-interface StartManagedRunInput<TOutcome> {
-    readonly runId: string;
-    /** Display name (usually the workflow's `meta.name`). */
-    readonly workflow: string;
-    readonly phases?: readonly string[];
-    readonly maxAgents?: number;
-    readonly plannedAgents?: number;
-    readonly tokenBudget?: number;
-    readonly processMetadata?: WorkflowProcessMetadata;
-    readonly signal?: AbortSignal;
-    /** Executes the run with the manager's lifecycle hooks injected. */
-    readonly runFn: (hooks: ManagedRunHooks) => Promise<TOutcome>;
-    /** Map the caller's terminal outcome to a neutral status for the snapshot. */
-    readonly classify: (outcome: TOutcome) => ManagedRunClassification;
-    /** Synthesize a caller-shaped outcome when `runFn` throws. */
-    readonly onError: (error: unknown) => TOutcome;
-}
-interface WorkflowRunManager {
-    start<TOutcome>(input: StartManagedRunInput<TOutcome>): ManagedWorkflowRun<TOutcome>;
-    list(): readonly ManagedWorkflowSnapshot[];
-    get(runId: string): ManagedWorkflowSnapshot | undefined;
-    subscribeWorkflowProcess(listener: (event: WorkflowProcessEvent) => void): () => void;
-    getWorkflowProcessSnapshot(runId: string): WorkflowProcessSnapshot | undefined;
-    listWorkflowProcessSnapshots(options?: {
-        readonly activeOnly?: boolean;
-        readonly limit?: number;
-    }): readonly WorkflowProcessSnapshot[];
-    pause(runId: string): boolean;
-    resume(runId: string): boolean;
-    stop(runId: string, reason?: string): boolean;
-}
-declare function createWorkflowRunManager(deps?: {
-    readonly now?: () => number;
-}): WorkflowRunManager;
-declare function getDefaultWorkflowRunManager(): WorkflowRunManager;
-
-export { applySessionCompaction as $, WORKFLOW_CAPSULE_FORMAT as A, WORKFLOW_CAPSULE_VERSION as B, DefaultSummaryCompaction as D, WORKFLOW_PATTERN_IDS as E, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, PROMISE_PATTERN as P, WORKFLOW_CAPSULE_API_VERSION as W, appendSessionLineageLabel as Y, applyLineageTruncation as Z, _resetMessageQueueForTests as _, archiveOldIslands as a0, assertRestrictedWorkflowQuality as a1, buildSessionTree as a2, buildWorkflowCapsuleIntent as a3, cleanupIncompleteToolCalls as a4, countActiveLineageMessages as a5, countTokens as a6, createSessionLineage as a7, createWorkflowCapsule as a8, createWorkflowModuleFromCapsule as a9, createWorkflowRunManager as aa, estimateTokens as ab, extractArtifactLedger as ac, extractFileOps as ad, extractTitleFromMessages as ae, findPreviousUserEntryId as af, forkSessionLineage as ag, generateSessionId as ah, getAgentConfigHome as ai, getAgentConfigPath as aj, getAppDataDir as ak, getDefaultWorkflowRunManager as al, getMessageQueue as am, getSessionLineagePath as an, getSessionMessagesFromLineage as ao, lintRestrictedWorkflowSource as ap, mergeArtifactLedger as aq, mergeFileOps as ar, resolveSessionLineageTarget as as, rewindSessionLineage as at, setAgentConfigHome as au, setSessionLineageActiveEntry as av, validateAndFixToolHistory as aw, validateWorkflowCapsule as ax, validateWorkflowScriptManifest as ay, KODAX_DEFAULT_TIMEOUT as f, KODAX_HARD_TIMEOUT as g, KODAX_MAX_INCOMPLETE_RETRIES as h, KODAX_MAX_MAXTOKENS_RETRIES as i, KODAX_MAX_RETRIES as j, KODAX_MAX_TOKENS as k, KODAX_RETRY_BASE_DELAY as l, KODAX_STAGGER_DELAY as m, LineageCompaction as o, LineageExtension as r, MessageQueue as y };
-export type { CompactionContext as C, WorkflowCapsule as F, WorkflowCapsuleEnvironmentRequirement as G, WorkflowCapsuleInputs as H, WorkflowCapsuleIntent as I, WorkflowCapsuleProvenance as J, ManagedRunClassification as M, WorkflowCapsuleRequirements as N, WorkflowPatternId as O, WorkflowProcessMetadata as Q, WorkflowQualityLintFinding as R, StartManagedRunInput as S, WorkflowQualityLintOptions as T, WorkflowQualityLintSeverity as U, WorkflowRunManager as V, WorkflowScriptManifest as X, CompactionEntry as a, CompactionEntryPayload as b, CompactionPolicy as c, CreateWorkflowCapsuleInput as d, DefaultSummaryCompactionOptions as e, LineageArtifactLedgerPayload as n, LineageCompactionDelegates as p, LineageEntryType as q, LineageLabelPayload as s, LineageTreeNode as t, ManagedRunHooks as u, ManagedWorkflowRun as v, ManagedWorkflowSnapshot as w, ManagedWorkflowStatus as x, PolicyCompactionResult as z };
+export { createSessionLineage as $, DefaultSummaryCompaction as D, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, MessageQueue as M, appendSessionLineageLabel as O, PROMISE_PATTERN as P, applyLineageTruncation as Q, applySessionCompaction as R, archiveOldIslands as S, assertRestrictedWorkflowQuality as T, buildSessionTree as U, buildWorkflowCapsuleIntent as V, WORKFLOW_CAPSULE_API_VERSION as W, cleanupIncompleteToolCalls as X, countActiveLineageMessages as Y, countTokens as Z, _resetMessageQueueForTests as _, createWorkflowCapsule as a0, createWorkflowModuleFromCapsule as a1, estimateTokens as a2, extractArtifactLedger as a3, extractFileOps as a4, extractTitleFromMessages as a5, findPreviousUserEntryId as a6, forkSessionLineage as a7, generateSessionId as a8, getAgentConfigHome as a9, getAgentConfigPath as aa, getAppDataDir as ab, getMessageQueue as ac, getSessionLineagePath as ad, getSessionMessagesFromLineage as ae, lintRestrictedWorkflowSource as af, mergeArtifactLedger as ag, mergeFileOps as ah, resolveSessionLineageTarget as ai, rewindSessionLineage as aj, setAgentConfigHome as ak, setSessionLineageActiveEntry as al, validateAndFixToolHistory as am, validateWorkflowCapsule as an, validateWorkflowScriptManifest as ao, KODAX_DEFAULT_TIMEOUT as f, KODAX_HARD_TIMEOUT as g, KODAX_MAX_INCOMPLETE_RETRIES as h, KODAX_MAX_MAXTOKENS_RETRIES as i, KODAX_MAX_RETRIES as j, KODAX_MAX_TOKENS as k, KODAX_RETRY_BASE_DELAY as l, KODAX_STAGGER_DELAY as m, LineageCompaction as o, LineageExtension as r, WORKFLOW_CAPSULE_FORMAT as v, WORKFLOW_CAPSULE_VERSION as w, WORKFLOW_PATTERN_IDS as x };
+export type { WorkflowCapsuleInputs as A, WorkflowCapsuleIntent as B, CompactionContext as C, WorkflowCapsuleProvenance as E, WorkflowCapsuleRequirements as F, WorkflowPatternId as G, WorkflowQualityLintFinding as H, WorkflowQualityLintOptions as I, WorkflowQualityLintSeverity as J, WorkflowScriptManifest as N, CompactionEntry as a, CompactionEntryPayload as b, CompactionPolicy as c, CreateWorkflowCapsuleInput as d, DefaultSummaryCompactionOptions as e, LineageArtifactLedgerPayload as n, LineageCompactionDelegates as p, LineageEntryType as q, LineageLabelPayload as s, LineageTreeNode as t, PolicyCompactionResult as u, WorkflowCapsule as y, WorkflowCapsuleEnvironmentRequirement as z };

package/dist/types-chunks/commands.d-Cg26ud-Y.d.ts

@@ -0,0 +1,213 @@
+import { h as SessionStorage$1, f as PermissionMode } from './public-api.d-CPBMPDiU.js';
+import { X as KodaXOptions, a5 as KodaXResult } from './bash-prefix-extractor.d-D57Gt6n8.js';
+import { m as RuntimeSurfaceStatus, b as CommandDefinition, e as CommandSource, c as CommandInfo, C as Command$1, I as InteractiveContext, a as CommandCallbacks, g as CurrentConfig, d as CommandInvocationRequest, f as CommandWorkflowInvocationRequest } from './utils.d-DMI-9GTR.js';
+import { b9 as KodaXSessionStorage, aZ as KodaXSessionData } from './types.d-DG9B4SMm.js';
+
+/**
+ * InkREPL - Ink-based REPL Adapter
+ *
+ * Bridges Ink UI components with existing KodaX command processing logic.
+ * Replaces the Node.js readline-based input with Ink's React components.
+ *
+ * Architecture based on Gemini CLI:
+ * - Uses UIStateContext for global state
+ * - Uses KeypressContext for priority-based keyboard handling
+ * - Uses StreamingContext for streaming response management
+ */
+
+interface InkRuntimeRunnerInput {
+    readonly options: KodaXOptions;
+    readonly prompt: string;
+    readonly sessionId: string;
+    readonly permissionMode: PermissionMode;
+}
+type InkRuntimeRunner = (input: InkRuntimeRunnerInput) => Promise<KodaXResult>;
+type InkRuntimeStatusProvider = () => Promise<RuntimeSurfaceStatus | undefined>;
+interface InkREPLOptions extends KodaXOptions {
+    storage?: SessionStorage$1;
+    hardExitOnClose?: boolean;
+    runtimeRunner?: InkRuntimeRunner;
+    getRuntimeStatus?: InkRuntimeStatusProvider;
+}
+/**
+ * Run Ink-based interactive mode
+ */
+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 ReplRuntimeRunnerInput {
+    readonly options: KodaXOptions;
+    readonly prompt: string;
+    readonly sessionId: string;
+    readonly permissionMode: PermissionMode;
+}
+type ReplRuntimeRunner = (input: ReplRuntimeRunnerInput) => Promise<KodaXResult>;
+type ReplRuntimeStatusProvider = () => Promise<RuntimeSurfaceStatus | undefined>;
+interface RepLOptions extends KodaXOptions {
+    storage?: SessionStorage;
+    runtimeRunner?: ReplRuntimeRunner;
+    getRuntimeStatus?: ReplRuntimeStatusProvider;
+}
+declare function runInteractiveMode(options: RepLOptions): Promise<void>;
+declare function processSpecialSyntax(input: string): Promise<string>;
+
+/**
+ * Command Registry - Dynamic command registration system
+ * 命令注册表 - 动态命令注册系统
+ *
+ * Provides centralized command management with source tracking,
+ * supporting dynamic registration, lookup, and listing of commands.
+ */
+
+/**
+ * CommandRegistry - Centralized command management
+ * 命令注册表 - 集中式命令管理
+ *
+ * @example
+ * ```typescript
+ * const registry = new CommandRegistry();
+ *
+ * // Register a command
+ * registry.register({
+ *   name: 'copy',
+ *   description: 'Copy last message to clipboard',
+ *   source: 'builtin',
+ *   handler: async (args, context, callbacks, config) => {
+ *     // Implementation
+ *   }
+ * });
+ *
+ * // Get a command
+ * const cmd = registry.get('copy');
+ *
+ * // List all commands
+ * const allCommands = registry.getAll();
+ *
+ * // List builtin commands only
+ * const builtinCommands = registry.getBySource('builtin');
+ * ```
+ */
+declare class CommandRegistry {
+    /**
+     * Internal command storage
+     * 内部命令存储
+     */
+    private commands;
+    /**
+     * Alias to command name mapping
+     * 别名到命令名称的映射
+     */
+    private aliases;
+    /**
+     * Register a command
+     * 注册命令
+     *
+     * @param def - Command definition
+     * @throws Error if command with same name already exists
+     */
+    register(def: CommandDefinition): void;
+    /**
+     * Unregister a command
+     * 注销命令
+     *
+     * @param name - Command name or alias
+     * @returns true if command was unregistered, false if not found
+     */
+    unregister(name: string): boolean;
+    /**
+     * Get a command by name or alias
+     * 通过名称或别名获取命令
+     *
+     * @param name - Command name or alias
+     * @returns Command definition or undefined if not found
+     */
+    get(name: string): CommandDefinition | undefined;
+    /**
+     * Check if a command exists
+     * 检查命令是否存在
+     *
+     * @param name - Command name or alias
+     * @returns true if command exists, false otherwise
+     */
+    has(name: string): boolean;
+    /**
+     * Get all commands with optional source filter
+     * 获取所有命令，可选按来源过滤
+     *
+     * @param source - Optional source filter
+     * @returns Array of command information
+     */
+    getAll(source?: CommandSource): CommandInfo[];
+    /**
+     * Get commands by source
+     * 按来源获取命令
+     *
+     * @param source - Command source
+     * @returns Array of command information
+     */
+    getBySource(source: CommandSource): CommandInfo[];
+    /**
+     * Get all command names
+     * 获取所有命令名称
+     *
+     * @returns Array of command names
+     */
+    getNames(): string[];
+    /**
+     * Clear all commands
+     * 清空所有命令
+     */
+    clear(): void;
+    /**
+     * Get command count
+     * 获取命令数量
+     *
+     * @returns Number of registered commands
+     */
+    get size(): number;
+    /**
+     * Get alias count
+     * 获取别名数量
+     *
+     * @returns Number of registered aliases
+     */
+    get aliasCount(): number;
+}
+
+/**
+ * KodaX Interactive Command System
+ */
+
+type Command = Command$1;
+declare const BUILTIN_COMMANDS: Command[];
+declare function getCommandRegistry(projectRoot?: string): CommandRegistry;
+declare function parseCommand(input: string): {
+    command: string;
+    args: string[];
+    skillInvocation?: {
+        name: string;
+    };
+} | null;
+type CommandResult = boolean | {
+    skillContent?: string;
+    invocation?: CommandInvocationRequest;
+    workflow?: CommandWorkflowInvocationRequest;
+};
+declare function executeCommand(parsed: {
+    command: string;
+    args: string[];
+    skillInvocation?: {
+        name: string;
+    };
+}, context: InteractiveContext, callbacks: CommandCallbacks, currentConfig: CurrentConfig): Promise<CommandResult>;
+
+export { BUILTIN_COMMANDS as B, executeCommand as g, getCommandRegistry as h, processSpecialSyntax as i, runInteractiveMode as j, parseCommand as p, runInkInteractiveMode as r };
+export type { Command as C, InkREPLOptions as I, RepLOptions as R, InkRuntimeRunner as a, InkRuntimeRunnerInput as b, InkRuntimeStatusProvider as c, ReplRuntimeRunner as d, ReplRuntimeRunnerInput as e, ReplRuntimeStatusProvider as f };