deel-local-cli 1.8.0 → 1.10.0

package/src/backend/adapter.js

@@ -5,6 +5,7 @@ import { 할당량기억 } from './quota.js';
 import { 열쇠 as 열쇠받아오기, 쓸수있나 } from '../safety/authcmd.js';
 import { 말 } from '../i18n/index.js';
 import { 다시부를지, 기다리기, 정책고르기 } from './retry.js';
+import { 도구맞추기, 이름되돌리기, 벤더 } from './toolfit.js';
 
 /*
  * Anthropic 규격의 판 이름.
@@ -59,7 +60,7 @@ export function 요청주소(conn) {
   return 주소붙이기(conn?.base, endpoint(conn?.kind));
 }
 
-export function buildBody(shape, { model, messages, tools, stream, json, think, maxTokens = 4096, ctx = null }) {
+export function buildBody(shape, { model, messages, tools, stream, json, think, maxTokens = 4096, ctx = null, 회사 = null }) {
   if (shape === 'ollama') {
     const body = { model, messages, stream: !!stream, options: { num_predict: maxTokens } };
     /*
@@ -89,7 +90,13 @@ export function buildBody(shape, { model, messages, tools, stream, json, think,
     body.keep_alive = process.env.DEEL_KEEP_ALIVE || '60m';
     if (tools?.length) body.tools = tools;
     if (json) body.format = json;
-    if (think !== undefined) body.think = think;
+    // 참·거짓은 그대로(생각을 켜고 끄는 말이다). 단계말은 이 규격이 아는
+    // 말로 옮긴다 — 아래 강도말() 머리말 참고.
+    if (typeof think === 'boolean') body.think = think;
+    else if (think !== undefined) {
+      const 눈금 = 강도말(think);
+      if (눈금) body.think = 눈금;
+    }
     return body;
   }
   if (shape === 'anthropic') return anthropic몸(
@@ -102,14 +109,31 @@ export function buildBody(shape, { model, messages, tools, stream, json, think,
   // max_tokens 만 보내면 상한이 안 걸린 것처럼 제 기본값으로 답하고, 우리가
   // 셈해 둔 자리와 어긋난다. 사용자 게이트웨이가 바로 그 경우였다.
   //
-  // 둘 다 보내도 탈이 없다. 옛 서버는 모르는 이름을 무시하고, 새 서버는
-  // 제가 보는 이름을 골라 쓴다. 둘 중 무엇을 보는지 우리가 알 필요가 없어진다.
-  const body = { model, messages, stream: !!stream, max_tokens: maxTokens, max_completion_tokens: maxTokens };
+  // 둘 다 보내도 탈이 없다 — **한 곳만 빼고.** 옛 서버는 모르는 이름을 무시하고,
+  // 새 서버는 제가 보는 이름을 골라 쓴다. 둘 중 무엇을 보는지 우리가 알 필요가
+  // 없어진다.
+  //
+  // ── 그 한 곳: OpenAI 직통 ──────────────────────────────────────────────
+  //
+  // 여기 추론 모델(o 계열·GPT-5 계열)은 옛 이름을 **무시하지 않고 튕긴다** —
+  // "Unsupported parameter: 'max_tokens' is not supported with this model."
+  // 그러면 첫 요청부터 400 이고, 화면에서는 열쇠가 틀린 것과 구별이 안 된다.
+  // 모델 이름으로 가르지 않는다(게이트웨이 뒤에 무엇이 있는지 우리는 모른다).
+  // **주소로** 가른다 — 그 규칙은 toolfit.js 의 벤더() 한 곳에서만 정한다.
+  //
+  // Azure 는 여기 안 넣는다. 옛 판(api-version)이 아직 많고 그쪽은 옛 이름만
+  // 본다 — 같이 묶으면 멀쩡히 쓰던 사내 Azure 연결이 이 줄 하나로 끊긴다.
+  const 옛이름도 = 회사 !== 'openai';
+  const body = { model, messages, stream: !!stream, max_completion_tokens: maxTokens };
+  if (옛이름도) body.max_tokens = maxTokens;
   if (tools?.length) { body.tools = tools; body.tool_choice = 'auto'; }
   if (json) {
     body.response_format = { type: 'json_schema', json_schema: { name: 'out', schema: json, strict: true } };
   }
-  if (think !== undefined && think !== false) body.reasoning_effort = think;
+  if (think !== undefined && think !== false) {
+    const 눈금 = 강도말(think);
+    if (눈금) body.reasoning_effort = 눈금;
+  }
   return body;
 }
 
@@ -132,6 +156,68 @@ export function buildBody(shape, { model, messages, tools, stream, json, think,
  *   · think — 생각 칸의 값 모양을 문서에서 확인하지 못했다.
  *   · json  — 이 규격에는 답 모양을 강제하는 칸이 없다. 도구로 하는 방법뿐이다.
  */
