feat: enable permission-aware subagents

pi-tool-search/CHANGELOG.md

@@ -11,6 +11,7 @@
 - Added limits for active groups, generated group size, and total dynamic tools, plus current-host catalog/config/LRU tests.
 - Added checked-in authoritative groups for every tool exposed by the standard my-pi bundle, eliminating first-use model generation and user caching unless unrecognized third-party tools are present.
 - Replaced the Hermes and third-party Hippo assignments with the five tools exposed by the official Hippo Pi extension, grouped into recall and management workflows.
+- Added the enabled bundle's `Agent`, `get_subagent_result`, and `steer_subagent` tools to a checked-in `subagents` orchestration group.
 
 ## [0.3.6] - 2026-04-24
 

pi-tool-search/README.md

@@ -37,6 +37,7 @@ Run `/tool-search-rebuild` to remove model enrichment. Standard bundle tools imm
 | `context-administration` | Context upgrade and destructive purge |
 | `memory-recall` | Official Hippo recall/context/status and condensed-output recovery |
 | `memory-management` | Official Hippo remember/outcome tools |
+| `subagents` | Launch agents, collect background results, and steer running agents |
 | `mcp-management` | Shared MCP adapter management |
 
 Pinned tools are removed from these dynamic groups at runtime. For example, the default-pinned `codegraph_explore` and `lsp_diagnostics` do not consume the `code-intelligence` group budget.

pi-tool-search/docs/dynamic-tool-loading.md

@@ -12,7 +12,7 @@
 8. Group load and member execution update an in-session LRU counter. Loading past `maxActiveGroups` or `maxDynamicTools` removes the least-recently-used dynamic groups.
 9. `turn_start` notices tool or grouping-configuration changes by hash, resets stale dynamic groups, and reconstructs the checked-in/hybrid catalog.
 
-The standard bundle assigns the official Hippo Pi extension's five `hippo_*` tools to recall and management groups. `context_tree_query` remains in `memory-recall` because it recovers condensed tool output; retired Hermes names and third-party `tff-memory_*` names are not seeded.
+The standard bundle assigns the official Hippo Pi extension's five `hippo_*` tools to recall and management groups, and assigns `Agent`, `get_subagent_result`, and `steer_subagent` to the `subagents` orchestration group. `context_tree_query` remains in `memory-recall` because it recovers condensed tool output; retired Hermes names and third-party `tff-memory_*` names are not seeded.
 
 A purely additive first load receives Pi's native dynamic-tool result propagation. A replacement that evicts one group while adding another is intentionally non-additive; current Pi detects the removal and uses its safe next-request fallback instead of attaching an invalid additive-only hint.
 

pi-tool-search/extensions/bundle-groups.ts

@@ -121,6 +121,15 @@ export const BUNDLE_GROUP_DEFINITIONS: BundleGroupDefinition[] = [
     keywords: ["remember", "outcome", "lesson", "error", "记住", "反馈", "项目经验"],
     tools: ["hippo_remember", "hippo_outcome"],
   },
+  {
+    id: "subagents",
+    title: "Subagent orchestration",
+    summary: "Launch isolated subagents, collect background results, and steer running delegated work.",
+    useWhen: ["A bounded task benefits from an isolated specialist, background execution, or delegated follow-up"],
+    avoidWhen: ["The current agent can complete a small direct task without delegation overhead"],
+    keywords: ["subagent", "agent", "delegate", "background", "steer", "子代理", "委派", "后台"],
+    tools: ["Agent", "get_subagent_result", "steer_subagent"],
+  },
   {
     id: "mcp-management",
     title: "MCP management",

pi-tool-search/test/bundle-groups.test.ts

@@ -29,6 +29,9 @@ test("bundle seed names are unique and cover the declared my-pi tools", () => {
   assert.equal(result.catalog.tools.find((card) => card.name === "tavily_web_fetch")?.primaryGroup, "web-tavily");
   assert.equal(result.catalog.tools.find((card) => card.name === "hippo_recall")?.primaryGroup, "memory-recall");
   assert.equal(result.catalog.tools.find((card) => card.name === "hippo_remember")?.primaryGroup, "memory-management");
+  assert.equal(result.catalog.tools.find((card) => card.name === "Agent")?.primaryGroup, "subagents");
+  assert.equal(result.catalog.tools.find((card) => card.name === "get_subagent_result")?.primaryGroup, "subagents");
+  assert.equal(result.catalog.tools.find((card) => card.name === "steer_subagent")?.primaryGroup, "subagents");
 });
 
 test("user overrides take priority and unknown tools retain deterministic fallback groups", () => {