@polpo-ai/tools 0.6.32 → 0.7.0

package/dist/lib/provider-resolver.js

@@ -0,0 +1,115 @@
+/**
+ * Lazy resolvers that map a Polpo provider name + ResolvedVault into an
+ * AI SDK provider instance. Each resolver dynamically imports the
+ * provider package so it stays optional — installing `@polpo-ai/tools`
+ * does not pull in `@ai-sdk/fal` / `@ai-sdk/anthropic` / etc unless the
+ * matching tool is actually used.
+ *
+ * Vault key conventions (must match the strings in the tools):
+ *   - `fal-ai` / "key"     → fal.ai (image_generate, video_generate)
+ *   - `openai`  / "key"    → OpenAI (image_analyze)
+ *   - `anthropic` / "key"  → Anthropic (image_analyze)
+ *
+ * Env-var fallbacks are read by the tool layer, not here. Resolvers
+ * receive a fully-resolved API key string.
+ */
+// ── Resolvers ──
+/** Build a fal.ai image provider. Throws a friendly error if the optional `@ai-sdk/fal` package is not installed. */
+export async function resolveImageProvider(name, apiKey) {
+    if (name !== "fal") {
+        throw new Error(`Unknown image provider: ${name}`);
+    }
+    const mod = await loadOptional("@ai-sdk/fal", "image_generate");
+    // @ts-ignore — mod typed as `any` from the dynamic import helper
+    const fal = mod.createFal({ apiKey });
+    return { image: (modelId) => fal.image(modelId) };
+}
+/** Build a video provider — currently fal.ai only. */
+export async function resolveVideoProvider(name, apiKey) {
+    if (name !== "fal") {
+        throw new Error(`Unknown video provider: ${name}`);
+    }
+    // fal.ai uses image-style queue API even for video; reuse the image
+    // provider's queue path. The `ai` SDK `experimental_generateVideo`
+    // accepts the result of `fal.video(...)`.
+    const mod = await loadOptional("@ai-sdk/fal", "video_generate");
+    // @ts-ignore — mod typed as `any` from the dynamic import helper
+    const fal = mod.createFal({ apiKey });
+    return { video: (modelId) => fal.video(modelId) };
+}
+/** Build a speech-to-text (transcription) provider. */
+export async function resolveTranscribeProvider(name, apiKey) {
+    if (name === "openai") {
+        const mod = await loadOptional("@ai-sdk/openai", "audio_transcribe (openai)");
+        // @ts-ignore — mod typed as `any` from the dynamic import helper
+        const openai = mod.createOpenAI({ apiKey });
+        return { transcription: (modelId) => openai.transcription(modelId) };
+    }
+    if (name === "deepgram") {
+        const mod = await loadOptional("@ai-sdk/deepgram", "audio_transcribe (deepgram)");
+        // @ts-ignore — mod typed as `any` from the dynamic import helper
+        const deepgram = mod.createDeepgram({ apiKey });
+        return { transcription: (modelId) => deepgram.transcription(modelId) };
+    }
+    throw new Error(`Unknown transcribe provider: ${name}`);
+}
+/** Build a text-to-speech provider. The local `edge` provider needs a
+ *  Shell + FileSystem (no API key); cloud providers need an API key. */
+export async function resolveSpeakProvider(name, config) {
+    if (name === "edge") {
+        if (!config.shell || !config.fs) {
+            throw new Error("edge provider requires shell and fs to be supplied");
+        }
+        const { createEdgeSpeechProvider } = await import("./edge-speech-model.js");
+        return createEdgeSpeechProvider({ shell: config.shell, fs: config.fs });
+    }
+    if (!config.apiKey) {
+        throw new Error(`${name} speech provider requires an apiKey`);
+    }
+    if (name === "openai") {
+        const mod = await loadOptional("@ai-sdk/openai", "audio_speak (openai)");
+        // @ts-ignore — mod typed as `any` from the dynamic import helper
+        const openai = mod.createOpenAI({ apiKey: config.apiKey });
+        return { speech: (modelId) => openai.speech(modelId) };
+    }
+    if (name === "deepgram") {
+        const mod = await loadOptional("@ai-sdk/deepgram", "audio_speak (deepgram)");
+        // @ts-ignore — mod typed as `any` from the dynamic import helper
+        const deepgram = mod.createDeepgram({ apiKey: config.apiKey });
+        return { speech: (modelId) => deepgram.speech(modelId) };
+    }
+    if (name === "elevenlabs") {
+        const mod = await loadOptional("@ai-sdk/elevenlabs", "audio_speak (elevenlabs)");
+        // @ts-ignore — mod typed as `any` from the dynamic import helper
+        const elevenlabs = mod.createElevenLabs({ apiKey: config.apiKey });
+        return { speech: (modelId) => elevenlabs.speech(modelId) };
+    }
+    throw new Error(`Unknown speak provider: ${name}`);
+}
+/** Build a vision (multimodal LanguageModel) provider. */
+export async function resolveVisionProvider(name, apiKey) {
+    if (name === "openai") {
+        const mod = await loadOptional("@ai-sdk/openai", "image_analyze (openai)");
+        // @ts-ignore — mod typed as `any` from the dynamic import helper
+        const openai = mod.createOpenAI({ apiKey });
+        return (modelId) => openai(modelId);
+    }
+    if (name === "anthropic") {
+        const mod = await loadOptional("@ai-sdk/anthropic", "image_analyze (anthropic)");
+        // @ts-ignore — mod typed as `any` from the dynamic import helper
+        const anthropic = mod.createAnthropic({ apiKey });
+        return (modelId) => anthropic(modelId);
+    }
+    throw new Error(`Unknown vision provider: ${name}`);
+}
+// ── Internal ──
+async function loadOptional(pkg, toolName) {
+    try {
+        return await import(pkg);
+    }
+    catch (err) {
+        throw new Error(`${pkg} is required for ${toolName} but is not installed. ` +
+            `Install it with: pnpm add ${pkg}`);
+    }
+}
+//# sourceMappingURL=provider-resolver.js.map

