@spinabot/brigade 0.1.1 → 1.0.0

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

@@ -0,0 +1,489 @@
+/**
+ * Brave Search web-search provider — bundled, API-key-gated.
+ *
+ * Brave is the most reliable non-DDG fallback when the operator has an API
+ * key. Endpoint: `https://api.search.brave.com/res/v1/web/search`. Auth via
+ * `X-Subscription-Token`.
+ *
+ * Two operator-selectable modes:
+ *   - `web` (default): the documented ranked-results endpoint
+ *     (`/web/search`). Returns title/url/description triples + optional age.
+ *   - `llm-context`: Brave's pre-extracted snippets endpoint
+ *     (`/llm/context`). Useful when the agent is doing one-shot grounded
+ *     RAG — Brave returns multi-snippet rows + a `sources[]` array.
+ *
+ * Per-call agent args (forwarded via `web_search`): query, count,
+ * country, language, freshness, date_after, date_before, search_lang,
+ * ui_lang. Operator config at `tools.web.search.providers.brave` can pin
+ * any of the same params as defaults; per-call args override.
+ *
+ * Country / language / freshness / date-range inputs are validated against
+ * Brave's documented sets before they hit the wire. Invalid country
+ * coerces to "ALL"; invalid search_lang / ui_lang yields a typed error.
+ */
+import { defineModule } from "../types.js";
+import { DEFAULT_TIMEOUT_SECONDS, readResponseText } from "../../tools/web-shared.js";
+import { mergeSignals, readProviderConfigSlot, resolveProviderApiKey, resolveSiteName, wrapSearchHit, } from "./web-provider-helpers.js";
+import { normalizeFreshness, parseIsoDateRange, WEB_DOCS_URL, } from "./web-search-filters.js";
+const BRAVE_SEARCH_ENDPOINT = "https://api.search.brave.com/res/v1/web/search";
+const BRAVE_LLM_CONTEXT_ENDPOINT = "https://api.search.brave.com/res/v1/llm/context";
+/**
+ * Brave's documented country codes. Unknown values coerce to "ALL"
+ * (Brave's wildcard) so the request still goes through with safe defaults
+ * rather than 400'ing the call.
+ */
+const BRAVE_COUNTRY_CODES = new Set([
+    "AR",
+    "AU",
+    "AT",
+    "BE",
+    "BR",
+    "CA",
+    "CL",
+    "DK",
+    "FI",
+    "FR",
+    "DE",
+    "GR",
+    "HK",
+    "IN",
+    "ID",
+    "IT",
+    "JP",
+    "KR",
+    "MY",
+    "MX",
+    "NL",
+    "NZ",
+    "NO",
+    "CN",
+    "PL",
+    "PT",
+    "PH",
+    "RU",
+    "SA",
+    "ZA",
+    "ES",
+    "SE",
+    "CH",
+    "TW",
+    "TR",
+    "GB",
+    "US",
+    "ALL",
+]);
+const BRAVE_SEARCH_LANG_CODES = new Set([
+    "ar",
+    "eu",
+    "bn",
+    "bg",
+    "ca",
+    "zh-hans",
+    "zh-hant",
+    "hr",
+    "cs",
+    "da",
+    "nl",
+    "en",
+    "en-gb",
+    "et",
+    "fi",
+    "fr",
+    "gl",
+    "de",
+    "el",
+    "gu",
+    "he",
+    "hi",
+    "hu",
+    "is",
+    "it",
+    "jp",
+    "kn",
+    "ko",
+    "lv",
+    "lt",
+    "ms",
+    "ml",
+    "mr",
+    "nb",
+    "pl",
+    "pt-br",
+    "pt-pt",
+    "pa",
+    "ro",
+    "ru",
+    "sr",
+    "sk",
+    "sl",
+    "es",
+    "sv",
+    "ta",
+    "te",
+    "th",
+    "tr",
+    "uk",
+    "vi",
+]);
+const BRAVE_SEARCH_LANG_ALIASES = {
+    ja: "jp",
+    zh: "zh-hans",
+    "zh-cn": "zh-hans",
+    "zh-hk": "zh-hant",
+    "zh-sg": "zh-hans",
+    "zh-tw": "zh-hant",
+};
+const BRAVE_UI_LANG_LOCALE = /^([a-z]{2})-([a-z]{2})$/i;
+const MAX_BRAVE_SEARCH_COUNT = 25;
+function normalizeBraveCountry(raw) {
+    if (!raw)
+        return undefined;
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return undefined;
+    const upper = trimmed.toUpperCase();
+    // Invalid codes coerce to "ALL" (Brave's wildcard) rather than fail
+    // the request; undefined/empty input stays undefined so callers can
+    // decide whether to omit the parameter entirely.
+    return BRAVE_COUNTRY_CODES.has(upper) ? upper : "ALL";
+}
+function normalizeBraveSearchLang(raw) {
+    if (!raw)
+        return undefined;
+    const lower = raw.trim().toLowerCase();
+    if (!lower)
+        return undefined;
+    const canonical = BRAVE_SEARCH_LANG_ALIASES[lower] ?? lower;
+    return BRAVE_SEARCH_LANG_CODES.has(canonical) ? canonical : undefined;
+}
+function normalizeBraveUiLang(raw) {
+    if (!raw)
+        return undefined;
+    const v = raw.trim();
+    const match = v.match(BRAVE_UI_LANG_LOCALE);
+    if (!match)
+        return undefined;
+    const language = match[1];
+    const region = match[2];
+    if (!language || !region)
+        return undefined;
+    return `${language.toLowerCase()}-${region.toUpperCase()}`;
+}
+/**
+ * Auto-swap reversed search_lang / ui_lang. The model sometimes flips
+ * them (passes `search_lang: "en-US"` and `ui_lang: "en"`); if one looks
+ * like the OTHER's expected shape, swap before validating. Saves the
+ * agent from a "wrong field" round-trip.
+ */
+function normalizeBraveLanguageParams(params) {
+    const rawSearchLang = params.search_lang?.trim() || undefined;
+    const rawUiLang = params.ui_lang?.trim() || undefined;
+    let searchLangCandidate = rawSearchLang;
+    let uiLangCandidate = rawUiLang;
+    if (normalizeBraveUiLang(rawSearchLang) && normalizeBraveSearchLang(rawUiLang)) {
+        searchLangCandidate = rawUiLang;
+        uiLangCandidate = rawSearchLang;
+    }
+    const search_lang = normalizeBraveSearchLang(searchLangCandidate);
+    if (searchLangCandidate && !search_lang)
+        return { invalidField: "search_lang" };
+    const ui_lang = normalizeBraveUiLang(uiLangCandidate);
+    if (uiLangCandidate && !ui_lang)
+        return { invalidField: "ui_lang" };
+    return { search_lang, ui_lang };
+}
+function readStringArg(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+}
+function createBraveSearchProvider() {
+    return {
+        id: "brave",
+        label: "Brave Search",
+        hint: "Brave's web-search API. Structured JSON, no HTML scraping.",
+        requiresCredential: true,
+        envVars: ["BRAVE_API_KEY"],
+        signupUrl: "https://brave.com/search/api/",
+        docsUrl: "https://api-dashboard.search.brave.com/app/documentation",
+        placeholder: "BSA…",
+        autoDetectOrder: 30,
+        supportsFilters: true,
+        isConfigured(cfg, env) {
+            return (resolveProviderApiKey({
+                cfg,
+                env,
+                providerId: "brave",
+                kind: "search",
+                envVars: ["BRAVE_API_KEY"],
+            }) !== undefined);
+        },
+        createTool(ctx) {
+            const apiKey = resolveProviderApiKey({
+                cfg: ctx.config,
+                env: ctx.env,
+                providerId: "brave",
+                kind: "search",
+                envVars: ["BRAVE_API_KEY"],
+            });
+            if (!apiKey)
+                return null;
+            const cfgSlot = readProviderConfigSlot({
+                cfg: ctx.config,
+                providerId: "brave",
+                kind: "search",
+            });
+            const timeoutMs = (ctx.runtime?.timeoutMs ?? DEFAULT_TIMEOUT_SECONDS * 1_000) | 0;
+            return {
+                description: "Brave Search — structured JSON results with title, URL, and snippet. Supports country, language, freshness (pd/pw/pm/py), and ISO date ranges.",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        query: { type: "string", description: "Search query string." },
+                        count: {
+                            type: "integer",
+                            minimum: 1,
+                            maximum: MAX_BRAVE_SEARCH_COUNT,
+                            description: "Number of results to return (1-25).",
+                        },
+                        country: {
+                            type: "string",
+                            description: "2-letter country code for region-specific results (e.g., 'DE', 'US', 'ALL'). Unknown codes coerce to 'ALL'.",
+                        },
+                        language: {
+                            type: "string",
+                            description: "ISO 639-1 language code (e.g., 'en', 'de', 'fr'). Alias of search_lang.",
+                        },
+                        search_lang: {
+                            type: "string",
+                            description: "Brave language code for search results (e.g., 'en', 'de', 'en-gb', 'zh-hans', 'zh-hant', 'pt-br').",
+                        },
+                        ui_lang: {
+                            type: "string",
+                            description: "Locale code for UI elements in language-region format (e.g., 'en-US', 'de-DE'). Must include region subtag.",
+                        },
+                        freshness: {
+                            type: "string",
+                            description: "Filter by recency: 'pd' (24h), 'pw' (week), 'pm' (month), 'py' (year), or a YYYY-MM-DDtoYYYY-MM-DD range.",
+                        },
+                        date_after: {
+                            type: "string",
+                            description: "Only results published on or after this date (YYYY-MM-DD).",
+                        },
+                        date_before: {
+                            type: "string",
+                            description: "Only results published on or before this date (YYYY-MM-DD).",
+                        },
+                    },
+                    required: ["query"],
+                },
+                async execute(args, signal) {
+                    const a = (args ?? {});
+                    const query = String(a.query ?? "").trim();
+                    if (!query)
+                        throw new Error("brave: missing query");
+                    const count = Math.min(Math.max(Number(a.count ?? 10) | 0, 1), MAX_BRAVE_SEARCH_COUNT);
+                    const mode = cfgSlot.mode === "llm-context" ? "llm-context" : "web";
+                    // llm-context endpoint is grounded-RAG only — freshness +
+                    // date_after/before are silently ignored by Brave. Surface
+                    // a typed error so the agent learns which mode to pick
+                    // instead of getting unfiltered results back.
+                    if (mode === "llm-context") {
+                        for (const field of ["freshness", "date_after", "date_before"]) {
+                            const value = readStringArg(a[field]);
+                            if (value) {
+                                return {
+                                    provider: "brave",
+                                    error: field === "freshness"
+                                        ? "unsupported_freshness"
+                                        : "unsupported_date_filter",
+                                    message: `${field === "freshness" ? "freshness" : "date_after/date_before"} is not supported by Brave's llm-context mode. Switch the provider config to mode=\"web\" to enable date filtering.`,
+                                    docs: WEB_DOCS_URL,
+                                };
+                            }
+                        }
+                    }
+                    const endpoint = mode === "llm-context" ? BRAVE_LLM_CONTEXT_ENDPOINT : BRAVE_SEARCH_ENDPOINT;
+                    const url = new URL(endpoint);
+                    url.searchParams.set("q", query);
+                    if (mode === "web")
+                        url.searchParams.set("count", String(count));
+                    // Country: per-call > config > "ALL".
+                    const country = normalizeBraveCountry(readStringArg(a.country) ?? cfgSlot.country);
+                    if (country)
+                        url.searchParams.set("country", country);
+                    // Language: prefer search_lang; fall back to `language` shorthand;
+                    // fall back to operator config.
+                    const rawSearchLang = readStringArg(a.search_lang) ??
+                        readStringArg(a.language) ??
+                        cfgSlot.search_lang;
+                    const rawUiLang = readStringArg(a.ui_lang) ?? cfgSlot.ui_lang;
+                    const langResult = normalizeBraveLanguageParams({
+                        search_lang: rawSearchLang,
+                        ui_lang: rawUiLang,
+                    });
+                    if (langResult.invalidField === "search_lang") {
+                        return {
+                            provider: "brave",
+                            error: "invalid_search_lang",
+                            message: `Invalid search_lang \"${rawSearchLang}\". Use a Brave language code such as 'en', 'de', 'pt-br', 'zh-hans'.`,
+                            docs: WEB_DOCS_URL,
+                        };
+                    }
+                    if (langResult.invalidField === "ui_lang") {
+                        return {
+                            provider: "brave",
+                            error: "invalid_ui_lang",
+                            message: `Invalid ui_lang \"${rawUiLang}\". Use language-region form like 'en-US' or 'de-DE'.`,
+                            docs: WEB_DOCS_URL,
+                        };
+                    }
+                    if (langResult.search_lang)
+                        url.searchParams.set("search_lang", langResult.search_lang);
+                    if (mode === "web" && langResult.ui_lang)
+                        url.searchParams.set("ui_lang", langResult.ui_lang);
+                    // Freshness OR explicit date range (mutually exclusive — freshness wins).
+                    if (mode === "web") {
+                        const rawFreshness = readStringArg(a.freshness) ?? cfgSlot.freshness;
+                        const freshness = normalizeFreshness(rawFreshness, "brave");
+                        if (rawFreshness && !freshness) {
+                            return {
+                                provider: "brave",
+                                error: "invalid_freshness",
+                                message: `Invalid freshness \"${rawFreshness}\". Use pd, pw, pm, py, or a YYYY-MM-DDtoYYYY-MM-DD range.`,
+                                docs: WEB_DOCS_URL,
+                            };
+                        }
+                        if (freshness) {
+                            url.searchParams.set("freshness", freshness);
+                        }
+                        else {
+                            const rawAfter = readStringArg(a.date_after) ?? cfgSlot.dateAfter;
+                            const rawBefore = readStringArg(a.date_before) ?? cfgSlot.dateBefore;
+                            const range = parseIsoDateRange({
+                                rawDateAfter: rawAfter,
+                                rawDateBefore: rawBefore,
+                                invalidDateAfterMessage: `Invalid date_after \"${rawAfter}\". Use YYYY-MM-DD.`,
+                                invalidDateBeforeMessage: `Invalid date_before \"${rawBefore}\". Use YYYY-MM-DD.`,
+                                invalidDateRangeMessage: "date_after must be on or before date_before.",
+                                docs: WEB_DOCS_URL,
+                            });
+                            if ("error" in range) {
+                                return { provider: "brave", ...range };
+                            }
+                            if (range.dateAfter && range.dateBefore) {
+                                url.searchParams.set("freshness", `${range.dateAfter}to${range.dateBefore}`);
+                            }
+                            else if (range.dateAfter) {
+                                const today = new Date().toISOString().slice(0, 10);
+                                url.searchParams.set("freshness", `${range.dateAfter}to${today}`);
+                            }
+                            else if (range.dateBefore) {
+                                url.searchParams.set("freshness", `1970-01-01to${range.dateBefore}`);
+                            }
+                        }
+                    }
+                    // Manual fetch (Brave is a trusted public endpoint — SSRF guard
+                    // not needed). Cache key handled upstream by web-search.ts.
+                    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",
+                                "x-subscription-token": apiKey,
+                            },
+                            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(`brave: HTTP ${response.status} — ${safe}`);
+                        }
+                        if (mode === "llm-context") {
+                            const data = (() => {
+                                try {
+                                    return JSON.parse(body);
+                                }
+                                catch {
+                                    throw new Error("brave: invalid JSON from upstream (llm-context)");
+                                }
+                            })();
+                            const entries = Array.isArray(data.grounding?.generic)
+                                ? data.grounding.generic
+                                : [];
+                            const results = entries
+                                .map((entry) => {
+                                const title = (entry.title ?? "").trim();
+                                const u = (entry.url ?? "").trim();
+                                if (!title || !u)
+                                    return null;
+                                const snippetList = Array.isArray(entry.snippets)
+                                    ? entry.snippets.filter((s) => typeof s === "string" && s.length > 0)
+                                    : [];
+                                const merged = snippetList.join("\n\n").trim();
+                                return wrapSearchHit({
+                                    title,
+                                    url: u,
+                                    snippet: merged.length > 0 ? merged : undefined,
+                                    siteName: resolveSiteName(u),
+                                });
+                            })
+                                .filter((h) => h !== null);
+                            return {
+                                provider: "brave",
+                                mode,
+                                results,
+                                sources: data.sources,
+                            };
+                        }
+                        const data = (() => {
+                            try {
+                                return JSON.parse(body);
+                            }
+                            catch {
+                                throw new Error("brave: invalid JSON from upstream");
+                            }
+                        })();
+                        const rawHits = Array.isArray(data.web?.results) ? data.web.results : [];
+                        const results = rawHits
+                            .map((hit) => {
+                            const title = (hit.title ?? "").trim();
+                            const u = (hit.url ?? "").trim();
+                            if (!title || !u)
+                                return null;
+                            return wrapSearchHit({
+                                title,
+                                url: u,
+                                snippet: (hit.description ?? "").trim() || undefined,
+                                siteName: resolveSiteName(u),
+                                published: hit.age,
+                            });
+                        })
+                            .filter((h) => h !== null);
+                        return {
+                            provider: "brave",
+                            mode,
+                            results,
+                        };
+                    }
+                    finally {
+                        clearTimeout(timer);
+                    }
+                },
+            };
+        },
+    };
+}
+export const braveModule = defineModule({
+    id: "brave",
+    register(b) {
+        b.webSearch(createBraveSearchProvider());
+    },
+});
+export { createBraveSearchProvider };
+//# sourceMappingURL=brave.js.map

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

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

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

