@kodax-ai/kodax 0.7.78 → 0.7.80

package/dist/types-chunks/{base.d-4e74xDdy.d.ts → base.d-DxG0m09Z.d.ts}

@@ -1,4 +1,4 @@
-import { q as KodaXProviderConfig, k as KodaXMessage, a1 as KodaXToolDefinition, H as KodaXReasoningRequest, y as KodaXProviderStreamOptions, N as KodaXStreamResult, a7 as KodaXVerifyCredentialResult, l as KodaXModelDescriptor, p as KodaXProviderCapabilityProfile, B as KodaXReasoningCapability, G as KodaXReasoningProfile, n as KodaXNormalizedReasoningRequest, a9 as KodaXWireReasoningEffort } from './types.d-DIpZJKUl.js';
+import { r as KodaXProviderConfig, k as KodaXMessage, a2 as KodaXToolDefinition, I as KodaXReasoningRequest, z as KodaXProviderStreamOptions, O as KodaXStreamResult, a8 as KodaXVerifyCredentialResult, l as KodaXModelDescriptor, q as KodaXProviderCapabilityProfile, C as KodaXReasoningCapability, H as KodaXReasoningProfile, n as KodaXNormalizedReasoningRequest, aa as KodaXWireReasoningEffort } from './types.d-CgrXrFrq.js';
 
 /**
  * Retry-After header parsing — FEATURE_130 (v0.7.36).

package/dist/types-chunks/{bash-prefix-extractor.d-uAe2Oqda.d.ts → bash-prefix-extractor.d-DStqKIlu.d.ts}

@@ -1,11 +1,11 @@
-import { bz as KodaXGoalState, ab as AgentMessage, eg as StopHookFn, bU as KodaXSessionLineage, n as AgentActorStore, aF as AgentTurnExecutor, w as AgentBudgetPort, i as AgentActorOwner, h as AgentActorClient, Q as AgentExecutionResult, Y as AgentExecutorPlaneBinding, bF as KodaXJsonValue, bt as KodaXExtensionSessionRecord, f as Agent, eG as WorkflowIsolation, bu as KodaXExtensionSessionState, bL as KodaXSessionArtifactLedgerEntry, e0 as SessionErrorMetadata, c0 as KodaXSessionScope, c1 as KodaXSessionStorage, d2 as MemoryContextIdentity, de as MemoryPack, aN as AskUserQuestionOptions, aJ as AskUserAnswer, aL as AskUserMultiOptions, eD as WorkflowEventCorrelation, aX as CompactionUpdate, eU as WorkflowProcessEvent, eC as WorkflowEvent, dt as MemoryReviewPlan, bI as KodaXMemoryOutcomeDigest, bi as Guardrail, b2 as DiscoveredInstance, bD as KodaXInputArtifact, du as MemoryReviewRunner, eu as UnifiedLearningReviewRunner } from './types.d-BA-Jwpfs.js';
-import { a0 as KodaXTokenUsage, k as KodaXMessage, a1 as KodaXToolDefinition, a9 as KodaXWireReasoningEffort, U as KodaXTaskRoutingDecision, V as KodaXTaskType, W as KodaXTaskWorkIntent, Q as KodaXTaskComplexity, L as KodaXRiskLevel, h as KodaXHarnessProfile, f as KodaXExecutionMode, b as KodaXChildFanoutClass, F as KodaXReasoningMode, J as KodaXReviewScale } from './types.d-DIpZJKUl.js';
-import { d as SkillDynamicContextExecutor, I as ISkillRegistry } from './types.d-BbtGlKZu.js';
+import { bI as KodaXGoalState, ae as AgentMessage, er as StopHookFn, c1 as KodaXSessionLineage, o as AgentActorStore, aI as AgentTurnExecutor, x as AgentBudgetPort, j as AgentActorOwner, D as AgentControllerHealth, h as AgentActorClient, T as AgentExecutionResult, $ as AgentExecutorPlaneBinding, bO as KodaXJsonValue, bC as KodaXExtensionSessionRecord, f as Agent, eT as WorkflowIsolation, bD as KodaXExtensionSessionState, bU as KodaXSessionArtifactLedgerEntry, eb as SessionErrorMetadata, c9 as KodaXSessionScope, ca as KodaXSessionStorage, bp as GuardrailPermissionIntent, db as MemoryContextIdentity, dn as MemoryPack, aQ as AskUserQuestionOptions, aM as AskUserAnswer, aO as AskUserMultiOptions, eQ as WorkflowEventCorrelation, a_ as CompactionUpdate, f5 as WorkflowProcessEvent, eP as WorkflowEvent, dC as MemoryReviewPlan, bR as KodaXMemoryOutcomeDigest, bl as Guardrail, b5 as DiscoveredInstance, bM as KodaXInputArtifact, dD as MemoryReviewRunner, eH as UnifiedLearningReviewRunner } from './controller.d-C2aHqzHj.js';
 import { Diagnostic, Position, Location, Hover, DocumentSymbol, SymbolInformation, WorkspaceSymbol, CallHierarchyItem, CallHierarchyIncomingCall, CallHierarchyOutgoingCall } from 'vscode-languageserver-protocol';
+import { a1 as KodaXTokenUsage, k as KodaXMessage, a2 as KodaXToolDefinition, aa as KodaXWireReasoningEffort, V as KodaXTaskRoutingDecision, W as KodaXTaskType, X as KodaXTaskWorkIntent, R as KodaXTaskComplexity, M as KodaXRiskLevel, h as KodaXHarnessProfile, f as KodaXExecutionMode, b as KodaXChildFanoutClass, G as KodaXReasoningMode, L as KodaXReviewScale } from './types.d-CgrXrFrq.js';
+import { d as SkillDynamicContextExecutor, I as ISkillRegistry } from './types.d-BbtGlKZu.js';
 import { K as KodaXLlmTimeoutConfig, a as CostTracker } from './cost-tracker.d-BeaenODW.js';
-import { t as MemoryRecallRunner } from './types-D3g6XUQr.js';
+import { t as MemoryRecallRunner } from './types-Bf3Y3mW-.js';
 import { C as CapabilityKind, f as CapabilitySearchSnapshot, b as CapabilityResult } from './capability.d-K664nHOS.js';
-import { K as KodaXBaseProvider } from './base.d-4e74xDdy.js';
+import { K as KodaXBaseProvider } from './base.d-DxG0m09Z.js';
 
 /**
  * FEATURE_192 v0.7.44 Phase C — Goal-tools execution context.
@@ -393,6 +393,7 @@ declare function workflowStartOutcomeConsumesTurn(input: {
 interface LspServerLaunch {
     readonly command: string;
     readonly args: readonly string[];
+    readonly kind?: 'javascript';
     readonly initializationOptions?: Record<string, unknown>;
 }
 interface DiscoverContext {
@@ -839,6 +840,7 @@ interface CodingActorSessionOptions {
     readonly budget?: AgentBudgetPort;
     readonly owner?: AgentActorOwner;
     readonly isOwnerAlive?: (owner: AgentActorOwner) => boolean | Promise<boolean>;
+    readonly onHealthChanged?: (health: AgentControllerHealth) => void;
 }
 /** One Runtime-owned Actor tree for one KodaX session. */
 declare class CodingActorSession {
@@ -851,6 +853,7 @@ declare class CodingActorSession {
     initialize(): Promise<void>;
     attach(parentCtx: KodaXToolExecutionContext, options: KodaXOptions, callerPath?: string): AgentActorClient;
     rootControl(): AgentActorClient;
+    health(): AgentControllerHealth;
     ownerId(): string | undefined;
     ownsDurableFence(): boolean;
     createWorkflowOwner(parentPath: string, runId: string): Promise<AgentActorClient>;
@@ -1361,7 +1364,7 @@ interface ExtensionRuntimeContract extends CapabilityRuntimeContract {
  *                            eligibility is still driven by `planModeAllowed`,
  *                            unchanged.
  *   - `'mutates-network'` — performs a network request that may mutate remote
- *                            state (web_fetch with a mutating method, mcp_call).
+ *                            state (for example mcp_call).
  *   - `'mutates-state'`   — changes internal session/agent state without
  *                            FS or shell side effects (todo_update,
  *                            send_message, spawn_agent, followup_task,
@@ -1847,10 +1850,12 @@ interface KodaXEvents {
     onTurnStarted?: (event: KodaXTurnStartedEvent) => void;
     onTurnCompleted?: (event: KodaXTurnCompletedEvent) => void;
     onTurnFailed?: (event: KodaXTurnFailedEvent) => void;
+    /** `maxIter` is the active Runner invocation's fuse, not a task-wide budget. */
     onIterationStart?: (iter: number, maxIter: number, meta?: KodaXActivityEventMeta) => void;
     /** Called after each iteration with current token count for UI updates */
     onIterationEnd?: (info: {
         iter: number;
+        /** Active Runner invocation fuse; zero is reserved for unbounded callers. */
         maxIter: number;
         tokenCount: number;
         tokenSource: 'api' | 'estimate';
@@ -2794,6 +2799,12 @@ interface KodaXShellSandbox {
     prepare(input: KodaXShellSandboxPrepareInput): Promise<KodaXPreparedShellSandboxInvocation | undefined>;
 }
 interface KodaXContextOptions {
+    /**
+     * Runtime-authenticated authority for permission review. Child runtimes must
+     * preserve the root request and add delegation metadata instead of treating
+     * their generated briefing as a new user authorization.
+     */
+    permissionIntent?: GuardrailPermissionIntent;
     /** Runtime-owner config home used by Memory, review inbox, and Learned Area routing. */
     configHome?: string;
     /** Runtime-internal shared work ledger inherited by every descendant Agent run. */
@@ -3167,6 +3178,8 @@ interface KodaXOptions {
     workflow?: {
         readonly maxConcurrency?: number;
     };
+    /** Host environment names exposed only to final command targets. Defaults to none. */
+    sandbox?: KodaXSandboxOptions;
     /** FEATURE_221: SDK-consumer self-manual injection (product name + topics). */
     selfManual?: KodaXSelfManualConfig;
     /**
@@ -3209,6 +3222,10 @@ interface KodaXOptions {
      */
     timeouts?: KodaXTimeoutConfig;
 }
+interface KodaXSandboxOptions {
+    /** Exact host environment-variable names; values are never carried in this option. */
+    readonly envPass?: readonly string[];
+}
 /**
  * Low-level mutators handed to a `KodaXSessionControl` by the substrate.
  * Each setter writes directly into the live `RuntimeSessionState`. Called
@@ -3474,6 +3491,8 @@ interface KodaXToolExecutionContext {
     };
     /** Shared root-run work ledger; descendant runtimes retain this exact object. */
     managedWorkBudget?: KodaXManagedWorkBudget;
+    /** Trusted permission authority inherited independently of child transcripts. */
+    permissionIntent?: GuardrailPermissionIntent;
     /** Trusted host operations that are intentionally absent from model-facing clients. */
     actorHost?: KodaXActorHost;
     /** FEATURE_260: current exactly-scoped read-only MemorySession query binding. */
@@ -3547,6 +3566,8 @@ interface KodaXToolExecutionContext {
     executionCwd?: string;
     /** Validated shell execution policy inherited by native child runtimes. */
     shellExecution?: KodaXShellExecutionContract;
+    /** Run-scoped command-target environment policy supplied by the SDK host. */
+    sandbox?: KodaXSandboxOptions;
     /** Runtime-owned OS sandbox broker for selected concrete shell calls. */
     shellSandbox?: KodaXShellSandbox;
     /** Structured containment metadata; never model-visible or persisted as conversation text. */
@@ -3640,6 +3661,8 @@ interface KodaXToolExecutionContext {
         readonly contextDiagnostics?: boolean;
         readonly disablePromptCache?: boolean;
         readonly shellExecution?: KodaXShellExecutionContract;
+        readonly sandbox?: KodaXSandboxOptions;
+        readonly permissionIntent?: GuardrailPermissionIntent;
     };
     /** Parent SDK/REPL callback surface used to preserve nested Agent telemetry. */
     parentEvents?: KodaXEvents;
@@ -3999,5 +4022,5 @@ interface CreateBashPrefixExtractorOptions {
  */
 declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
 
-export { ALWAYS_RESIDENT_TOOL_NAMES as A, BASH_POLICY_SPEC as B, resolveConstructedAgent as b$, LSP_SERVERS as b0, LspService as b2, buildGoalRuntimeBinding as bI, consumeCompactionCooldown as bJ, createBashPrefixExtractor as bK, createCompactionAntiThrashState as bL, createExternalActorTurnExecutor as bM, createLocalCodingActorControl as bN, createRuntimeContextBudgetSnapshot as bO, decideWorkflowInvocation as bP, drainPendingSwaps as bQ, estimateToolSchemaTokens as bR, extractCommandPrefix as bS, getDefaultLspService as bT, hasExplicitNaturalLanguageWorkflowIntent as bU, hasPendingSwap as bV, makeDisabledGoalToolsContext as bW, normalizeKodaXAgentMode as bX, planToolExposure as bY, providerResilienceConfigFromTimeouts as bZ, recordCompactionSavings as b_, shouldSkipLlmCompaction as c0, shutdownDefaultLspService as c1, withGoalBeforeNextTurn as c2, withGoalStopHook as c3, workflowStartOutcomeConsumesTurn as c4, CodingActorSession as d };
-export type { KodaXManualTopicInput as $, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXChildContextBundle as H, KodaXChildExecutionResult as I, KodaXCompactionOverride as J, KodaXActivityEventMeta as K, KodaXContextCompactionFinishedEvent as L, KodaXContextIdentity as M, KodaXContextOptions as N, KodaXContextTokenSnapshot as O, KodaXEffectiveTaskConfig as P, KodaXEvents as Q, KodaXLiveEventMeta as R, KodaXManagedBudgetSnapshot as S, KodaXManagedProtocolPayload as T, KodaXManagedTask as U, KodaXManagedTaskRuntimeState as V, KodaXManagedTaskStatusEvent as W, KodaXManualIndexTopic as X, KodaXManualSource as Y, KodaXManualTopic as Z, KodaXManualTopicId as _, BashPrefixExtractor as a, KodaXWorkflowTimeoutConfig as a$, KodaXMemoryStrategy as a0, KodaXOptions as a1, KodaXOrchestrationVerdict as a2, KodaXParentReductionContract as a3, KodaXPreparedShellSandboxInvocation as a4, KodaXPromptCacheDiagnosticEvent as a5, KodaXProviderPolicyHints as a6, KodaXRepoIntelligenceCapability as a7, KodaXRepoIntelligenceMode as a8, KodaXRepoIntelligenceResolvedMode as a9, 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, KodaXToolSandboxObservationUpdate 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, KodaXWorkflowEventMeta as a_, KodaXRepoIntelligenceTrace as aa, KodaXRepoIntelligenceTraceEvent as ab, KodaXRepoRoutingSignals as ac, KodaXResult as ad, KodaXRoleRoundSummary as ae, KodaXRuntimeVerificationContract as af, KodaXSelfManualConfig as ag, KodaXSessionControl as ah, KodaXSessionMutators as ai, KodaXSessionOptions as aj, KodaXShellExecutionContract as ak, KodaXShellKind as al, KodaXShellProfileMode as am, KodaXShellSandbox as an, KodaXShellSandboxBackend as ao, KodaXShellSandboxObservation as ap, KodaXShellSandboxPrepareInput as aq, KodaXSidecarMessageEvent as ar, KodaXSkillDynamicContextPolicy as as, KodaXSkillInvocationContext as at, KodaXSkillMap as au, KodaXSkillProjectionConfidence as av, KodaXSkillScriptInputFile as aw, KodaXSkillScriptOutputFile as ax, KodaXSkillScriptRunInput as ay, KodaXSkillScriptRunner as az, BashPrefixResult as b, LspServerInfo as b1, LspServiceConfig as b3, ProviderExecutionState as b4, ProviderRecoveryEvent as b5, ProviderResilienceConfig as b6, ProviderResiliencePolicy as b7, RecoveryAction as b8, RecoveryDecision as b9, WorkflowInvocationPolicyDecision as bA, WorkflowInvocationPolicyInput as bB, WorkflowInvocationSource as bC, WorkflowStartOutcome as bD, WorkflowToolHost as bE, WorkflowToolHostInlineInput as bF, WorkflowToolHostResult as bG, WorkflowToolHostStartResult as bH, RecoveryLadderStep as ba, RecoveryResult as bb, ResilienceClassification as bc, ResilienceErrorClass as bd, ResolveKodaXManualInput as be, ResolveKodaXManualOptions as bf, ResolveKodaXManualResult as bg, RuntimeCompactionSkippedEvent as bh, RuntimeContextBudgetBreakdown as bi, RuntimeContextBudgetRecommendation as bj, RuntimeContextBudgetSnapshot as bk, RuntimeContextBudgetSnapshotInput as bl, RuntimeContextOptimizationProfile as bm, RuntimeContextPressure as bn, RuntimeDefaultsSnapshot as bo, RuntimeToolExposureDecision as bp, RuntimeToolExposureMode as bq, RuntimeToolExposurePlan as br, RuntimeToolExposurePlanInput as bs, RuntimeToolExposureReason as bt, TodoItem as bu, TodoList as bv, TodoStatus as bw, ToolSideEffect as bx, WorkflowHostPolicy as by, WorkflowInvocationAction as bz, BoundExtensionRuntimeController as c, CodingActorSessionOptions as e, CompactionAntiThrashConfig as f, CompactionAntiThrashState as g, CompactionSavingsDecision as h, CompactionSavingsSample as i, CompactionSkipReason as j, CreateBashPrefixExtractorOptions as k, ExtractCommandPrefixOptions as l, GoalCompleteResult as m, GoalCreateInput as n, GoalLifecycleContext as o, GoalRuntimeBinding as p, GoalRuntimeBindingDeps as q, GoalToolsContext as r, KodaXActorHost as s, KodaXAgentMode as t, KodaXAgentProfile as u, KodaXAgentScope as v, KodaXBudgetDisclosureZone as w, KodaXBudgetExtensionRequest as x, KodaXCanonicalAgentMode as y, KodaXChildAgentResult as z };
+export { ALWAYS_RESIDENT_TOOL_NAMES as A, BASH_POLICY_SPEC as B, recordCompactionSavings as b$, LSP_SERVERS as b1, LspService as b3, buildGoalRuntimeBinding as bJ, consumeCompactionCooldown as bK, createBashPrefixExtractor as bL, createCompactionAntiThrashState as bM, createExternalActorTurnExecutor as bN, createLocalCodingActorControl as bO, createRuntimeContextBudgetSnapshot as bP, decideWorkflowInvocation as bQ, drainPendingSwaps as bR, estimateToolSchemaTokens as bS, extractCommandPrefix as bT, getDefaultLspService as bU, hasExplicitNaturalLanguageWorkflowIntent as bV, hasPendingSwap as bW, makeDisabledGoalToolsContext as bX, normalizeKodaXAgentMode as bY, planToolExposure as bZ, providerResilienceConfigFromTimeouts as b_, resolveConstructedAgent as c0, shouldSkipLlmCompaction as c1, shutdownDefaultLspService as c2, withGoalBeforeNextTurn as c3, withGoalStopHook as c4, workflowStartOutcomeConsumesTurn as c5, CodingActorSession as d };
+export type { KodaXManualTopicInput as $, CapabilityRuntimeContract as C, DiagnosticsRequest as D, ExtensionRuntimeContract as E, FailureStage as F, GoalBlockedResult as G, KodaXChildContextBundle as H, KodaXChildExecutionResult as I, KodaXCompactionOverride as J, KodaXActivityEventMeta as K, KodaXContextCompactionFinishedEvent as L, KodaXContextIdentity as M, KodaXContextOptions as N, KodaXContextTokenSnapshot as O, KodaXEffectiveTaskConfig as P, KodaXEvents as Q, KodaXLiveEventMeta as R, KodaXManagedBudgetSnapshot as S, KodaXManagedProtocolPayload as T, KodaXManagedTask as U, KodaXManagedTaskRuntimeState as V, KodaXManagedTaskStatusEvent as W, KodaXManualIndexTopic as X, KodaXManualSource as Y, KodaXManualTopic as Z, KodaXManualTopicId as _, BashPrefixExtractor as a, KodaXWorkflowEventMeta as a$, KodaXMemoryStrategy as a0, KodaXOptions as a1, KodaXOrchestrationVerdict as a2, KodaXParentReductionContract as a3, KodaXPreparedShellSandboxInvocation as a4, KodaXPromptCacheDiagnosticEvent as a5, KodaXProviderPolicyHints as a6, KodaXRepoIntelligenceCapability as a7, KodaXRepoIntelligenceMode as a8, KodaXRepoIntelligenceResolvedMode as a9, KodaXSkillScriptRunner 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, KodaXToolSandboxObservationUpdate as aR, KodaXToolVisibilityMeta as aS, KodaXToolVisibilityPolicy as aT, KodaXTurnCompletedEvent as aU, KodaXTurnDeliveryKind as aV, KodaXTurnFailedEvent as aW, KodaXTurnStartedEvent as aX, KodaXVerificationScorecard as aY, KodaXVerificationScorecardCriterion as aZ, KodaXWorkflowAgentDigestEvent as a_, KodaXRepoIntelligenceTrace as aa, KodaXRepoIntelligenceTraceEvent as ab, KodaXRepoRoutingSignals as ac, KodaXResult as ad, KodaXRoleRoundSummary as ae, KodaXRuntimeVerificationContract as af, KodaXSandboxOptions as ag, KodaXSelfManualConfig as ah, KodaXSessionControl as ai, KodaXSessionMutators as aj, KodaXSessionOptions as ak, KodaXShellExecutionContract as al, KodaXShellKind as am, KodaXShellProfileMode as an, KodaXShellSandbox as ao, KodaXShellSandboxBackend as ap, KodaXShellSandboxObservation as aq, KodaXShellSandboxPrepareInput as ar, KodaXSidecarMessageEvent as as, KodaXSkillDynamicContextPolicy as at, KodaXSkillInvocationContext as au, KodaXSkillMap as av, KodaXSkillProjectionConfidence as aw, KodaXSkillScriptInputFile as ax, KodaXSkillScriptOutputFile as ay, KodaXSkillScriptRunInput as az, BashPrefixResult as b, KodaXWorkflowTimeoutConfig as b0, LspServerInfo as b2, LspServiceConfig as b4, ProviderExecutionState as b5, ProviderRecoveryEvent as b6, ProviderResilienceConfig as b7, ProviderResiliencePolicy as b8, RecoveryAction as b9, WorkflowInvocationAction as bA, WorkflowInvocationPolicyDecision as bB, WorkflowInvocationPolicyInput as bC, WorkflowInvocationSource as bD, WorkflowStartOutcome as bE, WorkflowToolHost as bF, WorkflowToolHostInlineInput as bG, WorkflowToolHostResult as bH, WorkflowToolHostStartResult as bI, RecoveryDecision as ba, RecoveryLadderStep as bb, RecoveryResult as bc, ResilienceClassification as bd, ResilienceErrorClass as be, ResolveKodaXManualInput as bf, ResolveKodaXManualOptions as bg, ResolveKodaXManualResult as bh, RuntimeCompactionSkippedEvent as bi, RuntimeContextBudgetBreakdown as bj, RuntimeContextBudgetRecommendation as bk, RuntimeContextBudgetSnapshot as bl, RuntimeContextBudgetSnapshotInput as bm, RuntimeContextOptimizationProfile as bn, RuntimeContextPressure as bo, RuntimeDefaultsSnapshot as bp, RuntimeToolExposureDecision as bq, RuntimeToolExposureMode as br, RuntimeToolExposurePlan as bs, RuntimeToolExposurePlanInput as bt, RuntimeToolExposureReason as bu, TodoItem as bv, TodoList as bw, TodoStatus as bx, ToolSideEffect as by, WorkflowHostPolicy as bz, BoundExtensionRuntimeController as c, CodingActorSessionOptions as e, CompactionAntiThrashConfig as f, CompactionAntiThrashState as g, CompactionSavingsDecision as h, CompactionSavingsSample as i, CompactionSkipReason as j, CreateBashPrefixExtractorOptions as k, ExtractCommandPrefixOptions as l, GoalCompleteResult as m, GoalCreateInput as n, GoalLifecycleContext as o, GoalRuntimeBinding as p, GoalRuntimeBindingDeps as q, GoalToolsContext as r, KodaXActorHost as s, KodaXAgentMode as t, KodaXAgentProfile as u, KodaXAgentScope as v, KodaXBudgetDisclosureZone as w, KodaXBudgetExtensionRequest as x, KodaXCanonicalAgentMode as y, KodaXChildAgentResult as z };

package/dist/types-chunks/{capability-learning.d-CVsdHw4j.d.ts → capability-learning.d-iPSiAmc_.d.ts}

@@ -1,4 +1,4 @@
-import { G as KodaXReasoningProfile } from './types.d-DIpZJKUl.js';
+import { H as KodaXReasoningProfile } from './types.d-CgrXrFrq.js';
 
 type CapabilityCacheSource = 'observed' | 'probed';
 interface CapabilityCacheEntry {

package/dist/types-chunks/{capsule.d-BlSv9l3V.d.ts → capsule.d-BuFJaYxA.d.ts}

@@ -1,5 +1,5 @@
-import { k as KodaXMessage } from './types.d-DIpZJKUl.js';
-import { ab as AgentMessage, d$ as SessionEntry, dZ as Session, e1 as SessionExtension, bU as KodaXSessionLineage, bF as KodaXJsonValue, aT as CompactionDetails, bs as KodaXCompactMemorySeed, bQ as KodaXSessionEntry, c2 as KodaXSessionTreeNode, bT as KodaXSessionLabelEntry, bS as KodaXSessionGoalEntry, bN as KodaXSessionClientNoticeEntry, b_ as KodaXSessionRewindMarkerEntry, bV as KodaXSessionMemoryOutcomeDigestEntry, bW as KodaXSessionMemoryReviewReceiptEntry, bZ as KodaXSessionNavigationOptions, bL as KodaXSessionArtifactLedgerEntry, bg as FileOperations, eJ as WorkflowMeta, eK as WorkflowModelHint, eL as WorkflowModule } from './types.d-BA-Jwpfs.js';
+import { k as KodaXMessage } from './types.d-CgrXrFrq.js';
+import { ae as AgentMessage, ea as SessionEntry, e8 as Session, ec as SessionExtension, c1 as KodaXSessionLineage, bO as KodaXJsonValue, aW as CompactionDetails, bB as KodaXCompactMemorySeed, bZ as KodaXSessionEntry, cb as KodaXSessionTreeNode, c0 as KodaXSessionLabelEntry, b$ as KodaXSessionGoalEntry, bW as KodaXSessionClientNoticeEntry, c7 as KodaXSessionRewindMarkerEntry, c2 as KodaXSessionMemoryOutcomeDigestEntry, c3 as KodaXSessionMemoryReviewReceiptEntry, c6 as KodaXSessionNavigationOptions, bU as KodaXSessionArtifactLedgerEntry, bj as FileOperations, eW as WorkflowMeta, eX as WorkflowModelHint, eY as WorkflowModule } from './controller.d-C2aHqzHj.js';
 
 /**
  * @kodax-ai/agent Constants
@@ -18,24 +18,15 @@ declare const KODAX_API_MIN_INTERVAL = 0.5;
 declare const PROMISE_PATTERN: RegExp;
 
 /**
- * @kodax-ai/agent Tokenizer
+ * Provider-neutral, non-blocking token estimation.
  *
- * Token 估算 - 使用 tiktoken 进行精确计算
+ * This intentionally avoids Provider-specific BPE vocabularies on the main
+ * runtime thread. Provider usage remains the authoritative context baseline;
+ * these estimates account for new messages and enforce protective budgets.
  */
 
-/**
- * 估算消息的 token 数量
- *
- * 精确计算包括：
- * - 消息结构开销（每条约 4 tokens）
- * - 角色标识
- * - 内容文本
- * - 工具调用和结果
- */
 declare function estimateTokens(messages: readonly KodaXMessage[]): number;
-/**
- * 计算单个文本的 token 数量（便捷函数）
- */
+/** Estimate a text value without loading a BPE vocabulary or token array. */
 declare function countTokens(text: string): number;
 
 /**
@@ -481,7 +472,7 @@ declare class LineageCompaction implements CompactionPolicy {
 
 /**
  * 生成会话 ID
- * 格式: YYYYMMDD_HHMMSS_<suffix>  (suffix = ms 低位 + 随机, base36)
+ * 格式: YYYYMMDD_HHMMSS_<suffix>  (suffix = ms base36 + 48-bit random hex)
  *
  * FEATURE_219 (v0.7.46): the date-prefix is preserved (sortable +
  * human-readable), but a per-call suffix makes the id GLOBALLY unique.
@@ -490,6 +481,8 @@ declare class LineageCompaction implements CompactionPolicy {
  * directory layout the same id could otherwise exist in two project folders
  * and make `loadSession(id)` ambiguous. See ADR-038 §7.
  */
+declare function generateSessionIdSync(): string;
+/** Preserve the established async public API for existing consumers. */
 declare function generateSessionId(): Promise<string>;
 /**
  * 从消息中提取标题
@@ -510,7 +503,7 @@ declare function createSessionLineage(messages: KodaXMessage[], previous?: KodaX
  *
  * Traversal stops safely if malformed data introduces a parent cycle.
  */
-declare function getSessionLineagePath(lineage: KodaXSessionLineage, targetId?: string | null): NavigableSessionEntry[];
+declare function getSessionLineagePath(lineage: KodaXSessionLineage, targetId?: string | null, checkpoint?: () => void): NavigableSessionEntry[];
 /**
  * Build the effective LLM-visible message context for the active lineage path.
  *
@@ -528,7 +521,7 @@ declare function getSessionMessagesFromLineage(lineage: KodaXSessionLineage, tar
 /**
  * Resolve an entry selector using either a direct entry id or the latest label.
  */
-declare function resolveSessionLineageTarget(lineage: KodaXSessionLineage, selector: string): NavigableSessionEntry | undefined;
+declare function resolveSessionLineageTarget(lineage: KodaXSessionLineage, selector: string, checkpoint?: () => void): NavigableSessionEntry | undefined;
 /**
  * Move the active leaf to a selected target, optionally appending a
  * branch-summary node that captures the abandoned path.
@@ -593,7 +586,7 @@ declare function applyLineageTruncation(lineage: KodaXSessionLineage | undefined
 declare function evictOldIslandMessageContent(lineage: KodaXSessionLineage): KodaXSessionLineage;
 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;
+declare function forkSessionLineage(lineage: KodaXSessionLineage, selector?: string, checkpoint?: () => void): KodaXSessionLineage | null;
 /**
  * Convert a lineage into a nested tree structure for UI presentation.
  */
@@ -768,5 +761,5 @@ declare function buildWorkflowCapsuleIntent(manifest: {
     readonly originalRequest?: string;
 }): WorkflowCapsuleIntent;
 
-export { createSessionLineage as $, DefaultSummaryCompaction as D, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, actorQueueId as N, 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, _resetActiveRootQueueRoutesForTests as _, createWorkflowCapsule as a0, createWorkflowModuleFromCapsule as a1, estimateTokens as a2, evictOldIslandMessageContent as a3, extractArtifactLedger as a4, extractFileOps as a5, extractTitleFromMessages as a6, findPreviousUserEntryId as a7, forkSessionLineage as a8, generateSessionId as a9, getAgentConfigHome as aa, getAgentConfigPath as ab, getAppDataDir as ac, getSessionLineagePath as ad, getSessionMessagesFromLineage as ae, isPathInsideDirectory as af, lintRestrictedWorkflowSource as ag, mergeArtifactLedger as ah, mergeFileOps as ai, registerActiveRootQueueRoute as aj, resolveActiveRootQueueRoute as ak, resolveExecutionPath as al, resolveSessionLineageTarget as am, rewindSessionLineage as an, setAgentConfigHome as ao, setSessionLineageActiveEntry as ap, validateAndFixToolHistory as aq, validateWorkflowCapsule as ar, validateWorkflowScriptManifest as as, 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 { createSessionLineage as $, DefaultSummaryCompaction as D, KODAX_API_MIN_INTERVAL as K, LINEAGE_ENTRY_TYPES as L, actorQueueId as N, 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, _resetActiveRootQueueRoutesForTests as _, createWorkflowCapsule as a0, createWorkflowModuleFromCapsule as a1, estimateTokens as a2, evictOldIslandMessageContent as a3, extractArtifactLedger as a4, extractFileOps as a5, extractTitleFromMessages as a6, findPreviousUserEntryId as a7, forkSessionLineage as a8, generateSessionId as a9, generateSessionIdSync as aa, getAgentConfigHome as ab, getAgentConfigPath as ac, getAppDataDir as ad, getSessionLineagePath as ae, getSessionMessagesFromLineage as af, isPathInsideDirectory as ag, lintRestrictedWorkflowSource as ah, mergeArtifactLedger as ai, mergeFileOps as aj, registerActiveRootQueueRoute as ak, resolveActiveRootQueueRoute as al, resolveExecutionPath as am, resolveSessionLineageTarget as an, rewindSessionLineage as ao, setAgentConfigHome as ap, setSessionLineageActiveEntry as aq, validateAndFixToolHistory as ar, validateWorkflowCapsule as as, validateWorkflowScriptManifest as at, 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 M, 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 };