pi-shadow-mind 0.1.16 → 0.1.17

package/DESIGN.md

@@ -111,7 +111,7 @@ active_for_models:
 | `run_with_model` | Shadow 自己使用的模型；省略时使用插件默认模型 |
 | `thinking_level` | Shadow 使用的 thinking level；省略时使用插件默认值，再回退到 Main 会话当前生效等级 |
 | `timeout_seconds` | Shadow 单次运行超时；省略时使用插件默认超时 |
-| `tools` | 在 Pi SDK `readOnlyTools` 之上追加的工具白名单；默认 `[]` |
+| `tools` | 在 Pi SDK `readOnlyTools` 之上追加的工具白名单；`["*"]` 授权当前 Session 的全部工具；默认 `[]` |
 
 `name` 只用于 `shadow-report` 和状态界面展示，不参与身份判断；省略时回退到最终解析出的 `id`。Markdown 正文就是 Shadow 的认知定义、长期职责和行为要求。
 
@@ -131,9 +131,9 @@ Pi SDK readOnlyTools
 
 默认名称集合包含 `read`、`grep`、`find` 和 `ls`。激活时插件按名称从当前 Main Session 的最终工具 registry 解析实际实现，因此会继承其他插件对同名工具的覆盖以及当前环境适配。这里的 `readOnlyTools` 表示默认名称约定，不保证被覆盖后的实现仍然没有副作用。
 
-`tools` 是在该集合之上追加的显式白名单，省略时视为 `[]`。例如 `tools: [write]` 会获得当前 registry 中的默认四个工具、`write` 和内置 `report_to_main`。
+`tools` 是在该集合之上追加的显式白名单，省略时视为 `[]`。例如 `tools: [write]` 会获得当前 registry 中的默认四个工具、`write` 和内置 `report_to_main`。使用 `tools: ["*"]` 时，Shadow 会获得激活时 Main Session registry 中的全部工具以及 `report_to_main`；之后新增或改名的工具会自动随 registry 解析，不需要同步维护定义文件。
 
-Pi 的通用 `ToolDefinition` 没有可供插件查询的只读属性，因此自定义工具不会被自动归类或加入；编辑文件、执行 Shell 或其他能力也不会被隐式继承自 Main。配置的追加工具在当前 Session 不存在时，插件忽略该项、写入轻量运行事件，其余工具继续正常提供。
+Pi 的通用 `ToolDefinition` 没有可供插件查询的只读属性，因此自定义工具不会被自动归类或加入；编辑文件、执行 Shell 或其他能力也不会被隐式继承自 Main，除非显式列出名称或使用 `"*"`。配置的追加工具在当前 Session 不存在时，插件忽略该项、写入轻量运行事件，其余工具继续正常提供。
 
 `tools` 白名单本身就是用户对该 Shadow 的执行授权。列入白名单的写入、Shell 或其他工具可以由后台 Shadow 直接调用，插件不增加逐次确认层。
 

package/README.md

@@ -66,7 +66,7 @@ Report only concrete, actionable issues grounded in the visible trajectory or
 repository. If the current work is unrelated, do not intervene.
 ```
 
-This Shadow is read-only. It reviews the implementation in parallel and reports concrete architectural concerns without taking control of the main task.
+This Shadow is read-only. It reviews the implementation in parallel and reports concrete architectural concerns without taking control of the main task. Tool names extend the default read-only set; use `tools: ["*"]` only when the Shadow should inherit every tool currently registered in the main session, including tools added later.
 
 ## How it works
 

package/README.zh-CN.md

@@ -63,7 +63,7 @@ tools: [read, grep]
 无关，不要介入。
 ```
 
-这个 Shadow 默认只读。它会在实现过程中并行审阅架构，并向主 Agent 报告具体问题，但不会接管主任务。
+这个 Shadow 默认只读。它会在实现过程中并行审阅架构，并向主 Agent 报告具体问题，但不会接管主任务。`tools` 中的名称会追加到默认只读工具集；只有确实需要继承 Main Session 当前注册的全部工具（包括未来新增工具）时，才使用 `tools: ["*"]`。
 
 ## 工作方式
 

package/dist/index.js

@@ -7747,7 +7747,7 @@ function compactJson(value) {
 // src/shadow-runner.ts
 function resolveShadowTools(whitelist, available, defaults = DEFAULT_READ_TOOLS) {
   const builtin = /* @__PURE__ */ new Set(["report_to_main"]);
-  const requested = [.../* @__PURE__ */ new Set([...defaults, ...whitelist, ...builtin])];
+  const requested = whitelist.includes("*") ? [.../* @__PURE__ */ new Set([...available, ...builtin])] : [.../* @__PURE__ */ new Set([...defaults, ...whitelist, ...builtin])];
   const tools = [];
   const missing = [];
   for (const name of requested) {
@@ -7769,13 +7769,13 @@ function buildRunResult(options) {
   const usage = usageMetrics(ownMessages);
   return {
     reason,
-    ...error !== void 0 ? { error } : {},
+    ...error === void 0 ? {} : { error },
     durationMs,
     toolNames: session?.getActiveToolNames() ?? [],
     missingTools,
     ...metrics,
     usage,
-    ...thinkingLevel !== void 0 ? { thinkingLevel } : {},
+    ...thinkingLevel === void 0 ? {} : { thinkingLevel },
     sessionFile: session?.sessionFile
   };
 }