package/dist/lib/provider-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-resolver.js","sourceRoot":"","sources":["../../src/lib/provider-resolver.ts"],"names":[],"mappings":"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"}

package/dist/search-tools.d.ts

@@ -1,22 +1,19 @@
 /**
- * Web search tools powered by Exa (exa.ai).
+ * Web search tools — thin wrappers over a SearchProvider.
  *
- * Provides semantic web search with optional content extraction.
- * Requires EXA_API_KEY in vault or environment.
- *
- * Tools:
- * - search_web: Search the web with a natural language query
- * - search_find_similar: Find pages similar to a given URL
+ * The provider is injected by the shell (OSS today: ExaSearchProvider).
+ * The tool layer doesn't know which backend runs; it formats results
+ * for the agent and surfaces errors. `search_find_similar` is registered
+ * only when the provider implements the optional `findSimilar` method.
  */
-import type { PolpoTool as AgentTool } from "@polpo-ai/core";
-import type { ResolvedVault } from "./types.js";
+import type { PolpoTool as AgentTool, SearchProvider } from "@polpo-ai/core";
 export type SearchToolName = "search_web" | "search_find_similar";
 export declare const ALL_SEARCH_TOOL_NAMES: readonly SearchToolName[];
 /**
- * Create Exa-powered web search tools.
+ * Create web search tools backed by a SearchProvider.
  *
- * @param vault - Resolved vault credentials (looks for EXA_API_KEY)
- * @param allowedTools - Optional filter
+ * `search_find_similar` is only registered when the provider supports
+ * it (i.e. exposes the optional `findSimilar` method).
  */
-export declare function createSearchTools(vault?: ResolvedVault, allowedTools?: string[]): AgentTool<any>[];
+export declare function createSearchTools(provider: SearchProvider, allowedTools?: string[]): AgentTool<any>[];
 //# sourceMappingURL=search-tools.d.ts.map

