pi-sage 0.2.0 → 0.2.2

package/.pi/extensions/sage/index.ts

@@ -45,7 +45,8 @@ const SAGE_GUIDANCE = [
   "Do not overuse Sage for routine edits.",
   "Sage is advisory-only: treat output as recommendations and implement changes yourself.",
   "Use one focused Sage question per consultation.",
-  "If user explicitly requests Sage/second opinion, prefer at least one Sage consultation unless blocked by hard safety limits."
+  "If user explicitly requests Sage/second opinion, prefer at least one Sage consultation unless blocked by hard safety limits.",
+  "For `sage_consult` params: `objective` is optional and must be one of debug|design|review|refactor|general (omit if unsure); `urgency` is optional and must be low|medium|high."
 ].join("\n- ");
 
 export default function registerSageExtension(pi: ExtensionAPI): void {
@@ -99,6 +100,8 @@ export default function registerSageExtension(pi: ExtensionAPI): void {
     promptGuidelines: [
       "Use Sage for high-impact ambiguous tasks or explicit second-opinion requests.",
       "Set force=true when the user explicitly asks for Sage to bypass soft limits.",
+      "`objective` is optional: debug|design|review|refactor|general. Omit instead of free text.",
+      "`urgency` is optional: low|medium|high.",
       "After Sage returns, synthesize recommendations and continue execution."
     ],
     parameters: Type.Object({
@@ -107,16 +110,21 @@ export default function registerSageExtension(pi: ExtensionAPI): void {
       files: Type.Optional(Type.Array(Type.String(), { description: "Relevant file paths" })),
       evidence: Type.Optional(Type.Array(Type.String(), { description: "Logs, errors, or observations" })),
       objective: Type.Optional(
-        Type.Union([
-          Type.Literal("debug"),
-          Type.Literal("design"),
-          Type.Literal("review"),
-          Type.Literal("refactor"),
-          Type.Literal("general")
-        ])
+        Type.Union(
+          [
+            Type.Literal("debug"),
+            Type.Literal("design"),
+            Type.Literal("review"),
+            Type.Literal("refactor"),
+            Type.Literal("general")
+          ],
+          { description: "Optional objective: debug | design | review | refactor | general" }
+        )
       ),
       urgency: Type.Optional(
-        Type.Union([Type.Literal("low"), Type.Literal("medium"), Type.Literal("high")])
+        Type.Union([Type.Literal("low"), Type.Literal("medium"), Type.Literal("high")], {
+          description: "Optional urgency: low | medium | high"
+        })
       ),
       force: Type.Optional(
         Type.Boolean({ description: "Bypass soft limits for explicit user-requested consultations" })

package/.pi/extensions/sage/runner.ts

@@ -257,8 +257,12 @@ export async function runSageSingleShot(input: SageRunnerInput): Promise<SageRun
     throw new Error(`Sage subprocess failed (code ${String(exit.code)}): ${stderrBuffer.trim() || "no stderr"}`);
   }
 
+  if (assistantText.trim().length === 0) {
+    throw new Error(`Sage subprocess returned no assistant text (code ${String(exit.code)}): ${stderrBuffer.trim() || "no stderr"}`);
+  }
+
   return {
-    text: assistantText.trim().length > 0 ? assistantText : `Sage returned no assistant text.${EOL}${stderrBuffer.trim()}`,
+    text: assistantText,
     latencyMs,
     stopReason,
     usage,
@@ -311,6 +315,9 @@ function buildPiArgs(model: string, reasoningLevel: ReasoningLevel, cliTools: st
     "-p",
     "--no-session",
     "--no-extensions",
+    "--no-skills",
+    "--no-prompt-templates",
+    "--no-themes",
     "--model",
     model,
     "--thinking",

package/README.md

@@ -17,13 +17,13 @@ Interactive-only advisory Sage extension for Pi.
 ### Global install (all projects)
 
 ```bash
-pi install pi-sage
+pi install npm:pi-sage
 ```
 
 ### Project-local install (current project only)
 
 ```bash
-pi install -l pi-sage
+pi install -l npm:pi-sage
 ```
 
 Then in Pi run:
@@ -91,3 +91,12 @@ Project settings always override global settings for that project.
 
 Package name `sage` is already taken on npm.
 `pi-sage` is currently available and is the intended publish name.
+
+## Install troubleshooting
+
+If `pi install pi-sage` fails with a local-path error (for example `Path does not exist: .../pi-sage`), your Pi version is interpreting bare names as local paths.
+Use the explicit npm source form instead:
+
+```bash
+pi install npm:pi-sage
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-sage",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "private": false,
   "type": "module",
   "description": "Interactive-only advisory Sage extension for Pi",