@kodax-ai/kodax 0.7.87 → 0.7.88

package/dist/types-chunks/{bash-prefix-extractor.d-B36OQwNA.d.ts → bash-prefix-extractor.d-DcHi4vz5.d.ts}

@@ -1,7 +1,7 @@
-import { V as KodaXGoalState, ab as KodaXSessionLineage, g as AgentActorStore, K as AgentTurnExecutor, l as AgentBudgetPort, b as AgentActorOwner, a as AgentActorClient, t as AgentExecutionResult, Y as KodaXJsonValue, Q as KodaXExtensionSessionRecord, R as KodaXExtensionSessionState, a2 as KodaXSessionArtifactLedgerEntry, ba as SessionErrorMetadata, aj as KodaXSessionScope, ak as KodaXSessionStorage, aE as MemoryContextIdentity, aQ as MemoryPack, b4 as MemoryReviewPlan, $ as KodaXMemoryOutcomeDigest, b5 as MemoryReviewRunner } from './types.d-sW-OqiFt.js';
+import { Z as KodaXGoalState, af as KodaXSessionLineage, k as AgentActorStore, O as AgentTurnExecutor, p as AgentBudgetPort, b as AgentActorOwner, a as AgentActorClient, x as AgentExecutionResult, a0 as KodaXJsonValue, U as KodaXExtensionSessionRecord, V as KodaXExtensionSessionState, a6 as KodaXSessionArtifactLedgerEntry, be as SessionErrorMetadata, an as KodaXSessionScope, ao as KodaXSessionStorage, aI as MemoryContextIdentity, aU as MemoryPack, b8 as MemoryReviewPlan, a3 as KodaXMemoryOutcomeDigest, b9 as MemoryReviewRunner } from './types.d-BSFS8--Y.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-CK9A9rpP.js';
-import { P as AgentMessage, ct as StopHookFn, o as AgentControllerHealth, G as AgentExecutorPlaneBinding, f as Agent, cV as WorkflowIsolation, aN as GuardrailPermissionIntent, ac as AskUserQuestionOptions, a8 as AskUserAnswer, aa as AskUserMultiOptions, cS as WorkflowEventCorrelation, am as CompactionUpdate, d7 as WorkflowProcessEvent, cR as WorkflowEvent, aJ as Guardrail, at as DiscoveredInstance, a$ as KodaXInputArtifact, cJ as UnifiedLearningReviewRunner } from './controller.d-Dif9pbC9.js';
+import { P as AgentMessage, ct as StopHookFn, o as AgentControllerHealth, G as AgentExecutorPlaneBinding, f as Agent, cV as WorkflowIsolation, aN as GuardrailPermissionIntent, ac as AskUserQuestionOptions, a8 as AskUserAnswer, aa as AskUserMultiOptions, cS as WorkflowEventCorrelation, am as CompactionUpdate, d7 as WorkflowProcessEvent, cR as WorkflowEvent, aJ as Guardrail, at as DiscoveredInstance, a$ as KodaXInputArtifact, cJ as UnifiedLearningReviewRunner } from './controller.d-C-GjOuPV.js';
 import { d as SkillDynamicContextExecutor, I as ISkillRegistry } from './types.d-BSPlmJqf.js';
 import { K as KodaXLlmTimeoutConfig, a as CostTracker } from './cost-tracker.d-BeaenODW.js';
 import { p as MemoryRecallRunner } from './types-PHjfwebT.js';

package/dist/types-chunks/{capsule.d-DEncDNzD.d.ts → capsule.d-CjNNucoy.d.ts}

@@ -1,6 +1,6 @@
 import { k as KodaXMessage } from './types.d-CK9A9rpP.js';
