pi-delegation-policy 0.23.2 → 0.23.3

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 ## Unreleased
 
+## 0.23.3 - 2026-10-31
+
+### Fixed
+
+- The role-mode reply from `consult_advisor` starts with `Not an error:` and limits its instruction
+  not to call the tool again to the time when Advisor launch remains `role`.
+- The reply names the exact active host tool `subagent`, discovered at invocation time through Pi's
+  public tool API. If it is absent or inactive, the reply tells the model to inform the user that it
+  cannot launch the Advisor and not to improvise foreground execution, a CLI or another agent.
+
+### Compatibility and verification
+
+- Only the role-mode tool result changes. Tool definitions, the policy block and all other replies
+  remain unchanged from 0.23.2. No configuration migration, dependency, profile, model, permission or
+  Pi minimum change; upgrade and reload as usual.
+- Registered-tool tests cover the exact launcher name, its absence and changing availability within
+  one runtime. The existing definition-identity test remains unchanged and passes. These checks do
+  not measure provider cache hits or establish real-model behavior with the new wording.
+
 ## 0.23.2 - 2026-10-31
 
 ### Fixed

package/README.md

@@ -6,7 +6,7 @@ general subagent runner. Only explicit tools can request reader work or Advisor
 the authorized host executor; hooks never launch children.
 
 > **Docs:** [yivas.github.io/pi-delegation-policy](https://yivas.github.io/pi-delegation-policy/).
-> Version **0.23.2** requires Pi `0.87.1` or later (`>=0.87.1`); it re-applies its marked policy block in the final provider payload.
+> Version **0.23.3** requires Pi `0.87.1` or later (`>=0.87.1`); it re-applies its marked policy block in the final provider payload.
 > Version `0.14.1` supports Pi `0.84.3` or later (`>=0.84.3`).
 >
 > Independent Advisor mode and its companion file are available from version `0.17.0`.
@@ -15,7 +15,7 @@ the authorized host executor; hooks never launch children.
 ## Install
 
 ```bash
-pi install npm:pi-delegation-policy@0.23.2
+pi install npm:pi-delegation-policy@0.23.3
 # restart Pi, or run /reload
 ```
 

package/SECURITY.md

@@ -69,4 +69,4 @@ Include the affected version or commit, operating system, Pi version, reproducti
 
 ## Supported versions
 
-Only the latest published version is supported. Version `0.23.2` requires Pi `0.87.1` or later; version `0.14.1` requires Pi `0.84.3` or later.
+Only the latest published version is supported. Version `0.23.3` requires Pi `0.87.1` or later; version `0.14.1` requires Pi `0.84.3` or later.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-delegation-policy",
-  "version": "0.23.2",
+  "version": "0.23.3",
   "private": false,
   "description": "A Pi extension for configurable delegation intensity and exact subagent role model references.",
   "type": "module",

package/src/index.ts

@@ -564,10 +564,16 @@ export function createPiDelegationPolicy(options: PiDelegationPolicyOptions = {}
             "Advisor is off in /delegate for this session. Do not consult it and do not ask the user to enable it unless they raise it.",
           );
         if (!advisors.length) return text(advisorUnavailableText(state));
-        if (state.effective.advisorLaunch === "role")
+        if (state.effective.advisorLaunch === "role") {
+          const subagentTool = pi.getActiveTools().find((name) => name === "subagent");
+          if (!subagentTool)
+            return text(
+              'Not an error: Advisor launch is "role", so this tool does not launch Advisors; do not call this tool again while Advisor launch is "role". The host subagent tool "subagent" is not available. Tell the user that you cannot launch the Advisor with the available host tools. Do not improvise another mechanism: do not use foreground execution, a CLI, or another agent.',
+            );
           return text(
-            `Advisor launch is "role": this tool is not used in role mode; do not call this tool again. Launch every listed Advisor with the host subagent tool, using each exact agent profile and model below, in the background, all listed Advisors with the same question in one call, as the delegation policy describes. Replace LEVEL with a supported thinking level chosen per run under that Advisor's thinking policy; a fixed level must not change.\n${advisorRoleLines(state)}`,
+            `Not an error: Advisor launch is "role", so this tool does not launch Advisors; do not call this tool again while Advisor launch is "role". Launch every listed Advisor with the host subagent tool "${subagentTool}", using each exact agent profile and model below, in the background, all listed Advisors with the same question in one call, as the delegation policy describes. Replace LEVEL with a supported thinking level chosen per run under that Advisor's thinking policy; a fixed level must not change.\n${advisorRoleLines(state)}`,
           );
+        }
         if (advisorExecutor.busy)
           return text(
             "Advisor busy: one consultation group is already in flight for this session. Wait for its result before starting another consultation; do not duplicate the pending group.",