@kodax-ai/kodax 0.7.81 → 0.7.83

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/CHANGELOG.md +56 -0
  2. package/README.md +22 -0
  3. package/README_CN.md +17 -0
  4. package/dist/chunks/{agent-UMBMZLCW.js → agent-S7LMMTG7.js} +1 -1
  5. package/dist/chunks/argument-completer-SQHG2LYE.js +2 -0
  6. package/dist/chunks/chunk-37RT45HT.js +379 -0
  7. package/dist/chunks/{chunk-WLGQ6XI2.js → chunk-3DKQC7A2.js} +138 -138
  8. package/dist/chunks/{chunk-QMPJJCBE.js → chunk-45E23YJI.js} +142 -67
  9. package/dist/chunks/{chunk-D66EWPAX.js → chunk-6QILIBOU.js} +156 -156
  10. package/dist/chunks/{chunk-ITY7HLSS.js → chunk-DSFHIUHZ.js} +2 -2
  11. package/dist/chunks/{chunk-5XCQGFGP.js → chunk-DZUMH6GJ.js} +1 -1
  12. package/dist/chunks/{chunk-BNFUIZKY.js → chunk-HI6RCW5Y.js} +2 -2
  13. package/dist/chunks/{chunk-THBWLOA3.js → chunk-LF2JBTBG.js} +4 -4
  14. package/dist/chunks/{chunk-FGQZUN7C.js → chunk-RAQGGVIF.js} +1 -1
  15. package/dist/chunks/{chunk-VTFG3B7U.js → chunk-TC2VHPG5.js} +14 -14
  16. package/dist/chunks/{chunk-LLWRPP6U.js → chunk-URCS6CVP.js} +1 -1
  17. package/dist/chunks/{chunk-RX3X3PER.js → chunk-XB2JNLXH.js} +2 -2
  18. package/dist/chunks/{compaction-config-SSPH4V36.js → compaction-config-SSQ5NXUP.js} +1 -1
  19. package/dist/chunks/{construction-bootstrap-P5ZKDLTM.js → construction-bootstrap-E4M3CY3N.js} +1 -1
  20. package/dist/chunks/{dist-7J763N5L.js → dist-MIXP4ULB.js} +1 -1
  21. package/dist/chunks/{host-22ITM5E3.js → host-ZCPI7SMC.js} +1 -1
  22. package/dist/chunks/{run-manager-ABNHISGD.js → run-manager-4RYG7HSP.js} +1 -1
  23. package/dist/chunks/{utils-ATKWKEDP.js → utils-7DKE2EKT.js} +1 -1
  24. package/dist/index.d.ts +13 -13
  25. package/dist/index.js +5 -5
  26. package/dist/kodax_bootstrap.js +1 -1
  27. package/dist/kodax_cli.js +1708 -1284
  28. package/dist/kodax_resume.js +140 -65
  29. package/dist/runtime-worker.js +1538 -1114
  30. package/dist/sandbox-workspace-session.js +121 -46
  31. package/dist/sdk-a2a.d.ts +8 -8
  32. package/dist/sdk-a2a.js +1 -1
  33. package/dist/sdk-agent.d.ts +16 -9
  34. package/dist/sdk-agent.js +1 -1
  35. package/dist/sdk-coding.d.ts +13 -13
  36. package/dist/sdk-coding.js +1 -1
  37. package/dist/sdk-mcp.js +1 -1
  38. package/dist/sdk-repl.d.ts +11 -11
  39. package/dist/sdk-repl.js +1 -1
  40. package/dist/sdk-runtime.d.ts +55 -10
  41. package/dist/sdk-runtime.js +1 -1
  42. package/dist/sdk-sandbox.js +1 -1
  43. package/dist/sdk-session.d.ts +4 -4
  44. package/dist/sdk-session.js +1 -1
  45. package/dist/sdk-skills.js +1 -1
  46. package/dist/semantic-worker.js +120 -45
  47. package/dist/types-chunks/{bash-prefix-extractor.d-D_bvmnHs.d.ts → bash-prefix-extractor.d-CJM7OY-L.d.ts} +2 -2
  48. package/dist/types-chunks/{capsule.d-BFpbFq-C.d.ts → capsule.d-B7yoH4dM.d.ts} +1 -1
  49. package/dist/types-chunks/{controller.d-C2aHqzHj.d.ts → controller.d-CYNuR2n9.d.ts} +2 -2
  50. package/dist/types-chunks/{guardrail.d-CrSR1T_a.d.ts → guardrail.d-fM3mn4Op.d.ts} +2 -2
  51. package/dist/types-chunks/{history-retrieval.d-DImTKgO6.d.ts → history-retrieval.d-BDI-ZMvY.d.ts} +1 -1
  52. package/dist/types-chunks/{public-api.d-C-lVOhdt.d.ts → public-api.d-i10kvYFs.d.ts} +2 -2
  53. package/dist/types-chunks/{repl.d-DGi0nhpl.d.ts → repl.d-Cs3eqGVT.d.ts} +5 -5
  54. package/dist/types-chunks/{run-manager.d-C6ahvZqK.d.ts → run-manager.d-CodHf6rw.d.ts} +1 -1
  55. package/dist/types-chunks/{sdk-session-D5Ffq4h-.d.ts → sdk-session-CRXu5xNs.d.ts} +2 -2
  56. package/dist/types-chunks/{shell-command-sets.d-jmXn8K7r.d.ts → shell-command-sets.d-DfeSUjjM.d.ts} +1 -1
  57. package/dist/types-chunks/{types.d-BzpPDBPV.d.ts → types.d-DIXZFauU.d.ts} +1 -1
  58. package/dist/types-chunks/{types.d-BqYq_ljy.d.ts → types.d-DKs4tfSd.d.ts} +2 -2
  59. package/dist/types-chunks/{utils.d-Z-YpaiUS.d.ts → utils.d-CgITiLyc.d.ts} +4 -4
  60. package/docs/SDK_EMBEDDER_GUIDE.md +60 -14
  61. package/package.json +2 -1
  62. package/dist/chunks/argument-completer-MHRFNBWB.js +0 -2
  63. package/dist/chunks/chunk-FUK6OUCW.js +0 -30
