fatfish-world-pi 0.2.0 → 0.2.3

package/README.md

@@ -1,6 +1,6 @@
 # 大肥鱼世界 for Pi
 
-> Renamed from `fightclub-pi` to **`fatfish-world-pi`** in 0.2.0.
+> Renamed from `fightclub-pi` to **`fatfish-world-pi`** in 0.2.3.
 
 Pi intentionally has no built-in MCP client. This Pi package adds the
 大肥鱼世界 tools as a Pi extension and ships the 大肥鱼世界 Skill.

package/extensions/fatfish-world.ts

@@ -41,7 +41,10 @@ class LocalMcpClient {
     const rawArgs = process.env.FATFISH_WORLD_MCP_ARGS;
     if (rawArgs) {
       const parsed = JSON.parse(rawArgs);
-      if (!Array.isArray(parsed) || parsed.some((value) => typeof value !== "string")) {
+      if (
+        !Array.isArray(parsed) ||
+        parsed.some((value) => typeof value !== "string")
+      ) {
         throw new Error("FATFISH_WORLD_MCP_ARGS must be a JSON string array");
       }
       this.args = parsed;
@@ -54,17 +57,26 @@ class LocalMcpClient {
     const child = spawn(this.command, this.args, {
       stdio: ["pipe", "pipe", "pipe"],
       env: { ...process.env },
+      // Native spawn cannot execute npx.cmd directly on Windows.
+      shell: process.platform === "win32",
     });
     this.child = child;
     const lines = createInterface({ input: child.stdout });
     lines.on("line", (line) => this.onLine(line));
-    child.stderr.on("data", (chunk) => process.stderr.write(`[fatfish-world] ${chunk}`));
+    child.stderr.on("data", (chunk) =>
+      process.stderr.write(`[fatfish-world] ${chunk}`),
+    );
     child.on("error", (error) => this.failAll(error));
     child.on("exit", (code, signal) => {
-      this.failAll(new Error(`fatfish-world exited (${code ?? signal ?? "unknown"})`));
+      this.failAll(
+        new Error(`fatfish-world exited (${code ?? signal ?? "unknown"})`),
+      );
     });
     await new Promise<void>((resolve, reject) => {
-      const timer = setTimeout(() => reject(new Error("fatfish-world did not start")), 15_000);
+      const timer = setTimeout(
+        () => reject(new Error("fatfish-world did not start")),
+        15_000,
+      );
       child.once("spawn", () => {
         clearTimeout(timer);
         resolve();
@@ -77,9 +89,13 @@ class LocalMcpClient {
     await this.request("initialize", {
       protocolVersion: "2025-06-18",
       capabilities: {},
-      clientInfo: { name: "pi-fatfish-world", version: "0.2.0" },
+      clientInfo: { name: "pi-fatfish-world", version: "0.2.3" },
+    });
+    this.write({
+      jsonrpc: "2.0",
+      method: "notifications/initialized",
+      params: {},
     });
-    this.write({ jsonrpc: "2.0", method: "notifications/initialized", params: {} });
   }
 
   async listTools(): Promise<any[]> {
@@ -87,9 +103,18 @@ class LocalMcpClient {
     return Array.isArray(result?.tools) ? result.tools : [];
   }
 
-  async callTool(name: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<any> {
+  async callTool(
+    name: string,
+    args: Record<string, unknown>,
+    signal?: AbortSignal,
+  ): Promise<any> {
     if (signal?.aborted) throw new Error("tool call aborted");
-    return await this.request("tools/call", { name, arguments: args }, 60_000, signal);
+    return await this.request(
+      "tools/call",
+      { name, arguments: args },
+      60_000,
+      signal,
+    );
   }
 
   private onLine(line: string) {
@@ -104,16 +129,23 @@ class LocalMcpClient {
     if (!pending) return;
     clearTimeout(pending.timer);
     this.pending.delete(message.id);
-    if (message.error) pending.reject(new Error(message.error.message || "MCP error"));
+    if (message.error)
+      pending.reject(new Error(message.error.message || "MCP error"));
     else pending.resolve(message.result);
   }
 
   private write(message: JsonRpc) {
-    if (!this.child?.stdin.writable) throw new Error("fatfish-world is not running");
+    if (!this.child?.stdin.writable)
+      throw new Error("fatfish-world is not running");
     this.child.stdin.write(`${JSON.stringify(message)}\n`);
   }
 
-  private request(method: string, params: unknown, timeoutMs = 15_000, signal?: AbortSignal): Promise<any> {
+  private request(
+    method: string,
+    params: unknown,
+    timeoutMs = 15_000,
+    signal?: AbortSignal,
+  ): Promise<any> {
     const id = this.nextId++;
     return new Promise((resolve, reject) => {
       const timer = setTimeout(() => {
@@ -169,11 +201,19 @@ function contentForPi(result: any) {
       return [{ type: "text" as const, text: item.text }];
     }
     if (item?.type === "image" && typeof item.data === "string") {
-      return [{ type: "image" as const, data: item.data, mimeType: item.mimeType ?? "image/png" }];
+      return [
+        {
+          type: "image" as const,
+          data: item.data,
+          mimeType: item.mimeType ?? "image/png",
+        },
+      ];
     }
     return [{ type: "text" as const, text: JSON.stringify(item) }];
   });
-  return mapped.length > 0 ? mapped : [{ type: "text" as const, text: "大肥鱼世界 returned no content." }];
+  return mapped.length > 0
+    ? mapped
+    : [{ type: "text" as const, text: "大肥鱼世界 returned no content." }];
 }
 
 export default async function fatfishWorldPi(pi: any) {
@@ -189,13 +229,22 @@ export default async function fatfishWorldPi(pi: any) {
         label: tool.title || tool.name,
         description: tool.description || `大肥鱼世界 tool: ${tool.name}`,
         parameters: tool.inputSchema ?? { type: "object", properties: {} },
-        async execute(_toolCallId: string, params: Record<string, unknown>, signal: AbortSignal) {
+        async execute(
+          _toolCallId: string,
+          params: Record<string, unknown>,
+          signal: AbortSignal,
+        ) {
           const result = await client.callTool(tool.name, params ?? {}, signal);
           if (result?.isError) {
-            const message = contentForPi(result).map((item: { text?: string }) => item.text ?? "").join("\n");
+            const message = contentForPi(result)
+              .map((item: { text?: string }) => item.text ?? "")
+              .join("\n");
             throw new Error(message || "大肥鱼世界 tool failed");
           }
-          return { content: contentForPi(result), details: { tool: tool.name } };
+          return {
+            content: contentForPi(result),
+            details: { tool: tool.name },
+          };
         },
       });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fatfish-world-pi",
-  "version": "0.2.0",
+  "version": "0.2.3",
   "description": "fatfish.world (大肥鱼世界) MCP tools and Skill for Pi coding agent.",
   "type": "module",
   "keywords": [