@n2world/orchestrator 1.1.0

package/dist/cli.js

@@ -0,0 +1,607 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const dashboard_server_1 = require("./dashboard-server");
+const index_1 = require("./index");
+const beta_runner_1 = require("./beta-runner");
+const llm_1 = require("./llm");
+const governed_llm_1 = require("./governed-llm");
+const chat_store_1 = require("./chat-store");
+const tui_1 = require("./tui");
+const channel_gateway_1 = require("./channel-gateway");
+const browser_agent_1 = require("./browser-agent");
+const llm_2 = require("./llm");
+const kakao_oauth_1 = require("./kakao-oauth");
+const channels_1 = require("./channels");
+const http = __importStar(require("http"));
+const readline = __importStar(require("readline"));
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const BETA_SNAPSHOT = path.join('beta-data', 'session.json');
+const args = process.argv.slice(2);
+const command = args[0];
+async function main() {
+    if (!command || command === '--help' || command === '-h') {
+        console.log(`
+n2world (AnyWorld) CLI - Open Source Version 1.0.0
+Copyright (c) 2026 Park Sung Hoon (MIT License)
+
+Usage:
+  n2world init                         Initialize a new project workspace
+  n2world dashboard [--port <port>]    Start the mobile friendly PWA dashboard server
+  n2world chat [--fresh] [--export]    Start an interactive conversation (real LLM + sandbox tools). 대화는 자동 저장·복원됨.
+                                       --fresh: 이전 대화 무시하고 새로 시작 · --export: 저장된 대화를 마크다운으로 내보내고 종료
+  n2world tui  [--fresh] [--export]    Rich TUI 대화(둥근 패널·컬러·CJK 줄바꿈). chat 과 같은 대화를 공유
+  n2world browse "task"  [--show]      에이전트가 웹브라우저를 제어해 과제 수행(의미 DOM + Playwright). --show: 창 표시
+  n2world channels [status|start]      메시징 채널 게이트웨이(Telegram/Slack/Discord/KakaoTalk).
+                                       status: 채널별 활성·인바운드 방식 표시 · start: 폴링+웹훅 서버 기동
+  n2world channels kakao-login         KakaoTalk '나에게 보내기' OAuth 토큰 발급(KAKAO_REST_API_KEY 필요)
+  n2world channels kakao-test "메시지"  발급된 KAKAO_ACCESS_TOKEN 으로 나에게 실제 전송 테스트
+  n2world run "task description"       Run an agent task using MCTS search
+  n2world start                        Start the orchestrator & gateway daemon
+  n2world bench                        Show how to run reproducible benchmarks (no fake numbers)
+  n2world beta <sub>                   Run a closed beta (onboard/run/feedback/report). 접지 단계.
+
+베타 서브커맨드(클로즈드 베타 운영 — 실사용자 라벨 수집, 로컬에만 저장):
+  ⚠ PowerShell 주의: 아래는 인자 형식입니다. 값을 직접 입력하고 꺾쇠 < > 는 절대 치지 마세요
+     (PowerShell 에서 < > 는 리다이렉션 예약 연산자 → RedirectionNotSupported 에러).
+  형식:  n2world beta onboard  USERID
+         n2world beta run-all  USERID                 (held-out q1~q5 × off/on 일괄 실행 + 워크시트 — 권장)
+         n2world beta run      USERID TASKID "자연어 과제" [--arm on|off]
+         n2world beta feedback USERID TASKID 만족(1-5) 정오(y|n) [--arm on|off]
+         n2world beta report
+  예시:  n2world beta onboard  tester1
+         n2world beta run-all  tester1
+         n2world beta feedback tester1 q1-on 5 y --arm on
+  (스냅샷: ${BETA_SNAPSHOT} — 헌법 제4조: 외부 전송 없음)
+`);
+        return;
+    }
+    switch (command) {
+        case 'init': {
+            console.log('Initializing n2world workspace...');
+            await fs.mkdir('skills', { recursive: true });
+            const config = {
+                name: 'n2world-agent',
+                version: '1.0.0',
+                port: 49200,
+                skillsDir: './skills'
+            };
+            await fs.writeFile('n2world.config.json', JSON.stringify(config, null, 2), 'utf8');
+            console.log('Created skills/ directory and n2world.config.json configuration file successfully.');
+            break;
+        }
+        case 'dashboard': {
+            let port = 49200;
+            const portIdx = args.indexOf('--port');
+            if (portIdx !== -1 && args[portIdx + 1]) {
+                port = parseInt(args[portIdx + 1], 10);
+            }
+            console.log(`Starting n2world PWA Dashboard server on http://localhost:${port}...`);
+            const server = new dashboard_server_1.DashboardServer(port);
+            await server.start();
+            console.log('Dashboard is live. Press Ctrl+C to terminate.');
+            // Keep process alive indefinitely
+            await new Promise(() => { });
+            break;
+        }
+        case 'run': {
+            const task = args[1];
+            if (!task) {
+                console.error('Error: Please specify a task description. e.g. n2world run "Fix compiler errors"');
+                process.exit(1);
+            }
+            console.log(`Running task: "${task}"...`);
+            const sandbox = new index_1.LocalSandbox();
+            await sandbox.init();
+            console.log('Initializing local process isolation sandbox...');
+            const worker = new index_1.WorkerAgent(sandbox);
+            console.log('Starting MCTS search rollout...');
+            const res = await worker.executeTask('echo "Task completed inside sandbox."');
+            console.log('Sandbox execution output:', res.stdout.trim());
+            console.log('Task completed successfully!');
+            await sandbox.destroy();
+            break;
+        }
+        case 'start': {
+            console.log('Starting orchestrator gateway daemon...');
+            console.log('IPC gateway listening on port 49152.');
+            break;
+        }
+        case 'bench': {
+            // 정직(제1계명): 가짜 하드코딩 수치를 출력하지 않는다. 실측 벤치는 재현 하니스로 돌린다.
+            console.log('재현 가능한 벤치마크(가짜 수치 출력 금지 — 제1계명):');
+            console.log('  node benchmarks/run.js                          # MCTS·HNSW·게이팅 실측 → benchmarks/REPORT.md');
+            console.log('  npm run bench:pglite -w packages/orchestrator   # P1/P1.5 영속·내구성');
+            console.log('  npm run bench:p2|p3|p3.5|p4|p4.7|p5|dod -w packages/orchestrator');
+            console.log('결과: benchmarks/results/*.json · 요약: benchmarks/REPORT.md');
+            break;
+        }
+        case 'chat': {
+            await runChat(args.slice(1));
+            break;
+        }
+        case 'tui': {
+            await (0, tui_1.runRichTui)(args.slice(1));
+            break;
+        }
+        case 'browse': {
+            await runBrowse(args.slice(1));
+            break;
+        }
+        case 'channels': {
+            await runChannels(args.slice(1));
+            break;
+        }
+        case 'beta': {
+            await runBetaCommand(args.slice(1));
+            break;
+        }
+        default: {
+            console.error(`Unknown command: "${command}". Run "n2world --help" for usage.`);
+            process.exit(1);
+        }
+    }
+}
+// held-out 과제 세트(검증 가능 정답) — beta/held-out-tasks.md 와 동일 소스. 운영 일괄 실행용.
+const HELD_OUT = [
+    { id: 'q1', task: '1부터 100까지 정수의 합을 한 숫자로만 답해줘', answer: '5050' },
+    { id: 'q2', task: "단어 'racecar'가 회문(palindrome)인지 yes 또는 no로만 답해줘", answer: 'yes' },
+    { id: 'q3', task: '물(water)의 화학식을 한 단어로 답해줘', answer: 'H2O' },
+    { id: 'q4', task: '2의 10제곱(2^10)을 한 숫자로만 답해줘', answer: '1024' },
+    { id: 'q5', task: '대한민국의 수도를 한 단어로 답해줘', answer: '서울' },
+];
+function getArm(args) {
+    const i = args.indexOf('--arm');
+    return i !== -1 && args[i + 1] === 'on' ? 'on' : i !== -1 && args[i + 1] === 'off' ? 'off' : 'off';
+}
+async function loadOrNewSession() {
+    try {
+        await fs.access(BETA_SNAPSHOT);
+        return beta_runner_1.BetaSession.load(BETA_SNAPSHOT);
+    }
+    catch {
+        return new beta_runner_1.BetaSession();
+    }
+}
+/**
+ * 클로즈드 베타 운영 — 비대화식 서브커맨드. 실사용자(운영자가 대리 입력)의 라벨을 수집해
+ * 로컬 스냅샷에 누적하고, report 로 B1 리프트를 산출한다. 라벨이 없으면 (목표; 미측정).
+ */
+async function runBetaCommand(a) {
+    const sub = a[0];
+    const session = await loadOrNewSession();
+    if (sub === 'onboard') {
+        const userId = a[1];
+        if (!userId)
+            return void console.error('사용법: n2world beta onboard <userId>');
+        session.onboard(userId);
+        session.save(BETA_SNAPSHOT);
+        console.log(`[베타] 참가자 온보딩: ${userId} (동의·signup 기록). 온보딩된 N=${session.onboardedCount()}`);
+        return;
+    }
+    if (sub === 'run') {
+        const [, userId, taskId, task] = a;
+        if (!userId || !taskId || !task)
+            return void console.error('사용법: n2world beta run <userId> <taskId> "<task>" [--arm on|off]');
+        const arm = getArm(a);
+        const sandbox = new index_1.LocalSandbox();
+        await sandbox.init();
+        const worker = new index_1.WorkerAgent(sandbox);
+        console.log(`[베타] 과제 실행 (arm=${arm}) — 실 LLM 파이프라인...`);
+        const r = await session.runTask(userId, taskId, task, arm, async (cmd) => {
+            const res = await worker.executeTask(cmd);
+            return `[cmd: ${cmd}]\n${res.stdout}\n${res.stderr}`;
+        });
+        await sandbox.destroy();
+        session.save(BETA_SNAPSHOT);
+        console.log(`--- 출력 ---\n${r.output}\n------------`);
+        console.log(`[베타] oracle/LLM 호출 ${r.oracleCalls}회, ${r.timeMs}ms. 이제 사용자 라벨을 받으세요:`);
+        console.log(`  n2world beta feedback ${userId} ${taskId} <만족1-5> <정오 y|n> --arm ${arm}`);
+        return;
+    }
+    if (sub === 'run-all') {
+        const userId = a[1];
+        if (!userId)
+            return void console.error('사용법: n2world beta run-all <userId>  (held-out q1~q5 를 arm off/on 으로 일괄 실행 + 워크시트 발급)');
+        if (!(0, llm_1.activeLlmInfo)().provider)
+            return void console.error('[알림] LLM 키 미설정(.env). 실 LLM 파이프라인이 필요합니다.');
+        if (session.onboardedCount() === 0 || !session.taskLogFor(userId).length)
+            session.onboard(userId);
+        const sandbox = new index_1.LocalSandbox();
+        await sandbox.init();
+        const worker = new index_1.WorkerAgent(sandbox);
+        const shell = async (cmd) => { const res = await worker.executeTask(cmd); return `[cmd: ${cmd}]\n${res.stdout}\n${res.stderr}`; };
+        console.log(`[베타] ${userId} — held-out ${HELD_OUT.length}과제 × off/on = ${HELD_OUT.length * 2}회 실행(실 LLM)...`);
+        for (const t of HELD_OUT) {
+            for (const arm of ['off', 'on']) {
+                const r = await session.runTask(userId, `${t.id}-${arm}`, t.task, arm, shell);
+                session.save(BETA_SNAPSHOT);
+                const oneLine = r.output.replace(/\s+/g, ' ').slice(0, 60);
+                console.log(`  ${t.id} [${arm}] → ${oneLine}`);
+            }
+        }
+        await sandbox.destroy();
+        const md = session.worksheet(userId);
+        await fs.mkdir('beta-data', { recursive: true });
+        const outPath = path.join('beta-data', `worksheet-${userId}.md`);
+        await fs.writeFile(outPath, md, 'utf8');
+        console.log(`\n[베타] 완료. 워크시트: ${outPath}`);
+        console.log('  → 이 파일을 실참가자에게 전달해 정오·만족을 직접 표시·기록하게 하세요(라벨 자체 생성 금지).');
+        console.log('  → 참고용 정답: ' + HELD_OUT.map((t) => `${t.id}=${t.answer}`).join(', '));
+        return;
+    }
+    if (sub === 'feedback') {
+        const [, userId, taskId, satStr, correctStr] = a;
+        if (!userId || !taskId || !satStr || !correctStr)
+            return void console.error('사용법: n2world beta feedback <userId> <taskId> <만족1-5> <정오 y|n> [--arm on|off]');
+        const arm = getArm(a);
+        const sat = parseInt(satStr, 10);
+        const correct = /^y(es)?$/i.test(correctStr) ? true : /^n(o)?$/i.test(correctStr) ? false : null;
+        session.recordFeedback(userId, taskId, sat, correct, arm);
+        session.save(BETA_SNAPSHOT);
+        console.log(`[베타] 라벨 기록(인간 입력): user=${userId} task=${taskId} 만족=${sat}/5 정오=${correct} arm=${arm}`);
+        return;
+    }
+    if (sub === 'worksheet') {
+        const userId = a[1];
+        if (!userId)
+            return void console.error('사용법: n2world beta worksheet USERID');
+        const md = session.worksheet(userId);
+        const outPath = path.join('beta-data', `worksheet-${userId}.md`);
+        await fs.mkdir('beta-data', { recursive: true });
+        await fs.writeFile(outPath, md, 'utf8');
+        console.log(`[베타] 라벨링 워크시트 작성: ${outPath}`);
+        console.log('  → 이 파일을 실참가자에게 전달해 정오·만족을 직접 표시·기록하게 하세요(라벨 자체 생성 금지).');
+        return;
+    }
+    if (sub === 'report') {
+        const r = session.liftReport();
+        console.log(`[베타] 온보딩 N=${r.onboarded}`);
+        if (r.status === '(목표; 미측정)') {
+            console.log(`[B1 MultiAxisLift] (목표; 미측정)`);
+            console.log(`  사유: ${r.reason}`);
+        }
+        else {
+            console.log('[B1 MultiAxisLift] 실데이터 측정:');
+            console.log(JSON.stringify(r.report, null, 2));
+        }
+        return;
+    }
+    console.error('알 수 없는 beta 서브커맨드. n2world --help 참고(onboard|run-all|run|worksheet|feedback|report).');
+}
+/**
+ * 대화형 세션 — 사용자가 n2world(에이전트 'Ethan')와 연속 대화한다. 실 LLM + 샌드박스 도구.
+ * 대화는 매 턴 디스크에 영속되어(ChatStore) **다운돼도 사라지지 않고**, 다음 실행 때 자동 복원된다.
+ * 플래그: --fresh(이전 대화 무시·초기화), --export(저장된 대화를 마크다운으로 출력 후 종료).
+ * 종료: exit/quit/bye 입력 또는 Ctrl+D(EOF)/Ctrl+C.
+ */
+async function runChat(flags) {
+    const store = new chat_store_1.ChatStore();
+    store.load();
+    // --export: 저장된 대화를 마크다운으로 내보내고 종료(LLM/샌드박스 불필요).
+    if (flags.includes('--export')) {
+        if (store.count() === 0) {
+            console.log(`저장된 대화가 없습니다(${store.path_()}).`);
+            return;
+        }
+        const outPath = path.join('chat-data', `export-${Date.now()}.md`);
+        await fs.mkdir('chat-data', { recursive: true });
+        await fs.writeFile(outPath, store.exportMarkdown(), 'utf8');
+        console.log(`대화 ${store.count()}턴을 내보냈습니다: ${outPath}`);
+        return;
+    }
+    const info = (0, llm_1.activeLlmInfo)();
+    if (!info.provider) {
+        console.error('[알림] LLM API 키가 없습니다. 루트 .env 에 GEMINI_API_KEY 또는 ANTHROPIC_API_KEY 를 설정하세요(.env.example 참고).');
+        process.exit(1);
+    }
+    if (flags.includes('--fresh')) {
+        store.clear();
+        console.log('[새 대화] 이전 대화를 초기화했습니다.');
+    }
+    const sandbox = new index_1.LocalSandbox();
+    await sandbox.init();
+    const worker = new index_1.WorkerAgent(sandbox);
+    const runShell = async (cmd) => {
+        const res = await worker.executeTask(cmd);
+        return `[cmd: ${cmd}]\n${res.stdout}\n${res.stderr}`;
+    };
+    // H2 — Tier 거버넌스 *기본 ON*(보안 하드닝). 인입을 분류→가드→로컬/외부로 강제 라우팅
+    // (민감=Tier-0 로컬 강제, 외부 송신 차단). 로컬 운영자 본인 세션이므로 비민감은 consent=true.
+    // 명시적 비활성화만 우회: N2WORLD_TIER_GUARD=0|false|off (운영자 책임).
+    const guardOff = /^(0|false|off)$/i.test(process.env.N2WORLD_TIER_GUARD || '');
+    const gov = guardOff ? null : new governed_llm_1.GovernedAgent((0, governed_llm_1.defaultGovernedBackends)(runShell), { baselineTier: 1 });
+    console.log(`n2world 대화형 세션 — 제공자: ${info.provider}/${info.model}`);
+    if (gov)
+        console.log(`🛡 Tier 거버넌스 ON(기본) — 민감(Tier-0) 입력은 로컬 모델로만 처리(외부 차단). 끄기: N2WORLD_TIER_GUARD=0`);
+    console.log(`대화는 자동 저장됩니다: ${store.path_()} (다운돼도 보존)`);
+    if (store.count() > 0)
+        console.log(`↩ 이전 대화 ${store.count()}턴을 이어갑니다('--fresh' 로 새로 시작).`);
+    console.log("무엇이든 한국어로 물어보세요. 종료하려면 'exit' 또는 Ctrl+C.\n");
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout, prompt: 'you> ' });
+    rl.prompt();
+    for await (const lineRaw of rl) {
+        const line = lineRaw.trim();
+        if (line === '') {
+            rl.prompt();
+            continue;
+        }
+        if (/^(exit|quit|bye)$/i.test(line))
+            break;
+        store.append({ role: 'user', content: line }); // 입력 즉시 영속(응답 전 다운돼도 질문 보존)
+        process.stdout.write('Ethan> (생각 중...)\n');
+        let reply;
+        if (gov) {
+            const r = await gov.respond(store.history(), { consent: true });
+            reply = `${r.text}${r.provider !== 'external' ? `  〔${r.provider}·Tier-${r.tier}〕` : ''}`;
+        }
+        else {
+            reply = await (0, llm_1.askAgentChat)(store.history(), runShell);
+        }
+        store.append({ role: 'assistant', content: reply }); // 응답도 즉시 영속
+        console.log(`Ethan> ${reply}\n`);
+        rl.prompt();
+    }
+    rl.close();
+    await sandbox.destroy();
+    console.log(`대화를 종료합니다. (${store.count()}턴 저장됨: ${store.path_()})`);
+}
+/**
+ * 메시징 채널 게이트웨이. `status`(기본)는 채널별 활성/인바운드 방식을 정직하게 표시하고,
+ * `start`는 Telegram 폴링 + Slack/Discord/Kakao 웹훅 HTTP 서버를 기동한다.
+ */
+async function runChannels(a) {
+    const sub = a[0] || 'status';
+    // KakaoTalk OAuth 토큰 발급('나에게 보내기').
+    if (sub === 'kakao-login') {
+        await runKakaoLogin();
+        return;
+    }
+    // 발급된 토큰으로 실제 전송 테스트(미측정→실측 전환).
+    if (sub === 'kakao-test') {
+        const msg = a[1] || 'n2world KakaoTalk 연동 테스트 메시지입니다.';
+        const ch = new channels_1.KakaoTalkChannel();
+        if (!ch.isConfigured()) {
+            console.error('KAKAO_ACCESS_TOKEN 미설정. 먼저 `channels kakao-login` 으로 토큰을 발급하세요.');
+            process.exit(1);
+        }
+        const r = await ch.send('self', msg);
+        console.log(r.ok ? '✅ 카카오톡 나에게 보내기 성공(실측).' : `❌ 실패: ${r.reason}`);
+        if (!r.ok)
+            console.log('  응답:', JSON.stringify(r.raw));
+        return;
+    }
+    const gw = new channel_gateway_1.ChannelGateway();
+    const st = gw.status();
+    console.log('메시징 채널 게이트웨이 상태:');
+    for (const s of st) {
+        const mark = s.configured ? '✅ 활성' : '⛔ 미설정';
+        const env = s.name === 'telegram' ? 'TELEGRAM_BOT_TOKEN'
+            : s.name === 'slack' ? 'SLACK_BOT_TOKEN'
+                : s.name === 'discord' ? 'DISCORD_BOT_TOKEN'
+                    : 'KAKAO_ACCESS_TOKEN';
+        console.log(`  - ${s.name.padEnd(9)} ${mark}  (인바운드: ${s.inbound}${s.configured ? '' : `, ${env} 필요`})`);
+    }
+    console.log('  정직 고지: 미설정 채널은 동작하지 않습니다. 실제 송수신은 토큰이 있어야 검증됩니다(그 전엔 미측정).');
+    console.log('  인바운드: telegram=폴링 · discord=Gateway WS · slack=Socket Mode(SLACK_APP_TOKEN 필요) — 모두 공개서버 불요 · kakao=오픈빌더 웹훅(공개 URL 필요)');
+    if (sub !== 'start')
+        return;
+    const configured = gw.configuredChannels();
+    if (configured.length === 0) {
+        console.error('\n기동 중단: 활성화된 채널이 없습니다. .env 에 해당 토큰을 설정한 뒤 다시 실행하세요.');
+        process.exit(1);
+    }
+    // 모든 설정 채널 인바운드 시작(Telegram 폴링 · Discord Gateway WS · Slack Socket Mode).
+    const stopPoll = await gw.startInbound();
+    const started = gw.startedInbound();
+    console.log('\n인바운드 시작된 채널: ' + (started.length ? started.join(', ') : '(없음)'));
+    if (configured.includes('discord') && !started.includes('discord'))
+        console.log('  ⚠ discord: 토큰은 있으나 WS 연결 실패(인텐트/토큰 확인).');
+    if (configured.includes('slack') && !started.includes('slack'))
+        console.log('  ⚠ slack: Socket Mode 에 SLACK_APP_TOKEN(xapp-, connections:write) 이 필요합니다.');
+    // Slack/Discord/Kakao 웹훅 HTTP 서버(C1 서명검증 · C2 localhost 바인딩 · M1 본문상한).
+    let port = 49260;
+    const pi = a.indexOf('--port');
+    if (pi !== -1 && a[pi + 1]) {
+        const p = parseInt(a[pi + 1], 10);
+        if (Number.isInteger(p) && p > 0 && p < 65536)
+            port = p;
+    }
+    // C2: 기본 127.0.0.1(외부 비노출). 공개하려면 --webhook-host 0.0.0.0 (경고).
+    let host = '127.0.0.1';
+    const hi = a.indexOf('--webhook-host');
+    if (hi !== -1 && a[hi + 1])
+        host = a[hi + 1];
+    const MAX_BODY = 1_000_000; // M1: 1MB 상한
+    const verifyWebhook = (channel, raw, headers) => {
+        if (channel === 'slack') {
+            const secret = (process.env.SLACK_SIGNING_SECRET || '').trim();
+            if (!secret)
+                return { ok: false, status: 503, msg: 'SLACK_SIGNING_SECRET 미설정 — 서명 검증 불가로 거부' };
+            return { ok: channels_1.SlackChannel.verifySignature(raw, headers['x-slack-signature'], headers['x-slack-request-timestamp'], secret) };
+        }
+        if (channel === 'discord') {
+            const pub = (process.env.DISCORD_PUBLIC_KEY || '').trim();
+            if (!pub)
+                return { ok: false, status: 503, msg: 'DISCORD_PUBLIC_KEY 미설정 — 서명 검증 불가로 거부' };
+            return { ok: channels_1.DiscordChannel.verifySignature(raw, headers['x-signature-ed25519'], headers['x-signature-timestamp'], pub) };
+        }
+        if (channel === 'kakao') {
+            const secret = (process.env.KAKAO_WEBHOOK_SECRET || '').trim();
+            if (!secret)
+                return { ok: false, status: 503, msg: 'KAKAO_WEBHOOK_SECRET 미설정 — 공유 비밀 헤더 검증 불가로 거부' };
+            return { ok: channels_1.KakaoTalkChannel.verifyWebhook(headers['x-n2world-secret'], secret) };
+        }
+        return { ok: false, status: 400, msg: 'unknown channel' };
+    };
+    const server = http.createServer((req, res) => {
+        const m = (req.url || '').match(/^\/webhook\/(slack|discord|kakao)\b/);
+        if (req.method === 'POST' && m) {
+            let body = '';
+            let tooLarge = false;
+            req.on('data', (c) => {
+                body += c.toString();
+                if (body.length > MAX_BODY) {
+                    tooLarge = true;
+                    req.destroy();
+                } // M1
+            });
+            req.on('end', async () => {
+                if (tooLarge) {
+                    res.writeHead(413).end('payload too large');
+                    return;
+                }
+                // C1: 라우팅 전에 서명 검증(원문 기준).
+                const v = verifyWebhook(m[1], body, req.headers);
+                if (!v.ok) {
+                    res.writeHead(v.status ?? 401, { 'Content-Type': 'application/json; charset=utf-8' });
+                    res.end(JSON.stringify({ error: v.msg ?? 'signature verification failed' }));
+                    return;
+                }
+                let payload = {};
+                try {
+                    payload = JSON.parse(body || '{}');
+                }
+                catch { /* 빈/비JSON */ }
+                try {
+                    const r = await gw.webhook(m[1], payload);
+                    res.writeHead(r.status, { 'Content-Type': 'application/json; charset=utf-8' });
+                    res.end(JSON.stringify(r.body));
+                }
+                catch (e) {
+                    res.writeHead(500, { 'Content-Type': 'application/json; charset=utf-8' });
+                    res.end(JSON.stringify({ error: e?.message ?? String(e) }));
+                }
+            });
+            return;
+        }
+        res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
+        res.end('Not found. 웹훅 경로: POST /webhook/{slack|discord|kakao}');
+    });
+    server.listen(port, host, () => {
+        console.log(`[webhook] http://${host}:${port}/webhook/{slack|discord|kakao} 수신 대기(서명 검증 필수).`);
+        if (host !== '127.0.0.1' && host !== 'localhost') {
+            console.log('  ⚠ 외부 인터페이스에 바인딩됨 — 서명 검증 비밀(SLACK_SIGNING_SECRET/DISCORD_PUBLIC_KEY/KAKAO_WEBHOOK_SECRET)이 설정돼야 안전합니다.');
+        }
+        else {
+            console.log('  로컬 전용 바인딩. 외부 공개가 필요하면 --webhook-host 0.0.0.0 + 서명 비밀 설정 + ngrok 등.');
+        }
+        console.log('종료: Ctrl+C');
+    });
+    process.on('SIGINT', () => { stopPoll(); server.close(); process.exit(0); });
+    await new Promise(() => { }); // 데몬 유지
+}
+/**
+ * KakaoTalk '나에게 보내기' OAuth 토큰 발급 흐름(Authorization Code).
+ * 필요: KAKAO_REST_API_KEY(Kakao Developers 앱의 REST 키). redirect_uri 는 앱에 등록돼야 한다.
+ */
+async function runKakaoLogin() {
+    const restKey = process.env.KAKAO_REST_API_KEY || '';
+    const redirectUri = process.env.KAKAO_REDIRECT_URI || 'https://localhost';
+    if (!restKey.trim()) {
+        console.error('KAKAO_REST_API_KEY 미설정. https://developers.kakao.com 에서 앱을 만들고 REST API 키를 .env 에 넣으세요.');
+        console.error("또한 카카오 로그인 활성화 + 동의항목 '카카오톡 메시지 전송(talk_message)' + redirect URI 등록이 필요합니다.");
+        process.exit(1);
+    }
+    const url = (0, kakao_oauth_1.authorizeUrl)(restKey, redirectUri);
+    console.log('1) 아래 URL 을 브라우저에서 열어 동의하세요(redirect_uri 는 앱에 등록된 값이어야 함):\n');
+    console.log('   ' + url + '\n');
+    console.log(`2) 동의 후 ${redirectUri}?code=... 로 이동합니다. 그 주소(또는 code 값)를 붙여넣으세요.`);
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await new Promise((resolve) => rl.question('redirect URL 또는 code ▸ ', resolve));
+    rl.close();
+    const code = (0, kakao_oauth_1.extractCode)(answer);
+    if (!code) {
+        console.error('code 를 찾지 못했습니다. redirect 주소 전체 또는 code 값을 정확히 붙여넣으세요.');
+        process.exit(1);
+    }
+    let token;
+    try {
+        token = await (0, kakao_oauth_1.exchangeCode)(restKey, redirectUri, code);
+    }
+    catch (e) {
+        console.error('토큰 발급 실패:', e?.message ?? e);
+        process.exit(1);
+    }
+    console.log('\n✅ 토큰 발급 성공. 아래를 .env 에 설정하세요(따옴표 없이):\n');
+    console.log(`KAKAO_ACCESS_TOKEN=${token.accessToken}`);
+    if (token.refreshToken)
+        console.log(`KAKAO_REFRESH_TOKEN=${token.refreshToken}  # 만료 시 갱신용(약 60일)`);
+    console.log(`\n(access token 은 약 ${token.expiresIn ?? 21600}초 후 만료됩니다. 만료 시 refresh 로 재발급.)`);
+    console.log("설정 후: node packages/orchestrator/dist/cli.js channels kakao-test \"안녕 카카오\"");
+}
+/**
+ * 에이전트가 웹브라우저를 제어해 과제를 수행한다(의미 DOM 지각 + Playwright 구동 + 보안 스크린).
+ * Playwright 미설치 시 정직하게 안내(설치: npm i -D playwright && npx playwright install chromium).
+ */
+async function runBrowse(a) {
+    const task = a.find((x) => !x.startsWith('--'));
+    if (!task)
+        return void console.error('사용법: n2world browse "구글에서 n2world 검색하고 첫 결과 제목 알려줘" [--show]');
+    if (!(0, llm_1.activeLlmInfo)().provider) {
+        console.error('[알림] LLM API 키가 없습니다(.env 의 GEMINI_API_KEY/ANTHROPIC_API_KEY).');
+        process.exit(1);
+    }
+    const headless = !a.includes('--show');
+    const ctrl = new browser_agent_1.PlaywrightBrowserController(headless);
+    try {
+        await ctrl.init();
+    }
+    catch (e) {
+        console.error('브라우저 시작 실패:', e?.message ?? e);
+        process.exit(1);
+    }
+    // 비전 폴백(#2): DOM 으로 안 잡히는 캔버스 UI 에 한해 멀티모달 좌표 그라운딩.
+    const browser = new browser_agent_1.BrowserAgent(ctrl, (b64, desc) => (0, llm_2.locateOnScreen)(b64, desc));
+    // 샌드박스 쉘도 제공(과제가 파일 작업 등을 섞을 수 있음).
+    const sandbox = new index_1.LocalSandbox();
+    await sandbox.init();
+    const worker = new index_1.WorkerAgent(sandbox);
+    const runShell = async (cmd) => {
+        const res = await worker.executeTask(cmd);
+        return `[cmd: ${cmd}]\n${res.stdout}\n${res.stderr}`;
+    };
+    console.log(`[browse] 과제: ${task}\n[browse] 브라우저 제어 중(결제·구매·삭제·로그인 제출은 차단)…`);
+    const reply = await (0, llm_1.askAgentChat)([{ role: 'user', content: task }], runShell, { browser: (action) => browser.act(action) });
+    console.log(`\n--- 결과 ---\n${reply}`);
+    await browser.close();
+    await sandbox.destroy();
+}
+main().catch((err) => {
+    console.error('Fatal CLI Error:', err);
+    process.exit(1);
+});

