deel-local-cli 1.6.3 → 1.8.0

package/src/i18n/zh.js

@@ -94,8 +94,12 @@ export const zh = {
   'consult.failed': '问不成 — {왜}',
   'consult.empty': '返回是空的。那个模型可能不带工具就不回答。',
   'consult.added': '已把那个回答加进对话，并标明是谁说的。',
-  'head.spec.ollama': 'Ollama API',
+  'head.spec.ollama': 'Ollama 自有规格',
   'head.spec.openai': 'OpenAI 兼容 API',
+  'head.spec.anthropic': 'Anthropic API',
+  'head.mode.default': '本机内（默认）',
+  'head.mode.online': '外部（online）',
+  'head.mode.offline': '封锁（offline）',
   'head.model': '模型',
   'head.tokens': '词元',
   'head.grade': '等级',
@@ -131,6 +135,7 @@ export const zh = {
   'grade.large': '大',
   'head.gradeSuffix': ' · {급} {급이름}{짐작}',
   'seg.dir': '工作文件夹 (前面的 ⌂/↗ 表示你写的东西会去哪里)',
+  'seg.ver': '版本号',
   'seg.thread': '分支',
   'seg.model': '模型名',
   'seg.grade': '模型等级 (能独立做到哪一步)',
@@ -142,6 +147,7 @@ export const zh = {
   'seg.verify': '真正验证过的东西',
   'seg.undoable': '还能撤销的轮数',
   'seg.tok': '输入/输出词元',
+  'seg.cost': '已花费金额（仅在已知价格时）',
   'seg.tools': '工具调用',
   'seg.skills': '本机上找到的技能',
   'seg.time': '开始以来的时间',
@@ -259,6 +265,151 @@ export const zh = {
   'ask.freePrompt': '回答',
   'loop.backoff': '服务端把请求推回来了 ({무엇}) — {초} 秒后再试 ({n}/{max})',
   'cost.retries': '重试',
+  // ── 计数词 ────────────────────────────────────────────────────────────
+  'unit.files': '{n}个文件',
+  'unit.files1': '1个文件',
+  'unit.hits': '{n}处匹配',
+  'unit.hits1': '1处匹配',
+  'unit.lines': '{n}行',
+  'unit.lines1': '1行',
+  'unit.spots': '{n}处',
+  'unit.spots1': '1处',
+  'unit.places': '{n}处',
+  'unit.places1': '1处',
+  'unit.count': '{n}个',
+  'unit.count1': '1个',
+  'unit.chars': '{n}字',
+  'unit.kchars': '{n}k字',
+  'unit.calls': '{n}次',
+  'unit.sec': '{n}秒',
+  'unit.min': '{n}分钟',
+
+  'sum.done': '完成',
+  'sum.ok': '成功',
+  'sum.exitCode': '退出码 {code}',
+  'sum.killedBy': '被 {시그널} 结束',
+  'sum.partial': '仅部分',
+  'sum.cut': '已截断',
+  'sum.notAllSeen': '未全部扫描',
+  'sum.filesFailed': '{n}个失败',
+  'sum.spotsFailed': '{n}处失败',
+  'sum.moved': '移动{n}个',
+  'sum.total': '共{줄}',
+  'sum.addedLines': '+{줄}',
+  'sum.noVision': '当前模型看不了图片',
+  'sum.emptyAnswer': '空回答',
+  'sum.unread': '读不了{n}个',
+  'sum.doneOf': '{끝}/{전체} 完成',
+  'sum.justDone': '刚完成{n}个',
+  'sum.noChange': '没有变化',
+  'sum.verified': '核对{n}项',
+  'sum.readAs': '用 {쓴것} 转换后读取',
+  'sum.linesOf': '{준}/{전체}行',
+  'sum.countOf': '{n}/{전체}个',
+  'sum.remembered': '已记住（{n}行）',
+  'sum.rememberFull': '位置满了，已移除最旧的',
+  'sum.recall': '过往对话 {전체}条中 {맞음}条',
+  'sum.jobStarted': '以{n}号启动',
+  'sum.jobRunning': '运行中',
+  'sum.jobEndedAlready': '已经结束',
+  'sum.jobStopped': '已结束',
+
+  'tier.exact': '完全匹配',
+  'tier.trail': '忽略行尾空白和换行差异',
+  'tier.indent': '忽略缩进差异',
+  'tier.space': '忽略所有空白差异',
+
+  'sum.image': '图片',
+  'sum.imageDropped': '省略图片 {크기}',
+
+  'sum.broken': '{n}处问题',
+  'sum.unverified': '{n}项未核对',
+  'lsp.noDef': '找不到定义。用 Grep 试试。',
+  'lsp.defs': '定义 {n}',
+  'lsp.noRefs': '没有任何地方用到。',
+  'lsp.refs': '使用 {자리} · 文件 {파일}',
+
+  'sum.nothingToCheck': '没有可核对的东西',
+  'job.no': '{n}号',
+  'job.stop': '结束',
+  'more.files': '另外{n}个',
+  'more.spots': '另外{n}处',
+
+  'err.noSuchFile': '没有这个文件: {경로}',
+  'err.alreadyThere': '已经存在: {경로}',
+  'err.overwriteHint': '要覆盖请传 overwrite: true。',
+
+  'run.ctxProbe': '正在确认模型启动时的上下文长度…',
+  'run.noStream': '没有流式输出，回答会一次性出现',
+  'run.hintHelp': '/help 命令列表',
+  'run.hintEsc': 'ESC 中断',
+  'run.hintQuit': 'Ctrl+C 中断·退出',
+  'run.thinking': '思考中…',
+  'run.thinkingChars': '思考中… {n}字',
+  'run.turnFoot': '{초}秒 · 工具{n}次 · ↑{입력} ↓{출력}',
+  'run.bye': '结束。',
+  'run.byeStats': '模型调用{n}次 · 工具耗时{초}秒 · ↑{입력} ↓{출력}',
+  'run.notMade': '— 没有被创建',
+
+  'stage.plan': '先做判断',
+  'stage.work': '接着做',
+  'stage.fix': '卡住时',
+
+  'scr.tools': '工具',
+  'scr.conn': '连接',
+  'scr.session': '本次会话',
+  'status.kind': '规格',
+  'status.url': '地址',
+  'status.proxy': '代理',
+  'status.proxyOff': '用不了',
+  'status.model': '模型',
+  'status.root': '工作目录',
+  'status.shell': 'Shell',
+  'status.keyStore': '密钥存放',
+  'status.rules': '规则',
+  'status.noRules': '无（可用 /init 建一个）',
+  'status.caps': '支持',
+  'status.capTools': '工具',
+  'status.capStream': '流式',
+  'status.capSchema': '结构化',
+  'status.capThink': '推理',
+  'cost.calls': '模型调用',
+  'cost.tokIn': '输入 token',
+  'cost.tokOut': '输出 token',
+  'cost.toolMs': '工具耗时',
+  'cost.elapsed': '已用时',
+  'cost.money': '费用',
+  'cost.quota': '服务器额度',
+  'cost.quotaAge': '基于{초}秒前的响应',
+
+  'scr.context': '上下文',
+  'unit.tokens': '{n} token',
+  'ctx.system': '系统提示',
+  'ctx.rules': '规则 ({이름})',
+  'ctx.rulesNone': '规则 (无)',
+  'ctx.memory': '记忆 ({n}行)',
+  'ctx.learned': '在这里学到的',
+  'ctx.skills': '技能列表 ({실림}/{전체})',
+  'ctx.tools': '工具定义',
+  'ctx.history': '对话历史',
+  'ctx.toolResults': '工具结果 (文件{n}个)',
+  'ctx.left': '剩余',
+  'ctx.compactHint': '折叠对话',
+  'ctx.clearHint': '全部清空',
+  'ctx.calibrated': '已按服务器实测值校正 {부호}{퍼센트}%（采样{번}次）。',
+  'ctx.estimate': '数字为估算 — 没有使用精确的分词器。',
+
+  'auth.waiting': '正在等待公司登录…',
+  'auth.got': '已取得密钥 — 大约可用{분}分钟',
+  'auth.failed': '没能取得密钥 — {왜}',
+  'auth.from': '取得',
+  'auth.fromPolicy': '取得（管理策略）',
+  'auth.leftMin': '剩余{분}分钟',
+  'auth.notYet': '尚未取得',
+
+  'undo.wayRestored': '已还原',
+  'undo.wayDeleted': '已删除（原本不存在的文件）',
+
   'common.unknownCommand': '不认识的命令',
   'common.seeHelp': '用 /help 看命令列表',
   'common.yes': '是',

package/src/oneshot.js

@@ -11,7 +11,8 @@
 //   그래서 '묻는 자리' 를 전부 없앤 길을 따로 낸다. 에이전트 루프는 그대로 쓴다 —
 //   여기서 루프를 다시 짜면 두 벌이 되고, 언젠가 한쪽만 고쳐진다.
 import { c, mark, clip } from './ui/ansi.js';
-import { 규칙모으기 } from './safety/policy.js';
+import { 규칙모으기, 정책읽기 } from './safety/policy.js';
+import { 받기설정 } from './safety/authcmd.js';
 import { run } from './agent/loop.js';
 import { Session } from './agent/session.js';
 import { makeScope } from './safety/guard.js';
@@ -23,6 +24,8 @@ import { 말 as 옮긴말 } from './i18n/index.js';
 import { 알림채움 } from './backend/retry.js';
 import { discover } from './skills/discover.js';
 import { allowEndpoint, setOffline } from './safety/network.js';
+import { 지금모드, 바깥인가, 나갈수있나 } from './safety/runmode.js';
+import { 주소가리기 } from './safety/secrets.js';
 import { probeCtx, 기본값 as CTX_DEFAULT } from './backend/ctxsize.js';
 import { route } from './agent/route.js';
 import { get as getWork } from './agent/modes.js';
@@ -61,7 +64,7 @@ async function 표준입력읽기() {
 // 도구 한 줄 요약. 화면 그림이 아니라 로그에 남을 글이라 색을 아낀다.
 function 도구줄(name, args) {
   const a = args ?? {};
-  const 첫 = a.file_path ?? a.pattern ?? a.path ?? a.url ?? a.name ?? a.목적 ??
+  const 첫 = a.file_path ?? a.pattern ?? a.path ?? a.url ?? a.name ?? a.purpose ?? a.목적 ??
     (a.command ? String(a.command).replace(/\s+/g, ' ') : null) ??
     // 뒤에서 도는 명령. 번호가 곧 그 일감의 이름이라, 이게 없으면 기록에
     // `Jobs()` 만 여러 줄 남아 나중에 무엇을 본 것인지 알 수 없다.
@@ -152,6 +155,14 @@ export async function runOnce(opts = {}) {
   const conn = {
     kind: prof.kind, base: prof.baseUrl, auth: prof.auth,
     key: resolveKey(prof), model: prof.model,
+    /*
+     * 열쇠를 갖고 있는 대신 **받아 오는** 설정 (safety/authcmd.js).
+     *
+     * 여기서는 설정만 싣는다. 명령은 요청 직전에 부른다 — 켤 때 한 번
+     * 받아 두면 한 시간짜리 토큰이 세 시간짜리 대화 한복판에서 죽고,
+     * 그 401 은 화면에서 「열쇠가 틀렸다」 와 구별이 안 된다.
+     */
+    열쇠받기: 받기설정(prof, { 정책값: 정책읽기().값 }),
     ctx: opts.ctx ?? prof.ctx ?? CTX_DEFAULT,
     // 답 길이 상한 — deel --max-tokens 32k 로 높일 수 있다(대화 화면의 /out 과 같은 값).
     maxTokens: opts.maxTokens ?? prof.maxTokens ?? null,
@@ -160,11 +171,30 @@ export async function runOnce(opts = {}) {
     vision: prof.vision ?? false,
   };
 
-  // 자물쇠는 대화 화면과 똑같이 건다. 비대화라고 느슨해질 이유가 없다 —
-  // 오히려 배치는 아무도 안 보는 자리라 더 단단해야 한다.
+  /*
+   * 자물쇠는 대화 화면과 똑같이 건다. 비대화라고 느슨해질 이유가 없다 —
+   * 오히려 배치는 아무도 안 보는 자리라 더 단단해야 한다.
+   *
+   * 다른 것은 딱 하나, **물을 수가 없다**는 것이다. 파이프 뒤에는 답할 사람이
+   * 없다. 그래서 여기서는 묻는 대신 멈추고, 무엇을 붙이면 되는지를 말한다.
+   * 조용히 나가 버리면 스크립트가 바깥으로 나가고 있는 줄 아무도 모른다.
+   */
+  const 바깥연결 = 바깥인가(conn.base);
+  const 실행모드 = 지금모드({
+    online: opts.online === true,
+    // 관리 정책이 offline 을 못박아 뒀으면 옵션과 상관없이 켠다 (safety/policy.js).
+    offline: !!(opts.offline ?? prof.offline ?? cfg?.offline),
+  });
+  const 나감 = 나갈수있나(실행모드, { 바깥: 바깥연결, 허가: prof.online === true });
+  if (나감.물어볼까) {
+    const 어디 = (() => { try { return new URL(conn.base).host; } catch { return conn.base; } })();
+    return 못함('needs-online',
+      `이 연결은 이 컴퓨터 밖으로 나갑니다 (${주소가리기(어디)}). 여기서는 물어볼 수 없습니다.\n`
+      + '    나가도 된다면 --online 을 붙이거나, 대화 화면(deel)에서 한 번 허락해 두세요.\n'
+      + '    이 컴퓨터 안의 모델을 쓰려면 deel scan --save 로 붙이세요.');
+  }
   allowEndpoint(conn.base);
-  // 관리 정책이 offline 을 못박아 뒀으면 옵션과 상관없이 켠다 (safety/policy.js).
-  if (opts.offline ?? prof.offline ?? cfg?.offline) setOffline(true);
+  if (실행모드.허가무시) setOffline(true);
 
   const session = new Session(conn, {
     root,
@@ -174,6 +204,9 @@ export async function runOnce(opts = {}) {
     effort: opts.effort ?? 'save',
     maxSteps: opts.maxSteps ?? null,   // null 이면 작업 모드가 정한다
   });
+  // 지금 어느 실행 모드인가. 화면이 첫 줄에 이걸 그린다(ui/status.js).
+  // session 에 실어 두는 까닭은, 대화 도중 /model 로 옮겨도 같은 자리를 보게 하려는 것이다.
+  session.실행모드 = 실행모드;
 
   const found = discover(root);
   session.skills = found.skills;

package/src/pack/selfpack.js

@@ -17,7 +17,7 @@ export const repoRoot = () => join(dirname(fileURLToPath(import.meta.url)), '..'
 
 const SKIP_DIRS = new Set(['node_modules', '.git', '.github', 'test', '.deel']);
 const SHIP = ['bin', 'src'];
-const SHIP_FILES = ['package.json', 'README.md', 'README.en.md', 'LICENSE'];
+const SHIP_FILES = ['package.json', 'README.md', 'README.ko.md', 'LICENSE'];
 
 function walk(dir, base, out) {
   for (const e of readdirSync(dir, { withFileTypes: true })) {

package/src/providers/anthropic.js

@@ -0,0 +1,48 @@
+/*
+ * Anthropic 직접 (Claude).
+ *
+ * ── 여기만 규격이 하나 더 필요했다 ─────────────────────────────────────
+ *
+ * 다섯 중에 유일하게 **몸통 모양이 다르다.** OpenAI 호환 창구가 없어서,
+ * backend/adapter.js 에 `anthropic` 갈래를 하나 더해야 말이 통한다. 그
+ * 갈래를 붙였다 — 문 이름 · 몸통 · 답 읽기 · 이력 되돌리기 · 도구 결과 ·
+ * 흘려받기 여섯 자리, 그리고 그림과 창 크기.
+ *
+ * 무엇이 다른지는 backend/adapter.js 의 anthropic몸() 머리말에 있다.
+ */
+export const 제공자 = {
+  id: 'anthropic',
+  이름: 'Anthropic (Claude)',
+  한줄: '벤더에서 바로. 열쇠 하나만 있으면 됩니다.',
+
+  규격: 'anthropic',
+  // 인증 방식이 다르다. Bearer 가 아니라 x-api-key 다 — 축이 갈라져 있다는
+  // 것이 여기서 그대로 보인다 (계획표 05절).
+  인증: 'x-api-key',
+  주소들: () => ['https://api.anthropic.com'],
+  리전들: null,
+
+  규격됐나: true,
+
+  빈칸: ['열쇠'],
+  열쇠받는곳: 'https://console.anthropic.com/settings/keys',
+  키앞머리: [/^sk-ant-/],
+
+  // 왜 비워 두는지는 providers/openai.js 의 같은 자리에 적어 두었다.
+  요금: {},
+  요금기준: null,
+  요금표주소: 'https://www.anthropic.com/pricing',
+
+  오류읽기({ status, 서버말 }) {
+    if (status === 400 && /anthropic-version/i.test(서버말)) {
+      return 'anthropic-version 헤더가 없거나 틀렸습니다 — deel 의 규격 붙임이 아직 안 끝난 자리입니다.';
+    }
+    if (status === 404 && /model/i.test(서버말)) {
+      return '그 모델 이름을 이 열쇠로는 못 씁니다 — 이름이 틀렸거나, 아직 안 열린 모델입니다.';
+    }
+    if (status === 400 && /credit|balance/i.test(서버말)) {
+      return '잔액이 모자랍니다 — 콘솔에서 결제·크레딧을 확인하세요.';
+    }
+    return null;
+  },
+};

package/src/providers/bedrock.js

@@ -0,0 +1,102 @@
+/*
+ * AWS Bedrock.
+ *
+ * ── SigV4 서명이 필요 없다 ─────────────────────────────────────────────
+ *
+ * 이게 이 파일에서 제일 중요한 사실이고, 계획을 세울 때 내가 틀렸던 자리다.
+ * AWS 를 붙인다고 하면 보통 SigV4 서명(해시 체인 · 날짜 키 유도)을 떠올리고,
+ * 그건 의존성 0개로는 꽤 큰 일이다. 그런데 문서를 보면 —
+ * (docs.aws.amazon.com/bedrock/latest/userguide/inference-chat-completions-mantle.md)
+ *
+ *   curl -X POST "https://bedrock-runtime.us-east-1.amazonaws.com/v1/chat/completions" \
+ *     -H "Authorization: Bearer $AWS_BEARER_TOKEN_BEDROCK"
+ *
+ * **Bedrock API 키를 그냥 Bearer 로 받는다.** 그리고 OpenAI Chat Completions
+ * 창구로 부를 때는 인증이 API 키 하나로 제한된다고 문서가 못 박아 두었다.
+ * 그러면 Bedrock 은 새 규격이 아니라 **이미 있는 축들의 새 조합**일 뿐이다 —
+ * 규격 openai · 인증 bearer · 주소가 리전을 탄다.
+ *
+ * ── 주소가 셋이다 ──────────────────────────────────────────────────────
+ *
+ *   bedrock-runtime.{리전}.amazonaws.com/v1         API 키를 Bearer 로 (문서)
+ *   bedrock-runtime.{리전}.amazonaws.com/openai/v1  Bedrock 위의 OpenAI 모델 (문서)
+ *   bedrock-mantle.{리전}.api.aws/v1                mantle 창구 (문서)
+ *
+ * 셋 다 후보로 주고 **어느 것이 되는지는 물어본다**(backend/detect.js).
+ * 표를 믿고 하나만 쓰면 그 표가 낡은 날 사람은 「연결 실패」 만 본다.
+ *
+ * ── 리전 목록은 짧게, 진실은 엔드포인트에 묻는다 ───────────────────────
+ *
+ * 리전마다 열려 있는 모델이 다르다. 「서울에 최신 Claude 가 있다」 를 표에
+ * 박으면 그 표가 낡는다. 리전을 고르면 그 자리에서 실제로 물어보고, 없으면
+ * 없다고 말한다. 그래서 목록에는 「직접 입력」 이 늘 있다 — 목록은 빈칸을
+ * 줄여 주는 것이지 울타리가 아니다.
+ */
+export const 리전들 = [
+  { id: 'us-east-1', 어디: '버지니아', 왜: '새 모델이 제일 먼저 열립니다' },
+  { id: 'us-west-2', 어디: '오리건', 왜: '두 번째로 넓습니다' },
+  { id: 'ap-northeast-2', 어디: '서울', 왜: '자료를 국내에 남깁니다 — 사내 도입엔 이게 관건입니다' },
+  { id: 'ap-northeast-1', 어디: '도쿄', 왜: '서울에 없을 때 제일 가까운 대안입니다' },
+  { id: 'eu-central-1', 어디: '프랑크푸르트', 왜: 'EU' },
+];
+
+export const 제공자 = {
+  id: 'bedrock',
+  이름: 'AWS Bedrock',
+  한줄: '리전과 열쇠 둘만 있으면 됩니다. AWS 서명(SigV4)은 필요 없습니다.',
+
+  규격: 'openai',
+  인증: 'bearer',
+  기본리전: 'us-east-1',
+  리전들,
+
+  주소들: ({ 리전 } = {}) => {
+    const r = String(리전 ?? 'us-east-1').trim();
+    if (!/^[a-z]{2}-[a-z]+-\d$/.test(r)) return [];
+    return [
+      `https://bedrock-runtime.${r}.amazonaws.com/v1`,
+      `https://bedrock-runtime.${r}.amazonaws.com/openai/v1`,
+      `https://bedrock-mantle.${r}.api.aws/v1`,
+    ];
+  },
+
+  규격됐나: true,
+  빈칸: ['리전', '열쇠'],
+  열쇠받는곳: 'https://console.aws.amazon.com/bedrock/home#/api-keys',
+
+  /*
+   * 앞머리를 안 둔다.
+   *
+   * Bedrock API 키에는 알아볼 만한 고정 앞머리가 없다. 「모르면 뿌리지 말고
+   * 물어본다」 가 이 도구의 규칙이라(providers/index.js), 짐작이 안 서면
+   * 짐작하지 않는다. 빈 목록이 곧 그 뜻이다.
+   */
+  키앞머리: [],
+
+  // 왜 비워 두는지는 providers/openai.js 의 같은 자리에 적어 두었다.
+  요금: {},
+  요금기준: null,
+  요금표주소: 'https://aws.amazon.com/bedrock/pricing/',
+
+  오류읽기({ status, 서버말 }) {
+    /*
+     * Bedrock 에서 제일 흔한 첫 실패는 **모델 접근 신청을 안 한 것**이다.
+     * 열쇠도 맞고 주소도 맞는데 그 리전의 그 모델을 아직 안 열어 둔 상태다.
+     * 이걸 「연결 실패」로 뭉개면 사람은 주소와 열쇠를 몇 번이고 다시 본다 —
+     * 정작 해야 할 일은 콘솔에서 신청 버튼 한 번 누르는 것인데.
+     */
+    if (/AccessDenied|not authorized|access to the model/i.test(서버말)) {
+      return '이 리전에서 그 모델에 접근 권한이 없습니다 — Bedrock 콘솔의 모델 접근(Model access)에서 신청하세요.';
+    }
+    if (/ValidationException/i.test(서버말) && /model/i.test(서버말)) {
+      return '그 모델 이름을 이 리전에서 못 씁니다 — 리전을 바꾸거나 이름을 다시 보세요.';
+    }
+    if (status === 403 && /security token|ExpiredToken/i.test(서버말)) {
+      return '열쇠가 만료됐습니다 — Bedrock 콘솔에서 새로 발급받으세요 (단기 키는 만료됩니다).';
+    }
+    if (status === 404 && /^$|Not Found/i.test(서버말)) {
+      return '그 리전에 이 창구가 없습니다 — 리전 이름을 다시 보세요.';
+    }
+    return null;
+  },
+};

package/src/providers/custom.js

@@ -0,0 +1,65 @@
+/*
+ * 주소를 직접 넣기 — 사내 게이트웨이 · 이름 없는 창구 · 아직 안 적은 벤더.
+ *
+ * ── 이게 목록의 주인공이다 ─────────────────────────────────────────────
+ *
+ * 앞의 넷은 「못 외우는 주소를 대신 적어 둔 메모」 다. 이 다섯째가 진짜로
+ * 하는 일이고, 화면에서도 위쪽에 둔다.
+ *
+ * 회사마다 규격도 도메인도 다르다. 명단에 없는 회사가 안 되는 것처럼 보이면
+ * 그 명단은 도움이 아니라 울타리다. 그래서 목록의 어느 자리에서든 「주소를
+ * 직접」 으로 빠져나갈 수 있어야 한다.
+ *
+ * ── 빈칸이 하나도 안 채워져 있다 ───────────────────────────────────────
+ *
+ * 규격도 인증도 안 적는다. **스캐너가 알아낸다**(backend/detect.js) —
+ * 후보 주소를 넓혀 보고, 인증 방식을 다 해 보고, 첫 401 에서 안 멈추고,
+ * 401/403(규격은 맞고 인증이 틀림)과 404(규격이 아님)를 구분하고, 200 인데
+ * JSON 이 아니면(사내 프록시의 로그인 페이지) 성공으로 안 친다.
+ *
+ * 그 힘이 이미 있는데 여기에 규격을 적어 두면, 적어 둔 것이 틀린 날 스캐너가
+ * 알아낼 수 있는 것까지 못 붙게 만든다.
+ *
+ * ── 사내는 빈칸이 아예 0개가 될 수 있다 ────────────────────────────────
+ *
+ * 관리자가 policy.json (%ProgramData%\deel · /etc/deel)으로 baseUrl 을 못박아
+ * 두면 직원은 열쇠만 넣는다. 정책은 설정을 이기지만 넓히지는 못한다 — 금지를
+ * 더할 수는 있어도 사용자가 걸어 둔 금지를 풀지는 못한다(safety/policy.js).
+ */
+export const 제공자 = {
+  id: 'custom',
+  이름: '주소를 직접 넣기',
+  한줄: '사내 게이트웨이·목록에 없는 곳. 규격과 인증은 알아서 알아냅니다.',
+
+  // 셋 다 null 이다. 「모른다」 를 기본값으로 덮어쓰지 않는다.
+  규격: null,
+  인증: null,
+  주소들: () => [],
+  리전들: null,
+
+  규격됐나: true,
+  빈칸: ['주소', '열쇠(있으면)'],
+  열쇠받는곳: null,
+  키앞머리: [],
+
+  요금: {},
+  요금기준: null,
+  요금표주소: null,
+
+  오류읽기({ status, 서버말 }) {
+    /*
+     * 사내에서 제일 흔한 두 가지. 둘 다 「연결 실패」로 보이지만 고칠 자리가
+     * 전혀 다르다 — 하나는 프록시 설정, 하나는 인증서다.
+     */
+    if (/ENOTFOUND|EAI_AGAIN/i.test(서버말)) {
+      return '주소를 못 찾았습니다 — 사내망이라면 VPN 이 올라와 있는지, 프록시가 필요한지 보세요 (HTTPS_PROXY).';
+    }
+    if (/self.signed|unable to verify|CERT_|certificate/i.test(서버말)) {
+      return '사내 인증서를 못 믿습니다 — NODE_EXTRA_CA_CERTS 에 회사 인증서 파일을 걸어 주세요.';
+    }
+    if (status === 200 && /<html|<!DOCTYPE/i.test(서버말)) {
+      return '서버가 JSON 대신 웹 페이지를 줬습니다 — 앞단 프록시의 로그인 화면일 가능성이 큽니다.';
+    }
+    return null;
+  },
+};

package/src/providers/gemini.js

@@ -0,0 +1,64 @@
+/*
+ * Google Gemini.
+ *
+ * ── 규격을 안 늘려도 된다 ──────────────────────────────────────────────
+ *
+ * 구글이 OpenAI 호환 창구를 낸다. 문서로 확인한 것 (ai.google.dev/gemini-api/docs/openai):
+ *
+ *   base_url  https://generativelanguage.googleapis.com/v1beta/openai/
+ *   목록      GET  {base}/models        Authorization: Bearer <열쇠>
+ *   대화      POST {base}/chat/completions  · tools · tool_choice 그대로
+ *
+ * 그래서 Gemini 는 **주소 한 줄**이면 끝난다. deel 의 기본 규격이 이미 이
+ * 모양이라 adapter 를 안 건드린다.
+ *
+ * ── 다만 도구 스키마에 걸릴 수 있다 ────────────────────────────────────
+ *
+ * 구글 문서가 「함수 호출은 OpenAPI 스키마의 일부만 지원하고, 크거나 깊이
+ * 중첩된 스키마는 거절될 수 있다」 고 적어 두었다. deel 의 Write(files[]) ·
+ * Edit(edits[]) · Move(moves[]) 는 객체 배열이라 여기 걸릴 수 있다.
+ *
+ * 추측하지 않는다 — `deel diagnose` 가 그 자리에서 진짜로 찔러 본다. 걸리면
+ * 그때 배열 도구를 한 개씩 쓰도록 낮춘다. 미리 낮춰 두면 멀쩡한 자리에서까지
+ * 한 번에 한 파일씩 고치게 되고, 그건 몇 분을 그냥 버리는 일이다.
+ */
+export const 제공자 = {
+  id: 'gemini',
+  이름: 'Google Gemini',
+  한줄: 'OpenAI 호환 창구가 있어 주소 한 줄이면 됩니다.',
+
+  규격: 'openai',
+  인증: 'bearer',
+  주소들: () => ['https://generativelanguage.googleapis.com/v1beta/openai/'],
+  리전들: null,
+
+  규격됐나: true,
+  빈칸: ['열쇠'],
+  열쇠받는곳: 'https://aistudio.google.com/apikey',
+  키앞머리: [/^AIza/],
+
+  // 왜 비워 두는지는 providers/openai.js 의 같은 자리에 적어 두었다.
+  요금: {},
+  요금기준: null,
+  요금표주소: 'https://ai.google.dev/gemini-api/docs/pricing',
+
+  /*
+   * 도구 스키마가 걸릴 수 있는 곳이라고 표를 달아 둔다. 화면이 이걸 보고
+   * 「걸리면 deel diagnose 로 확인하세요」 한 줄을 붙인다.
+   */
+  도구스키마조심: '함수 호출이 OpenAPI 스키마의 일부만 지원됩니다 — 깊이 중첩된 스키마는 거절될 수 있습니다.',
+
+  오류읽기({ status, 서버말 }) {
+    if (status === 400 && /API key not valid/i.test(서버말)) {
+      return '열쇠를 못 알아봅니다 — AI Studio 에서 받은 열쇠(AIza…)가 맞는지 보세요.';
+    }
+    if (status === 400 && /schema|function|tool/i.test(서버말)) {
+      return '도구 스키마를 거절했습니다 — Gemini 는 스키마의 일부만 받습니다.'
+        + ' deel diagnose 로 어느 도구가 걸리는지 확인하세요.';
+    }
+    if (status === 403 && /SERVICE_DISABLED|PERMISSION_DENIED/i.test(서버말)) {
+      return '이 프로젝트에서 Generative Language API 가 꺼져 있습니다 — 콘솔에서 켜세요.';
+    }
+    return null;
+  },
+};