@kodax-ai/kodax 0.7.97-alpha.8 → 0.7.97-beta.1

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 (234) hide show
  1. package/CHANGELOG.md +352 -0
  2. package/README.md +154 -29
  3. package/README_CN.md +106 -17
  4. package/config-templates/config.example.jsonc +2 -3
  5. package/dist/artifacts/skills/artifact-review/SKILL.md +44 -7
  6. package/dist/builtin/code-review/SKILL.md +5 -17
  7. package/dist/builtin/git-workflow/SKILL.md +9 -8
  8. package/dist/builtin/skill-creator/SKILL.md +38 -108
  9. package/dist/builtin/skill-creator/references/evaluation.md +50 -0
  10. package/dist/builtin/skill-creator/scripts/analyze-benchmark.d.ts +2 -0
  11. package/dist/builtin/skill-creator/scripts/analyze-benchmark.js +6 -3
  12. package/dist/builtin/skill-creator/scripts/compare-runs.d.ts +2 -0
  13. package/dist/builtin/skill-creator/scripts/compare-runs.js +6 -3
  14. package/dist/builtin/skill-creator/scripts/grade-evals.d.ts +2 -0
  15. package/dist/builtin/skill-creator/scripts/grade-evals.js +6 -3
  16. package/dist/builtin/skill-creator/scripts/run-eval.js +3 -3
  17. package/dist/builtin/skill-creator/scripts/run-loop.js +2 -1
  18. package/dist/builtin/skill-creator/scripts/run-trigger-eval.d.ts +2 -0
  19. package/dist/builtin/skill-creator/scripts/run-trigger-eval.js +3 -1
  20. package/dist/builtin/skill-creator/scripts/utils.d.ts +1 -1
  21. package/dist/builtin/skill-creator/scripts/utils.js +8 -0
  22. package/dist/builtin/tdd/SKILL.md +24 -40
  23. package/dist/builtin/visual-review/SKILL.md +7 -3
  24. package/dist/chunks/agent-OY4U4WOU.js +2 -0
  25. package/dist/chunks/agent-adapter-NDH3DMPG.js +2 -0
  26. package/dist/chunks/argument-completer-Q6GMPJ74.js +2 -0
  27. package/dist/chunks/bedrock-native-Z5VNWF5U.js +4 -0
  28. package/dist/chunks/cell-ABNYMGXV.js +2 -0
  29. package/dist/chunks/{chunk-JNB2FL6P.js → chunk-3ZEJRVNA.js} +1 -1
  30. package/dist/chunks/chunk-45ZP2YHG.js +2 -0
  31. package/dist/chunks/chunk-4KR4VUZK.js +142 -0
  32. package/dist/chunks/chunk-4Y6U7AH4.js +9 -0
  33. package/dist/chunks/chunk-52EN2777.js +2 -0
  34. package/dist/chunks/chunk-5MDNQCAV.js +4 -0
  35. package/dist/chunks/chunk-5WZ5FUUD.js +14 -0
  36. package/dist/chunks/chunk-654JOM24.js +634 -0
  37. package/dist/chunks/chunk-65652LR4.js +2 -0
  38. package/dist/chunks/chunk-6VHO36HK.js +2 -0
  39. package/dist/chunks/chunk-7OTOH4PT.js +465 -0
  40. package/dist/chunks/chunk-7SX7CHYP.js +2 -0
  41. package/dist/chunks/chunk-7U2BL7CM.js +19 -0
  42. package/dist/chunks/chunk-A3SLNYBB.js +5 -0
  43. package/dist/chunks/{chunk-W7ZFQTOK.js → chunk-ADIWJDFS.js} +1 -1
  44. package/dist/chunks/chunk-AGUM5SWX.js +2 -0
  45. package/dist/chunks/chunk-BZF7WPRK.js +357 -0
  46. package/dist/chunks/chunk-D5OW7UD5.js +2 -0
  47. package/dist/chunks/chunk-E2Z754K5.js +366 -0
  48. package/dist/chunks/chunk-ED7D73C3.js +2 -0
  49. package/dist/chunks/chunk-F7H6CDJN.js +2 -0
  50. package/dist/chunks/chunk-FMZN5F3Q.js +2 -0
  51. package/dist/chunks/chunk-FZZMHNDB.js +42 -0
  52. package/dist/chunks/chunk-G2IMBA3R.js +29 -0
  53. package/dist/chunks/chunk-GYNAAIZP.js +18 -0
  54. package/dist/chunks/chunk-GZUWQZJD.js +2 -0
  55. package/dist/chunks/chunk-HA4IKFUK.js +2 -0
  56. package/dist/chunks/chunk-ISLK6R2P.js +2 -0
  57. package/dist/chunks/chunk-KDLOPBFZ.js +2 -0
  58. package/dist/chunks/chunk-KDRYQKT7.js +3 -0
  59. package/dist/chunks/chunk-KE2NBMAP.js +20 -0
  60. package/dist/chunks/chunk-KJBS6L7Q.js +351 -0
  61. package/dist/chunks/chunk-KQ3XVHKK.js +1157 -0
  62. package/dist/chunks/chunk-LPHKXPF7.js +190 -0
  63. package/dist/chunks/chunk-LWOGHKTL.js +2 -0
  64. package/dist/chunks/chunk-MJ4IGUD4.js +5 -0
  65. package/dist/chunks/chunk-N2B6A3CX.js +10 -0
  66. package/dist/chunks/chunk-NM3AINLH.js +142 -0
  67. package/dist/chunks/chunk-NQ4XK3B2.js +2 -0
  68. package/dist/chunks/chunk-P7OJRV5Z.js +2 -0
  69. package/dist/chunks/chunk-PRH5G5J7.js +12 -0
  70. package/dist/chunks/chunk-QP47JIWP.js +3 -0
  71. package/dist/chunks/chunk-SCGXZ2QT.js +127 -0
  72. package/dist/chunks/{chunk-FX4R5PB3.js → chunk-TXI6SHDO.js} +1 -1
  73. package/dist/chunks/chunk-UF3GZ5PO.js +2 -0
  74. package/dist/chunks/chunk-V4WSBIXB.js +2 -0
  75. package/dist/chunks/chunk-V5RCDBKU.js +2 -0
  76. package/dist/chunks/{chunk-JOPSY4GI.js → chunk-VT35IZEZ.js} +1 -1
  77. package/dist/chunks/chunk-W33QJA3M.js +2 -0
  78. package/dist/chunks/chunk-W6MHQ7ED.js +2 -0
  79. package/dist/chunks/chunk-WMMESRP3.js +9 -0
  80. package/dist/chunks/chunk-XGUGEVCK.js +4 -0
  81. package/dist/chunks/chunk-YB24NTBC.js +2 -0
  82. package/dist/chunks/chunk-ZT2LR3KD.js +2 -0
  83. package/dist/chunks/client-3JEK33QQ.js +2 -0
  84. package/dist/chunks/compaction-config-NKDAUZNH.js +2 -0
  85. package/dist/chunks/{construction-bootstrap-P4QKIZV5.js → construction-bootstrap-HCRLORKG.js} +1 -1
  86. package/dist/chunks/devtools-MVOFT6N7.js +2 -0
  87. package/dist/chunks/devtools-TXYDDL2A.js +2 -0
  88. package/dist/chunks/dist-NTS7CJG3.js +2 -0
  89. package/dist/chunks/errors-ER7ZRPWC.js +2 -0
  90. package/dist/chunks/google-native-45I4S26I.js +2 -0
  91. package/dist/chunks/host-RHJ3VGYE.js +2 -0
  92. package/dist/chunks/mistral-native-JXPIDDYZ.js +5 -0
  93. package/dist/chunks/model-WCSO7VEC.js +2 -0
  94. package/dist/chunks/permission-MTSFSB74.js +2 -0
  95. package/dist/chunks/pi-messages-5LLOZH57.js +16 -0
  96. package/dist/chunks/readline-helpers-KZQCE3NH.js +2 -0
  97. package/dist/chunks/responses-websocket-Y4N5GXD3.js +2 -0
  98. package/dist/chunks/run-manager-MWEV42C5.js +2 -0
  99. package/dist/chunks/running-session-3BYAXGLK.js +2 -0
  100. package/dist/chunks/skills-V7T55I4F.js +2 -0
  101. package/dist/chunks/tool-dispatch-ZVIDGKB4.js +2 -0
  102. package/dist/chunks/utils-WGRFGT7S.js +2 -0
  103. package/dist/generated-config-templates.json +6 -0
  104. package/dist/index.d.ts +34 -32
  105. package/dist/index.js +6 -6
  106. package/dist/kodax_bootstrap.js +4 -2
  107. package/dist/kodax_cli.js +1764 -2990
  108. package/dist/kodax_doctor.js +3 -0
  109. package/dist/kodax_resume.js +30 -30
  110. package/dist/manual-topics.json +2196 -0
  111. package/dist/native/darwin-arm64/kodax-text-transaction.node +0 -0
  112. package/dist/native/darwin-arm64/manifest.json +1 -1
  113. package/dist/native/win32-x64/kodax-windows-sandbox.exe +0 -0
  114. package/dist/native/win32-x64/kodax-windows-text-transaction.node +0 -0
  115. package/dist/native/win32-x64/manifest.json +2 -2
  116. package/dist/one-shot-task.js +2 -0
  117. package/dist/provider-auth-cli.js +16 -0
  118. package/dist/provider-capabilities.json +560 -40
  119. package/dist/runtime-daemon-schema.json +1 -0
  120. package/dist/sandbox-network-broker.js +260 -795
  121. package/dist/script-cell.js +1 -0
  122. package/dist/script-worker.cjs +2166 -0
  123. package/dist/sdk-a2a.d.ts +23 -22
  124. package/dist/sdk-a2a.js +6 -8
  125. package/dist/sdk-agent.d.ts +119 -96
  126. package/dist/sdk-agent.js +1 -1
  127. package/dist/sdk-client.d.ts +16 -10
  128. package/dist/sdk-client.js +1 -1
  129. package/dist/sdk-coding.d.ts +67 -79
  130. package/dist/sdk-coding.js +1 -1
  131. package/dist/sdk-experimental-memory.d.ts +3 -3
  132. package/dist/sdk-experimental-memory.js +1 -1
  133. package/dist/sdk-llm.d.ts +265 -14
  134. package/dist/sdk-llm.js +1 -1
  135. package/dist/sdk-mcp.d.ts +3 -3
  136. package/dist/sdk-mcp.js +1 -1
  137. package/dist/sdk-media.d.ts +41 -166
  138. package/dist/sdk-media.js +1 -1
  139. package/dist/sdk-repl.d.ts +81 -51
  140. package/dist/sdk-repl.js +2 -2
  141. package/dist/sdk-runtime.d.ts +216 -2989
  142. package/dist/sdk-runtime.js +1 -1
  143. package/dist/sdk-sandbox.js +1 -1
  144. package/dist/sdk-session.d.ts +15 -14
  145. package/dist/sdk-session.js +1 -1
  146. package/dist/sdk-skills.d.ts +2 -2
  147. package/dist/sdk-skills.js +1 -1
  148. package/dist/semantic-worker.js +121 -75
  149. package/dist/static-text.json +323 -0
  150. package/dist/storage-repair-cli.js +3 -0
  151. package/dist/types-chunks/auth-file.d-ovsHEqD4.d.ts +178 -0
  152. package/dist/types-chunks/{bash-prefix-extractor.d-DFH463j2.d.ts → bash-prefix-extractor.d-RblzA9kO.d.ts} +285 -168
  153. package/dist/types-chunks/{capability-learning.d-B4pxKwP4.d.ts → capability-learning.d-BXDEOON2.d.ts} +4 -4
  154. package/dist/types-chunks/{capability.d-DOF3r0fJ.d.ts → capability.d-DapzKxy3.d.ts} +1 -1
  155. package/dist/types-chunks/{capsule.d-CwpmHGFB.d.ts → capsule.d-C-saon3X.d.ts} +5 -5
  156. package/dist/types-chunks/{client-contract-CRm9ZpL2.d.ts → client-contract-D8HXN_iu.d.ts} +249 -67
  157. package/dist/types-chunks/{controller.d-B4GyqWri.d.ts → controller.d-C0SAuNKu.d.ts} +1 -1
  158. package/dist/types-chunks/{controller.d-P3H97ddz.d.ts → controller.d-pXik2EIy.d.ts} +71 -11
  159. package/dist/types-chunks/{cost-tracker.d-BeaenODW.d.ts → cost-tracker.d-D1CTx-IO.d.ts} +37 -7
  160. package/dist/types-chunks/{base.d-ZBOdjDUT.d.ts → errors.d-D73qdYbS.d.ts} +91 -74
  161. package/dist/types-chunks/{history-retrieval.d-BzKWDjzG.d.ts → history-retrieval.d-BwEUR9cb.d.ts} +2 -2
  162. package/dist/types-chunks/{manager.d-C8OlTe2J.d.ts → manager.d-BMH8Q6TV.d.ts} +1 -1
  163. package/dist/types-chunks/{manifest.d-COreAnXG.d.ts → manifest.d-r74es7yq.d.ts} +1 -1
  164. package/dist/types-chunks/{provider-credential-context.d-BH2OaB1b.d.ts → provider-credential-context.d-Dw-sWcnu.d.ts} +11 -2
  165. package/dist/types-chunks/{provider-request-observation.d-C_bEqr4m.d.ts → provider-request-observation.d-CNe9vse3.d.ts} +4 -2
  166. package/dist/types-chunks/{public-api.d-BLmqDi73.d.ts → public-api.d-CvDSMmN2.d.ts} +13 -10
  167. package/dist/types-chunks/queue-BxQhqhFM.d.ts +166 -0
  168. package/dist/types-chunks/{resolver.d-DLY01RHx.d.ts → resolver.d-DrkpD8wY.d.ts} +142 -103
  169. package/dist/types-chunks/{review-inbox.d-BTLDdpG2.d.ts → review-inbox.d-Bgt46S7L.d.ts} +16 -3
  170. package/dist/types-chunks/{review-packet.d-Crra1Q7t.d.ts → review-packet.d-C0NYHPdq.d.ts} +7 -7
  171. package/dist/types-chunks/{run-manager.d-DmS1edk4.d.ts → run-manager.d-COrEJ-hn.d.ts} +41 -11
  172. package/dist/types-chunks/{runtime-client-info-BBBxdU8V.d.ts → runtime-client-info-DJ9srk4O.d.ts} +88 -7
  173. package/dist/types-chunks/runtime-event-B24TGIxk.d.ts +48 -0
  174. package/dist/types-chunks/sdk-runtime-CBPScTNR.d.ts +2236 -0
  175. package/dist/types-chunks/{sdk-session-DipY_CCd.d.ts → sdk-session-D_bf_sN2.d.ts} +13 -4
  176. package/dist/types-chunks/{sdk-skills-DokfOoJF.d.ts → sdk-skills-C-UA1A6I.d.ts} +3 -1
  177. package/dist/types-chunks/{side-query.d-DTrhVd_r.d.ts → side-query.d-UFKdWSw7.d.ts} +4 -4
  178. package/dist/types-chunks/{types.d-Jxj49rqO.d.ts → skill-invocation-error.d-FJ6ZujRz.d.ts} +24 -14
  179. package/dist/types-chunks/task-results.d-XMdWq0eA.d.ts +15 -0
  180. package/dist/types-chunks/{trusted-repl-entry-B1cb7lAn.d.ts → trusted-repl-entry-9i4hUuj-.d.ts} +10 -10
  181. package/dist/types-chunks/{types.d-BjOq57-z.d.ts → types.d-Bi8iUd6x.d.ts} +248 -4
  182. package/dist/types-chunks/types.d-BvEGNdN-.d.ts +131 -0
  183. package/dist/types-chunks/{types.d-NyCB6ztO.d.ts → types.d-CTo0NiAM.d.ts} +22 -13
  184. package/dist/types-chunks/{types.d-Cb8RdrjU.d.ts → types.d-D8qQjMeo.d.ts} +5 -1
  185. package/dist/types-chunks/{utils.d-Bt6USYa5.d.ts → utils.d-BhoGV3yv.d.ts} +11 -7
  186. package/dist/windows-native-scripts.json +5 -0
  187. package/docs/ARTIFACT_SDK.md +8 -0
  188. package/docs/CLIENT_CONTRACT.md +195 -9
  189. package/docs/SDK_MIGRATION.md +624 -2
  190. package/docs/SPACE_SDK_SEAMS.md +255 -2
  191. package/package.json +33 -6
  192. package/public_docs/README.md +22 -2
  193. package/public_docs/configuration/config-files.md +6 -0
  194. package/public_docs/configuration/custom-providers.md +62 -0
  195. package/public_docs/configuration/providers.md +238 -3
  196. package/public_docs/configuration/sandbox.md +30 -0
  197. package/public_docs/getting-started/quickstart.md +10 -1
  198. package/public_docs/sdk/embedder-guide.md +476 -206
  199. package/dist/chunks/agent-Q3KETYAO.js +0 -2
  200. package/dist/chunks/argument-completer-YBLONGXK.js +0 -2
  201. package/dist/chunks/chunk-2AM3FRQ7.js +0 -137
  202. package/dist/chunks/chunk-35P7QL2Q.js +0 -2
  203. package/dist/chunks/chunk-76OPYNVX.js +0 -298
  204. package/dist/chunks/chunk-D73IHTHH.js +0 -350
  205. package/dist/chunks/chunk-EKMVGLHV.js +0 -22
  206. package/dist/chunks/chunk-FK7AP3FS.js +0 -394
  207. package/dist/chunks/chunk-FL5KAFQZ.js +0 -2
  208. package/dist/chunks/chunk-HCLUUEDQ.js +0 -2
  209. package/dist/chunks/chunk-HD5BDOPC.js +0 -2
  210. package/dist/chunks/chunk-HTLRQB72.js +0 -431
  211. package/dist/chunks/chunk-KH7BRH2Q.js +0 -429
  212. package/dist/chunks/chunk-MIS2WZPP.js +0 -635
  213. package/dist/chunks/chunk-NFGFHUO6.js +0 -69
  214. package/dist/chunks/chunk-ONUPGMER.js +0 -2
  215. package/dist/chunks/chunk-ORH7UGCN.js +0 -2
  216. package/dist/chunks/chunk-PRJR2WBC.js +0 -19
  217. package/dist/chunks/chunk-RSUAZDLC.js +0 -351
  218. package/dist/chunks/chunk-UE3J7V5F.js +0 -497
  219. package/dist/chunks/chunk-V26LAWJY.js +0 -2
  220. package/dist/chunks/chunk-VNPYCHJA.js +0 -260
  221. package/dist/chunks/chunk-XMWTEVFZ.js +0 -1481
  222. package/dist/chunks/chunk-XXU6HP6N.js +0 -12
  223. package/dist/chunks/chunk-YVBBU6K5.js +0 -5
  224. package/dist/chunks/client-XFASU74S.js +0 -2
  225. package/dist/chunks/compaction-config-JZNGDKWW.js +0 -2
  226. package/dist/chunks/devtools-CD6KSIHE.js +0 -2
  227. package/dist/chunks/devtools-XR5F2C6T.js +0 -2
  228. package/dist/chunks/dist-2B3JWYFP.js +0 -2
  229. package/dist/chunks/dist-ZLR4OTDD.js +0 -2
  230. package/dist/chunks/host-PMDL4OM2.js +0 -2
  231. package/dist/chunks/readline-helpers-5JGWEVMK.js +0 -2
  232. package/dist/chunks/run-manager-KW252NVZ.js +0 -2
  233. package/dist/chunks/tool-dispatch-G2E7DV5U.js +0 -2
  234. package/dist/chunks/utils-VHSKUOLF.js +0 -2
