@vtstech/pi-react-fallback 1.0.7 → 1.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vtstech/pi-react-fallback",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "ReAct fallback extension for Pi Coding Agent",
   "main": "react-fallback.js",
   "keywords": ["pi-extensions"],
@@ -14,7 +14,7 @@
     "url": "https://github.com/VTSTech/pi-coding-agent"
   },
   "dependencies": {
-    "@vtstech/pi-shared": "1.0.7"
+    "@vtstech/pi-shared": "1.0.8"
   },
   "peerDependencies": {
     "@mariozechner/pi-coding-agent": ">=0.66"

package/react-fallback.js

@@ -1,4 +1,7 @@
 // .build-npm/react-fallback/react-fallback.temp.ts
+import os from "node:os";
+import * as fs from "node:fs";
+import * as path from "node:path";
 import { section, ok, fail, warn, info } from "@vtstech/pi-shared/format";
 function sanitizeModelJson(text) {
   text = text.replace(/:\s*True\b/g, ": true");
@@ -273,82 +276,103 @@ function looksLikeSchemaDump(text) {
   const matches = indicators.filter((i) => lower.includes(i.toLowerCase())).length;
   return matches >= 2;
 }
+var REACT_CONFIG_PATH = path.join(os.homedir(), ".pi", "agent", "react-mode.json");
+function readReactConfig() {
+  try {
+    if (fs.existsSync(REACT_CONFIG_PATH)) {
+      const raw = JSON.parse(fs.readFileSync(REACT_CONFIG_PATH, "utf-8"));
+      if (typeof raw.enabled === "boolean") return raw;
+    }
+  } catch {
+  }
+  return { enabled: false };
+}
+function writeReactConfig(config) {
+  const dir = path.dirname(REACT_CONFIG_PATH);
+  if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+  fs.writeFileSync(REACT_CONFIG_PATH, JSON.stringify(config, null, 2) + "\n", "utf-8");
+}
 function react_fallback_temp_default(pi2) {
-  let reactModeEnabled = false;
+  let reactModeEnabled = readReactConfig().enabled;
   let stats = { bridgeCalls: 0, fuzzyMatches: 0, argNormalizations: 0, parseFailures: 0 };
   const branding = [
-    `  \u26A1 Pi ReAct Fallback Extension v1.0.7`,
+    `  \u26A1 Pi ReAct Fallback Extension v1.0.8`,
     `  Written by VTSTech`,
     `  GitHub: https://github.com/VTSTech`,
     `  Website: www.vts-tech.org`
   ].join("\n");
-  pi2.registerTool({
-    name: "tool_call",
-    label: "Universal Tool Call",
-    description: `Universal tool call bridge. Use this to call any available tool by specifying its name and arguments as JSON.
+  function registerBridgeTool() {
+    pi2.registerTool({
+      name: "tool_call",
+      label: "Universal Tool Call",
+      description: `Universal tool call bridge. Use this to call any available tool by specifying its name and arguments as JSON.
 
 To use: call tool_call with:
 - name: the exact tool name (e.g. "bash", "read", "write", "edit")
 - arguments: a JSON string of the tool's arguments (e.g. '{"command": "ls -la"}')
 
 The bridge will match your tool name (fuzzy matching supported) and normalize argument names automatically.`,
-    promptSnippet: "tool_call - universal bridge for calling any tool",
-    promptGuidelines: [
-      "When you need to use a tool but are unsure of the exact name, use tool_call with the tool name and arguments.",
-      `Example: tool_call(name='bash', arguments='{"command": "ls -la"}')`
-    ],
-    parameters: {
-      type: "object",
-      properties: {
-        name: { type: "string", description: "Name of the tool to call (fuzzy matching supported)" },
-        arguments: { type: "string", description: "Tool arguments as a JSON object string" }
+      promptSnippet: "tool_call - universal bridge for calling any tool",
+      promptGuidelines: [
+        "When you need to use a tool but are unsure of the exact name, use tool_call with the tool name and arguments.",
+        `Example: tool_call(name='bash', arguments='{"command": "ls -la"}')`
+      ],
+      parameters: {
+        type: "object",
+        properties: {
+          name: { type: "string", description: "Name of the tool to call (fuzzy matching supported)" },
+          arguments: { type: "string", description: "Tool arguments as a JSON object string" }
+        },
+        required: ["name", "arguments"]
       },
-      required: ["name", "arguments"]
-    },
-    execute: async (toolCallId, params, signal, onUpdate, ctx) => {
-      const p = params;
-      const requestedName = p.name || "";
-      const argsStr = p.arguments || "{}";
-      stats.bridgeCalls++;
-      let args;
-      try {
-        args = JSON.parse(argsStr);
-        if (typeof args !== "object" || args === null || Array.isArray(args)) {
+      execute: async (toolCallId, params, signal, onUpdate, ctx) => {
+        const p = params;
+        const requestedName = p.name || "";
+        const argsStr = p.arguments || "{}";
+        stats.bridgeCalls++;
+        let args;
+        try {
+          args = JSON.parse(argsStr);
+          if (typeof args !== "object" || args === null || Array.isArray(args)) {
+            args = { input: argsStr };
+          }
+        } catch {
           args = { input: argsStr };
         }
-      } catch {
-        args = { input: argsStr };
-      }
-      const allTools = pi2.getAllTools();
-      let targetToolName = null;
-      if (allTools.includes(requestedName)) {
-        targetToolName = requestedName;
-      } else {
-        targetToolName = fuzzyMatchToolName(requestedName, allTools);
-        if (targetToolName) stats.fuzzyMatches++;
-      }
-      if (!targetToolName) {
-        stats.parseFailures++;
+        const allTools = pi2.getAllTools();
+        let targetToolName = null;
+        if (allTools.includes(requestedName)) {
+          targetToolName = requestedName;
+        } else {
+          targetToolName = fuzzyMatchToolName(requestedName, allTools);
+          if (targetToolName) stats.fuzzyMatches++;
+        }
+        if (!targetToolName) {
+          stats.parseFailures++;
+          return {
+            content: [{ type: "text", text: `Error: Unknown tool "${requestedName}". Available tools: ${allTools.join(", ")}` }],
+            isError: true
+          };
+        }
+        const normalizedArgs = Object.keys(args).length > 0 ? args : {};
+        stats.argNormalizations++;
+        const argsJson = JSON.stringify(normalizedArgs);
         return {
-          content: [{ type: "text", text: `Error: Unknown tool "${requestedName}". Available tools: ${allTools.join(", ")}` }],
-          isError: true
-        };
-      }
-      const normalizedArgs = Object.keys(args).length > 0 ? args : {};
-      stats.argNormalizations++;
-      const argsJson = JSON.stringify(normalizedArgs);
-      return {
-        content: [{
-          type: "text",
-          text: `[ReAct Bridge] Tool resolved: ${requestedName} \u2192 ${targetToolName}${targetToolName !== requestedName ? " (fuzzy matched)" : ""}
+          content: [{
+            type: "text",
+            text: `[ReAct Bridge] Tool resolved: ${requestedName} \u2192 ${targetToolName}${targetToolName !== requestedName ? " (fuzzy matched)" : ""}
 
 Please call ${targetToolName} with these arguments:
 ${argsJson}`
-        }],
-        isError: false
-      };
-    }
-  });
+          }],
+          isError: false
+        };
+      }
+    });
+  }
+  if (reactModeEnabled) {
+    registerBridgeTool();
+  }
   pi2.on("context", (event) => {
     if (!reactModeEnabled) return;
     const model = event.messages;
@@ -367,18 +391,25 @@ ${argsJson}`
     description: "Toggle ReAct fallback mode for models without native tool calling",
     handler: async (_args, ctx) => {
       reactModeEnabled = !reactModeEnabled;
+      writeReactConfig({ enabled: reactModeEnabled });
       const status = reactModeEnabled ? "ENABLED" : "DISABLED";
       ctx.ui.notify(`ReAct mode ${status}`, "success");
       const lines = [branding];
       lines.push(section("REACT FALLBACK MODE"));
       lines.push(info(`Status: ${status}`));
+      lines.push(info(`Config: ${REACT_CONFIG_PATH}`));
       lines.push(info(`Bridge calls: ${stats.bridgeCalls}`));
       lines.push(info(`Fuzzy matches: ${stats.fuzzyMatches}`));
       lines.push(info(`Argument normalizations: ${stats.argNormalizations}`));
       lines.push(info(`Parse failures: ${stats.parseFailures}`));
       if (reactModeEnabled) {
+        registerBridgeTool();
         lines.push(ok("The tool_call bridge tool is now available to the model"));
         lines.push(info("ReAct system prompt instructions have been added"));
+        lines.push(info("Run /reload to make the bridge tool available to the current model"));
+      } else {
+        lines.push(warn("The tool_call bridge tool has been unregistered"));
+        lines.push(info("Run /reload to remove the tool from the current model"));
       }
       const report = lines.join("\n");
       pi2.sendMessage({