@aliou/pi-synthetic 0.18.0 → 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
@@ -56,6 +56,8 @@ Once installed, select `synthetic` as your provider and choose from available mo
 
 All models are accessed through Synthetic's API. Some models are hosted by Synthetic directly (`provider: "synthetic"` in the model config); others are proxied by Synthetic to upstream backends such as Fireworks or Together.
 
+Synthetic also provides permanent aliases (`syn:large:text`, `syn:small:text`, `syn:large:vision`, `syn:small:vision`) that route to the current best model for each category. These aliases are stable across model rotations — using an alias means no reconfiguration when models change. Alias models are always visible even when Proxied Models is disabled.
+
 By default, new installs show only Synthetic-hosted models. You can enable proxied models in `/synthetic:settings` under **Models > Proxied Models**. Existing configurations keep proxied models enabled to preserve prior behavior.
 
 The `provider` field in `src/extensions/provider/models.ts` is for maintenance only and is stripped before registering models with Pi, so users always select the `synthetic` provider.
@@ -109,13 +111,24 @@ The **Proxied Models** setting is not a loadable extension feature. It is a regu
 
 ## Adding or Updating Models
 
-Models are hardcoded in `src/extensions/provider/models.ts`. To add or update models:
+Models are hardcoded in `src/extensions/provider/models.ts`. Entries are a union of concrete models and thin aliases (`syn:*` IDs).
+
+### Adding a concrete model
 
 1. Edit `src/extensions/provider/models.ts`
-2. Add the model configuration following the `SyntheticModelConfig` interface
+2. Append a concrete model following the `SyntheticModelConfig` interface
 3. Set `provider` to the upstream backend Synthetic uses for that model, such as `synthetic`, `fireworks`, or `together`
 4. Run `pnpm run typecheck` to verify
 
+### Adding an alias model
+
+1. Add a thin `{ id, name, aliasFor }` entry at the top of `SYNTHETIC_MODELS`
+2. Set `id` and `name` from the Synthetic API
+3. Set `aliasFor` to `"hf:" + hugging_face_id` from the Synthetic API
+4. The resolved alias inherits all fields from the target at build time
+
+When Synthetic changes which model an alias routes to, update only the `aliasFor` field.
+
 ## Development
 
 ### Setup
@@ -152,7 +165,7 @@ pnpm run test
 ### Test Locally
 
 ```bash
-pi -e ./src/index.ts
+pi -e .
 ```
 
 ## Release
@@ -167,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.0",
+  "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

@@ -28,19 +28,46 @@ import {
 } from "../../types/quotas";
 import { fetchQuotas } from "../../utils/quotas";
 import { SYNTHETIC_OVERFLOW_PATTERN } from "./context-overflow";
