@spinabot/brigade 0.1.2 → 1.0.1

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

@@ -0,0 +1,280 @@
+/**
+ * Firecrawl web-fetch + web-search provider — bundled, API-key-gated.
+ *
+ * **Fetch path** falls back from the built-in raw HTTP fetcher when:
+ *   - the page is JS-heavy (built-in returns empty / shell HTML)
+ *   - the upstream blocks Node's default User-Agent
+ *   - the built-in throws a network error
+ *   - Readability bails on a JS-heavy page (provider beats regex fallback)
+ *
+ * Hits `https://api.firecrawl.dev/v2/scrape` with the configured API key,
+ * asks for `markdown` format, and returns the markdown + metadata.
+ *
+ * **Search path** is the `/v2/search` endpoint — used as the default
+ * `web_search` provider when Firecrawl is configured. The operator can pin a
+ * different search provider via `tools.web.search.provider: "<id>"`.
+ *
+ * Operator config (set in `brigade.json`):
+ *   tools.web.fetch.providers.firecrawl: {
+ *     apiKey?, proxy?, storeInCache?, maxAgeMs?, timeoutSeconds?, onlyMainContent?
+ *   }
+ *   tools.web.search.providers.firecrawl: {
+ *     apiKey? (shared with fetch), sources?, categories?, scrapeResults?
+ *   }
+ *
+ * Sign-up at https://firecrawl.dev (free tier ~500 pages/mo).
+ */
+import { defineModule } from "../types.js";
+import { DEFAULT_TIMEOUT_SECONDS, readResponseText } from "../../tools/web-shared.js";
+import { mergeSignals, resolveSiteName, sanitizeHeaderToken, wrapSearchHit, } from "./web-provider-helpers.js";
+const FIRECRAWL_SCRAPE_ENDPOINT = "https://api.firecrawl.dev/v2/scrape";
+const FIRECRAWL_SEARCH_ENDPOINT = "https://api.firecrawl.dev/v2/search";
+/* ─────────────────────────── shared key resolver ─────────────────────────── */
+/** Pull the Firecrawl API key from config OR env. Sanitized for safe header use. */
+function resolveFirecrawlApiKey(cfg, env) {
+    const cfgKey = cfg.tools?.web?.fetch?.providers?.firecrawl?.apiKey?.trim();
+    const envKey = env?.FIRECRAWL_API_KEY?.trim();
+    const raw = cfgKey || envKey;
+    if (!raw)
+        return undefined;
+    const cleaned = sanitizeHeaderToken(raw);
+    return cleaned.length > 0 ? cleaned : undefined;
+}
+function readFirecrawlFetchConfig(cfg) {
+    const slot = cfg.tools?.web?.fetch?.providers?.firecrawl;
+    return slot ?? {};
+}
+function readFirecrawlSearchConfig(cfg) {
+    const slot = cfg.tools?.web?.search?.providers?.firecrawl;
+    return slot ?? {};
+}
+async function postFirecrawl(opts) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(new Error("timeout")), opts.timeoutMs);
+    timer.unref?.();
+    const combined = mergeSignals([opts.signal, controller.signal]);
+    try {
+        const response = await fetch(opts.endpoint, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                authorization: `Bearer ${opts.apiKey}`,
+            },
+            body: JSON.stringify(opts.body),
+            signal: combined,
+        });
+        const { text: rawBody } = await readResponseText(response.body, 2_000_000);
+        if (response.status !== 200) {
+            // Strip control chars and cap before surfacing — the upstream body
+            // is attacker-influenceable text and lands in a thrown Error.message.
+            const safeSnippet = rawBody.replace(/[\x00-\x1f\x7f]/g, " ").slice(0, 200);
+            throw new Error(`firecrawl: HTTP ${response.status} — ${safeSnippet}`);
+        }
+        const json = (() => {
+            try {
+                return JSON.parse(rawBody);
+            }
+            catch {
+                return null;
+            }
+        })();
+        if (!json || json.success === false) {
+            const errMsg = typeof json?.error === "string"
+                ? json.error
+                : "firecrawl returned no success payload";
+            throw new Error(`firecrawl: ${errMsg}`);
+        }
+        return json;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/* ─────────────────────────── fetch provider ─────────────────────────── */
+function createFirecrawlFetchProvider() {
+    return {
+        id: "firecrawl",
+        label: "Firecrawl",
+        hint: "Hosted scraping API. Best fallback for JS-heavy / bot-blocked pages.",
+        requiresCredential: true,
+        envVars: ["FIRECRAWL_API_KEY"],
+        signupUrl: "https://firecrawl.dev",
+        docsUrl: "https://docs.firecrawl.dev/api-reference/endpoint/scrape",
+        placeholder: "fc-…",
+        autoDetectOrder: 10,
+        isConfigured(cfg, env) {
+            return resolveFirecrawlApiKey(cfg, env) !== undefined;
+        },
+        createTool(ctx) {
+            const apiKey = resolveFirecrawlApiKey(ctx.config, ctx.env);
+            if (!apiKey)
+                return null;
+            const fetchCfg = readFirecrawlFetchConfig(ctx.config);
+            const configuredTimeoutSec = fetchCfg.timeoutSeconds;
+            const fallbackTimeoutMs = (ctx.runtime?.timeoutMs ?? DEFAULT_TIMEOUT_SECONDS * 1_000) | 0;
+            const timeoutMs = typeof configuredTimeoutSec === "number" && configuredTimeoutSec > 0
+                ? (configuredTimeoutSec * 1_000) | 0
+                : fallbackTimeoutMs;
+            return {
+                description: "Firecrawl scrape (markdown extraction with JS rendering).",
+                parameters: {
+                    type: "object",
+                    properties: {
+                        url: { type: "string" },
+                        extractMode: { type: "string", enum: ["markdown", "text"] },
+                        maxChars: { type: "integer" },
+                    },
+                    required: ["url"],
+                },
+                async execute(args, signal) {
+                    const url = String(args.url ?? "").trim();
+                    if (!url)
+                        throw new Error("firecrawl: missing url");
+                    // Build the request body with operator-configurable knobs.
+                    // Default `onlyMainContent: true` — best fit for one-shot model
+                    // consumption.
+                    const body = {
+                        url,
+                        formats: ["markdown"],
+                        onlyMainContent: fetchCfg.onlyMainContent ?? true,
+                    };
+                    if (fetchCfg.proxy === "auto" || fetchCfg.proxy === "basic" || fetchCfg.proxy === "stealth") {
+                        body.proxy = fetchCfg.proxy;
+                    }
+                    if (typeof fetchCfg.storeInCache === "boolean") {
+                        body.storeInCache = fetchCfg.storeInCache;
+                    }
+                    if (typeof fetchCfg.maxAgeMs === "number" && fetchCfg.maxAgeMs >= 0) {
+                        body.maxAge = fetchCfg.maxAgeMs;
+                    }
+                    if (typeof configuredTimeoutSec === "number" && configuredTimeoutSec > 0) {
+                        body.timeout = configuredTimeoutSec * 1_000;
+                    }
+                    const json = await postFirecrawl({
+                        endpoint: FIRECRAWL_SCRAPE_ENDPOINT,
+                        apiKey,
+                        body,
+                        timeoutMs,
+                        signal,
+                    });
+                    const data = json.data;
+                    const markdown = typeof data?.markdown === "string"
+                        ? data.markdown
+                        : typeof data?.content === "string"
+                            ? data.content
+                            : "";
+                    const metadata = (data?.metadata ?? {});
+                    return {
+                        provider: "firecrawl",
+                        url,
+                        finalUrl: typeof metadata.sourceURL === "string" ? metadata.sourceURL : url,
+                        status: typeof metadata.statusCode === "number" ? metadata.statusCode : 200,
+                        contentType: "text/markdown",
+                        title: typeof metadata.title === "string" ? metadata.title : undefined,
+                        text: markdown,
+                        rawLength: markdown.length,
+                        extractor: "firecrawl",
+                    };
+                },
+            };
+        },
+    };
+}
+/* ─────────────────────────── search provider ─────────────────────────── */
+function createFirecrawlSearchProvider() {
+    return {
+        id: "firecrawl",
+        label: "Firecrawl Search",
+        hint: "Firecrawl's /v2/search endpoint. Same API key as Firecrawl scrape.",
+        requiresCredential: true,
+        envVars: ["FIRECRAWL_API_KEY"],
+        signupUrl: "https://firecrawl.dev",
+        docsUrl: "https://docs.firecrawl.dev/api-reference/endpoint/search",
+        placeholder: "fc-…",
+        // `firecrawl` keyed beats DuckDuckGo (200) but loses to the operator
+        // picking a structured/paid provider explicitly.
+        autoDetectOrder: 50,
+        isConfigured(cfg, env) {
+            return resolveFirecrawlApiKey(cfg, env) !== undefined;
+        },
+        createTool(ctx) {
+            const apiKey = resolveFirecrawlApiKey(ctx.config, ctx.env);
+            if (!apiKey)
+                return null;
+            const searchCfg = readFirecrawlSearchConfig(ctx.config);
+            const timeoutMs = (ctx.runtime?.timeoutMs ?? DEFAULT_TIMEOUT_SECONDS * 1_000) | 0;
+            return {
+                description: "Search the web via Firecrawl. Returns ranked URL hits with titles + snippets.",
+                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("firecrawl_search: missing query");
+                    const count = Math.min(Math.max(Number(args.count ?? 10) | 0, 1), 25);
+                    const body = { query, limit: count };
+                    if (Array.isArray(searchCfg.sources) && searchCfg.sources.length > 0) {
+                        body.sources = searchCfg.sources;
+                    }
+                    if (Array.isArray(searchCfg.categories) && searchCfg.categories.length > 0) {
+                        body.categories = searchCfg.categories;
+                    }
+                    if (searchCfg.scrapeResults === true) {
+                        body.scrapeOptions = { formats: ["markdown"] };
+                    }
+                    const json = await postFirecrawl({
+                        endpoint: FIRECRAWL_SEARCH_ENDPOINT,
+                        apiKey,
+                        body,
+                        timeoutMs,
+                        signal,
+                    });
+                    const rawData = (json.data ?? json.web ?? []);
+                    const hits = Array.isArray(rawData)
+                        ? rawData.filter((h) => !!h && typeof h === "object")
+                        : [];
+                    // Every other web-search provider routes through
+                    // `wrapSearchHit` so attacker-controllable title /
+                    // snippet / siteName fields can't escape the untrusted-
+                    // content envelope. Firecrawl was the outlier — fix it.
+                    const results = hits
+                        .map((hit) => {
+                        const title = typeof hit.title === "string" ? hit.title.trim() : "";
+                        const url = typeof hit.url === "string" ? hit.url.trim() : "";
+                        if (!title || !url)
+                            return null;
+                        const rawSnippet = typeof hit.description === "string"
+                            ? hit.description
+                            : typeof hit.snippet === "string"
+                                ? hit.snippet
+                                : "";
+                        const snippet = rawSnippet.trim();
+                        return wrapSearchHit({
+                            title,
+                            url,
+                            snippet: snippet.length > 0 ? snippet : undefined,
+                            siteName: resolveSiteName(url),
+                        });
+                    })
+                        .filter((r) => r !== null);
+                    return { provider: "firecrawl", results };
+                },
+            };
+        },
+    };
+}
+export const firecrawlModule = defineModule({
+    id: "firecrawl",
+    register(b) {
+        b.webFetch(createFirecrawlFetchProvider());
+        b.webSearch(createFirecrawlSearchProvider());
+    },
+});
+export { createFirecrawlFetchProvider, createFirecrawlSearchProvider, readFirecrawlFetchConfig, readFirecrawlSearchConfig, resolveFirecrawlApiKey, };
+//# sourceMappingURL=firecrawl.js.map

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

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

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

