@ian-pascoe/pi-advisor 0.3.3 → 0.3.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ian-pascoe/pi-advisor",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "private": false,
   "description": "Background review and attributed corrective advice for Pi agent sessions.",
   "keywords": [

package/skills/pi-advisor/SKILL.md

@@ -2,6 +2,7 @@
 name: pi-advisor
 description: Diagnose Pi Advisor when reviews or advisor_ask are missing, consultation fails, the Advisor is paused, settings are ineffective, backlog waits do not release, or corrective advice is not delivered safely.
 license: MIT
+disable-model-invocation: true
 ---
 
 # Pi Advisor

package/src/index.ts

@@ -19,6 +19,7 @@ import { completeAdvisorCommandArguments, parseAdvisorCommand } from "./advisor-
 import { AdvisorObserver } from "./advisor-observer.js";
 import { isAdvisorSession, type AdvisorResourceInputs } from "./advisor-session.js";
 import { advisorRuntimeWarning } from "./advisor-runtime.js";
+import { TROUBLESHOOTING_HINT } from "./troubleshooting-skill.js";
 
 interface WatchedChild {
   agentId: string;
@@ -76,13 +77,20 @@ export default function advisor(pi: ExtensionAPI): void {
         parameters: askToolParameters,
         executionMode: "sequential",
         execute: async (_id, { message }, signal) => {
-          const current = observer;
-          if (!current)
-            throw new Error(
-              `${error ?? "Advisor consultation is unavailable"}. Inspect /advisor status, then run /advisor on or correct its configuration.`,
-            );
-          const answer = await current.consult(message, signal);
-          return { content: [{ type: "text", text: answer }], details: {} };
+          try {
+            const current = observer;
+            if (!current)
+              throw new Error(
+                `${error ?? "Advisor consultation is unavailable"}. Inspect /advisor status, then run /advisor on or correct its configuration.`,
+              );
+            const answer = await current.consult(message, signal);
+            return { content: [{ type: "text", text: answer }], details: {} };
+          } catch (cause) {
+            // Caller cancellation is not a malfunction the Skill diagnoses.
+            if (signal?.aborted) throw cause;
+            const text = cause instanceof Error ? cause.message : String(cause);
+            throw new Error(`${text}\n\n${TROUBLESHOOTING_HINT}`, { cause });
+          }
         },
       });
       askToolRegistered = true;

package/src/troubleshooting-skill.ts

@@ -0,0 +1,9 @@
+import { fileURLToPath } from "node:url";
+
+/** Absolute path of this package's user-invoked troubleshooting Skill. */
+export const TROUBLESHOOTING_SKILL_PATH = fileURLToPath(
+  new URL("../skills/pi-advisor/SKILL.md", import.meta.url),
+);
+
+/** Model-facing pointer appended to failures this package's Skill diagnoses. */
+export const TROUBLESHOOTING_HINT = `For diagnosis, read the pi-advisor troubleshooting Skill at ${TROUBLESHOOTING_SKILL_PATH}.`;