@kodax-ai/kodax 0.7.82 → 0.7.84

package/dist/types-chunks/{bash-prefix-extractor.d-CJM7OY-L.d.ts → bash-prefix-extractor.d-CkdGL4rM.d.ts}

@@ -1,4 +1,4 @@
-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-CYNuR2n9.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-CesRxFL5.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';

package/dist/types-chunks/{capsule.d-B7yoH4dM.d.ts → capsule.d-7wQ_kM1C.d.ts}

@@ -1,5 +1,5 @@
 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-CYNuR2n9.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-CesRxFL5.js';
 
 /**
  * @kodax-ai/agent Constants

package/dist/types-chunks/{controller.d-CYNuR2n9.d.ts → controller.d-CesRxFL5.d.ts}

@@ -4825,6 +4825,7 @@ declare class AgentActorController {
     private durableOwner?;
     private initialized;
     private ownershipLost;
+    private settlementPersistenceUnknown;
     private ownershipReleased;
     private closing;
     private settlementGeneration;
@@ -4912,6 +4913,7 @@ declare class AgentActorController {
     private releaseOwnershipAfterInitializationFailure;
     private assertWritableOwner;
     private fenceUnknownSettlement;
+    private reconcileUnknownSettlement;
     private stopLocalWork;
     private fenceAfterSnapshotConflict;
     private isInterruptionDurable;

package/dist/types-chunks/{guardrail.d-fM3mn4Op.d.ts → guardrail.d-KaIeVree.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-DxG0m09Z.js';
 import { a as CostTracker } from './cost-tracker.d-BeaenODW.js';
-import { e2 as RunnerToolCall, ez as ToolGuardrail } from './controller.d-CYNuR2n9.js';
+import { e2 as RunnerToolCall, ez as ToolGuardrail } from './controller.d-CesRxFL5.js';
 import { k as KodaXMessage } from './types.d-CgrXrFrq.js';
 import { S as SideQueryDiagnostics } from './side-query.d-CP1LiRiH.js';
-import { by as ToolSideEffect } from './bash-prefix-extractor.d-CJM7OY-L.js';
+import { by as ToolSideEffect } from './bash-prefix-extractor.d-CkdGL4rM.js';
 
 /**
  * FEATURE_200 Phase F (v0.7.45) — MCP domain types extracted from types.ts.

package/dist/types-chunks/{history-retrieval.d-BDI-ZMvY.d.ts → history-retrieval.d-CbCls7r0.d.ts}

@@ -1,5 +1,5 @@
 import { k as KodaXMessage } from './types.d-CgrXrFrq.js';
-import { c1 as KodaXSessionLineage } from './controller.d-CYNuR2n9.js';
+import { c1 as KodaXSessionLineage } from './controller.d-CesRxFL5.js';
 
 type KodaXSessionHistoryScope = 'compacted' | 'all';
 type KodaXSessionHistorySource = 'user' | 'assistant' | 'system' | 'tool' | 'child_task';

package/dist/types-chunks/{public-api.d-i10kvYFs.d.ts → public-api.d-DpRj8b7d.d.ts}

@@ -1,6 +1,6 @@
-import { a as BashPrefixExtractor, t as KodaXAgentMode } from './bash-prefix-extractor.d-CJM7OY-L.js';
+import { a as BashPrefixExtractor, t as KodaXAgentMode } from './bash-prefix-extractor.d-CkdGL4rM.js';
 import { G as KodaXReasoningMode, k as KodaXMessage, T as KodaXTaskResultMetadata } from './types.d-CgrXrFrq.js';
-import { cY as LearningSurfaceSnapshot$1, cT as LearningQuery, cS as LearningPage, cv as LearnedCapabilityRecord, cO as LearningEvent, cX as LearningSubscribeOptions, bY as KodaXSessionData, c1 as KodaXSessionLineage, c6 as KodaXSessionNavigationOptions, c8 as KodaXSessionRuntimeInfo, ca as KodaXSessionStorage, bZ as KodaXSessionEntry, bU as KodaXSessionArtifactLedgerEntry, bC as KodaXExtensionSessionRecord, cc as KodaXSessionUiHistoryItem, c9 as KodaXSessionScope, k as AgentActorSnapshot, aX as CompactionReport, bO as KodaXJsonValue } from './controller.d-CYNuR2n9.js';
+import { cY as LearningSurfaceSnapshot$1, cT as LearningQuery, cS as LearningPage, cv as LearnedCapabilityRecord, cO as LearningEvent, cX as LearningSubscribeOptions, bY as KodaXSessionData, c1 as KodaXSessionLineage, c6 as KodaXSessionNavigationOptions, c8 as KodaXSessionRuntimeInfo, ca as KodaXSessionStorage, bZ as KodaXSessionEntry, bU as KodaXSessionArtifactLedgerEntry, bC as KodaXExtensionSessionRecord, cc as KodaXSessionUiHistoryItem, c9 as KodaXSessionScope, k as AgentActorSnapshot, aX as CompactionReport, bO as KodaXJsonValue } from './controller.d-CesRxFL5.js';
 
 /**
  * TextBuffer - Text buffer management class - 文本缓冲区管理类

package/dist/types-chunks/{repl.d-Cs3eqGVT.d.ts → repl.d-DWeC3PLW.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-CgITiLyc.js';
-import { ae as SessionStorage$1, S as PermissionMode, L as LearningBinding } from './public-api.d-i10kvYFs.js';
-import { a1 as KodaXOptions, ad as KodaXResult } from './bash-prefix-extractor.d-CJM7OY-L.js';
-import { ca as KodaXSessionStorage, bY as KodaXSessionData } from './controller.d-CYNuR2n9.js';
-import { s as AutoModeStats } from './guardrail.d-fM3mn4Op.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-C-eSIZ9n.js';
+import { ae as SessionStorage$1, S as PermissionMode, L as LearningBinding } from './public-api.d-DpRj8b7d.js';
+import { a1 as KodaXOptions, ad as KodaXResult } from './bash-prefix-extractor.d-CkdGL4rM.js';
+import { ca as KodaXSessionStorage, bY as KodaXSessionData } from './controller.d-CesRxFL5.js';
+import { s as AutoModeStats } from './guardrail.d-KaIeVree.js';
 
 interface ReplRuntimePermissionGrantSuggestion {
     readonly id: string;

package/dist/types-chunks/{run-manager.d-CodHf6rw.d.ts → run-manager.d-BXBkLT0A.d.ts}

@@ -1,4 +1,4 @@
-import { fh as WorkflowProcessTrackerOptions, eP as WorkflowEvent, fb as WorkflowProcessSnapshot, f5 as WorkflowProcessEvent } from './controller.d-CYNuR2n9.js';
+import { fh as WorkflowProcessTrackerOptions, eP as WorkflowEvent, fb as WorkflowProcessSnapshot, f5 as WorkflowProcessEvent } from './controller.d-CesRxFL5.js';
 
 /**
  * FEATURE_246 Part A0 (ADR-046) — neutral workflow run lifecycle manager.

package/dist/types-chunks/{sdk-session-CRXu5xNs.d.ts → sdk-session-DEtS6u20.d.ts}

@@ -1,6 +1,6 @@
-import { h as CreatableHistoryItem, ar as ToolCall } from './public-api.d-i10kvYFs.js';
+import { h as CreatableHistoryItem, ar as ToolCall } from './public-api.d-DpRj8b7d.js';
 import { k as KodaXMessage, c as KodaXContentBlock } from './types.d-CgrXrFrq.js';
-import { cc as KodaXSessionUiHistoryItem, cg as KodaXSessionUiToolCall } from './controller.d-CYNuR2n9.js';
+import { cc as KodaXSessionUiHistoryItem, cg as KodaXSessionUiToolCall } from './controller.d-CesRxFL5.js';
 
 interface RestoreHistoryItemsFromSessionInput {
     messages: readonly KodaXMessage[];

package/dist/types-chunks/{shell-command-sets.d-DfeSUjjM.d.ts → shell-command-sets.d-P2h4_KKL.d.ts}

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

package/dist/types-chunks/{types.d-DKs4tfSd.d.ts → types.d-0m3PS7Ng.d.ts}

@@ -1,8 +1,8 @@
 import { aa as KodaXWireReasoningEffort, a2 as KodaXToolDefinition, a4 as KodaXToolResultContentItem, k as KodaXMessage } from './types.d-CgrXrFrq.js';
 import { K as KodaXBaseProvider } from './base.d-DxG0m09Z.js';
 import { C as CapabilityKind, a as CapabilityProvider } from './capability.d-K664nHOS.js';
-import { bO as KodaXJsonValue, bC as KodaXExtensionSessionRecord, bE as KodaXExtensionStore } from './controller.d-CYNuR2n9.js';
-import { aQ as KodaXToolExecutionContext, by as ToolSideEffect } from './bash-prefix-extractor.d-CJM7OY-L.js';
+import { bO as KodaXJsonValue, bC as KodaXExtensionSessionRecord, bE as KodaXExtensionStore } from './controller.d-CesRxFL5.js';
+import { aQ as KodaXToolExecutionContext, by as ToolSideEffect } from './bash-prefix-extractor.d-CkdGL4rM.js';
 
 /**
  * KodaX Constructed-World types (FEATURE_087, v0.7.28).

package/dist/types-chunks/{types.d-DIXZFauU.d.ts → types.d-CUtMr2IG.d.ts}

@@ -1,4 +1,4 @@
-import { bM as KodaXInputArtifact } from './controller.d-CYNuR2n9.js';
+import { bM as KodaXInputArtifact } from './controller.d-CesRxFL5.js';
 import { T as KodaXTaskResultMetadata } from './types.d-CgrXrFrq.js';
 
 /**

package/dist/types-chunks/{utils.d-CgITiLyc.d.ts → utils.d-C-eSIZ9n.d.ts}

@@ -1,9 +1,9 @@
 import { k as KodaXMessage, G as KodaXReasoningMode, d as KodaXCustomProviderConfig, q as KodaXProviderCapabilityProfile } from './types.d-CgrXrFrq.js';
-import { cc as KodaXSessionUiHistoryItem, c1 as KodaXSessionLineage, bU as KodaXSessionArtifactLedgerEntry, bD as KodaXExtensionSessionState, bC as KodaXExtensionSessionRecord, c8 as KodaXSessionRuntimeInfo, fc as WorkflowProcessSource } from './controller.d-CYNuR2n9.js';
-import { O as KodaXContextTokenSnapshot, at as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, a8 as KodaXRepoIntelligenceMode, a1 as KodaXOptions, au as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-CJM7OY-L.js';
-import { d as AgentsFile, s as AutoModeStats, S as KodaXMcpServersConfig } from './guardrail.d-fM3mn4Op.js';
+import { cc as KodaXSessionUiHistoryItem, c1 as KodaXSessionLineage, bU as KodaXSessionArtifactLedgerEntry, bD as KodaXExtensionSessionState, bC as KodaXExtensionSessionRecord, c8 as KodaXSessionRuntimeInfo, fc as WorkflowProcessSource } from './controller.d-CesRxFL5.js';
+import { O as KodaXContextTokenSnapshot, at as KodaXSkillDynamicContextPolicy, t as KodaXAgentMode, a8 as KodaXRepoIntelligenceMode, a1 as KodaXOptions, au as KodaXSkillInvocationContext } from './bash-prefix-extractor.d-CkdGL4rM.js';
+import { d as AgentsFile, s as AutoModeStats, S as KodaXMcpServersConfig } from './guardrail.d-KaIeVree.js';
 import * as readline from 'readline';
-import { S as PermissionMode, L as LearningBinding, G as LearningSurfaceSnapshot } from './public-api.d-i10kvYFs.js';
+import { S as PermissionMode, L as LearningBinding, G as LearningSurfaceSnapshot } from './public-api.d-DpRj8b7d.js';
 import { SpawnSyncReturns } from 'child_process';
 
 /**

package/docs/SDK_EMBEDDER_GUIDE.md

@@ -2651,14 +2651,58 @@ SDK auto-start allows `daemonStartupTimeoutMs` (default 60 seconds) and
 concurrent test/desktop startup without weakening PID, endpoint, token, or
 runtime-identity validation.
 
-On Windows, current child cleanup verifies observed process identities and
-reports indeterminate outcomes instead of falling back to bare-PID success.
-That is not Job Object-grade containment: if an intermediate process exits
-between snapshots, an already-running descendant can become unobservable.
-Until Issue 256 is resolved (scheduled for v0.7.84) with spawn-time Job Object
-assignment and a host-issued Worker owner lease, embedders must not treat
-Runtime/Worker close or executor cleanup as proof that every descendant has
-terminated.
+### Windows daemon shutdown containment (v0.7.83)
+
+On Windows, a newly started daemon is created suspended and assigned to a
+kill-on-close Job Object before it is resumed. Daemon application code cannot
+create descendants before that assignment. An out-of-Job supervisor waits for
+the daemon to exit and then waits for the Job's active-process count to reach
+zero, so a daemon PID exit alone is not a verified shutdown.
+
+Hosts that own the shutdown boundary can use the public verifier:
+
+```ts
+import { waitForRuntimeDaemonShutdown } from '@kodax-ai/kodax/runtime';
+
+const result = await waitForRuntimeDaemonShutdown({
+  homeDir: kodaxHome,
+  profile: 'default',
+  runtimeId,
+  timeoutMs: 30_000,
+});
+if (!result.verified) {
+  throw new Error(`Runtime shutdown was not verified: ${result.outcome}`);
+}
+```
+
+The connected daemon must advertise `daemonShutdownVerification: 1` when a host
+requires this contract. A legacy daemon without Job-containment metadata is
+kept usable for ordinary Session recovery, but it is never reported as a
+verified shutdown and is not silently upgraded in place. Stop it explicitly and
+relaunch it before requiring the capability. The CLI's `kodax daemon stop
+--json` follows the same daemon-plus-supervisor boundary.
+
+The daemon-owned slice does not close the Worker-owned child lifetime gap in
+Issue 256; that owner-lease work remains scheduled for v0.7.85. Worker and
+executor cleanup still use identity-checked evidence and fail closed when a
+descendant cannot be proven gone.
+
+### Actor settlement recovery (v0.7.84)
+
+The v0.7.84 Actor settlement boundary bounds progress persistence to one
+in-flight durable projection plus one latest replacement. A terminal save can
+therefore make progress without waiting behind an unbounded backlog. If Actor
+durability becomes unknown because that boundary times out, a
+`runtime.runs.abort()` Stop can reconcile the late Actor snapshot only for the
+exact same local owner, validate the owner fence, quiesce remaining turns, and
+retry the repair.
+
+The receipt remains unknown until both Actor and executor settlement are
+resolved. Repeated same-owner Stop delivery is idempotent under the same
+unknown-owner proof; foreign owners, missing snapshots, legacy records, and
+unresolved stores fail closed. After repair, Promise terminal facts win over
+fallback callbacks, so a stale callback cannot rewind a terminal Run or emit a
+duplicate outcome. A no-op quiesce does not rewrite the Session.
 
 `homeDir` and `KODAX_HOME` deliberately name different levels. Runtime SDK and
 CLI daemon `--home` accept the **base directory that contains `.kodax`**;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodax-ai/kodax",
-  "version": "0.7.82",
+  "version": "0.7.84",
   "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,6 +8,7 @@
     "access": "public"
   },
   "kodaxRuntimeContracts": {
+    "daemonShutdownVerification": 1,
     "integrationConfigResilience": 1,
     "managedRunDurability": 1
   },

package/dist/chunks/argument-completer-N7ORRJBS.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-JDZFNWMZ.js";import"./chunk-VQBJMNFD.js";import"./chunk-7ZN2MLVM.js";import"./chunk-ZOBNDWOA.js";import"./chunk-ZZUIO5KL.js";import"./chunk-NINELPXH.js";import"./chunk-HTVLCHWH.js";import"./chunk-KH2HED37.js";import"./chunk-GIVYTXQW.js";import"./chunk-KHEFUT6O.js";import"./chunk-TRNAWSXP.js";import"./chunk-WMYCNECP.js";import"./chunk-EVXIJPZ6.js";import"./chunk-E7C4DRD2.js";import"./chunk-6UENDY33.js";import"./chunk-ONUPGMER.js";export{a as ArgumentCompleter,b as createArgumentCompleter};