@kodax-ai/kodax 0.7.82 → 0.7.84

package/CHANGELOG.md

@@ -10,6 +10,65 @@ No changes yet.
 
 ---
 
+## [0.7.84] - 2026-08-07
+
+> Git tag and GitHub Release are created by the release workflow. npm
+> publication remains a separate manual operator step.
+
+### Fixed
+
+- Issue 282: Agent progress persistence is now backpressured and coalesced to
+  one in-flight write plus one latest replacement. Terminal settlement no
+  longer waits behind an unbounded progress backlog and exposes an explicit
+  durability-unknown state when the remaining write cannot settle in time.
+- A same-owner Stop can reconcile a late Actor snapshot after settlement
+  timeout, durably quiesce remaining children, and retry the repair on a later
+  Stop. Foreign owners, missing snapshots, and persistent storage failures
+  remain fail-closed.
+- Promise success/failure facts are retained while Actor durability is unknown
+  and outrank fallback terminal callbacks after repair. A stale durable unknown
+  status cannot rewind an already terminal local Run, duplicate cancellation
+  effects, or emit conflicting terminal events.
+- A quiesce with no eligible turn is now a true no-op and avoids an unnecessary
+  Session snapshot rewrite.
+
+### Documentation
+
+- Updated the release baseline, SDK embedder guidance, `kodax_manual`, feature
+  design index, regression guides, and known-issue disposition for Issue 282.
+
+---
+
+## [0.7.83] - 2026-08-06
+
+> Git tag and GitHub Release are created by the release workflow. npm
+> publication remains a separate manual operator step.
+
+### Added
+
+- Windows daemon startup now assigns the Runtime process to a kill-on-close Job
+  Object before user code can run. The public
+  `waitForRuntimeDaemonShutdown()` verifier combines the exact durable cleanup
+  outcome with daemon and containment-supervisor exit, advertised by
+  `daemonShutdownVerification:1`.
+
+### Fixed
+
+- Daemon final cleanup can safely retire incomplete current-owner child
+  registry records when kernel Job containment is active. Per-child synchronous
+  process-exit hooks are omitted in that mode, avoiding listener growth and
+  repeated PowerShell tree scans during shutdown. CLI stop now waits for the
+  containment boundary as well as the daemon PID before reporting success.
+- Existing Windows daemons are no longer forced through a lock-only capability
+  upgrade merely to restore Sessions. Shutdown verification remains explicitly
+  negotiable; a legacy daemon must be stopped and relaunched before callers can
+  require the new containment contract.
+- Review hardening closes the Windows Job-assignment failure path by terminating
+  and waiting for a still-suspended daemon before its process handles are closed.
+  This prevents an uncontained orphan when kernel Job assignment fails.
+
+---
+
 ## [0.7.82] - 2026-08-05
 
 > Git tag and GitHub Release are created by the release workflow. npm

package/README.md

