@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.
- package/CHANGELOG.md +352 -0
- package/README.md +154 -29
- package/README_CN.md +106 -17
- package/config-templates/config.example.jsonc +2 -3
- package/dist/artifacts/skills/artifact-review/SKILL.md +44 -7
- package/dist/builtin/code-review/SKILL.md +5 -17
- package/dist/builtin/git-workflow/SKILL.md +9 -8
- package/dist/builtin/skill-creator/SKILL.md +38 -108
- package/dist/builtin/skill-creator/references/evaluation.md +50 -0
- package/dist/builtin/skill-creator/scripts/analyze-benchmark.d.ts +2 -0
- package/dist/builtin/skill-creator/scripts/analyze-benchmark.js +6 -3
- package/dist/builtin/skill-creator/scripts/compare-runs.d.ts +2 -0
- package/dist/builtin/skill-creator/scripts/compare-runs.js +6 -3
- package/dist/builtin/skill-creator/scripts/grade-evals.d.ts +2 -0
- package/dist/builtin/skill-creator/scripts/grade-evals.js +6 -3
- package/dist/builtin/skill-creator/scripts/run-eval.js +3 -3
- package/dist/builtin/skill-creator/scripts/run-loop.js +2 -1
- package/dist/builtin/skill-creator/scripts/run-trigger-eval.d.ts +2 -0
- package/dist/builtin/skill-creator/scripts/run-trigger-eval.js +3 -1
- package/dist/builtin/skill-creator/scripts/utils.d.ts +1 -1
- package/dist/builtin/skill-creator/scripts/utils.js +8 -0
- package/dist/builtin/tdd/SKILL.md +24 -40
- package/dist/builtin/visual-review/SKILL.md +7 -3
- package/dist/chunks/agent-OY4U4WOU.js +2 -0
- package/dist/chunks/agent-adapter-NDH3DMPG.js +2 -0
- package/dist/chunks/argument-completer-Q6GMPJ74.js +2 -0
- package/dist/chunks/bedrock-native-Z5VNWF5U.js +4 -0
- package/dist/chunks/cell-ABNYMGXV.js +2 -0
- package/dist/chunks/{chunk-JNB2FL6P.js → chunk-3ZEJRVNA.js} +1 -1
- package/dist/chunks/chunk-45ZP2YHG.js +2 -0
- package/dist/chunks/chunk-4KR4VUZK.js +142 -0
- package/dist/chunks/chunk-4Y6U7AH4.js +9 -0
- package/dist/chunks/chunk-52EN2777.js +2 -0
- package/dist/chunks/chunk-5MDNQCAV.js +4 -0
- package/dist/chunks/chunk-5WZ5FUUD.js +14 -0
- package/dist/chunks/chunk-654JOM24.js +634 -0
- package/dist/chunks/chunk-65652LR4.js +2 -0
- package/dist/chunks/chunk-6VHO36HK.js +2 -0
- package/dist/chunks/chunk-7OTOH4PT.js +465 -0
- package/dist/chunks/chunk-7SX7CHYP.js +2 -0
- package/dist/chunks/chunk-7U2BL7CM.js +19 -0
- package/dist/chunks/chunk-A3SLNYBB.js +5 -0
- package/dist/chunks/{chunk-W7ZFQTOK.js → chunk-ADIWJDFS.js} +1 -1
- package/dist/chunks/chunk-AGUM5SWX.js +2 -0
- package/dist/chunks/chunk-BZF7WPRK.js +357 -0
- package/dist/chunks/chunk-D5OW7UD5.js +2 -0
- package/dist/chunks/chunk-E2Z754K5.js +366 -0
- package/dist/chunks/chunk-ED7D73C3.js +2 -0
- package/dist/chunks/chunk-F7H6CDJN.js +2 -0
- package/dist/chunks/chunk-FMZN5F3Q.js +2 -0
- package/dist/chunks/chunk-FZZMHNDB.js +42 -0
- package/dist/chunks/chunk-G2IMBA3R.js +29 -0
- package/dist/chunks/chunk-GYNAAIZP.js +18 -0
- package/dist/chunks/chunk-GZUWQZJD.js +2 -0
- package/dist/chunks/chunk-HA4IKFUK.js +2 -0
- package/dist/chunks/chunk-ISLK6R2P.js +2 -0
- package/dist/chunks/chunk-KDLOPBFZ.js +2 -0
- package/dist/chunks/chunk-KDRYQKT7.js +3 -0
- package/dist/chunks/chunk-KE2NBMAP.js +20 -0
- package/dist/chunks/chunk-KJBS6L7Q.js +351 -0
- package/dist/chunks/chunk-KQ3XVHKK.js +1157 -0
- package/dist/chunks/chunk-LPHKXPF7.js +190 -0
- package/dist/chunks/chunk-LWOGHKTL.js +2 -0
- package/dist/chunks/chunk-MJ4IGUD4.js +5 -0
- package/dist/chunks/chunk-N2B6A3CX.js +10 -0
- package/dist/chunks/chunk-NM3AINLH.js +142 -0
- package/dist/chunks/chunk-NQ4XK3B2.js +2 -0
- package/dist/chunks/chunk-P7OJRV5Z.js +2 -0
- package/dist/chunks/chunk-PRH5G5J7.js +12 -0
- package/dist/chunks/chunk-QP47JIWP.js +3 -0
- package/dist/chunks/chunk-SCGXZ2QT.js +127 -0
- package/dist/chunks/{chunk-FX4R5PB3.js → chunk-TXI6SHDO.js} +1 -1
- package/dist/chunks/chunk-UF3GZ5PO.js +2 -0
- package/dist/chunks/chunk-V4WSBIXB.js +2 -0
- package/dist/chunks/chunk-V5RCDBKU.js +2 -0
- package/dist/chunks/{chunk-JOPSY4GI.js → chunk-VT35IZEZ.js} +1 -1
- package/dist/chunks/chunk-W33QJA3M.js +2 -0
- package/dist/chunks/chunk-W6MHQ7ED.js +2 -0
- package/dist/chunks/chunk-WMMESRP3.js +9 -0
- package/dist/chunks/chunk-XGUGEVCK.js +4 -0
- package/dist/chunks/chunk-YB24NTBC.js +2 -0
- package/dist/chunks/chunk-ZT2LR3KD.js +2 -0
- package/dist/chunks/client-3JEK33QQ.js +2 -0
- package/dist/chunks/compaction-config-NKDAUZNH.js +2 -0
- package/dist/chunks/{construction-bootstrap-P4QKIZV5.js → construction-bootstrap-HCRLORKG.js} +1 -1
- package/dist/chunks/devtools-MVOFT6N7.js +2 -0
- package/dist/chunks/devtools-TXYDDL2A.js +2 -0
- package/dist/chunks/dist-NTS7CJG3.js +2 -0
- package/dist/chunks/errors-ER7ZRPWC.js +2 -0
- package/dist/chunks/google-native-45I4S26I.js +2 -0
- package/dist/chunks/host-RHJ3VGYE.js +2 -0
- package/dist/chunks/mistral-native-JXPIDDYZ.js +5 -0
- package/dist/chunks/model-WCSO7VEC.js +2 -0
- package/dist/chunks/permission-MTSFSB74.js +2 -0
- package/dist/chunks/pi-messages-5LLOZH57.js +16 -0
- package/dist/chunks/readline-helpers-KZQCE3NH.js +2 -0
- package/dist/chunks/responses-websocket-Y4N5GXD3.js +2 -0
- package/dist/chunks/run-manager-MWEV42C5.js +2 -0
- package/dist/chunks/running-session-3BYAXGLK.js +2 -0
- package/dist/chunks/skills-V7T55I4F.js +2 -0
- package/dist/chunks/tool-dispatch-ZVIDGKB4.js +2 -0
- package/dist/chunks/utils-WGRFGT7S.js +2 -0
- package/dist/generated-config-templates.json +6 -0
- package/dist/index.d.ts +34 -32
- package/dist/index.js +6 -6
- package/dist/kodax_bootstrap.js +4 -2
- package/dist/kodax_cli.js +1764 -2990
- package/dist/kodax_doctor.js +3 -0
- package/dist/kodax_resume.js +30 -30
- package/dist/manual-topics.json +2196 -0
- package/dist/native/darwin-arm64/kodax-text-transaction.node +0 -0
- package/dist/native/darwin-arm64/manifest.json +1 -1
- package/dist/native/win32-x64/kodax-windows-sandbox.exe +0 -0
- package/dist/native/win32-x64/kodax-windows-text-transaction.node +0 -0
- package/dist/native/win32-x64/manifest.json +2 -2
- package/dist/one-shot-task.js +2 -0
- package/dist/provider-auth-cli.js +16 -0
- package/dist/provider-capabilities.json +560 -40
- package/dist/runtime-daemon-schema.json +1 -0
- package/dist/sandbox-network-broker.js +260 -795
- package/dist/script-cell.js +1 -0
- package/dist/script-worker.cjs +2166 -0
- package/dist/sdk-a2a.d.ts +23 -22
- package/dist/sdk-a2a.js +6 -8
- package/dist/sdk-agent.d.ts +119 -96
- package/dist/sdk-agent.js +1 -1
- package/dist/sdk-client.d.ts +16 -10
- package/dist/sdk-client.js +1 -1
- package/dist/sdk-coding.d.ts +67 -79
- package/dist/sdk-coding.js +1 -1
- package/dist/sdk-experimental-memory.d.ts +3 -3
- package/dist/sdk-experimental-memory.js +1 -1
- package/dist/sdk-llm.d.ts +265 -14
- package/dist/sdk-llm.js +1 -1
- package/dist/sdk-mcp.d.ts +3 -3
- package/dist/sdk-mcp.js +1 -1
- package/dist/sdk-media.d.ts +41 -166
- package/dist/sdk-media.js +1 -1
- package/dist/sdk-repl.d.ts +81 -51
- package/dist/sdk-repl.js +2 -2
- package/dist/sdk-runtime.d.ts +216 -2989
- package/dist/sdk-runtime.js +1 -1
- package/dist/sdk-sandbox.js +1 -1
- package/dist/sdk-session.d.ts +15 -14
- package/dist/sdk-session.js +1 -1
- package/dist/sdk-skills.d.ts +2 -2
- package/dist/sdk-skills.js +1 -1
- package/dist/semantic-worker.js +121 -75
- package/dist/static-text.json +323 -0
- package/dist/storage-repair-cli.js +3 -0
- package/dist/types-chunks/auth-file.d-ovsHEqD4.d.ts +178 -0
- package/dist/types-chunks/{bash-prefix-extractor.d-DFH463j2.d.ts → bash-prefix-extractor.d-RblzA9kO.d.ts} +285 -168
- package/dist/types-chunks/{capability-learning.d-B4pxKwP4.d.ts → capability-learning.d-BXDEOON2.d.ts} +4 -4
- package/dist/types-chunks/{capability.d-DOF3r0fJ.d.ts → capability.d-DapzKxy3.d.ts} +1 -1
- package/dist/types-chunks/{capsule.d-CwpmHGFB.d.ts → capsule.d-C-saon3X.d.ts} +5 -5
- package/dist/types-chunks/{client-contract-CRm9ZpL2.d.ts → client-contract-D8HXN_iu.d.ts} +249 -67
- package/dist/types-chunks/{controller.d-B4GyqWri.d.ts → controller.d-C0SAuNKu.d.ts} +1 -1
- package/dist/types-chunks/{controller.d-P3H97ddz.d.ts → controller.d-pXik2EIy.d.ts} +71 -11
- package/dist/types-chunks/{cost-tracker.d-BeaenODW.d.ts → cost-tracker.d-D1CTx-IO.d.ts} +37 -7
- package/dist/types-chunks/{base.d-ZBOdjDUT.d.ts → errors.d-D73qdYbS.d.ts} +91 -74
- package/dist/types-chunks/{history-retrieval.d-BzKWDjzG.d.ts → history-retrieval.d-BwEUR9cb.d.ts} +2 -2
- package/dist/types-chunks/{manager.d-C8OlTe2J.d.ts → manager.d-BMH8Q6TV.d.ts} +1 -1
- package/dist/types-chunks/{manifest.d-COreAnXG.d.ts → manifest.d-r74es7yq.d.ts} +1 -1
- package/dist/types-chunks/{provider-credential-context.d-BH2OaB1b.d.ts → provider-credential-context.d-Dw-sWcnu.d.ts} +11 -2
- package/dist/types-chunks/{provider-request-observation.d-C_bEqr4m.d.ts → provider-request-observation.d-CNe9vse3.d.ts} +4 -2
- package/dist/types-chunks/{public-api.d-BLmqDi73.d.ts → public-api.d-CvDSMmN2.d.ts} +13 -10
- package/dist/types-chunks/queue-BxQhqhFM.d.ts +166 -0
- package/dist/types-chunks/{resolver.d-DLY01RHx.d.ts → resolver.d-DrkpD8wY.d.ts} +142 -103
- package/dist/types-chunks/{review-inbox.d-BTLDdpG2.d.ts → review-inbox.d-Bgt46S7L.d.ts} +16 -3
- package/dist/types-chunks/{review-packet.d-Crra1Q7t.d.ts → review-packet.d-C0NYHPdq.d.ts} +7 -7
- package/dist/types-chunks/{run-manager.d-DmS1edk4.d.ts → run-manager.d-COrEJ-hn.d.ts} +41 -11
- package/dist/types-chunks/{runtime-client-info-BBBxdU8V.d.ts → runtime-client-info-DJ9srk4O.d.ts} +88 -7
- package/dist/types-chunks/runtime-event-B24TGIxk.d.ts +48 -0
- package/dist/types-chunks/sdk-runtime-CBPScTNR.d.ts +2236 -0
- package/dist/types-chunks/{sdk-session-DipY_CCd.d.ts → sdk-session-D_bf_sN2.d.ts} +13 -4
- package/dist/types-chunks/{sdk-skills-DokfOoJF.d.ts → sdk-skills-C-UA1A6I.d.ts} +3 -1
- package/dist/types-chunks/{side-query.d-DTrhVd_r.d.ts → side-query.d-UFKdWSw7.d.ts} +4 -4
- package/dist/types-chunks/{types.d-Jxj49rqO.d.ts → skill-invocation-error.d-FJ6ZujRz.d.ts} +24 -14
- package/dist/types-chunks/task-results.d-XMdWq0eA.d.ts +15 -0
- package/dist/types-chunks/{trusted-repl-entry-B1cb7lAn.d.ts → trusted-repl-entry-9i4hUuj-.d.ts} +10 -10
- package/dist/types-chunks/{types.d-BjOq57-z.d.ts → types.d-Bi8iUd6x.d.ts} +248 -4
- package/dist/types-chunks/types.d-BvEGNdN-.d.ts +131 -0
- package/dist/types-chunks/{types.d-NyCB6ztO.d.ts → types.d-CTo0NiAM.d.ts} +22 -13
- package/dist/types-chunks/{types.d-Cb8RdrjU.d.ts → types.d-D8qQjMeo.d.ts} +5 -1
- package/dist/types-chunks/{utils.d-Bt6USYa5.d.ts → utils.d-BhoGV3yv.d.ts} +11 -7
- package/dist/windows-native-scripts.json +5 -0
- package/docs/ARTIFACT_SDK.md +8 -0
- package/docs/CLIENT_CONTRACT.md +195 -9
- package/docs/SDK_MIGRATION.md +624 -2
- package/docs/SPACE_SDK_SEAMS.md +255 -2
- package/package.json +33 -6
- package/public_docs/README.md +22 -2
- package/public_docs/configuration/config-files.md +6 -0
- package/public_docs/configuration/custom-providers.md +62 -0
- package/public_docs/configuration/providers.md +238 -3
- package/public_docs/configuration/sandbox.md +30 -0
- package/public_docs/getting-started/quickstart.md +10 -1
- package/public_docs/sdk/embedder-guide.md +476 -206
- package/dist/chunks/agent-Q3KETYAO.js +0 -2
- package/dist/chunks/argument-completer-YBLONGXK.js +0 -2
- package/dist/chunks/chunk-2AM3FRQ7.js +0 -137
- package/dist/chunks/chunk-35P7QL2Q.js +0 -2
- package/dist/chunks/chunk-76OPYNVX.js +0 -298
- package/dist/chunks/chunk-D73IHTHH.js +0 -350
- package/dist/chunks/chunk-EKMVGLHV.js +0 -22
- package/dist/chunks/chunk-FK7AP3FS.js +0 -394
- package/dist/chunks/chunk-FL5KAFQZ.js +0 -2
- package/dist/chunks/chunk-HCLUUEDQ.js +0 -2
- package/dist/chunks/chunk-HD5BDOPC.js +0 -2
- package/dist/chunks/chunk-HTLRQB72.js +0 -431
- package/dist/chunks/chunk-KH7BRH2Q.js +0 -429
- package/dist/chunks/chunk-MIS2WZPP.js +0 -635
- package/dist/chunks/chunk-NFGFHUO6.js +0 -69
- package/dist/chunks/chunk-ONUPGMER.js +0 -2
- package/dist/chunks/chunk-ORH7UGCN.js +0 -2
- package/dist/chunks/chunk-PRJR2WBC.js +0 -19
- package/dist/chunks/chunk-RSUAZDLC.js +0 -351
- package/dist/chunks/chunk-UE3J7V5F.js +0 -497
- package/dist/chunks/chunk-V26LAWJY.js +0 -2
- package/dist/chunks/chunk-VNPYCHJA.js +0 -260
- package/dist/chunks/chunk-XMWTEVFZ.js +0 -1481
- package/dist/chunks/chunk-XXU6HP6N.js +0 -12
- package/dist/chunks/chunk-YVBBU6K5.js +0 -5
- package/dist/chunks/client-XFASU74S.js +0 -2
- package/dist/chunks/compaction-config-JZNGDKWW.js +0 -2
- package/dist/chunks/devtools-CD6KSIHE.js +0 -2
- package/dist/chunks/devtools-XR5F2C6T.js +0 -2
- package/dist/chunks/dist-2B3JWYFP.js +0 -2
- package/dist/chunks/dist-ZLR4OTDD.js +0 -2
- package/dist/chunks/host-PMDL4OM2.js +0 -2
- package/dist/chunks/readline-helpers-5JGWEVMK.js +0 -2
- package/dist/chunks/run-manager-KW252NVZ.js +0 -2
- package/dist/chunks/tool-dispatch-G2E7DV5U.js +0 -2
- 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
|
-
|
|
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`
|
|
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
|
|
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.
|
|
488
|
-
|
|
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 |
|
|
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
|
|
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`,
|
|
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
|
|
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
|
-
|
|
1635
|
-
`createConfiguredA2ARuntimeIntegration({ configHome })`
|
|
1636
|
-
|
|
1637
|
-
|
|
1638
|
-
|
|
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 {
|
|
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
|
|
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-
|
|
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 {
|
|
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`
|
|
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 (
|
|
2305
|
-
| mimo | `MIMO_API_KEY` | Native | mimo-v2.
|
|
2306
|
-
| mimo-coding | `MIMO_CODING_API_KEY` | Native | mimo-v2.
|
|
2307
|
-
| ark-coding | `ARK_CODING_API_KEY` | Native | glm-5.3 (
|
|
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
|
|
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
|
-
|
|
2424
|
-
|
|
2425
|
-
- **
|
|
2426
|
-
- **
|
|
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`
|
|
119
|
+
两个产品入口均支持可选 `onStartupProgress` 和共享 `ClientStartupProgress` 类型;新 Host 通过 `initializing/phase` 报告内部初始化步骤,不增加额外探测或等待。启动 `ready` 表示 Client 接口可用;Session 加载与 UI 渲染仍有独立完成边界。详见[启动进度示例](public_docs/sdk/embedder-guide.md#show-local-startup-progress)。
|
|
102
120
|
|
|
103
|
-
底层 `/runtime`
|
|
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'; //
|
|
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
|
-
|
|
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`〔
|
|
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(
|
|
1195
|
-
| mimo | `MIMO_API_KEY` | Native | mimo-v2.
|
|
1196
|
-
| mimo-coding | `MIMO_CODING_API_KEY` | Native | mimo-v2.
|
|
1197
|
-
| ark-coding | `ARK_CODING_API_KEY` | Native | glm-5.3
|
|
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 |
|
|
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
|
|
1410
|
-
|
|
1411
|
-
|
|
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`
|
|
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
|
|
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
|
-
//
|
|
26
|
-
//
|
|
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.
|