@kodax-ai/kodax 0.7.52 → 0.7.53

package/README.md

@@ -712,6 +712,11 @@ export KODAX_VERIFIER_MODEL=claude-haiku-4-5-20251001
 - `KODAX_VERIFIER_PROVIDER` + `KODAX_VERIFIER_MODEL` route the verifier to a separate provider/model instead of inheriting the main Worker model. Set both together.
 - `KODAX_VERIFIER_ALWAYS=1` forces the verifier to fire on every text-only completion for debugging/regression sweeps.
 
+SDK/headless hosts can observe actionable Sidecar Verifier messages via
+`KodaXEvents.onSidecarMessage`; JSONL output emits the same payload as
+`sidecar.message`. Only `revise` and `blocked` verdicts are surfaced; `accept`
+stays silent.
+
 ## Advanced Library Usage
 
 #### Simple Mode (runKodaX)
@@ -723,6 +728,7 @@ const events: KodaXEvents = {
   onTextDelta: (text) => process.stdout.write(text),
   onThinkingDelta: (text) => console.log(`Thinking delta: ${text.length} chars`),
   onToolResult: (result) => console.log(`Tool ${result.name}: ${result.content.slice(0, 100)}`),
+  onSidecarMessage: (event) => console.log(`[sidecar:${event.verdict}] ${event.content}`),
   onComplete: () => console.log('\nDone!'),
   onError: (e) => console.error(e.message),
 };

package/README_CN.md

@@ -284,6 +284,10 @@ export KODAX_VERIFIER_MODEL=claude-haiku-4-5-20251001
 
 `KODAX_VERIFIER_LOG=1` 等价于在 `~/.kodax/config.json` 写 `"verifierLog": true`，会显示 verifier gate、elapsedMs 和 trace；`KODAX_VERIFIER_PROVIDER` / `KODAX_VERIFIER_MODEL` 需要成对设置，用独立模型执行 verifier；`KODAX_VERIFIER_ALWAYS=1` 仅建议调试和回归测试时使用。
 
+SDK / headless 宿主可以通过 `KodaXEvents.onSidecarMessage` 观察 Sidecar
+Verifier 的 `revise` / `blocked` 可执行消息；JSONL 输出使用同形
+`sidecar.message` 事件。`accept` 仍保持静默。
+
 #### 给自定义 provider 开图片 / vision 输入（FEATURE_134 v0.7.40）
 
 如果你的自定义 provider 后面的模型支持 vision，加 `capabilityProfile.multimodalSupport: "image-input"` 显式开启，KodaX 的 SA-path policy gate 就不会人为拦截多模态请求。内置 vision-capable alias（Anthropic、OpenAI、DeepSeek、Kimi、Qwen、Zhipu、MiniMax、MiMo、Ark，以及通过 CLI `@<path>` file-include 语法传图的 Gemini-CLI）已经默认开了这个 flag。Codex-CLI 和自定义 provider 在底层模型支持图片输入时需要手动 opt-in。

package/dist/chunks/{agent-XXTR7T37.js → agent-DZ37KWZI.js}

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{Nb as c,Ob as d,Pb as e,Qb as f,_c as i,cd as j,hc as g,ic as h}from"./chunk-5USNUSTL.js";import"./chunk-LE6STNVN.js";import{jb as a,kb as b}from"./chunk-HMATTIU6.js";import"./chunk-V4WSBIXB.js";export{d as bucketProviderPayloadSize,g as buildAutoRepoIntelligenceContext,e as checkPromiseSignal,b as cleanupIncompleteToolCalls,h as describeTransientProviderRetry,f as emitResilienceDebug,c as estimateProviderPayloadBytes,j as runKodaX,i as saveSessionSnapshot,a as validateAndFixToolHistory};
+import{Ob as c,Pb as d,Qb as e,Rb as f,dd as i,ic as g,id as j,jc as h}from"./chunk-OQL4ISVD.js";import"./chunk-LE6STNVN.js";import{jb as a,kb as b}from"./chunk-XFCAXDSD.js";import"./chunk-V4WSBIXB.js";export{d as bucketProviderPayloadSize,g as buildAutoRepoIntelligenceContext,e as checkPromiseSignal,b as cleanupIncompleteToolCalls,h as describeTransientProviderRetry,f as emitResilienceDebug,c as estimateProviderPayloadBytes,j as runKodaX,i as saveSessionSnapshot,a as validateAndFixToolHistory};

package/dist/chunks/argument-completer-OFPM36IZ.js

@@ -0,0 +1,2 @@
+// @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
+import{ta as a,ua as b}from"./chunk-RFE5EC7W.js";import"./chunk-D4MGMUDL.js";import"./chunk-5YQDGVDB.js";import"./chunk-CLIRXPAJ.js";import"./chunk-OQL4ISVD.js";import"./chunk-LE6STNVN.js";import"./chunk-XFCAXDSD.js";import"./chunk-V4WSBIXB.js";export{a as ArgumentCompleter,b as createArgumentCompleter};

package/dist/chunks/{chunk-JJTUBNQX.js → chunk-5YQDGVDB.js}

@@ -1,2 +1,2 @@
 // @kodax-ai/kodax — bundled distribution. See docs/ADR.md ADR-022 + ADR-024.
-import{wa as e}from"./chunk-HMATTIU6.js";import{a as n}from"./chunk-V4WSBIXB.js";import{readFile as i}from"fs/promises";var c={enabled:!0,triggerPercent:75};async function g(o){let t=e("config.json");try{let r=await a(t);if(r?.compaction)return{...c,...r.compaction}}catch{}return c}n(g,"loadCompactionConfig");async function a(o){try{let t=await i(o,"utf-8");return JSON.parse(t)}catch{return null}}n(a,"readConfigFile");export{g as a};
+import{wa as e}from"./chunk-XFCAXDSD.js";import{a as n}from"./chunk-V4WSBIXB.js";import{readFile as i}from"fs/promises";var c={enabled:!0,triggerPercent:75};async function g(o){let t=e("config.json");try{let r=await a(t);if(r?.compaction)return{...c,...r.compaction}}catch{}return c}n(g,"loadCompactionConfig");async function a(o){try{let t=await i(o,"utf-8");return JSON.parse(t)}catch{return null}}n(a,"readConfigFile");export{g as a};