@@ -624,6 +624,26 @@ active interrupt and after-turn admission do not produce a transient
 `data_changed` rejection. FEATURE_287 remains planned for v0.7.88; this is a
 non-Feature patch. See the [v0.7.82 release checklist](docs/release.md#v0782-release-preparation).
 
+**v0.7.83 Windows daemon containment release:** Windows daemon startup creates
+the daemon suspended, assigns it to a kill-on-close Job Object before resuming
+user code, and keeps an out-of-Job supervisor until the Job is empty. The SDK
+exports `waitForRuntimeDaemonShutdown()` and capability
+`daemonShutdownVerification:1`; CLI stop waits for both daemon and supervisor
+exit. Legacy uncontained daemons are not reported as verified and are not
+silently upgraded in place. The Worker owner-lease portion of Issue 256 remains
+scheduled for v0.7.85, and FEATURE_287 remains planned for v0.7.88. See the
+[v0.7.83 release checklist](docs/release.md#v0783-release-preparation).
+
+**v0.7.84 Actor settlement recovery release:** Agent progress persistence is
+now bounded to one in-flight write plus one latest replacement, so terminal
+settlement cannot wait behind an unbounded progress backlog. A same-owner Stop
+can reconcile a late Actor snapshot after a durability timeout, durably quiesce
+remaining children, and retry the repair. Promise success/failure facts remain
+authoritative over fallback callbacks after repair; stale durable unknown state
+cannot rewind a local terminal Run or duplicate cancellation effects. No-op
+quiescence avoids an unnecessary Session rewrite. See the
+[v0.7.84 release checklist](docs/release.md#v0784-release-preparation).
+
 The v0.7.77 release also adds an opt-in, host-configurable Shell Execution Contract.
 Runtime Session settings or an individual Run can select `pwsh`, Windows
 PowerShell, `cmd`, `bash`, `zsh`, or an explicit Git Bash executable; KodaX

package/README_CN.md

@@ -232,6 +232,16 @@ Run，再读取可变 Session history，因此活动中断和 after-turn 接纳
 `data_changed` 拒绝。FEATURE_287 仍计划于 v0.7.88；本版本是非 Feature 补丁。详见
 [v0.7.82 发布清单](docs/release.md#v0782-release-preparation)。
 
+**v0.7.83 Windows daemon containment 发布**：Windows daemon 会先以 suspended
+状态创建，在用户代码运行前分配到 kill-on-close Job Object，并由 Job 外部的
+supervisor 等待整个 Job 清空。SDK 导出 `waitForRuntimeDaemonShutdown()`，并通过
+`daemonShutdownVerification:1` 宣布该能力；CLI stop 会等待 daemon 与 supervisor
+都退出。旧的未 containment daemon 不会被报告为已验证，也不会被静默地原地升级。
+Issue 256 的 Worker owner lease 部分仍计划于 v0.7.85，FEATURE_287 仍计划于
+v0.7.88。详见 [v0.7.83 发布清单](docs/release.md#v0783-release-preparation)。
+
+**v0.7.84 Actor settlement recovery 发布**：Agent progress 持久化现在限制为一个进行中的写入加一个最新替换，terminal settlement 不会再被无限 progress backlog 阻塞。同 owner 的 Stop 可以在 durability timeout 后协调迟到的 Actor snapshot，持久化 quiesce 剩余子任务，并在后续 Stop 中重试修复。修复后 Promise 的 success/failure fact 优先于 fallback callback；过时的 durable unknown 状态不能回退本地已终态 Run，也不会重复取消效果。没有可处理 turn 的 quiesce 现在是真正 no-op，不再无意义地重写 Session。详见 [v0.7.84 发布清单](docs/release.md#v0784-release-preparation)。
+
 v0.7.77 还增加了由宿主显式配置的 Shell Execution Contract。Runtime Session
 设置或单次 Run 可以选择 `pwsh`、Windows PowerShell、`cmd`、`bash`、`zsh`
 或 Git Bash 的绝对路径；KodaX 会在实际项目 cwd 中解析 shell 环境，再通过同一

package/dist/chunks/{agent-4UTCCMD5.js → agent-VMXNVYRK.js}

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{Ja as g,La as h,Ya as i,Za as j,a as c,db as k,ra as d,sa as e,ta as f}from"./chunk-ZZUIO5KL.js";import"./chunk-HTVLCHWH.js";import"./chunk-GIVYTXQW.js";import"./chunk-KHEFUT6O.js";import"./chunk-TRNAWSXP.js";import{wb as a,xb as b}from"./chunk-WMYCNECP.js";import"./chunk-EVXIJPZ6.js";import"./chunk-E7C4DRD2.js";import"./chunk-6UENDY33.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};
+import{Ja as g,La as h,Ya as i,Za as j,a as c,db as k,ra as d,sa as e,ta as f}from"./chunk-TDJS5SFS.js";import"./chunk-HTVLCHWH.js";import"./chunk-GRLC3N46.js";import"./chunk-KHEFUT6O.js";import"./chunk-TRNAWSXP.js";import{xb as a,yb as b}from"./chunk-4ZI2CPUQ.js";import"./chunk-EVXIJPZ6.js";import"./chunk-E7C4DRD2.js";import"./chunk-6UENDY33.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-QCS6GUAE.js

@@ -0,0 +1,2 @@
+// @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
+import{Ea as a,Fa as b}from"./chunk-ET2BMEQQ.js";import"./chunk-OHZFGQEH.js";import"./chunk-726WJGGY.js";import"./chunk-F44YYR6Z.js";import"./chunk-TDJS5SFS.js";import"./chunk-WTYAZOWO.js";import"./chunk-HTVLCHWH.js";import"./chunk-ZVPTDYDI.js";import"./chunk-GRLC3N46.js";import"./chunk-KHEFUT6O.js";import"./chunk-TRNAWSXP.js";import"./chunk-4ZI2CPUQ.js";import"./chunk-EVXIJPZ6.js";import"./chunk-E7C4DRD2.js";import"./chunk-6UENDY33.js";import"./chunk-ONUPGMER.js";export{a as ArgumentCompleter,b as createArgumentCompleter};