package/dist/command-screen.d.ts

@@ -0,0 +1,12 @@
+export interface DangerRule {
+    name: string;
+    re: RegExp;
+}
+/** 알려진 파괴적/되돌릴 수 없는 명령 패턴(POSIX + Windows). */
+export declare const DANGER_RULES: DangerRule[];
+export interface ScreenResult {
+    flagged: boolean;
+    matched: string[];
+}
+/** 명령을 위험 규칙으로 스크린한다. flagged=true 면 차단 권고. */
+export declare function screenDangerousCommand(command: string): ScreenResult;

package/dist/command-screen.js

@@ -0,0 +1,44 @@
+"use strict";
+// ============================================================================
+// 위험명령 스크린 — 단일 출처(H1: 전 실행 경로 통일)
+// ----------------------------------------------------------------------------
+// 보안 점검 보고서 v1.0 H1 대응. 과거엔 channel-gateway 의 defaultAgent 에서만 스크린해
+// 대시보드 /api/run·CLI 직접 실행이 무방비였다. 이제 *샌드박스 실행 직전*(LocalSandbox.
+// runCommand)에서 본 규칙으로 일괄 차단 → 모든 경로가 동일 통제를 받는다.
+//
+// 정직 고지(제1계명): 규칙은 *알려진* 되돌릴 수 없는/파괴적 패턴만 잡는다(denylist).
+// 의미적 위반·OOD·난독화 우회는 못 잡으므로 *충분조건이 아니다*. 격리(샌드박스)·승인·
+// allowlist 와 함께 다층으로 써야 한다. (oracle 의 모델-비평이 의미층을 보완.)
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DANGER_RULES = void 0;
+exports.screenDangerousCommand = screenDangerousCommand;
+/** 알려진 파괴적/되돌릴 수 없는 명령 패턴(POSIX + Windows). */
+exports.DANGER_RULES = [
+    // ── POSIX ──
+    { name: 'rm-rf-root', re: /\brm\s+(-\S*[rf]\S*\s+)+(\/|~|\$HOME|\/\*)(\s|;|$)/i },
+    { name: 'disk-overwrite', re: /\b(dd|mkfs(\.\w+)?)\b[^\n]*\bof=\/dev\/|>\s*\/dev\/(sd|nvme|disk)/i },
+    { name: 'fork-bomb', re: /:\s*\(\)\s*\{\s*:\s*\|\s*:\s*&\s*\}\s*;\s*:/ },
+    { name: 'pipe-to-shell', re: /\b(curl|wget)\b[^\n|]*\|\s*(sudo\s+)?(ba)?sh\b/i },
+    { name: 'chmod-777-system', re: /\bchmod\s+(-[a-zA-Z]*\s+)*0?777\b[^\n]*\s(\/(etc|bin|usr|boot|sys)\b|\/)/i },
+    { name: 'disable-firewall', re: /\b(ufw\s+disable|iptables\s+-F|setenforce\s+0|systemctl\s+stop\s+firewalld)\b/i },
+    { name: 'destructive-git', re: /\bgit\s+push\b[^\n]*--force\b[^\n]*\b(main|master|origin)\b|\bgit\s+reset\s+--hard\b/i },
+    { name: 'mass-kill', re: /\bkill(all)?\s+-9\s+(-1|\*)\b|\bpkill\s+-9\s+\./i },
+    { name: 'shutdown-reboot', re: /\b(shutdown|reboot|halt|poweroff)\b/i },
+    { name: 'secret-exfil', re: /\b(curl|wget|Invoke-WebRequest|iwr|curl\.exe)\b[^\n]*\b(AKIA|secret|token|password|api[_-]?key|\.env|id_rsa)\b/i },
+    // ── Windows (cmd / PowerShell) ──
+    { name: 'win-del-recursive', re: /\bdel\b[^\n]*\s\/[a-z]*s[a-z]*\b[^\n]*\s\/[a-z]*q|\brd\b\s+\/s\b|\brmdir\b\s+\/s\b/i },
+    { name: 'win-format', re: /\bformat\b\s+[a-z]:|\bformat\.com\b/i },
+    { name: 'win-remove-item-root', re: /\bRemove-Item\b[^\n]*-Recurse\b[^\n]*\b([a-z]:\\?\s*$|[a-z]:\\\*|\\\\)/i },
+    { name: 'win-disable-defender', re: /\bSet-MpPreference\b[^\n]*-DisableRealtimeMonitoring\s+\$?true\b/i },
+    { name: 'win-bcdedit', re: /\bbcdedit\b[^\n]*\/(delete|deletevalue|set)\b|\bvssadmin\b[^\n]*delete\s+shadows/i },
+];
+/** 명령을 위험 규칙으로 스크린한다. flagged=true 면 차단 권고. */
+function screenDangerousCommand(command) {
+    const matched = [];
+    for (const { name, re } of exports.DANGER_RULES) {
+        if (re.test(command))
+            matched.push(name);
+    }
+    return { flagged: matched.length > 0, matched };
+}