package/dist/search-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-tools.d.ts","sourceRoot":"","sources":["../src/search-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAuNhD,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,qBAAqB,CAAC;AAElE,eAAO,MAAM,qBAAqB,EAAE,SAAS,cAAc,EAA0C,CAAC;AAEtG;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,EAAE,aAAa,EACrB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,SAAS,CAAC,GAAG,CAAC,EAAE,CAWlB"}
+{"version":3,"file":"search-tools.d.ts","sourceRoot":"","sources":["../src/search-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,SAAS,IAAI,SAAS,EAAE,cAAc,EAAgB,MAAM,gBAAgB,CAAC;AAkH3F,MAAM,MAAM,cAAc,GAAG,YAAY,GAAG,qBAAqB,CAAC;AAElE,eAAO,MAAM,qBAAqB,EAAE,SAAS,cAAc,EAA0C,CAAC;AAEtG;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,cAAc,EACxB,YAAY,CAAC,EAAE,MAAM,EAAE,GACtB,SAAS,CAAC,GAAG,CAAC,EAAE,CASlB"}

package/dist/search-tools.js

@@ -1,122 +1,71 @@
 /**
- * Web search tools powered by Exa (exa.ai).
+ * Web search tools — thin wrappers over a SearchProvider.
  *
- * Provides semantic web search with optional content extraction.
- * Requires EXA_API_KEY in vault or environment.
- *
- * Tools:
- * - search_web: Search the web with a natural language query
- * - search_find_similar: Find pages similar to a given URL
+ * The provider is injected by the shell (OSS today: ExaSearchProvider).
+ * The tool layer doesn't know which backend runs; it formats results
+ * for the agent and surfaces errors. `search_find_similar` is registered
+ * only when the provider implements the optional `findSimilar` method.
  */
 import { Type } from "@sinclair/typebox";
-const EXA_BASE = "https://api.exa.ai";
 const DEFAULT_NUM_RESULTS = 5;
-const DEFAULT_TIMEOUT = 15_000;
 // ─── Helpers ───
-function getExaApiKey(vault) {
-    // Try vault first (service "exa", key "key"), then environment
-    return vault?.getKey("exa", "key") ?? process.env.EXA_API_KEY;
+function ok(text, details) {
+    return { content: [{ type: "text", text }], details: details ?? {} };
+}
+function err(text) {
+    return { content: [{ type: "text", text }], details: { error: true } };
 }
-function ok(text, details) { return { content: [{ type: "text", text }], details: details ?? {} }; }
-function err(text) { return { content: [{ type: "text", text }], details: { error: true } }; }
-function formatResults(results, withContent) {
+function formatResults(results) {
     if (results.length === 0)
         return "(no results)";
     return results.map((r, i) => {
-        const parts = [`${i + 1}. **${r.title}**`, `   ${r.url}`];
+        const parts = [`${i + 1}. **${r.title || r.url}**`, `   ${r.url}`];
         if (r.publishedDate)
             parts.push(`   Published: ${r.publishedDate}`);
-        if (r.author)
-            parts.push(`   Author: ${r.author}`);
-        if (r.summary) {
-            parts.push(`   Summary: ${r.summary}`);
-        }
-        else if (withContent && r.text) {
-            // Truncate content to avoid token bloat
+        if (r.text) {
             const text = r.text.length > 1500 ? r.text.slice(0, 1500) + "..." : r.text;
-            parts.push(`   Content: ${text}`);
-        }
-        if (r.highlights?.length) {
-            parts.push(`   Highlights:`);
-            for (const h of r.highlights.slice(0, 3)) {
-                parts.push(`     - ${h}`);
-            }
+            parts.push(`   ${text}`);
         }
         return parts.join("\n");
     }).join("\n\n");
 }
 // ─── Tool: search_web ───
 const SearchWebSchema = Type.Object({
-    query: Type.String({ description: "Natural language search query. Be descriptive — Exa uses semantic search, not keywords." }),
+    query: Type.String({ description: "Natural language search query. Be descriptive — semantic search providers reward intent over keywords." }),
     numResults: Type.Optional(Type.Number({ description: `Number of results to return (default: ${DEFAULT_NUM_RESULTS}, max: 20)` })),
     includeContent: Type.Optional(Type.Boolean({ description: "Include page content/summary in results (default: true). Costs more but saves a follow-up http_fetch." })),
     includeDomains: Type.Optional(Type.Array(Type.String(), { description: "Only return results from these domains (e.g. ['github.com', 'docs.python.org'])" })),
     excludeDomains: Type.Optional(Type.Array(Type.String(), { description: "Exclude results from these domains" })),
     startPublishedDate: Type.Optional(Type.String({ description: "Only results published after this date (ISO format, e.g. '2024-01-01')" })),
-    category: Type.Optional(Type.String({ description: "Filter by category: company, research_paper, news, pdf, github, tweet, personal_site, linkedin_profile" })),
+    endPublishedDate: Type.Optional(Type.String({ description: "Only results published before this date (ISO format)" })),
 });
-function createSearchWebTool(vault) {
+function createSearchWebTool(provider) {
     return {
         name: "search_web",
         label: "Web Search",
-        description: "Search the web using Exa's semantic search. Returns relevant pages with titles, URLs, and optionally content/summaries. " +
-            "Use natural language queries — Exa understands meaning, not just keywords. " +
-            "Example: 'how to implement OAuth2 with Better Auth in Next.js'",
+        description: `Search the web via ${provider.name}. Returns relevant pages with titles, URLs, and optionally snippet/summary. ` +
+            "Use natural language queries. Example: 'how to implement OAuth2 with Better Auth in Next.js'",
         parameters: SearchWebSchema,
         async execute(_id, params, signal) {
-            const apiKey = getExaApiKey(vault);
-            if (!apiKey) {
-                return err("Error: EXA_API_KEY not found. Add it to vault (service: exa, key: key) or set as environment variable.");
-            }
-            const numResults = Math.min(params.numResults ?? DEFAULT_NUM_RESULTS, 20);
-            const includeContent = params.includeContent ?? true;
-            const body = {
-                query: params.query,
-                numResults,
-                type: "auto",
-            };
-            if (includeContent) {
-                body.contents = {
-                    text: { maxCharacters: 2000 },
-                    highlights: { numSentences: 3 },
-                    summary: { query: params.query },
-                };
-            }
-            if (params.includeDomains?.length)
-                body.includeDomains = params.includeDomains;
-            if (params.excludeDomains?.length)
-                body.excludeDomains = params.excludeDomains;
-            if (params.startPublishedDate)
-                body.startPublishedDate = params.startPublishedDate;
-            if (params.category)
-                body.category = params.category;
             try {
-                const controller = new AbortController();
-                const timeout = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
-                if (signal)
-                    signal.addEventListener("abort", () => controller.abort());
-                const response = await fetch(`${EXA_BASE}/search`, {
-                    method: "POST",
-                    headers: {
-                        "x-api-key": apiKey,
-                        "Content-Type": "application/json",
-                    },
-                    body: JSON.stringify(body),
-                    signal: controller.signal,
+                const results = await provider.search(params.query, {
+                    numResults: params.numResults,
+                    includeText: params.includeContent ?? true,
+                    includeDomains: params.includeDomains,
+                    excludeDomains: params.excludeDomains,
+                    startPublishedDate: params.startPublishedDate,
+                    endPublishedDate: params.endPublishedDate,
+                    signal,
+                });
+                const header = `Found ${results.length} result(s) for: "${params.query}"`;
+                return ok(`${header}\n\n${formatResults(results)}`, {
+                    provider: provider.name,
+                    query: params.query,
+                    count: results.length,
                 });
-                clearTimeout(timeout);
-                if (!response.ok) {
-                    const errText = await response.text().catch(() => "");
-                    return err(`Error: Exa API returned ${response.status}: ${errText}`);
-                }
-                const data = (await response.json());
-                const formatted = formatResults(data.results, includeContent);
-                const header = `Found ${data.results.length} result(s) for: "${params.query}"`;
-                return ok(`${header}\n\n${formatted}`);
             }
             catch (e) {
-                const message = e.name === "AbortError" ? "Search timed out" : e.message;
-                return err(`Error: Web search failed — ${message}`);
+                return err(`Error: web search failed (${provider.name}) — ${e.message}`);
             }
         },
     };
@@ -128,78 +77,52 @@ const FindSimilarSchema = Type.Object({
     includeContent: Type.Optional(Type.Boolean({ description: "Include page content/summary (default: false)" })),
     excludeDomains: Type.Optional(Type.Array(Type.String(), { description: "Exclude results from these domains" })),
 });
-function createFindSimilarTool(vault) {
+function createFindSimilarTool(provider) {
     return {
         name: "search_find_similar",
         label: "Find Similar Pages",
-        description: "Find web pages similar to a given URL. Useful for finding alternatives, competitors, or related resources. " +
-            "Example: give it a GitHub repo URL to find similar projects.",
+        description: `Find web pages similar to a given URL via ${provider.name}. Useful for finding alternatives, ` +
+            "competitors, or related resources. Example: pass a GitHub repo URL to find similar projects.",
         parameters: FindSimilarSchema,
         async execute(_id, params, signal) {
-            const apiKey = getExaApiKey(vault);
-            if (!apiKey) {
-                return err("Error: EXA_API_KEY not found. Add it to vault or set as environment variable.");
-            }
-            const numResults = Math.min(params.numResults ?? DEFAULT_NUM_RESULTS, 20);
-            const includeContent = params.includeContent ?? false;
-            const body = {
-                url: params.url,
-                numResults,
-            };
-            if (includeContent) {
-                body.contents = {
-                    text: { maxCharacters: 2000 },
-                    highlights: { numSentences: 3 },
-                };
+            if (!provider.findSimilar) {
+                return err(`Error: provider '${provider.name}' does not support findSimilar`);
             }
-            if (params.excludeDomains?.length)
-                body.excludeDomains = params.excludeDomains;
             try {
-                const controller = new AbortController();
-                const timeout = setTimeout(() => controller.abort(), DEFAULT_TIMEOUT);
-                if (signal)
-                    signal.addEventListener("abort", () => controller.abort());
-                const response = await fetch(`${EXA_BASE}/findSimilar`, {
-                    method: "POST",
-                    headers: {
-                        "x-api-key": apiKey,
-                        "Content-Type": "application/json",
-                    },
-                    body: JSON.stringify(body),
-                    signal: controller.signal,
+                const results = await provider.findSimilar(params.url, {
+                    numResults: params.numResults,
+                    includeText: params.includeContent ?? false,
+                    excludeDomains: params.excludeDomains,
+                    signal,
+                });
+                const header = `Found ${results.length} page(s) similar to: ${params.url}`;
+                return ok(`${header}\n\n${formatResults(results)}`, {
+                    provider: provider.name,
+                    url: params.url,
+                    count: results.length,
                 });
-                clearTimeout(timeout);
-                if (!response.ok) {
-                    const errText = await response.text().catch(() => "");
-                    return err(`Error: Exa API returned ${response.status}: ${errText}`);
-                }
-                const data = (await response.json());
-                const formatted = formatResults(data.results, includeContent);
-                const header = `Found ${data.results.length} page(s) similar to: ${params.url}`;
-                return ok(`${header}\n\n${formatted}`);
             }
             catch (e) {
-                const message = e.name === "AbortError" ? "Search timed out" : e.message;
-                return err(`Error: Find similar failed — ${message}`);
+                return err(`Error: find similar failed (${provider.name}) — ${e.message}`);
             }
         },
     };
 }
 export const ALL_SEARCH_TOOL_NAMES = ["search_web", "search_find_similar"];
 /**
- * Create Exa-powered web search tools.
+ * Create web search tools backed by a SearchProvider.
  *
- * @param vault - Resolved vault credentials (looks for EXA_API_KEY)
- * @param allowedTools - Optional filter
+ * `search_find_similar` is only registered when the provider supports
+ * it (i.e. exposes the optional `findSimilar` method).
  */
-export function createSearchTools(vault, allowedTools) {
-    const factories = {
-        search_web: () => createSearchWebTool(vault),
-        search_find_similar: () => createFindSimilarTool(vault),
-    };
-    const names = allowedTools
-        ? ALL_SEARCH_TOOL_NAMES.filter(n => allowedTools.some(a => a.toLowerCase() === n))
-        : [...ALL_SEARCH_TOOL_NAMES];
-    return names.map(n => factories[n]());
+export function createSearchTools(provider, allowedTools) {
+    const tools = [createSearchWebTool(provider)];
+    if (provider.findSimilar) {
+        tools.push(createFindSimilarTool(provider));
+    }
+    if (!allowedTools)
+        return tools;
+    const allowed = new Set(allowedTools.map(a => a.toLowerCase()));
+    return tools.filter(t => allowed.has(t.name));
 }
 //# sourceMappingURL=search-tools.js.map

package/dist/search-tools.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-tools.js","sourceRoot":"","sources":["../src/search-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAIzC,MAAM,QAAQ,GAAG,oBAAoB,CAAC;AACtC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAC9B,MAAM,eAAe,GAAG,MAAM,CAAC;AAE/B,kBAAkB;AAElB,SAAS,YAAY,CAAC,KAAqB;IACzC,+DAA+D;IAC/D,OAAO,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;AAChE,CAAC;AAED,SAAS,EAAE,CAAC,IAAY,EAAE,OAAiC,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;AAC/I,SAAS,GAAG,CAAC,IAAY,IAAI,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;AAkB/G,SAAS,aAAa,CAAC,OAA0B,EAAE,WAAoB;IACrE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IAEhD,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,KAAK,IAAI,EAAE,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,CAAC,aAAa;YAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,CAAC,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;YACd,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,CAAC;aAAM,IAAI,WAAW,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;YACjC,wCAAwC;YACxC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YAC3E,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;YACzB,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;YAC7B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACzC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,2BAA2B;AAE3B,MAAM,eAAe,GAAG,IAAI,CAAC,MAAM,CAAC;IAClC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yFAAyF,EAAE,CAAC;IAC9H,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,mBAAmB,YAAY,EAAE,CAAC,CAAC;IACjI,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,uGAAuG,EAAE,CAAC,CAAC;IACrK,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,iFAAiF,EAAE,CAAC,CAAC;IAC5J,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC,CAAC;IAC/G,kBAAkB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,wEAAwE,EAAE,CAAC,CAAC;IACzI,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,wGAAwG,EAAE,CAAC,CAAC;CAChK,CAAC,CAAC;AAEH,SAAS,mBAAmB,CAAC,KAAqB;IAChD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,YAAY;QACnB,WAAW,EACT,0HAA0H;YAC1H,6EAA6E;YAC7E,gEAAgE;QAClE,UAAU,EAAE,eAAe;QAC3B,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM;YAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,GAAG,CAAC,wGAAwG,CAAC,CAAC;YACvH,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,mBAAmB,EAAE,EAAE,CAAC,CAAC;YAC1E,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;YAErD,MAAM,IAAI,GAA4B;gBACpC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,UAAU;gBACV,IAAI,EAAE,MAAM;aACb,CAAC;YAEF,IAAI,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,QAAQ,GAAG;oBACd,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;oBAC7B,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE;oBAC/B,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE;iBACjC,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM;gBAAE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;YAC/E,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM;gBAAE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;YAC/E,IAAI,MAAM,CAAC,kBAAkB;gBAAE,IAAI,CAAC,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC;YACnF,IAAI,MAAM,CAAC,QAAQ;gBAAE,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YAErD,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;gBACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,eAAe,CAAC,CAAC;gBACtE,IAAI,MAAM;oBAAE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;gBAEvE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,SAAS,EAAE;oBACjD,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,WAAW,EAAE,MAAM;wBACnB,cAAc,EAAE,kBAAkB;qBACnC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBAEH,YAAY,CAAC,OAAO,CAAC,CAAC;gBAEtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;oBACtD,OAAO,GAAG,CAAC,2BAA2B,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;gBACvE,CAAC;gBAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC;gBACpD,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;gBAC9D,MAAM,MAAM,GAAG,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,oBAAoB,MAAM,CAAC,KAAK,GAAG,CAAC;gBAC/E,OAAO,EAAE,CAAC,GAAG,MAAM,OAAO,SAAS,EAAE,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACzE,OAAO,GAAG,CAAC,8BAA8B,OAAO,EAAE,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,oCAAoC;AAEpC,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC;IACpC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,2CAA2C,EAAE,CAAC;IAC9E,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,+BAA+B,mBAAmB,YAAY,EAAE,CAAC,CAAC;IACvH,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,+CAA+C,EAAE,CAAC,CAAC;IAC7G,cAAc,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,WAAW,EAAE,oCAAoC,EAAE,CAAC,CAAC;CAChH,CAAC,CAAC;AAEH,SAAS,qBAAqB,CAAC,KAAqB;IAClD,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,oBAAoB;QAC3B,WAAW,EACT,6GAA6G;YAC7G,8DAA8D;QAChE,UAAU,EAAE,iBAAiB;QAC7B,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM;YAC/B,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC;YACnC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO,GAAG,CAAC,+EAA+E,CAAC,CAAC;YAC9F,CAAC;YAED,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,IAAI,mBAAmB,EAAE,EAAE,CAAC,CAAC;YAC1E,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,KAAK,CAAC;YAEtD,MAAM,IAAI,GAA4B;gBACpC,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,UAAU;aACX,CAAC;YAEF,IAAI,cAAc,EAAE,CAAC;gBACnB,IAAI,CAAC,QAAQ,GAAG;oBACd,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE;oBAC7B,UAAU,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE;iBAChC,CAAC;YACJ,CAAC;YAED,IAAI,MAAM,CAAC,cAAc,EAAE,MAAM;gBAAE,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;YAE/E,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;gBACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,eAAe,CAAC,CAAC;gBACtE,IAAI,MAAM;oBAAE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,CAAC;gBAEvE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,cAAc,EAAE;oBACtD,MAAM,EAAE,MAAM;oBACd,OAAO,EAAE;wBACP,WAAW,EAAE,MAAM;wBACnB,cAAc,EAAE,kBAAkB;qBACnC;oBACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;oBAC1B,MAAM,EAAE,UAAU,CAAC,MAAM;iBAC1B,CAAC,CAAC;gBAEH,YAAY,CAAC,OAAO,CAAC,CAAC;gBAEtB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;oBACjB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;oBACtD,OAAO,GAAG,CAAC,2BAA2B,QAAQ,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;gBACvE,CAAC;gBAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAgB,CAAC;gBACpD,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;gBAC9D,MAAM,MAAM,GAAG,SAAS,IAAI,CAAC,OAAO,CAAC,MAAM,wBAAwB,MAAM,CAAC,GAAG,EAAE,CAAC;gBAChF,OAAO,EAAE,CAAC,GAAG,MAAM,OAAO,SAAS,EAAE,CAAC,CAAC;YACzC,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBAChB,MAAM,OAAO,GAAG,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;gBACzE,OAAO,GAAG,CAAC,gCAAgC,OAAO,EAAE,CAAC,CAAC;YACxD,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAMD,MAAM,CAAC,MAAM,qBAAqB,GAA8B,CAAC,YAAY,EAAE,qBAAqB,CAAC,CAAC;AAEtG;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAqB,EACrB,YAAuB;IAEvB,MAAM,SAAS,GAAiD;QAC9D,UAAU,EAAE,GAAG,EAAE,CAAC,mBAAmB,CAAC,KAAK,CAAC;QAC5C,mBAAmB,EAAE,GAAG,EAAE,CAAC,qBAAqB,CAAC,KAAK,CAAC;KACxD,CAAC;IAEF,MAAM,KAAK,GAAG,YAAY;QACxB,CAAC,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;QAClF,CAAC,CAAC,CAAC,GAAG,qBAAqB,CAAC,CAAC;IAE/B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"search-tools.js","sourceRoot":"","sources":["../src/search-tools.ts"],"names":[],"mappings":"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"}

package/dist/system-tools.d.ts

@@ -7,7 +7,7 @@
  */
 import type { FileSystem } from "@polpo-ai/core/filesystem";
 import type { Shell } from "@polpo-ai/core/shell";
-import type { PolpoTool as AgentTool } from "@polpo-ai/core";
+import type { PolpoTool as AgentTool, SearchProvider } from "@polpo-ai/core";
 import type { ResolvedVault } from "./types.js";
 /**
  * Check if a tool name matches an allowed pattern.
@@ -45,14 +45,13 @@ export type { ExcelToolName } from "./excel-tools.js";
 export type { PdfToolName } from "./pdf-tools.js";
 export type { DocxToolName } from "./docx-tools.js";
 export type { SearchToolName } from "./search-tools.js";
-export type { PhoneToolName } from "./phone-tools.js";
 /** All known tool names across all categories */
-export type ExtendedToolName = SystemToolName | import("./browser-tools.js").BrowserToolName | import("./http-tools.js").HttpToolName | import("./email-tools.js").EmailToolName | import("./outcome-tools.js").OutcomeToolName | import("./vault-tools.js").VaultToolName | import("./image-tools.js").ImageToolName | import("./audio-tools.js").AudioToolName | import("./excel-tools.js").ExcelToolName | import("./pdf-tools.js").PdfToolName | import("./docx-tools.js").DocxToolName | import("./search-tools.js").SearchToolName | import("./phone-tools.js").PhoneToolName;
+export type ExtendedToolName = SystemToolName | import("./browser-tools.js").BrowserToolName | import("./http-tools.js").HttpToolName | import("./email-tools.js").EmailToolName | import("./outcome-tools.js").OutcomeToolName | import("./vault-tools.js").VaultToolName | import("./image-tools.js").ImageToolName | import("./audio-tools.js").AudioToolName | import("./excel-tools.js").ExcelToolName | import("./pdf-tools.js").PdfToolName | import("./docx-tools.js").DocxToolName | import("./search-tools.js").SearchToolName;
 /**
  * Public catalog of every configurable built-in tool name (core coding
  * + http + vault + browser + email + image + audio + excel + pdf +
- * docx + search + phone). Use this for config validation,
- * documentation, and the `/v1/tools` endpoint.
+ * docx + search). Use this for config validation, documentation,
+ * and the `/v1/tools` endpoint.
  *
  * Notable exclusion: `register_outcome` is not listed. It's a
  * task-only infrastructural tool, injected automatically when the
@@ -84,6 +83,21 @@ export interface CreateAllToolsOptions {
     fs?: FileSystem;
     /** Shell implementation (default: NodeShell). */
     shell?: Shell;
+    /** image_generate model. e.g. "fal/fal-ai/flux/dev" */
+    imageModel?: string;
+    /** video_generate model. e.g. "fal/luma-ray-2-flash" */
+    videoModel?: string;
+    /** image_analyze model. e.g. "openai/gpt-4o-mini" */
+    visionModel?: string;
+    /** audio_transcribe model. e.g. "openai/whisper-1" */
+    transcribeModel?: string;
+    /** audio_speak model. e.g. "openai/tts-1" or "edge/edge-tts" */
+    ttsModel?: string;
+    /** Pre-instantiated SearchProvider. When omitted, falls back to
+     *  ExaSearchProvider built from the vault's "exa" key. The cloud
+     *  shell can swap in a Gateway-routed provider here without
+     *  touching the tool layer. */
+    searchProvider?: SearchProvider;
 }
 /**
  * Create all available tools for an agent, including extended tool categories.

package/dist/system-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"system-tools.d.ts","sourceRoot":"","sources":["../src/system-tools.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"system-tools.d.ts","sourceRoot":"","sources":["../src/system-tools.ts"],"names":[],"mappings":"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"}

package/dist/system-tools.js

@@ -356,12 +356,11 @@ import { createExcelTools, ALL_EXCEL_TOOL_NAMES } from "./excel-tools.js";
 import { createPdfTools, ALL_PDF_TOOL_NAMES } from "./pdf-tools.js";
 import { createDocxTools, ALL_DOCX_TOOL_NAMES } from "./docx-tools.js";
 import { createSearchTools, ALL_SEARCH_TOOL_NAMES } from "./search-tools.js";
-import { createPhoneTools, ALL_PHONE_TOOL_NAMES } from "./phone-tools.js";
 /**
  * Public catalog of every configurable built-in tool name (core coding
  * + http + vault + browser + email + image + audio + excel + pdf +
- * docx + search + phone). Use this for config validation,
- * documentation, and the `/v1/tools` endpoint.
+ * docx + search). Use this for config validation, documentation,
+ * and the `/v1/tools` endpoint.
  *
  * Notable exclusion: `register_outcome` is not listed. It's a
  * task-only infrastructural tool, injected automatically when the
@@ -380,7 +379,6 @@ export const TOOL_CATALOG = [
     ...ALL_PDF_TOOL_NAMES,
     ...ALL_DOCX_TOOL_NAMES,
     ...ALL_SEARCH_TOOL_NAMES,
-    ...ALL_PHONE_TOOL_NAMES,
 ];
 /**
  * Create all available tools for an agent, including extended tool categories.
@@ -434,13 +432,21 @@ export async function createAllTools(options) {
     if (categoryRequested(ALL_DOCX_TOOL_NAMES)) {
         tools.push(...createDocxTools(cwd, allowedPaths, allowedTools, options.fs));
     }
-    // Search tools (Exa) — activated when any search_* tool is in allowedTools
+    // Search tools — activated when any search_* tool is in allowedTools.
+    // Provider injection: pre-instantiated `searchProvider` wins;
+    // otherwise we default to ExaSearchProvider built from the vault.
     if (categoryRequested(ALL_SEARCH_TOOL_NAMES)) {
-        tools.push(...createSearchTools(options.vault, allowedTools));
-    }
-    // Phone tools (VAPI) — activated when any phone_* tool is in allowedTools
-    if (categoryRequested(ALL_PHONE_TOOL_NAMES)) {
-        tools.push(...createPhoneTools(options.vault, allowedTools));
+        let provider = options.searchProvider;
+        if (!provider) {
+            const exaKey = options.vault?.getKey("exa", "key") ?? process.env.EXA_API_KEY;
+            if (exaKey) {
+                const { ExaSearchProvider } = await import("./lib/exa-search-provider.js");
+                provider = new ExaSearchProvider({ apiKey: exaKey });
+            }
+        }
+        if (provider) {
+            tools.push(...createSearchTools(provider, allowedTools));
+        }
     }
     // HTTP, register_outcome, and vault are already included via createSystemTools() above — no need to add again
     return tools;