cdsa-harness 0.22.2 → 0.22.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cdsa-harness",
-  "version": "0.22.2",
+  "version": "0.22.4",
   "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.2";
+export const VERSION = "0.22.4";
 
 export const BUILTIN_PLUGINS = [p0];
 

package/src/cli.js

@@ -549,6 +549,12 @@ async function runSetup(ask, cfg) {
     return false;
   }
   cfg.provider = provider;
+  // ollama 설정이 남긴 base_url 잔재는 다른 provider 의 요청까지 그 주소로 보내버린다.
+  // provider 를 새로 고르면 지운다(ollama 는 아래에서 다시 채워진다).
+  if (provider !== "ollama" && cfg.base_url) {
+    console.log(c.dim(`(이전 설정의 base_url(${cfg.base_url}) 을 지웠어요 — ${provider} 공식 엔드포인트를 사용합니다)`));
+    cfg.base_url = "";
+  }
 
   if (provider === "mock") {
     cfg.model = "mock-agent";
@@ -1263,6 +1269,10 @@ export async function main(argv = []) {
       const p = user.split(/\s+/)[1];
       if (!PROVIDERS.includes(p)) { console.log(c.yellow(`provider 는 ${PROVIDERS.join("/")} 중 하나.`)); continue; }
       cfg.provider = p;
+      if (p !== "ollama" && cfg.base_url) {
+        console.log(c.dim(`(이전 설정의 base_url(${cfg.base_url}) 을 지웠어요 — ${p} 공식 엔드포인트를 사용합니다)`));
+        cfg.base_url = "";
+      }
       if (SUGGESTED_MODELS[p]?.length) cfg.model = SUGGESTED_MODELS[p][0];
       loop.client = makeClient(cfg);
       loop.reset();

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);
@@ -57,7 +69,7 @@ export class LLMClient {
       res = await fetch(url, { method: "POST", headers, body: json, signal: ctrl.signal });
     } catch (e) {
       clearTimeout(timer);
-      throw new LLMError(this._netErrorMessage(e));
+      throw new LLMError(this._netErrorMessage(e, url));
     }
     if (!res.ok) {
       clearTimeout(timer);
@@ -67,8 +79,24 @@ export class LLMClient {
     return { res, started, timer, bodyBytes: Buffer.byteLength(json, "utf8") };
   }
 
-  _netErrorMessage(e) {
-    return describeNetError(e, this.provider, this.timeout);
+  _netErrorMessage(e, url = "") {
+    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) {
@@ -80,7 +108,7 @@ export class LLMClient {
     try {
       res = await fetch(url, { method: "POST", headers, body: json, signal: ctrl.signal });
     } catch (e) {
-      throw new LLMError(this._netErrorMessage(e));
+      throw new LLMError(this._netErrorMessage(e, url));
     } finally {
       clearTimeout(timer);
     }
@@ -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 };
@@ -231,7 +259,7 @@ export class LLMClient {
 // Node 내장 fetch(undici)는 실패하면 겉면 메시지가 "fetch failed" 하나뿐이고,
 // 진짜 원인(DNS 실패·프록시·인증서 등)은 e.cause 체인 안에 숨어 있다.
 // 여기서 원인을 끝까지 파고들어 사용자에게 코드와 해결 힌트까지 보여준다.
-export function describeNetError(e, provider = "", timeout = 0) {
+export function describeNetError(e, provider = "", timeout = 0, url = "") {
   // 자체 타임아웃(AbortController)에 걸린 경우: fetch 는 AbortError 를 던진다.
   if (e?.name === "AbortError" || e?.name === "TimeoutError") {
     return `네트워크 오류: 응답 시간 초과(${timeout}ms). 네트워크가 느리거나 요청이 너무 클 수 있어요.`;
@@ -257,6 +285,19 @@ export function describeNetError(e, provider = "", timeout = 0) {
   else if (codes.length) msg += `\n  ↳ 원인 코드: ${codes.join(", ")}`;
 
   const has = (...cs) => cs.some((c) => codes.includes(c));
+
+  // provider 는 클라우드(anthropic 등)인데 요청이 로컬 주소로 가는 경우:
+  // 이전에 ollama 설정 등이 남긴 config.json 의 base_url 잔재가 원인이다.
+  // 이때 방화벽/프록시 힌트는 오답이므로 이 안내만 보여주고 끝낸다.
+  const localUrl = /^https?:\/\/(localhost|127\.0\.0\.1|\[?::1\]?)([:/]|$)/i.test(url);
+  if (localUrl && provider && provider !== "ollama") {
+    msg +=
+      `\n  ↳ provider 는 '${provider}' 인데 요청이 로컬 주소(${url})로 가고 있어요. ` +
+      "설정 파일(config.json)에 이전 ollama 설정의 base_url 이 남아 있을 가능성이 큽니다.\n" +
+      "  ↳ 해결: /setup 을 다시 실행하거나, config.json 에서 \"base_url\" 값을 지우고 재시작하세요.";
+    return msg;
+  }
+
   if (has("ENOTFOUND", "EAI_AGAIN")) {
     msg += "\n  ↳ DNS 조회 실패예요. 인터넷 연결을 확인하세요. 사내망이라면 프록시 뒤일 가능성이 큽니다(아래 프록시 안내 참고).";
   }