@spinabot/brigade 0.1.2 → 1.0.1

package/dist/agents/extensions/modules/hackernews.js

@@ -0,0 +1,144 @@
+/**
+ * Hacker News search via Algolia — keyless.
+ *
+ * Endpoint: `https://hn.algolia.com/api/v1/search` (Algolia-powered HN
+ * mirror). No auth, no rate-limit short of abuse. Ideal for "what does HN
+ * think of X" / tech-news / startup-signal queries.
+ *
+ * Operator config (`tools.web.search.providers.hackernews`):
+ *   { tags?, sortBy? }
+ *     tags: 'story' | 'comment' | 'poll' | 'show_hn' | 'ask_hn' (or compound, e.g. "story,show_hn")
+ *     sortBy: 'relevance' (default) | 'date' (use `/search_by_date` endpoint)
+ */
+import { defineModule } from "../types.js";
+import { DEFAULT_TIMEOUT_SECONDS, readResponseText } from "../../tools/web-shared.js";
+import { readProviderConfigSlot, resolveSiteName, wrapSearchHit, mergeSignals, } from "./web-provider-helpers.js";
+const HN_ENDPOINT_RELEVANCE = "https://hn.algolia.com/api/v1/search";
+const HN_ENDPOINT_DATE = "https://hn.algolia.com/api/v1/search_by_date";
+function createHackerNewsSearchProvider() {
+    return {
+        id: "hackernews",
+        label: "Hacker News",
+        hint: "Algolia-powered HN search. Keyless. Best for tech/startup signal.",
+        requiresCredential: false,
+        envVars: [],
+        signupUrl: "https://news.ycombinator.com",
+        docsUrl: "https://hn.algolia.com/api",
+        autoDetectOrder: 160,
+        isConfigured: () => true,
+        createTool(ctx) {
+            const cfgSlot = readProviderConfigSlot({
+                cfg: ctx.config,
+                providerId: "hackernews",
+                kind: "search",
+            });
+            const sortByDate = cfgSlot.sortBy === "date";
+            const tags = cfgSlot.tags?.trim();
+            const timeoutMs = (ctx.runtime?.timeoutMs ?? DEFAULT_TIMEOUT_SECONDS * 1_000) | 0;
+            return {
+                description: "Hacker News search via Algolia — tech-news, startup signal, dev opinions.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        query: { type: "string" },
+                        count: { type: "integer", minimum: 1, maximum: 50 },
+                    },
+                    required: ["query"],
+                },
+                async execute(args, signal) {
+                    const query = String(args.query ?? "").trim();
+                    if (!query)
+                        throw new Error("hackernews: missing query");
+                    const hitsPerPage = Math.min(Math.max(Number(args.count ?? 10) | 0, 1), 50);
+                    const url = new URL(sortByDate ? HN_ENDPOINT_DATE : HN_ENDPOINT_RELEVANCE);
+                    url.searchParams.set("query", query);
+                    url.searchParams.set("hitsPerPage", String(hitsPerPage));
+                    if (tags)
+                        url.searchParams.set("tags", tags);
+                    const controller = new AbortController();
+                    const timer = setTimeout(() => controller.abort(new Error("timeout")), timeoutMs);
+                    timer.unref?.();
+                    const combined = mergeSignals([signal, controller.signal]);
+                    try {
+                        const response = await fetch(url.toString(), {
+                            method: "GET",
+                            headers: { accept: "application/json" },
+                            signal: combined,
+                        });
+                        const { text: body } = await readResponseText(response.body, 2_000_000);
+                        if (response.status !== 200) {
+                            const safe = body.replace(/[\x00-\x1f\x7f]/g, " ").slice(0, 200);
+                            throw new Error(`hackernews: HTTP ${response.status} — ${safe}`);
+                        }
+                        const data = (() => {
+                            try {
+                                return JSON.parse(body);
+                            }
+                            catch {
+                                throw new Error("hackernews: invalid JSON from upstream");
+                            }
+                        })();
+                        const rawHits = Array.isArray(data.hits) ? data.hits : [];
+                        const results = rawHits
+                            .map((h) => {
+                            const title = typeof h.title === "string"
+                                ? h.title.trim()
+                                : typeof h.story_title === "string"
+                                    ? h.story_title.trim()
+                                    : "";
+                            // External URL when the story has one (link post); else fall
+                            // back to the HN item page (text post / comment).
+                            const itemId = typeof h.objectID === "string" ? h.objectID : "";
+                            const externalUrl = typeof h.url === "string"
+                                ? h.url
+                                : typeof h.story_url === "string"
+                                    ? h.story_url
+                                    : "";
+                            const hnPermalink = itemId
+                                ? `https://news.ycombinator.com/item?id=${itemId}`
+                                : "";
+                            const finalUrl = externalUrl || hnPermalink;
+                            if (!title || !finalUrl)
+                                return null;
+                            // Snippet: author + score + comment count — gives the model
+                            // signal beyond the headline.
+                            const score = typeof h.points === "number" ? h.points : null;
+                            const comments = typeof h.num_comments === "number" ? h.num_comments : null;
+                            const author = typeof h.author === "string" ? h.author : null;
+                            const snippetParts = [];
+                            if (author)
+                                snippetParts.push(`by ${author}`);
+                            if (score !== null)
+                                snippetParts.push(`${score} points`);
+                            if (comments !== null)
+                                snippetParts.push(`${comments} comments`);
+                            const snippet = snippetParts.join(" · ") || undefined;
+                            const published = typeof h.created_at === "string" ? h.created_at : undefined;
+                            return wrapSearchHit({
+                                title,
+                                url: finalUrl,
+                                snippet,
+                                siteName: resolveSiteName(finalUrl),
+                                published,
+                                score: typeof score === "number" ? score : undefined,
+                            });
+                        })
+                            .filter((r) => r !== null);
+                        return { provider: "hackernews", results };
+                    }
+                    finally {
+                        clearTimeout(timer);
+                    }
+                },
+            };
+        },
+    };
+}
+export const hackerNewsModule = defineModule({
+    id: "hackernews",
+    register(b) {
+        b.webSearch(createHackerNewsSearchProvider());
+    },
+});
+export { createHackerNewsSearchProvider };
+//# sourceMappingURL=hackernews.js.map

