cx-viewer 1.0.2 → 1.0.4

package/concepts/ja/GlobalSettings.md

@@ -1,232 +1,230 @@
-# CC-Viewer 全局配置参考
+# CX-Viewer Configuration Reference
 
-## 一、全局设置面板（UI）
+## 1. Global Settings Panel (UI)
 
-通过左上角菜单 → "全局设置" 打开。
+Open via top-left menu → "Global Settings".
 
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| 过滤无关请求 | 开关 | 开 | 隐藏心跳、count_tokens、子代理等非主代理请求 |
-| 默认展开 Body Diff JSON | 开关 | 关 | 请求详情面板中的 Body Diff 区域默认展开 |
-| 日志目录设置 | 文本输入 | `~/.claude/cc-viewer` | 项目日志的读写根目录，支持 `~/` 展开。修改后回车或失焦保存，立即生效 |
+| Setting | Type | Default | Description |
+|---------|------|---------|-------------|
+| Filter Irrelevant Requests | Switch | On | Hide heartbeat, count_tokens, sub-agent and other non-main-agent requests |
+| Expand Body Diff JSON | Switch | Off | Expand Body Diff section by default in request detail panel |
+| Log Directory | Text Input | `~/.codex/cx-viewer` | Root directory for project log read/write. Supports `~/` expansion. Takes effect immediately on Enter or blur |
 
-## 二、显示设置面板（UI）
+## 2. Display Settings Panel (UI)
 
-通过左上角菜单 → "显示设置" 打开。
+Open via top-left menu → "Display Settings".
 
-| 配置项 | 类型 | 默认值 | 说明 |
-|--------|------|--------|------|
-| 折叠工具结果 | 开关 | 开 | 聊天视图中折叠工具调用结果块 |
-| 展开思考过程 | 开关 | 开 | 默认展开 Claude 的思考/推理过程块 |
-| 完整展示所有内容 | 开关 | 关 | 显示完整的工具调用内容，不截断 |
-| 自动恢复会话 | 开关 + 选项 | 关 | 遇到会话恢复提示时自动选择：`继续` 或 `新建` |
+| Setting | Type | Default | Description |
+|---------|------|---------|-------------|
+| Collapse Tool Results | Switch | On | Collapse tool call result blocks in chat view |
+| Expand Thinking | Switch | On | Expand Codex reasoning/thinking blocks by default |
+| Show Full Tool Content | Switch | Off | Show full untruncated tool call content |
+| Auto Resume Session | Switch + Options | Off | Automatically choose when session resume prompt appears: `Continue` or `New` |
 
-## 三、偏好设置文件
+## 3. Preferences File
 
-所有 UI 设置持久化到 `<日志目录>/preferences.json`，通过 `/api/preferences` 接口读写。
+All UI settings are persisted to `<log_dir>/preferences.json` via the `/api/preferences` API.
 
 ```json
 {
-  "lang": "zh",
+  "lang": "en",
   "filterIrrelevant": true,
   "expandDiff": false,
   "collapseToolResults": true,
   "expandThinking": true,
   "showFullToolContent": false,
-  "logDir": "~/.claude/cc-viewer",
+  "logDir": "~/.codex/cx-viewer",
   "resumeAutoChoice": null,
   "disabledPlugins": [],
   "presetShortcuts": []
 }
 ```
 
