@amaster.ai/pi-web-access 0.1.1

package/dist/index.js

@@ -0,0 +1,179 @@
+import { Type } from 'typebox';
+import { loadWebToolSettings, resolveProvider, resolveSearchProvider } from './config.js';
+import { webFetch } from './fetch.js';
+import { getProvider } from './providers/index.js';
+import { search } from './search.js';
+import { summarizeContent } from './summary.js';
+export { loadWebToolSettings, resolveFetchProvider, resolveProvider, resolveSearchProvider, } from './config.js';
+export { webFetch } from './fetch.js';
+export { getProvider, } from './providers/index.js';
+export { search } from './search.js';
+export default function piWebToolExtension(pi) {
+    let settings = {};
+    pi.on('session_start', async (_event, ctx) => {
+        settings = loadWebToolSettings(ctx.cwd);
+        const searchResolved = resolveSearchProvider(settings);
+        const hasSearch = !('error' in searchResolved) && Boolean(searchResolved.apiKey);
+        const hasFetch = Boolean(settings.fetch?.provider) || Boolean(settings.fetch?.summary);
+        console.debug('[pi-web-access] session_start', {
+            cwd: ctx.cwd,
+            searchProvider: hasSearch ? searchResolved.id : null,
+            fetchProvider: settings.fetch?.provider ?? 'local',
+            hasSummary: Boolean(settings.fetch?.summary),
+        });
+        if (hasSearch) {
+            pi.registerTool({
+                name: 'web_search',
+                label: 'WebSearch',
+                description: [
+                    '- Searches the web and returns results to inform responses',
+                    '- Provides up-to-date information for current events and recent data',
+                    '- Returns search results with titles, URLs, and content snippets, or a synthesized answer',
+                    '- Use this tool for accessing information beyond your knowledge cutoff',
+                    '',
+                    'After answering, include a "Sources:" section listing relevant URLs as markdown hyperlinks.',
+                ].join('\n'),
+                parameters: Type.Object({
+                    query: Type.String({ description: 'The search query to execute.' }),
+                    maxResults: Type.Optional(Type.Number({
+                        minimum: 1,
+                        maximum: 20,
+                        description: 'Max results to return (default 5).',
+                    })),
+                    topic: Type.Optional(Type.Union([Type.Literal('general'), Type.Literal('news')], {
+                        description: 'Topic category.',
+                    })),
+                    timeRange: Type.Optional(Type.Unsafe({
+                        type: 'string',
+                        enum: ['day', 'week', 'month', 'year'],
+                        description: 'Filter results by recency. Must be one of: "day", "week", "month", "year".',
+                    })),
+                    includeDomains: Type.Optional(Type.Array(Type.String(), {
+                        description: 'Only include results from these domains.',
+                    })),
+                    excludeDomains: Type.Optional(Type.Array(Type.String(), {
+                        description: 'Exclude results from these domains.',
+                    })),
+                }),
+                async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+                    const searchParams = params;
+                    const response = await search(searchParams, settings);
+                    const lines = [];
+                    lines.push(`## Web Search Results (${response.provider})`);
+                    lines.push(`**Query:** ${response.query}`);
+                    lines.push('');
+                    if (response.answer) {
+                        lines.push('### Answer');
+                        lines.push(response.answer);
+                        lines.push('');
+                    }
+                    if (response.results.length > 0) {
+                        lines.push('### Sources');
+                        for (const r of response.results) {
+                            lines.push(`- [${r.title}](${r.url})`);
+                            if (r.score !== undefined)
+                                lines.push(`  *Relevance: ${r.score.toFixed(2)}*`);
+                            if (r.content)
+                                lines.push(`  ${r.content}`);
+                        }
+                        lines.push('');
+                    }
+                    const text = lines.join('\n');
+                    return { content: [{ type: 'text', text }], details: undefined };
+                },
+            });
+        }
+        if (hasFetch) {
+            pi.registerTool({
+                name: 'web_fetch',
+                label: 'WebFetch',
+                description: [
+                    '- Fetches content from a specified URL and processes it using a prompt',
+                    '- Takes a URL and a prompt as input',
+                    '- Fetches the URL content, converts HTML to markdown',
+                    '- Processes the content with the prompt using a small, fast model',
+                    "- Returns the model's response about the content",
+                    '- Use this tool when you need to retrieve and analyze web content',
+                    '',
+                    'Usage notes:',
+                    '  - The URL must be a fully-formed valid URL',
+                    '  - The prompt should describe what information you want to extract from the page',
+                    '  - Results may be summarized if the content is very large',
+                ].join('\n'),
+                parameters: Type.Object({
+                    url: Type.String({ description: 'The URL to fetch content from.' }),
+                    prompt: Type.String({
+                        description: 'The prompt describing what information to extract or summarize from the page.',
+                    }),
+                }),
+                async execute(_toolCallId, params, _signal, _onUpdate, fetchCtx) {
+                    const fetchParams = params;
+                    const result = await webFetch({ url: fetchParams.url }, settings);
+                    let content = result.content;
+                    if (settings.fetch?.summary) {
+                        content = await summarizeContent(content, fetchParams.prompt, settings.fetch.summary, fetchCtx);
+                    }
+                    const lines = [];
+                    lines.push(`## ${result.title}`);
+                    lines.push(`**Source:** ${result.url}`);
+                    lines.push('');
+                    lines.push(content);
+                    const text = lines.join('\n');
+                    return { content: [{ type: 'text', text }], details: undefined };
+                },
+            });
+        }
+        // x_search: only register when xai provider has an API key
+        const xaiResolved = resolveProvider('xai', settings);
+        const hasXai = !('error' in xaiResolved) && Boolean(xaiResolved.apiKey);
+        if (hasXai) {
+            pi.registerTool({
+                name: 'x_search',
+                label: 'XSearch',
+                description: [
+                    '- Searches X (Twitter) for posts, threads, and social media content',
+                    '- Returns real-time social media insights with citations',
+                    '- Supports filtering by X handles and date ranges',
+                    '- Use this tool when you need information from X/Twitter specifically',
+                ].join('\n'),
+                parameters: Type.Object({
+                    query: Type.String({ description: 'The search query to execute on X.' }),
+                    allowedHandles: Type.Optional(Type.Array(Type.String(), {
+                        description: 'Only include posts from these X handles (max 20).',
+                    })),
+                    excludedHandles: Type.Optional(Type.Array(Type.String(), {
+                        description: 'Exclude posts from these X handles (max 20).',
+                    })),
+                    fromDate: Type.Optional(Type.String({ description: 'Start date in YYYY-MM-DD format.' })),
+                    toDate: Type.Optional(Type.String({ description: 'End date in YYYY-MM-DD format.' })),
+                }),
+                async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+                    const xaiProvider = getProvider('xai');
+                    const xParams = params;
+                    const response = await xaiProvider.xsearch(xParams, xaiResolved);
+                    const lines = [];
+                    lines.push(`## X Search Results`);
+                    lines.push(`**Query:** ${response.query}`);
+                    lines.push('');
+                    if (response.answer) {
+                        lines.push('### Answer');
+                        lines.push(response.answer);
+                        lines.push('');
+                    }
+                    if (response.results.length > 0) {
+                        lines.push('### Sources');
+                        for (const r of response.results) {
+                            lines.push(`- [${r.title}](${r.url})`);
+                            if (r.content)
+                                lines.push(`  ${r.content}`);
+                        }
+                        lines.push('');
+                    }
+                    const text = lines.join('\n');
+                    return { content: [{ type: 'text', text }], details: undefined };
+                },
+            });
+        }
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/providers/anthropic.d.ts

@@ -0,0 +1,8 @@
+import type { FetchResponse, ResolvedProvider, SearchParams, SearchResponse } from './base.js';
+import { BaseProvider } from './base.js';
+export declare class AnthropicProvider extends BaseProvider {
+    readonly id: "anthropic";
+    search(params: SearchParams, provider: ResolvedProvider): Promise<SearchResponse>;
+    fetch(targetUrl: string, provider: ResolvedProvider): Promise<FetchResponse>;
+}
+//# sourceMappingURL=anthropic.d.ts.map

package/dist/providers/anthropic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/providers/anthropic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,EAEf,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAIzC,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,QAAQ,CAAC,EAAE,EAAG,WAAW,CAAU;IAEpB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAqEjF,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;CA0C5F"}

package/dist/providers/anthropic.js

@@ -0,0 +1,100 @@
+import { BaseProvider } from './base.js';
+const REQUEST_TIMEOUT_MS = 60_000;
+export class AnthropicProvider extends BaseProvider {
+    id = 'anthropic';
+    async search(params, provider) {
+        if (!provider.apiKey) {
+            throw new Error('Anthropic API key not configured. Set ANTHROPIC_API_KEY env var or configure in settings.json.');
+        }
+        const url = `${provider.baseUrl.replace(/\/$/, '')}/messages`;
+        const tool = { type: 'web_search_20250305', name: 'web_search' };
+        if (params.includeDomains?.length)
+            tool.allowed_domains = params.includeDomains;
+        if (params.excludeDomains?.length)
+            tool.blocked_domains = params.excludeDomains;
+        if (params.maxResults)
+            tool.max_uses = params.maxResults;
+        const body = {
+            model: provider.model ?? 'claude-sonnet-4-6',
+            max_tokens: 4096,
+            messages: [{ role: 'user', content: params.query }],
+            tools: [tool],
+        };
+        const headers = {
+            'Content-Type': 'application/json',
+            'x-api-key': provider.apiKey,
+            'anthropic-version': '2023-06-01',
+            ...provider.headers,
+        };
+        const response = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`Anthropic API error ${response.status}: ${text}`);
+        }
+        const data = (await response.json());
+        let answer = '';
+        const results = [];
+        const seenUrls = new Set();
+        for (const block of data.content) {
+            if (block.type === 'text' && block.text) {
+                answer += block.text;
+                if (block.citations) {
+                    for (const cite of block.citations) {
+                        if (cite.url && !seenUrls.has(cite.url)) {
+                            seenUrls.add(cite.url);
+                            results.push({
+                                title: cite.title ?? cite.url,
+                                url: cite.url,
+                                content: cite.cited_text ?? '',
+                            });
+                        }
+                    }
+                }
+            }
+        }
+        return { provider: provider.id, query: params.query, answer: answer || undefined, results };
+    }
+    async fetch(targetUrl, provider) {
+        if (!provider.apiKey) {
+            throw new Error('Anthropic API key not configured. Set ANTHROPIC_API_KEY env var or configure in settings.json.');
+        }
+        const url = `${provider.baseUrl.replace(/\/$/, '')}/messages`;
+        const body = {
+            model: provider.model ?? 'claude-sonnet-4-6',
+            max_tokens: 4096,
+            messages: [
+                { role: 'user', content: `Please fetch and return the full content at: ${targetUrl}` },
+            ],
+            tools: [{ type: 'web_fetch_20250910', name: 'web_fetch' }],
+        };
+        const headers = {
+            'Content-Type': 'application/json',
+            'x-api-key': provider.apiKey,
+            'anthropic-version': '2023-06-01',
+            ...provider.headers,
+        };
+        const response = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`Anthropic API error ${response.status}: ${text}`);
+        }
+        const data = (await response.json());
+        let content = '';
+        for (const block of data.content) {
+            if (block.type === 'text' && block.text)
+                content += block.text;
+        }
+        return { url: targetUrl, title: targetUrl, content };
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/providers/anthropic.js.map

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

