@aliou/pi-synthetic 0.4.4 → 0.4.6

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @aliou/pi-synthetic
 
+## 0.4.6
+
+### Patch Changes
+
+- 6180572: mark pi SDK peer deps as optional to prevent koffi OOM in Gondolin VMs
+- fe8094f: register synthetic web search tool at init time and move availability checks to hooks
+
+## 0.4.5
+
+### Patch Changes
+
+- 7489bc0: update model list: add nvidia/Kimi-K2.5-NVFP4, remove 6 discontinued models
+
 ## 0.4.4
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliou/pi-synthetic",
-  "version": "0.4.4",
+  "version": "0.4.6",
   "repository": {
     "type": "git",
     "url": "https://github.com/aliou/pi-synthetic"
@@ -27,6 +27,11 @@
     "husky": "^9.1.7",
     "typescript": "^5.9.3"
   },
+  "peerDependenciesMeta": {
+    "@mariozechner/pi-coding-agent": {
+      "optional": true
+    }
+  },
   "scripts": {
     "typecheck": "tsc --noEmit",
     "lint": "biome check",

package/src/hooks/search-tool-availability.ts

@@ -0,0 +1,129 @@
+import type {
+  ExtensionAPI,
+  ExtensionContext,
+} from "@mariozechner/pi-coding-agent";
+import { SYNTHETIC_WEB_SEARCH_TOOL } from "../tools/search";
+
+function notifyDebug(ctx: ExtensionContext, message: string): void {
+  ctx.ui.notify(`[pi-synthetic:web-search] ${message}`, "info");
+}
+
+async function checkSubscriptionAccess(
+  apiKey: string,
+): Promise<{ ok: true } | { ok: false; reason: string }> {
+  try {
+    const response = await fetch("https://api.synthetic.new/v2/quotas", {
+      method: "GET",
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+      },
+    });
+
+    if (!response.ok) {
+      return {
+        ok: false,
+        reason: `Quotas check failed (HTTP ${response.status})`,
+      };
+    }
+
+    const data = await response.json();
+    if (data?.subscription?.limit > 0) {
+      return { ok: true };
+    }
+
+    return {
+      ok: false,
+      reason: "No active subscription (search requires a subscription plan)",
+    };
+  } catch (error) {
+    const message =
+      error instanceof Error ? error.message : "Unknown error occurred";
+    return { ok: false, reason: `Quotas check failed: ${message}` };
+  }
+}
+
+export function registerSyntheticWebSearchHooks(pi: ExtensionAPI): void {
+  let accessCheckPromise:
+    | Promise<{ ok: true } | { ok: false; reason: string }>
+    | undefined;
+  let hasAccess = false;
+  let deniedReason: string | undefined;
+  let didNotifyDenied = false;
+
+  // Keep tool inactive at session start. Availability is decided before each agent run.
+  pi.on("session_start", (_event, ctx) => {
+    notifyDebug(ctx, "session_start: preparing web search tool");
+
+    const current = pi.getActiveTools();
+    if (current.includes(SYNTHETIC_WEB_SEARCH_TOOL)) {
+      pi.setActiveTools(
+        current.filter((toolName) => toolName !== SYNTHETIC_WEB_SEARCH_TOOL),
+      );
+      notifyDebug(ctx, "session_start: tool disabled until subscription check");
+    }
+  });
+
+  // Verify subscription only when user starts agent execution.
+  pi.on("before_agent_start", async (_event, ctx) => {
+    notifyDebug(ctx, "before_agent_start: ensuring tool availability");
+
+    const apiKey = process.env.SYNTHETIC_API_KEY;
+    if (!apiKey) {
+      hasAccess = false;
+      deniedReason = "SYNTHETIC_API_KEY is not configured";
+      accessCheckPromise = undefined;
+      notifyDebug(ctx, "before_agent_start: access denied (missing API key)");
+    } else {
+      if (deniedReason === "SYNTHETIC_API_KEY is not configured") {
+        deniedReason = undefined;
+      }
+
+      if (!hasAccess && !deniedReason) {
+        notifyDebug(ctx, "before_agent_start: checking subscription access");
+        accessCheckPromise ??= checkSubscriptionAccess(apiKey);
+        const access = await accessCheckPromise;
+
+        if (!access.ok) {
+          deniedReason = access.reason;
+          notifyDebug(
+            ctx,
+            `before_agent_start: access denied (${access.reason})`,
+          );
+        } else {
+          hasAccess = true;
+          didNotifyDenied = false;
+          notifyDebug(ctx, "before_agent_start: access granted");
+        }
+      }
+    }
+
+    if (deniedReason) {
+      const current = pi.getActiveTools();
+      if (current.includes(SYNTHETIC_WEB_SEARCH_TOOL)) {
+        pi.setActiveTools(
+          current.filter((toolName) => toolName !== SYNTHETIC_WEB_SEARCH_TOOL),
+        );
+        notifyDebug(ctx, "before_agent_start: tool kept disabled");
+      }
+
+      if (ctx.hasUI && !didNotifyDenied) {
+        ctx.ui.notify(
+          `Synthetic web search disabled: ${deniedReason}`,
+          "warning",
+        );
+        didNotifyDenied = true;
+        notifyDebug(
+          ctx,
+          "before_agent_start: user notified about disabled tool",
+        );
+      }
+      return;
+    }
+
+    const current = pi.getActiveTools();
+    if (!current.includes(SYNTHETIC_WEB_SEARCH_TOOL)) {
+      pi.setActiveTools([...current, SYNTHETIC_WEB_SEARCH_TOOL]);
+      notifyDebug(ctx, "before_agent_start: tool enabled");
+    }
+  });
+}