-| 字段 | 类型 | 说明 |
-|------|------|------|
-| `lang` | string | 界面语言（zh/en/zh-TW/ko/ja/de/es/fr/it/da/pl/ru/ar/no/pt-BR/th/tr/uk） |
-| `filterIrrelevant` | boolean | 过滤无关请求 |
-| `expandDiff` | boolean | 默认展开 Body Diff JSON |
-| `collapseToolResults` | boolean | 折叠工具结果 |
-| `expandThinking` | boolean | 展开思考过程 |
-| `showFullToolContent` | boolean | 完整展示内容 |
-| `logDir` | string | 日志目录路径 |
-| `resumeAutoChoice` | null / "continue" / "new" | 自动恢复会话选择 |
-| `disabledPlugins` | string[] | 已禁用的插件文件名列表 |
-| `presetShortcuts` | array | Agent Team 快捷指令预设 |
-
-## 四、环境变量
-
-### CC-Viewer 专有
-
-| 变量名 | 默认值 | 说明 |
-|--------|--------|------|
-| `CCV_LOG_DIR` | `~/.claude/cc-viewer` | 日志存储根目录。特殊值：`tmp`/`temp` 使用系统临时目录 |
-| `CCV_CLI_MODE` | 未设置 | `=1` 启用 CLI 模式（PTY 终端） |
-| `CCV_SDK_MODE` | 未设置 | `=1` 启用 Agent SDK 模式（无终端） |
-| `CCV_WORKSPACE_MODE` | 未设置 | `=1` 启用工作空间选择模式 |
-| `CCV_PROJECT_DIR` | `process.cwd()` | 项目工作目录，用于文件操作和 Git 命令 |
-| `CCV_PROXY_PORT` | 未设置 | 本地 MITM 代理端口 |
-| `CCV_BYPASS_PERMISSIONS` | 未设置 | `=1` 跳过工具权限审批（配合 `--dangerously-skip-permissions`） |
-| `CCV_DISABLE_DELTA` | 未设置 | `=1` 禁用增量日志存储，每次写入完整消息 |
-| `CCV_DEBUG` | 未设置 | `=1` 启用 HTTP 代理调试日志 |
-| `CCV_DEBUG_PLUGINS` | 未设置 | `=1` 启用插件加载调试日志 |
-
-### 内部 IPC
-
-| 变量名 | 说明 |
-|--------|------|
-| `CCVIEWER_PORT` | 服务端口，供 ask-bridge/perm-bridge 通信 |
-| `CCV_EDITOR_PORT` | 服务端口，供 ccv-editor 文件编辑桥接 |
-
-### 外部变量（读取）
-
-| 变量名 | 说明 |
-|--------|------|
-| `ANTHROPIC_BASE_URL` | 自定义 Anthropic API 地址 |
-| `SHELL` | 用户 Shell（PTY 启动和 Shell 配置检测） |
-| `http_proxy` / `HTTPS_PROXY` 等 | HTTP 代理配置（通过 undici EnvHttpProxyAgent） |
-
-## 五、CLI 命令参数
+| Field | Type | Description |
+|-------|------|-------------|
+| `lang` | string | UI language (zh/en/zh-TW/ko/ja/de/es/fr/it/da/pl/ru/ar/no/pt-BR/th/tr/uk) |
+| `filterIrrelevant` | boolean | Filter irrelevant requests |
+| `expandDiff` | boolean | Expand Body Diff JSON by default |
+| `collapseToolResults` | boolean | Collapse tool results |
+| `expandThinking` | boolean | Expand thinking blocks |
+| `showFullToolContent` | boolean | Show full content |
+| `logDir` | string | Log directory path |
+| `resumeAutoChoice` | null / "continue" / "new" | Auto resume session choice |
+| `disabledPlugins` | string[] | Disabled plugin filenames |
+| `presetShortcuts` | array | Agent Team preset shortcuts |
+
+## 4. Environment Variables
+
+### CX-Viewer Specific
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `CXV_LOG_DIR` | `~/.codex/cx-viewer` | Log storage root directory. Special values: `tmp`/`temp` use system temp dir |
+| `CXV_CLI_MODE` | unset | `=1` enables CLI mode (PTY terminal) |
+| `CXV_SDK_MODE` | unset | `=1` enables Codex SDK mode (no terminal) |
+| `CXV_WORKSPACE_MODE` | unset | `=1` enables workspace selection mode |
+| `CXV_PROJECT_DIR` | `process.cwd()` | Project working directory for file operations and Git commands |
+| `CXV_PROXY_PORT` | unset | Local Codex proxy port |
+| `CXV_BYPASS_PERMISSIONS` | unset | `=1` skip tool permission approval with Codex bypass mode |
+| `CXV_DISABLE_DELTA` | unset | `=1` disable incremental log storage, write full messages every time |
+| `CXV_DEBUG` | unset | `=1` enable debug logging |
+| `CXV_DEBUG_PLUGINS` | unset | `=1` enable plugin loading debug logging |
+
+### Internal IPC
+
+| Variable | Description |
+|----------|-------------|
+| `CXVIEWER_PORT` | Server port for ask-bridge/perm-bridge communication |
+| `CXV_EDITOR_PORT` | Server port for cxv-editor file editing bridge |
+
+### External (Read-only)
+
+| Variable | Description |
+|----------|-------------|
+| `OPENAI_BASE_URL` | Custom OpenAI-compatible API base URL |
+| `SHELL` | User's shell (PTY spawn and shell config detection) |
+| `http_proxy` / `HTTPS_PROXY` etc. | HTTP proxy config (via undici EnvHttpProxyAgent) |
+
+## 5. CLI Arguments
 
 ```
-ccv [选项] [claude 参数...]
+cxv [options] [codex args...]
 ```
 