package/dist/agents/extensions/modules/hackernews.js.map

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

package/dist/agents/extensions/modules/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Bundled (in-tree) Brigade extension modules.
+ *
+ * Each capability ships as a module that registers itself through the seam.
+ * They land here in build order: whatsapp first, then more channels, sub-agents,
+ * cron, voice, … User modules dropped in `~/.brigade/extensions/` are discovered
+ * + loaded by the loader alongside these (same gating) — see `discovery.ts`.
+ */
+import type { BrigadeModule } from "../types.js";
+export declare const BUNDLED_MODULES: BrigadeModule[];
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/extensions/modules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/agents/extensions/modules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,eAAe,EAAE,aAAa,EAwC1C,CAAC"}

package/dist/agents/extensions/modules/index.js

@@ -0,0 +1,64 @@
+/**
+ * Bundled (in-tree) Brigade extension modules.
+ *
+ * Each capability ships as a module that registers itself through the seam.
+ * They land here in build order: whatsapp first, then more channels, sub-agents,
+ * cron, voice, … User modules dropped in `~/.brigade/extensions/` are discovered
+ * + loaded by the loader alongside these (same gating) — see `discovery.ts`.
+ */
+import { whatsAppModule } from "../../channels/whatsapp/module.js";
+import { arxivModule } from "./arxiv.js";
+import { braveModule } from "./brave.js";
+import { duckduckgoModule } from "./duckduckgo.js";
+import { exaModule } from "./exa.js";
+import { firecrawlModule } from "./firecrawl.js";
+import { githubSearchModule } from "./github-search.js";
+import { hackerNewsModule } from "./hackernews.js";
+import { npmSearchModule } from "./npm-search.js";
+import { ollamaSearchModule } from "./ollama-search.js";
+import { perplexityModule } from "./perplexity.js";
+import { searxngModule } from "./searxng.js";
+import { tavilyModule } from "./tavily.js";
+import { wikipediaModule } from "./wikipedia.js";
+export const BUNDLED_MODULES = [
+    whatsAppModule,
+    // Web-fetch + web-search providers. Each module is inert unless its
+    // credential is configured (env var or `tools.web.{search,fetch}.providers.<id>`).
+    // The registry picks the active provider by `autoDetectOrder` ascending —
+    // lower wins — so the operator's preferred backend lands when configured.
+    //
+    //   autoDetectOrder priority — lower number = picked sooner:
+    //     10  Firecrawl fetch (key-gated, JS-heavy fallback)
+    //     20  Tavily search (AI-answer, one-shot RAG)
+    //     30  Brave search (structured native API)
+    //     40  Exa search (neural / content extraction)
+    //     45  Perplexity search (research-mode)
+    //     50  Firecrawl search (same key as fetch)
+    //     90  Ollama local web search (free when daemon running)
+    //     100 DuckDuckGo (keyless HTML scrape + Instant Answer fast-path)
+    //     150 Wikipedia (keyless, specialised: definitions / overviews)
+    //     160 Hacker News Algolia (keyless, specialised: tech / startup signal)
+    //     165 arXiv (keyless, specialised: research papers)
+    //     170 GitHub REST search (keyless 60/hr; token raises cap)
+    //     175 npm registry search (keyless, specialised: package discovery)
+    //     180 SearXNG (self-hosted, operator-supplied URL)
+    //
+    // The specialised keyless providers (Wikipedia / HN / arXiv / GitHub /
+    // npm) sort below DuckDuckGo so a vanilla query still goes to a
+    // general-purpose engine. The model addresses them by name via the
+    // per-call `provider: "<id>"` override on `web_search`.
+    arxivModule,
+    braveModule,
+    duckduckgoModule,
+    exaModule,
+    firecrawlModule,
+    githubSearchModule,
+    hackerNewsModule,
+    npmSearchModule,
+    ollamaSearchModule,
+    perplexityModule,
+    searxngModule,
+    tavilyModule,
+    wikipediaModule,
+];
+//# sourceMappingURL=index.js.map