-import { SYNTHETIC_MODELS } from "./models";
+import {
+  type ConcreteSyntheticModelConfig,
+  isAlias,
+  SYNTHETIC_MODELS,
+} from "./models";
 
 export function buildSyntheticProviderModels(includeProxiedModels: boolean) {
-  return SYNTHETIC_MODELS.filter(
-    (model) => includeProxiedModels || model.provider === "synthetic",
-  ).map(({ provider: _provider, ...model }) => ({
-    ...model,
-    compat: {
-      supportsDeveloperRole: false,
-      maxTokensField: "max_tokens" as const,
-      ...model.compat,
-    },
-  }));
+  const concreteModels = SYNTHETIC_MODELS.filter(
+    (m): m is ConcreteSyntheticModelConfig => !isAlias(m),
+  );
+  const byId = new Map(concreteModels.map((m) => [m.id, m]));
+
+  const resolved = SYNTHETIC_MODELS.map((entry) => {
+    if (!isAlias(entry)) return entry;
+
+    const target = byId.get(entry.aliasFor);
+    if (!target) {
+      throw new Error(
+        `Synthetic alias "${entry.id}" references missing model "${entry.aliasFor}"`,
+      );
+    }
+
+    return {
+      ...target,
+      id: entry.id,
+      name: entry.name,
+      provider: "synthetic" as const,
+    };
+  });
+
+  return resolved
+    .filter((model) => includeProxiedModels || model.provider === "synthetic")
+    .map(({ provider: _provider, ...model }) => ({
+      ...model,
+      compat: {
+        supportsDeveloperRole: false,
+        maxTokensField: "max_tokens" as const,
+        ...model.compat,
+      },
+    }));
 }
 
 interface RegisterSyntheticProviderOptions {
@@ -53,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

@@ -9,14 +9,68 @@ export interface SyntheticModelConfig extends ProviderModelConfig {
   provider: string;
 }
 
-export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
+/** A thin alias that resolves to a concrete model at build time. */
+export interface SyntheticModelAliasConfig {
+  id: string;
+  name: string;
+  /** Full model ID of the concrete target this alias resolves to. */
+  aliasFor: string;
+}
+
+/** Concrete model with full spec; aliases are excluded. */
+export type ConcreteSyntheticModelConfig = SyntheticModelConfig & {
+  aliasFor?: never;
+};
+
+export function isAlias(
+  entry: ConcreteSyntheticModelConfig | SyntheticModelAliasConfig,
+): entry is SyntheticModelAliasConfig {
+  return "aliasFor" in entry;
+}
+
+export type SyntheticModelEntry =
+  | ConcreteSyntheticModelConfig
+  | SyntheticModelAliasConfig;
+
+export const SYNTHETIC_MODELS: SyntheticModelEntry[] = [
+  // API: syn:large:text → alias for hf:zai-org/GLM-5.1
+  {
+    id: "syn:large:text",
+    name: "syn:large:text",
+    aliasFor: "hf:zai-org/GLM-5.1",
+  },
+  // API: syn:small:text → alias for hf:zai-org/GLM-4.7-Flash
+  {
+    id: "syn:small:text",
+    name: "syn:small:text",
+    aliasFor: "hf:zai-org/GLM-4.7-Flash",
+  },
+  // API: syn:large:vision → alias for hf:moonshotai/Kimi-K2.6
+  {
+    id: "syn:large:vision",
+    name: "syn:large:vision",
+    aliasFor: "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:Qwen/Qwen3.6-27B",
+  },
   // API: hf:zai-org/GLM-4.7 → ctx=202752
   {
     id: "hf:zai-org/GLM-4.7",
     name: "zai-org/GLM-4.7",
     provider: "synthetic",
     reasoning: true,
-    thinkingLevelMap: { minimal: null, xhigh: null },
+    thinkingLevelMap: {
+      off: "none",
+      minimal: null,
+      low: null,
+      medium: "medium",
+      high: null,
+      xhigh: null,
+    },
     compat: {
       supportsReasoningEffort: true,
     },
@@ -30,33 +84,20 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     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: { minimal: 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",
     name: "zai-org/GLM-5.1",
     provider: "synthetic",
     reasoning: true,
-    thinkingLevelMap: { minimal: null, xhigh: null },
+    thinkingLevelMap: {
+      off: "none",
+      minimal: null,
+      low: null,
+      medium: "medium",
+      high: null,
+      xhigh: null,
+    },
     compat: {
       supportsReasoningEffort: true,
       supportsDeveloperRole: false,
@@ -77,7 +118,14 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "zai-org/GLM-4.7-Flash",
     provider: "synthetic",
     reasoning: true,
-    thinkingLevelMap: { minimal: null, xhigh: null },
+    thinkingLevelMap: {
+      off: "none",
+      minimal: null,
+      low: null,
+      medium: "medium",
+      high: null,
+      xhigh: null,
+    },
     compat: {
       supportsReasoningEffort: true,
     },
@@ -91,22 +139,6 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     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,
-    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",
@@ -145,7 +177,14 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "moonshotai/Kimi-K2.6",
     provider: "synthetic",
     reasoning: true,
-    thinkingLevelMap: { minimal: null, low: null, xhigh: null },
+    thinkingLevelMap: {
+      off: "none",
+      minimal: null,
+      low: null,
+      medium: "medium",
+      high: null,
+      xhigh: null,
+    },
     compat: {
       supportsReasoningEffort: true,
     },
@@ -165,6 +204,17 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     name: "Qwen/Qwen3.5-397B-A17B",
     provider: "together",
     reasoning: true,
+    thinkingLevelMap: {
+      off: "none",
+      minimal: null,
+      low: null,
+      medium: "medium",
+      high: null,
+      xhigh: null,
+    },
+    compat: {
+      supportsReasoningEffort: true,
+    },
     input: ["text", "image"],
     cost: {
       input: 0.6,
@@ -175,123 +225,83 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     contextWindow: 262144,
     maxTokens: 65536,
   },
-  // API: hf:MiniMaxAI/MiniMax-M2.5 → ctx=191488, out=65536
+  // API: hf:Qwen/Qwen3.6-27B → ctx=262144, out=65536
   {
-    id: "hf:MiniMaxAI/MiniMax-M2.5",
-    name: "MiniMaxAI/MiniMax-M2.5",
+    id: "hf:Qwen/Qwen3.6-27B",
+    name: "Qwen/Qwen3.6-27B",
     provider: "synthetic",
     reasoning: true,
-    thinkingLevelMap: { off: null, minimal: null, low: null, xhigh: null },
-    input: ["text"],
-    cost: {
-      input: 0.4,
-      output: 2,
-      cacheRead: 0.4,
-      cacheWrite: 0,
-    },
-    contextWindow: 191488,
-    maxTokens: 65536,
-    compat: {
-      supportsReasoningEffort: true,
-      maxTokensField: "max_completion_tokens",
+    thinkingLevelMap: {
+      off: "none",
+      minimal: null,
+      low: null,
+      medium: "medium",
+      high: null,
+      xhigh: null,
     },
-  },
-  // API: hf:nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-NVFP4 → ctx=262144, out=65536
-  {
-    id: "hf:nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-NVFP4",
-    name: "nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-NVFP4",
-    provider: "synthetic",
-    reasoning: true,
-    thinkingLevelMap: { minimal: null, low: null, xhigh: null },
     compat: {
       supportsReasoningEffort: true,
     },
-    input: ["text"],
+    input: ["text", "image"],
     cost: {
-      input: 0.3,
-      output: 1,
-      cacheRead: 0.3,
+      input: 0.45,
+      output: 3.6,
+      cacheRead: 0.45,
       cacheWrite: 0,
     },
     contextWindow: 262144,
     maxTokens: 65536,
   },
-  // API: syn:large:text → alias for hf:zai-org/GLM-5.1 → ctx=196608, out=65536
+  // API: hf:MiniMaxAI/MiniMax-M2.5 → ctx=191488, out=65536
   {
-    id: "syn:large:text",
-    name: "syn:large:text",
+    id: "hf:MiniMaxAI/MiniMax-M2.5",
+    name: "MiniMaxAI/MiniMax-M2.5",
     provider: "synthetic",
     reasoning: true,
-    thinkingLevelMap: { minimal: null, xhigh: null },
-    compat: {
-      supportsReasoningEffort: true,
-      supportsDeveloperRole: false,
+    thinkingLevelMap: {
+      off: null,
+      minimal: null,
+      low: null,
+      medium: "medium",
+      high: null,
+      xhigh: null,
     },
     input: ["text"],
     cost: {
-      input: 1,
-      output: 3,
-      cacheRead: 1,
+      input: 0.4,
+      output: 2,
+      cacheRead: 0.4,
       cacheWrite: 0,
     },
-    contextWindow: 196608,
+    contextWindow: 191488,
     maxTokens: 65536,
-  },
-  // API: syn:small:text → alias for hf:zai-org/GLM-4.7-Flash → ctx=196608, out=65536
-  {
-    id: "syn:small:text",
-    name: "syn:small:text",
-    provider: "synthetic",
-    reasoning: true,
-    thinkingLevelMap: { minimal: null, xhigh: null },
     compat: {
       supportsReasoningEffort: true,
+      maxTokensField: "max_completion_tokens",
     },
-    input: ["text"],
-    cost: {
-      input: 0.1,
-      output: 0.5,
-      cacheRead: 0.1,
-      cacheWrite: 0,
-    },
-    contextWindow: 196608,
-    maxTokens: 65536,
   },
-  // API: syn:large:vision → alias for hf:moonshotai/Kimi-K2.6 → ctx=262144, out=65536
+  // API: hf:nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-NVFP4 → ctx=262144, out=65536
   {
-    id: "syn:large:vision",
-    name: "syn:large:vision",
+    id: "hf:nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-NVFP4",
+    name: "nvidia/NVIDIA-Nemotron-3-Super-120B-A12B-NVFP4",
     provider: "synthetic",
     reasoning: true,
-    thinkingLevelMap: { minimal: null, low: null, xhigh: null },
-    compat: {
-      supportsReasoningEffort: true,
-    },
-    input: ["text", "image"],
-    cost: {
-      input: 0.95,
-      output: 4,
-      cacheRead: 0.95,
-      cacheWrite: 0,
+    thinkingLevelMap: {
+      off: "none",
+      minimal: null,
+      low: null,
+      medium: "medium",
+      high: null,
+      xhigh: null,
     },
-    contextWindow: 262144,
-    maxTokens: 65536,
-  },
-  // API: syn:small:vision → alias for hf:moonshotai/Kimi-K2.6 → ctx=262144, out=65536
-  {
-    id: "syn:small:vision",
-    name: "syn:small:vision",
-    provider: "synthetic",
-    reasoning: true,
-    thinkingLevelMap: { minimal: null, low: null, xhigh: null },
     compat: {
       supportsReasoningEffort: true,
     },
-    input: ["text", "image"],
+    input: ["text"],
     cost: {
-      input: 0.95,
-      output: 4,
-      cacheRead: 0.95,
+      input: 0.3,
+      output: 1,
+      cacheRead: 0.3,
       cacheWrite: 0,
     },
     contextWindow: 262144,

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);
 }