-### CC-Viewer 专有选项
+### CX-Viewer Options
 
-| 参数 | 说明 |
-|------|------|
-| `-logger` | 安装/修复 Claude Code hooks |
-| `--uninstall` / `-uninstall` | 卸载所有 CC-Viewer 集成 |
-| `--help` / `-h` / `help` | 显示帮助信息 |
-| `--version` / `-v` | 显示版本号 |
-| `-SDK` / `--sdk` | 使用 Agent SDK 模式 |
-| `--d` | `--dangerously-skip-permissions` 简写 |
-| `--ad` | `--allow-dangerously-skip-permissions` 简写 |
-| `run` | 通过代理运行命令（`ccv run -- claude ...`） |
+| Argument | Description |
+|----------|-------------|
+| `-logger` | Install/repair Codex logger integration |
+| `--uninstall` / `-uninstall` | Remove all CX-Viewer integration |
+| `--help` / `-h` / `help` | Show help text |
+| `--version` / `-v` | Show version |
+| `-SDK` / `--sdk` | Use Agent SDK mode |
+| `--d` | Shortcut for `--dangerously-bypass-approvals-and-sandbox` |
+| `--ad` | Legacy compatibility flag for CXV-side bypass toggles |
+| `run` | Run command through the CXV wrapper (`cxv run -- codex ...`) |
 
-### Claude 透传参数（常用）
+### Codex Pass-through (common)
 
-| 参数 | 说明 |
-|------|------|
-| `-c` / `--continue` | 继续上一次会话 |
-| `-r` / `--resume` | 恢复指定会话 |
-| `-p` / `--print` | 非交互式输出 |
-| `--model` | 指定模型 |
-| `--permission-mode` | 权限模式 |
-| `--system-prompt` | 自定义系统提示词 |
-| `--max-budget-usd` | 最大预算 |
+| Argument | Description |
+|----------|-------------|
+| `continue` | Resume the last session (`codex resume --last`) |
+| `resume [session-id]` | Resume a specific session |
+| `exec [prompt]` | Non-interactive Codex execution |
+| `--model` | Specify model |
+| `--search` | Enable live web search mode |
+| `-C` / `--cd` | Set working directory |
+| `--sandbox` | Set sandbox mode |
+| `--ask-for-approval` | Set approval policy |
 
-## 六、Hook 配置
+## 6. Hook Configuration
 
-CC-Viewer 自动注册到 `~/.claude/settings.json` 的 `hooks.PreToolUse` 中：
+CX-Viewer's Codex integration primarily uses the local wrapper/proxy path. Hook bridges use current Codex tool names only.
 
-### 1. AskUserQuestion 桥接
-- **匹配器**: `"AskUserQuestion"`
-- **命令**: `node <安装目录>/lib/ask-bridge.js`
-- **作用**: 将 Claude 的问题转发到 Web UI，等待用户回答
+### 1. request_user_input Bridge
+- **Matcher**: `"request_user_input"`
+- **Command**: `node <install_dir>/lib/ask-bridge.js`
+- **Purpose**: Forward tool/user approval prompts to the Web UI when a bridge path is active
 
-### 2. 权限审批桥接
-- **匹配器**: `""` (空 = 匹配所有工具)
-- **命令**: `node <安装目录>/lib/perm-bridge.js`
-- **作用**: 仅 `Bash`/`Edit`/`Write`/`NotebookEdit` 需要 Web UI 审批，其余自动放行
+### 2. Permission Approval Bridge
+- **Matcher**: `""` (empty = match all tools)
+- **Command**: `node <install_dir>/lib/perm-bridge.js`
+- **Purpose**: Mutating or external tools such as `shell_command`, `apply_patch`, `web_search`, and `image_generation` require Web UI approval; others pass through
 