package/CHANGELOG.md CHANGED
@@ -10,6 +10,62 @@ No changes yet.
10
10
 
11
11
  ---
12
12
 
13
+ ## [0.7.83] - 2026-08-06
14
+
15
+ > Git tag and GitHub Release are created by the release workflow. npm
16
+ > publication remains a separate manual operator step.
17
+
18
+ ### Added
19
+
20
+ - Windows daemon startup now assigns the Runtime process to a kill-on-close Job
21
+ Object before user code can run. The public
22
+ `waitForRuntimeDaemonShutdown()` verifier combines the exact durable cleanup
23
+ outcome with daemon and containment-supervisor exit, advertised by
24
+ `daemonShutdownVerification:1`.
25
+
26
+ ### Fixed
27
+
28
+ - Daemon final cleanup can safely retire incomplete current-owner child
29
+ registry records when kernel Job containment is active. Per-child synchronous
30
+ process-exit hooks are omitted in that mode, avoiding listener growth and
31
+ repeated PowerShell tree scans during shutdown. CLI stop now waits for the
32
+ containment boundary as well as the daemon PID before reporting success.
33
+ - Existing Windows daemons are no longer forced through a lock-only capability
34
+ upgrade merely to restore Sessions. Shutdown verification remains explicitly
35
+ negotiable; a legacy daemon must be stopped and relaunched before callers can
36
+ require the new containment contract.
37
+ - Review hardening closes the Windows Job-assignment failure path by terminating
38
+ and waiting for a still-suspended daemon before its process handles are closed.
39
+ This prevents an uncontained orphan when kernel Job assignment fails.
40
+
41
+ ---
42
+
43
+ ## [0.7.82] - 2026-08-05
44
+
45
+ > Git tag and GitHub Release are created by the release workflow. npm
46
+ > publication remains a separate manual operator step.
47
+
48
+ ### Fixed
49
+
50
+ - Daemon Host Tool capability discovery now preserves complete, lease-scoped
51
+ snapshots when it composes them with the active MCP runtime. Explicit server
52
+ filters select only their requested source, unfiltered discovery stays
53
+ complete/live, and legacy providers are queried without the ordinary page cap
54
+ while retaining explicit degraded metadata (Issue 279).
55
+ - A recorded managed-Run Stop now fences provider retry/fallback/continuation,
56
+ guardrail, tool, and Actor work after cooperative cancellation is observed.
57
+ The trusted Stop/Abort cause is classified before credential redaction, so
58
+ status, terminal event, `runs.get()`, and `runs.await()` consistently report
59
+ interruption without overriding genuine completion or independent failures
60
+ (Issue 280).
61
+ - `runtime.runs.submitInput()` and daemon preflight now resolve the admitted
62
+ authoritative Run before reading mutable Session history. Active interrupt
63
+ and after-turn admission no longer fail with transient `data_changed`; queued
64
+ continuations still wait for predecessor settlement and retain exact
65
+ operation-id idempotency (Issue 281).
66
+
67
+ ---
68
+
13
69
  ## [0.7.81] - 2026-08-05
14
70
 
15
71
  > Git tag and GitHub Release are created by the release workflow. npm
package/README.md CHANGED
@@ -612,6 +612,28 @@ failure fails the delivery closed rather than emitting an unverifiable event.
612
612
  FEATURE_287 remains planned for v0.7.88; this is a non-Feature patch. See the
