@robota-sdk/agent-cli 3.0.0-beta.62 → 3.0.0-beta.64

package/dist/node/subagents/child-process-subagent-worker.js

@@ -1,123 +1,2 @@
-import {
-  createProviderFromProfile,
-  isSubagentWorkerParentMessage
-} from "../chunk-BENOH47A.js";
-
-// src/subagents/child-process-subagent-worker.ts
-import {
-  createDefaultTools,
-  createSubagentLogger,
-  createSubagentSession
-} from "@robota-sdk/agent-sdk";
-var CANCEL_EXIT_CODE = 130;
-var NOOP_TERMINAL = {
-  write: () => {
-  },
-  writeLine: () => {
-  },
-  writeMarkdown: () => {
-  },
-  writeError: () => {
-  },
-  prompt: () => Promise.resolve(""),
-  select: () => Promise.resolve(0),
-  spinner: () => ({ stop: () => {
-  }, update: () => {
-  } })
-};
-var session = null;
-var cancelled = false;
-var running = Promise.resolve();
-function sendChildMessage(message) {
-  if (process.send) {
-    process.send(message);
-  }
-}
-async function runInitialPrompt(payload) {
-  try {
-    const provider = createProviderFromProfile(payload.providerProfile, payload.request.model);
-    const sessionLogger = payload.logsDir ? createSubagentLogger(payload.request.parentSessionId, payload.jobId, payload.logsDir) : void 0;
-    session = createSubagentSession({
-      agentDefinition: payload.agentDefinition,
-      parentConfig: payload.parentConfig,
-      parentContext: payload.parentContext,
-      parentTools: createDefaultTools(),
-      provider,
-      terminal: NOOP_TERMINAL,
-      sessionId: payload.jobId,
-      ...sessionLogger ? { sessionLogger } : {},
-      permissionMode: payload.permissionMode,
-      hooks: payload.parentConfig.hooks,
-      onTextDelta: (delta) => sendChildMessage({ type: "text_delta", delta }),
-      onToolExecution: forwardToolExecution
-    });
-    const output = await session.run(payload.request.prompt);
-    if (cancelled) {
-      sendChildMessage({ type: "cancelled", reason: "Subagent worker cancelled" });
-      return;
-    }
-    sendChildMessage({ type: "result", output });
-  } catch (error) {
-    if (cancelled) {
-      sendChildMessage({ type: "cancelled", reason: "Subagent worker cancelled" });
-      return;
-    }
-    const message = error instanceof Error ? error.message : String(error);
-    sendChildMessage({ type: "error", message });
-  } finally {
-    setImmediate(() => process.exit(cancelled ? CANCEL_EXIT_CODE : 0));
-  }
-}
-function forwardToolExecution(event) {
-  if (event.type === "start") {
-    sendChildMessage({ type: "tool_start", toolName: event.toolName, toolArgs: event.toolArgs });
-    return;
-  }
-  sendChildMessage({ type: "tool_end", toolName: event.toolName, success: event.success ?? true });
-}
-function runFollowUp(prompt) {
-  if (session === null) {
-    sendChildMessage({ type: "error", message: "Subagent worker has not started" });
-    return;
-  }
-  running = running.then(async () => {
-    try {
-      await session?.run(prompt);
-    } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      sendChildMessage({ type: "error", message });
-    }
-  });
-}
-async function cancelWorker(reason) {
-  cancelled = true;
-  session?.abort();
-  sendChildMessage({ type: "cancelled", reason });
-  await session?.shutdown({ reason: "other" }).catch(() => void 0);
-  setTimeout(() => process.exit(CANCEL_EXIT_CODE), 0);
-}
-process.on("message", (message) => {
-  if (!isSubagentWorkerParentMessage(message)) {
-    sendChildMessage({ type: "error", message: "Malformed subagent worker parent message" });
-    return;
-  }
-  switch (message.type) {
-    case "start":
-      running = running.then(() => runInitialPrompt(message.payload));
-      break;
-    case "send":
-      runFollowUp(message.prompt);
-      break;
-    case "cancel":
-      void cancelWorker(message.reason);
-      break;
-    default:
-      sendChildMessage({ type: "error", message: "Unhandled subagent worker parent message" });
-  }
-});
-process.on("disconnect", () => {
-  cancelled = true;
-  session?.abort();
-  void session?.shutdown({ reason: "other" }).catch(() => void 0);
-});
-sendChildMessage({ type: "ready" });
+import{n as e,r as t}from"../child-process-subagent-ipc-DVpVp43R.js";import{createDefaultTools as n,createSubagentLogger as r,createSubagentSession as i}from"@robota-sdk/agent-framework";import{createProviderFromProfile as a}from"@robota-sdk/agent-executor";const o={write:()=>{},writeLine:()=>{},writeMarkdown:()=>{},writeError:()=>{},prompt:()=>Promise.resolve(``),select:()=>Promise.resolve(0),spinner:()=>({stop:()=>{},update:()=>{}})};let s=null,c=!1,l=Promise.resolve();function u(e){process.send&&process.send(e)}async function d(e){try{let l=a(e.providerProfile,e.request.model,t),d=e.logsDir?r(e.request.parentSessionId,e.jobId,e.logsDir):void 0;s=i({agentDefinition:e.agentDefinition,parentConfig:e.parentConfig,parentContext:e.parentContext,parentTools:n(),provider:l,terminal:o,sessionId:e.jobId,...d?{sessionLogger:d}:{},permissionMode:e.permissionMode,hooks:e.parentConfig.hooks,onTextDelta:e=>u({type:`text_delta`,delta:e}),onToolExecution:f});let p=await s.run(e.request.prompt);if(c){u({type:`cancelled`,reason:`Subagent worker cancelled`});return}u({type:`result`,output:p})}catch(e){if(c){u({type:`cancelled`,reason:`Subagent worker cancelled`});return}u({type:`error`,message:e instanceof Error?e.message:String(e)})}finally{setImmediate(()=>process.exit(c?130:0))}}function f(e){if(e.type===`start`){u({type:`tool_start`,toolName:e.toolName,toolArgs:e.toolArgs});return}u({type:`tool_end`,toolName:e.toolName,success:e.success??!0})}function p(e){if(s===null){u({type:`error`,message:`Subagent worker has not started`});return}l=l.then(async()=>{try{await s?.run(e)}catch(e){u({type:`error`,message:e instanceof Error?e.message:String(e)})}})}async function m(e){c=!0,s?.abort(),u({type:`cancelled`,reason:e}),await s?.shutdown({reason:`other`}).catch(()=>void 0),setTimeout(()=>process.exit(130),0)}process.on(`message`,t=>{if(!e(t)){u({type:`error`,message:`Malformed subagent worker parent message`});return}switch(t.type){case`start`:l=l.then(()=>d(t.payload));break;case`send`:p(t.prompt);break;case`cancel`:m(t.reason);break;default:u({type:`error`,message:`Unhandled subagent worker parent message`})}}),process.on(`disconnect`,()=>{c=!0,s?.abort(),s?.shutdown({reason:`other`}).catch(()=>void 0)}),u({type:`ready`});export{};
+//# sourceMappingURL=child-process-subagent-worker.js.map

