jetbrains-pi-acp 0.1.2 → 0.1.4

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.2 --setup
+   npx --yes jetbrains-pi-acp@0.1.4 --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.2"],
+         "args": ["--yes", "jetbrains-pi-acp@0.1.4"],
          "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.2", "--", "--model", "provider/model-id", "--thinking", "medium"]
+["--yes", "jetbrains-pi-acp@0.1.4", "--", "--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.
@@ -66,6 +67,7 @@ Restart the agent connection after updating the adapter or changing startup opti
 
 - Tools execute locally through pi; ACP client-side `fs/*` and `terminal/*` execution is not implemented. Save editor buffers before asking the agent to read or change files.
 - Terminal input uses stdin pipes, not a PTY. Full-screen apps and TTY password prompts are unsupported; background tasks have no stdin input.
+- Only commands the model runs with `interactive: true` accept input. Other commands get an empty stdin (`/dev/null`) like native pi, so commands that read stdin by mistake exit instead of hanging.
 - Diffs have size limits and may be unavailable for binary files or older history. File reports scan at most 20,000 entries or two seconds per snapshot and cannot reliably attribute concurrent external changes.
 - MCP SSE, audio, and binary embedded resources are unsupported. Image support depends on the model.
 - ACP v2 follows a draft schema. Client UI behavior, real provider sign-in, and Windows hardware still need verification.

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.2 --setup
+   npx --yes jetbrains-pi-acp@0.1.4 --setup
    ```
 
    在 pi 中运行 `/login`，完成登录后退出 pi 并返回 IDE。凭据由 pi 管理。
@@ -23,7 +23,7 @@
      "agent_servers": {
        "pi": {
          "command": "npx",
-         "args": ["--yes", "jetbrains-pi-acp@0.1.2"],
+         "args": ["--yes", "jetbrains-pi-acp@0.1.4"],
          "use_idea_mcp": true,
          "use_custom_mcp": true
        }
@@ -40,7 +40,8 @@ IDE 必须能找到 `npx`，必要时使用其绝对路径。菜单位置随 IDE
 - 支持 ACP v1 和 v2 草案，流式展示回答、思考、工具状态、终端输出和用量。
 - 每轮汇总模型请求与自动压缩的输入、输出及缓存读写 token，取消仍保留已发生用量；通过 `usage_update.cost` 发布 pi 记录的会话累计美元费用，恢复历史后继续累计。可用 `/status` 查看累计 token、费用和上下文用量。
 - 使用 pi 原生历史，支持会话列表、加载、恢复、改名、分叉和删除。
-- 支持切换模型与推理级别，以及完全访问、标准访问、只读和规划模式。名称和模式说明在启动时按系统语言自动切换中英文：依次读取非空的 `LC_ALL`、`LC_MESSAGES`、`LANG`，未设置时使用系统默认语言；中文使用中文，其余语言使用英文。更改系统语言后需重启适配器。
+- 支持切换模型与推理级别，以及完全访问、标准访问、只读和规划模式。
+- 界面文案（配置名称、模式说明、命令说明、授权选项、报错等）按系统语言自动切换中英文，给模型看的工具描述和系统提示固定使用英文。语言判断依次读取非空的 `LC_ALL`、`LC_MESSAGES`、`LANG`，未设置时使用系统默认语言；中文使用中文，其余语言使用英文。更改系统语言后需重启适配器。
 - 展示内置 `edit/write` 工具的文件 diff，可协商 Air Git patch 和每轮文件报告。
 - 转发 stdio/HTTP MCP 配置及 IDE 工具；支持子 agent、后台 shell 任务和定向停止。
 - 按客户端能力提供 steering、终端 stdin、表单和 URL 交互。Air v1 可在命令执行期间发送 `/stdin 文本` 和 `/eof`。
@@ -52,7 +53,7 @@ IDE 必须能找到 `npx`，必要时使用其绝对路径。菜单位置随 IDE
 在 Agent 的 `args` 末尾添加 `--`，随后传递 pi 参数，例如：
 
 ```json
-["--yes", "jetbrains-pi-acp@0.1.2", "--", "--model", "provider/model-id", "--thinking", "medium"]
+["--yes", "jetbrains-pi-acp@0.1.4", "--", "--model", "provider/model-id", "--thinking", "medium"]
 ```
 
 这里只传配置选项，不传初始提示、交互模式或会话选择参数。RPC 模式和会话由适配器管理。
@@ -67,6 +68,7 @@ IDE 必须能找到 `npx`，必要时使用其绝对路径。菜单位置随 IDE
 
 - 工具由本机 pi 执行，尚未接入客户端 `fs/*` 和 `terminal/*` 执行接口。让 Agent 读取或修改文件前，请保存编辑器内容。
 - 终端输入使用 stdin 管道，不提供 PTY，不支持全屏终端应用和 TTY 密码提示；后台任务不支持 stdin 输入。
+- 只有模型以 `interactive: true` 调用的命令可以接收输入；其他命令与 pi 原生一致，stdin 为空（`/dev/null`），误读 stdin 的命令会直接结束，不会卡住。
 - diff 有大小限制，二进制文件或旧历史可能无法展示。每轮文件报告的单次快照最多扫描 20,000 项或两秒，无法准确区分外部并发修改。
 - 不支持 MCP SSE、音频和二进制内嵌资源，图片支持取决于模型。
 - ACP v2 仍为草案，客户端界面展示、真实提供商账号登录及 Windows 实机仍需验证。

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 [
@@ -78,13 +79,17 @@ export default function (pi: any) {
       const createTool = name === 'bash' ? createBashToolDefinition : createPowerShellToolDefinition;
       const definition = createTool(process.cwd());
       pi.registerTool({ ...definition,
+        parameters: Type.Object({ ...definition.parameters.properties,
+          interactive: Type.Optional(Type.Boolean({ description: 'Set true only when the command must read input typed by the user on stdin. ' +
+            'Default false: stdin is empty (/dev/null) and no input can be sent while it runs.' })) }),
         execute: async (id: string, args: any, signal: AbortSignal, update: any, ctx: any) => {
+          const interactive = args.interactive === true;
           const settings = SettingsManager.create(ctx.cwd);
           const tool = createTool(ctx.cwd, {
             commandPrefix: settings.getShellCommandPrefix(),
             operations: { exec: (command: string, cwd: string, options: any) => terminals.exec(id,
               name === 'bash' ? getShellConfig(settings.getShellPath()) : getPowerShellConfig(),
-              command, cwd, options, () => ctx.ui.notify(`PI_ACP_TERMINAL_READY:${id}`, 'info')) },
+              command, cwd, { ...options, interactive }, () => ctx.ui.notify(`PI_ACP_TERMINAL_READY:${id}`, 'info')) },
           });
           return tool.execute(id, args, signal, update, ctx);
         },
@@ -92,12 +97,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 +129,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 +183,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 +192,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 +224,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.2",
+  "version": "0.1.4",
   "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: {