package/dist/agents/extensions/modules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/agents/extensions/modules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAGjD,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC/C,cAAc;IACd,oEAAoE;IACpE,mFAAmF;IACnF,0EAA0E;IAC1E,0EAA0E;IAC1E,EAAE;IACF,6DAA6D;IAC7D,yDAAyD;IACzD,kDAAkD;IAClD,+CAA+C;IAC/C,mDAAmD;IACnD,4CAA4C;IAC5C,+CAA+C;IAC/C,6DAA6D;IAC7D,sEAAsE;IACtE,oEAAoE;IACpE,4EAA4E;IAC5E,wDAAwD;IACxD,+DAA+D;IAC/D,wEAAwE;IACxE,uDAAuD;IACvD,EAAE;IACF,uEAAuE;IACvE,gEAAgE;IAChE,mEAAmE;IACnE,wDAAwD;IACxD,WAAW;IACX,WAAW;IACX,gBAAgB;IAChB,SAAS;IACT,eAAe;IACf,kBAAkB;IAClB,gBAAgB;IAChB,eAAe;IACf,kBAAkB;IAClB,gBAAgB;IAChB,aAAa;IACb,YAAY;IACZ,eAAe;CACf,CAAC"}

package/dist/agents/extensions/modules/npm-search.d.ts

@@ -0,0 +1,15 @@
+/**
+ * npm registry search provider — keyless.
+ *
+ * Endpoint: `https://registry.npmjs.org/-/v1/search`. Returns top-level
+ * package metadata + popularity / quality / maintenance scores. No auth.
+ *
+ * Operator config (`tools.web.search.providers.npm`):
+ *   { quality?, popularity?, maintenance? }   // weights (0-1) the API
+ *                                              // uses to rank.
+ */
+import type { WebSearchProvider } from "../types.js";
+declare function createNpmSearchProvider(): WebSearchProvider;
+export declare const npmSearchModule: import("../types.js").BrigadeModule;
+export { createNpmSearchProvider };
+//# sourceMappingURL=npm-search.d.ts.map

