scream-code 0.19.5 → 0.19.7

package/dist/{dispatch-Cqw-jMk5.mjs → dispatch-d_R8-8sn.mjs}

@@ -3,5 +3,5 @@ import { fileURLToPath as __cjsShimFileURLToPath } from 'node:url';
 import { dirname as __cjsShimDirname } from 'node:path';
 const __filename = __cjsShimFileURLToPath(import.meta.url);
 const __dirname = __cjsShimDirname(__filename);
-import { Qt as handleConnectCommand } from "./dispatch-Brb_yK-J.mjs";
+import { Qt as handleConnectCommand } from "./dispatch-BiOeRj_C.mjs";
 export { handleConnectCommand };

package/dist/main.mjs

@@ -6,7 +6,7 @@ const __dirname = __cjsShimDirname(__filename);
 import "./suppress-sqlite-warning-C2VB0doZ.mjs";
 //#region src/main.ts
 try {
-	(await import("./app-JxeaGaIc.mjs")).main();
+	(await import("./app-Bpl0l99M.mjs")).main();
 } catch (error) {
 	process.stderr.write(`${error instanceof Error ? error.stack ?? error.message : String(error)}\n`);
 	process.exit(1);

package/dist/{text-input-dialog-1CeiIQzf.mjs → text-input-dialog-BLUlZjUL.mjs}

@@ -3,5 +3,5 @@ import { fileURLToPath as __cjsShimFileURLToPath } from 'node:url';
 import { dirname as __cjsShimDirname } from 'node:path';
 const __filename = __cjsShimFileURLToPath(import.meta.url);
 const __dirname = __cjsShimDirname(__filename);
-import { t as TextInputDialogComponent } from "./text-input-dialog-D6PfbOws.mjs";
+import { t as TextInputDialogComponent } from "./text-input-dialog-Ce2AEFU9.mjs";
 export { TextInputDialogComponent };

package/dist/{text-input-dialog-D6PfbOws.mjs → text-input-dialog-Ce2AEFU9.mjs}

@@ -757,10 +757,11 @@ const dictionaries = {
 		"memory.detail_nav_hint": "  Enter/Esc 返回  |  i 注入  |  d 删除  |  e 编辑",
 		"plugin.no_session": "请先创建或恢复一个会话，再使用 Plugin 中心。",
 		"extension.no_session": "请先创建或恢复一个会话，再使用扩展命令。",
-		"extension.usage": "用法：/extension activate|deactivate|status [pluginId]",
+		"extension.usage": "用法：/extension activate|deactivate|reload|status [pluginId]",
 		"extension.missing_id": "缺少扩展 id：/extension {action} <pluginId>",
 		"extension.activated": "扩展 {pluginId} 已激活。",
 		"extension.deactivated": "扩展 {pluginId} 已停用。",
+		"extension.reloaded": "扩展 {pluginId} 已重新加载。",
 		"extension.no_extensions": "没有安装代码插件（entryPoint）。",
 		"plugin.loading": "正在加载 Plugin 中心…",
 		"plugin.center_title": "Plugin 中心",
@@ -972,6 +973,7 @@ const dictionaries = {
 		"usage.subagent_title": "子 Agent 用量",
 		"usage.panel_title": " 用量 ",
 		"usage.session_total": "会话总计",
+		"usage.cost": "花费",
 		"usage.cache_rw": "缓存",
 		"usage.main_agent": "主 Agent",
 		"usage.sub_agent": "子 Agent",
@@ -2138,10 +2140,11 @@ const dictionaries = {
 		"memory.detail_nav_hint": "  Enter/Esc Back  |  i Inject  |  d Delete  |  e Edit",
 		"plugin.no_session": "Please create or resume a session before using the Plugin center.",
 		"extension.no_session": "Please create or resume a session before using extension commands.",
-		"extension.usage": "Usage: /extension activate|deactivate|status [pluginId]",
+		"extension.usage": "Usage: /extension activate|deactivate|reload|status [pluginId]",
 		"extension.missing_id": "Missing plugin id: /extension {action} <pluginId>",
 		"extension.activated": "Extension {pluginId} activated.",
 		"extension.deactivated": "Extension {pluginId} deactivated.",
+		"extension.reloaded": "Extension {pluginId} reloaded.",
 		"extension.no_extensions": "No code extensions (entryPoint) installed.",
 		"plugin.loading": "Loading Plugin center…",
 		"plugin.center_title": "Plugin Center",
@@ -2353,6 +2356,7 @@ const dictionaries = {
 		"usage.subagent_title": "Sub-Agent Usage",
 		"usage.panel_title": " Usage ",
 		"usage.session_total": "Session Total",
+		"usage.cost": "Cost",
 		"usage.cache_rw": "cache",
 		"usage.main_agent": "Main Agent",
 		"usage.sub_agent": "Sub-Agent",

package/docs/plugins.md

@@ -0,0 +1,198 @@
+# Plugins — 给自己写插件
+
+Scream 可以给自己写插件：遇到技能和 MCP 都覆盖不了的需求时，直接产出一个代码插件。
+
+插件能贡献四类能力：技能（提示词）、MCP server、shell hooks、以及在进程内运行的工具代码。注册后技能立即生效；MCP server 与 hooks 随激活启动，**代码只在 `activate` 时执行**。
+
+## 快速开始
+
+**先征得同意**：动手写之前用 `AskUserQuestion` 问一句（"要不要我做一个插件来完成这个？"）。审批弹窗在 auto/yolo 下不会出现，所以 yolo 里问句是唯一还会出现的同意步骤（与 `/make-skill` 的确认方式一致）。auto 模式连问句也被禁（`AutoModeAskUserQuestionDenyPermissionPolicy`），因此自产插件属于交互模式的用法，无人值守场景请显式 `install`。manual 模式下 `register_generated` 仍会单独弹一次审批。
+
+目录约定 `<scream home>/plugins/generated/<id>/`（`<scream home>` 默认 `~/.scream-code`）。放在别处的目录也能注册，但任何目录都不会被自动扫描——注册必须显式发生。
+
+`scream.plugin.json` 最小内容：
+
+```json
+{
+  "name": "text-stats",
+  "version": "0.1.0",
+  "description": "Count lines and characters in a file",
+  "entryPoint": "./index.mjs"
+}
+```
+
+入口 `index.mjs` 最小内容：
+
+```js
+import { readFile } from 'node:fs/promises';
+
+export async function activate(context) {
+  context.services.tools.registerUserTool({
+    name: 'text_stats',
+    description: 'Count lines and characters in a file',
+    parameters: {
+      type: 'object',
+      properties: { path: { type: 'string' } },
+      required: ['path'],
+    },
+    execute: async (args) => {
+      const text = await readFile(String(args.path), 'utf8');
+      return { output: `lines=${text.split('\n').length} chars=${text.length}` };
+    },
+  });
+}
+```
+
+两步启用：
+
+1. `ManagePlugin { "action": "register_generated", "source": "<插件目录的绝对路径>" }` —— 登记目录、热应用技能，**不 import 入口**。
+2. `ManagePlugin { "action": "activate", "id": "text-stats" }` —— 单独审批后 import 入口并执行 `activate`，工具此刻才对模型可见。
+
+## 清单字段
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| `name` | 是 | 插件 id，须匹配 `^[a-z0-9][a-z0-9_-]{0,63}$` |
+| `version` | 否 | 版本字符串，仅用于展示与检查 |
+| `description` | 否 | 一句话说明 |
+| `skills` | 否 | 技能目录，字符串或字符串数组；每项必须以 `./` 开头且位于插件目录内 |
+| `mcpServers` | 否 | MCP server 配置对象，key 为 server 名；注册不会拉起进程，随 `activate` / `enable` 启动 |
+| `hooks` | 否 | HookDef 数组（`event` / `command` / `matcher` / `timeout`），激活时注入、停用时移除 |
+| `config` | 否 | 任意 JSON 对象，原样作为 `context.config` 交给入口模块 |
+| `entryPoint` | 否 | 代码入口；必须 `./` 开头，且 realpath 后仍位于插件目录内。不满足时清单层丢弃该字段并留下诊断，`register_generated` 会据此报 `entry_point_rejected`，不会静默降级 |
+
+`entryPoint` 指向的文件必须存在：`register_generated` 在登记前会 stat 该路径，缺失时返回 `entry_file_missing`，不会留下半登记记录。
+
+## 入口模块契约
+
+```js
+export async function activate(context) {}
+
+export async function deactivate() {}
+```
+
+- 必须是 ESM。也接受 `export default { activate, deactivate }` 的写法（运行时统一经 `normalizeExtensionModule` 归一化）。
+- `activate(context)` 必须导出；`deactivate()` 可选，且不接收参数——需要清理的东西在 `activate` 里捕获到模块作用域。
+- `activate` 抛错时，本次激活完成一半的 hooks 与事件订阅会被回滚，错误写入插件记录并返回 `activation_failed`。
+- 激活是**按会话**的：同一个插件可以在 A、B 两个会话里各跑一份（各自的 hooks、事件订阅、工具互不相干），但**同一会话内**不能重复激活；停用一个会话不影响另一个。
+- 会话关闭时，它激活过的插件会被自动 `deactivate`，不会残留。
+
+## context API
+
+| 成员 | 说明 |
+|---|---|
+| `pluginId` | 当前插件 id |
+| `config` | 清单 `config` 块；未声明时为 `undefined` |
+| `services.tools.registerUserTool(input)` | 注册进程内工具，立即对当前 agent 可见 |
+| `services.tools.unregisterUserTool(name)` | 注销自己注册的工具 |
+| `services.tools.unregisterToolsByOwner(id)` | 按 owner 批量注销；宿主在停用时也会自动执行 |
+| `events.subscribe(type \| '*', handler)` | 订阅 agent 事件，返回 `unsubscribe`；`deactivate` 时宿主也会统一释放 |
+| `services` | agent 的子系统清单；只应调用这里列出的工具相关成员 |
+| `ui.notify(level, message)` | 向用户报一句：`info` / `warn` / `error`。作为状态区消息显示，不打断 |
+| `ui.confirm({ title, body?, confirmLabel?, cancelLabel? })` | 问用户是/否，返回 `Promise<boolean>`；无界面宿主一律返回 `false` 并说明原因 |
+| `ui.progress(title)` | 返回 `{ update(label), done(message?), fail(message?) }`；文本进度，`update` 限流约 5 次/秒 |
+
+`registerUserTool` 的入参：
+
+| 字段 | 说明 |
+|---|---|
+| `name` | 工具名，全局唯一 |
+| `description` | 给模型看的一句话说明 |
+| `parameters` | JSON Schema 对象（`type: "object"` 及 `properties` / `required`） |
+| `execute(args, ctx)` | 返回 `{ output, message?, isError? }` 或 Promise；`output` 是模型看到的内容，`message` 只给 UI |
+
+运行时会给注册自动打上 `ownerPluginId`，因此停用、移除、熔断都能精确回收该插件的工具；插件自己声明的 owner 优先。`execute` 抛错会被转成工具错误，不会打断 agent loop，但会计入熔断计数。
+
+## 界面交互（ui）
+
+三个原语，全部**降级而不抛错**：
+
+| 宿主 | `notify` | `confirm` | `progress` |
+|---|---|---|---|
+| TUI | 状态区一行 | 弹出选择框，选「确认」为 `true` | 状态区文本逐步更新 |
+| `/line`、SDK、print | 事件日志 | 直接 `false` + 一条 warn | 状态区文本（若宿主有） |
+
+`confirm` 走的是和 `AskUserQuestion` 同一条提问通道，所以不需要插件自己画界面；`notify` 复用宿主的警示事件（`code: "plugin:<level>"`），宿主可据此区分级别。**插件不能阻塞会话**：任何等待都有结果，宿主不在就按「否」处理。
+
+## 迭代
+
+改完入口文件后执行 `/extension reload <id>`（等价于 `deactivate` + `activate`），或者在会话里用 `ManagePlugin` 先 `deactivate` 再 `activate`。
+
+注意区分两个动作：`ManagePlugin {action:"reload"}` 只是**重读插件表**，不会重新 import；要重新 import 改过的入口文件，用 `/extension reload <id>` 或 `ManagePlugin {action:"reload_code", id:"<id>"}`。
+
+只调用 `activate` 不会加载新代码：模块按入口路径缓存，`deactivate` 会丢掉该缓存并让下一次 import 走新的 specifier，重新激活才读到新文件。激活失败、import 失败同样会让缓存失效，所以「改错 → 报错 → 改对 → reload」是可行的。
+
+## 已知限制
+
+- **重启进程后需要重新激活**：插件记录仍在插件中心（`/plugin`、`ManagePlugin list` 可见），但激活态只存在于进程内。
+- **激活绑定当前会话的 main agent**：工具注册在那一个 agent 上。同一进程里的另一个会话可能看到 `●` 状态，但拿不到这个工具。
+- **熔断分两种，恢复方式不同**：
+  - **工具连续失败 3 次**：持久禁用（写进插件记录），`check` 的 `circuit` 能看到计数，`ManagePlugin { "action": "reset", "id": "<id>" }` 清除并重新启用。
+  - **事件 handler 连续抛错 3 次**：只在**当前进程内**停用，不改插件记录，`check.circuit` 也不会显示；修好 handler 后重新 `activate` 即可。
+- **`reload` 只重新 import 入口模块**：入口用 `import './lib.mjs'` 引的其它文件仍走进程缓存，多文件插件改完辅助文件不会生效（改放进入口，或重启进程）。
+- **每次 reload 都会在进程里留下一份旧模块实例**：这是「改了立刻生效」的代价，量级等于编辑次数，不影响正确性。
+- 没有目录扫描或自动发现：新插件必须显式 `register_generated` / `install`。
+
+## 完整示例：text-stats
+
+`scream.plugin.json`：
+
+```json
+{
+  "name": "text-stats",
+  "version": "0.1.0",
+  "description": "Count lines and characters in a file",
+  "entryPoint": "./index.mjs"
+}
+```
+
+`index.mjs`：
+
+```js
+import { readFile } from 'node:fs/promises';
+
+// Kept in module scope so deactivate() can unregister without a context arg.
+let tools;
+
+export async function activate(context) {
+  tools = context.services.tools;
+  tools.registerUserTool({
+    name: 'text_stats',
+    description: '统计文件的行数与字符数',
+    parameters: {
+      type: 'object',
+      properties: {
+        path: { type: 'string', description: '要统计的文件路径' },
+      },
+      required: ['path'],
+      additionalProperties: false,
+    },
+    execute: async (args) => {
+      const text = await readFile(String(args.path), 'utf8');
+      return {
+        output: `lines=${text.split('\n').length} chars=${text.length}`,
+        message: `已统计 ${String(args.path)}`,
+      };
+    },
+  });
+}
+
+export async function deactivate() {
+  // The host reclaims owned tools too; this keeps the plugin self-contained.
+  tools?.unregisterUserTool('text_stats');
+  tools = undefined;
+}
+```
+
+启用与迭代：
+
+1. `ManagePlugin { "action": "register_generated", "source": "/Users/me/.scream-code/plugins/generated/text-stats" }`
+2. `ManagePlugin { "action": "activate", "id": "text-stats" }`
+3. 改完代码后 `/extension reload text-stats`
+
+## 安全边界
+
+- 入口只能在插件目录内：清单层强制 `./` 相对路径，并对 realpath 结果做越界检查（见 `resolvePluginPathField`）。越界的 `entryPoint` 会被清单层拒绝，`register_generated` 报 `entry_point_rejected`，不会降级成"看起来注册成功"的纯数据插件。
+- 注册不执行代码：`register_generated` 只解析清单、登记记录；`activate` 是唯一的执行点，且单独要求审批。
+- 审批身份包含目录路径与插件 id：`register_generated` 的审批串带完整 source，`activate` / `deactivate` / `remove` / `enable` / `disable` / `reset` / `rollback` / `set_mcp_enabled` / `reload_code` 带插件 id（如 `ManagePlugin(activate text-stats)`）。会话级授权只能覆盖同名对象，不能挪用到另一个目录或另一个插件。
+- 激活后代码运行在 agent 进程内，可访问 `context.services`。只激活自己写的或完全信任的插件。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scream-code",
-  "version": "0.19.5",
+  "version": "0.19.7",
   "description": "A terminal-native AI agent for builders",
   "license": "MIT",
   "author": "ScreamCli",
@@ -58,7 +58,7 @@
     "@earendil-works/pi-codemode": "^1.1.0",
     "@huggingface/tokenizers": "^0.2.0",
     "@larksuiteoapi/node-sdk": "^1.76.0",
-    "@liutod-scream/pi-tui": "^1.1.0",
+    "@liutod-scream/pi-tui": "^1.5.0",
     "@mariozechner/clipboard": "^0.3.2",
     "chalk": "^5.4.1",
     "cli-highlight": "^2.1.11",