@@ -0,0 +1,29 @@
+/**
+ * GitHub search provider — keyless by default.
+ *
+ * GitHub's REST search API is open without auth (capped at 60 req/hr per
+ * IP). With a token (PAT or `gh auth token`), the cap rises to 5 000/hr.
+ *
+ * Endpoint family: `https://api.github.com/search/{repositories|code|issues|users}`
+ *
+ * Operator config (`tools.web.search.providers.github`):
+ *   { token?, target?, sort?, order? }
+ *     target: 'repositories' | 'code' | 'issues' | 'users' (default 'repositories')
+ *     sort:   'stars' | 'forks' | 'updated' | 'help-wanted-issues'  (per target)
+ *     order:  'asc' | 'desc' (default desc)
+ *
+ * Auth: optional `GITHUB_TOKEN` env or config.token.
+ */
+import type { WebSearchProvider } from "../types.js";
+type GhTarget = "repositories" | "code" | "issues" | "users";
+interface GithubConfig {
+    token?: string;
+    target?: GhTarget;
+    sort?: string;
+    order?: "asc" | "desc";
+}
+declare function resolveGithubToken(cfgSlot: Partial<GithubConfig>, env?: NodeJS.ProcessEnv): string | undefined;
+declare function createGithubSearchProvider(): WebSearchProvider;
+export declare const githubSearchModule: import("../types.js").BrigadeModule;
+export { createGithubSearchProvider, resolveGithubToken };
+//# sourceMappingURL=github-search.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"github-search.d.ts","sourceRoot":"","sources":["../../../../src/agents/extensions/modules/github-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAIX,iBAAiB,EACjB,MAAM,aAAa,CAAC;AAUrB,KAAK,QAAQ,GAAG,cAAc,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE7D,UAAU,YAAY;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CACvB;AAgCD,iBAAS,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,GAAG,SAAS,CAOvG;AAED,iBAAS,0BAA0B,IAAI,iBAAiB,CA4FvD;AAkED,eAAO,MAAM,kBAAkB,qCAK7B,CAAC;AAEH,OAAO,EAAE,0BAA0B,EAAE,kBAAkB,EAAE,CAAC"}

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

