@epoch-agent/plugin-terminal 2.8.0 → 3.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -10,7 +10,8 @@
10
10
 
11
11
  ⚠️ **第二族 2026-08-20(方案 49 PR-3)起不认 kind 了。** 它们背后是**一张**住在
12
12
  [infra](../../infra) 的作业表(`src/jobs.ts`),里面同时装着 `terminal({ background: true })`
13
- 起的后台命令(`t1`)和 `shell_open` 开的持久会话(`s1`),将来还有后台子 agent。
13
+ 起的后台命令(`t1`)、`shell_open` 开的持久会话(`s1`),以及后台子 agent
14
+ (`a1`,由 core 的 `delegate_task({ background: true })` 登记)。
14
15
  于是模型只学一套「列出来 / 读输出 / 停掉」,而不是每加一类作业就多学一套。
15
16
 
16
17
  - ✅ **做**:起进程、收输出(执行期间同时喂给 `ctx.onOutput`)、到点杀干净(含孙进程)、
@@ -42,14 +43,18 @@
42
43
  | ------------------------- | -------------------- | --------------------------------------- |
43
44
  | `plan` | `read-only` | 哪都不行(`/dev/null` 除外) |
44
45
  | `default` / `acceptEdits` | `workspace-write` | 工作区 + 额外根 + 临时目录 + 工具链缓存 |
45
- | `auto` / `bypass` | `danger-full-access` | 不设限 —— **但危险命令表照旧拦** |
46
+ | `auto` | `danger-full-access` | 不设限 —— **但危险命令表照旧拦** |
46
47
 
47
48
  ⚠️ **`auto` 那一格 2026-10-08 从 `workspace-write` 改成 `danger-full-access`。**
48
49
  不是「越松越好」:那一档的**文件工具早就不看工作区了**(工作区外的读写它都放行),
49
50
  留着沙箱只会让同一档里 `file_write('~/x')` 落得下去、而 `echo > ~/x` 被 OS 挡下
50
- —— 而菜单上那一档写的是「工作区外也一样」。改完之后它和 `bypass` 在**这一轴上**
51
+ —— 而菜单上那一档写的是「工作区外也一样」。改完之后它和当时的 `bypass` 在**这一轴上**
51
52
  相同,差别收窄成审批那一格(`bypass` 连「判不了」的都不问,`auto` 照问)。
52
53
 
