@aliou/pi-synthetic 0.18.1 → 0.18.2

package/README.md

@@ -41,7 +41,7 @@ pi install npm:@aliou/pi-synthetic
 pi install git:github.com/aliou/pi-synthetic
 
 # Local development
-pi -e ./src/index.ts
+pi -e .
 ```
 
 ## Usage
@@ -165,7 +165,7 @@ pnpm run test
 ### Test Locally
 
 ```bash
-pi -e ./src/index.ts
+pi -e .
 ```
 
 ## Release
@@ -180,7 +180,7 @@ This repository uses [Changesets](https://github.com/changesets/changesets) for
 
 ## Requirements
 
-- Pi coding agent v0.72.0+
+- Pi coding agent v0.77.0+
 - Synthetic API key (configured in `~/.pi/agent/auth.json` or via `SYNTHETIC_API_KEY`)
 
 ## Links

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliou/pi-synthetic",
-  "version": "0.18.1",
+  "version": "0.18.2",
   "license": "MIT",
   "type": "module",
   "private": false,
@@ -33,8 +33,9 @@
     "!src/**/*.test.ts"
   ],
   "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "0.74.0",
-    "@earendil-works/pi-tui": "0.74.0"
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*",
+    "typebox": "*"
   },
   "dependencies": {
     "@aliou/pi-utils-settings": "^0.15.0",
@@ -44,12 +45,13 @@
     "@aliou/biome-plugins": "^0.8.1",
     "@biomejs/biome": "^2.4.15",
     "@changesets/cli": "^2.27.11",
-    "@earendil-works/pi-coding-agent": "0.74.0",
+    "@earendil-works/pi-coding-agent": "0.77.0",
     "typebox": "^1.1.37",
     "@types/node": "^25.0.10",
     "husky": "^9.1.7",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.18"
+    "vitest": "^4.0.18",
+    "@earendil-works/pi-tui": "0.77.0"
   },
   "peerDependenciesMeta": {
     "@earendil-works/pi-coding-agent": {
@@ -57,6 +59,9 @@
     },
     "@earendil-works/pi-tui": {
       "optional": true
+    },
+    "typebox": {
+      "optional": true
     }
   },
   "scripts": {

package/src/extensions/provider/index.ts

@@ -80,7 +80,7 @@ export function registerSyntheticProvider(
 ): void {
   pi.registerProvider("synthetic", {
     baseUrl: "https://api.synthetic.new/openai/v1",
-    apiKey: "SYNTHETIC_API_KEY",
+    apiKey: "$SYNTHETIC_API_KEY",
     api: "openai-completions",
     headers: {
       Referer: "https://pi.dev",

package/src/extensions/provider/models.ts

@@ -51,11 +51,11 @@ export const SYNTHETIC_MODELS: SyntheticModelEntry[] = [
     name: "syn:large:vision",
     aliasFor: "hf:moonshotai/Kimi-K2.6",
   },
-  // API: syn:small:vision → alias for hf:moonshotai/Kimi-K2.6
+  // API: syn:small:vision → alias for hf:Qwen/Qwen3.6-27B
   {
     id: "syn:small:vision",
     name: "syn:small:vision",
-    aliasFor: "hf:moonshotai/Kimi-K2.6",
+    aliasFor: "hf:Qwen/Qwen3.6-27B",
   },
   // API: hf:zai-org/GLM-4.7 → ctx=202752
   {
@@ -84,33 +84,6 @@ export const SYNTHETIC_MODELS: SyntheticModelEntry[] = [
     contextWindow: 202752,
     maxTokens: 65536,
   },
-  // API: hf:zai-org/GLM-5 → ctx=196608, out=65536
-  {
-    id: "hf:zai-org/GLM-5",
-    name: "zai-org/GLM-5",
-    provider: "synthetic",
-    reasoning: true,
-    thinkingLevelMap: {
-      off: "none",
-      minimal: null,
-      low: null,
-      medium: "medium",
-      high: null,
-      xhigh: null,
-    },
-    compat: {
-      supportsReasoningEffort: true,
-    },
-    input: ["text"],
-    cost: {
-      input: 1,
-      output: 3,
-      cacheRead: 1,
-      cacheWrite: 0,
-    },
-    contextWindow: 196608,
-    maxTokens: 65536,
-  },
   // API: hf:zai-org/GLM-5.1 → ctx=196608, out=65536
   {
     id: "hf:zai-org/GLM-5.1",
@@ -166,33 +139,6 @@ export const SYNTHETIC_MODELS: SyntheticModelEntry[] = [
     contextWindow: 196608,
     maxTokens: 65536,
   },
-  // models.dev: synthetic/hf:deepseek-ai/DeepSeek-V3.2 → ctx=162816, out=8000
-  {
-    id: "hf:deepseek-ai/DeepSeek-V3.2",
-    name: "deepseek-ai/DeepSeek-V3.2",
-    provider: "fireworks",
-    reasoning: true,
-    thinkingLevelMap: {
-      off: "none",
-      minimal: null,
-      low: null,
-      medium: "medium",
-      high: null,
-      xhigh: null,
-    },
-    compat: {
-      supportsReasoningEffort: true,
-    },
-    input: ["text"],
-    cost: {
-      input: 0.56,
-      output: 1.68,
-      cacheRead: 0.56,
-      cacheWrite: 0,
-    },
-    contextWindow: 162816,
-    maxTokens: 8000,
-  },
   // models.dev: synthetic/hf:openai/gpt-oss-120b → ctx=128000, out=32768
   {
     id: "hf:openai/gpt-oss-120b",
@@ -279,6 +225,33 @@ export const SYNTHETIC_MODELS: SyntheticModelEntry[] = [
     contextWindow: 262144,
     maxTokens: 65536,
   },
+  // API: hf:Qwen/Qwen3.6-27B → ctx=262144, out=65536
+  {
+    id: "hf:Qwen/Qwen3.6-27B",
+    name: "Qwen/Qwen3.6-27B",
+    provider: "synthetic",
+    reasoning: true,
+    thinkingLevelMap: {
+      off: "none",
+      minimal: null,
+      low: null,
+      medium: "medium",
+      high: null,
+      xhigh: null,
+    },
+    compat: {
+      supportsReasoningEffort: true,
+    },
+    input: ["text", "image"],
+    cost: {
+      input: 0.45,
+      output: 3.6,
+      cacheRead: 0.45,
+      cacheWrite: 0,
+    },
+    contextWindow: 262144,
+    maxTokens: 65536,
+  },
   // API: hf:MiniMaxAI/MiniMax-M2.5 → ctx=191488, out=65536
   {
     id: "hf:MiniMaxAI/MiniMax-M2.5",

package/src/extensions/web-search/tool.ts

@@ -3,16 +3,11 @@ import { writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
 import { ToolCallHeader, ToolFooter } from "@aliou/pi-utils-ui";
-import type {
-  AgentToolResult,
-  ExtensionAPI,
-  ExtensionContext,
-  Theme,
-  ToolRenderResultOptions,
-} from "@earendil-works/pi-coding-agent";
+import type { ExtensionAPI, Theme } from "@earendil-works/pi-coding-agent";
 import {
   DEFAULT_MAX_BYTES,
   DEFAULT_MAX_LINES,
+  defineTool,
   formatSize,
   keyHint,
   truncateHead,
@@ -60,261 +55,248 @@ const SearchParams = Type.Object({
 
 type SearchParamsType = Static<typeof SearchParams>;
 
-export function registerSyntheticWebSearchTool(pi: ExtensionAPI): void {
-  pi.registerTool<typeof SearchParams, WebSearchDetails>({
-    name: SYNTHETIC_WEB_SEARCH_TOOL,
-    label: "Synthetic: Web Search",
-    description: `Search the web using Synthetic's zero-data-retention API. Returns search results with titles, URLs, content snippets, and publication dates. Use for finding documentation, articles, recent information, or any web content. Results are fresh and not cached by Synthetic. Results are truncated to ${DEFAULT_MAX_LINES} lines or ${formatSize(DEFAULT_MAX_BYTES)} (whichever is hit first). If truncated, full output is saved to a temp file.`,
-    promptSnippet: "Search the web using Synthetic's zero-data-retention API",
-    promptGuidelines: [
-      "Use synthetic_web_search for finding documentation, articles, recent information, or any web content.",
-      "Write specific queries with names, dates, versions, or locations for synthetic_web_search.",
-      "synthetic_web_search results are fresh and not cached by Synthetic.",
-    ],
-    parameters: SearchParams,
-
-    async execute(
-      _toolCallId: string,
-      params: SearchParamsType,
-      signal: AbortSignal | undefined,
-      onUpdate:
-        | ((result: AgentToolResult<WebSearchDetails>) => void)
-        | undefined,
-      ctx: ExtensionContext,
-    ): Promise<AgentToolResult<WebSearchDetails>> {
-      onUpdate?.({
-        content: [{ type: "text", text: "Searching..." }],
-        details: { query: params.query },
+export const syntheticWebSearchTool = defineTool({
+  name: SYNTHETIC_WEB_SEARCH_TOOL,
+  label: "Synthetic: Web Search",
+  description: `Search the web using Synthetic's zero-data-retention API. Returns search results with titles, URLs, content snippets, and publication dates. Use for finding documentation, articles, recent information, or any web content. Results are fresh and not cached by Synthetic. Results are truncated to ${DEFAULT_MAX_LINES} lines or ${formatSize(DEFAULT_MAX_BYTES)} (whichever is hit first). If truncated, full output is saved to a temp file.`,
+  promptSnippet: "Search the web using Synthetic's zero-data-retention API",
+  promptGuidelines: [
+    "Use synthetic_web_search for finding documentation, articles, recent information, or any web content.",
+    "Write specific queries with names, dates, versions, or locations for synthetic_web_search.",
+    "synthetic_web_search results are fresh and not cached by Synthetic.",
+  ],
+  parameters: SearchParams,
+
+  async execute(_toolCallId, params, signal, onUpdate, ctx) {
+    onUpdate?.({
+      content: [{ type: "text", text: "Searching..." }],
+      details: { query: params.query },
+    });
+
+    if (!configLoader.getConfig().webSearch) {
+      throw new Error(
+        "Synthetic web search is disabled. Re-enable it with synthetic:settings or pi config.",
+      );
+    }
+
+    const apiKey = await getSyntheticApiKey(ctx.modelRegistry.authStorage);
+    if (!apiKey) {
+      throw new Error(
+        "Synthetic web search requires a Synthetic subscription. Add credentials to ~/.pi/agent/auth.json or set SYNTHETIC_API_KEY environment variable.",
+      );
+    }
+
+    const response = await fetch("https://api.synthetic.new/v2/search", {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({ query: params.query }),
+      signal,
+    });
+
+    if (!response.ok) {
+      const errorText = await response.text();
+      throw new Error(`Search API error: ${response.status} ${errorText}`);
+    }
+
+    let data: SyntheticSearchResponse;
+    try {
+      data = await response.json();
+    } catch (parseError) {
+      throw new Error(
+        parseError instanceof Error
+          ? `Failed to parse search results: ${parseError.message}`
+          : "Failed to parse search results",
+      );
+    }
+
+    let content = `Found ${data.results.length} result(s):\n\n`;
+    const resultDetails: WebSearchResultDetails[] = [];
+
+    for (let i = 0; i < data.results.length; i++) {
+      const result = data.results[i];
+      const slug = result.title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/(^-|-$)/g, "")
+        .slice(0, 40);
+      const truncation = truncateHead(result.text, {
+        maxLines: DEFAULT_MAX_LINES,
+        maxBytes: DEFAULT_MAX_BYTES,
       });
 
-      if (!configLoader.getConfig().webSearch) {
-        throw new Error(
-          "Synthetic web search is disabled. Re-enable it with synthetic:settings or pi config.",
-        );
-      }
+      let preview = truncation.content;
+      let tempFilePath: string | undefined;
 
-      const apiKey = await getSyntheticApiKey(ctx.modelRegistry.authStorage);
-      if (!apiKey) {
-        throw new Error(
-          "Synthetic web search requires a Synthetic subscription. Add credentials to ~/.pi/agent/auth.json or set SYNTHETIC_API_KEY environment variable.",
+      if (truncation.truncated) {
+        tempFilePath = join(
+          tmpdir(),
+          `pi-synthetic-search-${slug}-${randomBytes(4).toString("hex")}.md`,
         );
+        await writeFile(tempFilePath, result.text, "utf8");
+        preview += `\n\n[Result truncated: ${truncation.outputLines} of ${truncation.totalLines} lines (${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)}). Full result: ${tempFilePath}]`;
       }
 
-      const response = await fetch("https://api.synthetic.new/v2/search", {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${apiKey}`,
-          "Content-Type": "application/json",
-        },
-        body: JSON.stringify({ query: params.query }),
-        signal,
+      content += `## ${result.title}\n`;
+      content += `URL: ${result.url}\n`;
+      content += `Published: ${result.published}\n`;
+      content += `\n${preview}\n`;
+      content += "\n---\n\n";
+
+      resultDetails.push({
+        title: result.title,
+        url: result.url,
+        published: result.published,
+        truncated: truncation.truncated,
+        tempFilePath,
+        totalLines: truncation.totalLines,
+        totalBytes: truncation.totalBytes,
+        outputLines: truncation.outputLines,
+        outputBytes: truncation.outputBytes,
       });
+    }
+
+    return {
+      content: [{ type: "text", text: content }],
+      details: {
+        results: resultDetails,
+        query: params.query,
+      },
+    };
+  },
+
+  renderCall(args: SearchParamsType, theme: Theme) {
+    return new ToolCallHeader(
+      {
+        toolName: "Synthetic: WebSearch",
+        mainArg: `"${args.query}"`,
+        showColon: true,
+      },
+      theme,
+    );
+  },
+
+  renderResult(result, options, theme: Theme) {
+    const { expanded, isPartial } = options;
+
+    if (isPartial) {
+      return new Text(
+        theme.fg("muted", "Synthetic: WebSearch: fetching..."),
+        0,
+        0,
+      );
+    }
+
+    const details = result.details as WebSearchDetails | undefined;
+    const results = details?.results || [];
+    const container = new Container();
+
+    // When the tool throws, the framework calls renderResult with
+    // details={} (empty object) and the error message in content.
+    // Detect this by checking for missing results in details.
+    if (!details?.results) {
+      const textBlock = result.content.find((c) => c.type === "text");
+      const errorMsg =
+        (textBlock?.type === "text" && textBlock.text) || "Search failed";
+      container.addChild(new Text(theme.fg("error", errorMsg), 0, 0));
+      return container;
+    }
 
-      if (!response.ok) {
-        const errorText = await response.text();
-        throw new Error(`Search API error: ${response.status} ${errorText}`);
-      }
+    const hasTruncation = results.some((r) => r.truncated);
 
-      let data: SyntheticSearchResponse;
-      try {
-        data = await response.json();
-      } catch (parseError) {
-        throw new Error(
-          parseError instanceof Error
-            ? `Failed to parse search results: ${parseError.message}`
-            : "Failed to parse search results",
-        );
+    if (results.length === 0) {
+      container.addChild(
+        new Text(theme.fg("muted", "Synthetic: WebSearch: no results"), 0, 0),
+      );
+    } else if (!expanded) {
+      // Collapsed: show result count + first result title
+      let text = theme.fg("success", `Found ${results.length} result(s)`);
+      if (hasTruncation) {
+        text += theme.fg("warning", " (truncated)");
       }
-
-      let content = `Found ${data.results.length} result(s):\n\n`;
-      const resultDetails: WebSearchResultDetails[] = [];
-
-      for (let i = 0; i < data.results.length; i++) {
-        const result = data.results[i];
-        const slug = result.title
-          .toLowerCase()
-          .replace(/[^a-z0-9]+/g, "-")
-          .replace(/(^-|-$)/g, "")
-          .slice(0, 40);
-        const truncation = truncateHead(result.text, {
-          maxLines: DEFAULT_MAX_LINES,
-          maxBytes: DEFAULT_MAX_BYTES,
-        });
-
-        let preview = truncation.content;
-        let tempFilePath: string | undefined;
-
-        if (truncation.truncated) {
-          tempFilePath = join(
-            tmpdir(),
-            `pi-synthetic-search-${slug}-${randomBytes(4).toString("hex")}.md`,
-          );
-          await writeFile(tempFilePath, result.text, "utf8");
-          preview += `\n\n[Result truncated: ${truncation.outputLines} of ${truncation.totalLines} lines (${formatSize(truncation.outputBytes)} of ${formatSize(truncation.totalBytes)}). Full result: ${tempFilePath}]`;
+      const first = results[0];
+      if (first) {
+        text += `\n  ${theme.fg("dim", first.title)}`;
+        if (results.length > 1) {
+          text += theme.fg("dim", ` (+${results.length - 1} more)`);
         }
-
-        content += `## ${result.title}\n`;
-        content += `URL: ${result.url}\n`;
-        content += `Published: ${result.published}\n`;
-        content += `\n${preview}\n`;
-        content += "\n---\n\n";
-
-        resultDetails.push({
-          title: result.title,
-          url: result.url,
-          published: result.published,
-          truncated: truncation.truncated,
-          tempFilePath,
-          totalLines: truncation.totalLines,
-          totalBytes: truncation.totalBytes,
-          outputLines: truncation.outputLines,
-          outputBytes: truncation.outputBytes,
-        });
       }
-
-      return {
-        content: [{ type: "text", text: content }],
-        details: {
-          results: resultDetails,
-          query: params.query,
-        },
-      };
-    },
-
-    renderCall(args: SearchParamsType, theme: Theme) {
-      return new ToolCallHeader(
-        {
-          toolName: "Synthetic: WebSearch",
-          mainArg: `"${args.query}"`,
-          showColon: true,
-        },
-        theme,
-      );
-    },
-
-    renderResult(
-      result: AgentToolResult<WebSearchDetails>,
-      options: ToolRenderResultOptions,
-      theme: Theme,
-    ) {
-      const { expanded, isPartial } = options;
-
-      if (isPartial) {
-        return new Text(
-          theme.fg("muted", "Synthetic: WebSearch: fetching..."),
+      text += theme.fg("muted", ` ${keyHint("app.tools.expand", "to expand")}`);
+      container.addChild(new Text(text, 0, 0));
+    } else {
+      // Expanded: show each result with title, URL, date, and snippet
+      container.addChild(
+        new Text(
+          theme.fg("success", `Found ${results.length} result(s)`),
           0,
           0,
-        );
-      }
-
-      const details = result.details;
-      const results = details?.results || [];
-      const container = new Container();
-
-      // When the tool throws, the framework calls renderResult with
-      // details={} (empty object) and the error message in content.
-      // Detect this by checking for missing results in details.
-      if (!details?.results) {
-        const textBlock = result.content.find((c) => c.type === "text");
-        const errorMsg =
-          (textBlock?.type === "text" && textBlock.text) || "Search failed";
-        container.addChild(new Text(theme.fg("error", errorMsg), 0, 0));
-        return container;
-      }
-
-      const hasTruncation = results.some((r) => r.truncated);
+        ),
+      );
 
-      if (results.length === 0) {
-        container.addChild(
-          new Text(theme.fg("muted", "Synthetic: WebSearch: no results"), 0, 0),
-        );
-      } else if (!expanded) {
-        // Collapsed: show result count + first result title
-        let text = theme.fg("success", `Found ${results.length} result(s)`);
-        if (hasTruncation) {
-          text += theme.fg("warning", " (truncated)");
-        }
-        const first = results[0];
-        if (first) {
-          text += `\n  ${theme.fg("dim", first.title)}`;
-          if (results.length > 1) {
-            text += theme.fg("dim", ` (+${results.length - 1} more)`);
-          }
-        }
-        text += theme.fg(
-          "muted",
-          ` ${keyHint("app.tools.expand", "to expand")}`,
-        );
-        container.addChild(new Text(text, 0, 0));
-      } else {
-        // Expanded: show each result with title, URL, date, and snippet
+      for (const r of results) {
+        container.addChild(new Text("", 0, 0));
         container.addChild(
           new Text(
-            theme.fg("success", `Found ${results.length} result(s)`),
+            `${theme.fg("dim", ">")} ${theme.fg("accent", theme.bold(r.title))}`,
             0,
             0,
           ),
         );
+        container.addChild(new Text(`  ${theme.fg("dim", r.url)}`, 0, 0));
+        if (r.published) {
+          container.addChild(
+            new Text(
+              `  ${theme.fg("muted", `Published: ${r.published}`)}`,
+              0,
+              0,
+            ),
+          );
+        }
 
-        for (const r of results) {
-          container.addChild(new Text("", 0, 0));
+        if (r.truncated) {
           container.addChild(
             new Text(
-              `${theme.fg("dim", ">")} ${theme.fg("accent", theme.bold(r.title))}`,
+              `  ${theme.fg("warning", `Truncated: ${r.outputLines} of ${r.totalLines} lines (${formatSize(r.outputBytes)} of ${formatSize(r.totalBytes)}). Full content: ${r.tempFilePath}`)}`,
               0,
               0,
             ),
           );
-          container.addChild(new Text(`  ${theme.fg("dim", r.url)}`, 0, 0));
-          if (r.published) {
-            container.addChild(
-              new Text(
-                `  ${theme.fg("muted", `Published: ${r.published}`)}`,
-                0,
-                0,
-              ),
-            );
-          }
-
-          if (r.truncated) {
-            container.addChild(
-              new Text(
-                `  ${theme.fg("warning", `Truncated: ${r.outputLines} of ${r.totalLines} lines (${formatSize(r.outputBytes)} of ${formatSize(r.totalBytes)}). Full content: ${r.tempFilePath}`)}`,
-                0,
-                0,
-              ),
-            );
-          }
         }
       }
-
-      const footerItems: { label: string; value: string }[] = [];
+    }
+
+    const footerItems: { label: string; value: string }[] = [];
+    footerItems.push({
+      label: "results",
+      value: `${results.length} result(s)`,
+    });
+    if (hasTruncation) {
+      const truncatedCount = results.filter((r) => r.truncated).length;
       footerItems.push({
-        label: "results",
-        value: `${results.length} result(s)`,
+        label: "truncated",
+        value: `${truncatedCount}`,
       });
-      if (hasTruncation) {
-        const truncatedCount = results.filter((r) => r.truncated).length;
-        footerItems.push({
-          label: "truncated",
-          value: `${truncatedCount}`,
-        });
-      }
-      if (!expanded) {
-        footerItems.push({
-          label: "",
-          value: keyHint("app.tools.expand", "to expand"),
-        });
-      }
-      container.addChild(new Text("", 0, 0));
-      container.addChild(
-        new ToolFooter(theme, {
-          items: footerItems,
-          separator: " | ",
-        }),
-      );
+    }
+    if (!expanded) {
+      footerItems.push({
+        label: "",
+        value: keyHint("app.tools.expand", "to expand"),
+      });
+    }
+    container.addChild(new Text("", 0, 0));
+    container.addChild(
+      new ToolFooter(theme, {
+        items: footerItems,
+        separator: " | ",
+      }),
+    );
+
+    return container;
+  },
+});
 
-      return container;
-    },
-  });
+export function registerSyntheticWebSearchTool(pi: ExtensionAPI): void {
+  pi.registerTool(syntheticWebSearchTool);
 }