package/dist/node/subagents/child-process-subagent-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-process-subagent-worker.js","names":[],"sources":["../../../src/subagents/child-process-subagent-worker.ts"],"sourcesContent":["import {\n  createDefaultTools,\n  createSubagentLogger,\n  createSubagentSession,\n} from '@robota-sdk/agent-framework';\nimport { createProviderFromProfile } from '@robota-sdk/agent-executor';\nimport {\n  isSubagentWorkerParentMessage,\n  type ISubagentWorkerStartPayload,\n  type TSubagentWorkerChildMessage,\n  type TSubagentWorkerWireValue,\n} from './child-process-subagent-ipc.js';\nimport type { ITerminalOutput } from '../types.js';\nimport { DEFAULT_PROVIDER_DEFINITIONS } from '../utils/provider-default-definitions.js';\n\nconst CANCEL_EXIT_CODE = 130;\n\nconst NOOP_TERMINAL: ITerminalOutput = {\n  write: (): void => {},\n  writeLine: (): void => {},\n  writeMarkdown: (): void => {},\n  writeError: (): void => {},\n  prompt: (): Promise<string> => Promise.resolve(''),\n  select: (): Promise<number> => Promise.resolve(0),\n  spinner: () => ({ stop: (): void => {}, update: (): void => {} }),\n};\n\ntype TSubagentSessionToolEvent = Parameters<\n  NonNullable<Parameters<typeof createSubagentSession>[0]['onToolExecution']>\n>[0];\n\nlet session: ReturnType<typeof createSubagentSession> | null = null;\nlet cancelled = false;\nlet running: Promise<void> = Promise.resolve();\n\nfunction sendChildMessage(message: TSubagentWorkerChildMessage): void {\n  if (process.send) {\n    process.send(message);\n  }\n}\n\nasync function runInitialPrompt(payload: ISubagentWorkerStartPayload): Promise<void> {\n  try {\n    const provider = createProviderFromProfile(\n      payload.providerProfile,\n      payload.request.model,\n      DEFAULT_PROVIDER_DEFINITIONS,\n    );\n    const sessionLogger = payload.logsDir\n      ? createSubagentLogger(payload.request.parentSessionId, payload.jobId, payload.logsDir)\n      : undefined;\n    session = createSubagentSession({\n      agentDefinition: payload.agentDefinition,\n      parentConfig: payload.parentConfig,\n      parentContext: payload.parentContext,\n      parentTools: createDefaultTools(),\n      provider,\n      terminal: NOOP_TERMINAL,\n      sessionId: payload.jobId,\n      ...(sessionLogger ? { sessionLogger } : {}),\n      permissionMode: payload.permissionMode,\n      hooks: payload.parentConfig.hooks,\n      onTextDelta: (delta) => sendChildMessage({ type: 'text_delta', delta }),\n      onToolExecution: forwardToolExecution,\n    });\n    const output = await session.run(payload.request.prompt);\n    if (cancelled) {\n      sendChildMessage({ type: 'cancelled', reason: 'Subagent worker cancelled' });\n      return;\n    }\n    sendChildMessage({ type: 'result', output });\n  } catch (error) {\n    if (cancelled) {\n      sendChildMessage({ type: 'cancelled', reason: 'Subagent worker cancelled' });\n      return;\n    }\n    const message = error instanceof Error ? error.message : String(error);\n    sendChildMessage({ type: 'error', message });\n  } finally {\n    setImmediate(() => process.exit(cancelled ? CANCEL_EXIT_CODE : 0));\n  }\n}\n\nfunction forwardToolExecution(event: TSubagentSessionToolEvent): void {\n  if (event.type === 'start') {\n    sendChildMessage({ type: 'tool_start', toolName: event.toolName, toolArgs: event.toolArgs });\n    return;\n  }\n  sendChildMessage({ type: 'tool_end', toolName: event.toolName, success: event.success ?? true });\n}\n\nfunction runFollowUp(prompt: string): void {\n  if (session === null) {\n    sendChildMessage({ type: 'error', message: 'Subagent worker has not started' });\n    return;\n  }\n  running = running.then(async () => {\n    try {\n      await session?.run(prompt);\n    } catch (error) {\n      const message = error instanceof Error ? error.message : String(error);\n      sendChildMessage({ type: 'error', message });\n    }\n  });\n}\n\nasync function cancelWorker(reason?: string): Promise<void> {\n  cancelled = true;\n  session?.abort();\n  sendChildMessage({ type: 'cancelled', reason });\n  await session?.shutdown({ reason: 'other' }).catch(() => undefined);\n  setTimeout(() => process.exit(CANCEL_EXIT_CODE), 0);\n}\n\nprocess.on('message', (message: TSubagentWorkerWireValue) => {\n  if (!isSubagentWorkerParentMessage(message)) {\n    sendChildMessage({ type: 'error', message: 'Malformed subagent worker parent message' });\n    return;\n  }\n\n  switch (message.type) {\n    case 'start':\n      running = running.then(() => runInitialPrompt(message.payload));\n      break;\n    case 'send':\n      runFollowUp(message.prompt);\n      break;\n    case 'cancel':\n      void cancelWorker(message.reason);\n      break;\n    default:\n      sendChildMessage({ type: 'error', message: 'Unhandled subagent worker parent message' });\n  }\n});\n\nprocess.on('disconnect', () => {\n  cancelled = true;\n  session?.abort();\n  void session?.shutdown({ reason: 'other' }).catch(() => undefined);\n});\n\nsendChildMessage({ type: 'ready' });\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@robota-sdk/agent-cli",
-  "version": "3.0.0-beta.62",
+  "version": "3.0.0-beta.64",
   "description": "AI coding assistant CLI built on Robota SDK",
   "type": "module",
   "bin": {
@@ -38,55 +38,27 @@
     "bin"
   ],
   "dependencies": {
+    "@robota-sdk/agent-executor": "3.0.0-beta.64",
     "chalk": "^5.3.0",
     "cli-highlight": "^2.1.0",
-    "ink": "^7.0.1",
-    "ink-select-input": "^6.2.0",
-    "ink-spinner": "^5.0.0",
-    "ink-text-input": "^6.0.0",
     "marked": "^9.1.5",
     "marked-terminal": "^7.3.0",
     "open": "^11.0.0",
-    "react": "19.2.4",
     "string-width": "^8.2.0",
     "ws": "^8.18.3",
-    "@robota-sdk/agent-command-agent": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-background": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-help": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-exit": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-language": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-model": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-memory": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-context": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-compact": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-permissions": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-provider": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-plugin": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-rewind": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-reset": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-session": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-skills": "3.0.0-beta.62",
-    "@robota-sdk/agent-core": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-statusline": "3.0.0-beta.62",
-    "@robota-sdk/agent-command-user-local": "3.0.0-beta.62",
-    "@robota-sdk/agent-provider-anthropic": "3.0.0-beta.62",
-    "@robota-sdk/agent-provider-deepseek": "3.0.0-beta.62",
-    "@robota-sdk/agent-provider-openai": "3.0.0-beta.62",
-    "@robota-sdk/agent-provider-gemini": "3.0.0-beta.62",
-    "@robota-sdk/agent-provider-qwen": "3.0.0-beta.62",
-    "@robota-sdk/agent-provider-gemma": "3.0.0-beta.62",
-    "@robota-sdk/agent-transport-headless": "3.0.0-beta.62",
-    "@robota-sdk/agent-sdk": "3.0.0-beta.62",
-    "@robota-sdk/agent-transport-ws": "3.0.0-beta.62"
+    "@robota-sdk/agent-command": "3.0.0-beta.64",
+    "@robota-sdk/agent-core": "3.0.0-beta.64",
+    "@robota-sdk/agent-interface-transport": "3.0.0-beta.64",
+    "@robota-sdk/agent-provider": "3.0.0-beta.64",
+    "@robota-sdk/agent-framework": "3.0.0-beta.64",
+    "@robota-sdk/agent-transport": "3.0.0-beta.64"
   },
   "devDependencies": {
     "@homebridge/node-pty-prebuilt-multiarch": "^0.13.1",
     "@types/marked": "^6.0.0",
-    "@types/react": "^19.2.14",
     "@types/ws": "^8.5.10",
-    "ink-testing-library": "^4.0.0",
     "rimraf": "^5.0.5",
-    "tsup": "^8.0.1",
+    "tsdown": "^0.22.0",
     "tsx": "^4.7.0",
     "typescript": "^5.3.3",
     "vitest": "^1.6.1"
@@ -96,9 +68,9 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsup",
-    "build:js": "tsup --no-dts",
-    "build:types": "tsup --dts-only",
+    "build": "pnpm --filter @robota-sdk/agent-web build:spa && node scripts/copy-web-assets.mjs && tsdown",
+    "build:js": "tsdown --no-dts",
+    "build:types": "tsdown --dts",
     "dev": "tsx src/bin.ts",
     "start": "node dist/node/bin.js",
     "test": "vitest run --passWithNoTests",

package/README.ko.md

@@ -1,297 +0,0 @@
-**Language:** [English](README.md) | [한국어](README.ko.md)
-
-# @robota-sdk/agent-cli
-
-Robota SDK 기반의 AI 코딩 어시스턴트 CLI. AGENTS.md/CLAUDE.md를 로드하여 프로젝트 컨텍스트를 파악하고, Claude Code 호환 권한 모드를 갖춘 도구 호출 REPL을 제공합니다.
-
-## 시스템 요구사항
-
-**Node.js 22 이상** 필요합니다.
-
-```bash
-node --version  # v22.x.x 이상이어야 합니다
-```
-
-Node.js 버전이 22 미만이라면 [nvm](https://github.com/nvm-sh/nvm)으로 업그레이드:
-
-```bash
-nvm install 22
-nvm use 22
-```
-
-## 설치
-
-```bash
-# 전역 설치
-npm install -g @robota-sdk/agent-cli
-
-# 또는 npx로 직접 실행
-npx @robota-sdk/agent-cli
-```
-
-> **macOS Terminal.app 사용자**: 한국어/중국어/일본어 입력 시 크래시가 발생할 수 있습니다. **[iTerm2](https://iterm2.com/)** 사용을 권장합니다. 이는 Ink + Terminal.app의 알려진 문제로 Claude Code와 동일합니다.
-
-전역 설치 후 시스템 전체에서 `robota` 명령어를 사용할 수 있습니다:
-
-```bash
-robota                        # 인터랙티브 REPL
-robota "프롬프트"              # 초기 프롬프트와 함께 REPL 시작
-robota -p "파일 목록 출력"     # 출력 모드 (단발성, 응답 후 종료)
-```
-
-### 환경 변수
-
-| 변수                | 설명                                     | 필수 여부      |
-| ------------------- | ---------------------------------------- | -------------- |
-| `ANTHROPIC_API_KEY` | Anthropic 프로바이더용 API 키            | Anthropic 전용 |
-| `DEEPSEEK_API_KEY`  | DeepSeek 프로바이더용 API 키             | DeepSeek 전용  |
-| `DASHSCOPE_API_KEY` | Qwen(알리바바 클라우드) 모델 스튜디오 키 | Qwen 전용      |
-
-실행 전 키를 설정하세요:
-
-```bash
-export ANTHROPIC_API_KEY=sk-ant-...
-```
-
-## 개발 환경 설정 (모노레포)
-
-```bash
-# 의존성 및 CLI 빌드
-pnpm build:deps
-pnpm --filter @robota-sdk/agent-cli build
-```
-
-## 실행 (모노레포)
-
-```bash
-# 모노레포 루트에서
-cd packages/agent-cli
-
-# 개발 모드 (빌드 불필요)
-pnpm dev
-
-# 프로덕션 모드 (빌드 필요)
-pnpm start
-
-# 인자 포함 실행
-pnpm dev -- --version
-pnpm dev -- --permission-mode plan
-pnpm dev -- -p "src/ 내 모든 TypeScript 파일 목록"
-```
-
-## CLI 플래그
-
-```
-robota                              # 인터랙티브 REPL (기본 모드)
-robota "프롬프트"                   # 초기 프롬프트와 함께 REPL 시작
-robota -p "프롬프트"                # 출력 모드 (단발성, 응답 후 종료)
-robota -c                           # 마지막 세션 이어서 시작
-robota -r <session-id>              # 세션 ID로 세션 재개
-robota --model <모델>               # 모델 지정 (예: claude-sonnet-4-6)
-robota --language <언어>            # 응답 언어 (ko, en, ja, zh)
-robota --permission-mode <모드>     # plan | default | acceptEdits | bypassPermissions
-robota --max-turns <n>              # 인터랙션당 에이전틱 턴 제한
-robota --output-format <형식>       # text | json | stream-json (출력 모드)
-robota --system-prompt <텍스트>     # 시스템 프롬프트 교체 (출력 모드)
-robota --append-system-prompt <텍스트> # 시스템 프롬프트에 추가 (출력 모드)
-robota --reset                      # 사용자 설정 삭제 후 종료
-robota --check-update               # npm에서 최신 CLI 버전 확인 후 종료
-robota --disable-update-check       # 이번 실행에서 시작 시 업데이트 확인 건너뜀
-robota --version                    # 버전 표시
-```
-
-### CLI 업데이트 확인
-
-```bash
-robota --check-update
-```
-
-업데이트가 있으면 npm 전역 설치 명령어를 출력합니다:
-
-```bash
-npm install -g '@robota-sdk/agent-cli@latest'
-```
-
-### 출력 모드 형식
-
-출력 모드(`-p`)는 `--output-format`으로 세 가지 형식을 지원합니다:
-
-| 형식          | 설명                                                             |
-| ------------- | ---------------------------------------------------------------- |
-| `text`        | 표준 출력에 일반 텍스트 응답 (기본값)                            |
-| `json`        | 단일 JSON 객체: `{ type, result, session_id, subtype }`          |
-| `stream-json` | `content_block_delta` 스트리밍 이벤트를 줄바꿈으로 구분한 NDJSON |
-
-### 표준 입력(Stdin) 파이프
-
-`-p`와 위치 인자 없이 stdin이 파이프되면 CLI가 stdin에서 읽습니다:
-
-```bash
-echo "이 오류를 설명해줘" | robota -p
-cat file.ts | robota -p "이 코드를 검토해줘" --output-format json
-git diff | robota -p "변경 사항 요약" --output-format stream-json
-```
-
-## 최초 실행 설정
-
-사용 가능한 설정 파일이 없으면 CLI가 다음을 안내합니다:
-
-1. **프로바이더 선택** — CLI 바이너리에 포함된 프로바이더 중 선택
-2. **프로바이더별 설정** — 모델, base URL, 마스킹된 API 키 등
-3. **응답 언어** (ko/en/ja/zh, 기본값: en)
-
-`~/.robota/settings.json`에 설정이 저장됩니다. `robota --reset`으로 최초 실행 상태로 되돌릴 수 있습니다.
-
-## 내장 도구
-
-AI 에이전트는 8개의 로컬 도구를 호출할 수 있습니다:
-
-| 도구        | 설명                          | 주요 인자  |
-| ----------- | ----------------------------- | ---------- |
-| `Bash`      | 셸 명령 실행                  | `command`  |
-| `Read`      | 줄 번호와 함께 파일 내용 읽기 | `filePath` |
-| `Write`     | 파일에 내용 쓰기              | `filePath` |
-| `Edit`      | 파일의 문자열 교체            | `filePath` |
-| `Glob`      | 패턴으로 파일 검색            | `pattern`  |
-| `Grep`      | 정규식으로 파일 내용 검색     | `pattern`  |
-| `WebFetch`  | URL 내용을 텍스트로 가져오기  | `url`      |
-| `WebSearch` | 인터넷 검색                   | `query`    |
-
-## 권한 시스템
-
-모든 도구 호출은 세 단계 권한 게이트를 통과합니다:
-
-1. **거부 목록** — 거부 패턴이 일치하면 차단
-2. **허용 목록** — 허용 패턴이 일치하면 자동 승인
-3. **모드 정책** — 활성 권한 모드에 따라 결정
-
-### 권한 모드
-
-| 모드                | Read/Glob/Grep | Write/Edit | Bash |
-| ------------------- | :------------: | :--------: | :--: |
-| `plan`              |      자동      |    거부    | 거부 |
-| `default`           |      자동      |    승인    | 승인 |
-| `acceptEdits`       |      자동      |    자동    | 승인 |
-| `bypassPermissions` |      자동      |    자동    | 자동 |
-
-### 런타임 모드 변경
-
-`/permissions` 슬래시 커맨드 사용:
-
-```
-> /permissions                    # 현재 모드 및 세션 승인 도구 표시
-> /permissions plan               # 읽기 전용 모드로 전환
-> /permissions bypassPermissions  # 모든 프롬프트 건너뜀
-```
-
-또는 시작 시 설정:
-
-```bash
-robota --permission-mode plan
-```
-
-### 권한 패턴
-
-`.robota/settings.json` 또는 `.robota/settings.local.json`에 설정:
-
-```json
-{
-  "permissions": {
-    "allow": ["Bash(pnpm *)", "Bash(git status)", "Read(/src/**)"],
-    "deny": ["Bash(rm -rf *)", "Write(.env)"]
-  }
-}
-```
-
-패턴 문법: `ToolName`은 모든 호출에 매칭; `ToolName(pattern)`은 셸 스타일 글로브(`*`, `**`)로 주요 인자에 매칭.
-
-## 키보드 단축키
-
-| 키        | 동작                                       |
-| --------- | ------------------------------------------ |
-| Enter     | 입력 제출                                  |
-| ESC       | 현재 실행 중단 (부분 응답 저장)            |
-| Ctrl+C    | 즉시 프로세스 종료                         |
-| Up/Down   | 여러 줄 입력에서 줄 탐색                   |
-| 화살표 키 | 슬래시 커맨드 자동완성, 권한 프롬프트 탐색 |
-
-## 주요 슬래시 커맨드
-
-| 커맨드                | 설명                                            |
-| --------------------- | ----------------------------------------------- |
-| `/help`               | 사용 가능한 커맨드 표시                         |
-| `/clear`              | 대화 기록 초기화                                |
-| `/model [모델명]`     | AI 모델 변경 (확인 프롬프트, CLI 재시작)        |
-| `/language [언어]`    | 응답 언어 설정 (ko, en, ja, zh), 저장 후 재시작 |
-| `/compact [지시사항]` | 컨텍스트 창 압축                                |
-| `/cost`               | 세션 정보 표시                                  |
-| `/context`            | 컨텍스트 창 상세, 참조 목록, 자동 압축 설정     |
-| `/agent`              | 백그라운드 서브에이전트 작업 실행 및 관리       |
-| `/permissions [모드]` | 권한 규칙 표시 또는 권한 모드 변경              |
-| `/plugin [하위명령]`  | 플러그인 관리                                   |
-| `/resume`             | 최근 세션 목록 표시 및 재개                     |
-| `/rename <이름>`      | 현재 세션 이름 변경                             |
-| `/exit`               | CLI 종료                                        |
-
-## 세션 관리
-
-### CLI 플래그
-
-| 플래그                | 설명                                     |
-| --------------------- | ---------------------------------------- |
-| `-c`, `--continue`    | 가장 최근 세션 이어서 시작               |
-| `-r`, `--resume <id>` | 특정 세션 ID로 재개                      |
-| `--fork-session <id>` | 세션 포크 (복사된 기록으로 새 세션 시작) |
-| `--name <이름>`       | 시작 시 세션에 이름 지정                 |
-
-## 설정
-
-설정은 다음 순서로 병합됩니다 (낮은 우선순위 → 높은 우선순위):
-
-1. `~/.robota/settings.json` (사용자 전역)
-2. `~/.claude/settings.json` (사용자 전역, Claude Code 호환)
-3. `.robota/settings.json` (프로젝트, 공유)
-4. `.robota/settings.local.json` (로컬, gitignore 대상)
-5. `.claude/settings.json` (프로젝트, Claude Code 호환)
-6. `.claude/settings.local.json` (로컬, gitignore 대상, Claude Code 호환)
-
-```json
-{
-  "defaultMode": "default",
-  "language": "ko",
-  "currentProvider": "claude-sonnet-4-6",
-  "providers": {
-    "claude-sonnet-4-6": {
-      "type": "anthropic",
-      "model": "claude-sonnet-4-6",
-      "apiKey": "$ENV:ANTHROPIC_API_KEY"
-    }
-  },
-  "permissions": {
-    "allow": ["Bash(pnpm *)"],
-    "deny": ["Bash(rm -rf *)"]
-  }
-}
-```
-
-## 컨텍스트 자동 탐색
-
-CLI는 다음을 자동으로 탐색하고 로드합니다:
-
-- **AGENTS.md** — cwd에서 파일시스템 루트까지 상위 디렉토리 탐색
-- **CLAUDE.md** — 동일한 상위 탐색
-- **프로젝트 메타데이터** — `package.json`, `tsconfig.json`
-
-모든 컨텍스트가 시스템 프롬프트로 조합됩니다.
-
-## 세션 로깅
-
-세션 로그는 JSONL 형식으로 `.robota/logs/{sessionId}.jsonl`에 기록됩니다. 재개 가능한 세션 JSON은 `.robota/sessions/{sessionId}.json`에 저장됩니다.
-
-## 아키텍처
-
-CLI는 순수 TUI 레이어입니다. 모든 비즈니스 로직은 `@robota-sdk/agent-sdk`의 `InteractiveSession`에 있습니다. `useInteractiveSession`이 유일한 React↔SDK 브릿지입니다.
-
-## 라이선스
-
-MIT