54
+ ⚠️ **2026-10-27 那两档合并了**(用户拍的「五档并四档」):`auto` 现在就是
55
+ 「审批轴 = `never`」那一档,也连「判不了」的都不问。所以这张表只剩一行
56
+ `danger-full-access`,而上面那句「差别收窄成审批那一格」描述的是**合并前的现场**。
57
+
53
58
  **外加一个开关**:`sandbox.terminal: false`(2026-08-21,方案 46 §11.3 第一条,见
54
59
  [CONFIGURATION.md](../../../docs/CONFIGURATION.md#关掉-terminal-的-os-沙箱))。
55
60
  它落在 `sandboxPolicyFor()` 算出来的 `SandboxPolicy.enabled` 上,
@@ -57,19 +62,35 @@
57
62
 
58
63
  - 关掉开关**不改 `mode`** —— `default` 档关掉之后报的仍然是
59
64
  `workspace-write` + 「没包上,原因是开关关着」,不是 `danger-full-access`。
60
- 这一行就是「`bypass` 不是这个开关的替代品」的判据:`bypass` 连审批一起放开,
65
+ 这一行就是「最宽那一档不是这个开关的替代品」的判据:它连审批一起放开,
61
66
  这个开关一点审批都不动(方案 46 §2.3「我们不做二维」)
62
67
  - 关着的时候工具输出那一行逐字说清是**配置**关的,和「这个平台没有后端」
63
68
  是两句不同的话 —— 说错那句的代价是用户按着一句可操作的谎去改档位
64
69
  - 用例:[`__tests__/sandbox-switch.test.ts`](__tests__/sandbox-switch.test.ts)(这一层)
65
70
  和 `runtime/__tests__/sandbox-switch-e2e.test.ts`(从 yaml 走到工具输出)
66
71
 
72
+ **第三档:这一次的升权门**(2026-10-27,方案 65 §2.1)。上面那张表是**会话级**的
73
+ 边界;在那之前,一条命令被 `workspace-write` 挡下之后模型能建议的只有「用户自己跑一遍」
74
+ 或「整个会话切到 `auto`」。现在它可以带 `sandbox_permissions` + `justification`
75
+ 请求放开**这一次**:
76
+
77
+ - 判据全在 infra 的 [escalation.ts](../../infra/src/sandbox/escalation.ts)(阶梯 /
78
+ 成对 / 词表),入口在 core 的 `ToolExecutor.resolveEscalation()`(审批),
79
+ 生效在 [sandbox.ts](src/sandbox.ts) 的 `sandboxPolicyFor()`(`mode` 覆盖 +
80
+ `bypass: 'escalated'`)
81
+ - **永远只批这一次**:那条决定不进审批缓存,宿主也画不出「永久允许」
82
+ - ⚠️ **`shell_open` 的粒度是整个会话**(边界在开的那一刻定下),
83
+ `terminal` 的三条路径才是「这一条命令/这个后台任务」
84
+ - 用例:[`__tests__/sandbox-escalation.test.ts`](__tests__/sandbox-escalation.test.ts)
85
+ 和 `core/__tests__/sandbox-escalation.test.ts`(审批那一半)
86
+
67
87
  ⚠️ **三件必须说清楚的事**,不然「terminal 有沙箱了」会被读成「terminal 安全了」:
68
88
 
69
89
  1. **只管写入。** 读取和网络都**不设限** —— 给终端上读白名单会让 `git push`
70
90
  (要读 `~/.ssh`)和 `pnpm install`(要读 `~/.npmrc`)当场废掉。
71
91
  沙箱里的命令还能 `ps` 看见主机上别的进程。
72
- ⚠️ **`auto` / `bypass` 两档连写入都不挡**(上面那张表),这两档下第 1 条不适用。
92
+ ⚠️ **`auto` 那一档连写入都不挡**(上面那张表;合并前 `auto` / `bypass` 两档
93
+ 都是这样),这一档下第 1 条不适用。
73
94
  2. **「三条路径都包上了」不等于「terminal 安全了」。** 安全中心那份「不在沙箱里」的
74
95
  点名清单现在是空的,它只说**没有哪条路径看起来在沙箱里而实际不在** ——
75
96
  第 1 条和第 3 条一个字都没变。那份清单也**不认上面那个开关**(它是一张静态的
@@ -108,16 +129,27 @@ task_list() → 看全部
108
129
 
109
130
  ### 作业控制器是 kind 无关的(方案 49 PR-3,2026-08-20)
110
131
 
111
- 上面那四个工具**不只看得见后台命令**:`task_list` 把后台命令和持久 shell 会话
112
- 一起列出来、**逐行标出是哪一种**(`[命令]` / `[会话]`),`task_output s1` 读得到
113
- 会话的输出,`task_stop s1` 等价于 `shell_close s1`(走的是同一个 `stopJob()`)。
132
+ 上面那四个工具**不只看得见后台命令**:`task_list` 把后台命令、持久 shell 会话
133
+ 和后台子 agent(`a1`,2026-10-26 接的第三类)一起列出来、**逐行标出是哪一种**
134
+ (`[命令]` / `[会话]` / `[子 agent]`),`task_output s1` 读得到会话的输出,
135
+ `task_stop s1` 等价于 `shell_close s1`(走的是同一个 `stopJob()`)。
114
136
 
115
137
  | 这一轮变了什么 | 这一轮**没**变什么 |
116
138
  | ---------------------------- | ------------------------------------------------------- |
117
139
  | 两张作业表合成一张,住 infra | 两族的**语义**分界线(后台不管了 / 持久要接着聊) |
118
140
  | `task_*` 四个不认 kind | `shell_send` 这种只有持久会话才有的动作,照旧在那一族里 |
119
141
  | 环形缓冲 / 溢出落盘只剩一份 | 三条上限的**取值**(后台 8 个 / 会话 4 个)各是各的 |
120
- | 工具名 —— **一个都没改** | `listTasks()` 这个给宿主的口子仍然只报后台命令,见下 |
142
+ | 工具名 —— **一个都没改** | 宿主口子从 2026-08-26 起报全部 kind(见下) |
143
+
144
+ 第三类(**后台子 agent**,2026-10-26)用的是同一套:它由 core 的
145
+ `delegate_task({ background: true })` 登记,`terminates: true`(所以 `task_wait a1`
146
+ 有意义),`task_stop a1` 收的是一个 `AbortController` 而不是进程
147
+ —— 子 agent 不是子进程,退出时那张按 pid 记的表摸不到它。
148
+ 停止回执也按 kind 分口径:子任务被收了,但它已经起过的后台命令归在父会话名下,
149
+ 不会跟着没(判据在 `job-notice.ts` 的 `stoppedNotice`)。
150
+
151
+ ⚠️ **动作口子只排除持久会话**(`actionableJob`):命令和子 agent 都能从
152
+ `task_stop` / `task_wait` 走,会话不行 —— 它有自己的 `shell_close` / 空闲回收。
121
153
 
122
154
  一个例外:`task_wait` 遇到持久会话会**立刻**返回一句「它没有『结束』这个状态」,
123
155
  而不是干等到超时 —— 那是方案 §五「不做 `shell_wait`」的理由说给模型听一遍。
@@ -129,16 +161,16 @@ task_list() → 看全部
129
161
  上,直到那个 `timeoutMs` 走满 —— 看起来就是卡死。
130
162
 
131
163
  **给宿主的两个口子(`listTasks` / `taskOutput`,runtime 转给 server / TUI)
132
- 仍然只报后台命令那一类。** 判据在 `src/background.ts` 的文件头:它们的落点是
133
- `BackgroundTaskInfo` 那个线上形状,而把持久会话塞进去意味着 `command` 那一格
134
- 要填一个工作目录 —— 那是一句假话。宿主界面要不要显示持久会话是一次界面决定。
164
+ 报的是全部 kind**(2026-08-26 起:方案 62 把可见性放宽了,持久会话也要上宿主界面)。
165
+ 可见性和生命周期是两件事:列表 / 读输出不问 kind,而 `task_stop` / `task_wait`
166
+ 照旧不认持久会话(它有自己的动作口子)。
135
167
 
136
168
  六条边界(「谁看得见」那一条是 2026-08-15 新加的,它以前的答案是「所有人」):
137
169
 
138
170
  | 事情 | 取舍 |
139
171
  | --------------- | ---------------------------------------------------------------------------------------------------------------------- |
140
172
  | 活过一轮对话 | **会**(任务表挂在会话上,不是一次工具调用) |
141
- | 谁看得见 | **只有起它的那个会话**(2026-08-15 收窄,见下) |
173
+ | 谁看得见 | **只有起它的那个会话**(2026-08-15 收窄,见下;后台子 agent 记在**派活**的那个会话名下) |
142
174
  | 活过 epoch 进程 | **不会**,且这是刻意的 —— 见下 |
143
175
  | 同时几个 | **每个会话** 8 个,超了拒绝并列出**这个会话**在跑的 |
144
176
  | `epoch -p` 里 | 跑完给一段摘要(`--json` 里是 `backgroundTasks` 字段),随后一并终止。见 [docs/HEADLESS.md](../../../docs/HEADLESS.md) |
@@ -177,6 +209,17 @@ A 会话每轮被告知一批它没起过的命令在跑,而一句 `task_stop
177
209
  完整判据(含进程退出时的清理为什么不受影响)在
178
210
  [src/background.ts](src/background.ts) 的文件头。
179
211
 
212
+ **真删会话会把它们全停掉**(2026-10-29)。在这之前删掉一段会话 = 它那几个
213
+ 后台任务从此**没有任何界面看得见**,而进程一直跑到 epoch 退出 —— Web 的任务
214
+ 面板要先打开那个会话,模型的 `task_stop` 要在那个会话里才有 `sessionId`。
215
+ 现在 `SessionControl.delete` 会调 infra 的 `stopSessionJobs(sessionId)`:逐个
216
+ `stop`、忘掉那一格,然后才去删 `artifacts/<sid>/`(顺序反了的话,那几格溢出过
217
+ 的全文在 POSIX 上会写进一个已经从目录树里消失的 inode,在 Windows 上直接
218
+ 删不掉)。
219
+
220
+ ⚠️ **冷却和真删是两件事,判据是「这段会话还会回来吗」**:冷却要保住那个把手
221
+ (它会回来),真删没必要(连会话都没了)。
222
+
180
223
  ### 为什么后台任务不能活过 epoch
181
224
 
182
225
  因为它们和前台命令一样 **`detached: false`**。理由在
package/dist/index.d.ts CHANGED
@@ -40,17 +40,22 @@ interface SandboxOutcome {
40
40
  /**
41
41
  * 没包上的原因,包上了就是 `null`。
42
42
  *
43
- * 四档是四句不同的话,不能合成一个「没有沙箱」:
43
+ * 六档是六句不同的话,不能合成一个「没有沙箱」:
44
44
  * `config-disabled` 是**用户把 `sandbox.terminal` 关了**(方案 46 §11.3 第一条),
45
45
  * `mode-disabled` 是**用户选了不上沙箱的那两档**(`auto` / `bypass`),
46
46
  * `no-backend` 是**平台限制**(Windows / 没装 bwrap),
47
- * `not-requested` 是**调用方没传 policy**(今天只有用例会这样)。
47
+ * `not-requested` 是**调用方没传 policy**(今天只有用例会这样),
48
+ * `escalated` 是**模型请求了升权、用户单独批了**(方案 65 §2.1)。
48
49
  *
49
50
  * 前两档看着都是「用户自己选的」,但它们是两个正交的轴,分开的理由写在
50
51
  * infra 的 `Confinement.reason` 上:说错那一句的代价是用户按着一句
51
52
  * 可操作的谎去改档位,而改完照样没有沙箱。
53
+ *
54
+ * 最后那一档和 `mode-disabled` 的区别是「这一档本来有边界、这一次没有」,
55
+ * 而 `mode-disabled` 是「这一档本来就承诺不上沙箱」。合成一句话的表现是
56
+ * 用户以为自己切进了 `auto` 档,其实只是模型请求、他批了一次放宽。
52
57
  */
53
- skipped: 'config-disabled' | 'mode-disabled' | 'no-backend' | 'not-requested' | null;
58
+ skipped: 'config-disabled' | 'mode-disabled' | 'no-backend' | 'not-requested' | 'escalated' | null;
54
59
  /**
55
60
  * 非零退出时这次失败属于哪一种(方案 46 §五)。
56
61
  *
@@ -226,8 +231,13 @@ declare function cleanupBackgroundProcesses(table?: ProcessTable): Promise<void>
226
231
  * 烧到进程退出,而没有任何人能报出它们的存在;跟着冷却**杀掉**更糟 ——
227
232
  * 用户开第 9 个标签页,第 1 个会话跑了二十分钟的构建就没了。
228
233
  *
229
- * ⚠️ **真删会话(`DELETE /api/sessions/:id`)那条路今天没有收这一格** ——
230
- * 判据和处置写在 {@link clearAllTasks} 上面。
234
+ * ⚠️ **真删会话(`DELETE /api/sessions/:id`)那条路 2026-10-29 起会收这一格了** ——
235
+ * `SessionControl.delete` 调 infra 的 `stopSessionJobs(sessionId)`(判据在它的
236
+ * JSDoc 上)。在这之前这里写的是「今天没有收」,那份判断的条件已经变了。
237
+ *
238
+ * ⚠️ **冷却(上面那一节)和真删是两件事,别把这条改动读成冷却也会杀进程**:
239
+ * 冷却一个字都没变,作业表照旧不动。判据是「这段会话还会回来」和「这段会话
240
+ * 不会再回来」的差别 —— 前者要保住那个把手,后者连会话都没了。
231
241
  */
232
242
 
233
243
  /** **每个会话**同时最多几个在跑(2026-08-15 从进程级收窄,判据见文件头) */
@@ -278,7 +288,7 @@ interface TaskOutputResult {
278
288
  * 取增量输出。**方案 62 起也认持久会话**(判据见 {@link listTasks})。
279
289
  *
280
290
  * ⚠️ 它跟着两个列表口子一起放宽,而 {@link stopTask} / {@link waitTask} 没有 ——
281
- * 判据在 {@link commandJob} 上那一节:**取输出是「看」,不是「动」**。
291
+ * 判据在 {@link actionableJob} 上那一节:**取输出是「看」,不是「动」**。
282
292
  * 一格在检视面板上列得出来、点开却永远是空的,那是把可见性做了一半。
283
293
  *
284
294
  * `since` 是绝对偏移,语义和实现都在 `infra/jobs.ts` 的 `readJob()`
@@ -312,10 +322,14 @@ declare function waitTask(sessionId: string, id: string, timeoutMs: number, sign
312
322
  * TUI 里 `/resume` 一下,刚才起的那条 `pnpm dev` 从 `/tasks` 里消失,
313
323
  * 而它还在跑 —— 一个停不掉也报不出来的进程,比一条错误归属的记录坏得多。
314
324
  *
315
- * ⚠️ **只搬 `command` 那一类。** 持久会话这一格今天不搬(那个 venv 还算不算
325
+ * ⚠️ **只搬 `command` 和 `agent`。** 持久会话这一格今天不搬(那个 venv 还算不算
316
326
  * 「这段对话的」是一次要单独判的产品决定,记在方案 49 的验收记录里),
317
327
  * 而下沉之后两类住在同一张表里 —— 点名 kind 就是那次刻意不作为的落点,
318
328
  * 不点名的话它会在这一轮被静默改掉。
329
+ *
330
+ * 后台子 agent(2026-10-26)**要搬**,判据和上面那条 `pnpm dev` 逐字同款:
331
+ * 它可以跑好几分钟,`/resume` 一下就从 `task_list` 里消失、也停不掉,
332
+ * 而它比一条命令更贵(每个子任务花的是模型的钱)。
319
333
  */
320
334
  declare function rekeyTasks(from: string, to: string): void;
321
335
  /**
@@ -329,7 +343,7 @@ declare function rekeyTasks(from: string, to: string): void;
329
343
  * (2026-09-10 立这一条时说的是侧栏那行「N 在跑 / M」—— 那一行 2026-09-18 撤了,
330
344
  * 宾语换成了「输出」那一格,而这个口子存在的理由一个字没变。)
331
345
  *
332
- * ## ⚠️ 这一个**不过 {@link isCommandJob} 那道闸**
346
+ * ## ⚠️ 这一个**不过 {@link actionableJob} 那道闸**
333
347
  *
334
348
  * 和上面三个读的口子同一条判据(方案 62 §五:可见性和生命周期是两件事)——
335
349
  * 检视面板列得出持久会话,那么持久会话的增删也得让面板知道。而且这里也**没法**
@@ -349,19 +363,32 @@ declare function observeTasks(listener: JobsListener): () => void;
349
363
  * `killAllTrackedProcesses()` 再这一下(生产路径走的是
350
364
  * `OwnedProcessTable.release()`,不是它)—— 判据见文件头。
351
365
  *
352
- * ⚠️ **给合并的人:`DELETE /api/sessions/:id` 那条路今天不收这一格。**
353
- * 表按会话分了之后,删掉一个会话 = 它那几个后台任务从此**没有任何界面看得见**。
354
- * 该有的处置是删会话时连同它们一起停掉 —— 那是一次真的杀进程,语义上和
355
- * `hub.unregister()` 里「放弃挂起的审批 + 中止在跑的回合」同一档。
366
+ * ⚠️ **`DELETE /api/sessions/:id` 那条路 2026-10-29 起会收这一格**,走的是
367
+ * infra 的 `stopSessionJobs(sessionId)`(`SessionControl.delete` 里那一行)。
368
+ * 在这之前删掉一个会话 = 它那几个后台任务从此**没有任何界面看得见**,而进程
369
+ * 一直跑到 epoch 退出 —— 下面这一段是那份判断的原文,留着当来路:
370
+ *
371
+ * > 该有的处置是删会话时连同它们一起停掉 —— 那是一次真的杀进程,语义上和
372
+ * > `hub.unregister()` 里「放弃挂起的审批 + 中止在跑的回合」同一档。
373
+ * >
374
+ * > 这一轮**没做**,两个理由:入口在 `server/src/api.ts` 的删会话处理里,不在
375
+ * > 这一轮的文件所有权内(.epoch/plans/30 §十二那条规矩);而且「删会话要不要
376
+ * > 杀掉它起的构建」是一次产品决定。要收的话在 infra 那边加一个
377
+ * > `stopSessionJobs(sessionId)`(遍历那一格 `stopJob`),在删会话那条路上调一次
378
+ * > —— **不是** `clearAllJobs` 的会话版:只忘掉记录而不杀进程,正好是上面说的那个洞。
379
+ *
380
+ * 那两个理由各自的下场:
381
+ *
382
+ * - 第一个(文件所有权)**早已不成立** —— 那轮的并行分支早合完了;
383
+ * - 第二个(产品决定)**判错了对象**。「删会话要不要杀掉它起的构建」确实是
384
+ * 一次产品决定;而「删完之后它还在跑,并且从此谁都停不掉它」不是 —— 后者
385
+ * 没有选项,是一条失控。实际落地的是**只收掉那个失控**(停掉全部 + 忘掉
386
+ * 记录),没有做「问用户要不要连构建一起停」那个 UI,那是另一笔。
356
387
  *
357
- * 这一轮**没做**,两个理由:入口在 `server/src/api.ts` 的删会话处理里,不在
358
- * 这一轮的文件所有权内(.epoch/plans/30 §十二那条规矩);而且「删会话要不要
359
- * 杀掉它起的构建」是一次产品决定。要收的话在 infra 那边加一个
360
- * `stopSessionJobs(sessionId)`(遍历那一格 `stopJob`),在删会话那条路上调一次
361
- * —— **不是** `clearAllJobs` 的会话版:只忘掉记录而不杀进程,正好是上面说的那个洞。
388
+ * 上面那段原文里那句「**不是** `clearAllJobs` 的会话版」正是这一笔的判据:
389
+ * 照着写一个只忘记录的会话版,得到的还是那个洞。
362
390
  *
363
- * ⚠️ **2026-08-15 合并时看了,明确不做**(账在
364
- * [30 §13.4](../../../../docs/verify/VERIFY_RECORD-30-web-multi-session.md))。
391
+ * ⚠️ **和冷却无关**:同一份文件头上一节那批「冷却时一个字都不动」一个字没变。
365
392
  */
366
393
  declare function clearAllTasks(): void;
367
394
  /** 一行摘要,宿主展示用 */
@@ -384,7 +411,7 @@ declare function describeTask(info: BackgroundTaskInfo): string;
384
411
  */
385
412
  /** **每个会话**同时最多开几个持久会话 */
386
413
  declare const MAX_SHELLS = 4;
387
- /** 单个会话留多少字节输出(环形,丢头保尾,同 `MAX_TASK_OUTPUT`) */
414
+ /** 单个会话留多少字节输出(环形,丢头保尾)。**真源在 infra 的 `JOB_OUTPUT_LIMIT`** */
388
415
  declare const MAX_SHELL_OUTPUT: number;
389
416
  /** `shell_read` / `shell_send` 单次最多吐多少(同 `MAX_OUTPUT_CHUNK`) */
390
417
  declare const MAX_SHELL_CHUNK: number;
package/dist/index.js CHANGED
@@ -1,11 +1,18 @@
1
1
  // src/index.ts
2
2
  import { isAbsolute as isAbsolute2, resolve as resolve2 } from "path";
3
- import { checkDangerousCommand as checkDangerousCommand2, isInWorkspace as isInWorkspace2 } from "@epoch-agent/infra";
3
+ import {
4
+ checkDangerousCommand as checkDangerousCommand2,
5
+ ESCALATION_TARGETS as ESCALATION_TARGETS2,
6
+ isInWorkspace as isInWorkspace2,
7
+ JUSTIFICATION_PARAM as JUSTIFICATION_PARAM2,
8
+ SANDBOX_PERMISSIONS_PARAM as SANDBOX_PERMISSIONS_PARAM2
9
+ } from "@epoch-agent/infra";
4
10
  // src/background.ts
5
11
  import {
6
12
  artifactsDir,
7
13
  clearAllJobs,
8
14
  getJob,
15
+ JOB_OUTPUT_LIMIT,
9
16
  jobDetail,
10
17
  killTrackedProcess,
11
18
  listJobs,
@@ -25,12 +32,15 @@ import {
25
32
  sandboxModeForLevel
26
33
  } from "@epoch-agent/infra";
27
34
  function sandboxPolicyFor(ctx, workspaceRoot) {
35
+ const mode = ctx.sandboxEscalation ?? sandboxModeForLevel(ctx.permissionLevel);
36
+ const bypass = ctx.sandboxEscalation === "danger-full-access" ? "escalated" : void 0;
28
37
  return {
29
- mode: sandboxModeForLevel(ctx.permissionLevel),
38
+ mode,
30
39
  workspaceRoot,
31
40
  ...ctx.extraRoots ? { extraRoots: ctx.extraRoots } : {},
32
41
  allowNetwork: true,
33
- enabled: ctx.sandboxTerminal !== false
42
+ enabled: ctx.sandboxTerminal !== false,
43
+ ...bypass ? { bypass } : {}
34
44
  };
35
45
  }
36
46
  function unconfined(skipped) {
@@ -79,7 +89,7 @@ function confineShell(sh, policy, cwd) {
79
89
  }
80
90
  // src/background.ts
81
91
  var MAX_TASKS = 8;
82
- var MAX_TASK_OUTPUT = 256 * 1024;
92
+ var MAX_TASK_OUTPUT = JOB_OUTPUT_LIMIT;
83
93
  var MAX_OUTPUT_CHUNK = 8 * 1024;
84
94
  function startTask(sessionId, command, cwd, homeDir, sandbox) {
85
95
  const running = listJobs(sessionId, "command").filter((j) => j.status === "running");
@@ -132,9 +142,9 @@ function taskSandbox(sessionId, id) {
132
142
  function listTasks(sessionId) {
133
143
  return listJobs(sessionId).map(toInfo);
134
144
  }
135
- function commandJob(sessionId, id) {
145
+ function actionableJob(sessionId, id) {
136
146
  const info = getJob(sessionId, id);
137
- return info?.kind === "command" ? info : void 0;
147
+ return info && info.kind !== "shell" ? info : void 0;
138
148
  }
139
149
  function taskOutput(sessionId, id, since = 0) {
140
150
  if (!getJob(sessionId, id)) return void 0;
@@ -143,17 +153,17 @@ function taskOutput(sessionId, id, since = 0) {
143
153
  return { ...read, info: toInfo(read.info) };
144
154
  }
145
155
  function stopTask(sessionId, id) {
146
- if (!commandJob(sessionId, id)) return Promise.resolve(false);
156
+ if (!actionableJob(sessionId, id)) return Promise.resolve(false);
147
157
  return stopJob(sessionId, id);
148
158
  }
149
159
  async function waitTask(sessionId, id, timeoutMs, signal) {
150
- if (!commandJob(sessionId, id)) return void 0;
160
+ if (!actionableJob(sessionId, id)) return void 0;
151
161
  const result = await waitJob(sessionId, id, timeoutMs, signal);
152
162
  if (!result) return void 0;
153
163
  return { info: toInfo(result.info), timedOut: result.timedOut, aborted: result.aborted };
154
164
  }
155
165
  function rekeyTasks(from, to) {
156
- rekeyJobs(from, to, ["command"]);
166
+ rekeyJobs(from, to, ["command", "agent"]);
157
167
  }
158
168
  function observeTasks(listener) {
159
169
  return subscribeJobs(listener);
@@ -183,9 +193,10 @@ function taskStatus(info) {
183
193
  }
184
194
  function describeTask(info) {
185
195
  const dur = Math.round(((info.endedAt ?? Date.now()) - info.startedAt) / 1e3);
186
- const state = info.status === "running" ? `\u8FD0\u884C\u4E2D ${dur}s` : info.status === "exited" ? `\u5DF2\u7ED3\u675F\uFF0C\u9000\u51FA\u7801 ${info.exitCode}` : info.status === "killed" ? "\u5DF2\u505C\u6B62" : "\u542F\u52A8\u5931\u8D25";
196
+ const agent = info.kind === "agent";
197
+ const state = info.status === "running" ? `\u8FD0\u884C\u4E2D ${dur}s` : info.status === "exited" ? agent ? "\u5DF2\u7ED3\u675F" : `\u5DF2\u7ED3\u675F\uFF0C\u9000\u51FA\u7801 ${info.exitCode}` : info.status === "killed" ? "\u5DF2\u505C\u6B62" : agent ? "\u5931\u8D25" : "\u542F\u52A8\u5931\u8D25";
187
198
  const trunc = info.truncated ? "\uFF0C\u5F00\u5934\u5DF2\u6EDA\u51FA\u7F13\u51B2" : "";
188
- return `${info.id} ${state}\uFF08${info.outputBytes} \u5B57\u8282\u8F93\u51FA${trunc}\uFF09 ${info.command}`;
199
+ return `${info.id} ${state}\uFF08${info.outputBytes} \u5B57\u8282\u8F93\u51FA${trunc}\uFF09 ${info.command ?? info.label}`;
189
200
  }
190
201
  // src/exec.ts
191
202
  import { spawn } from "child_process";
@@ -481,6 +492,9 @@ function sandboxNotice(sb) {
481
492
  if (sb.skipped === "no-backend") {
482
493
  return `[\u6C99\u7BB1: \u65E0] \u672C\u6B21\u6CA1\u6709 OS \u7EA7\u9694\u79BB\u2014\u2014\u8FD9\u4E2A\u5E73\u53F0\uFF08${sb.backend === "none" ? process.platform : sb.backend}\uFF09\u4E0A\u63A2\u6D4B\u4E0D\u5230\u53EF\u7528\u540E\u7AEF\uFF0C\u547D\u4EE4\u80FD\u8BFB\u5199\u6574\u4E2A\u6587\u4EF6\u7CFB\u7EDF\u3002`;
483
494
  }
495
+ if (sb.skipped === "escalated") {
496
+ return "[\u6C99\u7BB1: \u5173] \u8FD9\u4E00\u6B21\u662F\u6A21\u578B\u8BF7\u6C42\u653E\u5F00\u8FB9\u754C\u3001\u7528\u6237\u5355\u72EC\u6279\u51C6\u4E4B\u540E\u6267\u884C\u7684\uFF0C\u6CA1\u6709 OS \u7EA7\u9694\u79BB\u3002\u53EA\u5BF9\u8FD9\u4E00\u6B21\u8C03\u7528\u751F\u6548\uFF0C\u4E0B\u4E00\u4E2A\u5DE5\u5177\u8C03\u7528\u91CD\u65B0\u6309\u6863\u4F4D\u5305\u3002\u5371\u9669\u547D\u4EE4\u8868\u4ECD\u7136\u5728\u5C97\u3002";
497
+ }
484
498
  const boundary = MODE_BOUNDARY[sb.mode ?? ""] ?? "";
485
499
  if (sb.enforcement === "partial") {
486
500
  return `[\u6C99\u7BB1: ${sb.backend} \xB7 ${sb.mode} \xB7 \u5F3A\u5236\u4E0D\u5B8C\u6574] ${boundary}\u3002\u4E0D\u5B8C\u6574\u4E4B\u5904\uFF1APOSIX shell \u5FC5\u987B\u7559\u7740 /dev/null \u8FD9\u4E2A\u5199\u5165\u53E3\uFF0C\u5426\u5219\u5B83\u81EA\u5DF1\u90FD\u8D77\u4E0D\u6765\u3002`;
@@ -493,23 +507,31 @@ function sandboxError(sb) {
493
507
  if (failure2.kind === "runner-failed") {
494
508
  return {
495
509
  message: `\u6C99\u7BB1\u542F\u52A8\u5931\u8D25\uFF0C\u547D\u4EE4\u6CA1\u6709\u6267\u884C\uFF1A${failure2.evidence ?? "(\u6C99\u7BB1\u672A\u7ED9\u51FA\u539F\u56E0)"}`,
496
- suggestion: "\u8FD9\u4E0D\u662F\u547D\u4EE4\u672C\u8EAB\u7684\u95EE\u9898\uFF0C\u522B\u6539\u547D\u4EE4\u3002\u628A\u8FD9\u6761\u539F\u6587\u62A5\u7ED9\u7528\u6237 \u2014\u2014 \u8981\u7ED5\u5F00\u7684\u8BDD\uFF0C\u8BA9\u4ED6\u5728 config.yaml \u91CC\u5199 sandbox.terminal: false\uFF08\u53EA\u5173\u6C99\u7BB1\uFF0C\u5BA1\u6279\u4E0D\u52A8\uFF09\uFF0C\u522B\u529D\u4ED6\u5207\u300C\u5141\u8BB8\u4E00\u5207\u300D\u6863\u4F4D\u3002"
510
+ suggestion: "\u8FD9\u4E0D\u662F\u547D\u4EE4\u672C\u8EAB\u7684\u95EE\u9898\uFF0C\u522B\u6539\u547D\u4EE4\uFF0C\u4E5F\u522B\u529D\u4ED6\u5207\u300C\u5141\u8BB8\u4E00\u5207\u300D\u6863\u4F4D\uFF08\u90A3\u8FDE\u5BA1\u6279\u4E00\u8D77\u653E\u5F00\uFF09\u3002\u6700\u8F7B\u7684\u51FA\u8DEF\u662F\u8BF7\u7528\u6237\u5728\u4ED6\u81EA\u5DF1\u7684\u7EC8\u7AEF\u91CC\u8DD1\u8FD9\u4E00\u904D\u3001\u628A\u7ED3\u679C\u8D34\u56DE\u6765\u3002\u8981\u5F7B\u5E95\u7ED5\u5F00\uFF0C\u53EA\u6709 `epoch config set sandbox.terminal false`\uFF08\u5373 config.yaml \u91CC\u7684 `sandbox.terminal: false`\uFF09\u2014\u2014 \u5168\u5C40\u5F00\u5173\uFF08\u53EA\u5173\u6C99\u7BB1\u3001\u5BA1\u6279\u4E0D\u52A8\uFF09\uFF0C\u6539\u5B8C\u8981\u91CD\u542F epoch \u624D\u751F\u6548\uFF0C\u65B0\u5F00\u4F1A\u8BDD\u4E0D\u591F\u3002"
497
511
  };
498
512
  }
499
513
  if (failure2.kind === "sandbox-denied") {
500
514
  return {
501
515
  message: `\u547D\u4EE4\u88AB\u6C99\u7BB1\u6321\u4E0B\uFF1A${failure2.evidence ?? "(\u6C99\u7BB1\u672A\u7ED9\u51FA\u539F\u56E0)"}`,
502
- suggestion: sb.mode === "read-only" ? "\u5F53\u524D\u662F\u53EA\u8BFB\u6863\u4F4D\uFF0C\u4EFB\u4F55\u5199\u5165\u90FD\u4F1A\u88AB\u6321\u3002\u8981\u771F\u7684\u6539\u4E1C\u897F\uFF0C\u5148\u8BF7\u7528\u6237\u5207\u6362\u6743\u9650\u6863\u4F4D\u3002" : "\u6C99\u7BB1\u53EA\u653E\u5F00\u5DE5\u4F5C\u533A\u3001\u4E34\u65F6\u76EE\u5F55\u548C\u5DE5\u5177\u94FE\u7F13\u5B58\u3002\u8981\u5199\u5230\u522B\u5904\uFF0C\u5148\u8BF7\u7528\u6237\u786E\u8BA4\uFF1B\u5982\u679C\u88AB\u6321\u7684\u662F\u4E00\u6761\u672C\u6765\u8BE5\u80FD\u8DD1\u7684\u547D\u4EE4\uFF08\u6BD4\u5982\u67D0\u4E2A\u6CA1\u767B\u8BB0\u7684\u5DE5\u5177\u94FE\u7F13\u5B58\u76EE\u5F55\uFF09\uFF0C\u4ED6\u53EF\u4EE5\u5728 config.yaml \u91CC\u5199 sandbox.terminal: false \u6574\u4E2A\u5173\u6389\u3002"
516
+ suggestion: sb.mode === "read-only" ? "\u5F53\u524D\u662F plan \u6863\uFF08\u53EA\u8BFB\uFF09\uFF0C\u4EFB\u4F55\u5199\u5165\u90FD\u4F1A\u88AB\u6321 \u2014\u2014 \u8FD9\u662F plan \u6A21\u5F0F\u7684\u627F\u8BFA\uFF0C\u4E0D\u662F\u914D\u7F6E\u51FA\u4E86\u95EE\u9898\u3002\u540C\u4E00\u6761\u8FB9\u754C\u4E0B\u6362\u4E2A\u5199\u6CD5\u8FD8\u662F\u4F1A\u88AB\u6321\uFF0C\u522B\u53CD\u590D\u8BD5\u3002\u8981\u771F\u7684\u6539\u4E1C\u897F\uFF0C\u8BF7\u7528\u6237\u5207\u51FA plan \u6863\uFF08\u5207\u5B8C\u7ACB\u523B\u751F\u6548\u3001\u53EF\u9006\uFF09\uFF1B\u4ED6\u4E0D\u5728\u65C1\u8FB9\u65F6\uFF0C\u4E5F\u53EF\u4EE5\u8BF7\u4ED6\u81EA\u5DF1\u628A\u8FD9\u6761\u547D\u4EE4\u8DD1\u4E00\u904D\u3002" : '\u6C99\u7BB1\u53EA\u653E\u5F00\u5DE5\u4F5C\u533A\u3001\u4E34\u65F6\u76EE\u5F55\u548C\u5DE5\u5177\u94FE\u7F13\u5B58 \u2014\u2014 \u540C\u4E00\u6761\u8FB9\u754C\u4E0B\u6362\u4E2A\u5199\u6CD5\u8FD8\u662F\u4F1A\u88AB\u6321\uFF0C\u522B\u53CD\u590D\u8BD5\u3002\u6309\u4EE3\u4EF7\u4ECE\u8F7B\u5230\u91CD\u6311\u4E00\u6761\u8BF7\u7528\u6237\u529E\uFF1A\u2460 \u5982\u679C\u4F60\u786E\u8BA4\u8FD9\u4E00\u6B21\u5FC5\u987B\u8D8A\u754C\uFF0C\u5E26\u4E0A `sandbox_permissions: "danger-full-access"` \u548C `justification`\uFF08\u4E00\u53E5\u8BDD\u8BF4\u660E\u4E3A\u4EC0\u4E48\u5FC5\u987B\u8D8A\u754C\uFF09**\u518D\u8C03\u4E00\u6B21** \u2014\u2014 \u7528\u6237\u4F1A\u5355\u72EC\u6536\u5230\u4E00\u6B21\u5347\u6743\u5BA1\u6279\uFF0C\u6279\u4E86\u5C31\u53EA\u6709\u8FD9\u4E00\u6B21\u4E0D\u5305\u6C99\u7BB1\uFF0C\u4E0B\u4E00\u6761\u547D\u4EE4\u7167\u65E7\uFF1B\u2461 \u4ED6\u5728\u81EA\u5DF1\u7684\u7EC8\u7AEF\u91CC\u8DD1\u8FD9\u4E00\u904D\u3001\u628A\u7ED3\u679C\u8D34\u56DE\u6765\uFF08\u96F6\u964D\u7EA7\uFF09\uFF1B\u2462 \u628A\u8981\u5199\u7684\u76EE\u6807\u632A\u8FDB\u5DE5\u4F5C\u533A\uFF1B\u2463 \u786E\u5B9E\u9700\u8981\u6574\u4E2A\u4F1A\u8BDD\u653E\u5F00\u8FB9\u754C\uFF0C\u624D\u8BF7\u4ED6\u5207\u5230 auto \u6863\uFF08\u90A3\u4E00\u6863\u6CA1\u6709 OS \u6C99\u7BB1\uFF0C\u53EA\u5269\u5371\u9669\u547D\u4EE4\u8868\uFF1B\u53EF\u9006\u3001\u7ACB\u523B\u751F\u6548\uFF09\uFF1B\u2464 \u53EA\u6709\u5F53\u88AB\u6321\u7684\u662F\u4E00\u6761\u672C\u6765\u8BE5\u80FD\u8DD1\u7684\u547D\u4EE4\uFF08\u6BD4\u5982\u67D0\u4E2A\u6CA1\u767B\u8BB0\u7684\u7F13\u5B58\u76EE\u5F55\uFF09\uFF0C\u624D\u52A8 `epoch config set sandbox.terminal false`\uFF08\u5373 config.yaml \u91CC\u7684 `sandbox.terminal: false`\uFF09\u2014\u2014 \u5168\u5C40\u5F00\u5173\uFF0C\u6539\u5B8C\u8981\u91CD\u542F epoch \u624D\u751F\u6548\uFF08\u65B0\u5F00\u4F1A\u8BDD\u4E0D\u591F\uFF09\uFF0C\u6539\u56DE\u53BB\u4E5F\u8981\u518D\u91CD\u542F\u4E00\u6B21\u3002'
503
517
  };
504
518
  }
505
519
  return null;
506
520
  }
507
521
  // src/shell/tools.ts
508
522
  import { isAbsolute, resolve } from "path";
509
- import { checkDangerousCommand, isInWorkspace, t } from "@epoch-agent/infra";
523
+ import {
524
+ checkDangerousCommand,
525
+ ESCALATION_TARGETS,
526
+ isInWorkspace,
527
+ JUSTIFICATION_PARAM,
528
+ SANDBOX_PERMISSIONS_PARAM,
529
+ t
530
+ } from "@epoch-agent/infra";
510
531
  // src/shell/limits.ts
532
+ import { JOB_OUTPUT_LIMIT as JOB_OUTPUT_LIMIT2 } from "@epoch-agent/infra";
511
533
  var MAX_SHELLS = 4;
512
- var MAX_SHELL_OUTPUT = 256 * 1024;
534
+ var MAX_SHELL_OUTPUT = JOB_OUTPUT_LIMIT2;
513
535
  var MAX_SHELL_CHUNK = 8 * 1024;
514
536
  var SHELL_IDLE_MS = 10 * 60 * 1e3;
515
537
  var SHELL_SWEEP_MS = 60 * 1e3;
@@ -861,6 +883,15 @@ var shellOpen = {
861
883
  workdir: {
862
884
  type: "string",
863
885
  description: "\u4F1A\u8BDD\u7684\u521D\u59CB\u5DE5\u4F5C\u76EE\u5F55\uFF08\u5FC5\u987B\u5728\u5DE5\u4F5C\u533A\u5185\uFF0C\u76F8\u5BF9\u8DEF\u5F84\u6309\u5DE5\u4F5C\u533A\u6839\u89E3\u6790\uFF09"
886
+ },
887
+ [SANDBOX_PERMISSIONS_PARAM]: {
888
+ type: "string",
889
+ enum: [...ESCALATION_TARGETS],
890
+ description: "\u4EC5\u5F53\u4E0A\u4E00\u8F6E\u4F1A\u8BDD\u88AB\u6C99\u7BB1\u6321\u4E0B\u3001\u4E14\u786E\u8BA4\u6574\u4E2A\u4F1A\u8BDD\u90FD\u9700\u8981\u8D8A\u754C\u65F6\u624D\u7528\uFF1A\u8BF7\u6C42\u653E\u5F00**\u8FD9\u4E2A\u4F1A\u8BDD**\u7684\u6C99\u7BB1\u8FB9\u754C\u3002\u26A0\uFE0F \u548C terminal \u7684\u4E0D\u540C\uFF1A\u5B83\u7BA1\u7684\u662F\u6574\u4E2A\u4F1A\u8BDD\uFF08\u4E4B\u540E\u6240\u6709 shell_send\uFF09\uFF0C\u4E0D\u662F\u4E00\u4E2A\u547D\u4EE4\u3002\u53D6\u503C\u53EA\u80FD\u662F\u5F53\u524D\u6863\u4F4D\u4E25\u683C\u66F4\u5BBD\u7684\u90A3\u4E00\u9879\uFF0C\u4E14\u5FC5\u987B\u548C justification \u6210\u5BF9\u51FA\u73B0\u3002\u7528\u6237\u4F1A\u5355\u72EC\u770B\u5230\u4E00\u6B21\u5347\u6743\u5BA1\u6279\u3002"
891
+ },
892
+ [JUSTIFICATION_PARAM]: {
893
+ type: "string",
894
+ description: "\u4E00\u53E5\u8BDD\u8BF4\u660E\u4E3A\u4EC0\u4E48\u6574\u4E2A\u4F1A\u8BDD\u90FD\u5FC5\u987B\u8D8A\u754C\uFF0C\u7ED9\u7528\u6237\u770B\u3002\u53EA\u5728\u540C\u65F6\u4F20\u4E86 sandbox_permissions \u65F6\u6709\u610F\u4E49\uFF0C\u5355\u72EC\u7ED9\u4F1A\u88AB\u62D2\u3002"
864
895
  }
865
896
  },
866
897
  required: []
@@ -1027,12 +1058,13 @@ var KIND_MARK = {
1027
1058
  shell: "\u4F1A\u8BDD",
1028
1059
  agent: "\u5B50 agent"
1029
1060
  };
1030
- function stateOf2(status, exitCode, seconds) {
1061
+ function stateOf2(status, exitCode, seconds, kind) {
1062
+ const agent = kind === "agent";
1031
1063
  switch (status) {
1032
1064
  case "running":
1033
1065
  return `\u8FD0\u884C\u4E2D ${seconds}s`;
1034
1066
  case "exited":
1035
- return `\u5DF2\u7ED3\u675F\uFF0C\u9000\u51FA\u7801 ${exitCode}`;
1067
+ return agent ? "\u5DF2\u7ED3\u675F" : `\u5DF2\u7ED3\u675F\uFF0C\u9000\u51FA\u7801 ${exitCode}`;
1036
1068
  case "killed":
1037
1069
  return "\u5DF2\u505C\u6B62";
1038
1070
  case "closed":
@@ -1040,17 +1072,17 @@ function stateOf2(status, exitCode, seconds) {
1040
1072
  case "reaped":
1041
1073
  return "\u7A7A\u95F2\u5DF2\u88AB\u56DE\u6536";
1042
1074
  case "failed":
1043
- return "\u542F\u52A8\u5931\u8D25";
1075
+ return agent ? "\u5931\u8D25" : "\u542F\u52A8\u5931\u8D25";
1044
1076
  }
1045
1077
  }
1046
1078
  function describeJob(info) {
1047
1079
  const dur = Math.round(((info.endedAt ?? Date.now()) - info.startedAt) / 1e3);
1048
1080
  const trunc = info.truncated ? "\uFF0C\u5F00\u5934\u5DF2\u6EDA\u51FA\u7F13\u51B2" : "";
1049
- return `${info.id} [${KIND_MARK[info.kind]}] ${stateOf2(info.status, info.exitCode, dur)}\uFF08${info.outputBytes} \u5B57\u8282\u8F93\u51FA${trunc}\uFF09 ${info.label}`;
1081
+ return `${info.id} [${KIND_MARK[info.kind]}] ${stateOf2(info.status, info.exitCode, dur, info.kind)}\uFF08${info.outputBytes} \u5B57\u8282\u8F93\u51FA${trunc}\uFF09 ${info.label}`;
1050
1082
  }
1051
- var NO_JOBS = "\u6CA1\u6709\u540E\u53F0\u4F5C\u4E1A\u3002\u7528 terminal \u7684 background: true \u8D77\u4E00\u6761\u540E\u53F0\u547D\u4EE4\uFF0C\u6216\u8005 shell_open \u5F00\u4E00\u4E2A\u6301\u4E45 shell \u4F1A\u8BDD\u3002";
1083
+ var NO_JOBS = "\u6CA1\u6709\u540E\u53F0\u4F5C\u4E1A\u3002\u7528 terminal \u7684 background: true \u8D77\u4E00\u6761\u540E\u53F0\u547D\u4EE4\uFF0Cshell_open \u5F00\u4E00\u4E2A\u6301\u4E45 shell \u4F1A\u8BDD\uFF0C\u6216\u8005 delegate_task({ background: true }) \u6D3E\u4E00\u6279\u5B50\u4EFB\u52A1\u3002";
1052
1084
  function listHead2(count) {
1053
- return `${count} \u4E2A\u540E\u53F0\u4F5C\u4E1A\uFF08\u540E\u53F0\u547D\u4EE4 + \u6301\u4E45 shell \u4F1A\u8BDD\uFF0C\u4E00\u8D77\u5217\uFF09`;
1085
+ return `${count} \u4E2A\u540E\u53F0\u4F5C\u4E1A\uFF08\u540E\u53F0\u547D\u4EE4 + \u6301\u4E45 shell \u4F1A\u8BDD + \u540E\u53F0\u5B50 agent\uFF0C\u4E00\u8D77\u5217\uFF09`;
1054
1086
  }
1055
1087
  function notFoundNotice(id) {
1056
1088
  return `\u6CA1\u6709\u7F16\u53F7\u4E3A ${id} \u7684\u540E\u53F0\u4F5C\u4E1A`;
@@ -1072,7 +1104,13 @@ ${id} \u662F\u4E00\u4E2A\u6301\u4E45 shell \u4F1A\u8BDD\uFF0C\u5B83\u6CA1\u6709\
1072
1104
  \u8981\u770B\u5B83\u73B0\u5728\u7684\u8F93\u51FA\u7528 shell_read({ id: '${id}' })\uFF0C\u8981\u53D1\u4E0B\u4E00\u53E5\u7528 shell_send\uFF0C\u8981\u6536\u6389\u5B83\u7528 shell_close \u6216 task_stop\u3002`;
1073
1105
  }
1074
1106
  function stoppedNotice(id, kind) {
1075
- return kind === "shell" ? `${id} \u5DF2\u5173\u95ED\uFF08\u542B\u5B83\u8D77\u7684\u5B50\u8FDB\u7A0B\uFF09\u3002\u90A3\u4E2A\u4F1A\u8BDD\u91CC\u7684\u73AF\u5883\uFF08cd / venv / REPL\uFF09\u6CA1\u4E86\uFF0C\u8981\u7528\u5F97\u91CD\u5F00\u4E00\u4E2A\u3002` : `${id} \u5DF2\u505C\u6B62\uFF08\u542B\u5B83\u8D77\u7684\u5B50\u8FDB\u7A0B\uFF09\u3002`;
1107
+ if (kind === "shell") {
1108
+ return `${id} \u5DF2\u5173\u95ED\uFF08\u542B\u5B83\u8D77\u7684\u5B50\u8FDB\u7A0B\uFF09\u3002\u90A3\u4E2A\u4F1A\u8BDD\u91CC\u7684\u73AF\u5883\uFF08cd / venv / REPL\uFF09\u6CA1\u4E86\uFF0C\u8981\u7528\u5F97\u91CD\u5F00\u4E00\u4E2A\u3002`;
1109
+ }
1110
+ if (kind === "agent") {
1111
+ return `${id} \u5DF2\u505C\u6B62\uFF08\u5B50\u4EFB\u52A1\u4E0D\u4F1A\u518D\u5F80\u4E0B\u8DD1\uFF09\u3002\u5B83\u5DF2\u7ECF\u8D77\u8FC7\u7684\u540E\u53F0\u547D\u4EE4\u5F52\u5230\u4E86\u4F60\u8FD9\u4E2A\u4F1A\u8BDD\u540D\u4E0B\uFF0C\u8981\u6536\u5F97\u5355\u72EC task_stop\u3002`;
1112
+ }
1113
+ return `${id} \u5DF2\u505C\u6B62\uFF08\u542B\u5B83\u8D77\u7684\u5B50\u8FDB\u7A0B\uFF09\u3002`;
1076
1114
  }
1077
1115
  function alreadyStoppedNotice(id) {
1078
1116
  return `${id} \u5DF2\u7ECF\u4E0D\u5728\u8FD0\u884C\u4E2D\u4E86\u3002`;
@@ -1098,7 +1136,7 @@ function notFound2(id) {
1098
1136
  }
1099
1137
  var taskList = {
1100
1138
  name: "task_list",
1101
- description: "\u5217\u51FA\u672C\u6B21\u4F1A\u8BDD\u8D77\u8FC7\u7684**\u540E\u53F0\u4F5C\u4E1A** \u2014\u2014 terminal \u7684 background: true \u8D77\u7684\u540E\u53F0\u547D\u4EE4\uFF0C\u548C shell_open \u5F00\u7684\u6301\u4E45 shell \u4F1A\u8BDD\uFF0C\u4E24\u79CD\u4E00\u8D77\u5217\uFF0C\u6BCF\u884C\u6807\u51FA\u662F\u54EA\u4E00\u79CD\uFF08[\u547D\u4EE4] / [\u4F1A\u8BDD]\uFF09\u3002\u542B\u72B6\u6001\u3001\u9000\u51FA\u7801\u3001\u8F93\u51FA\u5B57\u8282\u6570\u3002\u4E0D\u786E\u5B9A\u624B\u91CC\u6709\u4EC0\u4E48\u5728\u8DD1\u5C31\u5148\u770B\u8FD9\u4E2A\u3002",
1139
+ description: "\u5217\u51FA\u672C\u6B21\u4F1A\u8BDD\u8D77\u8FC7\u7684**\u540E\u53F0\u4F5C\u4E1A** \u2014\u2014 terminal \u7684 background: true \u8D77\u7684\u540E\u53F0\u547D\u4EE4\u3001shell_open \u5F00\u7684\u6301\u4E45 shell \u4F1A\u8BDD\u3001delegate_task({ background: true }) \u6D3E\u51FA\u53BB\u7684\u540E\u53F0\u5B50 agent\uFF0C\u4E09\u79CD\u4E00\u8D77\u5217\uFF0C\u6BCF\u884C\u6807\u51FA\u662F\u54EA\u4E00\u79CD\uFF08[\u547D\u4EE4] / [\u4F1A\u8BDD] / [\u5B50 agent]\uFF09\u3002\u542B\u72B6\u6001\u3001\u9000\u51FA\u7801\u3001\u8F93\u51FA\u5B57\u8282\u6570\u3002\u4E0D\u786E\u5B9A\u624B\u91CC\u6709\u4EC0\u4E48\u5728\u8DD1\u5C31\u5148\u770B\u8FD9\u4E2A\u3002",
1102
1140
  parameters: { type: "object", properties: {}, required: [] },
1103
1141
  annotations: { readOnlyHint: true, idempotentHint: false, openWorldHint: false },
1104
1142
  operation: "file_read",
@@ -1110,11 +1148,14 @@ var taskList = {
1110
1148
  };
1111
1149
  var taskOutputTool = {
1112
1150
  name: "task_output",
1113
- description: `\u53D6\u4E00\u4E2A\u540E\u53F0\u4F5C\u4E1A\u7684\u8F93\u51FA\uFF08\u540E\u53F0\u547D\u4EE4 t1 \u548C\u6301\u4E45\u4F1A\u8BDD s1 \u90FD\u884C\uFF09\u3002\u53C2\u6570: id(\u5FC5\u586B), since(\u4E0A\u6B21\u8FD4\u56DE\u7684 nextCursor\uFF0C\u7528\u6765\u53EA\u53D6\u65B0\u589E\u90E8\u5206)\u3002\u5355\u6B21\u6700\u591A ${MAX_OUTPUT_CHUNK} \u5B57\u8282\uFF1B\u8F93\u51FA\u5F88\u957F\u65F6\u4F1A\u5206\u6B21\u53D6\uFF0C\u8FD4\u56DE\u91CC\u4F1A\u8BF4\u660E\u8FD8\u6709\u6CA1\u6709\u66F4\u591A\u3002`,
1151
+ description: `\u53D6\u4E00\u4E2A\u540E\u53F0\u4F5C\u4E1A\u7684\u8F93\u51FA\uFF08\u540E\u53F0\u547D\u4EE4 t1\u3001\u6301\u4E45\u4F1A\u8BDD s1\u3001\u540E\u53F0\u5B50 agent a1 \u90FD\u884C\uFF09\u3002\u53C2\u6570: id(\u5FC5\u586B), since(\u4E0A\u6B21\u8FD4\u56DE\u7684 nextCursor\uFF0C\u7528\u6765\u53EA\u53D6\u65B0\u589E\u90E8\u5206)\u3002\u5355\u6B21\u6700\u591A ${MAX_OUTPUT_CHUNK} \u5B57\u8282\uFF1B\u8F93\u51FA\u5F88\u957F\u65F6\u4F1A\u5206\u6B21\u53D6\uFF0C\u8FD4\u56DE\u91CC\u4F1A\u8BF4\u660E\u8FD8\u6709\u6CA1\u6709\u66F4\u591A\u3002`,
1114
1152
  parameters: {
1115
1153
  type: "object",
1116
1154
  properties: {
1117
- id: { type: "string", description: "\u4F5C\u4E1A id\uFF0C\u4F8B\u5982 t1\uFF08\u540E\u53F0\u547D\u4EE4\uFF09\u6216 s1\uFF08\u6301\u4E45\u4F1A\u8BDD\uFF09" },
1155
+ id: {
1156
+ type: "string",
1157
+ description: "\u4F5C\u4E1A id\uFF0C\u4F8B\u5982 t1\uFF08\u540E\u53F0\u547D\u4EE4\uFF09\u3001s1\uFF08\u6301\u4E45\u4F1A\u8BDD\uFF09\u6216 a1\uFF08\u540E\u53F0\u5B50 agent\uFF09"
1158
+ },
1118
1159
  since: { type: "number", description: "\u4E0A\u6B21\u8FD4\u56DE\u7684 nextCursor\uFF1B\u4E0D\u7ED9\u5C31\u4ECE\u5934\u53D6" }
1119
1160
  },
1120
1161
  required: ["id"]
@@ -1156,7 +1197,7 @@ ${sbErr.suggestion}`);
1156
1197
  };
1157
1198
  var taskWait = {
1158
1199
  name: "task_wait",
1159
- description: "\u963B\u585E\u7B49\u4E00\u4E2A\u540E\u53F0\u4F5C\u4E1A\u7ED3\u675F\u3002\u53C2\u6570: id(\u5FC5\u586B), timeoutMs(\u9ED8\u8BA4 30000\uFF0C\u6700\u5927 300000)\u3002**\u8D85\u65F6\u4E0D\u4F1A\u6740\u5B83** \u2014\u2014 \u53EA\u662F\u544A\u8BC9\u4F60\u8FD8\u5728\u8DD1\uFF0C\u8981\u505C\u7528 task_stop\u3002\u6301\u4E45 shell \u4F1A\u8BDD\uFF08s1\uFF09\u538B\u6839\u6CA1\u6709\u300C\u7ED3\u675F\u300D\u8FD9\u4E2A\u72B6\u6001\uFF0C\u7B49\u5B83\u4F1A**\u7ACB\u523B**\u8FD4\u56DE\u4E00\u53E5\u8BF4\u660E\u800C\u4E0D\u662F\u5E72\u7B49\u3002",
1200
+ description: "\u963B\u585E\u7B49\u4E00\u4E2A\u540E\u53F0\u4F5C\u4E1A\u7ED3\u675F\u3002\u53C2\u6570: id(\u5FC5\u586B), timeoutMs(\u9ED8\u8BA4 30000\uFF0C\u6700\u5927 300000)\u3002**\u8D85\u65F6\u4E0D\u4F1A\u6740\u5B83** \u2014\u2014 \u53EA\u662F\u544A\u8BC9\u4F60\u8FD8\u5728\u8DD1\uFF0C\u8981\u505C\u7528 task_stop\u3002\u540E\u53F0\u5B50 agent\uFF08a1\uFF09\u4E5F\u80FD\u7B49\uFF0C\u7B49\u5230\u4E86\u7528 task_output \u53D6\u7ED3\u8BBA\u3002\u6301\u4E45 shell \u4F1A\u8BDD\uFF08s1\uFF09\u538B\u6839\u6CA1\u6709\u300C\u7ED3\u675F\u300D\u8FD9\u4E2A\u72B6\u6001\uFF0C\u7B49\u5B83\u4F1A**\u7ACB\u523B**\u8FD4\u56DE\u4E00\u53E5\u8BF4\u660E\u800C\u4E0D\u662F\u5E72\u7B49\u3002",
1160
1201
  parameters: {
1161
1202
  type: "object",
1162
1203
  properties: {
@@ -1183,7 +1224,7 @@ var taskWait = {
1183
1224
  };
1184
1225
  var taskStop = {
1185
1226
  name: "task_stop",
1186
- description: "\u505C\u6389\u4E00\u4E2A\u540E\u53F0\u4F5C\u4E1A\uFF08\u6740\u6574\u68F5\u8FDB\u7A0B\u6811\uFF0C\u542B\u5B83\u8D77\u7684\u5B50\u8FDB\u7A0B\uFF09\u3002\u53C2\u6570: id(\u5FC5\u586B)\u3002\u540E\u53F0\u547D\u4EE4\uFF08t1\uFF09\u548C\u6301\u4E45\u4F1A\u8BDD\uFF08s1\uFF09\u90FD\u80FD\u505C \u2014\u2014 \u505C\u4E00\u4E2A\u6301\u4E45\u4F1A\u8BDD\u7B49\u4EF7\u4E8E shell_close\uFF0C\u90A3\u4E2A\u4F1A\u8BDD\u91CC\u7684\u73AF\u5883\uFF08cd / venv / REPL\uFF09\u4F1A\u4E00\u8D77\u6CA1\u3002",
1227
+ description: "\u505C\u6389\u4E00\u4E2A\u540E\u53F0\u4F5C\u4E1A\uFF08\u6740\u6574\u68F5\u8FDB\u7A0B\u6811\uFF0C\u542B\u5B83\u8D77\u7684\u5B50\u8FDB\u7A0B\uFF09\u3002\u53C2\u6570: id(\u5FC5\u586B)\u3002\u540E\u53F0\u547D\u4EE4\uFF08t1\uFF09\u3001\u6301\u4E45\u4F1A\u8BDD\uFF08s1\uFF09\u3001\u540E\u53F0\u5B50 agent\uFF08a1\uFF09\u90FD\u80FD\u505C \u2014\u2014\u505C\u4E00\u4E2A\u6301\u4E45\u4F1A\u8BDD\u7B49\u4EF7\u4E8E shell_close\uFF0C\u90A3\u4E2A\u4F1A\u8BDD\u91CC\u7684\u73AF\u5883\uFF08cd / venv / REPL\uFF09\u4F1A\u4E00\u8D77\u6CA1\uFF1B\u505C\u4E00\u4E2A\u540E\u53F0\u5B50 agent \u4F1A\u628A\u5B83\u7684\u5B50\u4EFB\u52A1\u4E00\u8D77\u6536\u6389\uFF08\u5DF2\u7ECF\u8D77\u8FC7\u7684\u540E\u53F0\u547D\u4EE4\u4E0D\u8DDF\u7740\u6CA1\uFF09\u3002",
1187
1228
  parameters: {
1188
1229
  type: "object",
1189
1230
  properties: { id: { type: "string", description: "\u4F5C\u4E1A id" } },
@@ -1255,6 +1296,15 @@ var terminalTool = {
1255
1296
  workdir: {
1256
1297
  type: "string",
1257
1298
  description: "\u5DE5\u4F5C\u76EE\u5F55\uFF08\u5FC5\u987B\u5728\u5DE5\u4F5C\u533A\u5185\uFF0C\u76F8\u5BF9\u8DEF\u5F84\u6309\u5DE5\u4F5C\u533A\u6839\u89E3\u6790\uFF09"
1299
+ },
1300
+ [SANDBOX_PERMISSIONS_PARAM2]: {
1301
+ type: "string",
1302
+ enum: [...ESCALATION_TARGETS2],
1303
+ description: "\u4EC5\u5F53\u547D\u4EE4\u88AB\u6C99\u7BB1\u6321\u4E0B\uFF08\u9519\u8BEF 2008/2009\uFF09\u4E14\u786E\u8BA4\u8FD9\u6B21\u5FC5\u987B\u8D8A\u754C\u65F6\u624D\u7528\uFF1A\u8BF7\u6C42\u653E\u5F00**\u8FD9\u4E00\u6B21**\u6267\u884C\u7684\u6C99\u7BB1\u8FB9\u754C\u3002\u53D6\u503C\u53EA\u80FD\u662F\u5F53\u524D\u6863\u4F4D\u4E25\u683C\u66F4\u5BBD\u7684\u90A3\u4E00\u9879\uFF0C\u4E14\u5FC5\u987B\u548C justification \u6210\u5BF9\u51FA\u73B0\uFF08\u53EA\u7ED9\u4E00\u4E2A\u6574\u6B21\u8C03\u7528\u76F4\u63A5\u5931\u8D25\uFF09\u3002\u7528\u6237\u4F1A\u5355\u72EC\u770B\u5230\u4E00\u6B21\u5347\u6743\u5BA1\u6279\uFF1B\u53EA\u5BF9\u8FD9\u4E00\u6B21\u8C03\u7528\u751F\u6548\u3002\u522B\u628A\u5B83\u5F53\u4E07\u7528\u5F00\u5173 \u2014\u2014 \u80FD\u628A\u6539\u52A8\u632A\u8FDB\u5DE5\u4F5C\u533A\u3001\u6216\u6362\u6210\u4E0D\u9700\u8981\u8D8A\u754C\u7684\u5199\u6CD5\uFF0C\u5C31\u5148\u90A3\u4E48\u529E\u3002"
1304
+ },
1305
+ [JUSTIFICATION_PARAM2]: {
1306
+ type: "string",
1307
+ description: "\u4E00\u53E5\u8BDD\u8BF4\u660E\u4E3A\u4EC0\u4E48\u5FC5\u987B\u8D8A\u754C\uFF0C\u7ED9\u7528\u6237\u770B\uFF08\u4ED6\u636E\u6B64\u51B3\u5B9A\u6279\u4E0D\u6279\uFF09\u3002\u53EA\u5728\u540C\u65F6\u4F20\u4E86 sandbox_permissions \u65F6\u6709\u610F\u4E49\uFF0C\u5355\u72EC\u7ED9\u4F1A\u88AB\u62D2\u3002"
1258
1308
  }
1259
1309
  },
1260
1310
  required: ["command"]
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@epoch-agent/plugin-terminal",
3
- "version": "2.8.0",
3
+ "version": "3.0.0",
4
4
  "private": false,
5
5
  "description": "epoch-agent 终端命令执行插件",
6
6
  "repository": {
@@ -22,8 +22,8 @@
22
22
  ],
23
23
  "dependencies": {
24
24
  "node-pty": "^1.1.0",
25
- "@epoch-agent/infra": "2.8.0",
26
- "@epoch-agent/protocol": "2.8.0"
25
+ "@epoch-agent/infra": "3.0.0",
26
+ "@epoch-agent/protocol": "3.0.0"
27
27
  },
28
28
  "devDependencies": {
29
29
  "@types/node": "^26.1.2",