@the-forge-flow/visual-explainer-pi 0.1.1 → 0.2.0

package/README.md

@@ -76,13 +76,15 @@ pi config  # enable/disable individual extensions, skills, prompts, themes
 
 ## 🚀 Usage
 
-The extension registers a single `generate_visual` tool that the LLM can call directly. It also exposes two slash commands to reopen recently generated files.
+The extension registers a single `tff-generate_visual` tool that the LLM can call directly. It also exposes two slash commands to reopen recently generated files.
 
-### `generate_visual`
+> The tool id is namespaced with the `tff-` prefix so it can coexist with other pi packages that might ship a tool named `generate_visual`. The user-facing display label ("Generate Visual") stays readable — only the LLM-facing id is prefixed.
+
+### `tff-generate_visual`
 
 ```typescript
 // Render a technical architecture diagram
-generate_visual({
+tff-generate_visual({
   type: "architecture",
   title: "Auth System Overview",
   aesthetic: "blueprint",
@@ -95,7 +97,7 @@ generate_visual({
 });
 
 // Render a Mermaid flowchart
-generate_visual({
+tff-generate_visual({
   type: "flowchart",
   title: "Data Pipeline",
   aesthetic: "editorial",
@@ -103,7 +105,7 @@ generate_visual({
 });
 
 // Render a comparison table
-generate_visual({
+tff-generate_visual({
   type: "table",
   title: "API Endpoints",
   aesthetic: "paper",
@@ -138,7 +140,7 @@ Generated HTML files are saved to `~/.agent/diagrams/` and automatically opened
 
 ```
 ┌─────────────┐     ┌──────────────────┐     ┌─────────────┐
-│  LLM Request│────▶│ generate_visual  │────▶│   Browser   │
+│  LLM Request│────▶│tff-generate_visual│───▶│   Browser   │
 │  (via PI)   │     │  (defineTool)    │     │   (HTML)    │
 └─────────────┘     └────────┬─────────┘     └─────────────┘
                              │

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA+JlE;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,EAAE,EAAE,YAAY,QA6IhE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AA+JlE;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,wBAAwB,CAAC,EAAE,EAAE,YAAY,QAiJhE"}

package/dist/index.js

@@ -122,9 +122,13 @@ export default function visualExplainerExtension(pi) {
             ctx.ui.notify("Visual explainer ready", "info");
         }
     });
-    // Register generate_visual tool
+    // Register tff-generate_visual tool
     const generateVisualTool = defineTool({
-        name: "generate_visual",
+        // Namespaced with the tff- prefix so it can coexist with other pi
+        // packages that might ship a tool named "generate_visual". The
+        // user-facing display label ("Generate Visual") stays readable;
+        // only the LLM-facing tool id carries the prefix.
+        name: "tff-generate_visual",
         label: "Generate Visual",
         description: "Generate beautiful, self-contained HTML pages for diagrams, architecture overviews, diff reviews, data tables, and visual explanations. Opens result in browser. Based on nicobailon/visual-explainer design principles.",
         promptSnippet: "Create a visual diagram/architecture/table",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@the-forge-flow/visual-explainer-pi",
-	"version": "0.1.1",
+	"version": "0.2.0",
 	"description": "PI extension for generating beautiful HTML visualizations of diagrams, architecture, and data",
 	"type": "module",
 	"main": "dist/index.js",