package/dist/providers/base.d.ts

@@ -0,0 +1,44 @@
+import type { BuiltInProviderId } from '../types.js';
+export interface ResolvedProvider {
+    id: BuiltInProviderId;
+    baseUrl: string;
+    apiKey?: string;
+    model?: string;
+    headers?: Record<string, string>;
+}
+export interface SearchParams {
+    query: string;
+    maxResults?: number;
+    topic?: 'general' | 'news';
+    timeRange?: 'day' | 'week' | 'month' | 'year';
+    includeDomains?: string[];
+    excludeDomains?: string[];
+}
+export interface SearchResult {
+    title: string;
+    url: string;
+    content: string;
+    score?: number;
+}
+export interface SearchResponse {
+    provider: string;
+    query: string;
+    answer?: string | undefined;
+    results: SearchResult[];
+}
+export interface FetchResponse {
+    url: string;
+    title: string;
+    content: string;
+}
+export interface WebProvider {
+    readonly id: BuiltInProviderId;
+    search(params: SearchParams, provider: ResolvedProvider): Promise<SearchResponse>;
+    fetch(url: string, provider: ResolvedProvider): Promise<FetchResponse>;
+}
+export declare abstract class BaseProvider implements WebProvider {
+    abstract readonly id: BuiltInProviderId;
+    search(_params: SearchParams, _provider: ResolvedProvider): Promise<SearchResponse>;
+    fetch(_url: string, _provider: ResolvedProvider): Promise<FetchResponse>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/providers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIrD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,iBAAiB,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC9C,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAID,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAC/B,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAClF,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACxE;AAED,8BAAsB,YAAa,YAAW,WAAW;IACvD,QAAQ,CAAC,QAAQ,CAAC,EAAE,EAAE,iBAAiB,CAAC;IAElC,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IAInF,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;CAG/E"}

package/dist/providers/base.js

@@ -0,0 +1,9 @@
+export class BaseProvider {
+    async search(_params, _provider) {
+        throw new Error(`${this.id} does not support web_search.`);
+    }
+    async fetch(_url, _provider) {
+        throw new Error(`${this.id} does not support web_fetch.`);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAiDA,MAAM,OAAgB,YAAY;IAGhC,KAAK,CAAC,MAAM,CAAC,OAAqB,EAAE,SAA2B;QAC7D,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,EAAE,+BAA+B,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,SAA2B;QACnD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,EAAE,8BAA8B,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/providers/gemini.d.ts

@@ -0,0 +1,7 @@
+import { BaseProvider } from './base.js';
+import type { ResolvedProvider, SearchParams, SearchResponse } from './index.js';
+export declare class GeminiProvider extends BaseProvider {
+    readonly id: "gemini";
+    search(params: SearchParams, provider: ResolvedProvider): Promise<SearchResponse>;
+}
+//# sourceMappingURL=gemini.d.ts.map

package/dist/providers/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAC;AAI/F,qBAAa,cAAe,SAAQ,YAAY;IAC9C,QAAQ,CAAC,EAAE,EAAG,QAAQ,CAAU;IAEjB,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;CA8CjG"}

package/dist/providers/gemini.js

@@ -0,0 +1,41 @@
+import { BaseProvider } from './base.js';
+const REQUEST_TIMEOUT_MS = 60_000;
+export class GeminiProvider extends BaseProvider {
+    id = 'gemini';
+    async search(params, provider) {
+        if (!provider.apiKey) {
+            throw new Error('Gemini API key not configured. Set GEMINI_API_KEY env var or configure in settings.json.');
+        }
+        const model = provider.model ?? 'gemini-2.5-flash';
+        const url = `${provider.baseUrl.replace(/\/$/, '')}/models/${model}:generateContent`;
+        const body = {
+            contents: [{ parts: [{ text: params.query }] }],
+            tools: [{ google_search: {} }],
+        };
+        const headers = {
+            'Content-Type': 'application/json',
+            'x-goog-api-key': provider.apiKey,
+            ...provider.headers,
+        };
+        const response = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`Gemini API error ${response.status}: ${text}`);
+        }
+        const data = (await response.json());
+        const candidate = data.candidates[0];
+        if (!candidate)
+            throw new Error('Gemini API returned empty response');
+        const answer = candidate.content.parts.map((p) => p.text).join('');
+        const results = (candidate.groundingMetadata?.groundingChunks ?? [])
+            .filter((c) => c.web)
+            .map((c) => ({ title: c.web.title, url: c.web.uri, content: '' }));
+        return { provider: provider.id, query: params.query, answer, results };
+    }
+}
+//# sourceMappingURL=gemini.js.map

package/dist/providers/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../../src/providers/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC,MAAM,OAAO,cAAe,SAAQ,YAAY;IACrC,EAAE,GAAG,QAAiB,CAAC;IAEvB,KAAK,CAAC,MAAM,CAAC,MAAoB,EAAE,QAA0B;QACpE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrB,MAAM,IAAI,KAAK,CACb,0FAA0F,CAC3F,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,kBAAkB,CAAC;QACnD,MAAM,GAAG,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,KAAK,kBAAkB,CAAC;QACrF,MAAM,IAAI,GAAG;YACX,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;YAC/C,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;SAC/B,CAAC;QACF,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;YAClC,gBAAgB,EAAE,QAAQ,CAAC,MAAM;YACjC,GAAG,QAAQ,CAAC,OAAO;SACpB,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;YAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,kBAAkB,CAAC;SAChD,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,oBAAoB,QAAQ,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAKlC,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QACrC,IAAI,CAAC,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QAEtE,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,MAAM,OAAO,GAAmB,CAAC,SAAS,CAAC,iBAAiB,EAAE,eAAe,IAAI,EAAE,CAAC;aACjF,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;aACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,GAAI,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC,GAAI,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QAEvE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IACzE,CAAC;CACF"}

package/dist/providers/index.d.ts

@@ -0,0 +1,6 @@
+import type { BuiltInProviderId } from '../types.js';
+import type { WebProvider } from './base.js';
+export type { FetchResponse, ResolvedProvider, SearchParams, SearchResponse, SearchResult, WebProvider, } from './base.js';
+export { BaseProvider } from './base.js';
+export declare function getProvider(id: BuiltInProviderId): WebProvider | undefined;
+//# sourceMappingURL=index.d.ts.map

package/dist/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAW7C,YAAY,EACV,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,WAAW,GACZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAmBzC,wBAAgB,WAAW,CAAC,EAAE,EAAE,iBAAiB,GAAG,WAAW,GAAG,SAAS,CAE1E"}

package/dist/providers/index.js

@@ -0,0 +1,29 @@
+import { AnthropicProvider } from './anthropic.js';
+import { GeminiProvider } from './gemini.js';
+import { KimiProvider } from './kimi.js';
+import { MimoProvider } from './mimo.js';
+import { OpenAIProvider } from './openai.js';
+import { OpenRouterProvider } from './openrouter.js';
+import { PerplexityProvider } from './perplexity.js';
+import { TavilyProvider } from './tavily.js';
+import { XaiProvider } from './xai.js';
+import { ZaiProvider } from './zai.js';
+export { BaseProvider } from './base.js';
+// ─── Registry ────────────────────────────────────────────────────────────────
+const providers = [
+    new TavilyProvider(),
+    new KimiProvider(),
+    new MimoProvider(),
+    new ZaiProvider(),
+    new GeminiProvider(),
+    new PerplexityProvider(),
+    new OpenRouterProvider(),
+    new XaiProvider(),
+    new OpenAIProvider(),
+    new AnthropicProvider(),
+];
+const registry = new Map(providers.map((p) => [p.id, p]));
+export function getProvider(id) {
+    return registry.get(id);
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEnD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAUvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,gFAAgF;AAEhF,MAAM,SAAS,GAAkB;IAC/B,IAAI,cAAc,EAAE;IACpB,IAAI,YAAY,EAAE;IAClB,IAAI,YAAY,EAAE;IAClB,IAAI,WAAW,EAAE;IACjB,IAAI,cAAc,EAAE;IACpB,IAAI,kBAAkB,EAAE;IACxB,IAAI,kBAAkB,EAAE;IACxB,IAAI,WAAW,EAAE;IACjB,IAAI,cAAc,EAAE;IACpB,IAAI,iBAAiB,EAAE;CACxB,CAAC;AAEF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAsB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/E,MAAM,UAAU,WAAW,CAAC,EAAqB;IAC/C,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC"}

package/dist/providers/kimi.d.ts

@@ -0,0 +1,8 @@
+import { BaseProvider } from './base.js';
+import type { ResolvedProvider, SearchParams, SearchResponse } from './index.js';
+export declare class KimiProvider extends BaseProvider {
+    readonly id: "kimi";
+    search(params: SearchParams, provider: ResolvedProvider): Promise<SearchResponse>;
+    private callApi;
+}
+//# sourceMappingURL=kimi.d.ts.map

package/dist/providers/kimi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kimi.d.ts","sourceRoot":"","sources":["../../src/providers/kimi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAoBjF,qBAAa,YAAa,SAAQ,YAAY;IAC5C,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAU;IAEf,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;YA2ClF,OAAO;CA6BtB"}

package/dist/providers/kimi.js

@@ -0,0 +1,66 @@
+import { BaseProvider } from './base.js';
+const REQUEST_TIMEOUT_MS = 60_000;
+export class KimiProvider extends BaseProvider {
+    id = 'kimi';
+    async search(params, provider) {
+        if (!provider.apiKey) {
+            throw new Error('Kimi API key not configured. Set MOONSHOT_API_KEY env var or configure in settings.json.');
+        }
+        const messages = [
+            {
+                role: 'system',
+                content: 'You are a helpful assistant that searches the web to answer questions. Provide concise, factual answers based on web search results.',
+            },
+            { role: 'user', content: params.query },
+        ];
+        const firstResponse = await this.callApi(messages, provider);
+        const firstChoice = firstResponse.choices[0];
+        if (!firstChoice)
+            throw new Error('Kimi API returned empty response');
+        if (firstChoice.finish_reason === 'tool_calls' && firstChoice.message.tool_calls?.length) {
+            const toolCall = firstChoice.message.tool_calls[0];
+            messages.push(firstChoice.message);
+            messages.push({
+                role: 'tool',
+                tool_call_id: toolCall.id,
+                name: toolCall.function.name,
+                content: toolCall.function.arguments,
+            });
+            const secondResponse = await this.callApi(messages, provider);
+            const answer = secondResponse.choices[0]?.message.content ?? '';
+            return { provider: provider.id, query: params.query, answer, results: [] };
+        }
+        return {
+            provider: provider.id,
+            query: params.query,
+            answer: firstChoice.message.content ?? '',
+            results: [],
+        };
+    }
+    async callApi(messages, provider) {
+        const url = `${provider.baseUrl.replace(/\/$/, '')}/chat/completions`;
+        const body = {
+            model: provider.model ?? 'kimi-k2.6',
+            messages,
+            tools: [{ type: 'builtin_function', function: { name: '$web_search' } }],
+            thinking: { type: 'disabled' },
+        };
+        const headers = {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${provider.apiKey}`,
+            ...provider.headers,
+        };
+        const response = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`Kimi API error ${response.status}: ${text}`);
+        }
+        return (await response.json());
+    }
+}
+//# sourceMappingURL=kimi.js.map

package/dist/providers/kimi.js.map

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

package/dist/providers/mimo.d.ts

@@ -0,0 +1,7 @@
+import { BaseProvider } from './base.js';
+import type { ResolvedProvider, SearchParams, SearchResponse } from './index.js';
+export declare class MimoProvider extends BaseProvider {
+    readonly id: "mimo";
+    search(params: SearchParams, provider: ResolvedProvider): Promise<SearchResponse>;
+}
+//# sourceMappingURL=mimo.d.ts.map

package/dist/providers/mimo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mimo.d.ts","sourceRoot":"","sources":["../../src/providers/mimo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,cAAc,EAAgB,MAAM,YAAY,CAAC;AAI/F,qBAAa,YAAa,SAAQ,YAAY;IAC5C,QAAQ,CAAC,EAAE,EAAG,MAAM,CAAU;IAEf,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;CAoDjG"}

package/dist/providers/mimo.js

@@ -0,0 +1,45 @@
+import { BaseProvider } from './base.js';
+const REQUEST_TIMEOUT_MS = 60_000;
+export class MimoProvider extends BaseProvider {
+    id = 'mimo';
+    async search(params, provider) {
+        if (!provider.apiKey) {
+            throw new Error('Mimo API key not configured. Set MIMO_API_KEY env var or configure in settings.json.');
+        }
+        const url = `${provider.baseUrl.replace(/\/$/, '')}/chat/completions`;
+        const body = {
+            model: provider.model ?? 'mimo-v2.5-pro',
+            messages: [{ role: 'user', content: params.query }],
+            tools: [{ type: 'web_search', max_keyword: 3, force_search: true }],
+            max_completion_tokens: 2048,
+            temperature: 1.0,
+            top_p: 0.95,
+            stream: false,
+            thinking: { type: 'disabled' },
+        };
+        const headers = {
+            'Content-Type': 'application/json',
+            'api-key': provider.apiKey,
+            ...provider.headers,
+        };
+        const response = await fetch(url, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`Mimo API error ${response.status}: ${text}`);
+        }
+        const data = (await response.json());
+        const choice = data.choices[0];
+        if (!choice)
+            throw new Error('Mimo API returned empty response');
+        const results = (choice.message.annotations ?? [])
+            .filter((a) => a.type === 'url_citation')
+            .map((a) => ({ title: a.title, url: a.url, content: a.summary }));
+        return { provider: provider.id, query: params.query, answer: choice.message.content, results };
+    }
+}
+//# sourceMappingURL=mimo.js.map