@kodax-ai/kodax 0.7.83 → 0.7.84

package/CHANGELOG.md

@@ -10,6 +10,35 @@ 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

package/README.md

@@ -631,9 +631,19 @@ 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.84, and FEATURE_287 remains planned for v0.7.88. See the
+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

@@ -237,9 +237,11 @@ Run，再读取可变 Session history，因此活动中断和 after-turn 接纳
 supervisor 等待整个 Job 清空。SDK 导出 `waitForRuntimeDaemonShutdown()`，并通过
 `daemonShutdownVerification:1` 宣布该能力；CLI stop 会等待 daemon 与 supervisor
 都退出。旧的未 containment daemon 不会被报告为已验证，也不会被静默地原地升级。
-Issue 256 的 Worker owner lease 部分仍计划于 v0.7.84，FEATURE_287 仍计划于
+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-S7LMMTG7.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-TC2VHPG5.js";import"./chunk-HTVLCHWH.js";import"./chunk-6QILIBOU.js";import"./chunk-KHEFUT6O.js";import"./chunk-TRNAWSXP.js";import{xb as a,yb as b}from"./chunk-45E23YJI.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};