package/README.md CHANGED
@@ -36,6 +36,32 @@
36
36
 
37
37
  ---
38
38
 
39
+ ## Current development after alpha.10
40
+
41
+ The unified Host cutover shipped in the `v0.7.97-alpha.12` tag retires
42
+ `runtimeExitSettlement` and `settleKodaXRuntimeExit()`. Version-labelled
43
+ paragraphs below describe their historical releases; use the [current SDK
44
+ migration guide](docs/SDK_MIGRATION.md) for supported interfaces and
45
+ [provider contracts](docs/LLM_INTEGRATION.md) for credential/account-preserving
46
+ upgrades. Existing SDK/config/API_KEY entries remain.
47
+
48
+ Agent / Coding / experimental Script work modes ship with Coding as the
49
+ default. Select them with `--work-mode`, `/work-mode`, or Product Client
50
+ Session `workMode`; this is independent of permissions and model choice.
51
+ SDK/Host paths now share the corresponding settings, question outcomes,
52
+ saved original tool reads, structured task reports and estimated-token
53
+ progress. See the [SDK alignment and migration checklist](docs/SDK_MIGRATION.md#2026-10-29-未发布改动对齐)
54
+ and [English integration guide](public_docs/sdk/embedder-guide.md#post-alpha10-sdk-alignment).
55
+ These source additions shipped in the `v0.7.97-alpha.11` tag; the
56
+ `v0.7.97-alpha.12` tag ships the unified shared-Host cutover, the
57
+ FEATURE_302 provider/OAuth credential parity stack, and the 2026-11-01
58
+ full-chain audit's Windows recovery, credential and permission fixes;
59
+ the `v0.7.97-beta.1` tag completes the Space-facing Host execution and
60
+ Session seams with Main default Skills, Quick Ask Session promotion and
61
+ atomic core-config publication.
62
+ Issue 371's historical first-read latency and Script model-efficiency
63
+ acceptance remain open.
64
+
39
65
  ## Install in 30 seconds
40
66
 
41
67
  ```bash
@@ -294,10 +320,12 @@ name, not an API key value. Put the custom provider's actual API key in the
294
320
  `MY_LLM_API_KEY` environment variable, then close the current terminal and open
295
321
  a new one before running `kodax`.
296
322
 
323
+ For native OpenAI Responses, add `"api": "responses"` to the custom provider. Omitted `api` keeps Chat Completions. Responses uses client-managed history and preserves ordered output; see [configuration and scope](public_docs/configuration/custom-providers.md#native-responses-api).
324
+
297
325
  `userAgentMode` defaults to `"compat"`, which sends `KodaX` instead of the official SDK User-Agent. Switch it to `"sdk"` only when your gateway expects the upstream SDK header.
298
326
  For custom reasoning models, `reasoning: { efforts, default }` is the preferred v0.7.57 shape; use `"reasoning": "none"` for models without thinking capability. SDK hosts should render effort pickers from `reasoningProfile.supportedEfforts` / `defaultEffort` rather than assuming a fixed five-option ladder.
299
327
 
300
- An undeclared OpenAI-compatible reasoning profile means capability is unknown. Omitted effort uses `auto`: the declared default wins, otherwise KodaX tries `max` and lowers only after explicit parameter/value rejection. `none` attempts to disable reasoning, then tries the lowest available thinking effort if disabling is rejected. SDK hosts receive `onReasoningResolved` with the requested effort, sent effort, fallback reasons, and `verified: false`; request acceptance does not prove that the model honored the strength. See [reasoning negotiation](docs/DD.md#23-custom-openai-compatible-reasoning) for cache and replay contracts.
328
+ For the default Chat Completions API, an undeclared OpenAI-compatible reasoning profile means capability is unknown. Omitted effort uses `auto`: the declared default wins, otherwise KodaX tries `max` and lowers only after explicit parameter/value rejection. `none` attempts to disable reasoning, then tries the lowest available thinking effort if disabling is rejected. SDK hosts receive `onReasoningResolved` with the requested effort, sent effort, fallback reasons, and `verified: false`; request acceptance does not prove that the model honored the strength. See [reasoning negotiation](docs/DD.md#23-custom-openai-compatible-reasoning) for cache and replay contracts.
301
329
 
302
330
  #### OpenAI-compatible reasoning providers
303
331
 
@@ -443,12 +471,13 @@ try {
443
471
 
444
472
  `connectKodaXClient` attaches without starting or replacing a Host. The Node
445
473
  connector does not provide browser HTTP/WebSocket transport. The retained
446
- `/runtime` inline/daemon APIs are for explicit low-level Host integration;
474
+ `/runtime` APIs connect trusted integrations to the same shared Host;
447
475
  Worker-hosted embedded Runtime is removed. The following structured-failure
448
476
  reference is scoped to that low-level API, not fields promised by Product Client.
449
477
 
450
478
  Both product entries accept optional `onStartupProgress` with the shared
451
- `ClientStartupProgress` type. Launcher `ready` means the Client is usable;
479
+ `ClientStartupProgress` type, including `initializing` with actual Host phases
480
+ for new Hosts. Phase observation adds no extra probes or waits. Launcher `ready` means the Client is usable;
452
481
  Session loading and UI rendering have separate boundaries. See the
453
482
  [startup progress example](public_docs/sdk/embedder-guide.md#show-local-startup-progress).
454
483
 
@@ -484,8 +513,10 @@ See [Structured Runtime failures](public_docs/sdk/embedder-guide.md#structured-c
484
513
  for the field contract, taxonomy, migration guidance, and security boundary.
485
514
 
486
515
  The product CLI uses the shared Host; `--runtime-mode`, `KODAX_RUNTIME_MODE`
487
- and the `runtimeMode` config key are removed. Explicit low-level inline
488
- embedding retains private ownership, while daemon clients detach independently.
516
+ and the `runtimeMode` config key are removed. The unreleased Host-only SDK
517
+ cutover also retires public embedded construction and inline owner switching.
518
+ Use `/client` for product execution; daemon clients detach independently.
519
+ See [migration and downgrade limits](docs/SDK_MIGRATION.md#统一-host-sdk-收口未发布).
489
520
  Worker-hosted embedded Runtime is no longer an option.
490
521
 
491
522
  ```bash
@@ -794,6 +825,85 @@ starts, upgrades, or waits. See
794
825
  Every v0.7.96 stable and v0.7.97-alpha.1/alpha.2/alpha.3 contract is
795
826
  retained.
796
827
 
828
+ **v0.7.97-beta.1 release:** Space-facing Host execution and Session seams
829
+ complete — Main-owned capability-gated default Skills and consumption-time
830
+ execution bindings select committed expert/connector state with fresh
831
+ credential/tool leases at actual Product input consumption, and Quick Ask
832
+ promotes Sessions through Host-owned revision checks with durable
833
+ request-ID reconciliation while preserving the original Session and history.
834
+ Plain redirect Run boundaries persist apart from legacy explicit Skill queues
835
+ and survive cold recovery with strict missing-method rejection; Main bindings
836
+ resolve before steer authority and retain the active Run's principal and
837
+ lease boundaries. Every core configuration update publishes atomically under
838
+ the shared lock with old bytes retained on failed writes, damaged provider
839
+ collections rejected before mutation, secret-free errors and bounded Windows
840
+ reader-denied replacement. The complete daemon schema ships as packaged data
841
+ inside the npm inventory while the CLI keeps its size budget; owner-local
842
+ temporary Run results stay awaitable after Host Session cleanup. Windows
843
+ protected paths retain lexical and physical short-name fences, and bare
844
+ `resume` discovery paints immediate `Finding sessions` feedback without
845
+ extra startup work (Issue 371's historical first-read investigation remains
846
+ open). Tagging and publication remain separate. See the
847
+ [v0.7.97-beta.1 release notes](docs/release.md#v0797-beta1-release-preparation).
848
+ Every v0.7.96 stable and v0.7.97-alpha.1 through alpha.12 contract is
849
+ retained.
850
+
851
+ **v0.7.97-alpha.12 release:** Public product execution converges on the
852
+ independent shared Host — embedded/default Runtime construction, inline
853
+ owner switching and function-based in-process external-agent Hosts are
854
+ retired behind an explicit daemon launcher with one-way abandoned-owner
855
+ policy migration, and `runtimeExitSettlement`/`settleKodaXRuntimeExit()`
856
+ retire. FEATURE_302 provider/OAuth credential parity lands the native
857
+ Responses transport, ordered history, native cloud protocols with scoped
858
+ authentication, Mistral Pi, native media classification, shared file
859
+ credentials bound to actual provider connections and hidden API-key setup;
860
+ Claude 5.5 history fragments and per-message effort controls join the LLM
861
+ layer; manual data moves out of the CLI JavaScript budget; and the
862
+ 2026-11-01 full-chain audit's Windows recovery, credential and permission
863
+ hardening ships with lock diagnostics and a Windows streaming-history PTY
864
+ CI gate. Tagging and publication remain separate. See the
865
+ [v0.7.97-alpha.12 release notes](docs/release.md#v0797-alpha12-release-preparation).
866
+ Every v0.7.96 stable and v0.7.97-alpha.1 through alpha.11 contract is
867
+ retained.
868
+
869
+ **v0.7.97-alpha.11 release:** Explicit Agent, Coding and experimental Script
870
+ work modes land through the CLI, `/work-mode` and managed SDK/Session paths —
871
+ Coding stays the default and Script runs supported leaf tools through the
872
+ existing permission and receipt boundaries. Ark, MiMo and MiniMax catalogs
873
+ refresh their reasoning and capacity metadata; non-interactive question
874
+ outcomes are preserved with Host-owned deadlines; Skill `Bash(pattern)` rules
875
+ admit a single parsed command; MCP tool originals stay readable through
876
+ `part: 'original'` across daemon IPC and Host restart; structured task reports
877
+ project into Product live views and recovered history; streaming progress
878
+ shows consistent estimated tokens; Windows stale-process recovery and
879
+ history-browsing cursor resync are corrected and sandbox filesystem
880
+ capabilities are validated at startup. Tagging and publication remain
881
+ separate. See the
882
+ [v0.7.97-alpha.11 release notes](docs/release.md#v0797-alpha11-release-preparation).
883
+ Every v0.7.96 stable and v0.7.97-alpha.1 through alpha.10 contract is
884
+ retained.
885
+
886
+ **v0.7.97-alpha.10 release:** Checkpointed Runs and task trees resume after
887
+ Host restart with fresh scoped authority on top of durable context-capacity
888
+ recovery boundaries; Kimi K3.1 provider routes join the registry with all
889
+ seven effort levels; AskUser questions wait indefinitely by default with
890
+ explicit skip and `unanswered` results. SDK startup callbacks expose internal
891
+ Host phases, and exit recovery separates safe startup from historical unknown
892
+ cleanup acknowledgements. Tagging and publication remain separate. See the
893
+ [v0.7.97-alpha.10 release notes](docs/release.md#v0797-alpha10-release-preparation).
894
+ Every v0.7.96 stable and v0.7.97-alpha.1 through alpha.9 contract is
895
+ retained.
896
+
897
+ **v0.7.97-alpha.9 release:** Checks Session admission through canonical
898
+ identity metadata instead of loading complete historical transcripts, so a
899
+ readable metadata header with an unreadable body (for example a Windows
900
+ ERROR_CRC surfacing as EIO) no longer blocks unrelated Run listing, daemon
901
+ inspection, or idle-exit inspection, with admission reuse fenced to initialized Actor controllers so
902
+ `protected` exit receipts for other clients' work are preserved. See the
903
+ [v0.7.97-alpha.9 release notes](docs/release.md#v0797-alpha9-release-preparation).
904
+ Every v0.7.96 stable and v0.7.97-alpha.1 through alpha.8 contract is
905
+ retained.
906
+
797
907
  **v0.7.97-alpha.8 release:** Ships the Artifact SDK inside the single main
798
908
  package — `@kodax-ai/kodax` gains `/artifacts`, `/artifacts/client`,
799
909
  `/artifacts/runtime` and `/artifacts/kodax` subpath exports; the workspace
@@ -1508,7 +1618,7 @@ KodaX has two layers that consumers should understand separately:
1508
1618
  | `packages/repl` | `@kodax-ai/kodax/repl` | Full package | Ink TUI + permission modes + commands (217 exports) | Terminal-UI consumers |
1509
1619
  | `packages/repl` | `@kodax-ai/kodax/session` | **Narrow subset** | Session management only — `listSessions` / `loadFullTranscript` / `appendClientNotice` / `forkSession` / `compactSession` / `watchSessions` / ... (17 exports) | IDE plugins and desktop hosts reading session history |
1510
1620
  | `src` | `@kodax-ai/kodax/client` | Product API | Shared Host connection and `KodaXProductClient` contract | TUI, desktop/IDE and automation applications |
1511
- | `src` | `@kodax-ai/kodax/runtime` | Host API | Explicit inline/daemon runtime facade, sessions/runs/events/permissions/catalog/MCP/artifacts/diagnostics/external agents, daemon protocol schema (10 exports) | Trusted Host integration |
1621
+ | `src` | `@kodax-ai/kodax/runtime` | Host API | Shared-Host runtime facade, sessions/runs/events/permissions/catalog/MCP/artifacts/diagnostics/external agents, daemon protocol schema (10 exports) | Trusted Host integration |
1512
1622
  | `src` | `@kodax-ai/kodax/sandbox` | Host API | Explicit ASRT capability/doctor/setup and host-owned contained command execution; unavailability never means silent ordinary execution | SDK hosts that need standalone process containment |
1513
1623
  | `src` | `@kodax-ai/kodax/a2a` | Integration edge | A2A 1.0 Agent Card discovery, JSON-RPC/SSE F258 executor, safe fetch policy, and authenticated Runtime-backed Agent server | Agent orchestrators and KodaX hosts |
1514
1624
 
@@ -1522,7 +1632,7 @@ KodaX has two layers that consumers should understand separately:
1522
1632
 
1523
1633
  **Inline Workflow Authoring (FEATURE_246, v0.7.58; F270 update in v0.7.72)**: the Worker can author and run a workflow inline via the model-callable `run_workflow` tool when Workflow intent is explicit. It scouts the codebase first, bakes concrete findings into child prompts, and runs the script through the sandbox, static-validation, and postcondition-verification pipeline. F270 retires AMAW and complexity-driven activation; AMA keeps explicit `/workflow`, named/SDK, and natural-language Workflow requests. Workflow child Agents now run on the unified Actor control plane. See [docs/features/v0.7.58.md](docs/features/v0.7.58.md), [docs/features/v0.7.72.md](docs/features/v0.7.72.md), and ADR-044/046/047/048/049/055.
1524
1634
 
1525
- **Historical Workflow Activation Tiers (FEATURE_248 + FEATURE_249, v0.7.59; superseded by F270 in v0.7.72)**: v0.7.59 introduced AMAW and explicit-request AMA behavior. F270 retires AMAW and its complexity-driven directive. SA remains solo; AMA is the single adaptive multi-Agent mode and activates Workflow only from explicit Workflow intent. See [docs/features/v0.7.59.md](docs/features/v0.7.59.md) and [docs/features/v0.7.72.md](docs/features/v0.7.72.md).
1635
+ **Historical Workflow Activation Tiers (FEATURE_248 + FEATURE_249, v0.7.59; superseded by F270 in v0.7.72)**: v0.7.59 introduced AMAW and explicit-request AMA behavior. F270 retires AMAW and its complexity-driven directive. CLI and REPL tasks use AMA; explicit SDK SA selection and the internal solo executor remain compatible. AMA is the single adaptive multi-Agent mode and activates Workflow only from explicit Workflow intent. See [docs/features/v0.7.59.md](docs/features/v0.7.59.md) and [docs/features/v0.7.72.md](docs/features/v0.7.72.md).
1526
1636
 
1527
1637
  **Progressive Disclosure on the Managed Tool Path (FEATURE_250, v0.7.60; current policy corrected in v0.7.74)**: the deferred-tool mechanism applies to the managed AMA path as well as SA. The current deferred set contains exactly 11 tools: six repo-intelligence tools, four web/code discovery tools, and `run_workflow`. Their `input_schema` remains directly callable while `tool_search` provides the full description on demand. The five fixed `mcp_*` facades and the `get_goal` / `create_goal` / `update_goal` lifecycle tools stay resident with their complete contracts. The v0.7.74 goal correction adds only about 109 estimated schema tokens versus the former hints (`get_goal` is actually 12 tokens smaller when resident), removes a discovery round trip, and changes no tool schema, handler, permission, goal state, or compaction-protection behavior. See [docs/features/v0.7.60.md](docs/features/v0.7.60.md) and [docs/features/v0.7.74.md](docs/features/v0.7.74.md#feature_250-v0774-correction-resident-goal-lifecycle-tools).
1528
1638
 
@@ -1534,7 +1644,7 @@ KodaX has two layers that consumers should understand separately:
1534
1644
 
1535
1645
  **Active-Run Interrupt Input (v0.7.74)**: embedded Runtime and the shared daemon advertise `interruptInput:1`. `runtime.runs.submitInput()` queues an immutable, ordered input for the current active Actor Run; all inputs admitted before one safe Runner boundary are delivered FIFO as separate user messages in the next LLM request, without creating continuation Runs. Queued/delivered state is visible in typed Run snapshots/events, delivery is acknowledged against the exact consumed IDs, and terminal cleanup prevents undelivered input from leaking into later Runs.
1536
1646
 
1537
- **External Agent SDK Plane (FEATURE_258, v0.7.67)**: `/agent` exports the protocol-neutral executor, registration, policy, credential-broker, artifact-policy, catalog, and durable task contracts. `/runtime` exposes the installed plane through `admin.agentRegistrations`, `agents`, and `agentTasks`, with the same DTO service methods over embedded and daemon clients. Executor factories are host functions: install them in an inline owner or while creating a new in-process daemon owner; they cannot be injected through an existing daemon connection or across a Runtime Worker boundary. Plane shutdown is terminal: pending waits and all later service calls reject. Restricted Workflow scripts preserve validated `phase` and external `target` routing. See the [complete owner/consumer recipes and safety contract](public_docs/sdk/embedder-guide.md#18-external-agent-executor-plane-feature_258-v0767).
1647
+ **External Agent SDK Plane (FEATURE_258, v0.7.67)**: `/agent` exports the protocol-neutral executor, registration, policy, credential-broker, artifact-policy, catalog, and durable task contracts. `/runtime` exposes the installed plane through `admin.agentRegistrations`, `agents`, and `agentTasks`, through the shared Host DTO services. The unified Host cutover retires public executor-factory injection and in-process owner construction. Configure supported A2A agents in the Host; arbitrary executor functions remain a standalone library integration and have no transparent product Host equivalent. Plane shutdown is terminal: pending waits and all later service calls reject. Restricted Workflow scripts preserve validated `phase` and external `target` routing. See the [complete owner/consumer recipes and safety contract](public_docs/sdk/embedder-guide.md#18-external-agent-executor-plane-feature_258-v0767).
1538
1648
 
1539
1649
  **Cost-Disciplined Workflow SDK (FEATURE_259, v0.7.67)**: SDK callers configure run-scoped `modelTiers` and `workflow.maxConcurrency`, while workflow authors express semantic `fast` / `balanced` / `deep` intent. Terminal workflow events expose resolved tier/source/fallback/usage/duration facts, and each durable `run.json` contains an `efficiencyReport` with token coverage, role/tier starts, packet-read topology, review waves, and quality-gate outcomes. See the [routing and telemetry contract](public_docs/sdk/embedder-guide.md#20-cost-disciplined-workflow-routing-and-telemetry-feature_259-v0767).
1540
1650
 
@@ -1542,7 +1652,7 @@ KodaX has two layers that consumers should understand separately:
1542
1652
 
1543
1653
  **Experimental Memory Agent SDK (FEATURE_260 + FEATURE_292)**: `/experimental-memory` exposes the source-compatible `MemoryAgent`/`MemorySession` lifecycle plus the additive `MemoryManagementAgent` facade when `createMemoryAgent()` receives a `MemoryManagementController`. That facade provides governed `list()`, `remember()`, and `forget()` through the same plane used by the conversation-first product surface. Passive recall is zero-wait; `query()` is read-only and deliberate; recalled content stays low-authority, and safety/scope gates remain deterministic. See the [direct session and boundary guide](public_docs/sdk/embedder-guide.md#21-experimental-governed-memory--experimental-memory-feature_260--feature_275--feature_292-v0768v0785).
1544
1654
 
1545
- **Bidirectional A2A 1.0 (FEATURE_267, v0.7.69)**: `/a2a` discovers allowed Agent Cards and installs a JSON-RPC/SSE executor through the existing F258 plane. Configured outbound Agents are also registered automatically as `external:<name>` in embedded CLI and user-daemon Runtimes, so the main Agent can orchestrate them without host code. One `a2a.json` may hold many outbound registrations and at most one inbound server, which publishes either the Runtime default or one validated `~/.kodax/agents/*.md` Agent behind an authenticated Runtime facade. The built-in listener is loopback-only and will not return a port blocked by Fetch-compatible clients; public deployment uses `handle()` behind host-owned TLS and authorization. A2A 0.3, gRPC, HTTP+JSON, push notifications, and automatic public exposure are not advertised. See the [client/server recipes and security boundaries](public_docs/sdk/embedder-guide.md#22-bidirectional-a2a-10--a2a-feature_267-v0769).
1655
+ **Bidirectional A2A 1.0 (FEATURE_267, v0.7.69)**: `/a2a` discovers allowed Agent Cards and installs a JSON-RPC/SSE executor through the existing F258 plane. Configured outbound Agents are also registered automatically as `external:<name>` in the shared Host, so the main Agent can orchestrate them without host code. One `a2a.json` may hold many outbound registrations and at most one inbound server, which publishes either the Runtime default or one validated `~/.kodax/agents/*.md` Agent behind an authenticated Runtime facade. The built-in listener is loopback-only and will not return a port blocked by Fetch-compatible clients; public deployment uses `handle()` behind host-owned TLS and authorization. A2A 0.3, gRPC, HTTP+JSON, push notifications, and automatic public exposure are not advertised. See the [client/server recipes and security boundaries](public_docs/sdk/embedder-guide.md#22-bidirectional-a2a-10--a2a-feature_267-v0769).
1546
1656
 
1547
1657
  **A2A interoperability and authentication hardening** keeps a discovered
1548
1658
  interface on the trusted Agent Card origin and sends credentials only when one
@@ -1631,11 +1741,11 @@ later re-enable. Private-address access and non-loopback plaintext HTTP are
1631
1741
  independent, persisted, default-deny permissions (`--allow-private` and
1632
1742
  `--allow-insecure-http`); exact loopback HTTP remains available without either.
1633
1743
  OAuth token endpoints retain their stricter HTTPS-or-exact-loopback rule.
1634
- SDK hosts load this same configured plane by wiring
1635
- `createConfiguredA2ARuntimeIntegration({ configHome })` and passing its
1636
- `runtimeOptions` as `externalAgents` — the CLI does this for its embedded
1637
- sessions and the daemon Host it launches, and the `worker.configuredA2A` opt-in
1638
- was removed with the Worker facade in v0.7.97. `a2a serve` loads
1744
+ The shared Host loads this configured plane through its internal
1745
+ `createConfiguredA2ARuntimeIntegration({ configHome })` wiring. SDK clients
1746
+ connect to that Host; public `externalAgents` function injection is retired.
1747
+ The `worker.configuredA2A` opt-in was removed with the Worker facade in v0.7.97.
1748
+ `a2a serve` loads
1639
1749
  its configured MCP/Extension capability surface before listening and pins that
1640
1750
  execution authority; it hot-reloads publication, authentication, and limits.
1641
1751
 
@@ -1773,7 +1883,7 @@ import { SkillRegistry } from '@kodax-ai/kodax/skills'; // zero-dep skil
1773
1883
  import { loadConfig } from '@kodax-ai/kodax/repl'; // REPL config / session helpers
1774
1884
  import { createMcpManager } from '@kodax-ai/kodax/mcp'; // MCP popout manager (v0.7.42)
1775
1885
  import { listSessions } from '@kodax-ai/kodax/session'; // session history helpers
1776
- import { createKodaXRuntime } from '@kodax-ai/kodax/runtime'; // embedded/daemon runtime API
1886
+ import { ensureKodaXRuntime } from '@kodax-ai/kodax/runtime'; // shared Host runtime API
1777
1887
  import { runKodaXSandboxed } from '@kodax-ai/kodax/sandbox'; // standalone ASRT containment
1778
1888
  import { createKodaXA2AServer } from '@kodax-ai/kodax/a2a'; // A2A 1.0 client/server edge
1779
1889
  import { createMemoryAgent } from '@kodax-ai/kodax/experimental-memory'; // opt-in memory SDK
@@ -1781,7 +1891,7 @@ import { createMemoryAgent } from '@kodax-ai/kodax/experimental-memory'; // opt-
1781
1891
 
1782
1892
  All 14 SDK entries (root + 13 subpaths, including `/client`) share internal code via ESM chunk splitting — importing from `/agent` does not pull in `/repl`'s Ink + React surface.
1783
1893
 
1784
- For the product contract and separate low-level inline/daemon ownership,
1894
+ For the product contract and low-level shared Host connections,
1785
1895
  external-agent registration and task control, session cursor pagination, workflow
1786
1896
  model-tier routing, and efficiency telemetry — see the
1787
1897
  [SDK Embedder Integration Guide](public_docs/sdk/embedder-guide.md).
@@ -2105,7 +2215,7 @@ This development tree exposes 17 SDK subpaths plus the root. Shared product
2105
2215
  applications use `@kodax-ai/kodax/client`; independent libraries and trusted Host
2106
2216
  APIs remain available through the other subpaths. See the [Client contract](docs/CLIENT_CONTRACT.md)
2107
2217
  and [SDK migration guide](docs/SDK_MIGRATION.md). This documentation was checked
2108
- against package version `0.7.97-alpha.8`; npm publication is separate from
2218
+ against package version `0.7.97-beta.1`; npm publication is separate from
2109
2219
  the current development-tree contract.
2110
2220
 
2111
2221
  ```bash
@@ -2123,7 +2233,7 @@ import { runInkInteractiveMode } from '@kodax-ai/kodax/repl'; // Ink TUI ent
2123
2233
  import { SkillRegistry } from '@kodax-ai/kodax/skills'; // zero-dep skill loader
2124
2234
  import { createMcpManager } from '@kodax-ai/kodax/mcp'; // MCP popout manager (v0.7.42)
2125
2235
  import { listSessions } from '@kodax-ai/kodax/session'; // session history helpers
2126
- import { createKodaXRuntime } from '@kodax-ai/kodax/runtime'; // embedded/daemon runtime API
2236
+ import { ensureKodaXRuntime } from '@kodax-ai/kodax/runtime'; // shared Host runtime API
2127
2237
  import { runKodaXSandboxed } from '@kodax-ai/kodax/sandbox'; // explicit standalone containment
2128
2238
  import { createKodaXA2AServer } from '@kodax-ai/kodax/a2a'; // A2A 1.0 client/server edge
2129
2239
  import { createMemoryAgent } from '@kodax-ai/kodax/experimental-memory'; // opt-in experimental memory SDK
@@ -2294,17 +2404,17 @@ await runInkInteractiveMode({ provider: 'zhipu-coding', effort: 'auto' });
2294
2404
  |----------|----------------------|-------------------|---------------|
2295
2405
  | anthropic | `ANTHROPIC_API_KEY` | Native | claude-sonnet-4-6 (`claude-opus-4-6` / `claude-haiku-4-5` via `/model`) |
2296
2406
  | openai | `OPENAI_API_KEY` | Native | gpt-5.3-codex (`gpt-5.4` / `gpt-5.3-codex-spark` via `/model`) |
2297
- | kimi | `KIMI_API_KEY` | Native | kimi-k2.7-code (262,144-token context; `kimi-k3` 1M / `kimi-k2.7-code-highspeed` / `kimi-k2.6` / `kimi-k2.5` via `/model`) |
2298
- | kimi-code | `KIMI_CODE_API_KEY` | Native | k3-256k (Moderato+, 256K, direct upstream ID; `k3` 1M / `kimi-for-coding` K2.7 Code / `kimi-for-coding-highspeed` via `/model`) |
2407
+ | kimi | `KIMI_API_KEY` | Native | kimi-k2.7-code (262,144-token context; `kimi-k3.1-pro` / `kimi-k3.1-pro-highspeed` / `kimi-k3` 1M / `kimi-k2.7-code-highspeed` / `kimi-k2.6` / `kimi-k2.5` via `/model`) |
2408
+ | kimi-code | `KIMI_CODE_API_KEY` | Native | k3-256k (Moderato+, 256K, direct upstream ID; `k3.1-pro` / `k3.1-pro-highspeed` / `k3` 1M / `kimi-for-coding` / `kimi-for-coding-highspeed` via `/model`; K3.1 requires thinking) |
2299
2409
  | qwen | `QWEN_API_KEY` | Native | qwen3.5-plus |
2300
2410
  | qwen-token-plan | `QWEN_TOKEN_API_KEY` | Native | qwen3.8-max (Anthropic-compat; legacy `qwen3.8-max-preview` plus `qwen3.7-max` / `qwen3.7-plus` / `qwen3.6-flash` / `glm-5.2` / `deepseek-v4-pro` via `/model`; all 1M context; image input on both Qwen 3.8 IDs / 3.7 Plus / 3.6 Flash) |
2301
2411
  | zhipu | `ZHIPU_API_KEY` | Native | glm-5 (`glm-5.3` / `glm-5.2` 1M ctx, plus `glm-5.1` / `glm-5-turbo` via `/model`; GLM-5.3 is pre-registered while the public API remains marked upcoming) |
2302
2412
  | zhipu-coding | `ZHIPU_CODING_API_KEY` | Native | glm-5.3 (1M ctx, 128K output; `glm-5.2` rollback plus `glm-5-turbo` / `glm-4.7` via `/model`; raw upstream IDs) |
2303
2413
  | zai-coding | `ZAI_CODING_API_KEY` | Native | glm-5.3 (`glm-5.2` rollback; raw upstream IDs; switched from glm-5.2 default on 2026-08-15) |
2304
- | minimax-coding | `MINIMAX_CODING_API_KEY` | Native | MiniMax-M3 (Frontier Coding, native multimodal + 1M ctx; legacy `MiniMax-M2.7` / `MiniMax-M2.7-highspeed` remain selectable via `/model`) |
2305
- | mimo | `MIMO_API_KEY` | Native | mimo-v2.5-pro (Xiaomi MiMo pay-per-token, Anthropic-compat) |
2306
- | mimo-coding | `MIMO_CODING_API_KEY` | Native | mimo-v2.5-pro (Xiaomi Token Plan, Anthropic-compat) |
2307
- | ark-coding | `ARK_CODING_API_KEY` | Native | glm-5.3 (Volcengine Ark Coding Plan — GLM-5.3 (1M ctx, 128K out) · GLM-5.2 (alias: `glm-latest`) · Kimi K2.7 Code / K2.6 · MiniMax M3 / M2.7 · DeepSeek V4 Pro / V4 Flash · Doubao Seed 2.0 Code / Pro / Lite · Doubao Seed Code) |
2414
+ | minimax-coding | `MINIMAX_CODING_API_KEY` | Native | MiniMax-M3.1-Flash (M Plan, 1M ctx, five effort levels; always-on thinking) |
2415
+ | mimo | `MIMO_API_KEY` | Native | mimo-v2.6-pro (Xiaomi MiMo pay-per-token; V2.6 Flash also selectable) |
2416
+ | mimo-coding | `MIMO_CODING_API_KEY` | Native | mimo-v2.6-pro (Xiaomi Token Plan; V2.6 Flash also selectable, image input, thinking on/off) |
2417
+ | ark-coding | `ARK_CODING_API_KEY` | Native | glm-5.3 (Ark Coding Plan; new `deepseek-v4.1-flash` / `deepseek-v4.1-flash-economy`, `glm-5.3-flash`, `kimi-k3.1-pro` / `kimi-k3` / `kimi-k2.8-preview`; all six accept images; previous configured IDs retained) |
2308
2418
  | deepseek | `DEEPSEEK_API_KEY` | Native | deepseek-flash (Anthropic-compat; DeepSeek-V4.1-Flash, 1M ctx, native image input; legacy text-only `deepseek-v4-pro`, via `/model`) |
2309
2419
  | gemini-cli | Provider CLI authentication (no KodaX API-key variable) | Prompt-only / CLI bridge | (via gemini CLI) |
2310
2420
  | codex-cli | Provider CLI authentication (no KodaX API-key variable) | Prompt-only / CLI bridge | (via codex CLI) |
@@ -2331,7 +2441,7 @@ kodax --session list
2331
2441
  kodax --parallel "Read package.json and tsconfig.json"
2332
2442
 
2333
2443
  # Adaptive multi-agent (AMA) mode — V2 Worker single-loop with Actor collaboration
2334
- kodax --agent-mode ama "Analyze code structure, check test coverage, find bugs"
2444
+ kodax "Analyze code structure, check test coverage, find bugs"
2335
2445
  ```
2336
2446
 
2337
2447
  ---
@@ -2420,10 +2530,25 @@ kodax "please use /skill:code-review src/"
2420
2530
 
2421
2531
  Set `disable-model-invocation: true` for a Skill that must only be loaded after an explicit slash invocation. This keeps it out of natural-language model discovery without disabling `/<name>` or `/skill:<name>`.
2422
2532
 
2423
- Built-in skills include:
2424
- - **code-review** - Code review and quality analysis
2425
- - **tdd** - Test-driven development workflow
2426
- - **git-workflow** - Git commit and workflow automation
2533
+ The five core built-in Skills are model-discoverable:
2534
+
2535
+ - **code-review** — Review changes without editing; includes read-only Git inspection.
2536
+ - **tdd** — Regression-first fixes or test-first work; tests-only requests may pass on the first run and do not authorize production edits.
2537
+ - **git-workflow** — Perform requested Git operations; explaining Git alone does not invoke the workflow.
2538
+ - **skill-creator** — Create, change, validate, package or evaluate reusable Skills; packaging does not install into the user's catalog.
2539
+ - **visual-review** — Review actual visual evidence and state unchecked scope honestly.
2540
+
2541
+ Skill shell declarations match the entire command, for example `Bash(git *, npm *)`,
2542
+ and retain Host permission and sandbox checks. The optional `artifact-review`
2543
+ Skill is registered with the [Artifact adapter](docs/ARTIFACT_SDK.md); it documents
2544
+ that adapter's supported formats and parameters. Both visual Skills may use the
2545
+ existing managed preparation flow within the task's authorization; denied or
2546
+ missing capabilities leave the affected scope unverified.
2547
+
2548
+ Skill Creator helpers use the public SDK, with a separately configured Provider,
2549
+ model and cwd. `run-trigger-eval.js` performs single-description semantic screening;
2550
+ actual triggering requires observed `skill` calls with the complete visible catalog.
2551
+ See its [evaluation reference](packages/agent/src/capabilities/skills/builtin/skill-creator/references/evaluation.md).
2427
2552
 
2428
2553
  Skills are stored in `~/.kodax/skills/` and can be extended with custom skills.
2429
2554
  F263 background learning is Memory-first: a single correction does not create
package/README_CN.md CHANGED
@@ -36,6 +36,24 @@
36
36
 
37
37
  ---
38
38
 
39
+ ## alpha.10 之后的当前开发
40
+
41
+ 随 `v0.7.97-alpha.12` 标签发布的统一 Host 收口已退役 `runtimeExitSettlement` 与
42
+ `settleKodaXRuntimeExit()`。下文带版本的发布记录保留历史事实;当前接口以
43
+ [SDK 迁移指南](docs/SDK_MIGRATION.md)为准,凭证与账号保持见
44
+ [接入契约](docs/LLM_INTEGRATION.md)。既有 SDK、配置与 API_KEY 环境入口继续有效。
45
+
46
+ Agent / Coding / 实验性 Script 工作模式已随 `v0.7.97-alpha.11` 标签发布,默认 Coding。
47
+ CLI 使用 `--work-mode`,REPL 使用 `/work-mode`,Product Client 使用 Session
48
+ `workMode`;它与权限、模型选择独立。SDK/Host 的相关设置、问题结算、工具原文读取、
49
+ 结构化任务报告和 token 估算进度已接入对应契约,见
50
+ [SDK 一致性与迁移清单](docs/SDK_MIGRATION.md#2026-10-29-未发布改动对齐)。
51
+ `v0.7.97-alpha.12` 标签发布统一共享 Host 收口、FEATURE_302 供应商/OAuth 凭据
52
+ 对齐栈,以及 2026-11-01 全链路审计的 Windows 恢复、凭据与权限修复;
53
+ `v0.7.97-beta.1` 标签完成 Space 侧 Host 执行与会话接缝——Main 默认 Skills、
54
+ Quick Ask Session promotion 与核心配置原子发布。
55
+ Issue 371 的历史首次读取延迟及 Script 模型效率验收仍未关闭。
56
+
39
57
  ## 30 秒上手
40
58
 
41
59
  ```bash
@@ -98,9 +116,9 @@ try {
98
116
 
99
117
  `connectKodaXClient` 只连接已有兼容 Host;`ensureKodaXClient` 通过统一启动器启动或正常更新空闲 Host。Node 连接器不提供浏览器 HTTP/WebSocket transport。
100
118
 
101
- 两个产品入口均支持可选 `onStartupProgress` 和共享 `ClientStartupProgress` 类型。启动 `ready` 表示 Client 接口可用;Session 加载与 UI 渲染仍有独立完成边界。详见[启动进度示例](public_docs/sdk/embedder-guide.md#show-local-startup-progress)。
119
+ 两个产品入口均支持可选 `onStartupProgress` 和共享 `ClientStartupProgress` 类型;新 Host 通过 `initializing/phase` 报告内部初始化步骤,不增加额外探测或等待。启动 `ready` 表示 Client 接口可用;Session 加载与 UI 渲染仍有独立完成边界。详见[启动进度示例](public_docs/sdk/embedder-guide.md#show-local-startup-progress)。
102
120
 
103
- 底层 `/runtime` 仍支持显式 inline embedded 与 daemon,供受信任宿主处理凭据桥、Host Tools、启动和诊断;Worker-hosted embedded、通用 operation receipt/journal 已移除。不能在产品连接失败时退回私有 Runtime。下方结构化 Runtime 错误说明仅属于底层接口,不能假定 Product Client 暴露相同字段。
121
+ 底层 `/runtime` 连接唯一共享 Host,供受信任客户端处理凭据桥、Host Tools、启动和诊断;Worker-hosted embedded、通用 operation receipt/journal 已移除。不能在产品连接失败时退回私有 Runtime。下方结构化 Runtime 错误说明仅属于底层接口,不能假定 Product Client 暴露相同字段。
104
122
 
105
123
  ### 结构化且凭据安全的 Runtime 错误
106
124
 
@@ -314,6 +332,62 @@ SDK 系统代码契约更新,但没有放宽 shell/sandbox 的 fail-closed 边
314
332
  [v0.7.97-alpha.4 发布清单](docs/release.md#v0797-alpha4-release-preparation)。
315
333
  所有 v0.7.96 稳定与 v0.7.97-alpha.1/alpha.2/alpha.3 契约全部保留。
316
334
 
335
+ **v0.7.97-beta.1 发布**:Space 侧 Host 执行与会话接缝收尾——Main 持有的
336
+ 能力门禁默认 Skills 与消费时执行绑定在实际 Product 输入消费点选取已提交
337
+ 专家/连接器状态并重新获取凭证/工具 lease;Quick Ask 通过 Host 掌握的修订
338
+ 检查与持久 request-ID 对账完成 Session promotion,保留原 Session 与历史。
339
+ 普通 redirect 的 Run 边界与遗留显式 Skill 队列分离并持久化,冷恢复后仍保持
340
+ 严格缺失方法拒绝;Main 绑定先于 steer 权限解析,保留活动 Run 的 principal
341
+ 与 lease 边界。所有核心配置更新在同一共享锁下原子发布——失败写入保留旧
342
+ 字节、损坏的 provider 集合变更前拒绝、配置错误不含秘密,Windows reader
343
+ 拒绝的替换在同一 staged 文件与写锁内有界重试。完整 daemon schema 作为
344
+ 打包数据进入 npm 清单且 CLI 保持体积预算;owner 本地临时 Run 结果在 Host
345
+ Session 清理后仍可等待。Windows 保护路径保留词法与物理短名围栏;裸
346
+ `resume` 会话发现立即显示 `Finding sessions` 反馈且不增加启动工作
347
+ (Issue 371 的历史首次读取调查仍未关闭)。代码提交、版本标签与实际发布
348
+ 分别判断。
349
+ 详见 [v0.7.97-beta.1 发布清单](docs/release.md#v0797-beta1-release-preparation)。
350
+ 所有 v0.7.96 稳定与 v0.7.97-alpha.1 至 alpha.12 契约全部保留。
351
+
352
+ **v0.7.97-alpha.12 发布**:公开产品执行收口到独立共享 Host——内嵌/默认
353
+ Runtime 构造、内联 owner 切换与函数式进程内外部 Agent Host 退役,由显式
354
+ daemon 启动器接管,并对废弃 owner 策略做单向迁移;`runtimeExitSettlement`
355
+ 与 `settleKodaXRuntimeExit()` 退役。FEATURE_302 供应商/OAuth 凭据对齐落地
356
+ 原生 Responses 传输、有序历史、带作用域认证的原生云协议、Mistral Pi、
357
+ 原生媒体分类、绑定实际供应商连接的共享文件凭据与隐藏 API Key 配置;
358
+ Claude 5.5 历史片段与逐消息 effort 控制进入 LLM 层;manual 数据移出 CLI
359
+ JavaScript 预算;2026-11-01 全链路审计的 Windows 恢复、凭据与权限加固
360
+ 随锁诊断与 Windows 流式历史 PTY CI 门禁一并发布。代码提交、版本标签与
361
+ 实际发布分别判断。
362
+ 详见 [v0.7.97-alpha.12 发布清单](docs/release.md#v0797-alpha12-release-preparation)。
363
+ 所有 v0.7.96 稳定与 v0.7.97-alpha.1 至 alpha.11 契约全部保留。
364
+
365
+ **v0.7.97-alpha.11 发布**:显式 Agent、Coding 与实验性 Script 工作模式通过
366
+ CLI、`/work-mode` 与托管 SDK/Session 路径落地——Coding 保持默认,Script 在既有
367
+ 权限与回执边界内执行受支持的叶子工具。Ark、MiMo、MiniMax 目录刷新推理与容量
368
+ 元数据;非交互问题结算保留结果且截止期限由 Host 掌握;Skill `Bash(pattern)`
369
+ 规则仅放行单条解析命令;MCP 工具原文经 `part: 'original'` 跨 daemon IPC 与
370
+ Host 重启可读;结构化任务报告投影到 Product 视图与恢复历史;流式进度统一以
371
+ token 估算展示;修正 Windows 陈旧进程恢复与历史浏览游标重同步,启动时校验
372
+ 沙箱文件系统能力。代码提交、版本标签与实际发布分别判断。
373
+ 详见 [v0.7.97-alpha.11 发布清单](docs/release.md#v0797-alpha11-release-preparation)。
374
+ 所有 v0.7.96 稳定与 v0.7.97-alpha.1 至 alpha.10 契约全部保留。
375
+
376
+ **v0.7.97-alpha.10 发布**:Host 重启后可恢复检查点 Run 与任务树(全新作用域
377
+ 授权);上下文容量恢复到达持久代边界;Kimi K3.1 供应商路由覆盖全部七档
378
+ effort;AskUser 默认无限等待、支持显式跳过并返回带原因的 `unanswered` 结果。
379
+ SDK 启动回调透传 Host 内部阶段;退出恢复将安全启动与历史清理未知事实分开。
380
+ 代码提交、版本标签与实际发布分别判断。
381
+ 详见 [v0.7.97-alpha.10 发布清单](docs/release.md#v0797-alpha10-release-preparation)。
382
+ 所有 v0.7.96 稳定与 v0.7.97-alpha.1 至 alpha.9 契约全部保留。
383
+
384
+ **v0.7.97-alpha.9 发布**:Session 准入检查改用规范身份元数据而非加载完整
385
+ 历史 transcript——元数据头可读而正文不可读(例如损坏存储上的 Windows
386
+ ERROR_CRC 以 EIO 呈现)不再阻塞无关的 Run 列表、daemon 检查或空闲退出检查。
387
+ 准入复用围栏到仍持有 owner fence 的已初始化 Actor 控制器,其他客户端工作的
388
+ `protected` 退出回执保持不变。详见 [v0.7.97-alpha.9 发布清单](docs/release.md#v0797-alpha9-release-preparation)。
389
+ 所有 v0.7.96 稳定与 v0.7.97-alpha.1 至 alpha.8 契约全部保留。
390
+
317
391
  **v0.7.97-alpha.8 发布**:Artifact SDK 并入单一主包发布——`@kodax-ai/kodax` 新增
318
392
  `/artifacts`、`/artifacts/client`、`/artifacts/runtime`、`/artifacts/kodax` 四个
319
393
  子路径导出;工作区模块转为私有(不再独立发布 npm),固定依赖上移到根包声明,
@@ -991,7 +1065,7 @@ import { SkillRegistry } from '@kodax-ai/kodax/skills'; // 零依赖 ski
991
1065
  import { loadConfig } from '@kodax-ai/kodax/repl'; // REPL 配置 / session 工具
992
1066
  import { createMcpManager } from '@kodax-ai/kodax/mcp'; // MCP popout manager(v0.7.42 起)
993
1067
  import { listSessions } from '@kodax-ai/kodax/session'; // session 历史工具
994
- import { createKodaXRuntime } from '@kodax-ai/kodax/runtime'; // inline/daemon 宿主 API
1068
+ import { createKodaXRuntime } from '@kodax-ai/kodax/runtime'; // 共享 Host 连接 API
995
1069
  import { runKodaXSandboxed } from '@kodax-ai/kodax/sandbox'; // 独立 ASRT 受控执行
996
1070
  import { createKodaXA2AServer } from '@kodax-ai/kodax/a2a'; // A2A 1.0 双向接入
997
1071
  import { createMemoryAgent } from '@kodax-ai/kodax/experimental-memory'; // opt-in 实验性记忆 SDK
@@ -1031,11 +1105,13 @@ import { createMemoryAgent } from '@kodax-ai/kodax/experimental-memory'; // opt-
1031
1105
  请把自定义 provider 的真实 API Key 设置到 `MY_LLM_API_KEY` 环境变量中,然后关闭
1032
1106
  当前终端、打开新终端,再运行 `kodax`。
1033
1107
 
1108
+ 原生 OpenAI Responses 可在自定义 provider 中设置 `"api": "responses"`;省略时保持 Chat Completions。Responses 使用客户端历史并保留输出块顺序;配置方式、离线验证及当前范围见 [Custom Providers](public_docs/configuration/custom-providers.md#native-responses-api)。
1109
+
1034
1110
  `userAgentMode` 默认 `"compat"`(发送 `KodaX` 而非上游 SDK 的 User-Agent);如果你的网关要求原生 SDK header,再切到 `"sdk"`。
1035
1111
 
1036
1112
  自定义 reasoning 模型优先使用 v0.7.57 的 `reasoning: { efforts, default }`;无 thinking 能力的模型使用 `"reasoning": "none"`。SDK 宿主的 effort 选择器应从 `reasoningProfile.supportedEfforts` / `defaultEffort` 动态生成,不要假定固定五档。
1037
1113
 
1038
- OpenAI-compatible provider 未声明 reasoning profile 表示能力未知。未设置 effort 时使用 `auto`:优先采用已声明默认档,否则从 `max` 开始,仅在明确的参数/档位拒绝后逐档降低。`none` 会尝试关闭;关闭被拒绝后尝试最低可用思考档。SDK 宿主通过 `onReasoningResolved` 收到用户意图、实际发送档位、回退原因和 `verified: false`;请求成功不代表模型已按该强度执行。缓存和推理数据回传规则见[详细设计](docs/DD.md#23-custom-openai-compatible-reasoning)。
1114
+ 默认 Chat Completions 路径下,OpenAI-compatible provider 未声明 reasoning profile 表示能力未知。未设置 effort 时使用 `auto`:优先采用已声明默认档,否则从 `max` 开始,仅在明确的参数/档位拒绝后逐档降低。`none` 会尝试关闭;关闭被拒绝后尝试最低可用思考档。SDK 宿主通过 `onReasoningResolved` 收到用户意图、实际发送档位、回退原因和 `verified: false`;请求成功不代表模型已按该强度执行。缓存和推理数据回传规则见[详细设计](docs/DD.md#23-custom-openai-compatible-reasoning)。
1039
1115
 
1040
1116
  #### OpenAI 兼容推理模型
1041
1117
 
@@ -1140,7 +1216,7 @@ kodax daemon stop --profile default
1140
1216
 
1141
1217
  daemon 可承载多个 Session;不同 Session 可以并发,同一 Session 的交付由 Host 串行协调。`after_turn` 可在当前 Run 的安全点交付,不必等整个长任务结束。客户端关闭观察或断开连接不会停止 Run。停止任务使用 `runs.stop` 或 `sessions.cancel`;关闭空闲 Host 才使用 `host.shutdown`/daemon stop。
1142
1218
 
1143
- 显式独立库嵌入仍可使用 `/runtime` 的 `createKodaXRuntime({mode:'embedded'})`,其 owner 和退出责任属于调用者。这不是 CLI 的可选运行模式,也不是产品客户端的连接失败回退。当前包版本与发布状态见[SDK 迁移指南](docs/SDK_MIGRATION.md)。
1219
+ 未发布的统一 Host 收口已退役公开 embedded 构造与 inline 所有权切换;完整产品能力统一使用 `/client`。独立 llm/agent/coding 库仍可单独使用。旧状态自动迁移与降级限制见 SDK 迁移指南。当前包版本与发布状态见[SDK 迁移指南](docs/SDK_MIGRATION.md)。
1144
1220
 
1145
1221
  普通 CLI 自动拉起的 Host 在最后一个客户端断开、后台工作持续空闲 30 秒后退出;重新连接会取消空闲退出。显式 `kodax daemon start` 会保留当前 Host,即使它原先是临时 Host;承载已配置 A2A 服务的 Host 也会在没有 CLI 客户端时继续常驻。
1146
1222
 
@@ -1184,17 +1260,17 @@ dist/binary/linux-x64/
1184
1260
  |----------|----------|-----------|-----------|
1185
1261
  | anthropic | `ANTHROPIC_API_KEY` | Native | claude-sonnet-4-6(可 `/model` 切换 `claude-opus-4-6` / `claude-haiku-4-5`) |
1186
1262
  | openai | `OPENAI_API_KEY` | Native | gpt-5.3-codex(可 `/model` 切换 `gpt-5.4` / `gpt-5.3-codex-spark`) |
1187
- | kimi | `KIMI_API_KEY` | Native | kimi-k2.7-code(262,144 token;可 `/model` 切换 `kimi-k3`〔1M〕/ `kimi-k2.7-code-highspeed` / `kimi-k2.6` / `kimi-k2.5`) |
1188
- | kimi-code | `KIMI_CODE_API_KEY` | Native | k3-256k(Moderato+,256K,直接请求同名上游模型;可 `/model` 切换 `k3`〔Allegretto+,1M〕/ `kimi-for-coding`〔K2.7 Code〕/ `kimi-for-coding-highspeed`) |
1263
+ | kimi | `KIMI_API_KEY` | Native | kimi-k2.7-code(262,144 token;可 `/model` 切换 `kimi-k3.1-pro` / `kimi-k3.1-pro-highspeed` / `kimi-k3`〔1M〕/ `kimi-k2.7-code-highspeed` / `kimi-k2.6` / `kimi-k2.5`) |
1264
+ | kimi-code | `KIMI_CODE_API_KEY` | Native | k3-256k(Moderato+,256K,直接请求同名上游模型;可 `/model` 切换 `k3.1-pro` / `k3.1-pro-highspeed` / `k3`〔1M〕/ `kimi-for-coding` / `kimi-for-coding-highspeed`;K3.1 必须开启思考) |
1189
1265
  | qwen | `QWEN_API_KEY` | Native | qwen3.5-plus |
1190
1266
  | qwen-token-plan | `QWEN_TOKEN_API_KEY` | Native | qwen3.8-max(Anthropic 协议;可 `/model` 切换兼容项 `qwen3.8-max-preview` 及 `qwen3.7-max` / `qwen3.7-plus` / `qwen3.6-flash` / `glm-5.2` / `deepseek-v4-pro`;均为 1M ctx;两个 Qwen 3.8 ID / 3.7 Plus / 3.6 Flash 支持图片理解) |
1191
1267
  | zhipu | `ZHIPU_API_KEY` | Native | glm-5(可 `/model` 切换 `glm-5.3` / `glm-5.2`,均为 1M ctx,另有 `glm-5.1` / `glm-5-turbo`;GLM-5.3 开放平台 API 仍标注为即将上线) |
1192
1268
  | zhipu-coding | `ZHIPU_CODING_API_KEY` | Native | glm-5.3(1M ctx、128K 最大输出;可回退到 `glm-5.2`,也可切换 `glm-5-turbo` / `glm-4.7`;原样发送上游 ID) |
1193
1269
  | zai-coding | `ZAI_CODING_API_KEY` | Native | glm-5.3(保留 `glm-5.2` 回退;原样发送上游 ID;2026-08-15 起默认从 glm-5.2 切换) |
1194
- | minimax-coding | `MINIMAX_CODING_API_KEY` | Native | MiniMax-M3(Frontier Coding,原生多模态 + 1M ctx;仍可通过 `/model` 显式选择兼容模型 `MiniMax-M2.7` / `MiniMax-M2.7-highspeed`) |
1195
- | mimo | `MIMO_API_KEY` | Native | mimo-v2.5-pro(小米 MiMo 按量计费,Anthropic 协议) |
1196
- | mimo-coding | `MIMO_CODING_API_KEY` | Native | mimo-v2.5-pro(小米 MiMo Token Plan,Anthropic 协议) |
1197
- | ark-coding | `ARK_CODING_API_KEY` | Native | glm-5.3(火山方舟 Coding Plan — GLM-5.3(1M ctx、128K out) · GLM-5.2(别名 `glm-latest`) · Kimi K2.7 Code / K2.6 · MiniMax M3 / M2.7 · DeepSeek V4 Pro / V4 Flash · Doubao Seed 2.0 Code / Pro / Lite · Doubao Seed Code) |
1270
+ | minimax-coding | `MINIMAX_CODING_API_KEY` | Native | MiniMax-M3.1-Flash(M Plan,1M 上下文,原生五档推理,思考始终开启) |
1271
+ | mimo | `MIMO_API_KEY` | Native | mimo-v2.6-pro(小米 MiMo 按量计费,也可选 V2.6 Flash) |
1272
+ | mimo-coding | `MIMO_CODING_API_KEY` | Native | mimo-v2.6-pro(小米 MiMo Token Plan,也可选 V2.6 Flash;支持图片、思考开关) |
1273
+ | ark-coding | `ARK_CODING_API_KEY` | Native | glm-5.3(方舟 Coding Plan;新增 `deepseek-v4.1-flash` / `deepseek-v4.1-flash-economy`、`glm-5.3-flash`、`kimi-k3.1-pro` / `kimi-k3` / `kimi-k2.8-preview`;六款均支持图片;保留历史配置 ID) |
1198
1274
  | deepseek | `DEEPSEEK_API_KEY` | Native | deepseek-flash(Anthropic 协议;DeepSeek-V4.1-Flash,1M ctx,原生图片理解;可 `/model` 切换纯文本兼容名 `deepseek-v4-pro`) |
1199
1275
  | gemini-cli | 由 Provider CLI 完成认证(无 KodaX API-key 环境变量) | Prompt-only / CLI bridge | (通过 gemini CLI) |
1200
1276
  | codex-cli | 由 Provider CLI 完成认证(无 KodaX API-key 环境变量) | Prompt-only / CLI bridge | (通过 codex CLI) |
@@ -1266,6 +1342,19 @@ KodaX 有 50+ 个内置工具,按类别分组如下(实际暴露给 LLM 是
1266
1342
  | `ask_user_question` | 向用户发起单选 / 多选 / 自由文本提问 |
1267
1343
  | `exit_plan_mode` | 仅在当前 REPL/宿主提供审批回调时提交最终方案 |
1268
1344
 
1345
+ ## 内置 Skills
1346
+
1347
+ 五个核心 Skill(git-workflow、tdd、code-review、skill-creator、visual-review)
1348
+ 默认开放自然语言发现;概念解释与无关任务不应触发工作流。TDD 的“仅补测试”
1349
+ 分支允许首次通过,不扩大生产代码改动;Skill Creator 按创建、打包、评测分支
1350
+ 执行,分享包不默认安装到个人目录。`Bash(git *, npm *)` 匹配完整命令,仍保留
1351
+ Host 授权与沙箱。
1352
+
1353
+ 描述语义筛查不等于观察到真实 Skill 调用。独立 SDK 评测需明确 Provider、model、
1354
+ cwd 和预算,见[评测方法](packages/agent/src/capabilities/skills/builtin/skill-creator/references/evaluation.md)。
1355
+ 可选 artifact-review 聚焦已注册 Artifact 工具;与 visual-review 一样,受管准备
1356
+ 被拒绝或能力缺失时,受影响范围保留为未验证。
1357
+
1269
1358
  ## Repo Intelligence(内置 full/light 引擎)
1270
1359
 
1271
1360
  KodaX 内置 repo intelligence(`repo_overview` / `module_context` / `symbol_context` / `process_context` / `impact_estimate` 等),让 coding agent 不靠零散 grep/glob 就能理解大型仓库。
@@ -1311,7 +1400,7 @@ KodaX 有两层结构,SDK 用户需要分开理解:
1311
1400
  | `packages/repl` | `@kodax-ai/kodax/repl` | 完整包 | Ink TUI + 权限模式 + 命令系统 (217 exports) | 终端 UI 消费者 |
1312
1401
  | `packages/repl` | `@kodax-ai/kodax/session` | **窄子集** | 仅会话管理 —— `listSessions` / `loadFullTranscript` / `appendClientNotice` / `forkSession` / `compactSession` / `watchSessions` 等 (17 exports) | 读取 session 历史的 IDE 插件和桌面宿主 |
1313
1402
  | `src` | `@kodax-ai/kodax/client` | 产品 API | 共享 Host 连接与 `KodaXProductClient` 统一契约 | TUI、桌面/IDE 和自动化应用 |
1314
- | `src` | `@kodax-ai/kodax/runtime` | 宿主 API | Explicit inline/daemon facade,含 sessions/runs/events/permissions/catalog/MCP/artifacts/diagnostics/外部 Agent 和 daemon schema (10 exports) | 受信任宿主集成 |
1403
+ | `src` | `@kodax-ai/kodax/runtime` | 宿主 API | Shared-Host facade,含 sessions/runs/events/permissions/catalog/MCP/artifacts/diagnostics/外部 Agent 和 daemon schema (10 exports) | 受信任宿主集成 |
1315
1404
  | `src` | `@kodax-ai/kodax/sandbox` | 宿主 API | 显式 ASRT capability/doctor/setup 与宿主自有受控命令执行;不可用时绝不静默普通执行 | 需要独立进程 containment 的 SDK 宿主 |
1316
1405
  | `src` | `@kodax-ai/kodax/a2a` | 集成边界 | A2A 1.0 Agent Card 发现、JSON-RPC/SSE F258 executor、安全 fetch 与鉴权 Runtime Agent server | Agent 编排器和 KodaX 宿主 |
1317
1406
 
@@ -1406,9 +1495,9 @@ MCP、A2A、Extension 分别使用 `~/.kodax/integrations/` 下的一个用户
1406
1495
  停用条目可随时重新启用。私网地址访问与非 loopback 明文 HTTP 是两项独立、
1407
1496
  持久化且默认拒绝的权限(`--allow-private` 与 `--allow-insecure-http`);精确
1408
1497
  loopback HTTP 无需这两项授权。OAuth token endpoint 仍保持更严格的
1409
- HTTPS 或精确 loopback 规则。SDK 宿主通过 `createConfiguredA2ARuntimeIntegration({ configHome })` 装载同一
1410
- 配置执行平面,并把其 `runtimeOptions` 作为 `externalAgents` 传入——CLI 为其嵌入式
1411
- 会话和它启动的 daemon Host 完成同样的接线;`worker.configuredA2A` 选项已随
1498
+ HTTPS 或精确 loopback 规则。共享 Host 在内部通过 `createConfiguredA2ARuntimeIntegration({ configHome })`
1499
+ 装载配置执行平面;SDK 客户端连接这个 Host,公开 `externalAgents` 函数注入已退役。
1500
+ `worker.configuredA2A` 选项已随
1412
1501
  Worker facade 在 v0.7.97 移除。
1413
1502
  `a2a serve` 会在监听前装载已配置的 MCP/Extension 能力并固定执行权威,同时热加载
1414
1503
  公开信息、鉴权和限额。Agent、Skill、Extension 工具权威、工作区、tool policy
@@ -1434,13 +1523,13 @@ REPL 显示、唤醒或消费。
1434
1523
 
1435
1524
  当前源码中,`kodax -r` 按最近真实对话消息排序并显示对应时间,旧记录缺少可靠消息时间时回退创建时间。SDK 的 `lastMessageAt`、Host 列表与选择器共用规则;标题、设置、Actor 保存和压缩不刷新对话时间。共享 Host 在取得所有权后统一恢复历史进程,连接客户端不重复清扫;加载提示继续使用统一启动进度契约。
1436
1525
 
1437
- **外部 Agent SDK plane(FEATURE_258,v0.7.67)**:`/agent` 导出协议中立的 executor、registration、policy、credential broker、artifact policy、catalog 和 durable task 契约;`/runtime` 通过 `admin.agentRegistrations`、`agents`、`agentTasks` 向 embedded 与 daemon client 提供同一组 DTO API。Executor factory 是宿主函数,只能装入 inline owner,或在创建新的 in-process daemon owner 时装入;不能通过既有 daemon 连接或 Runtime Worker 边界注入。Plane 关闭后是终态:未完成的 wait 和后续所有服务调用都会拒绝;受限 Workflow 脚本会完整校验并传递 `phase` 与外部 `target`。完整所有权、注册、preflight、启动/等待/继续/取消/对账和安全边界见 [SDK Embedder Guide §18](public_docs/sdk/embedder-guide.md#18-external-agent-executor-plane-feature_258-v0767)。
1526
+ **外部 Agent SDK plane(FEATURE_258,v0.7.67)**:`/agent` 导出协议中立的 executor、registration、policy、credential broker、artifact policy、catalog 和 durable task 契约;`/runtime` 通过 `admin.agentRegistrations`、`agents`、`agentTasks` 向共享 Host 客户端提供 DTO API。统一 Host 收口退役公开 executor factory 注入和进程内 owner 构造;支持的 A2A Agent 通过 Host 配置接入。任意 executor 函数仍可用于独立库,但没有透明等价的产品 Host API。Plane 关闭后是终态:未完成的 wait 和后续所有服务调用都会拒绝;受限 Workflow 脚本会完整校验并传递 `phase` 与外部 `target`。完整所有权、注册、preflight、启动/等待/继续/取消/对账和安全边界见 [SDK Embedder Guide §18](public_docs/sdk/embedder-guide.md#18-external-agent-executor-plane-feature_258-v0767)。
1438
1527
 
1439
1528
  **成本受控 Workflow SDK(FEATURE_259,v0.7.67)**:SDK 调用方用 run-scoped `modelTiers` 与 `workflow.maxConcurrency` 配置路由和并发,workflow 作者只表达 `fast` / `balanced` / `deep` 语义意图。terminal workflow event 回显 tier/source/fallback/usage/duration,持久化 `run.json.efficiencyReport` 给出 token coverage、role/tier 启动数、packet-read 拓扑、review wave 和 quality gate 结果。完整配置与遥测读取方式见 [SDK Embedder Guide §20](public_docs/sdk/embedder-guide.md#20-cost-disciplined-workflow-routing-and-telemetry-feature_259-v0767)。
1440
1529
 
1441
1530
  **Inline workflow authoring(FEATURE_246,v0.7.58;F270 于 v0.7.72 更新)**:Worker 在明确表达 Workflow 意图时,可通过 model-callable 的 `run_workflow` 工具在会话内编写并运行工作流。F270 退役 AMAW 与复杂度驱动激活;AMA 保留显式 `/workflow`、named/SDK 和自然语言 Workflow 请求。Workflow 子 Agent 统一运行在 Actor 控制面。详见 [docs/features/v0.7.58.md](docs/features/v0.7.58.md)、[docs/features/v0.7.72.md](docs/features/v0.7.72.md) 与 ADR-044/046/047/048/049/055。
1442
1531
 
1443
- **历史工作流激活分层(FEATURE_248 + FEATURE_249,v0.7.59;F270 于 v0.7.72 取代)**:v0.7.59 引入 AMAW 和 AMA 的显式请求行为。F270 退役 AMAW 及其复杂度驱动指令;SA 保持单独作业,AMA 成为唯一自适应多 Agent 模式,并且只在明确 Workflow 意图下激活 Workflow。详见 [docs/features/v0.7.59.md](docs/features/v0.7.59.md) 与 [docs/features/v0.7.72.md](docs/features/v0.7.72.md)。
1532
+ **历史工作流激活分层(FEATURE_248 + FEATURE_249,v0.7.59;F270 于 v0.7.72 取代)**:v0.7.59 引入 AMAW 和 AMA 的显式请求行为。F270 退役 AMAW 及其复杂度驱动指令;CLI/REPL 使用 AMA;SDK 显式 SA 和内部单 Agent 执行器继续兼容。AMA 是唯一自适应多 Agent 模式,并且只在明确 Workflow 意图下激活 Workflow。详见 [docs/features/v0.7.59.md](docs/features/v0.7.59.md) 与 [docs/features/v0.7.72.md](docs/features/v0.7.72.md)。
1444
1533
 
1445
1534
  **managed 工具路径的渐进披露(FEATURE_250,v0.7.60;当前策略于 v0.7.74 纠偏)**:deferred-tool 机制同时应用于 AMA managed path 与 SA。当前延迟集合精确包含 11 个工具:6 个 repo-intelligence、4 个 web/code discovery,以及 `run_workflow`;其 `input_schema` 仍可直接调用,完整描述按需由 `tool_search` 返回。5 个固定 `mcp_*` facade 与 `get_goal` / `create_goal` / `update_goal` 生命周期工具常驻完整契约。v0.7.74 的 Goal 纠偏相对旧 hint 仅增加约 109 个估算 schema token(其中常驻的 `get_goal` 反而少 12 token),消除一次发现往返,并且不改变工具 schema、handler、权限、Goal 状态或压缩保护。详见 [docs/features/v0.7.60.md](docs/features/v0.7.60.md) 与 [docs/features/v0.7.74.md](docs/features/v0.7.74.md#feature_250-v0774-correction-resident-goal-lifecycle-tools)。
1446
1535
 
@@ -22,14 +22,13 @@
22
22
  // "reasoningMode": "auto",
23
23
  // "thinking": true,
24
24
 
25
- // Agent harness: "ama" enables adaptive multi-agent use; "sa" forces one
26
- // agent. Permission profiles are "plan", "accept-edits", sandbox-first
25
+ // New product tasks use AMA with adaptive multi-agent use.
26
+ // Permission profiles are "plan", "accept-edits", sandbox-first
27
27
  // "auto", or direct-host "full-access". Full Access has no sandbox or
28
28
  // approval prompts; built-in dangerous-command fallbacks do not apply.
29
29
  // Explicit forbidden rules still block; explicit prompt rules cannot prompt.
30
30
  // Exec Policy is separate:
31
31
  // ~/.kodax/exec-policy.jsonc (and explicitly trusted project policy).
32
- // "agentMode": "ama",
33
32
  // "permissionMode": "accept-edits",
34
33
  // User-level Bash allow patterns. Project additions belong in
35
34
  // <project>/.kodax/config.local.json. Broad Bash(*) is rejected.