@kodax-ai/kodax 0.7.62 → 0.7.66

package/dist/types-chunks/{bash-prefix-extractor.d-Do_TCAmA.d.ts → bash-prefix-extractor.d-BjkITAva.d.ts}

@@ -1,5 +1,5 @@
-import { _ as KodaXGoalState, h as AgentMessage, bL as StopHookFn, af as KodaXSessionLineage, a4 as KodaXJsonValue, U as KodaXExtensionSessionRecord, c7 as WorkflowIsolation, V as KodaXExtensionSessionState, a6 as KodaXSessionArtifactLedgerEntry, bw as SessionErrorMetadata, ak as KodaXSessionScope, al as KodaXSessionStorage, a2 as KodaXInputArtifact, C as ChildTaskRegistry, c4 as WorkflowEventCorrelation, x as CompactionUpdate, cg as WorkflowProcessEvent, c3 as WorkflowEvent, q as AskUserQuestionOptions, m as AskUserAnswer, o as AskUserMultiOptions, a$ as MemoryReviewPlan, b0 as MemoryReviewRunner, J as Guardrail, B as DiscoveredInstance, bP as TaskAbortRegistry } from './process.d-DXkRD7hj.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 { _ 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, 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
@@ -1240,6 +1368,121 @@ interface ExtensionRuntimeContract extends CapabilityRuntimeContract {
  */
 type ToolSideEffect = 'readonly' | 'reads-network' | 'mutates-fs' | 'mutates-shell' | 'mutates-network' | 'mutates-state';
 
+/**
+ * FEATURE_089 (v0.7.31) Phase 3.4 — Constructed Agent Resolver.
+ *
+ * Module-singleton registry mapping `name` → runnable `Agent` for
+ * agents that have passed admission and been activated through
+ * `ConstructionRuntime.activate()`. Mirrors the way TOOL_REGISTRY
+ * holds activated constructed tools, but for agents.
+ *
+ * Why a separate registry (not in TOOL_REGISTRY):
+ *
+ *   - Tools and Agents are different runtime types. A `KodaXToolDefinition`
+ *     has `input_schema` + `handler`; an `Agent` has `instructions` +
+ *     `tools` + `handoffs` + `reasoning`. Conflating them would force
+ *     consumers to discriminate on every lookup.
+ *   - Resolution semantics differ: a tool lookup returns the executable
+ *     handler; an agent lookup returns the declarative spec (Runner.run
+ *     drives the loop separately).
+ *
+ * Resolution surface:
+ *
+ *   - `resolveConstructedAgent(name)`     — name → Agent | undefined
+ *   - `listConstructedAgents()`           — snapshot of activated agents
+ *   - `registerConstructedAgent(artifact)` → unregister fn (called by
+ *      runtime on activate, captured in the runtime's `_activated` map)
+ *   - `_resetAgentResolverForTesting()`   — test isolation
+ *
+ * Tool / handoff ref resolution:
+ *   - Tool refs are resolved against TOOL_REGISTRY at activation time —
+ *     a snapshot. If a referenced tool is later revoked, the agent
+ *     keeps its stale ref; Phase 3.5 sandbox testing catches this.
+ *   - Handoff target refs lift to stub Agent objects (`name` only) when
+ *     the target hasn't been activated yet. Transitive admission ran
+ *     at test time so the graph is known to be acyclic; runtime
+ *     traversal just walks the names.
+ *
+ * Non-goal: full referential consistency between tools / agents /
+ * handoffs. The threat model is single-user CLI integrity (DD §14.5);
+ * stale refs are an LLM-authoring footgun, not a security bypass.
+ */
+
+interface ConstructedAgentToolPolicy {
+    readonly declaredTools: boolean;
+    readonly effectiveToolNames: readonly string[];
+}
+interface KodaXAgentScope {
+    readonly kind: 'constructed-agent-scope';
+    readonly id: string;
+    readonly disposed: boolean;
+    resolve(name: string): ConstructedAgentEntry | undefined;
+    list(): readonly ConstructedAgentEntry[];
+    dispose(): void;
+}
+/**
+ * FEATURE_191 — registration source enum. Used in-memory to disambiguate
+ * which loader registered an agent so REPL `/agents list` can group by
+ * origin and same-name precedence is enforced via load order rather
+ * than a precedence stack. Not persisted to `AgentArtifact` (the
+ * artifact schema stays untouched to avoid migration).
+ *
+ * Load-order convention (boot path registers in this order; subsequent
+ * registrations overwrite earlier ones via last-write-wins):
+ *   built-in < extension < markdown:user < markdown:project <
+ *   constructed:cli < constructed:llm
+ */
+type ConstructedAgentSource = 'built-in' | 'extension' | 'markdown:user' | 'markdown:project' | 'constructed:cli' | 'constructed:llm';
+/**
+ * Look up an activated constructed agent by name. Returns the
+ * resolved `Agent` (with tools / handoffs lifted from refs). Returns
+ * `undefined` when no agent at that name has been activated.
+ */
+declare function resolveConstructedAgent(name: string, scope?: KodaXAgentScope): Agent | undefined;
+/**
+ * FEATURE_191 — enriched snapshot exposing both the resolved Agent and
+ * the in-memory source tag. Consumers that need provenance (REPL
+ * `/agents list --by-source`, debug surfaces) call this instead of
+ * `listConstructedAgents()`. The plain-Agent list keeps its signature
+ * for backward compatibility with all pre-FEATURE_191 callers.
+ *
+ * @internal v0.7.43 surface — exposed for the planned v0.7.46+
+ * `/agents list` REPL command and for source-tag round-trip tests
+ * (see `agent-resolver.test.ts` FEATURE_191 B.3 block). NOT yet a
+ * stable SDK surface; embedders SHOULD continue using
+ * `listConstructedAgents()` (which is byte-identical post-F191).
+ * Promoted to public when the REPL `/agents list` consumer ships.
+ */
+interface ConstructedAgentEntry {
+    readonly agent: Agent;
+    readonly source: ConstructedAgentSource | undefined;
+    readonly toolPolicy?: ConstructedAgentToolPolicy;
+}
+/**
+ * FEATURE_090 — `true` iff a self-modify activation has been staged
+ * for `name` but has not yet been drained into the active registry.
+ * Surfaces for tooling that wants to display "next run will use
+ * version X" hints, and as a sanity-check assertion in tests.
+ */
+declare function hasPendingSwap(name: string): boolean;
+/**
+ * FEATURE_090 — promote every pending self-modify entry into
+ * `AGENT_REGISTRY`, replacing the prior active version. Returns the
+ * names that were drained so the caller can surface a hint
+ * ("alpha is now running version 1.1.0").
+ *
+ * Idempotent: calling on an empty pending map is a no-op. Atomic at
+ * the JS event-loop level (a single synchronous pass); drain cannot
+ * partially complete.
+ *
+ * Integration contract: the REPL surface calls this immediately after
+ * any top-level `Runner.run` returns. KodaX is single-process and
+ * single-user, so "the run that triggered the change" and "all
+ * in-flight runs" are the same set — no concurrent-run coordination
+ * needed.
+ */
+declare function drainPendingSwaps(): readonly string[];
+
 /**
  * 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
@@ -1594,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.
      *
@@ -2282,6 +2531,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
@@ -2302,6 +2556,12 @@ interface KodaXContextOptions {
     inputArtifacts?: KodaXInputArtifact[];
     /** Internal execution-mode overlay appended to the system prompt */
     promptOverlay?: string;
+    /**
+     * Scoped specialist-agent resolver for embedders that run multiple
+     * projects/sessions in one process. When absent, constructed-agent
+     * lookups use the legacy process-global registry.
+     */
+    agentScope?: KodaXAgentScope;
     /** Optional task-engine surface label used to track managed tasks across UX entry points. */
     taskSurface?: KodaXTaskSurface;
     /**
@@ -2851,6 +3111,8 @@ interface KodaXToolExecutionContext {
      * from `options.context.agentProfile`. Absent ⇒ default Coding Agent.
      */
     agentProfile?: KodaXAgentProfile;
+    /** Scoped specialist-agent resolver inherited from KodaXOptions.context. */
+    agentScope?: KodaXAgentScope;
     /** FEATURE_221: SDK-consumer self-manual injection, forwarded from KodaXOptions. */
     selfManual?: KodaXSelfManualConfig;
     /** FEATURE_222 skill security — host policy for skill `!`cmd`` dynamic-context,
@@ -3416,5 +3678,5 @@ interface CreateBashPrefixExtractorOptions {
  */
 declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
 
-export { BASH_POLICY_SPEC as B, LSP_SERVERS as aB, LspService as aD, buildGoalRuntimeBinding as b6, createBashPrefixExtractor as b7, decideWorkflowInvocation as b8, extractCommandPrefix as b9, getDefaultLspService as ba, makeDisabledGoalToolsContext as bb, providerResilienceConfigFromTimeouts as bc, shutdownDefaultLspService as bd, withGoalBeforeNextTurn as be, withGoalStopHook as bf, workflowStartOutcomeConsumesTurn as bg };
-export type { KodaXRoleRoundSummary as $, KodaXManagedProtocolPayload as A, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXManagedTask as H, KodaXManagedTaskRuntimeState as I, KodaXManagedTaskStatusEvent as J, KodaXActivityEventMeta as K, KodaXManualSource as L, KodaXManualTopic as M, KodaXManualTopicId as N, KodaXManualTopicInput as O, KodaXMemoryStrategy as P, KodaXOptions as Q, KodaXOrchestrationVerdict as R, KodaXParentReductionContract as S, KodaXProviderPolicyHints as T, KodaXRepoIntelligenceCapability as U, KodaXRepoIntelligenceMode as V, KodaXRepoIntelligenceResolvedMode as W, KodaXRepoIntelligenceTrace as X, KodaXRepoIntelligenceTraceEvent as Y, KodaXRepoRoutingSignals as Z, KodaXResult as _, BashPrefixExtractor as a, WorkflowInvocationSource as a$, KodaXRuntimeVerificationContract as a0, KodaXSelfManualConfig as a1, KodaXSessionControl as a2, KodaXSessionMutators as a3, KodaXSessionOptions as a4, KodaXSidecarMessageEvent as a5, KodaXSkillDynamicContextPolicy as a6, KodaXSkillInvocationContext as a7, KodaXSkillMap as a8, KodaXSkillProjectionConfidence as a9, KodaXWorkflowTimeoutConfig as aA, LspServerInfo as aC, LspServiceConfig as aE, ProviderExecutionState as aF, ProviderRecoveryEvent as aG, ProviderResilienceConfig as aH, ProviderResiliencePolicy as aI, RecoveryAction as aJ, RecoveryDecision as aK, RecoveryLadderStep as aL, RecoveryResult as aM, ResilienceClassification as aN, ResilienceErrorClass as aO, ResolveKodaXManualInput as aP, ResolveKodaXManualOptions as aQ, ResolveKodaXManualResult as aR, RuntimeDefaultsSnapshot as aS, TodoItem as aT, TodoList as aU, TodoStatus as aV, ToolSideEffect as aW, WorkflowHostPolicy as aX, WorkflowInvocationAction as aY, WorkflowInvocationPolicyDecision as aZ, WorkflowInvocationPolicyInput as a_, 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, KodaXToolVisibilityMeta as aq, KodaXToolVisibilityPolicy as ar, KodaXTurnCompletedEvent as as, KodaXTurnDeliveryKind as at, KodaXTurnFailedEvent as au, KodaXTurnStartedEvent as av, KodaXVerificationScorecard as aw, KodaXVerificationScorecardCriterion as ax, KodaXWorkflowAgentDigestEvent as ay, KodaXWorkflowEventMeta as az, BashPrefixResult as b, WorkflowRunProgressView as b0, WorkflowStartOutcome as b1, WorkflowToolHost as b2, WorkflowToolHostInlineInput as b3, WorkflowToolHostResult as b4, WorkflowToolHostStartResult as b5, 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, KodaXBudgetDisclosureZone as o, KodaXBudgetExtensionRequest as p, KodaXChildAgentResult as q, KodaXChildContextBundle as r, KodaXChildExecutionResult as s, KodaXCompactionOverride as t, KodaXContextOptions as u, KodaXContextTokenSnapshot as v, KodaXEffectiveTaskConfig as w, KodaXEvents as x, KodaXLiveEventMeta as y, KodaXManagedBudgetSnapshot 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-CYY3pZeJ.d.ts → capsule.d-hVhPNkHd.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-DFf4Sfys.js';
-import { h as AgentMessage, bv as SessionEntry, bt as Session, bx as SessionExtension, af as KodaXSessionLineage, a4 as KodaXJsonValue, u as CompactionDetails, T as KodaXCompactMemorySeed, ab as KodaXSessionEntry, am as KodaXSessionTreeNode, ae as KodaXSessionLabelEntry, ad as KodaXSessionGoalEntry, a8 as KodaXSessionClientNoticeEntry, ai as KodaXSessionNavigationOptions, a6 as KodaXSessionArtifactLedgerEntry, H as FileOperations, ca as WorkflowMeta, cb as WorkflowModelHint, cc as WorkflowModule, cs as WorkflowProcessTrackerOptions, c3 as WorkflowEvent, cm as WorkflowProcessSnapshot, cg as WorkflowProcessEvent } from './process.d-DXkRD7hj.js';
+import { Q as QueueEventListener, c as QueuedMessage, E as EnqueueInput, D as DequeueFilter } from './types.d-BMLxKV69.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 } from './process.d-CY2g03Mb.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 数量（便捷函数）
  */
@@ -568,7 +568,7 @@ declare function generateSessionId(): Promise<string>;
  */
 declare function extractTitleFromMessages(messages: KodaXMessage[]): string;
 
-type NavigableSessionEntry = Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry | KodaXSessionClientNoticeEntry>;
+type NavigableSessionEntry = Exclude<KodaXSessionEntry, KodaXSessionLabelEntry | KodaXSessionGoalEntry | KodaXSessionClientNoticeEntry | KodaXSessionRewindMarkerEntry>;
 /**
  * Reconcile a linear message list against an existing lineage tree.
  *
@@ -591,6 +591,9 @@ declare function getSessionLineagePath(lineage: KodaXSessionLineage, targetId?:
  * slicer-layer concern, which preserves the contract
  * `entryMatchesContextMessage` and FEATURE_073's future firstKeptEntryId-based
  * slicing both depend on.
+ * Native rewind audits are `rewind_marker` entries and never reach this path;
+ * the `reason !== 'rewind'` guard keeps legacy persisted rewind compactions
+ * context-silent.
  */
 declare function getSessionMessagesFromLineage(lineage: KodaXSessionLineage, targetId?: string | null): KodaXMessage[];
 /**
@@ -651,20 +654,6 @@ declare function applySessionCompaction(lineage: KodaXSessionLineage | undefined
  * defines the helper; no production caller yet.
  */
 declare function applyLineageTruncation(lineage: KodaXSessionLineage | undefined, trimmedMessages: KodaXMessage[]): KodaXSessionLineage;
-/**
- * Rewind the current session lineage to a target entry, truncating all entries after it.
- * Records a rewind event in the lineage for auditability.
- * Returns null if targetEntryId is not found.
- *
- * @param lineage - The session lineage to rewind
- * @param targetEntryId - The entry ID to rewind to (inclusive)
- * @returns A new lineage with entries truncated after the target, or null if target not found
- */
-/**
- * Find the entry ID of the second-to-last user message in the lineage.
- * Used by `/rewind` (no argument) to go back one conversational turn.
- * Returns null if fewer than 2 user messages exist.
- */
 declare function findPreviousUserEntryId(lineage: KodaXSessionLineage): string | null;
 declare function rewindSessionLineage(lineage: KodaXSessionLineage, targetEntryId: string): KodaXSessionLineage | null;
 declare function forkSessionLineage(lineage: KodaXSessionLineage, selector?: string): KodaXSessionLineage | null;
@@ -842,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 };