jetbrains-pi-acp 0.1.1 → 0.1.3

package/README.md

@@ -4,14 +4,14 @@
 
 Connect the [pi coding agent](https://github.com/earendil-works/pi) to JetBrains IDEs through ACP, with session history, permission controls, file diffs, subagents, and background tasks.
 
-Requires **Node.js 22.19.0+** and a JetBrains IDE with ACP support, such as IntelliJ IDEA with the Air plugin (`com.intellij.air`). The npm package includes pi `1.2.0`; no global pi installation or build step is required.
+Requires **Node.js 22.19.0+** and a JetBrains IDE with ACP support, such as IntelliJ IDEA with the Air plugin (`com.intellij.air`). The npm package includes pi `1.3.0`; no global pi installation or build step is required.
 
 ## Quick start
 
 1. Sign in to your model provider from a terminal:
 
    ```bash
-   npx --yes jetbrains-pi-acp@0.1.1 --setup
+   npx --yes jetbrains-pi-acp@0.1.3 --setup
    ```
 
    In pi, run `/login`, complete sign-in, then exit pi and return to the IDE. Credentials are managed by pi.
@@ -23,7 +23,7 @@ Requires **Node.js 22.19.0+** and a JetBrains IDE with ACP support, such as Inte
      "agent_servers": {
        "pi": {
          "command": "npx",
-         "args": ["--yes", "jetbrains-pi-acp@0.1.1"],
+         "args": ["--yes", "jetbrains-pi-acp@0.1.3"],
          "use_idea_mcp": true,
          "use_custom_mcp": true
        }
@@ -40,6 +40,7 @@ The IDE must be able to find `npx`; use its absolute path if needed. Menu locati
 - ACP v1 and v2 draft support, with streaming responses, reasoning, tool status, terminal output, and usage reporting.
 - Native pi session history: list, load, resume, rename, fork, and delete sessions.
 - Model and reasoning-level selection, plus full-access, standard, read-only, and plan modes.
+- UI text (config names, mode and command descriptions, permission options, errors) follows the system language: Chinese for `zh*` locales, English otherwise, based on the first non-empty `LC_ALL`, `LC_MESSAGES`, or `LANG`, falling back to the system locale. Tool descriptions and system prompts sent to the model are always English. Restart the adapter after changing the language.
 - File diffs for built-in `edit`/`write` tools, with optional Air Git patches and per-turn file reports.
 - stdio/HTTP MCP forwarding, including IDE tools; subagents and background shell tasks with targeted cancellation.
 - Steering, terminal stdin, forms, and URL interactions when supported by the client. Air v1 provides `/stdin text` and `/eof` during command execution.
@@ -51,7 +52,7 @@ The IDE must be able to find `npx`; use its absolute path if needed. Menu locati
 Append pi options after `--` in the agent's `args`, for example:
 
 ```json
-["--yes", "jetbrains-pi-acp@0.1.1", "--", "--model", "provider/model-id", "--thinking", "medium"]
+["--yes", "jetbrains-pi-acp@0.1.3", "--", "--model", "provider/model-id", "--thinking", "medium"]
 ```
 
 Use configuration options here, not initial prompts, interactive mode, or session-selection arguments. The adapter manages RPC mode and sessions.

package/README.zh-CN.md

@@ -4,14 +4,14 @@
 
 通过 ACP 将 [pi coding agent](https://github.com/earendil-works/pi) 连接到 JetBrains IDE，支持历史会话、权限控制、文件 diff、子 agent 和后台任务。
 
-需要 **Node.js 22.19.0+** 和支持 ACP 的 JetBrains IDE，例如安装了 Air 插件（`com.intellij.air`）的 IntelliJ IDEA。npm 包自带 pi `1.2.0`，无需全局安装 pi，也无需构建。
+需要 **Node.js 22.19.0+** 和支持 ACP 的 JetBrains IDE，例如安装了 Air 插件（`com.intellij.air`）的 IntelliJ IDEA。npm 包自带 pi `1.3.0`，无需全局安装 pi，也无需构建。
 
 ## 快速开始
 
 1. 在终端中登录模型提供商：
 
    ```bash
-   npx --yes jetbrains-pi-acp@0.1.1 --setup
+   npx --yes jetbrains-pi-acp@0.1.3 --setup
    ```
 
    在 pi 中运行 `/login`，完成登录后退出 pi 并返回 IDE。凭据由 pi 管理。
@@ -23,7 +23,7 @@
      "agent_servers": {
        "pi": {
          "command": "npx",
-         "args": ["--yes", "jetbrains-pi-acp@0.1.1"],
+         "args": ["--yes", "jetbrains-pi-acp@0.1.3"],
          "use_idea_mcp": true,
          "use_custom_mcp": true
        }
@@ -38,8 +38,10 @@ IDE 必须能找到 `npx`，必要时使用其绝对路径。菜单位置随 IDE
 ## 主要功能
 
 - 支持 ACP v1 和 v2 草案，流式展示回答、思考、工具状态、终端输出和用量。
+- 每轮汇总模型请求与自动压缩的输入、输出及缓存读写 token，取消仍保留已发生用量；通过 `usage_update.cost` 发布 pi 记录的会话累计美元费用，恢复历史后继续累计。可用 `/status` 查看累计 token、费用和上下文用量。
 - 使用 pi 原生历史，支持会话列表、加载、恢复、改名、分叉和删除。
 - 支持切换模型与推理级别，以及完全访问、标准访问、只读和规划模式。
+- 界面文案（配置名称、模式说明、命令说明、授权选项、报错等）按系统语言自动切换中英文，给模型看的工具描述和系统提示固定使用英文。语言判断依次读取非空的 `LC_ALL`、`LC_MESSAGES`、`LANG`，未设置时使用系统默认语言；中文使用中文，其余语言使用英文。更改系统语言后需重启适配器。
 - 展示内置 `edit/write` 工具的文件 diff，可协商 Air Git patch 和每轮文件报告。
 - 转发 stdio/HTTP MCP 配置及 IDE 工具；支持子 agent、后台 shell 任务和定向停止。
 - 按客户端能力提供 steering、终端 stdin、表单和 URL 交互。Air v1 可在命令执行期间发送 `/stdin 文本` 和 `/eof`。
@@ -51,7 +53,7 @@ IDE 必须能找到 `npx`，必要时使用其绝对路径。菜单位置随 IDE
 在 Agent 的 `args` 末尾添加 `--`，随后传递 pi 参数，例如：
 
 ```json
-["--yes", "jetbrains-pi-acp@0.1.1", "--", "--model", "provider/model-id", "--thinking", "medium"]
+["--yes", "jetbrains-pi-acp@0.1.3", "--", "--model", "provider/model-id", "--thinking", "medium"]
 ```
 
 这里只传配置选项，不传初始提示、交互模式或会话选择参数。RPC 模式和会话由适配器管理。
@@ -69,6 +71,7 @@ IDE 必须能找到 `npx`，必要时使用其绝对路径。菜单位置随 IDE
 - diff 有大小限制，二进制文件或旧历史可能无法展示。每轮文件报告的单次快照最多扫描 20,000 项或两秒，无法准确区分外部并发修改。
 - 不支持 MCP SSE、音频和二进制内嵌资源，图片支持取决于模型。
 - ACP v2 仍为草案，客户端界面展示、真实提供商账号登录及 Windows 实机仍需验证。
+- 每轮 token 在 v1 提示响应的 `usage`、v2 完成状态的 `usage` 中返回；未上报用量时省略，不单列思考 token 或每轮费用。费用取自 pi 的模型计价数据；上下文用量不可用时不发送 `usage_update`，IDE 展示取决于客户端支持。
 
 ## 开发
 

package/examples/acp.json

@@ -3,7 +3,7 @@
     "pi": {
       "command": "/绝对路径/node",
       "args": [
-        "/绝对路径/jetbrains-acp/src/index.js",
+        "/绝对路径/jetbrains-pi-acp/src/index.js",
         "--pi-command",
         "/绝对路径/pi"
       ],

package/extensions/acp.ts

@@ -7,6 +7,7 @@ import { createBashToolDefinition, createPowerShellToolDefinition, getShellConfi
 import { readJsonl, writeJsonl } from '../src/jsonl.js';
 import { TerminalProcesses } from '../src/terminal-input.js';
 import { fileText, MAX_DIFF_BYTES, toolPath } from '../src/file-diff.js';
+import { t } from '../src/i18n.js';
 
 // 由适配器创建的临时配置，避免覆盖用户或项目的 MCP 设置。
 export default function (pi: any) {
@@ -22,14 +23,14 @@ export default function (pi: any) {
     pendingTasks.set(id, { resolve, reject });
     if (!inputChannel || inputChannel.destroyed) {
       pendingTasks.delete(id);
-      reject(new Error('ACP 任务通道未连接'));
+      reject(new Error(t('taskChannelDisconnected')));
       return;
     }
     writeJsonl(inputChannel, { type: 'acp_task_request', id, action, toolCallId, params });
   });
   const closeChannel = () => {
     shared.terminals.close();
-    for (const pending of pendingTasks.values()) pending.reject(new Error('ACP 任务通道已关闭'));
+    for (const pending of pendingTasks.values()) pending.reject(new Error(t('taskChannelClosed')));
     pendingTasks.clear();
   };
   for (const [event, action] of [
@@ -92,12 +93,12 @@ export default function (pi: any) {
     }
   }
   for (const [name, description, parameters] of [
-    ['spawn_agent', '创建独立上下文的子 agent 并在后台执行；返回 taskId，使用 task_status 查询，stop_task 停止。',
+    ['spawn_agent', 'Start a subagent with its own context in the background. Returns a taskId; query it with task_status and stop it with stop_task.',
       Type.Object({ prompt: Type.String({ minLength: 1 }), name: Type.Optional(Type.String()) })],
-    ['background_shell', '启动后台 shell 命令；返回 taskId，使用 task_status 查询输出，stop_task 停止整个进程组。',
+    ['background_shell', 'Start a background shell command. Returns a taskId; read output with task_status and stop the whole process group with stop_task.',
       Type.Object({ command: Type.String({ minLength: 1 }), timeout: Type.Optional(Type.Number({ minimum: 0.001 })) })],
-    ['task_status', '查询本会话创建的后台命令或子 agent 的状态与最近输出。', Type.Object({ taskId: Type.String() })],
-    ['stop_task', '仅停止指定 taskId 的后台命令或子 agent，不影响其他任务。', Type.Object({ taskId: Type.String() })],
+    ['task_status', 'Get the status and recent output of a background command or subagent created in this session.', Type.Object({ taskId: Type.String() })],
+    ['stop_task', 'Stop only the background command or subagent with the given taskId, leaving other tasks running.', Type.Object({ taskId: Type.String() })],
   ] as const) {
     pi.registerTool({ name, label: name, description, parameters,
       execute: async (id: string, args: any, _signal: AbortSignal, _update: any, ctx: any) => {
@@ -124,40 +125,40 @@ export default function (pi: any) {
     event.systemPromptOptions.sections = {
       ...sections,
       ...(config.customInstructions ? { acp_client_instructions: config.customInstructions } : {}),
-      ...(planMode ? { acp_plan_mode: '只分析问题并制定可执行计划，不修改文件、不执行命令或其他有副作用的工具。' } : {}),
-      ...(goal?.status === 'active' ? { acp_goal: `本会话长期目标：${goal.objective}` } : {}),
+      ...(planMode ? { acp_plan_mode: 'Only analyze the problem and produce an actionable plan. Do not modify files, run commands, or use other tools with side effects.' } : {}),
+      ...(goal?.status === 'active' ? { acp_goal: `Long-term goal for this session: ${goal.objective}` } : {}),
     };
   });
   pi.registerCommand('__acp_mode', {
-    description: '切换 ACP 规划模式',
+    description: 'Toggle ACP plan mode',
     handler: async (args: string) => { planMode = args.trim() === 'plan'; },
   });
   pi.registerCommand('__acp_fork', {
-    description: '在指定历史条目之后分叉 ACP 会话',
+    description: 'Fork the ACP session after a given history entry',
     handler: async (args: string, ctx: any) => {
       await ctx.fork(JSON.parse(args), { position: 'at' });
     },
   });
   pi.registerCommand('__acp_goal', {
-    description: '同步 ACP 长期目标',
+    description: 'Sync the ACP goal',
     handler: async (args: string) => {
       const value = JSON.parse(args);
       if (value !== null && (typeof value?.objective !== 'string' ||
-          !['active', 'paused'].includes(value.status))) throw new Error('ACP goal 无效');
+          !['active', 'paused'].includes(value.status))) throw new Error(t('goalInvalid'));
       pi.appendEntry('acp_goal', value);
       goal = value;
     },
   });
   pi.registerTool({
-    name: 'update_plan', label: '更新计划',
-    description: '用结构化步骤更新当前任务的执行计划和进度。仅记录计划，不执行文件或命令操作。',
+    name: 'update_plan', label: t('updatePlanLabel'),
+    description: 'Update the execution plan and progress of the current task with structured steps. Only records the plan; performs no file or command operations.',
     parameters: Type.Object({ entries: Type.Array(Type.Object({
       content: Type.String({ minLength: 1, maxLength: 10000 }),
       priority: Type.Union([Type.Literal('high'), Type.Literal('medium'), Type.Literal('low')]),
       status: Type.Union([Type.Literal('pending'), Type.Literal('in_progress'), Type.Literal('completed')]),
     }), { maxItems: 100 }) }),
     execute: async (_id: string, input: any) => ({
-      content: [{ type: 'text', text: '计划已更新' }], details: { acpPlan: input.entries },
+      content: [{ type: 'text', text: 'Plan updated' }], details: { acpPlan: input.entries },
     }),
   });
   const messageIds = new Map<string, string>();
@@ -178,7 +179,7 @@ export default function (pi: any) {
     pi.registerMcpServer(name, server);
   }
   pi.registerCommand('__acp_check', {
-    description: '检查 ACP 适配器连接',
+    description: 'Check the ACP adapter connection',
     handler: async (_args: string, ctx: any) => {
       goal = ctx.sessionManager.getBranch().findLast((entry: any) =>
         entry.type === 'custom' && entry.customType === 'acp_goal')?.data ?? null;
@@ -187,11 +188,11 @@ export default function (pi: any) {
     },
   });
   pi.registerCommand('__acp_archive', {
-    description: '同步 ACP 归档状态',
+    description: 'Sync the ACP archive state',
     handler: async (args: string) => { pi.appendEntry('acp_archive', args.trim() === 'true'); },
   });
   pi.registerCommand('__acp_list', {
-    description: '列出 ACP 可恢复的 pi 会话',
+    description: 'List pi sessions that ACP can resume',
     handler: async (args: string, ctx: any) => {
       const directory = config.sessionDir || process.env.PI_CODING_AGENT_SESSION_DIR ||
         SettingsManager.create(ctx.cwd).getSessionDir();
@@ -219,14 +220,14 @@ export default function (pi: any) {
   });
   pi.on('tool_call', async (event: any, ctx: any) => {
     if (['read', 'grep', 'find', 'ls', 'update_plan', 'task_status'].includes(event.toolName)) return;
-    if (planMode) return { block: true, reason: '规划模式不允许此工具调用' };
+    if (planMode) return { block: true, reason: t('planModeBlocked') };
     try {
       const approved = await ctx.ui.confirm('PI_ACP_PERMISSION', JSON.stringify({
         toolCallId: event.toolCallId, toolName: event.toolName, args: event.input,
       }));
-      if (!approved) return { block: true, reason: '用户未授权此工具调用' };
+      if (!approved) return { block: true, reason: t('userDenied') };
     } catch {
-      return { block: true, reason: 'IDEA 授权通道不可用' };
+      return { block: true, reason: t('permissionChannelUnavailable') };
     }
     if (!['edit', 'write'].includes(event.toolName) || typeof event.input?.path !== 'string') return;
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jetbrains-pi-acp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "description": "连接 JetBrains IDE 与 pi coding agent 的 ACP 适配器",
   "bin": {
@@ -31,7 +31,7 @@
     "examples/"
   ],
   "dependencies": {
-    "@earendil-works/pi-coding-agent": "1.2.0",
+    "@earendil-works/pi-coding-agent": "1.3.0",
     "typebox": "1.3.27"
   },
   "license": "MIT"

package/scripts/config.js

@@ -1,6 +1,7 @@
 import { accessSync, constants } from 'node:fs';
 import { delimiter, isAbsolute, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { t } from '../src/i18n.js';
 
 const requested = process.argv[2] || process.env.PI_ACP_PI_COMMAND;
 const candidates = !requested ? [] : isAbsolute(requested) ? [requested]
@@ -9,7 +10,7 @@ const command = candidates.find(path => {
   try { accessSync(path, constants.X_OK); return true; } catch { return false; }
 });
 if (requested && !command) {
-  process.stderr.write('未找到 pi，请传入 pi 可执行文件的绝对路径。\n');
+  process.stderr.write(`${t('piNotFound')}\n`);
   process.exit(1);
 }
 console.log(JSON.stringify({ agent_servers: { pi: {