package/dist/agents/extensions/modules/npm-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"npm-search.d.ts","sourceRoot":"","sources":["../../../../src/agents/extensions/modules/npm-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAIX,iBAAiB,EACjB,MAAM,aAAa,CAAC;AA6BrB,iBAAS,uBAAuB,IAAI,iBAAiB,CAuGpD;AAED,eAAO,MAAM,eAAe,qCAK1B,CAAC;AAEH,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/agents/extensions/modules/npm-search.js

@@ -0,0 +1,126 @@
+/**
+ * npm registry search provider — keyless.
+ *
+ * Endpoint: `https://registry.npmjs.org/-/v1/search`. Returns top-level
+ * package metadata + popularity / quality / maintenance scores. No auth.
+ *
+ * Operator config (`tools.web.search.providers.npm`):
+ *   { quality?, popularity?, maintenance? }   // weights (0-1) the API
+ *                                              // uses to rank.
+ */
+import { defineModule } from "../types.js";
+import { DEFAULT_TIMEOUT_SECONDS, readResponseText } from "../../tools/web-shared.js";
+import { readProviderConfigSlot, wrapSearchHit, mergeSignals, } from "./web-provider-helpers.js";
+function createNpmSearchProvider() {
+    return {
+        id: "npm",
+        label: "npm registry",
+        hint: "Search the public npm registry. Keyless. Ideal for finding packages by name/keyword.",
+        requiresCredential: false,
+        envVars: [],
+        signupUrl: "https://www.npmjs.com",
+        docsUrl: "https://github.com/npm/registry/blob/master/docs/REGISTRY-API.md#get-v1search",
+        autoDetectOrder: 175,
+        isConfigured: () => true,
+        createTool(ctx) {
+            const cfgSlot = readProviderConfigSlot({
+                cfg: ctx.config,
+                providerId: "npm",
+                kind: "search",
+            });
+            const timeoutMs = (ctx.runtime?.timeoutMs ?? DEFAULT_TIMEOUT_SECONDS * 1_000) | 0;
+            return {
+                description: "npm registry search. Returns package name + version + description + npm URL.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        query: { type: "string" },
+                        count: { type: "integer", minimum: 1, maximum: 25 },
+                    },
+                    required: ["query"],
+                },
+                async execute(args, signal) {
+                    const query = String(args.query ?? "").trim();
+                    if (!query)
+                        throw new Error("npm: missing query");
+                    const size = Math.min(Math.max(Number(args.count ?? 10) | 0, 1), 25);
+                    const url = new URL("https://registry.npmjs.org/-/v1/search");
+                    url.searchParams.set("text", query);
+                    url.searchParams.set("size", String(size));
+                    if (typeof cfgSlot.quality === "number") {
+                        url.searchParams.set("quality", String(cfgSlot.quality));
+                    }
+                    if (typeof cfgSlot.popularity === "number") {
+                        url.searchParams.set("popularity", String(cfgSlot.popularity));
+                    }
+                    if (typeof cfgSlot.maintenance === "number") {
+                        url.searchParams.set("maintenance", String(cfgSlot.maintenance));
+                    }
+                    const controller = new AbortController();
+                    const timer = setTimeout(() => controller.abort(new Error("timeout")), timeoutMs);
+                    timer.unref?.();
+                    const combined = mergeSignals([signal, controller.signal]);
+                    try {
+                        const response = await fetch(url.toString(), {
+                            method: "GET",
+                            headers: { accept: "application/json" },
+                            signal: combined,
+                        });
+                        const { text: body } = await readResponseText(response.body, 2_000_000);
+                        if (response.status !== 200) {
+                            const safe = body.replace(/[\x00-\x1f\x7f]/g, " ").slice(0, 200);
+                            throw new Error(`npm: HTTP ${response.status} — ${safe}`);
+                        }
+                        const data = (() => {
+                            try {
+                                return JSON.parse(body);
+                            }
+                            catch {
+                                throw new Error("npm: invalid JSON from upstream");
+                            }
+                        })();
+                        const objects = Array.isArray(data.objects) ? data.objects : [];
+                        const results = objects
+                            .map((o) => {
+                            const p = o.package;
+                            if (!p)
+                                return null;
+                            const name = typeof p.name === "string" ? p.name : "";
+                            const version = typeof p.version === "string" ? p.version : "";
+                            const description = typeof p.description === "string" ? p.description : "";
+                            const npmUrl = typeof p.links?.npm === "string"
+                                ? p.links.npm
+                                : name
+                                    ? `https://www.npmjs.com/package/${name}`
+                                    : "";
+                            if (!name || !npmUrl)
+                                return null;
+                            const finalScore = typeof o.score?.final === "number" ? o.score.final : undefined;
+                            return wrapSearchHit({
+                                title: version ? `${name}@${version}` : name,
+                                url: npmUrl,
+                                snippet: description || undefined,
+                                siteName: "npmjs.com",
+                                published: typeof p.date === "string" ? p.date : undefined,
+                                score: finalScore,
+                            });
+                        })
+                            .filter((r) => r !== null);
+                        return { provider: "npm", results };
+                    }
+                    finally {
+                        clearTimeout(timer);
+                    }
+                },
+            };
+        },
+    };
+}
+export const npmSearchModule = defineModule({
+    id: "npm-search",
+    register(b) {
+        b.webSearch(createNpmSearchProvider());
+    },
+});
+export { createNpmSearchProvider };
+//# sourceMappingURL=npm-search.js.map