-import { P as AgentMessage, cd as SessionEntry, cb as Session, ce as SessionExtension, ai as CompactionDetails, aH as FileOperations, cY as WorkflowMeta, cZ as WorkflowModelHint, c_ as WorkflowModule } from './controller.d-Dif9pbC9.js';
-import { ab as KodaXSessionLineage, Y as KodaXJsonValue, P as KodaXCompactMemorySeed, a7 as KodaXSessionEntry, al as KodaXSessionTreeNode, aa as KodaXSessionLabelEntry, a9 as KodaXSessionGoalEntry, a4 as KodaXSessionClientNoticeEntry, ah as KodaXSessionRewindMarkerEntry, ac as KodaXSessionMemoryOutcomeDigestEntry, ad as KodaXSessionMemoryReviewReceiptEntry, ag as KodaXSessionNavigationOptions, a2 as KodaXSessionArtifactLedgerEntry } from './types.d-sW-OqiFt.js';
+import { P as AgentMessage, cd as SessionEntry, cb as Session, ce as SessionExtension, ai as CompactionDetails, aH as FileOperations, cY as WorkflowMeta, cZ as WorkflowModelHint, c_ as WorkflowModule } from './controller.d-C-GjOuPV.js';
+import { af as KodaXSessionLineage, a0 as KodaXJsonValue, T as KodaXCompactMemorySeed, ab as KodaXSessionEntry, ap as KodaXSessionTreeNode, ae as KodaXSessionLabelEntry, ad as KodaXSessionGoalEntry, a8 as KodaXSessionClientNoticeEntry, al as KodaXSessionRewindMarkerEntry, ag as KodaXSessionMemoryOutcomeDigestEntry, ah as KodaXSessionMemoryReviewReceiptEntry, ak as KodaXSessionNavigationOptions, a6 as KodaXSessionArtifactLedgerEntry } from './types.d-BSFS8--Y.js';
 
 /**
  * @kodax-ai/agent Constants

package/dist/types-chunks/{controller.d-C1YdP_pQ.d.ts → controller.d-BcUJlVOt.d.ts}

@@ -1,4 +1,4 @@
-import { aE as MemoryContextIdentity, aM as MemoryItemRef, ab as KodaXSessionLineage, a2 as KodaXSessionArtifactLedgerEntry, aI as MemoryEvent, b5 as MemoryReviewRunner, aP as MemoryManagementController, au as MemoryActionProposal, ax as MemoryApplyResult, aX as MemoryRejectResult, aV as MemoryRefFilter, aC as MemoryBodySnapshot, aY as MemoryRememberInput, aZ as MemoryRememberResult, aO as MemoryLifecycleOperationResult, aG as MemoryCuratorInput, aL as MemoryGovernanceReport, aA as MemoryAutoCuratorInput, aB as MemoryAutoCuratorResult, aS as MemoryPackInput, aQ as MemoryPack, b0 as MemoryReviewInput, b4 as MemoryReviewPlan, $ as KodaXMemoryOutcomeDigest, b1 as MemoryReviewModelInput, aH as MemoryEpisodeReviewResult } from './types.d-sW-OqiFt.js';
+import { aI as MemoryContextIdentity, aQ as MemoryItemRef, af as KodaXSessionLineage, a6 as KodaXSessionArtifactLedgerEntry, aM as MemoryEvent, b9 as MemoryReviewRunner, aT as MemoryManagementController, ay as MemoryActionProposal, aB as MemoryApplyResult, a$ as MemoryRejectResult, aZ as MemoryRefFilter, aG as MemoryBodySnapshot, b0 as MemoryRememberInput, b1 as MemoryRememberResult, aS as MemoryLifecycleOperationResult, aK as MemoryCuratorInput, aP as MemoryGovernanceReport, aE as MemoryAutoCuratorInput, aF as MemoryAutoCuratorResult, aW as MemoryPackInput, aU as MemoryPack, b4 as MemoryReviewInput, b8 as MemoryReviewPlan, a3 as KodaXMemoryOutcomeDigest, b5 as MemoryReviewModelInput, aL as MemoryEpisodeReviewResult } from './types.d-BSFS8--Y.js';
 
 interface CreateMemoryControlPlaneOptions {
     readonly cwd: string;

package/dist/types-chunks/{controller.d-Dif9pbC9.d.ts → controller.d-C-GjOuPV.d.ts}

@@ -1,5 +1,5 @@
 import { a2 as KodaXToolDefinition, k as KodaXMessage, G as KodaXReasoningMode, aa as KodaXWireReasoningEffort, a4 as KodaXToolResultContentItem, Z as KodaXThinkingBlock, J as KodaXRedactedThinkingBlock } from './types.d-CK9A9rpP.js';
-import { b1 as MemoryReviewModelInput, $ as KodaXMemoryOutcomeDigest, b4 as MemoryReviewPlan, P as KodaXCompactMemorySeed, a2 as KodaXSessionArtifactLedgerEntry, m as AgentCapabilities, K as AgentTurnExecutor, s as AgentExecutionKind, l as AgentBudgetPort, g as AgentActorStore, b as AgentActorOwner, p as AgentEvent, z as AgentMailboxMessage, a as AgentActorClient, t as AgentExecutionResult, H as AgentSpawnInput, C as AgentMutationOptions, L as AgentTurnRef, n as AgentDataClassification, B as AgentMetadataValue, u as AgentFollowupResult, w as AgentInterruptScope, I as AgentTreeSnapshot, o as AgentDetail, D as AgentOutput } from './types.d-sW-OqiFt.js';
+import { b5 as MemoryReviewModelInput, a3 as KodaXMemoryOutcomeDigest, b8 as MemoryReviewPlan, T as KodaXCompactMemorySeed, a6 as KodaXSessionArtifactLedgerEntry, q as AgentCapabilities, O as AgentTurnExecutor, w as AgentExecutionKind, p as AgentBudgetPort, k as AgentActorStore, b as AgentActorOwner, t as AgentEvent, E as AgentMailboxMessage, a as AgentActorClient, x as AgentExecutionResult, L as AgentSpawnInput, G as AgentMutationOptions, P as AgentTurnRef, r as AgentDataClassification, F as AgentMetadataValue, y as AgentFollowupResult, B as AgentInterruptScope, M as AgentTreeSnapshot, s as AgentDetail, H as AgentOutput } from './types.d-BSFS8--Y.js';
 
 /**
  * Layer A Primitive: Agent / Handoff / Guardrail / AgentReasoningProfile
@@ -3812,6 +3812,8 @@ declare class AgentActorController {
     private readonly now;
     private readonly admissionScope;
     private mutationTail;
+    private activeMutationSaveAttempt?;
+    private readonly mutationSaveAttemptWaiters;
     private activeProgress?;
     private progressMutation?;
     private progressDrainScheduled;
@@ -3908,6 +3910,11 @@ declare class AgentActorController {
     private requireCommittedControl;
     private installRoot;
     private mutate;
+    private setActiveMutationSaveAttempt;
+    private clearActiveMutationSaveAttempt;
+    private waitForActiveMutationSaveAttempt;
+    private waitForPhaseAwareMutationHead;
+    private waitForPhaseAwareSaveAttemptCanonical;
     private snapshot;
     private restore;
     private republishUnacknowledgedRootCompletions;

package/dist/types-chunks/{guardrail.d-DhpnJv4Y.d.ts → guardrail.d-BuI5uypW.d.ts}

@@ -1,10 +1,10 @@
 import { b as McpServersConfig, M as McpConnectMode, a as McpServerConfig, c as McpTransportKind } from './config.d-CJy1WENT.js';
 import { K as KodaXBaseProvider } from './base.d-vopO1rml.js';
 import { a as CostTracker } from './cost-tracker.d-BeaenODW.js';
-import { c5 as RunnerToolCall, cB as ToolGuardrail } from './controller.d-Dif9pbC9.js';
+import { c5 as RunnerToolCall, cB as ToolGuardrail } from './controller.d-C-GjOuPV.js';
 import { k as KodaXMessage } from './types.d-CK9A9rpP.js';
 import { S as SideQueryDiagnostics } from './side-query.d-iH0P9ASy.js';
-import { bB as ToolSideEffect } from './bash-prefix-extractor.d-B36OQwNA.js';
+import { bB as ToolSideEffect } from './bash-prefix-extractor.d-DcHi4vz5.js';
 
 /**
  * FEATURE_200 Phase F (v0.7.45) — MCP domain types extracted from types.ts.
@@ -618,6 +618,12 @@ interface AutoModeSharedState {
 type AutoModeAskUserVerdict = 'allow' | 'block' | 'timeout';
 interface AutoModeDecisionDiagnostics {
     readonly source: 'classifier_confirm' | 'classifier_failure' | 'classifier_circuit_breaker' | 'configuration';
+    /**
+     * Bounded (≤512 chars) decision-rationale summary for display surfaces
+     * (permission prompts). Same text the guardrail already passes as the ask
+     * reason; never prompt content or raw response body.
+     */
+    readonly reason?: string;
     readonly classifierFailureKind?: ClassifierFailureKind;
     readonly classifierAttempts?: readonly ClassifierAttemptDiagnostics[];
 }