+/*
+ * ── 이 규격의 추론 강도 ────────────────────────────────────────────────
+ *
+ * OpenAI 호환 쪽은 `reasoning_effort: 'high'` 처럼 **말**로 준다. 이쪽은
+ * **토큰 수**로 준다 — `thinking: { type:'enabled', budget_tokens: 12000 }`.
+ * 그래서 우리 단계말(low·medium·high·max)을 숫자로 옮겨야 한다.
+ *
+ * 여태 이 자리가 비어 있었다. anthropic몸() 이 think 를 인자로 받아 놓고 한
+ * 번도 안 썼다. 그래서 Claude 를 직접 붙이면 상태줄에는 `◇ medium` 이 뜨는데
+ * 요청에는 아무것도 안 실렸다 — **화면과 전선이 다른 말을 하고 있었다.**
+ * 아무 일도 안 하는 것보다 나쁘다. 사람은 조절했다고 믿기 때문이다.
+ *
+ * 지키는 선 둘(둘 다 서버가 거절하는 자리다):
+ *   · 최소 1,024. 그보다 작게 주면 요청이 통째로 튕긴다.
+ *   · max_tokens 보다 작아야 한다. 생각도 그 예산에서 나가기 때문이다.
+ *     그래서 답이 설 자리를 남겨 두고 깎는다. 그러고도 1,024 가 안 되면
+ *     생각을 아예 안 켠다 — 켤 수 없는 자리에서 켜면 그 턴이 죽는다.
+ */
+const 생각최소 = 1024;
+const 답에남길것 = 1024;
+const 강도별예산 = { low: 2048, medium: 6144, high: 16384, max: 32768 };
+
+/*
+ * ── 우리 눈금은 다섯, 전선 위의 눈금은 넷 ──────────────────────────────
+ *
+ * agent/effort.js 의 눈금은 off·low·medium·high·**max** 다. 그런데 `max` 를
+ * 받는 창구는 하나도 없다 — OpenAI 는 minimal·low·medium·high, Gemini 의
+ * OpenAI 호환 창구는 none·low·medium·high, Ollama 는 참·거짓이거나
+ * low·medium·high 다. 그 말을 그대로 실어 보내면 400 이고, 그 400 은 화면에서
+ * 열쇠가 틀린 것과 구별이 안 된다.
+ *
+ * 여태 그대로 흘려보내고 있었다. 그리고 이 자리는 `/think max` 를 친
+ * 사람만 밟는 것이 아니다 — `깊게` 배분은 첫 판단과 막혔을 때를 한 칸씩
+ * 올리므로, `/think high` 만 해도 그 두 자리가 `max` 가 된다. 즉 **가장
+ * 세게 생각하라고 시킨 턴만 골라서 죽는다.**
+ *
+ * 그래서 여기서 전선이 아는 말로 옮긴다. `max` 는 그 규격이 낼 수 있는 제일
+ * 센 말(high)이 된다 — 없는 칸을 지어내지 않고, 있는 칸 중 가장 위에 선다.
+ *
+ * Anthropic 규격은 여기 안 온다. 거기는 말이 아니라 **숫자 예산**으로 주므로
+ * (아래 생각예산) `max` 가 32,768 이라는 진짜 값이 된다. 눈금이 모자라지 않는다.
+ *
+ * 모르는 말은 **안 보낸다.** 짐작으로 실은 칸 하나가 그 턴을 죽인다.
+ *
+ * 받은 값을 담는 자리를 `말` 이라고 부르지 않는다. 이 파일에서 `말` 은
+ * i18n 의 그 함수라, 같은 이름으로 가리면 그 블록 안에서는 화면에 말을 걸
+ * 수가 없어진다 — 나중에 한 줄 더 적으려는 사람이 거기서 넘어진다.
+ */
+const 전선눈금 = { low: 'low', medium: 'medium', high: 'high', max: 'high' };
+
+export function 강도말(강도) {
+  return 전선눈금[String(강도)] ?? null;
+}
+
+export function 생각예산(강도, maxTokens) {
+  const 바라는것 = 강도별예산[String(강도)];
+  if (!바라는것) return 0;
+  const 쓸수있는 = Math.floor(Number(maxTokens) || 0) - 답에남길것;
+  const 예산 = Math.min(바라는것, 쓸수있는);
+  return 예산 >= 생각최소 ? 예산 : 0;
+}
+
 function anthropic몸({ model, messages, tools, stream, json, think, maxTokens }) {
   const 머리말 = [];
   const 나머지 = [];
@@ -141,6 +227,8 @@ function anthropic몸({ model, messages, tools, stream, json, think, maxTokens }
   }
   const body = { model, messages: 차례합치기(나머지), stream: !!stream, max_tokens: maxTokens };
   if (머리말.length) body.system = 머리말.join('\n\n');
+  const 예산 = 생각예산(think, maxTokens);
+  if (예산) body.thinking = { type: 'enabled', budget_tokens: 예산 };
   if (tools?.length) {
     body.tools = tools.map((t) => {
       const f = t.function ?? t;
@@ -181,15 +269,29 @@ export function extractMessage(shape, json) {
     // 답이 블록 배열이다. 글·생각·도구 부름이 한 배열에 섞여 온다.
     let content = '';
     let thinking = '';
+    /*
+     * 생각 블록은 **받은 그대로** 따로 챙긴다.
+     *
+     * 글자만 이어 붙이면 안 된다. 이 규격의 생각 블록에는 서명(signature)이
+     * 딸려 있고, 도구를 쓰는 턴에서는 그 블록을 서명째 돌려보내야 서버가
+     * 받는다. 서명 없이 지어서 보내면 그 턴이 통째로 거절된다.
+     * redacted_thinking 은 속을 우리가 못 읽는 블록인데, 그것도 그대로
+     * 돌려보내야 한다 — 읽지 말고 나르라는 뜻이다.
+     */
+    const 생각블록 = [];
     const 부름들 = [];
     for (const b of Array.isArray(json?.content) ? json.content : []) {
       if (b?.type === 'text') content += b.text ?? '';
-      else if (b?.type === 'thinking') thinking += b.thinking ?? '';
+      else if (b?.type === 'thinking') {
+        thinking += b.thinking ?? '';
+        생각블록.push({ type: 'thinking', thinking: b.thinking ?? '', signature: b.signature ?? '' });
+      } else if (b?.type === 'redacted_thinking') 생각블록.push({ type: 'redacted_thinking', data: b.data });
       else if (b?.type === 'tool_use') 부름들.push({ id: b.id, name: b.name, args: b.input ?? {} });
     }
     return {
       content,
       thinking,
+      생각블록,
       toolCalls: normalizeCalls(부름들),
       // 이름이 다르다. prompt_tokens 를 찾으면 늘 0 이 나오고, 화면에는
       // 「토큰을 하나도 안 썼다」 로 뜬다.
@@ -258,20 +360,39 @@ export function normalizeCalls(list) {
 }
 
 // 대화 이력에 되돌려 넣을 메시지 만들기 — 규격마다 모양이 다르다.
-export function assistantMessage(shape, { content = '', thinking = '', toolCalls = [] }) {
+export function assistantMessage(shape, { content = '', thinking = '', toolCalls = [], 생각블록 = null }) {
   if (shape === 'anthropic') {
+    /*
+     * ── 생각 블록을 **맨 앞에, 받은 그대로** 돌려보낸다 ──────────────────
+     *
+     * 여기는 오래 비어 있던 자리다. 예전 주석은 「서명 조각을 제대로 모으는
+     * 것까지 확인하지 못했으므로 뺀다」 였다. 이제 모은다(흘려받기의
+     * signature_delta). 그래서 실을 수 있다.
+     *
+     * 왜 실어야 하나 — 생각을 켜고 도구를 쓰면, 서버는 그 도구 부름을 낳은
+     * 생각 블록이 **같이 돌아오기를** 요구한다. 안 보내면 그 턴이 거절된다.
+     * 즉 생각을 켜는 것과 이 블록을 나르는 것은 한 몸이다.
+     *
+     * 서명은 우리가 읽거나 고칠 것이 아니다. 받은 문자열 그대로 나른다.
+     * 서명이 빈 블록은 아예 안 싣는다 — 지어낸 서명은 거절당하고, 그러면
+     * 왜 안 되는지가 화면에서 안 보인다.
+     */
     const 블록 = [];
+    for (const b of 생각블록 ?? []) {
+      if (b?.type === 'thinking' && b.signature) {
+        블록.push({ type: 'thinking', thinking: b.thinking ?? '', signature: b.signature });
+      } else if (b?.type === 'redacted_thinking' && b.data) {
+        블록.push({ type: 'redacted_thinking', data: b.data });
+      }
+    }
     if (content) 블록.push({ type: 'text', text: content });
     for (const t of toolCalls) 블록.push({ type: 'tool_use', id: t.id, name: t.name, input: t.args ?? {} });
     /*
-     * 생각은 **안 돌려보낸다.**
-     *
-     * 이 규격의 생각 블록에는 서명(signature)이 딸려 있고, 서명 없이 돌려보내면
-     * 서버가 거절한다. 흘려받기에서 서명 조각을 제대로 모으는 것까지 확인하지
-     * 못했으므로 여기서는 뺀다. 화면에는 그대로 흘러가고, 대화 이력에만 안 남는다.
-     *
      * 블록이 하나도 없으면 이 규격은 거절한다. 빈 답이 오는 일은 드물지만
      * 그때 대화 전체가 죽으면 안 되니 자리표시를 하나 넣는다.
+     *
+     * 생각 블록**만** 있는 경우도 여기 걸리지 않게 한다 — 생각만 하고 아무
+     * 말도 안 한 턴은 실제로 있고, 그때 생각 블록은 살아 있어야 한다.
      */
     if (!블록.length) 블록.push({ type: 'text', text: '(빈 답)' });
     return { role: 'assistant', content: 블록 };
@@ -351,7 +472,12 @@ function 열쇠다시받을까(conn, status, 이미) {
 
 // 한 번에 받기.
 export async function chat(conn, opts) {
-  const body = buildBody(conn.kind, { model: conn.model, ctx: conn.ctx ?? null, ...opts });
+  // 이 회사가 받는 모양으로 도구를 다듬는다 (backend/toolfit.js).
+  // 모르는 주소면 아무것도 안 바뀐다 — 지금까지와 똑같이 돈다.
+  const 맞춘것 = 도구맞추기(opts.tools, conn);
+  const body = buildBody(conn.kind, {
+    model: conn.model, ctx: conn.ctx ?? null, ...opts, tools: 맞춘것.tools, 회사: 벤더(conn),
+  });
   const 정책 = 정책고르기(conn, opts);
   let 열쇠다시받음 = false;
   for (let 시도 = 1; ; 시도++) {
@@ -365,7 +491,9 @@ export async function chat(conn, opts) {
     // 서버가 남았다고 말해 준 할당량을 적어 둔다 (backend/quota.js).
     // 429 를 맞고 나서야 아는 것과, 맞기 전에 아는 것은 사람이 할 일이 다르다.
     할당량기억(r.headers);
-    if (r.ok) return extractMessage(conn.kind, r.json);
+    // 다듬느라 이름을 고쳤으면 여기서 되돌린다. 밖에서는 그런 일이 있었는지
+    // 모른 채로 원래 이름을 받는다.
+    if (r.ok) return 이름되돌리기(extractMessage(conn.kind, r.json), 맞춘것.되돌림);
     // 열쇠가 늙어서 막힌 것이면 새로 받고 한 번만 다시. 시도 수는 안 올린다 —
     // 서버가 막은 것이 아니라 우리 열쇠가 낡았던 것이라 물러설 까닭이 없다.
     if (열쇠다시받을까(conn, r.status, 열쇠다시받음)) {
@@ -433,7 +561,10 @@ async function 거절읽기(r) {
 
 // 흘려 받기. { type:'thinking'|'content', text } 를 내보내고 마지막에 { type:'done', message } 를 준다.
 export async function* chatStream(conn, opts) {
-  const body = buildBody(conn.kind, { model: conn.model, ctx: conn.ctx ?? null, ...opts, stream: true });
+  const 맞춘것 = 도구맞추기(opts.tools, conn);
+  const body = buildBody(conn.kind, {
+    model: conn.model, ctx: conn.ctx ?? null, ...opts, tools: 맞춘것.tools, stream: true, 회사: 벤더(conn),
+  });
   const 정책 = 정책고르기(conn, opts);
   let r;
   let 열쇠다시받음 = false;
@@ -497,9 +628,33 @@ export async function* chatStream(conn, opts) {
       for (const ev of absorb(conn.kind, obj, acc)) yield ev;
     }
   }
-  yield { type: 'done', message: acc };
+  /*
+   * ── 끝을 안 알려 주고 끊긴 것은 '끝난 것' 이 아니다 ──────────────────────
+   *
+   * 규격대로면 끝을 알리는 조각이 반드시 하나 온다 —
+   * OpenAI 는 finish_reason, Anthropic 은 message_delta.stop_reason,
+   * Ollama 는 done:true. 그게 하나도 안 왔는데 흘러오던 것이 그냥 멎었으면
+   * **왜 끝났는지 모르는 것**이다. 중계 프록시가 몸통을 자르고 연결을 곱게
+   * 닫으면 이 모양이 된다(끊긴 티가 안 나서 read 가 던지지도 않는다).
+   *
+   * 여태 stopped 를 null 로 뒀는데, 위에서는 null 을 '정상 종료' 와 구별하지
+   * 못했다. 그래서 중간에서 잘린 답이 온전한 답으로 지나갔다 — 사람 눈에는
+   * 모델이 말을 하다 만 것으로 보이니 같은 것을 다시 시킨다.
+   *
+   * 다만 '상한에서 잘림(length)' 과 같이 취급하지는 않는다. 까닭이 다르므로
+   * 상한을 올려 다시 부르는 것은 답이 아니다. 이름만 따로 붙여서, 화면이
+   * 사실대로 말할 수 있게 한다. 아무것도 안 온 경우는 여기서 안 다룬다 —
+   * 그건 '빈 답' 쪽이 받는다.
+   */
+  if (acc.stopped == null && (acc.content || acc.thinking || acc.toolCalls.length)) {
+    acc.stopped = 말없이끝남;
+  }
+  yield { type: 'done', message: 이름되돌리기(acc, 맞춘것.되돌림) };
 }
 
+/** 서버가 끝난 까닭을 안 주고 흘려보내기를 멈춘 것. 'stop' 과 구별해야 한다. */
+export const 말없이끝남 = '말없이끝남';
+
 // 조각 하나를 누적하고, 화면에 흘릴 것만 내보낸다.
 function absorb(shape, obj, acc) {
   const out = [];
@@ -553,6 +708,19 @@ function anthropic흡수(obj, acc, out) {
     if (b.type === 'tool_use') {
       acc._raw ??= [];
       acc._raw[번호] = { id: b.id, name: b.name ?? '', args: '' };
+    } else if (b.type === 'thinking') {
+      /*
+       * 생각 블록이 열렸다. 여기서는 속이 비어 있고(`thinking:''`,
+       * `signature:''`), 글은 thinking_delta 로, 서명은 **블록이 닫히기
+       * 직전** signature_delta 로 따로 온다. 그래서 자리를 먼저 잡아 두고
+       * 번호로 찾아 채운다 — 한 답에 생각 블록이 여럿일 수 있다.
+       */
+      acc.생각블록 ??= [];
+      acc.생각블록[번호] = { type: 'thinking', thinking: b.thinking ?? '', signature: b.signature ?? '' };
+    } else if (b.type === 'redacted_thinking') {
+      // 속을 우리가 못 읽는 블록. 읽지 말고 그대로 나르라는 뜻이다.
+      acc.생각블록 ??= [];
+      acc.생각블록[번호] = { type: 'redacted_thinking', data: b.data };
     }
     return out;
   }
@@ -563,7 +731,22 @@ function anthropic흡수(obj, acc, out) {
       out.push({ type: 'content', text: d.text });
     } else if (d.type === 'thinking_delta' && d.thinking) {
       acc.thinking += d.thinking;
+      // 화면으로 흘려보내는 것과 별개로, 돌려보낼 블록에도 그대로 쌓는다.
+      acc.생각블록 ??= [];
+      acc.생각블록[번호] ??= { type: 'thinking', thinking: '', signature: '' };
+      acc.생각블록[번호].thinking += d.thinking;
       out.push({ type: 'thinking', text: d.thinking });
+    } else if (d.type === 'signature_delta' && d.signature) {
+      /*
+       * 서명. 이것 하나가 없으면 그 생각 블록은 못 돌려보낸다 — 서버가
+       * 서명 없는 생각 블록을 거절하기 때문이다. 여기를 빠뜨리면 생각을
+       * 켠 채 도구를 쓰는 순간 그 턴이 죽고, 화면에는 왜인지 안 나온다.
+       *
+       * 조각으로 나뉘어 올 수 있으므로 이어 붙인다.
+       */
+      acc.생각블록 ??= [];
+      acc.생각블록[번호] ??= { type: 'thinking', thinking: '', signature: '' };
+      acc.생각블록[번호].signature += d.signature;
     } else if (d.type === 'input_json_delta' && d.partial_json != null) {
       acc._raw ??= [];
       acc._raw[번호] ??= { id: null, name: '', args: '' };

package/src/backend/learn.js

@@ -69,6 +69,30 @@ export function 배울것(message) {
   }
 
   // ── 2) 답 길이 한계 ───────────────────────────────────────────────────
+
+  /*
+   * 「우리가 준 값 > 서버의 한계」 로 말하는 자리부터 본다.
+   *
+   * Anthropic 은 출력 상한을 이렇게 말한다 —
+   *
+   *   "max_tokens: 100000 > 64000, which is the maximum allowed number of
+   *    output tokens for claude-x"
+   *
+   * 숫자가 둘인데 **앞이 우리가 요청한 값**이고 뒤가 한계다. 아래 표는 이름
+   * 뒤의 첫 숫자를 집으므로, 그대로 두면 방금 거절당한 바로 그 값을 한계로
+   * 배운다. 그러면 같은 값으로 곧장 다시 부르고 또 거절당하는데, 그때는 이미
+   * 배운 뒤라 두 번은 못 배우고 턴이 죽는다(loop.js). 게다가 배운 값은
+   * 연결저장() 으로 프로필에 적히므로 **다음에 켤 때도 똑같이 죽는다.**
+   * 사람이 손으로 설정을 고치기 전에는 안 풀린다.
+   *
+   * 표보다 먼저 본다. 표에 한 번 걸리고 나면 되돌릴 자리가 없다.
+   */
+  const 넘김 = /max_(?:completion_)?tokens\s*[:=]?\s*(\d{3,})\s*>\s*(\d{3,})/i.exec(s);
+  if (넘김) {
+    const limit = 성한수(넘김[2]);
+    if (limit) return { kind: 'out', limit, asked: 성한수(넘김[1]), text: 짧게(s) };
+  }
+
   const out표 = [
     // "max_tokens is too large: 200000. This model supports at most 16384 completion tokens"
     /supports? at most\s+(\d+)\s*(?:completion\s*)?tokens?/i,

package/src/backend/mcp.js

@@ -69,6 +69,42 @@ export function 설정읽기(root) {
   return { 서버들, 자리: p, 있음: true };
 }
 
+/*
+ * ── 지금 띄워 둔 서버들 ─────────────────────────────────────────────────
+ *
+ * 여기 왜 명부가 있나. MCP 서버는 붙인 쪽(repl·ACP)이 들고 있을 뿐이라,
+ * 프로그램이 어느 길로든 끝나 버리면 **아무도 안 닫는다.** 그러면 사람
+ * 컴퓨터에 서버 프로세스가 하나씩 쌓인다 — 작업 관리자를 열기 전에는
+ * 모르는 종류의 탈이다.
+ *
+ * 일감(tools/jobs.js)과 언어 서버(lsp/client.js)에는 이미 이 그물이 있는데
+ * 여기만 없었다. 같은 자리, 같은 규칙으로 둔다.
+ */
+const 띄운것들 = new Set();
+
+/** 검사와 진단이 본다. 지금 살아 있는 서버 수. */
+export function 살아있는수() { return 띄운것들.size; }
+
+/**
+ * 다 닫는다. 프로그램이 끝날 때와 검사 뒤에 부른다.
+ * @returns {number} 닫은 개수
+ */
+export function 모두닫기() {
+  const 것들 = [...띄운것들];
+  띄운것들.clear();
+  let n = 0;
+  for (const s of 것들) { try { s.닫기(); n++; } catch { /* 끝나는 중이라 할 수 있는 게 없다 */ } }
+  return n;
+}
+
+/*
+ * 어떤 길로 끝나든 남기지 않는다. 붙인 쪽이 이미 닫았어도 무해하다.
+ *
+ * 이름 있는 함수를 그대로 건다 — 이름 없는 화살표로 걸면 그물이 걸려 있는지
+ * 검사가 밖에서 확인할 길이 없다. 걷어내도 아무도 모르는 그물은 없는 것과 같다.
+ */
+process.once('exit', 모두닫기);
+
 /**
  * 서버 하나와의 연결.
  *
@@ -105,6 +141,9 @@ export class MCP서버 {
       this.죽음 = `띄우지 못했습니다: ${e.message}`;
       return false;
     }
+    // 띄운 순간부터 명부에 든다. 악수(initialize)를 못 마쳐도 아이는 이미
+    // 떠 있으므로, 여기서 안 적으면 그 아이는 아무도 안 거두는 아이가 된다.
+    띄운것들.add(this);
 
     this.kid.on('error', (e) => this.끝냄(`오류: ${e.message}`));
     this.kid.on('exit', (code, sig) => this.끝냄(`끝났습니다 (코드 ${code ?? sig})`));
@@ -163,25 +202,56 @@ export class MCP서버 {
     if (!기다림) return;
     this.기다리는것.delete(j.id);
     clearTimeout(기다림.타이머);
+    // 끝난 자리의 ESC 엿듣기는 떼어 낸다. 안 떼면 한 턴에 도구를 스무 번
+    // 부르는 사이 신호 하나에 스무 개가 매달린다 — 노드가 열 개 넘으면
+    // 「메모리가 새는 것 같다」 고 경고를 찍는데, 실제로 새는 것이 맞다.
+    기다림.끊기그만?.();
     if (j.error) 기다림.실패(new Error(j.error.message ?? '알 수 없는 오류'));
     else 기다림.성공(j.result);
   }
 
-  보내고기다리기(method, params, timeout = 부르기제한) {
+  /**
+   * 한 통 보내고 답을 기다린다.
+   *
+   * signal 은 사람이 누른 ESC 다. 안 받으면 도구 하나 부르는 데 최대 60초
+   * (부르기제한)를 기다리는데, 그 60초 동안 ESC 는 아무것도 안 한다 — 화면은
+   * 「멈추는 중…」 인데 남의 프로세스의 답을 계속 기다리고 있는 상태다.
+   * 그래서 시한과 같은 자리에서 같은 방식으로 푼다: 기다리는 표에서 빼고,
+   * 왜 끝났는지를 말로 남기고 끝낸다.
+   */
+  보내고기다리기(method, params, timeout = 부르기제한, signal = null) {
     return new Promise((성공, 실패) => {
       if (!this.kid || this.kid.exitCode !== null) return 실패(new Error(this.죽음 ?? '연결이 없습니다'));
+      // 이미 멈췄으면 보내지도 않는다. 보내 놓고 버리면 남의 서버는 그 일을 끝까지 한다.
+      if (signal?.aborted) return 실패(new Error('중단했습니다'));
       const id = this.다음번호++;
       const 타이머 = setTimeout(() => {
         this.기다리는것.delete(id);
+        끊기그만();
         실패(new Error(`${Math.round(timeout / 1000)}초 안에 답이 없습니다`));
       }, timeout);
       if (타이머.unref) 타이머.unref();
-      this.기다리는것.set(id, { 성공, 실패, 타이머 });
+      /*
+       * 기다리는 표에서 **반드시** 뺀다.
+       *
+       * 안 빼면 뒤늦게 온 답이 이미 끝난 약속을 또 푼다. 두 번째 풀기는
+       * 조용히 무시되므로 오류는 안 나지만, 표에 죽은 자리가 남아서
+       * 끝냄() 이 그것들을 다시 실패시킨다 — 아무도 안 듣는 실패다.
+       */
+      const 끊겼다 = () => {
+        clearTimeout(타이머);
+        this.기다리는것.delete(id);
+        실패(new Error('중단했습니다'));
+      };
+      signal?.addEventListener?.('abort', 끊겼다, { once: true });
+      const 끊기그만 = () => signal?.removeEventListener?.('abort', 끊겼다);
+      this.기다리는것.set(id, { 성공, 실패, 타이머, 끊기그만 });
       try {
         this.kid.stdin.write(JSON.stringify({ jsonrpc: '2.0', id, method, params }) + '\n');
       } catch (e) {
         clearTimeout(타이머);
         this.기다리는것.delete(id);
+        끊기그만();
         실패(e);
       }
     });
@@ -191,8 +261,8 @@ export class MCP서버 {
     try { this.kid?.stdin?.write(JSON.stringify({ jsonrpc: '2.0', method, params }) + '\n'); } catch { /* 죽었으면 어차피 끝이다 */ }
   }
 
-  async 부르기(도구이름, args, { timeout = 부르기제한 } = {}) {
-    const r = await this.보내고기다리기('tools/call', { name: 도구이름, arguments: args ?? {} }, timeout);
+  async 부르기(도구이름, args, { timeout = 부르기제한, signal = null } = {}) {
+    const r = await this.보내고기다리기('tools/call', { name: 도구이름, arguments: args ?? {} }, timeout, signal);
     // 규격상 결과는 content 배열이다. 글만 뽑아 모델에게 넘긴다.
     const 조각 = Array.isArray(r?.content) ? r.content : [];
     const 글 = 조각
@@ -206,6 +276,7 @@ export class MCP서버 {
     this.죽음 = this.마지막말 ? `${왜} — ${this.마지막말}` : 왜;
     for (const [, 기다림] of this.기다리는것) {
       clearTimeout(기다림.타이머);
+      기다림.끊기그만?.();
       기다림.실패(new Error(this.죽음));
     }
     this.기다리는것.clear();
@@ -213,6 +284,7 @@ export class MCP서버 {
 
   닫기() {
     this.끝냄('닫았습니다');
+    띄운것들.delete(this);
     try {
       this.kid?.stdin?.end();
       this.kid?.kill();
@@ -236,6 +308,25 @@ function 깨끗한환경() {
   return out;
 }
 
+/**
+ * 게이트웨이 열쇠 **하나만** 뺀 환경. Bash 와 Jobs 가 자식에게 넘길 것.
+ *
+ * 위 깨끗한환경 은 남의 프로그램(MCP 서버)에 주는 것이라 통째로 씻는다.
+ * 여기는 다르다 — Bash 로 도는 것은 **사용자 제 프로젝트**다. PATH·NODE_ENV·
+ * DEEL_HOME·사내 프록시 설정이 다 있어야 하고(사용자는 이 프로그램의 검사
+ * 자체를 Bash 로 돌린다), 하나라도 빠지면 「내 터미널에서는 되는데」 가 된다.
+ *
+ * 그래서 딱 하나만 뺀다. 안 빼면 `env` 한 줄로 열쇠가 화면에 찍히고, 그 화면이
+ * 대화에 실려 게이트웨이로 나가고 `.deel/sessions/*.jsonl` 로 디스크에도 남는다 —
+ * 열쇠를 그 열쇠의 주인에게 보내는 셈이다(guard.js 가 막는 것과 같은 길).
+ * 자식이 무엇을 하든 이 값이 필요할 일은 없다. 게이트웨이로 나가는 것은 우리다.
+ */
+export function 열쇠뺀환경(env = process.env) {
+  const out = { ...env };
+  delete out.DEEL_API_KEY;
+  return out;
+}
+
 /** 우리 도구 이름과 안 부딪히게 앞에 서버 이름을 붙인다. Claude Code 와 같은 꼴이다. */
 export const 도구이름 = (서버, 도구) => `mcp__${서버}__${도구}`;
 
@@ -275,7 +366,7 @@ export async function 다붙이기(root, { offline = false, timeout = 붙기제
     const ok = await 서버.붙기({ timeout });
     if (ok) {
       붙은것.push(서버);
-      audit?.note?.('mcp', { 이름: s.이름, command: s.command, 도구: 서버.도구.length });
+      audit?.write?.('mcp', { 이름: s.이름, command: s.command, 도구: 서버.도구.length });
     } else {
       못한것.push({ 이름: s.이름, 왜: 서버.죽음 ?? '알 수 없는 이유' });
       서버.닫기();