-## 七、Shell 集成
+## 7. Shell Integration
 
-CC-Viewer 在 `~/.zshrc`（或 `.bashrc`）中注入 `claude()` 函数：
+CX-Viewer can inject a `codex()` wrapper into `~/.zshrc` (or `.bashrc`) in logger mode:
 
 ```bash
-# >>> CC-Viewer Auto-Inject >>>
-claude() { ... }
-# <<< CC-Viewer Auto-Inject <<<
+# >>> CX-Viewer Auto-Inject >>>
+codex() { ... }
+# <<< CX-Viewer Auto-Inject <<<
 ```
 
-所有 `claude` 命令自动通过 CC-Viewer 代理，实现日志捕获和 Web UI 功能。
+Interactive `codex` commands are routed through CX-Viewer for log capture and Web UI features, while pass-through commands such as `codex --help` and `codex auth` continue to run directly.
 
-卸载：`ccv --uninstall` 或手动删除标记之间的内容。
+Uninstall: `cxv --uninstall` or manually delete content between the markers.
 
-## 八、代理配置（Proxy Profile）
+## 8. Proxy Configuration (Proxy Profile)
 
-存储在 `<日志目录>/profile.json`，通过 UI 的"代理切换"面板管理。
+Stored in `<log_dir>/profile.json`, managed via the "Proxy Switch" panel in the UI.
 
 ```json
 {
   "active": "max",
   "profiles": [
     { "id": "max", "name": "Default" },
-    { "id": "my-proxy", "name": "自定义", "baseURL": "https://...", "apiKey": "sk-..." }
+    { "id": "my-proxy", "name": "Custom", "baseURL": "https://...", "apiKey": "sk-..." }
   ]
 }
 ```
 
-| 字段 | 说明 |
-|------|------|
-| `active` | 当前激活的配置 ID（`"max"` = 直连，无代理） |
-| `id` | 唯一标识 |
-| `name` | 显示名称 |
-| `baseURL` | 代理 API 地址（替换请求 origin） |
-| `apiKey` | 代理 API 密钥（替换认证头） |
-| `models` | 可用模型列表 |
-| `activeModel` | 当前选中的模型 |
+| Field | Description |
+|-------|-------------|
+| `active` | Active profile ID (`"max"` = direct connection, no proxy) |
+| `id` | Unique identifier |
+| `name` | Display name |
+| `baseURL` | Proxy API address (replaces request origin) |
+| `apiKey` | Proxy API key (replaces auth headers) |
+| `models` | Available model list |
+| `activeModel` | Currently selected model |
 
-## 九、插件系统
+## 9. Plugin System
 
-插件目录：`<日志目录>/plugins/`
+Plugin directory: `<log_dir>/plugins/`
 
-### 支持的 Hook 类型
+### Supported Hook Types
 
-| Hook | 类型 | 说明 |
-|------|------|------|
-| `httpsOptions` | 瀑布 | 提供 HTTPS 证书（返回 `{ cert, key }` 或 `{ pfx }`） |
-| `localUrl` | 瀑布 | 修改本地访问 URL |
-| `serverStarted` | 并行 | 服务器启动通知 |
-| `serverStopping` | 并行 | 服务器停止通知 |
-| `onNewEntry` | 并行 | 新日志条目写入通知 |
+| Hook | Type | Description |
+|------|------|-------------|
+| `httpsOptions` | Waterfall | Provide HTTPS certificate (return `{ cert, key }` or `{ pfx }`) |
+| `localUrl` | Waterfall | Modify local access URL |
+| `serverStarted` | Parallel | Server startup notification |
+| `serverStopping` | Parallel | Server shutdown notification |
+| `onNewEntry` | Parallel | New log entry written notification |
 
-插件启用/禁用通过 `preferences.json` 的 `disabledPlugins` 数组管理。
+Plugin enable/disable managed via `disabledPlugins` array in `preferences.json`.
 