package/dist/types-chunks/{history-retrieval.d-YJQpQt7h.d.ts → history-retrieval.d-BjJTJtKF.d.ts}

@@ -1,5 +1,5 @@
 import { k as KodaXMessage } from './types.d-CK9A9rpP.js';
-import { ab as KodaXSessionLineage } from './types.d-sW-OqiFt.js';
+import { af as KodaXSessionLineage } from './types.d-BSFS8--Y.js';
 
 type KodaXSessionHistoryScope = 'compacted' | 'all';
 type KodaXSessionHistorySource = 'user' | 'assistant' | 'system' | 'tool' | 'child_task';

package/dist/types-chunks/{public-api.d-D4q3WxKq.d.ts → public-api.d-hYcrNiNt.d.ts}

@@ -1,7 +1,7 @@
-import { a as BashPrefixExtractor, t as KodaXAgentMode } from './bash-prefix-extractor.d-B36OQwNA.js';
+import { a as BashPrefixExtractor, t as KodaXAgentMode } from './bash-prefix-extractor.d-DcHi4vz5.js';
 import { G as KodaXReasoningMode, k as KodaXMessage, T as KodaXTaskResultMetadata } from './types.d-CK9A9rpP.js';
-import { bF as LearningSurfaceSnapshot$1, bA as LearningQuery, bz as LearningPage, bc as LearnedCapabilityRecord, bv as LearningEvent, bE as LearningSubscribeOptions, aj as CompactionReport } from './controller.d-Dif9pbC9.js';
-import { a6 as KodaXSessionData, ab as KodaXSessionLineage, ag as KodaXSessionNavigationOptions, ai as KodaXSessionRuntimeInfo, ak as KodaXSessionStorage, a7 as KodaXSessionEntry, a2 as KodaXSessionArtifactLedgerEntry, Q as KodaXExtensionSessionRecord, am as KodaXSessionUiHistoryItem, aj as KodaXSessionScope, c as AgentActorSnapshot, Y as KodaXJsonValue } from './types.d-sW-OqiFt.js';
+import { bF as LearningSurfaceSnapshot$1, bA as LearningQuery, bz as LearningPage, bc as LearnedCapabilityRecord, bv as LearningEvent, bE as LearningSubscribeOptions, aj as CompactionReport } from './controller.d-C-GjOuPV.js';
+import { aa as KodaXSessionData, af as KodaXSessionLineage, ak as KodaXSessionNavigationOptions, am as KodaXSessionRuntimeInfo, ao as KodaXSessionStorage, ab as KodaXSessionEntry, a6 as KodaXSessionArtifactLedgerEntry, U as KodaXExtensionSessionRecord, aq as KodaXSessionUiHistoryItem, an as KodaXSessionScope, g as AgentActorSnapshot, c as AgentActorSaveAttempt, a0 as KodaXJsonValue } from './types.d-BSFS8--Y.js';
 
 /**
  * TextBuffer - Text buffer management class - 文本缓冲区管理类
@@ -1058,6 +1058,7 @@ type SessionLocationTraversalBoundary = {
     readonly topologyMutationBefore: boolean;
 };
 declare class FileSessionStorage implements KodaXSessionStorage {
+    readonly actorSnapshotEligibilityTimeoutMs: number;
     private readonly sessionsDir;
     private readonly configHome;
     private readonly sessionLocations;
@@ -1152,7 +1153,7 @@ declare class FileSessionStorage implements KodaXSessionStorage {
     private readArchivedEntries;
     private completeConversationLineage;
     private appendIslandArchive;
-    /** Write `<dir>/project.json` once per process per directory (best-effort). */
+    /** Create `<dir>/project.json` without ever writing through a conflicting identity. */
     private ensureProjectJson;
     private rebuildConversationCache;
     private updateConversationCacheAfterAppend;
