@kodax-ai/kodax 0.7.77 → 0.7.79

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-pZdu6qt7.d.ts → bash-prefix-extractor.d-CNSidpmv.d.ts}

@@ -1,11 +1,11 @@
-import { bs as KodaXGoalState, a8 as AgentMessage, dv as StopHookFn, bM as KodaXSessionLineage, k as AgentActorStore, aC as AgentTurnExecutor, t as AgentBudgetPort, h as AgentActorClient, N as AgentExecutionResult, V as AgentExecutorPlaneBinding, by as KodaXJsonValue, bm as KodaXExtensionSessionRecord, f as Agent, dS as WorkflowIsolation, bn as KodaXExtensionSessionState, bD as KodaXSessionArtifactLedgerEntry, df as SessionErrorMetadata, bU as KodaXSessionScope, bV as KodaXSessionStorage, cj as MemoryContextIdentity, cv as MemoryPack, aK as AskUserQuestionOptions, aG as AskUserAnswer, aI as AskUserMultiOptions, dP as WorkflowEventCorrelation, aT as CompactionUpdate, e4 as WorkflowProcessEvent, dO as WorkflowEvent, cJ as MemoryReviewPlan, bA as KodaXMemoryOutcomeDigest, bb as Guardrail, aY as DiscoveredInstance, bw as KodaXInputArtifact, cK as MemoryReviewRunner } from './types.d-RdWRfUEs.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-DCQVBqVn.js';
+import { bI as KodaXGoalState, ae as AgentMessage, eq 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, eS as WorkflowIsolation, bD as KodaXExtensionSessionState, bU as KodaXSessionArtifactLedgerEntry, ea 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, eP as WorkflowEventCorrelation, a_ as CompactionUpdate, f4 as WorkflowProcessEvent, eO as WorkflowEvent, dC as MemoryReviewPlan, bR as KodaXMemoryOutcomeDigest, bl as Guardrail, b5 as DiscoveredInstance, bM as KodaXInputArtifact, dD as MemoryReviewRunner, eG as UnifiedLearningReviewRunner } from './controller.d-RGV7Pjv9.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-LanCEDj8.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 {
@@ -837,6 +838,9 @@ interface CodingActorSessionOptions {
     readonly store?: AgentActorStore;
     readonly executor?: AgentTurnExecutor;
     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 {
@@ -849,6 +853,9 @@ 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>;
     workflowOwnerSignal(ownerPath: string): AbortSignal;
     settleWorkflowOwner(ownerPath: string, state: 'completed' | 'failed' | 'interrupted', result: AgentExecutionResult & {
@@ -859,6 +866,8 @@ declare class CodingActorSession {
     registerTurnExecutor(key: string, executor: AgentTurnExecutor): () => void;
     waitForAgentCapacity(signal?: AbortSignal): Promise<boolean>;
     close(reason?: string): Promise<void>;
+    quiesce(reason?: string): Promise<void>;
+    disposeAfterStoreRemoval(reason?: string): void;
 }
 declare function createLocalCodingActorControl(parentCtx: KodaXToolExecutionContext, options: KodaXOptions): AgentActorClient;
 /** Runtime adapter for detached external Actor turns. The executor plane stays internal. */
@@ -871,7 +880,7 @@ declare function createExternalActorTurnExecutor(binding: AgentExecutorPlaneBind
  * configure / install / troubleshoot KodaX?" questions. Pure data + a
  * deterministic resolver — no RAG, no vector store, no network fetch.
  */
-type KodaXManualTopicId = 'overview' | 'license' | 'install' | 'quickstart' | 'providers' | 'custom-providers' | 'config' | 'permissions' | 'commands' | 'tools' | 'agents' | 'skills' | 'extensions' | 'mcp' | 'a2a' | 'repo-intelligence' | 'sessions' | 'compaction' | 'memory' | 'doctor' | 'sdk' | 'troubleshooting';
+type KodaXManualTopicId = 'overview' | 'license' | 'install' | 'quickstart' | 'providers' | 'custom-providers' | 'config' | 'permissions' | 'sandbox' | 'commands' | 'tools' | 'agents' | 'skills' | 'extensions' | 'mcp' | 'a2a' | 'repo-intelligence' | 'sessions' | 'compaction' | 'memory' | 'doctor' | 'sdk' | 'troubleshooting';
 /** A pointer to the code/doc the topic is derived from (for traceability). */
 interface KodaXManualSource {
     readonly label: string;
@@ -1687,6 +1696,25 @@ interface KodaXWorkflowAgentDigestEvent {
 interface KodaXToolEventMeta extends KodaXActivityEventMeta {
     readonly toolId?: string;
 }
+type KodaXShellSandboxBackend = 'windows-restricted-user' | 'macos-seatbelt' | 'linux-bubblewrap' | 'unsupported';
+type KodaXShellSandboxObservation = {
+    readonly version: 1;
+    readonly state: 'applied';
+    readonly backend: KodaXShellSandboxBackend;
+    readonly policyId: 'kodax-workspace-shell-v1';
+} | {
+    readonly version: 1;
+    readonly state: 'fallback';
+    readonly reason: 'not_ready' | 'prepare_failed' | 'backend_failed';
+    readonly execution: 'normal_permission_policy';
+} | {
+    readonly version: 1;
+    readonly state: 'not_selected';
+};
+interface KodaXToolSandboxObservationUpdate {
+    readonly id: string;
+    readonly observation: KodaXShellSandboxObservation;
+}
 interface KodaXContextCompactionFinishedEvent extends Partial<KodaXLiveEventMeta> {
     readonly source: 'manual' | 'automatic_threshold' | 'physical_capacity';
     readonly tokensBefore: number;
@@ -1806,6 +1834,11 @@ interface KodaXEvents {
         id: string;
         message: string;
     }, meta?: KodaXToolEventMeta) => void;
+    /**
+     * Execution metadata for professional hosts. REPL history intentionally does
+     * not render this internal containment state.
+     */
+    onToolSandboxObservation?: (update: KodaXToolSandboxObservationUpdate, meta?: KodaXToolEventMeta) => void;
     onToolInputDelta?: (toolName: string, partialJson: string, meta?: KodaXToolEventMeta) => void;
     onStreamEnd?: (meta?: KodaXActivityEventMeta) => void;
     /** Fired once when a child-agent run fully leaves the child executor. */
@@ -2035,12 +2068,17 @@ interface KodaXEvents {
     /** Semantic memory review plan produced from explicit user feedback. */
     onMemoryReview?: (plan: MemoryReviewPlan) => void;
     onMemoryNotice?: (notice: {
+        readonly sessionId?: string;
         readonly episodeId: string;
         readonly summaries: readonly string[];
         readonly proposalIds: readonly string[];
     }) => void;
-    onMemoryOutcomeDigest?: (digest: KodaXMemoryOutcomeDigest) => void;
+    onMemoryOutcomeDigest?: (digest: KodaXMemoryOutcomeDigest, metadata?: {
+        readonly jobId?: string;
+    }) => void;
     onMemoryReviewReceipt?: (receipt: {
+        readonly sessionId?: string;
+        readonly jobId?: string;
         readonly reviewKey: string;
         readonly proposalIds: readonly string[];
         readonly completedAt: string;
@@ -2093,7 +2131,10 @@ interface KodaXSessionOptions {
      * NOT also snapshot the session: `saveSessionSnapshot` early-returns so
      * the runner's flat full-rewrite `storage.save` can never race / clobber
      * the host's richer incremental writes (which regressed `activeEntryId`
-     * to the first round on resume).
+     * to the first round on resume). Context-silent protocol facts may use the
+     * host's optional atomic `storage.mutateLineage`; this never writes a stale
+     * full session snapshot. A host using F263 durable Memory review facts must
+     * provide that capability; those writes fail closed when it is absent.
      *
      * `storage` is still consulted for LOAD (resume / `resolveInitialMessages`
      * tier 2). When absent (print CLI, ACP, SDK headless), the runner remains
@@ -2729,7 +2770,41 @@ interface KodaXShellExecutionContract {
     };
     readonly probeTimeoutMs?: number;
 }
+interface KodaXShellSandboxPrepareInput {
+    readonly toolCallId?: string;
+    readonly toolInput: Readonly<Record<string, unknown>>;
+    readonly command: string;
+    readonly executable?: string;
+    readonly args?: readonly string[];
+    readonly cwd: string;
+    readonly env: NodeJS.ProcessEnv;
+    readonly windowsVerbatimArguments?: boolean;
+    /** Caller cancellation while waiting for sandbox admission/preparation. */
+    readonly signal?: AbortSignal;
+    /** Absolute wall-clock deadline shared with the command timeout. */
+    readonly deadlineAt?: number;
+    readonly reportObservation?: (observation: KodaXShellSandboxObservation) => void;
+}
+interface KodaXPreparedShellSandboxInvocation {
+    readonly executable: string;
+    readonly args: readonly string[];
+    readonly env: NodeJS.ProcessEnv;
+    readonly windowsVerbatimArguments?: boolean;
+    cleanup(): Promise<KodaXShellSandboxObservation | undefined>;
+}
+/** Runtime-owned OS sandbox broker for selected concrete shell calls. */
+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. */
     managedWorkBudget?: KodaXManagedWorkBudget;
     /** FEATURE_260 runtime-owned identity used for scoped memory reads. */
@@ -2787,6 +2862,8 @@ interface KodaXContextOptions {
     executionCwd?: string;
     /** Optional host-owned shell/environment resolution policy for command tools. */
     shellExecution?: KodaXShellExecutionContract;
+    /** Runtime-owned OS sandbox broker; never accepted from serialized model input. */
+    shellSandbox?: KodaXShellSandbox;
     /** Fail-closed host policy applied to every concrete file a read tool opens. */
     assertReadablePath?: (candidate: string) => void;
     /**
@@ -2827,6 +2904,30 @@ interface KodaXContextOptions {
     skillsPrompt?: string;
     /** Optional run-scoped registry used to pin and restrict Skill invocation. */
     skillRegistry?: ISkillRegistry;
+    /** Runtime-owned complete formal-name inventory used to prevent learned Skill shadowing. */
+    protectedFormalSkillNames?: readonly string[];
+    /**
+     * Opaque root-run binding used to correlate learned Skill usage with the
+     * exact Memory episode produced by that run.
+     *
+     * @internal
+     */
+    learnedSkillBindingId?: string;
+    /** Runtime-owner admission for exact learned Skill revisions. */
+    admitLearnedSkillInvocation?: (input: {
+        readonly sessionId: string;
+        readonly capabilityId: string;
+        readonly revision: number;
+        readonly fingerprint: string;
+    }) => Promise<{
+        readonly invocationId: string;
+    }>;
+    /** Runtime-owner outcome correlation for learned Skill canaries. */
+    completeLearnedSkillOutcomes?: (input: {
+        readonly sessionId: string;
+        readonly outcome: 'verified_success' | 'credible_negative' | 'inconclusive';
+        readonly evidenceRefs: readonly string[];
+    }) => Promise<void>;
     /** Remote-runtime broker for explicitly admitted, OS-sandboxed Skill scripts. */
     skillScriptRunner?: KodaXSkillScriptRunner;
     rawUserInput?: string;
@@ -3020,6 +3121,8 @@ interface KodaXOptions {
     context?: KodaXContextOptions;
     events?: KodaXEvents;
     memoryReviewer?: MemoryReviewRunner;
+    /** One-call F263 reviewer. When present it replaces the memory-only reviewer for episode jobs. */
+    learningReviewer?: UnifiedLearningReviewRunner;
     /** Optional host-owned semantic selector for sparse governed memory interventions. */
     memoryRecallRunner?: MemoryRecallRunner;
     extensionRuntime?: ExtensionRuntimeContract;
@@ -3073,6 +3176,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;
     /**
@@ -3115,6 +3220,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
@@ -3380,6 +3489,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. */
@@ -3387,6 +3498,24 @@ interface KodaXToolExecutionContext {
         readonly content: string;
         readonly evidenceRefs: readonly string[];
     } | undefined>;
+    /**
+     * Root-session-only submission channel for explicit user Memory intent.
+     * The host validates an exact current-user quote and captures one intent for
+     * end-of-episode governed submission; this callback never creates a durable
+     * review job or writes Memory directly.
+     */
+    memoryIntent?: (input: {
+        readonly operation: 'remember' | 'correct';
+        readonly statement: string;
+        readonly userQuote: string;
+    }) => Promise<{
+        readonly status: 'captured';
+        readonly operation: 'remember' | 'correct';
+        readonly evidenceRef: string;
+    } | {
+        readonly status: 'rejected';
+        readonly reason: string;
+    }>;
     /** Exact persisted history loader for the current root or isolated worker Session. */
     loadSessionHistory?: () => Promise<KodaXSessionLineage | null>;
     /** Git root directory - Git 鏍圭洰褰?*/
@@ -3427,12 +3556,20 @@ interface KodaXToolExecutionContext {
     skillDynamicContext?: KodaXSkillDynamicContextPolicy;
     /** Runtime-bound Skill registry; avoids process-global cross-session drift. */
     skillRegistry?: ISkillRegistry;
+    /** Runtime-owner admission for exact learned Skill revisions. */
+    admitLearnedSkillInvocation?: KodaXContextOptions['admitLearnedSkillInvocation'];
     /** Present only when the host admitted exact Skill scripts for this run. */
     skillScriptRunner?: KodaXSkillScriptRunner;
     /** Working directory used to resolve relative paths and execute shell commands. */
     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. */
+    reportToolSandboxObservation?: (observation: KodaXShellSandboxObservation) => void;
     /**
      * Exact credential variable names owned by registered Providers.
      * Used only to remove non-standard `apiKeyEnv` names from child processes.
@@ -3522,6 +3659,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;
@@ -3881,5 +4020,5 @@ interface CreateBashPrefixExtractorOptions {
  */
 declare function createBashPrefixExtractor(opts: CreateBashPrefixExtractorOptions): BashPrefixExtractor;
 
-export { ALWAYS_RESIDENT_TOOL_NAMES as A, BASH_POLICY_SPEC as B, LSP_SERVERS as aW, LspService as aY, buildGoalRuntimeBinding as bC, consumeCompactionCooldown as bD, createBashPrefixExtractor as bE, createCompactionAntiThrashState as bF, createExternalActorTurnExecutor as bG, createLocalCodingActorControl as bH, createRuntimeContextBudgetSnapshot as bI, decideWorkflowInvocation as bJ, drainPendingSwaps as bK, estimateToolSchemaTokens as bL, extractCommandPrefix as bM, getDefaultLspService as bN, hasExplicitNaturalLanguageWorkflowIntent as bO, hasPendingSwap as bP, makeDisabledGoalToolsContext as bQ, normalizeKodaXAgentMode as bR, planToolExposure as bS, providerResilienceConfigFromTimeouts as bT, recordCompactionSavings as bU, resolveConstructedAgent as bV, shouldSkipLlmCompaction as bW, shutdownDefaultLspService as bX, withGoalBeforeNextTurn as bY, withGoalStopHook as bZ, workflowStartOutcomeConsumesTurn as b_, 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, ProviderRecoveryEvent as a$, KodaXMemoryStrategy as a0, KodaXOptions as a1, KodaXOrchestrationVerdict as a2, KodaXParentReductionContract as a3, KodaXPromptCacheDiagnosticEvent as a4, KodaXProviderPolicyHints as a5, KodaXRepoIntelligenceCapability as a6, KodaXRepoIntelligenceMode as a7, KodaXRepoIntelligenceResolvedMode as a8, KodaXRepoIntelligenceTrace as a9, KodaXTaskRole as aA, KodaXTaskRoleAssignment as aB, KodaXTaskStatus as aC, KodaXTaskSurface as aD, KodaXTaskToolPolicy as aE, KodaXTaskVerificationContract as aF, KodaXTaskVerificationCriterion as aG, KodaXTaskWorkItem as aH, KodaXTimeoutConfig as aI, KodaXToolEventMeta as aJ, KodaXToolExecutionContext as aK, KodaXToolVisibilityMeta as aL, KodaXToolVisibilityPolicy as aM, KodaXTurnCompletedEvent as aN, KodaXTurnDeliveryKind as aO, KodaXTurnFailedEvent as aP, KodaXTurnStartedEvent as aQ, KodaXVerificationScorecard as aR, KodaXVerificationScorecardCriterion as aS, KodaXWorkflowAgentDigestEvent as aT, KodaXWorkflowEventMeta as aU, KodaXWorkflowTimeoutConfig as aV, LspServerInfo as aX, LspServiceConfig as aZ, ProviderExecutionState as a_, KodaXRepoIntelligenceTraceEvent as aa, KodaXRepoRoutingSignals as ab, KodaXResult as ac, KodaXRoleRoundSummary as ad, KodaXRuntimeVerificationContract as ae, KodaXSelfManualConfig as af, KodaXSessionControl as ag, KodaXSessionMutators as ah, KodaXSessionOptions as ai, KodaXShellExecutionContract as aj, KodaXShellKind as ak, KodaXShellProfileMode as al, KodaXSidecarMessageEvent as am, KodaXSkillDynamicContextPolicy as an, KodaXSkillInvocationContext as ao, KodaXSkillMap as ap, KodaXSkillProjectionConfidence as aq, KodaXSkillScriptInputFile as ar, KodaXSkillScriptOutputFile as as, KodaXSkillScriptRunInput as at, KodaXSkillScriptRunner as au, KodaXTaskCapabilityHint as av, KodaXTaskContract as aw, KodaXTaskEvidenceArtifact as ax, KodaXTaskEvidenceBundle as ay, KodaXTaskEvidenceEntry as az, BashPrefixResult as b, ProviderResilienceConfig as b0, ProviderResiliencePolicy as b1, RecoveryAction as b2, RecoveryDecision as b3, RecoveryLadderStep as b4, RecoveryResult as b5, ResilienceClassification as b6, ResilienceErrorClass as b7, ResolveKodaXManualInput as b8, ResolveKodaXManualOptions as b9, WorkflowToolHostResult as bA, WorkflowToolHostStartResult as bB, ResolveKodaXManualResult as ba, RuntimeCompactionSkippedEvent as bb, RuntimeContextBudgetBreakdown as bc, RuntimeContextBudgetRecommendation as bd, RuntimeContextBudgetSnapshot as be, RuntimeContextBudgetSnapshotInput as bf, RuntimeContextOptimizationProfile as bg, RuntimeContextPressure as bh, RuntimeDefaultsSnapshot as bi, RuntimeToolExposureDecision as bj, RuntimeToolExposureMode as bk, RuntimeToolExposurePlan as bl, RuntimeToolExposurePlanInput as bm, RuntimeToolExposureReason as bn, TodoItem as bo, TodoList as bp, TodoStatus as bq, ToolSideEffect as br, WorkflowHostPolicy as bs, WorkflowInvocationAction as bt, WorkflowInvocationPolicyDecision as bu, WorkflowInvocationPolicyInput as bv, WorkflowInvocationSource as bw, WorkflowStartOutcome as bx, WorkflowToolHost as by, WorkflowToolHostInlineInput 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-CxCm1KZz.d.ts → capsule.d-B3q98pLQ.d.ts}

@@ -1,5 +1,5 @@
-import { k as KodaXMessage } from './types.d-DIpZJKUl.js';
-import { a8 as AgentMessage, de as SessionEntry, dc as Session, dg as SessionExtension, bM as KodaXSessionLineage, by as KodaXJsonValue, aP as CompactionDetails, bl as KodaXCompactMemorySeed, bI as KodaXSessionEntry, bW as KodaXSessionTreeNode, bL as KodaXSessionLabelEntry, bK as KodaXSessionGoalEntry, bF as KodaXSessionClientNoticeEntry, bS as KodaXSessionRewindMarkerEntry, bN as KodaXSessionMemoryOutcomeDigestEntry, bO as KodaXSessionMemoryReviewReceiptEntry, bR as KodaXSessionNavigationOptions, bD as KodaXSessionArtifactLedgerEntry, b9 as FileOperations, dV as WorkflowMeta, dW as WorkflowModelHint, dX as WorkflowModule } from './types.d-RdWRfUEs.js';
+import { k as KodaXMessage } from './types.d-CgrXrFrq.js';
+import { ae as AgentMessage, e9 as SessionEntry, e7 as Session, eb 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, eV as WorkflowMeta, eW as WorkflowModelHint, eX as WorkflowModule } from './controller.d-RGV7Pjv9.js';
 
 /**
  * @kodax-ai/agent Constants
@@ -481,7 +481,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 +490,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 +512,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 +530,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 +595,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 +770,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 };