-## 十、目录结构
+## 10. Directory Structure
 
 ```
-~/.claude/cc-viewer/               # 日志根目录
-├── preferences.json               # 用户偏好设置
-├── workspaces.json                # 工作空间注册表
-├── profile.json                   # 代理配置
-├── plugins/                       # 插件目录
+~/.codex/cx-viewer/                # Log root directory
+├── preferences.json               # User preferences
+├── workspaces.json                # Workspace registry
+├── profile.json                   # Proxy configuration
+├── plugins/                       # Plugin directory
 │   └── my-plugin.js
-├── <项目名>/                       # 每个项目的日志目录
-│   ├── <项目名>_20260404_123456.jsonl  # JSONL 日志文件
-│   ├── <项目名>.json              # 统计数据（后台生成）
-│   └── images/                    # 上传图片的持久副本
+├── <project>/                     # Per-project log directory
+│   ├── <project>_20260404_123456.jsonl  # JSONL log files
+│   ├── <project>.json             # Stats data (background generated)
+│   └── images/                    # Persistent uploaded image copies
 └── ...
 
-/tmp/cc-viewer-uploads/            # 临时上传文件目录
+/tmp/cx-viewer-uploads/            # Temporary upload file directory
 ```
 
-## 十一、服务器配置
-
-| 配置 | 值 | 说明 |
-|------|-----|------|
-| 端口范围 | 7008-7099 | 自动扫描可用端口 |
-| 绑定地址 | 0.0.0.0 | 所有网络接口 |
-| 访问令牌 | 随机 16 字节 hex | 局域网访问需要 `?token=xxx`，本机免认证 |
-| HTTPS | 仅通过插件 | 需要插件提供 `httpsOptions` hook |
-| CORS | `*` | 允许所有来源 |
-| 上传限制 | 50MB | 单文件最大上传大小 |
-
-## 十二、URL 参数
-
-| 参数 | 说明 |
-|------|------|
-| `?token=xxx` | 局域网访问认证令牌 |
-| `?logfile=path` | 打开指定历史日志文件（只读模式） |
-
-## 十三、localStorage 配置
-
-| 键 | 说明 |
-|-----|------|
-| `cxv_cacheExpireAt` | 缓存倒计时到期时间 |
-| `cxv_cacheType` | 缓存类型标签 |
-| `ccv_sseSlim` | 启用 SSE 增量裁剪（桌面端性能优化） |
-| `ccv_calibrationModel` | KV-Cache 上下文窗口校准模型 |
-| `ccv_fileExplorerOpen` | 文件浏览器面板开关 |
-| `cc-viewer-terminal-width` | 终端面板宽度（像素） |
+## 11. Server Configuration
+
+| Setting | Value | Description |
+|---------|-------|-------------|
+| Port range | 7008-7099 | Auto-scans for available port |
+| Bind address | 0.0.0.0 | All network interfaces |
+| Access token | Random 16-byte hex | LAN access requires `?token=xxx`; localhost is exempt |
+| HTTPS | Plugin only | Requires plugin providing `httpsOptions` hook |
+| CORS | `*` | All origins allowed |
+| Upload limit | 50MB | Maximum single file upload size |
+
+## 12. URL Parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| `?token=xxx` | LAN access authentication token |
+| `?logfile=path` | Open specific historical log file (read-only mode) |
+
+## 13. localStorage Settings
+
+| Key | Description |
+|-----|-------------|
+| `cxv_viewMode` | Current responsive view mode override |
+| `cxv_fileExplorerOpen` | File explorer panel toggle |
+| `cx-viewer-terminal-width` | Terminal panel width (pixels) |

package/concepts/ja/MainAgent.md

@@ -2,7 +2,7 @@
 
 ## 定義
 
-MainAgent は、Claude Code が非 agent team 状態における主幹リクエストチェーンです。ユーザーと Claude Code のやり取りのたびに一連の API リクエストが生成され、その中で MainAgent リクエストがコア会話チェーンを構成します。これらは完全な system prompt、ツール定義、メッセージ履歴を含みます。
+MainAgent は、Codex が非 agent team 状態における主幹リクエストチェーンです。ユーザーと Codex のやり取りのたびに一連の API リクエストが生成され、その中で MainAgent リクエストがコア会話チェーンを構成します。これらは完全な system prompt、ツール定義、メッセージ履歴を含みます。
 
 ## 識別方法
 