@@ -1176,6 +1177,8 @@ declare class FileSessionStorage implements KodaXSessionStorage {
     */
     createGenerated(id: string, data: SessionData): Promise<void>;
     mutateLineage(id: string, mutation: (lineage: KodaXSessionLineage) => KodaXSessionLineage): Promise<boolean>;
+    /** Phase-aware Actor CAS save; canonical success is observable before cache maintenance. */
+    beginActorSnapshotSave(id: string, snapshot: AgentActorSnapshot, expectedRevision: number): AgentActorSaveAttempt;
     /** F270/F269 owner mutation: CAS-update only the Actor section of a session snapshot. */
     saveActorSnapshot(id: string, snapshot: AgentActorSnapshot, expectedRevision: number): Promise<void>;
     /** Read Session data without recovery writes or append-watermark mutation. */
@@ -1193,6 +1196,7 @@ declare class FileSessionStorage implements KodaXSessionStorage {
     readFullSnapshot(id: string, options?: SessionReadOptions): Promise<SessionReadSnapshot | null>;
     private readFullSnapshotAtPath;
     load(id: string): Promise<SessionData | null>;
+    has(id: string): Promise<boolean>;
     isArchived(id: string): Promise<boolean>;
     getLineage(id: string): Promise<KodaXSessionLineage | null>;
     loadFullLineage(id: string): Promise<KodaXSessionLineage | null>;
@@ -1244,6 +1248,7 @@ declare class FileSessionStorage implements KodaXSessionStorage {
     archiveOwned(id: string, ownerId: string): Promise<boolean>;
     private sessionConversationCacheMainPaths;
     private removeSessionConversationCaches;
+    private removeResumeMembership;
     private archiveWithActorOwner;
     /** Restore an archived session back into its project directory. */
     unarchive(id: string): Promise<boolean>;

package/dist/types-chunks/{repl.d-D4ye29Kk.d.ts → repl.d-DSQdq_FY.d.ts}

@@ -1,8 +1,8 @@
-import { n as ResolvedAutoModeSettings, b as CommandDefinition, e as CommandSource, c as CommandInfo, C as Command$1, I as InteractiveContext, a as CommandCallbacks, g as CurrentConfig, d as CommandInvocationRequest, f as CommandWorkflowInvocationRequest, p as RuntimeSurfaceStatus } from './utils.d-B65ozSTV.js';
-import { ae as SessionStorage$1, S as PermissionMode, L as LearningBinding } from './public-api.d-D4q3WxKq.js';
-import { a4 as KodaXOptions, ag as KodaXResult } from './bash-prefix-extractor.d-B36OQwNA.js';
-import { ak as KodaXSessionStorage, a6 as KodaXSessionData } from './types.d-sW-OqiFt.js';
-import { t as AutoModeStats } from './guardrail.d-DhpnJv4Y.js';
+import { n as ResolvedAutoModeSettings, b as CommandDefinition, e as CommandSource, c as CommandInfo, C as Command$1, I as InteractiveContext, a as CommandCallbacks, g as CurrentConfig, d as CommandInvocationRequest, f as CommandWorkflowInvocationRequest, p as RuntimeSurfaceStatus } from './utils.d-CeM3tG-E.js';
+import { ae as SessionStorage$1, S as PermissionMode, L as LearningBinding } from './public-api.d-hYcrNiNt.js';
+import { a4 as KodaXOptions, ag as KodaXResult } from './bash-prefix-extractor.d-DcHi4vz5.js';
+import { ao as KodaXSessionStorage, aa as KodaXSessionData } from './types.d-BSFS8--Y.js';
+import { t as AutoModeStats } from './guardrail.d-BuI5uypW.js';
 
 interface ReplRuntimePermissionGrantSuggestion {
     readonly id: string;

package/dist/types-chunks/{review-inbox.d-C1_xZ-yg.d.ts → review-inbox.d-D2EtBlPt.d.ts}

@@ -1,4 +1,4 @@
-import { $ as KodaXMemoryOutcomeDigest, aE as MemoryContextIdentity } from './types.d-sW-OqiFt.js';
+import { a3 as KodaXMemoryOutcomeDigest, aI as MemoryContextIdentity } from './types.d-BSFS8--Y.js';
 
 interface PendingEpisodeReviewV1 {
     readonly version: 1;

package/dist/types-chunks/{run-manager.d-D30IvnwV.d.ts → run-manager.d-i7Q30bns.d.ts}

@@ -1,4 +1,4 @@
-import { dj as WorkflowProcessTrackerOptions, cR as WorkflowEvent, dd as WorkflowProcessSnapshot, d7 as WorkflowProcessEvent } from './controller.d-Dif9pbC9.js';
+import { dj as WorkflowProcessTrackerOptions, cR as WorkflowEvent, dd as WorkflowProcessSnapshot, d7 as WorkflowProcessEvent } from './controller.d-C-GjOuPV.js';
 
 /**
  * FEATURE_246 Part A0 (ADR-046) — neutral workflow run lifecycle manager.

package/dist/types-chunks/{sdk-session-DIU6sHa2.d.ts → sdk-session-CAL2IZsM.d.ts}

@@ -1,6 +1,6 @@
-import { h as CreatableHistoryItem, ar as ToolCall } from './public-api.d-D4q3WxKq.js';
+import { h as CreatableHistoryItem, ar as ToolCall } from './public-api.d-hYcrNiNt.js';
 import { k as KodaXMessage, c as KodaXContentBlock } from './types.d-CK9A9rpP.js';
-import { am as KodaXSessionUiHistoryItem, aq as KodaXSessionUiToolCall } from './types.d-sW-OqiFt.js';
+import { aq as KodaXSessionUiHistoryItem, au as KodaXSessionUiToolCall } from './types.d-BSFS8--Y.js';
 
 interface RestoreHistoryItemsFromSessionInput {
     messages: readonly KodaXMessage[];

package/dist/types-chunks/{shell-command-sets.d-rIHkZ_VR.d.ts → shell-command-sets.d-BLjNQYPi.d.ts}

@@ -1,4 +1,4 @@
-import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-B36OQwNA.js';
+import { a as BashPrefixExtractor } from './bash-prefix-extractor.d-DcHi4vz5.js';
 
 /**
  * Permission Utilities

package/dist/types-chunks/{types.d-sW-OqiFt.d.ts → types.d-BSFS8--Y.d.ts}

@@ -244,10 +244,41 @@ interface AgentActorSnapshotV2 extends AgentActorSnapshotContents {
     readonly owner?: AgentActorOwner;
 }
 type AgentActorSnapshot = AgentActorSnapshotV1 | AgentActorSnapshotV2;
+type AgentActorSavePhase = 'queued' | 'precommit' | 'commit_inflight' | 'committed' | 'not_committed';
+type AgentActorSaveTiming = 'storageQueue' | 'fileLock' | 'readCas' | 'lineage' | 'topology' | 'tempWrite' | 'fsync' | 'rename' | 'postCommit' | 'total';
+interface AgentActorSaveDiagnostics {
+    readonly attemptId: string;
+    readonly phase: AgentActorSavePhase;
+    readonly activeStage?: AgentActorSaveTiming;
+    readonly activeStageElapsedMs?: number;
+    readonly failedStage?: AgentActorSaveTiming;
+    readonly canonicalOutcome?: 'pending' | 'committed' | 'committed_by_readback' | 'not_committed' | 'ambiguous';
+    readonly completionOutcome?: 'pending' | 'succeeded' | 'failed';
+    readonly timingsMs: Readonly<Partial<Record<AgentActorSaveTiming, number>>>;
+}
+/** One storage-neutral Actor snapshot attempt with an explicit canonical boundary. */
+interface AgentActorSaveAttempt {
+    /** Resolves after the process-local storage queue admits this attempt. */
+    readonly dequeued: Promise<void>;
+    /** Resolves after storage queueing and writer admission, before canonical preparation. */
+    readonly eligible: Promise<void>;
+    /** Resolves when the Actor snapshot is canonical; rejects before or during commit. */
+    readonly canonical: Promise<void>;
+    /** Full cache/watermark/topology maintenance completion for legacy callers and diagnostics. */
+    readonly completion: Promise<void>;
+    phase(): AgentActorSavePhase;
+    /** Prevents a queued/precommit attempt from ever entering canonical commit. */
+    cancelBeforeCommit(): boolean;
+    diagnostics(): AgentActorSaveDiagnostics;
+}
 interface AgentActorStore {
     load(): Promise<AgentActorSnapshot | undefined>;
     /** CAS save. Implementations must throw actor_snapshot_conflict on a revision mismatch. */
     save(snapshot: AgentActorSnapshot, expectedRevision: number): Promise<void>;
+    /** Optional phase-aware save used by Actor settlement convergence v2. */
+    beginSave?(snapshot: AgentActorSnapshot, expectedRevision: number): AgentActorSaveAttempt;
+    /** Maximum expected writer-admission wait after a phase-aware save is dequeued. */
+    readonly eligibilityTimeoutMs?: number;
 }
 /** Runtime-bound actor control surface. The caller path is minted by Runtime. */
 interface AgentActorClient {
@@ -1053,5 +1084,5 @@ type MemoryEvent = {
     readonly actionCount: number;
 };
 
-export { hashMemoryIdentityComponent as bb, isMemoryManagementController as bc, matchesMemoryApplicability as bd, memoryApplicabilityFingerprint as be };
-export type { KodaXMemoryOutcomeDigest as $, AgentActor as A, AgentMetadataValue as B, AgentMutationOptions as C, AgentOutput as D, AgentProgressItem as E, AgentProgressKind as F, AgentProgressUpdate as G, AgentSpawnInput as H, AgentTreeSnapshot as I, AgentTurn as J, AgentTurnExecutor as K, AgentTurnRef as L, AgentTurnState as M, AgentTurnSummary as N, KodaXCompactMemoryProgress as O, KodaXCompactMemorySeed as P, KodaXExtensionSessionRecord as Q, KodaXExtensionSessionState as R, KodaXExtensionStore as S, KodaXExtensionStoreEntry as T, KodaXGoalEventType as U, KodaXGoalState as V, KodaXGoalStatus as W, KodaXHandledMemoryOperation as X, KodaXJsonValue as Y, KodaXMemoryInfluenceRef as Z, KodaXMemoryIntent as _, AgentActorClient as a, MemoryReviewDraftAction as a$, KodaXMemoryOutcomeEvidence as a0, KodaXSessionArchiveMarkerEntry as a1, KodaXSessionArtifactLedgerEntry as a2, KodaXSessionBranchSummaryEntry as a3, KodaXSessionClientNoticeEntry as a4, KodaXSessionCompactionEntry as a5, KodaXSessionData as a6, KodaXSessionEntry as a7, KodaXSessionEntryBase as a8, KodaXSessionGoalEntry as a9, MemoryAutoCuratorInput as aA, MemoryAutoCuratorResult as aB, MemoryBodySnapshot as aC, MemoryClaimKind as aD, MemoryContextIdentity as aE, MemoryController as aF, MemoryCuratorInput as aG, MemoryEpisodeReviewResult as aH, MemoryEvent as aI, MemoryGovernanceFinding as aJ, MemoryGovernanceFindingKind as aK, MemoryGovernanceReport as aL, MemoryItemRef as aM, MemoryLifecycle as aN, MemoryLifecycleOperationResult as aO, MemoryManagementController as aP, MemoryPack as aQ, MemoryPackHint as aR, MemoryPackInput as aS, MemoryPackTraceMetadata as aT, MemoryProposalAction as aU, MemoryRefFilter as aV, MemoryRefKind as aW, MemoryRejectResult as aX, MemoryRememberInput as aY, MemoryRememberResult as aZ, MemoryReviewCandidateRef as a_, KodaXSessionLabelEntry as aa, KodaXSessionLineage as ab, KodaXSessionMemoryOutcomeDigestEntry as ac, KodaXSessionMemoryReviewReceiptEntry as ad, KodaXSessionMessageEntry as ae, KodaXSessionMeta as af, KodaXSessionNavigationOptions as ag, KodaXSessionRewindMarkerEntry as ah, KodaXSessionRuntimeInfo as ai, KodaXSessionScope as aj, KodaXSessionStorage as ak, KodaXSessionTreeNode as al, KodaXSessionUiHistoryItem as am, KodaXSessionUiHistoryItemType as an, KodaXSessionUiTextHistoryItem as ao, KodaXSessionUiTextHistoryItemType as ap, KodaXSessionUiToolCall as aq, KodaXSessionUiToolCallStatus as ar, KodaXSessionUiToolGroupHistoryItem as as, KodaXSessionWorkspaceKind as at, MemoryActionProposal as au, MemoryApplicability as av, MemoryApplyPreview as aw, MemoryApplyResult as ax, MemoryApproval as ay, MemoryAuthority as az, AgentActorOwner as b, MemoryReviewInput as b0, MemoryReviewModelInput as b1, MemoryReviewPersistenceDecision as b2, MemoryReviewPersistenceKind as b3, MemoryReviewPlan as b4, MemoryReviewRunner as b5, MemoryReviewTrigger as b6, MemoryScope as b7, MemorySourceAdapter as b8, MemoryVisibility as b9, SessionErrorMetadata as ba, AgentActorSnapshot as c, AgentActorSnapshotV1 as d, AgentActorSnapshotV2 as e, AgentActorState as f, AgentActorStore as g, AgentArtifactDescriptor as h, AgentBudgetAdmission as i, AgentBudgetAdmissionInput as j, AgentBudgetExhausted as k, AgentBudgetPort as l, AgentCapabilities as m, AgentDataClassification as n, AgentDetail as o, AgentEvent as p, AgentEventKind as q, AgentExecutionInput as r, AgentExecutionKind as s, AgentExecutionResult as t, AgentFollowupResult as u, AgentForkTurns as v, AgentInterruptScope as w, AgentLimitReached as x, AgentListEntry as y, AgentMailboxMessage as z };
+export { hashMemoryIdentityComponent as bf, isMemoryManagementController as bg, matchesMemoryApplicability as bh, memoryApplicabilityFingerprint as bi };
+export type { KodaXHandledMemoryOperation as $, AgentActor as A, AgentInterruptScope as B, AgentLimitReached as C, AgentListEntry as D, AgentMailboxMessage as E, AgentMetadataValue as F, AgentMutationOptions as G, AgentOutput as H, AgentProgressItem as I, AgentProgressKind as J, AgentProgressUpdate as K, AgentSpawnInput as L, AgentTreeSnapshot as M, AgentTurn as N, AgentTurnExecutor as O, AgentTurnRef as P, AgentTurnState as Q, AgentTurnSummary as R, KodaXCompactMemoryProgress as S, KodaXCompactMemorySeed as T, KodaXExtensionSessionRecord as U, KodaXExtensionSessionState as V, KodaXExtensionStore as W, KodaXExtensionStoreEntry as X, KodaXGoalEventType as Y, KodaXGoalState as Z, KodaXGoalStatus as _, AgentActorClient as a, MemoryRejectResult as a$, KodaXJsonValue as a0, KodaXMemoryInfluenceRef as a1, KodaXMemoryIntent as a2, KodaXMemoryOutcomeDigest as a3, KodaXMemoryOutcomeEvidence as a4, KodaXSessionArchiveMarkerEntry as a5, KodaXSessionArtifactLedgerEntry as a6, KodaXSessionBranchSummaryEntry as a7, KodaXSessionClientNoticeEntry as a8, KodaXSessionCompactionEntry as a9, MemoryApplyPreview as aA, MemoryApplyResult as aB, MemoryApproval as aC, MemoryAuthority as aD, MemoryAutoCuratorInput as aE, MemoryAutoCuratorResult as aF, MemoryBodySnapshot as aG, MemoryClaimKind as aH, MemoryContextIdentity as aI, MemoryController as aJ, MemoryCuratorInput as aK, MemoryEpisodeReviewResult as aL, MemoryEvent as aM, MemoryGovernanceFinding as aN, MemoryGovernanceFindingKind as aO, MemoryGovernanceReport as aP, MemoryItemRef as aQ, MemoryLifecycle as aR, MemoryLifecycleOperationResult as aS, MemoryManagementController as aT, MemoryPack as aU, MemoryPackHint as aV, MemoryPackInput as aW, MemoryPackTraceMetadata as aX, MemoryProposalAction as aY, MemoryRefFilter as aZ, MemoryRefKind as a_, KodaXSessionData as aa, KodaXSessionEntry as ab, KodaXSessionEntryBase as ac, KodaXSessionGoalEntry as ad, KodaXSessionLabelEntry as ae, KodaXSessionLineage as af, KodaXSessionMemoryOutcomeDigestEntry as ag, KodaXSessionMemoryReviewReceiptEntry as ah, KodaXSessionMessageEntry as ai, KodaXSessionMeta as aj, KodaXSessionNavigationOptions as ak, KodaXSessionRewindMarkerEntry as al, KodaXSessionRuntimeInfo as am, KodaXSessionScope as an, KodaXSessionStorage as ao, KodaXSessionTreeNode as ap, KodaXSessionUiHistoryItem as aq, KodaXSessionUiHistoryItemType as ar, KodaXSessionUiTextHistoryItem as as, KodaXSessionUiTextHistoryItemType as at, KodaXSessionUiToolCall as au, KodaXSessionUiToolCallStatus as av, KodaXSessionUiToolGroupHistoryItem as aw, KodaXSessionWorkspaceKind as ax, MemoryActionProposal as ay, MemoryApplicability as az, AgentActorOwner as b, MemoryRememberInput as b0, MemoryRememberResult as b1, MemoryReviewCandidateRef as b2, MemoryReviewDraftAction as b3, MemoryReviewInput as b4, MemoryReviewModelInput as b5, MemoryReviewPersistenceDecision as b6, MemoryReviewPersistenceKind as b7, MemoryReviewPlan as b8, MemoryReviewRunner as b9, MemoryReviewTrigger as ba, MemoryScope as bb, MemorySourceAdapter as bc, MemoryVisibility as bd, SessionErrorMetadata as be, AgentActorSaveAttempt as c, AgentActorSaveDiagnostics as d, AgentActorSavePhase as e, AgentActorSaveTiming as f, AgentActorSnapshot as g, AgentActorSnapshotV1 as h, AgentActorSnapshotV2 as i, AgentActorState as j, AgentActorStore as k, AgentArtifactDescriptor as l, AgentBudgetAdmission as m, AgentBudgetAdmissionInput as n, AgentBudgetExhausted as o, AgentBudgetPort as p, AgentCapabilities as q, AgentDataClassification as r, AgentDetail as s, AgentEvent as t, AgentEventKind as u, AgentExecutionInput as v, AgentExecutionKind as w, AgentExecutionResult as x, AgentFollowupResult as y, AgentForkTurns as z };

package/dist/types-chunks/{types.d-COhAF5Xo.d.ts → types.d-CqIcGQlc.d.ts}

@@ -1,4 +1,4 @@
-import { a$ as KodaXInputArtifact } from './controller.d-Dif9pbC9.js';
+import { a$ as KodaXInputArtifact } from './controller.d-C-GjOuPV.js';
 import { T as KodaXTaskResultMetadata } from './types.d-CK9A9rpP.js';
 
 /**

package/dist/types-chunks/{types.d-Bz5Y-PD9.d.ts → types.d-DNIzbJD_.d.ts}

@@ -1,8 +1,8 @@
 import { aa as KodaXWireReasoningEffort, a2 as KodaXToolDefinition, a4 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-CK9A9rpP.js';
 import { K as KodaXBaseProvider } from './base.d-vopO1rml.js';
 import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-K664nHOS.js';
-import { Y as KodaXJsonValue, Q as KodaXExtensionSessionRecord, S as KodaXExtensionStore } from './types.d-sW-OqiFt.js';
-import { aT as KodaXToolExecutionContext, bB as ToolSideEffect } from './bash-prefix-extractor.d-B36OQwNA.js';
+import { a0 as KodaXJsonValue, U as KodaXExtensionSessionRecord, W as KodaXExtensionStore } from './types.d-BSFS8--Y.js';
+import { aT as KodaXToolExecutionContext, bB as ToolSideEffect } from './bash-prefix-extractor.d-DcHi4vz5.js';
 
 /**
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).

package/dist/types-chunks/{utils.d-B65ozSTV.d.ts → utils.d-CeM3tG-E.d.ts}

@@ -1,10 +1,10 @@
 import { k as KodaXMessage, G as KodaXReasoningMode, d as KodaXCustomProviderConfig, q as KodaXProviderCapabilityProfile } from './types.d-CK9A9rpP.js';
-import { de as WorkflowProcessSource } from './controller.d-Dif9pbC9.js';
-import { Q as KodaXContextTokenSnapshot, aw as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, ab as KodaXRepoIntelligenceMode, a4 as KodaXOptions, ax as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-B36OQwNA.js';
-import { e as AgentsFile, t as AutoModeStats, T as KodaXMcpServersConfig } from './guardrail.d-DhpnJv4Y.js';
+import { de as WorkflowProcessSource } from './controller.d-C-GjOuPV.js';
+import { Q as KodaXContextTokenSnapshot, aw as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, ab as KodaXRepoIntelligenceMode, a4 as KodaXOptions, ax as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-DcHi4vz5.js';
+import { e as AgentsFile, t as AutoModeStats, T as KodaXMcpServersConfig } from './guardrail.d-BuI5uypW.js';
 import * as readline from 'readline';
-import { am as KodaXSessionUiHistoryItem, ab as KodaXSessionLineage, a2 as KodaXSessionArtifactLedgerEntry, R as KodaXExtensionSessionState, Q as KodaXExtensionSessionRecord, ai as KodaXSessionRuntimeInfo } from './types.d-sW-OqiFt.js';
-import { S as PermissionMode, L as LearningBinding, G as LearningSurfaceSnapshot } from './public-api.d-D4q3WxKq.js';
+import { aq as KodaXSessionUiHistoryItem, af as KodaXSessionLineage, a6 as KodaXSessionArtifactLedgerEntry, V as KodaXExtensionSessionState, U as KodaXExtensionSessionRecord, am as KodaXSessionRuntimeInfo } from './types.d-BSFS8--Y.js';
+import { S as PermissionMode, L as LearningBinding, G as LearningSurfaceSnapshot } from './public-api.d-hYcrNiNt.js';
 import { SpawnSyncReturns } from 'child_process';
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodax-ai/kodax",
-  "version": "0.7.87",
+  "version": "0.7.88",
   "description": "KodaX lightweight coding agent - TypeScript implementation with 16 built-in LLM provider aliases, published as a Node-free single-file CLI and SDK",
   "type": "module",
   "private": false,
@@ -8,7 +8,7 @@
     "access": "public"
   },
   "kodaxRuntimeContracts": {
-    "actorSettlementConvergence": 1,
+    "actorSettlementConvergence": 2,
     "daemonShutdownVerification": 1,
     "integrationConfigResilience": 1,
     "managedRunDurability": 1,

package/dist/chunks/agent-Z64QF7KG.js

@@ -1,2 +0,0 @@
-// @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{Ka as g,Ma as h,Za as i,_a as j,a as c,sa as d,ta as e,ua as f,yc as k}from"./chunk-3PGNESV3.js";import"./chunk-JS4RSF4B.js";import"./chunk-DB4O33RR.js";import"./chunk-GRJ7NKWP.js";import"./chunk-SKELDH3G.js";import{Jb as a,Kb as b}from"./chunk-ITP7J5HX.js";import"./chunk-XH7UM4GO.js";import"./chunk-ONUPGMER.js";export{e as bucketProviderPayloadSize,g as buildAutoRepoIntelligenceContext,f as checkPromiseSignal,b as cleanupIncompleteToolCalls,h as describeTransientProviderRetry,c as emitResilienceDebug,d as estimateProviderPayloadBytes,k as runKodaX,j as saveRequiredSessionSnapshot,i as saveSessionSnapshot,a as validateAndFixToolHistory};

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

@@ -1,2 +0,0 @@
-// @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{Ea as a,Fa as b}from"./chunk-4OLXWSCQ.js";import"./chunk-ASFCAPIG.js";import"./chunk-U44C5STU.js";import"./chunk-BCYJIACJ.js";import"./chunk-3PGNESV3.js";import"./chunk-XKLVC7F6.js";import"./chunk-JS4RSF4B.js";import"./chunk-ZQNOEKOB.js";import"./chunk-DB4O33RR.js";import"./chunk-GRJ7NKWP.js";import"./chunk-SKELDH3G.js";import"./chunk-ITP7J5HX.js";import"./chunk-XH7UM4GO.js";import"./chunk-ONUPGMER.js";export{a as ArgumentCompleter,b as createArgumentCompleter};