package/src/index.ts

@@ -1,14 +1,15 @@
 import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { registerQuotasCommand } from "./commands/quotas";
+import { registerSyntheticWebSearchHooks } from "./hooks/search-tool-availability";
 import { registerSyntheticProvider } from "./providers/index";
 import { registerSyntheticWebSearchTool } from "./tools/search";
 
 export default async function (pi: ExtensionAPI) {
   registerSyntheticProvider(pi);
+  registerSyntheticWebSearchTool(pi);
+  registerSyntheticWebSearchHooks(pi);
 
-  // Only register quotas command and web search tool if API key is available
   if (process.env.SYNTHETIC_API_KEY) {
     registerQuotasCommand(pi);
-    registerSyntheticWebSearchTool(pi);
   }
 }

package/src/providers/models.ts

@@ -100,36 +100,6 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     contextWindow: 131072,
     maxTokens: 128000,
   },
-  // models.dev: synthetic/hf:deepseek-ai/DeepSeek-V3.1 → ctx=128000, out=128000
-  {
-    id: "hf:deepseek-ai/DeepSeek-V3.1",
-    name: "deepseek-ai/DeepSeek-V3.1",
-    reasoning: false,
-    input: ["text"],
-    cost: {
-      input: 0.56,
-      output: 1.68,
-      cacheRead: 0.56,
-      cacheWrite: 0,
-    },
-    contextWindow: 131072,
-    maxTokens: 128000,
-  },
-  // models.dev: synthetic/hf:deepseek-ai/DeepSeek-V3.1-Terminus → ctx=128000, out=128000
-  {
-    id: "hf:deepseek-ai/DeepSeek-V3.1-Terminus",
-    name: "deepseek-ai/DeepSeek-V3.1-Terminus",
-    reasoning: false,
-    input: ["text"],
-    cost: {
-      input: 1.2,
-      output: 1.2,
-      cacheRead: 1.2,
-      cacheWrite: 0,
-    },
-    contextWindow: 131072,
-    maxTokens: 128000,
-  },
   // models.dev: synthetic/hf:deepseek-ai/DeepSeek-V3.2 → ctx=162816, out=8000
   {
     id: "hf:deepseek-ai/DeepSeek-V3.2",
@@ -145,21 +115,6 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     contextWindow: 162816,
     maxTokens: 8000,
   },