@@ -0,0 +1,197 @@
+/**
+ * GitHub search provider — keyless by default.
+ *
+ * GitHub's REST search API is open without auth (capped at 60 req/hr per
+ * IP). With a token (PAT or `gh auth token`), the cap rises to 5 000/hr.
+ *
+ * Endpoint family: `https://api.github.com/search/{repositories|code|issues|users}`
+ *
+ * Operator config (`tools.web.search.providers.github`):
+ *   { token?, target?, sort?, order? }
+ *     target: 'repositories' | 'code' | 'issues' | 'users' (default 'repositories')
+ *     sort:   'stars' | 'forks' | 'updated' | 'help-wanted-issues'  (per target)
+ *     order:  'asc' | 'desc' (default desc)
+ *
+ * Auth: optional `GITHUB_TOKEN` env or config.token.
+ */
+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";
+function resolveGithubToken(cfgSlot, env) {
+    const cfg = cfgSlot.token?.trim();
+    const e = env?.GITHUB_TOKEN?.trim() ?? env?.GH_TOKEN?.trim();
+    const raw = cfg || e;
+    if (!raw)
+        return undefined;
+    const cleaned = sanitizeHeaderToken(raw);
+    return cleaned.length > 0 ? cleaned : undefined;
+}
+function createGithubSearchProvider() {
+    return {
+        id: "github",
+        label: "GitHub",
+        hint: "GitHub's REST search API. Keyless (60 req/hr); token raises cap to 5 000/hr.",
+        // Technically keyless — we mark requiresCredential false so the
+        // provider activates without a token. The token is OPTIONAL.
+        requiresCredential: false,
+        envVars: ["GITHUB_TOKEN", "GH_TOKEN"],
+        signupUrl: "https://github.com",
+        docsUrl: "https://docs.github.com/en/rest/search/search",
+        autoDetectOrder: 170,
+        isConfigured: () => true,
+        createTool(ctx) {
+            const cfgSlot = readProviderConfigSlot({
+                cfg: ctx.config,
+                providerId: "github",
+                kind: "search",
+            });
+            const token = resolveGithubToken(cfgSlot, ctx.env);
+            const target = cfgSlot.target || "repositories";
+            const sort = cfgSlot.sort?.trim();
+            const order = cfgSlot.order === "asc" ? "asc" : "desc";
+            const timeoutMs = (ctx.runtime?.timeoutMs ?? DEFAULT_TIMEOUT_SECONDS * 1_000) | 0;
+            return {
+                description: `GitHub search (${target}). Returns repo / code / issue / user matches with stars + author metadata.`,
+                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("github: missing query");
+                    const per_page = Math.min(Math.max(Number(args.count ?? 10) | 0, 1), 50);
+                    const url = new URL(`https://api.github.com/search/${target}`);
+                    url.searchParams.set("q", query);
+                    url.searchParams.set("per_page", String(per_page));
+                    if (sort)
+                        url.searchParams.set("sort", sort);
+                    url.searchParams.set("order", order);
+                    const headers = {
+                        accept: "application/vnd.github+json",
+                        "x-github-api-version": "2022-11-28",
+                        "user-agent": "Brigade/1.0",
+                    };
+                    if (token)
+                        headers.authorization = `Bearer ${token}`;
+                    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,
+                            signal: combined,
+                        });
+                        const { text: body } = await readResponseText(response.body, 2_000_000);
+                        if (response.status === 403 && /rate limit/i.test(body)) {
+                            throw new Error("github: rate-limit hit (60 req/hr keyless). Set GITHUB_TOKEN env or tools.web.search.providers.github.token for 5 000/hr.");
+                        }
+                        if (response.status !== 200) {
+                            const safe = body.replace(/[\x00-\x1f\x7f]/g, " ").slice(0, 200);
+                            throw new Error(`github: HTTP ${response.status} — ${safe}`);
+                        }
+                        const data = (() => {
+                            try {
+                                return JSON.parse(body);
+                            }
+                            catch {
+                                throw new Error("github: invalid JSON from upstream");
+                            }
+                        })();
+                        const items = Array.isArray(data.items) ? data.items : [];
+                        const results = items
+                            .map((raw) => mapGhItem(raw, target))
+                            .filter((r) => r !== null);
+                        return { provider: "github", target, results };
+                    }
+                    finally {
+                        clearTimeout(timer);
+                    }
+                },
+            };
+        },
+    };
+}
+function mapGhItem(raw, target) {
+    switch (target) {
+        case "repositories": {
+            const r = raw;
+            const title = typeof r.full_name === "string" ? r.full_name : "";
+            const url = typeof r.html_url === "string" ? r.html_url : "";
+            if (!title || !url)
+                return null;
+            const snippetParts = [];
+            if (typeof r.description === "string" && r.description)
+                snippetParts.push(r.description);
+            if (typeof r.stargazers_count === "number")
+                snippetParts.push(`★ ${r.stargazers_count}`);
+            return wrapSearchHit({
+                title,
+                url,
+                snippet: snippetParts.join(" · ") || undefined,
+                siteName: resolveSiteName(url),
+                published: typeof r.updated_at === "string" ? r.updated_at : undefined,
+            });
+        }
+        case "code": {
+            const r = raw;
+            const repo = typeof r.repository?.full_name === "string" ? r.repository.full_name : "";
+            const path = typeof r.path === "string" ? r.path : "";
+            const title = repo && path ? `${repo}/${path}` : (typeof r.name === "string" ? r.name : "");
+            const url = typeof r.html_url === "string" ? r.html_url : "";
+            if (!title || !url)
+                return null;
+            return wrapSearchHit({ title, url, siteName: resolveSiteName(url) });
+        }
+        case "issues": {
+            const r = raw;
+            const title = typeof r.title === "string" ? r.title : "";
+            const url = typeof r.html_url === "string" ? r.html_url : "";
+            if (!title || !url)
+                return null;
+            const author = typeof r.user?.login === "string" ? r.user.login : null;
+            const state = typeof r.state === "string" ? r.state : null;
+            const parts = [];
+            if (state)
+                parts.push(state);
+            if (author)
+                parts.push(`by ${author}`);
+            if (typeof r.body === "string" && r.body)
+                parts.push(r.body.slice(0, 200));
+            return wrapSearchHit({
+                title,
+                url,
+                snippet: parts.join(" · ") || undefined,
+                siteName: resolveSiteName(url),
+                published: typeof r.created_at === "string" ? r.created_at : undefined,
+            });
+        }
+        case "users": {
+            const r = raw;
+            const title = typeof r.login === "string" ? r.login : "";
+            const url = typeof r.html_url === "string" ? r.html_url : "";
+            if (!title || !url)
+                return null;
+            return wrapSearchHit({
+                title,
+                url,
+                snippet: typeof r.type === "string" ? r.type : undefined,
+                siteName: resolveSiteName(url),
+            });
+        }
+    }
+}
+export const githubSearchModule = defineModule({
+    id: "github-search",
+    register(b) {
+        b.webSearch(createGithubSearchProvider());
+    },
+});
+export { createGithubSearchProvider, resolveGithubToken };
+//# sourceMappingURL=github-search.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * 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 type { WebSearchProvider } from "../types.js";
+declare function createHackerNewsSearchProvider(): WebSearchProvider;
+export declare const hackerNewsModule: import("../types.js").BrigadeModule;
+export { createHackerNewsSearchProvider };
+//# sourceMappingURL=hackernews.d.ts.map

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

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