@@ -0,0 +1,27 @@
+/**
+ * DuckDuckGo web-search provider — bundled, zero-config.
+ *
+ * Hits the `html.duckduckgo.com/html` endpoint (the lite, no-JS search page)
+ * with a normal browser User-Agent, parses the resulting HTML for result
+ * rows, and returns title/url/snippet triples. No API key required, no
+ * card-on-file, no signup — works on a clean Brigade install.
+ *
+ * Trade-off: HTML scraping breaks when DDG changes its layout. Pair with
+ * a JSON-API-backed provider (Tavily / Brave) as a second module when
+ * production reliability matters.
+ */
+import type { WebSearchProvider } from "../types.js";
+/** Unwrap DDG's `/l/?uddg=<encoded>` redirector to the original URL. */
+declare function unwrapDdgUrl(rawHref: string): string;
+/** Parse the DDG HTML response into normalized hit objects. */
+declare function parseDdgResults(html: string, count: number): Array<{
+    title: string;
+    url: string;
+    snippet?: string;
+}>;
+/** Build the DuckDuckGo provider. Zero-config — no envVar, no API key. */
+declare function createDuckDuckGoProvider(): WebSearchProvider;
+/** Brigade module — registers the DuckDuckGo provider via `b.webSearch`. */
+export declare const duckduckgoModule: import("../types.js").BrigadeModule;
+export { createDuckDuckGoProvider, parseDdgResults, unwrapDdgUrl };
+//# sourceMappingURL=duckduckgo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"duckduckgo.d.ts","sourceRoot":"","sources":["../../../../src/agents/extensions/modules/duckduckgo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAIX,iBAAiB,EACjB,MAAM,aAAa,CAAC;AAoBrB,wEAAwE;AACxE,iBAAS,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAW7C;AAOD,+DAA+D;AAC/D,iBAAS,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkB7G;AA8GD,0EAA0E;AAC1E,iBAAS,wBAAwB,IAAI,iBAAiB,CAuGrD;AAED,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,qCAK3B,CAAC;AAGH,OAAO,EAAE,wBAAwB,EAAE,eAAe,EAAE,YAAY,EAAE,CAAC"}