cdsa-harness 0.22.3 → 0.22.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdsa-harness",
-  "version": "0.22.3",
+  "version": "0.22.5",
   "description": "AI 에이전트의 내부 동작을 단계별로 드러내는 교육용 터미널 하네스. 실시간 스트리밍 + OpenAI/Claude/OpenRouter + MCP + npm 플러그인·크로스포맷 스킬.",
   "type": "module",
   "bin": {

package/src/builtins.js

@@ -2,7 +2,7 @@
 // 스킬/플러그인/버전을 바꾼 뒤 `node scripts/gen-builtins.mjs` 로 재생성하세요.
 import p0 from "../plugins/hwpx_read.mjs";
 
-export const VERSION = "0.22.3";
+export const VERSION = "0.22.5";
 
 export const BUILTIN_PLUGINS = [p0];
 

package/src/cli.js

@@ -297,7 +297,12 @@ async function fetchProviderModels(cfg, query = "") {
   try {
     if (cfg.provider === "openrouter") {
       const r = await fetchJson("https://openrouter.ai/api/v1/models");
-      let ids = (r.data || []).map((m) => m.id).sort();
+      // 하네스는 항상 도구(tools)를 함께 보내므로, 도구를 지원하지 않는 모델은 어차피
+      // "No endpoints found that support tool use" 로 실패한다 — 목록에서 미리 제외.
+      let ids = (r.data || [])
+        .filter((m) => !Array.isArray(m.supported_parameters) || m.supported_parameters.includes("tools"))
+        .map((m) => m.id)
+        .sort();
       if (q) ids = ids.filter((id) => id.toLowerCase().includes(q));
       return { list: ids, live: true };
     }

package/src/llm.js

@@ -46,6 +46,18 @@ export class LLMClient {
     throw new LLMError(`지원하지 않는 provider 입니다: ${this.provider}`);
   }
 
+  // _post/_openStream 을 감싸, 샘플링 파라미터 거부(400)를 만나면 빼고 1회 재시도.
+  async _sendWithSamplingRetry(send, body) {
+    if (this._noSampling) this._stripSampling(body);
+    try {
+      return await send(body);
+    } catch (e) {
+      if (!this._shouldRetryWithoutSampling(e, body)) throw e;
+      this._stripSampling(body);
+      return await send(body);
+    }
+  }
+
   // 스트리밍용: 응답 객체(본문 스트림)를 그대로 받는다.
   async _openStream(url, headers, body) {
     const json = JSON.stringify(body);
@@ -71,6 +83,22 @@ export class LLMClient {
     return describeNetError(e, this.provider, this.timeout, url);
   }
 
+  // 최신 Claude 모델(Sonnet 5, Opus 4.7+ 등)은 temperature/top_p/top_k 샘플링 파라미터를
+  // 거부한다(400: "`temperature` is deprecated for this model."). 모델 목록을 하드코딩하는
+  // 대신 그 400 을 감지하면 파라미터를 빼고 1회 재시도하고, 세션 동안 기억해 다시 안 보낸다.
+  _shouldRetryWithoutSampling(e, body) {
+    if (this._noSampling) return false;
+    if (!("temperature" in body || "top_p" in body || "top_k" in body)) return false;
+    return e instanceof LLMError && /API 오류 400/.test(e.message) && /temperature|top_p|top_k/.test(e.message);
+  }
+
+  _stripSampling(body) {
+    this._noSampling = true;
+    delete body.temperature;
+    delete body.top_p;
+    delete body.top_k;
+  }
+
   async _post(url, headers, body) {
     const json = JSON.stringify(body);
     const ctrl = new AbortController();
@@ -108,7 +136,7 @@ export class LLMClient {
       headers["HTTP-Referer"] = "https://github.com/cdsassj00/miniharness";
       headers["X-Title"] = "CDSA Harness";
     }
-    const { payload, latencyMs, bodyBytes } = await this._post(url, headers, body);
+    const { payload, latencyMs, bodyBytes } = await this._sendWithSamplingRetry((b) => this._post(url, headers, b), body);
     const parsed = parseOpenAiReply(payload);
     return {
       ...parsed,
@@ -126,7 +154,7 @@ export class LLMClient {
       "anthropic-version": "2023-06-01",
       "Content-Type": "application/json",
     };
-    const { payload, latencyMs, bodyBytes } = await this._post(url, headers, body);
+    const { payload, latencyMs, bodyBytes } = await this._sendWithSamplingRetry((b) => this._post(url, headers, b), body);
     const parsed = parseAnthropicReply(payload);
     return {
       ...parsed,
@@ -148,7 +176,7 @@ export class LLMClient {
       headers["HTTP-Referer"] = "https://github.com/cdsassj00/miniharness";
       headers["X-Title"] = "CDSA Harness";
     }
-    const { res, started, timer, bodyBytes } = await this._openStream(url, headers, body);
+    const { res, started, timer, bodyBytes } = await this._sendWithSamplingRetry((b) => this._openStream(url, headers, b), body);
     let content = "";
     const tcMap = new Map(); // index -> {id,name,args}
     let usage = null;
@@ -183,7 +211,7 @@ export class LLMClient {
     const body = toAnthropicBody(messages, tools, this.model, this.temperature, this.maxTokens);
     body.stream = true;
     const headers = { "x-api-key": this.apiKey, "anthropic-version": "2023-06-01", "Content-Type": "application/json" };
-    const { res, started, timer, bodyBytes } = await this._openStream(url, headers, body);
+    const { res, started, timer, bodyBytes } = await this._sendWithSamplingRetry((b) => this._openStream(url, headers, b), body);
     let content = "";
     const blocks = new Map(); // index -> {type,name,id,json}
     let usage = { input: null, output: null, total: 0 };
@@ -318,6 +346,15 @@ function safeParse(jsonStr) {
 
 function httpErrorMessage(status, text) {
   let msg = `API 오류 ${status}: ${trim(text)}`;
+  // 도구(tool use) 미지원 모델/엔드포인트 — 모델명 오타 힌트는 오답이므로 여기서 끝낸다.
+  if (/tool[ _]use|support tools?/i.test(text)) {
+    msg +=
+      "\n  ↳ 이 모델(또는 이 모델의 제공 엔드포인트)이 도구 호출(tool use)을 지원하지 않아요. " +
+      "에이전트 하네스는 파일 도구가 필수라 도구 지원 모델이 필요합니다." +
+      "\n  ↳ /models 로 다른 모델을 고르세요 — OpenRouter 목록은 도구 지원 모델만 표시됩니다 " +
+      "(예: anthropic/claude-sonnet-4.5, openai/gpt-4o-mini).";
+    return msg;
+  }
   if (status === 404) {
     msg += "\n  ↳ 모델 이름을 확인하세요. /model 로 변경 가능. " +
       "OpenRouter 는 'provider/model' 형식이어야 합니다 (예: openai/gpt-4o-mini, anthropic/claude-3.7-sonnet).";