@@ -11,13 +11,12 @@ cc-viewer では、MainAgent は `req.mainAgent === true` で識別され、`int
 判定条件（すべて満たす）：
 - リクエストボディに `system` フィールド（system prompt）が含まれる
 - リクエストボディに `tools` 配列（ツール定義）が含まれる
-- system prompt に "Claude Code" の特徴テキストが含まれる
+- system prompt に "Codex" の特徴テキストが含まれる
 
 ## SubAgent との違い
 
 | 特徴 | MainAgent | SubAgent |
 |------|-----------|----------|
-| system prompt | 完全な Claude Code メインプロンプト | 簡潔なタスク専用プロンプト |
+| system prompt | 完全な Codex メインプロンプト | 簡潔なタスク専用プロンプト |
 | tools 配列 | 利用可能なすべてのツールを含む | 通常タスクに必要な少数のツールのみ |
 | メッセージ履歴 | 完全な会話コンテキストを蓄積 | サブタスク関連のメッセージのみ |
-| キャッシュ動作 | prompt caching あり（5分 TTL） | 通常キャッシュなし、またはキャッシュが小さい |

package/concepts/ja/ProxySwitch.md

@@ -2,9 +2,9 @@
 
 ## Overview
 
-Hot-Switch Proxy lets you dynamically redirect API requests to a different endpoint without restarting Claude Code. This is useful when using third-party API proxy services.
+Hot-Switch Proxy lets you dynamically redirect Codex/OpenAI API requests to a different endpoint without restarting the current CX Viewer session. This is useful when using a compatible third-party API proxy service.
 
-> ⚠️ Do not use this feature if you are a Claude Max subscriber.
+> Use only with endpoints and keys you are authorized to use. The active profile replaces request authentication and may route prompts, files, and tool context through the configured service.
 
 ## Fields
 
@@ -26,7 +26,7 @@ When a proxy is active, `interceptor.js` performs the following before each API
 
 ## Config File
 
-Configuration is stored at `~/.claude/cc-viewer/profile.json`. Click the folder icon in the title to open the directory:
+Configuration is stored at `~/.codex/cx-viewer/profile.json`. Click the folder icon in the title to open the directory:
 
 ```json
 {

package/concepts/ja/QRCode.md

@@ -2,7 +2,7 @@
 
 ## 仕組み
 
-CC Viewer はローカルで HTTP サーバーを起動し、**LAN アドレス**（例：`http://192.168.1.100:7008`）を生成します。QR コードをスキャンすると、同じ WiFi ネットワーク経由でスマートフォンから Claude Code を操作できます。
+CC Viewer はローカルで HTTP サーバーを起動し、**LAN アドレス**（例：`http://192.168.1.100:7008`）を生成します。QR コードをスキャンすると、同じ WiFi ネットワーク経由でスマートフォンから Codex を操作できます。
 
 ## 接続できない場合
 

package/concepts/ja/ResponseFields.md

@@ -1,50 +1,38 @@
-# Response Body フィールド説明
+# Response Body Field Reference
 
-Claude API `/v1/messages` レスポンスボディのフィールド説明。
+Field reference for CX-Viewer's normalized Codex response body.
 
-## トップレベルフィールド
+## Top-Level Fields
 
-| フィールド | 型 | 説明 |
-|------|------|------|
-| **model** | string | 実際に使用されたモデル名。例: `claude-opus-4-6` |
-| **id** | string | 今回のレスポンスの一意識別子。例: `msg_01Tgsr2QeH8AVXGoP2wAXRvU` |
-| **type** | string | 固定値 `"message"` |
-| **role** | string | 固定値 `"assistant"` |
-| **content** | array | モデル出力のコンテンツブロック配列。テキスト、ツール呼び出し、思考プロセスなどを含む |
-| **stop_reason** | string | 停止理由: `"end_turn"`（正常終了）、`"tool_use"`（ツール実行が必要）、`"max_tokens"`（トークン上限に到達） |
-| **stop_sequence** | string/null | 停止をトリガーしたシーケンス。通常は `null` |
-| **usage** | object | トークン使用量の統計（詳細は下記参照） |
+| Field | Type | Description |
+|-------|------|-------------|
+| **model** | string | The model name actually used |
+| **id** | string | Unique response or streamed item identifier when available |
+| **type** | string | Always `"message"` |
+| **role** | string | Always `"assistant"` |
+| **content** | array | Array of content blocks output by the model, containing text, tool calls, thinking process, etc. |
+| **stop_reason** | string | Normalized reason/status for stopping, such as `"end_turn"`, `"completed"`, `"failed"`, or `"max_tokens"` |
+| **stop_sequence** | string/null | The sequence that triggered the stop, usually `null` |
+| **usage** | object | Token usage statistics (see below) |
 
-## content ブロックタイプ
+## content Block Types
 
-| タイプ | 説明 |
-|------|------|
-| **text** | モデルのテキスト応答。`text` フィールドを含む |
-| **tool_use** | ツール呼び出しリクエスト。`name`（ツール名）、`input`（パラメータ）、`id`（呼び出し ID、tool_result とのマッチングに使用）を含む |
-| **thinking** | 拡張思考の内容（thinking モードが有効な場合のみ出現）。`thinking` フィールドを含む |
+| Type | Description |
+|------|-------------|
+| **text** | The model's text reply, contains a `text` field |
+| **tool_use** | Tool call request, contains `name` (tool name), `input` (parameters), `id` (call ID, used to match tool_result) |
+| **thinking** | Extended thinking content (only appears when thinking mode is enabled), contains a `thinking` field |
 
-## usage フィールド詳細
+## usage Field Details
 
-| フィールド | 説明 |
-|------|------|
-| **input_tokens** | キャッシュにヒットしなかった入力トークン数（通常料金で課金） |
-| **cache_creation_input_tokens** | 今回新たに作成されたキャッシュのトークン数（キャッシュ書き込み、通常入力より高い料金） |
-| **cache_read_input_tokens** | キャッシュにヒットしたトークン数（キャッシュ読み取り、通常入力より大幅に低い料金） |
-| **output_tokens** | モデル出力のトークン数 |
-| **service_tier** | サービスティア。例: `"standard"` |
-| **inference_geo** | 推論リージョン。例: `"not_available"` はリージョン情報が提供されていないことを示す |
+| Field | Description |
+|-------|-------------|
+| **output_tokens** | Number of tokens output by the model |
+| **reasoning_output_tokens** | Reasoning tokens when the source reports them |
+| **total_tokens** | Total tokens reported by the source |
 
-## cache_creation サブフィールド
+## stop_reason Meanings
 
-| フィールド | 説明 |
-|------|------|
-| **ephemeral_5m_input_tokens** | TTL 5分の短期キャッシュ作成トークン数 |
-| **ephemeral_1h_input_tokens** | TTL 1時間の長期キャッシュ作成トークン数 |
-
-> **キャッシュ課金について**: `cache_read_input_tokens` の単価は `input_tokens` よりはるかに低く、`cache_creation_input_tokens` の単価は通常入力よりやや高くなっています。そのため、継続的な会話で高いキャッシュヒット率を維持することで、費用を大幅に削減できます。cc-viewer の「ヒット率」指標でこの比率を直感的に監視できます。
-
-## stop_reason の意味
-
-- **end_turn**: モデルが正常に応答を完了
-- **tool_use**: モデルがツールの呼び出しを必要としており、content に `tool_use` ブロックが含まれる。次のリクエストでは messages に `tool_result` を追加して会話を継続する必要がある
-- **max_tokens**: `max_tokens` の制限に達して切り詰められたため、応答が不完全な可能性がある
+- **end_turn**: The model completed its reply normally
+- **tool_use**: The model needs to call a tool; CX-Viewer shows the matching tool result when the capture source provides it
+- **max_tokens**: The reply was truncated due to reaching the `max_tokens` limit and may be incomplete

package/concepts/ja/SubAgent-Search.md

@@ -1,20 +1,20 @@
 # SubAgent: Search
 
-## 定義
+## Definition
 
-Search は、コードベースの検索を実行するために Claude Code のメイン agent によって生成されるサブ agent タイプです。Glob、Grep、Read などのツールを使用してファイルやコンテンツの対象を絞った検索を実行し、結果を親 agent に返します。
+Search is a sub-agent type spawned by Codex's main agent to perform codebase searches. It discovers available search and reading capabilities through `tool_search`, then returns the results to the parent agent.
 
-## 動作
+## Behavior
 
-- メイン agent がコードベースを検索または探索する必要があるときに自動的に生成される
-- 読み取り専用アクセス権を持つ隔離されたコンテキストで実行される
-- ファイルパターンマッチングには Glob、コンテンツ検索には Grep、ファイル検査には Read を使用する
-- さらなる処理のために検索結果を親 agent に返す
+- Spawned automatically when the main agent needs to search or explore the codebase
+- Runs in an isolated context with read-only access
+- Uses current Codex/deferred tools for file pattern matching, content search, and file inspection
+- Returns search results to the parent agent for further processing
 
-## 表示されるタイミング
+## When It Appears
 
-Search サブ agent は通常、次のような場合に表示されます:
+Search sub-agents typically appear when:
 
-1. メイン agent が特定のファイル、関数、またはコードパターンを見つける必要があるとき
-2. ユーザーが広範なコードベース探索を要求したとき
-3. agent が依存関係、参照、または使用パターンを調査しているとき
+1. The main agent needs to find specific files, functions, or code patterns
+2. A broad codebase exploration is requested by the user
+3. The agent is investigating dependencies, references, or usage patterns

package/concepts/ja/Teammate.md

@@ -1,26 +1,26 @@
 # Teammate
 
-## 定義
+## Definition
 
-Teammate は Claude Code Agent Team モードにおける協調 agent です。メイン agent が `TeamCreate` でチームを作成し、`Agent` ツールで teammate を生成すると、各 teammate は独立した agent プロセスとして実行され、独自のコンテキストウィンドウとツールセットを持ち、`SendMessage` を通じてチームメンバーと通信します。
+A Teammate is a collaborative agent in Codex Agent Team mode. The main agent discovers the available multi-agent tools through `tool_search`; when those tools are available, each teammate runs as an independent agent process with its own context window and toolset.
 
-## SubAgent との違い
+## Differences from SubAgent
 
-| 特徴 | Teammate | SubAgent |
-|------|----------|----------|
-| ライフサイクル | 持続的に存在し、複数回メッセージを受信可能 | 一回限りのタスク、完了後に破棄 |
-| 通信方式 | SendMessage による双方向メッセージ | 親→子の一方向呼び出し、結果を返す |
-| コンテキスト | 独立した完全なコンテキスト、ターン間で保持 | 隔離されたタスクコンテキスト |
-| 協調モデル | チーム協調、相互通信可能 | 階層構造、親 agent とのみやり取り |
-| タスクタイプ | 複雑なマルチステップタスク | 検索・探索などの単一タスク |
+| Feature | Teammate | SubAgent |
+|---------|----------|----------|
+| Lifecycle | Persistent, can receive multiple messages | One-off task, destroyed upon completion |
+| Communication | Team messaging through the available multi-agent toolset | Parent→child unidirectional call, returns result |
+| Context | Independent full context, retained across turns | Isolated task context |
+| Collaboration | Team collaboration, can communicate with each other | Hierarchical structure, only interacts with parent agent |
+| Task Type | Complex multi-step tasks | Single tasks such as search and exploration |
 
-## 動作
+## Behavior
 
-- メイン agent（team lead）が `Agent` ツールで作成し、`team_name` を割り当てる
-- `TaskList` / `TaskGet` / `TaskUpdate` を通じてタスクリストを共有
-- 各ターンの実行完了後に idle 状態に入り、新しいメッセージで起動を待つ
-- `shutdown_request` により graceful に終了可能
+- Created by the main agent (team lead) through available multi-agent tooling and assigned a team identity
+- Shares task state through the available multi-agent task/status tools
+- Enters idle state after each turn, waiting to be woken by a new message
+- Can be gracefully terminated via `shutdown_request`
 
-## 統計パネルの説明
+## Stats Panel Description
 
-Teammate 統計パネルは各 teammate の API 呼び出し回数を表示します。`Name` 列は teammate 名（例：`reviewer-security`、`reviewer-pipeline`）、`回数` 列はその teammate が発生させた API リクエストの総数です。
+The Teammate stats panel displays the number of API calls for each teammate. The `Name` column shows the teammate's name (e.g., `reviewer-security`, `reviewer-pipeline`), and the `Count` column shows the total number of API requests generated by that teammate.