package/dist/agents/extensions/modules/npm-search.js.map

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

package/dist/agents/extensions/modules/ollama-search.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Ollama local web-search provider — keyless when paired with a local
+ * Ollama instance running the experimental web-search endpoint.
+ *
+ * Ollama (the local model runtime) ships an `/api/experimental/web_search`
+ * endpoint that proxies the host's own search provider (the Ollama Cloud
+ * tier or a self-hosted SearchAPI). For Brigade, this is a clean keyless
+ * path: if the operator has `ollama` running locally, web_search is free.
+ *
+ * Endpoint: `${baseUrl}/api/experimental/web_search` (default base
+ * `http://localhost:11434`).
+ *
+ * Auth: usually none (local sockets). When the operator routes through
+ * Ollama Cloud, set `OLLAMA_API_KEY` and we send `Authorization: Bearer`.
+ *
+ * Operator config (`tools.web.search.providers.ollama`):
+ *   { baseUrl?, apiKey?, snippetMaxChars? }
+ */
+import type { WebSearchProvider } from "../types.js";
+interface OllamaConfig {
+    baseUrl?: string;
+    apiKey?: string;
+    snippetMaxChars?: number;
+}
+declare function resolveOllamaBaseUrl(cfgSlot: Partial<OllamaConfig>, env?: NodeJS.ProcessEnv): string;
+declare function resolveOllamaApiKey(cfgSlot: Partial<OllamaConfig>, env?: NodeJS.ProcessEnv): string | undefined;
+declare function createOllamaSearchProvider(): WebSearchProvider;
+export declare const ollamaSearchModule: import("../types.js").BrigadeModule;
+export { createOllamaSearchProvider, resolveOllamaBaseUrl, resolveOllamaApiKey };
+//# sourceMappingURL=ollama-search.d.ts.map

package/dist/agents/extensions/modules/ollama-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-search.d.ts","sourceRoot":"","sources":["../../../../src/agents/extensions/modules/ollama-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAIX,iBAAiB,EACjB,MAAM,aAAa,CAAC;AAcrB,UAAU,YAAY;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAYD,iBAAS,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAM7F;AAED,iBAAS,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS,CAOxG;AAOD,iBAAS,0BAA0B,IAAI,iBAAiB,CAwHvD;AAED,eAAO,MAAM,kBAAkB,qCAK7B,CAAC;AAEH,OAAO,EAAE,0BAA0B,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/agents/extensions/modules/ollama-search.js

