@alexeiled/pi-fusion 0.2.3 → 0.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alexeiled/pi-fusion",
-  "version": "0.2.3",
+  "version": "0.3.1",
   "description": "Stronger answers for hard Pi questions via a parallel model panel + judge, built on pi-subagents",
   "type": "module",
   "main": "./src/index.ts",
@@ -21,6 +21,7 @@
   ],
   "files": [
     "agents/*.md",
+    "skills/**/*.md",
     "src/*.ts",
     "docs/user-guide.md"
   ],
@@ -39,6 +40,9 @@
     "extensions": [
       "./src/index.ts"
     ],
+    "skills": [
+      "./skills"
+    ],
     "subagents": {
       "agents": [
         "./agents"

package/skills/fusion-review/SKILL.md

@@ -0,0 +1,30 @@
+---
+name: fusion-review
+description: >
+  Trigger a pi-fusion multi-model panel review implicitly. Use when the user asks to
+  "invoke fusion", "run a fusion panel", "discuss this through fusion", "get multi-model
+  opinions", "panel review", or any phrasing that implies running a parallel model review.
+  Call the start_fusion_review tool with the user's topic or prompt.
+---
+
+# Fusion Review
+
+Use the `start_fusion_review` tool to launch a fusion panel without the user needing to type `/fusion`.
+
+## When to use
+
+- "invoke fusion panel to discuss this"
+- "run fusion on this"
+- "get a panel review of …"
+- "use multi-model review for …"
+- "discuss this through fusion"
+- Any prompt that implies parallel model review or multi-perspective analysis
+
+## How to use
+
+Call `start_fusion_review` with:
+
+- `prompt` — the topic, question, or code excerpt to review (required)
+- `profile` — a named fusion profile (optional; omit to use the default)
+
+The tool queues a `/fusion` command as a follow-up, so the panel starts immediately after the current turn.

package/src/index.ts

@@ -1,4 +1,5 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { Type } from "typebox";
 import { registerFusionCommands } from "./commands.js";
 import {
   FusionOrchestrator,
@@ -7,6 +8,51 @@ import {
 import { FusionRunStore } from "./run-store.js";
 import { SubagentsRpcClient } from "./subagents-rpc.js";
 
+function registerFusionTool(
+  pi: ExtensionAPI,
+  orchestrator: FusionOrchestrator,
+): void {
+  pi.registerTool({
+    name: "start_fusion_review",
+    label: "Fusion Review",
+    description:
+      "Start a pi-fusion multi-model panel review. Use when the user asks to invoke fusion, run a panel review, get multi-model opinions, or discuss something through the fusion panel.",
+    promptSnippet: "Start a fusion panel review for a topic or code",
+    promptGuidelines: [
+      "Use start_fusion_review when the user says 'invoke fusion', 'run fusion', 'fusion panel', 'multi-model review', 'panel review', or similar.",
+    ],
+    parameters: Type.Object({
+      prompt: Type.String({ description: "What to review or discuss" }),
+      profile: Type.Optional(
+        Type.String({ description: "Fusion profile name (optional)" }),
+      ),
+    }),
+    async execute(_toolCallId, params, _signal, _onUpdate, ctx) {
+      const result = await orchestrator.startRun(
+        {
+          prompt: params.prompt,
+          ...(params.profile ? { profile: params.profile } : {}),
+        },
+        ctx,
+      );
+      const text =
+        result.status === "started"
+          ? "Fusion panel review started. The report will be posted when the panel and judge finish."
+          : result.status === "conflict"
+            ? `A fusion run is already active (${result.activeRunId}). Do not start another; wait for its report.`
+            : `Fusion review failed to start: ${result.status === "failed" ? result.error : result.status}`;
+      return {
+        content: [{ type: "text", text }],
+        details: {
+          prompt: params.prompt,
+          profile: params.profile,
+          status: result.status,
+        },
+      };
+    },
+  });
+}
+
 export default function fusionExtension(pi: ExtensionAPI): void {
   const orchestrator = new FusionOrchestrator({
     rpc: new SubagentsRpcClient({ events: pi.events }),
@@ -15,6 +61,7 @@ export default function fusionExtension(pi: ExtensionAPI): void {
   });
 
   registerFusionCommands(pi, orchestrator);
+  registerFusionTool(pi, orchestrator);
 
   const unsubscribeComplete = pi.events.on(
     SUBAGENT_ASYNC_COMPLETE_EVENT,