-  // NOTE: not present in models.dev synthetic provider; maxTokens unchanged
-  {
-    id: "hf:Qwen/Qwen3-VL-235B-A22B-Instruct",
-    name: "Qwen/Qwen3-VL-235B-A22B-Instruct",
-    reasoning: true,
-    input: ["text", "image"],
-    cost: {
-      input: 0.22,
-      output: 0.88,
-      cacheRead: 0.22,
-      cacheWrite: 0,
-    },
-    contextWindow: 256000,
-    maxTokens: 4096,
-  },
   // models.dev: synthetic/hf:moonshotai/Kimi-K2-Instruct-0905 → ctx=262144, out=32768
   {
     id: "hf:moonshotai/Kimi-K2-Instruct-0905",
@@ -220,61 +175,31 @@ export const SYNTHETIC_MODELS: SyntheticModelConfig[] = [
     contextWindow: 262144,
     maxTokens: 32000,
   },
-  // models.dev: synthetic/hf:Qwen/Qwen3-235B-A22B-Instruct-2507 → ctx=256000, out=32000
-  {
-    id: "hf:Qwen/Qwen3-235B-A22B-Instruct-2507",
-    name: "Qwen/Qwen3-235B-A22B-Instruct-2507",
-    reasoning: false,
-    input: ["text"],
-    cost: {
-      input: 0.22,
-      output: 0.88,
-      cacheRead: 0.22,
-      cacheWrite: 0,
-    },
-    contextWindow: 262144,
-    maxTokens: 32000,
-  },
-  // models.dev: synthetic/hf:zai-org/GLM-4.6 → ctx=200000, out=64000
-  {
-    id: "hf:zai-org/GLM-4.6",
-    name: "zai-org/GLM-4.6",
-    reasoning: true,
-    input: ["text"],
-    cost: {
-      input: 0.55,
-      output: 2.19,
-      cacheRead: 0.55,
-      cacheWrite: 0,
-    },
-    contextWindow: 202752,
-    maxTokens: 64000,
-  },
-  // models.dev: synthetic/hf:MiniMaxAI/MiniMax-M2 → ctx=196608, out=131000
+  // models.dev: synthetic/hf:moonshotai/Kimi-K2.5 → ctx=262144, out=65536
   {
-    id: "hf:MiniMaxAI/MiniMax-M2",
-    name: "MiniMaxAI/MiniMax-M2",
+    id: "hf:moonshotai/Kimi-K2.5",
+    name: "moonshotai/Kimi-K2.5",
     reasoning: true,
-    input: ["text"],
+    input: ["text", "image"],
     cost: {
-      input: 0.3,
+      input: 1.2,
       output: 1.2,
-      cacheRead: 0.3,
+      cacheRead: 1.2,
       cacheWrite: 0,
     },
-    contextWindow: 196608,
-    maxTokens: 131000,
+    contextWindow: 262144,
+    maxTokens: 65536,
   },
-  // models.dev: synthetic/hf:moonshotai/Kimi-K2.5 → ctx=262144, out=65536
+  // API: hf:nvidia/Kimi-K2.5-NVFP4 → ctx=262144, out=65536 (NVFP4 quantized)
   {
-    id: "hf:moonshotai/Kimi-K2.5",
-    name: "moonshotai/Kimi-K2.5",
+    id: "hf:nvidia/Kimi-K2.5-NVFP4",
+    name: "nvidia/Kimi-K2.5-NVFP4",
     reasoning: true,
     input: ["text", "image"],
     cost: {
-      input: 1.2,
-      output: 1.2,
-      cacheRead: 1.2,
+      input: 0.6,
+      output: 3,
+      cacheRead: 0.6,
       cacheWrite: 0,
     },
     contextWindow: 262144,

package/src/tools/search.ts

@@ -8,7 +8,8 @@ import type {
 import { Text } from "@mariozechner/pi-tui";
 import { type Static, Type } from "@sinclair/typebox";
 
-// Types
+export const SYNTHETIC_WEB_SEARCH_TOOL = "synthetic_web_search" as const;
+
 interface SyntheticSearchResult {
   url: string;
   title: string;
@@ -27,7 +28,6 @@ interface WebSearchDetails {
   isError?: boolean;
 }
 
-// Schema
 const SearchParams = Type.Object({
   query: Type.String({
     description: "The search query. Be specific for best results.",
@@ -36,80 +36,9 @@ const SearchParams = Type.Object({
 
 type SearchParamsType = Static<typeof SearchParams>;
 
-// Check if API key has subscription access by calling quotas endpoint.
-// Returns "ok" if the user has access, or an error message if not.
-async function checkSubscriptionAccess(
-  apiKey: string,
-): Promise<{ ok: true } | { ok: false; reason: string }> {
-  try {
-    const response = await fetch("https://api.synthetic.new/v2/quotas", {
-      method: "GET",
-      headers: {
-        Authorization: `Bearer ${apiKey}`,
-      },
-    });
-
-    if (!response.ok) {
-      return {
-        ok: false,
-        reason: `Quotas check failed (HTTP ${response.status})`,
-      };
-    }
-
-    const data = await response.json();
-    if (data?.subscription?.limit > 0) {
-      return { ok: true };
-    }
-
-    return {
-      ok: false,
-      reason: "No active subscription (search requires a subscription plan)",
-    };
-  } catch (error) {
-    const message =
-      error instanceof Error ? error.message : "Unknown error occurred";
-    return { ok: false, reason: `Quotas check failed: ${message}` };
-  }
-}
-
-// Tool Registration
-export function registerSyntheticWebSearchTool(pi: ExtensionAPI) {
-  const apiKey = process.env.SYNTHETIC_API_KEY;
-  if (!apiKey) {
-    return;
-  }
-
-  // Register tool immediately so it's available when tools are collected
-  registerTool(pi, apiKey);
-
-  // On session start, remove tool from active set, check subscription, re-add if valid
-  pi.on("session_start", async (_event, ctx) => {
-    // Disable tool until subscription is verified
-    const activeTools = pi.getActiveTools();
-    pi.setActiveTools(activeTools.filter((t) => t !== "synthetic_web_search"));
-
-    const access = await checkSubscriptionAccess(apiKey);
-    if (!access.ok) {
-      if (ctx.hasUI) {
-        ctx.ui.notify(
-          `Synthetic web search disabled: ${access.reason}`,
-          "warning",
-        );
-      }
-      return;
-    }
-
-    // Add tool back to active tools
-    const current = pi.getActiveTools();
-    if (!current.includes("synthetic_web_search")) {
-      pi.setActiveTools([...current, "synthetic_web_search"]);
-    }
-  });
-}
-
-function registerTool(pi: ExtensionAPI, apiKey: string) {
+export function registerSyntheticWebSearchTool(pi: ExtensionAPI): void {
   pi.registerTool<typeof SearchParams, WebSearchDetails>({
-    name: "synthetic_web_search",
+    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.",
@@ -124,14 +53,21 @@ function registerTool(pi: ExtensionAPI, apiKey: string) {
         | undefined,
       _ctx: ExtensionContext,
     ): Promise<AgentToolResult<WebSearchDetails>> {
-      // Send progress update
       onUpdate?.({
         content: [{ type: "text", text: "Searching..." }],
         details: { query: params.query },
       });
 
       try {
-        // Make API request
+        const apiKey = process.env.SYNTHETIC_API_KEY;
+        if (!apiKey) {
+          const error = "SYNTHETIC_API_KEY is not configured";
+          return {
+            content: [{ type: "text", text: `Error: ${error}` }],
+            details: { error, isError: true },
+          };
+        }
+
         const response = await fetch("https://api.synthetic.new/v2/search", {
           method: "POST",
           headers: {
@@ -151,7 +87,6 @@ function registerTool(pi: ExtensionAPI, apiKey: string) {
           };
         }
 
-        // Parse response
         let data: SyntheticSearchResponse;
         try {
           data = await response.json();
@@ -166,7 +101,6 @@ function registerTool(pi: ExtensionAPI, apiKey: string) {
           };
         }
 
-        // Format results for LLM
         let content = `Found ${data.results.length} result(s):\n\n`;
         for (const result of data.results) {
           content += `## ${result.title}\n`;
@@ -184,7 +118,6 @@ function registerTool(pi: ExtensionAPI, apiKey: string) {
           },
         };
       } catch (error) {
-        // Handle abort signal
         if (error instanceof Error && error.name === "AbortError") {
           return {
             content: [{ type: "text", text: "Search cancelled" }],
@@ -192,7 +125,6 @@ function registerTool(pi: ExtensionAPI, apiKey: string) {
           };
         }
 
-        // Handle other errors
         const message =
           error instanceof Error ? error.message : "Unknown error occurred";
         return {
@@ -215,7 +147,6 @@ function registerTool(pi: ExtensionAPI, apiKey: string) {
     ): Text {
       const { expanded, isPartial } = options;
 
-      // Handle partial/loading state
       if (isPartial) {
         const text =
           result.content?.[0]?.type === "text"
@@ -225,8 +156,6 @@ function registerTool(pi: ExtensionAPI, apiKey: string) {
       }
 
       const details = result.details;
-
-      // Handle error state
       if (details?.isError) {
         const errorMsg =
           result.content?.[0]?.type === "text"
@@ -235,21 +164,18 @@ function registerTool(pi: ExtensionAPI, apiKey: string) {
         return new Text(theme.fg("error", errorMsg), 0, 0);
       }
 
-      // Handle success state
       const results = details?.results || [];
       let text = theme.fg("success", `✓ Found ${results.length} result(s)`);
 
-      // Collapsed view
       if (!expanded && results.length > 0) {
         const first = results[0];
         text += `\n  ${theme.fg("dim", `${first.title}`)}`;
         if (results.length > 1) {
           text += theme.fg("dim", ` (${results.length - 1} more)`);
         }
-        text += theme.fg("muted", ` [Ctrl+O to expand]`);
+        text += theme.fg("muted", " [Ctrl+O to expand]");
       }
 
-      // Expanded view
       if (expanded) {
         for (const r of results) {
           text += `\n\n${theme.fg("accent", theme.bold(r.title))}`;

package/.pi/settings.json

@@ -1,3 +0,0 @@
-{
-  "packages": ["npm:@aliou/pi-extension-dev"]
-}