@@ -0,0 +1,171 @@
+/**
+ * Ollama local web-search provider — keyless when paired with a local
+ * Ollama instance running the experimental web-search endpoint.
+ *
+ * Ollama (the local model runtime) ships an `/api/experimental/web_search`
+ * endpoint that proxies the host's own search provider (the Ollama Cloud
+ * tier or a self-hosted SearchAPI). For Brigade, this is a clean keyless
+ * path: if the operator has `ollama` running locally, web_search is free.
+ *
+ * Endpoint: `${baseUrl}/api/experimental/web_search` (default base
+ * `http://localhost:11434`).
+ *
+ * Auth: usually none (local sockets). When the operator routes through
+ * Ollama Cloud, set `OLLAMA_API_KEY` and we send `Authorization: Bearer`.
+ *
+ * Operator config (`tools.web.search.providers.ollama`):
+ *   { baseUrl?, apiKey?, snippetMaxChars? }
+ */
+import { defineModule } from "../types.js";
+import { DEFAULT_TIMEOUT_SECONDS, readResponseText } from "../../tools/web-shared.js";
+import { readProviderConfigSlot, resolveSiteName, sanitizeHeaderToken, wrapSearchHit, mergeSignals, } from "./web-provider-helpers.js";
+const OLLAMA_DEFAULT_BASE = "http://localhost:11434";
+const OLLAMA_SEARCH_PATH = "/api/experimental/web_search";
+const DEFAULT_SNIPPET_MAX = 300;
+function resolveOllamaBaseUrl(cfgSlot, env) {
+    const cfg = cfgSlot.baseUrl?.trim();
+    if (cfg)
+        return cfg.replace(/\/$/, "");
+    const e = env?.OLLAMA_HOST?.trim();
+    if (e)
+        return e.replace(/\/$/, "");
+    return OLLAMA_DEFAULT_BASE;
+}
+function resolveOllamaApiKey(cfgSlot, env) {
+    const cfg = cfgSlot.apiKey?.trim();
+    const e = env?.OLLAMA_API_KEY?.trim();
+    const raw = cfg || e;
+    if (!raw)
+        return undefined;
+    const cleaned = sanitizeHeaderToken(raw);
+    return cleaned.length > 0 ? cleaned : undefined;
+}
+function truncate(text, max) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max).trimEnd()}…`;
+}
+function createOllamaSearchProvider() {
+    return {
+        id: "ollama",
+        label: "Ollama (local web search)",
+        hint: "Use the Ollama runtime's web_search proxy. Free when Ollama runs locally.",
+        // Keyless when local; the apiKey path is OPTIONAL for Ollama Cloud users.
+        requiresCredential: false,
+        envVars: ["OLLAMA_HOST", "OLLAMA_API_KEY"],
+        signupUrl: "https://ollama.ai/download",
+        docsUrl: "https://docs.ollama.com/cloud",
+        placeholder: "http://localhost:11434",
+        // Loses to commercial keyed backends but beats DDG when the operator
+        // has OPTED IN — typically more reliable than HTML scraping.
+        autoDetectOrder: 90,
+        // OPT-IN ONLY. This endpoint proxies ollama.com's account-metered cloud
+        // search with a hard weekly quota — it must never be the silent default.
+        // (Production incident: a fresh-ish install auto-resolved here, burned
+        // the weekly quota dry mid-research, and with no fallback chain the
+        // agent lost web search entirely.) Configured =
+        //   - the operator wrote `tools.web.search.providers.ollama` in config
+        //     (even `{}` counts — presence is the opt-in), OR
+        //   - OLLAMA_API_KEY is exported (explicit Ollama Cloud setup).
+        // OLLAMA_HOST alone is NOT opt-in — that env var configures the chat
+        // runtime, and treating it as search opt-in would silently re-default
+        // every Ollama chat user onto the metered endpoint.
+        isConfigured: (cfg, env) => {
+            const slot = cfg.tools?.web?.search?.providers?.ollama;
+            return slot !== undefined || Boolean(env?.OLLAMA_API_KEY?.trim());
+        },
+        createTool(ctx) {
+            const cfgSlot = readProviderConfigSlot({
+                cfg: ctx.config,
+                providerId: "ollama",
+                kind: "search",
+            });
+            const baseUrl = resolveOllamaBaseUrl(cfgSlot, ctx.env);
+            const apiKey = resolveOllamaApiKey(cfgSlot, ctx.env);
+            const snippetMax = typeof cfgSlot.snippetMaxChars === "number" && cfgSlot.snippetMaxChars > 0
+                ? Math.floor(cfgSlot.snippetMaxChars)
+                : DEFAULT_SNIPPET_MAX;
+            const timeoutMs = (ctx.runtime?.timeoutMs ?? DEFAULT_TIMEOUT_SECONDS * 1_000) | 0;
+            return {
+                description: "Ollama runtime's web_search proxy (uses Ollama Cloud or a configured host backend).",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        query: { type: "string" },
+                        count: { type: "integer", minimum: 1, maximum: 25 },
+                    },
+                    required: ["query"],
+                },
+                async execute(args, signal) {
+                    const query = String(args.query ?? "").trim();
+                    if (!query)
+                        throw new Error("ollama: missing query");
+                    const max_results = Math.min(Math.max(Number(args.count ?? 10) | 0, 1), 25);
+                    const headers = { "content-type": "application/json" };
+                    if (apiKey)
+                        headers.authorization = `Bearer ${apiKey}`;
+                    const controller = new AbortController();
+                    const timer = setTimeout(() => controller.abort(new Error("timeout")), timeoutMs);
+                    timer.unref?.();
+                    const combined = mergeSignals([signal, controller.signal]);
+                    try {
+                        const response = await fetch(`${baseUrl}${OLLAMA_SEARCH_PATH}`, {
+                            method: "POST",
+                            headers,
+                            body: JSON.stringify({ query, max_results }),
+                            signal: combined,
+                        });
+                        const { text: rawBody } = await readResponseText(response.body, 2_000_000);
+                        if (response.status === 401) {
+                            throw new Error("ollama: web_search authentication failed. Run `ollama signin` for Ollama Cloud access, or unset OLLAMA_API_KEY for local use.");
+                        }
+                        if (response.status === 403) {
+                            throw new Error("ollama: web_search not enabled on this host. Enable cloud-backed web search in your Ollama settings.");
+                        }
+                        if (response.status !== 200) {
+                            const safe = rawBody.replace(/[\x00-\x1f\x7f]/g, " ").slice(0, 200);
+                            throw new Error(`ollama: HTTP ${response.status} — ${safe}`);
+                        }
+                        const data = (() => {
+                            try {
+                                return JSON.parse(rawBody);
+                            }
+                            catch {
+                                throw new Error("ollama: invalid JSON from upstream");
+                            }
+                        })();
+                        const rawHits = Array.isArray(data.results) ? data.results : [];
+                        const results = rawHits
+                            .slice(0, max_results)
+                            .map((h) => {
+                            const title = (h.title ?? "").trim();
+                            const url = (h.url ?? "").trim();
+                            if (!title || !url)
+                                return null;
+                            const snippet = (h.content ?? "").trim();
+                            return wrapSearchHit({
+                                title,
+                                url,
+                                snippet: snippet.length > 0 ? truncate(snippet, snippetMax) : undefined,
+                                siteName: resolveSiteName(url),
+                            });
+                        })
+                            .filter((r) => r !== null);
+                        return { provider: "ollama", results };
+                    }
+                    finally {
+                        clearTimeout(timer);
+                    }
+                },
+            };
+        },
+    };
+}
+export const ollamaSearchModule = defineModule({
+    id: "ollama-search",
+    register(b) {
+        b.webSearch(createOllamaSearchProvider());
+    },
+});
+export { createOllamaSearchProvider, resolveOllamaBaseUrl, resolveOllamaApiKey };
+//# sourceMappingURL=ollama-search.js.map

package/dist/agents/extensions/modules/ollama-search.js.map

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

package/dist/agents/extensions/modules/perplexity.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Perplexity web-search provider — structured search results.
+ *
+ * Two transports exist in Perplexity's ecosystem: the structured Search API
+ * (`/search`) and the Sonar chat-completions API (`/chat/completions` with
+ * built-in citations). Brigade ships the Search API for v1 because it
+ * returns clean URL hits without an extra "extract synthesized answer"
+ * step. The Sonar path is a future bolt-on.
+ *
+ * Endpoint: `https://api.perplexity.ai/search`. Auth: `Authorization: Bearer`.
+ *
+ * Operator config (`tools.web.search.providers.perplexity`):
+ *   { apiKey?, country?, searchRecencyFilter?, searchDomainFilter?[] }
+ */
+import type { WebSearchProvider } from "../types.js";
+declare function createPerplexitySearchProvider(): WebSearchProvider;
+export declare const perplexityModule: import("../types.js").BrigadeModule;
+export { createPerplexitySearchProvider };
+//# sourceMappingURL=perplexity.d.ts.map

package/dist/agents/extensions/modules/perplexity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perplexity.d.ts","sourceRoot":"","sources":["../../../../src/agents/extensions/modules/perplexity.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAIX,iBAAiB,EACjB,MAAM,aAAa,CAAC;AAkErB,iBAAS,8BAA8B,IAAI,iBAAiB,CA8M3D;AAsHD,eAAO,MAAM,gBAAgB,qCAK3B,CAAC;AAEH,OAAO,EAAE,8BAA8B,EAAE,CAAC"}