613
613
  [v0.7.81 release checklist](docs/release.md#v0781-release-preparation).
614
614
 
615
+ **v0.7.82 Runtime causality release:** Daemon capability discovery now composes
616
+ live, complete MCP and Host Tool snapshots only for unfiltered search; an
617
+ explicit server filter selects that source alone, while legacy providers report
618
+ honest incomplete/unknown discovery. An observed Stop cooperatively fences
619
+ later retries, continuations, guardrails, tools, and Run-admitted Actor work;
620
+ trusted Abort remains terminal causality before credential redaction without
621
+ overriding a real completion or independent failure. Input submission resolves
622
+ the admitted authoritative Run before reading mutable Session history, so
623
+ active interrupt and after-turn admission do not produce a transient
624
+ `data_changed` rejection. FEATURE_287 remains planned for v0.7.88; this is a
625
+ non-Feature patch. See the [v0.7.82 release checklist](docs/release.md#v0782-release-preparation).
626
+
627
+ **v0.7.83 Windows daemon containment release:** Windows daemon startup creates
628
+ the daemon suspended, assigns it to a kill-on-close Job Object before resuming
629
+ user code, and keeps an out-of-Job supervisor until the Job is empty. The SDK
630
+ exports `waitForRuntimeDaemonShutdown()` and capability
631
+ `daemonShutdownVerification:1`; CLI stop waits for both daemon and supervisor
632
+ exit. Legacy uncontained daemons are not reported as verified and are not
633
+ silently upgraded in place. The Worker owner-lease portion of Issue 256 remains
634
+ scheduled for v0.7.84, and FEATURE_287 remains planned for v0.7.88. See the
635
+ [v0.7.83 release checklist](docs/release.md#v0783-release-preparation).
636
+
615
637
  The v0.7.77 release also adds an opt-in, host-configurable Shell Execution Contract.
616
638
  Runtime Session settings or an individual Run can select `pwsh`, Windows
617
639
  PowerShell, `cmd`, `bash`, `zsh`, or an explicit Git Bash executable; KodaX
package/README_CN.md CHANGED
@@ -223,6 +223,23 @@ provenance 失败会 fail closed,不会发布无法验证的交付事件。FEA
223
223
  v0.7.88;本版本是非 Feature 补丁。详见
224
224
  [v0.7.81 发布清单](docs/release.md#v0781-release-preparation)。
225
225
 
226
+ **v0.7.82 Runtime 因果性发布**:daemon 的未过滤 capability 发现会组合 live、complete
227
+ 的 MCP 与 Host Tool snapshot;显式 `server` 过滤只选择对应来源,legacy provider 则如实
228
+ 报告 incomplete/unknown。观察到 Stop 后,后续 retry、continuation、guardrail、tool 及
229
+ Run-admitted Actor 工作会协作式停止;可信 Abort 会在 credential redaction 前保留为终态
230
+ 因果,但不会覆盖真实 completion 或独立 failure。输入提交先解析已接纳的 authoritative
231
+ Run,再读取可变 Session history,因此活动中断和 after-turn 接纳不会产生瞬态
232
+ `data_changed` 拒绝。FEATURE_287 仍计划于 v0.7.88;本版本是非 Feature 补丁。详见
233
+ [v0.7.82 发布清单](docs/release.md#v0782-release-preparation)。
234
+
235
+ **v0.7.83 Windows daemon containment 发布**:Windows daemon 会先以 suspended
236
+ 状态创建,在用户代码运行前分配到 kill-on-close Job Object,并由 Job 外部的
237
+ supervisor 等待整个 Job 清空。SDK 导出 `waitForRuntimeDaemonShutdown()`,并通过
238
+ `daemonShutdownVerification:1` 宣布该能力;CLI stop 会等待 daemon 与 supervisor
239
+ 都退出。旧的未 containment daemon 不会被报告为已验证,也不会被静默地原地升级。
240
+ Issue 256 的 Worker owner lease 部分仍计划于 v0.7.84,FEATURE_287 仍计划于
241
+ v0.7.88。详见 [v0.7.83 发布清单](docs/release.md#v0783-release-preparation)。
242
+
226
243
  v0.7.77 还增加了由宿主显式配置的 Shell Execution Contract。Runtime Session
227
244
  设置或单次 Run 可以选择 `pwsh`、Windows PowerShell、`cmd`、`bash`、`zsh`
228
245
  或 Git Bash 的绝对路径;KodaX 会在实际项目 cwd 中解析 shell 环境,再通过同一
@@ -1,2 +1,2 @@
1
1
  // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
- 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-VTFG3B7U.js";import"./chunk-HTVLCHWH.js";import"./chunk-D66EWPAX.js";import"./chunk-KHEFUT6O.js";import"./chunk-TRNAWSXP.js";import{wb as a,xb as b}from"./chunk-QMPJJCBE.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};
2
+ 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};
@@ -0,0 +1,2 @@
1
+ // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
2
+ import{Ea as a,Fa as b}from"./chunk-DSFHIUHZ.js";import"./chunk-HI6RCW5Y.js";import"./chunk-DZUMH6GJ.js";import"./chunk-3DKQC7A2.js";import"./chunk-TC2VHPG5.js";import"./chunk-RAQGGVIF.js";import"./chunk-HTVLCHWH.js";import"./chunk-XB2JNLXH.js";import"./chunk-6QILIBOU.js";import"./chunk-KHEFUT6O.js";import"./chunk-TRNAWSXP.js";import"./chunk-45E23YJI.js";import"./chunk-EVXIJPZ6.js";import"./chunk-E7C4DRD2.js";import"./chunk-6UENDY33.js";import"./chunk-ONUPGMER.js";export{a as ArgumentCompleter,b as createArgumentCompleter};