daemora 1.0.0-alpha.0

package/dist/tools/core/webSearch.js

@@ -0,0 +1,429 @@
+/**
+ * web_search — multi-provider internet search with automatic fallback.
+ *
+ * Tries providers in priority order and falls through to the next on
+ * any failure (missing key, rate limit, HTTP error, timeout):
+ *
+ *   Tavily → Perplexity → Brave → SearXNG → DuckDuckGo
+ *
+ * DuckDuckGo needs no API key, so there's always *something* working
+ * as long as the process has outbound internet. The earlier providers
+ * are better quality when a key is present — Tavily/Perplexity even
+ * return a synthesised AI answer alongside the raw hits.
+ *
+ * Results cached in-memory for 5 minutes (LRU, max 50 entries) so
+ * back-to-back identical queries don't burn quota.
+ */
+import { z } from "zod";
+import { ProviderError, ProviderUnavailableError, TimeoutError, ValidationError, } from "../../util/errors.js";
+const CACHE_TTL_MS = 5 * 60_000;
+const CACHE_MAX = 50;
+const TIMEOUT_MS = 12_000;
+const FRESHNESS_TO_BRAVE = { day: "pd", week: "pw", month: "pm", year: "py" };
+const FRESHNESS_TO_TAVILY_DAYS = { day: 1, week: 7, month: 30, year: 365 };
+const FRESHNESS_TO_SEARXNG = { day: "day", week: "week", month: "month", year: "year" };
+const FRESHNESS_TO_PERPLEXITY = { day: "day", week: "week", month: "month", year: "year" };
+const inputSchema = z.object({
+    query: z.string().min(1).max(400).describe("Search query. Natural language OK — don't escape."),
+    count: z.number().int().min(1).max(20).default(5).describe("Number of results. Default 5, max 20."),
+    freshness: z.enum(["day", "week", "month", "year"]).optional().describe("Time filter."),
+    language: z.string().length(2).optional().describe("ISO language code, e.g. 'en'."),
+    provider: z.enum(["firecrawl", "tavily", "perplexity", "brave", "searxng", "ddg"]).optional()
+        .describe("Force a specific provider (falls back through remaining on failure)."),
+});
+const searchCache = new Map();
+function cacheKey(query, count, freshness, provider, language) {
+    return `${query}::${count}::${freshness ?? ""}::${provider ?? ""}::${language ?? ""}`;
+}
+function cacheGet(key) {
+    const e = searchCache.get(key);
+    if (!e)
+        return null;
+    if (Date.now() >= e.expiresAt) {
+        searchCache.delete(key);
+        return null;
+    }
+    // LRU: move to end
+    searchCache.delete(key);
+    searchCache.set(key, e);
+    return e.result;
+}
+function cachePut(key, result) {
+    if (searchCache.size >= CACHE_MAX) {
+        const first = searchCache.keys().next().value;
+        if (first)
+            searchCache.delete(first);
+    }
+    searchCache.set(key, { result, expiresAt: Date.now() + CACHE_TTL_MS });
+}
+export function clearWebSearchCache() {
+    const n = searchCache.size;
+    searchCache.clear();
+    return n;
+}
+async function fetchWithTimeout(url, init, signal) {
+    const timer = AbortSignal.timeout(TIMEOUT_MS);
+    const composite = composeSignals([signal, timer]);
+    return fetch(url, { ...init, signal: composite });
+}
+// ── Provider: Firecrawl (key: FIRECRAWL_API_KEY) ───────────────
+// Same key the user sets for `web_fetch`'s Firecrawl extractor —
+// one credential covers both tools.
+async function searchFirecrawl(cfg, query, limit, freshness, signal) {
+    const key = cfg.vault.get("FIRECRAWL_API_KEY");
+    if (!key)
+        throw new ProviderUnavailableError("Firecrawl", "FIRECRAWL_API_KEY");
+    // Firecrawl's freshness window is `tbs=qdr:<unit>` Google-style.
+    const tbs = { day: "qdr:d", week: "qdr:w", month: "qdr:m", year: "qdr:y" };
+    const body = { query, limit };
+    if (freshness)
+        body["tbs"] = tbs[freshness];
+    const res = await fetchWithTimeout("https://api.firecrawl.dev/v1/search", {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${key.reveal()}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(body),
+    }, signal);
+    if (!res.ok) {
+        const text = await res.text().catch(() => "");
+        throw new ProviderError(`Firecrawl ${res.status}: ${text.slice(0, 200)}`, "firecrawl");
+    }
+    const json = (await res.json());
+    const items = Array.isArray(json.data) ? json.data : [];
+    const results = items
+        .filter((d) => typeof d.url === "string" && d.url.length > 0)
+        .slice(0, limit)
+        .map((d) => ({
+        title: d.title ?? "",
+        url: d.url ?? "",
+        description: d.description ?? "",
+    }));
+    return { query, provider: "Firecrawl", aiAnswer: null, totalReturned: results.length, results };
+}
+// ── Provider: DuckDuckGo (keyless) ─────────────────────────────
+async function searchDDG(query, limit, freshness, signal) {
+    let q = query;
+    if (freshness === "day")
+        q += " date:d";
+    else if (freshness === "week")
+        q += " date:w";
+    else if (freshness === "month")
+        q += " date:m";
+    else if (freshness === "year")
+        q += " date:y";
+    const url = `https://lite.duckduckgo.com/lite/?q=${encodeURIComponent(q)}`;
+    const res = await fetchWithTimeout(url, {
+        headers: {
+            "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+        },
+    }, signal);
+    if (!res.ok)
+        throw new ProviderError(`DuckDuckGo ${res.status}`, "ddg");
+    const html = await res.text();
+    const results = [];
+    // lite.duckduckgo.com layout
+    const liteRe = /<a[^>]+class=['"]result-link['"][^>]*href=['"]([^'"]+)['"][^>]*>([\s\S]*?)<\/a>|<a[^>]+href=['"]([^'"]+)['"][^>]*class=['"]result-link['"][^>]*>([\s\S]*?)<\/a>/gi;
+    const snippetRe = /<td[^>]+class=['"]result-snippet['"][^>]*>([\s\S]*?)<\/td>/gi;
+    const links = [];
+    const snippets = [];
+    let m;
+    while ((m = liteRe.exec(html)) !== null) {
+        links.push({ url: m[1] ?? m[3] ?? "", title: m[2] ?? m[4] ?? "" });
+    }
+    while ((m = snippetRe.exec(html)) !== null)
+        snippets.push(m[1] ?? "");
+    // Fall back to html.duckduckgo.com layout if lite didn't match
+    if (links.length === 0) {
+        const altRe = /<a rel="nofollow"[^>]+class="result__a"[^>]+href="([^"]+)"[^>]*>([\s\S]*?)<\/a>[\s\S]*?<a class="result__snippet"[^>]*>([\s\S]*?)<\/a>/gi;
+        while ((m = altRe.exec(html)) !== null && results.length < limit) {
+            let actualUrl = m[1] ?? "";
+            const uddg = actualUrl.match(/uddg=([^&]+)/);
+            if (uddg?.[1])
+                actualUrl = decodeURIComponent(uddg[1]);
+            results.push({
+                title: decodeEntities(stripTags(m[2] ?? "")),
+                url: actualUrl,
+                description: decodeEntities(stripTags(m[3] ?? "")),
+            });
+        }
+        return { query, provider: "DuckDuckGo", aiAnswer: null, totalReturned: results.length, results };
+    }
+    for (let i = 0; i < links.length && results.length < limit; i++) {
+        const link = links[i];
+        if (!link)
+            continue;
+        let actualUrl = link.url;
+        const uddg = actualUrl.match(/uddg=([^&]+)/);
+        if (uddg?.[1])
+            actualUrl = decodeURIComponent(uddg[1]);
+        results.push({
+            title: decodeEntities(stripTags(link.title)),
+            url: actualUrl,
+            description: decodeEntities(stripTags(snippets[i] ?? "")),
+        });
+    }
+    return { query, provider: "DuckDuckGo", aiAnswer: null, totalReturned: results.length, results };
+}
+// ── Provider: Brave ────────────────────────────────────────────
+async function searchBrave(cfg, query, limit, freshness, language, signal) {
+    const key = cfg.vault.get("BRAVE_SEARCH_API_KEY") ?? cfg.vault.get("BRAVE_API_KEY");
+    if (!key)
+        throw new ProviderUnavailableError("Brave", "BRAVE_SEARCH_API_KEY");
+    let url = `https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(query)}&count=${limit}`;
+    if (freshness)
+        url += `&freshness=${FRESHNESS_TO_BRAVE[freshness]}`;
+    if (language)
+        url += `&search_lang=${encodeURIComponent(language)}`;
+    const res = await fetchWithTimeout(url, {
+        headers: {
+            Accept: "application/json",
+            "Accept-Encoding": "gzip",
+            "X-Subscription-Token": key.reveal(),
+        },
+    }, signal);
+    if (!res.ok)
+        throw new ProviderError(`Brave ${res.status}: ${await res.text().catch(() => "")}`, "brave");
+    const data = (await res.json());
+    const results = (data.web?.results ?? []).slice(0, limit).map((r) => ({
+        title: r.title ?? "",
+        url: r.url,
+        description: stripTags(r.description ?? ""),
+    }));
+    return { query, provider: "Brave", aiAnswer: null, totalReturned: results.length, results };
+}
+// ── Provider: Tavily ───────────────────────────────────────────
+async function searchTavily(cfg, query, limit, freshness, signal) {
+    const key = cfg.vault.get("TAVILY_API_KEY");
+    if (!key)
+        throw new ProviderUnavailableError("Tavily", "TAVILY_API_KEY");
+    const body = {
+        query,
+        max_results: limit,
+        search_depth: "advanced",
+        include_answer: true,
+        include_raw_content: false,
+    };
+    if (freshness)
+        body["days"] = FRESHNESS_TO_TAVILY_DAYS[freshness];
+    const res = await fetchWithTimeout("https://api.tavily.com/search", {
+        method: "POST",
+        headers: { "Content-Type": "application/json", Authorization: `Bearer ${key.reveal()}` },
+        body: JSON.stringify(body),
+    }, signal);
+    if (!res.ok)
+        throw new ProviderError(`Tavily ${res.status}: ${await res.text().catch(() => "")}`, "tavily");
+    const data = (await res.json());
+    const results = (data.results ?? []).slice(0, limit).map((r) => ({
+        title: r.title ?? "",
+        url: r.url ?? "",
+        description: r.content ?? "",
+    }));
+    return { query, provider: "Tavily", aiAnswer: data.answer ?? null, totalReturned: results.length, results };
+}
+// ── Provider: Perplexity (also accepts OpenRouter keys) ────────
+async function searchPerplexity(cfg, query, limit, freshness, signal) {
+    const key = cfg.vault.get("PERPLEXITY_API_KEY");
+    if (!key)
+        throw new ProviderUnavailableError("Perplexity", "PERPLEXITY_API_KEY");
+    const raw = key.reveal();
+    const isOpenRouter = raw.startsWith("sk-or-");
+    const url = isOpenRouter
+        ? "https://openrouter.ai/api/v1/chat/completions"
+        : "https://api.perplexity.ai/chat/completions";
+    const model = isOpenRouter ? "perplexity/sonar-pro" : "sonar";
+    const body = {
+        model,
+        messages: [{ role: "user", content: query }],
+    };
+    if (!isOpenRouter && freshness) {
+        body["search_recency_filter"] = FRESHNESS_TO_PERPLEXITY[freshness];
+    }
+    const res = await fetchWithTimeout(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", Authorization: `Bearer ${raw}` },
+        body: JSON.stringify(body),
+    }, signal);
+    if (!res.ok)
+        throw new ProviderError(`Perplexity ${res.status}: ${await res.text().catch(() => "")}`, "perplexity");
+    const data = (await res.json());
+    const content = data.choices?.[0]?.message?.content ?? "";
+    const citations = [];
+    const seen = new Set();
+    for (const u of data.citations ?? []) {
+        if (u && !seen.has(u)) {
+            seen.add(u);
+            citations.push(u);
+        }
+    }
+    if (citations.length === 0) {
+        for (const choice of data.choices ?? []) {
+            for (const ann of choice.message?.annotations ?? []) {
+                const u = ann.url_citation?.url ?? ann.url;
+                if (u && !seen.has(u)) {
+                    seen.add(u);
+                    citations.push(u);
+                }
+            }
+        }
+    }
+    const results = citations.slice(0, limit).map((u, i) => ({
+        title: `Source ${i + 1}`,
+        url: u,
+        description: "",
+    }));
+    return { query, provider: "Perplexity", aiAnswer: content || null, totalReturned: results.length, results };
+}
+// ── Provider: SearXNG (self-hosted) ────────────────────────────
+async function searchSearXNG(cfg, query, limit, freshness, language, signal) {
+    const baseUrl = cfg.settings.getGeneric("SEARXNG_URL");
+    if (!baseUrl)
+        throw new ProviderUnavailableError("SearXNG", "SEARXNG_URL");
+    let url = `${baseUrl.replace(/\/+$/, "")}/search?q=${encodeURIComponent(query)}&format=json&categories=general`;
+    if (freshness)
+        url += `&time_range=${FRESHNESS_TO_SEARXNG[freshness]}`;
+    if (language)
+        url += `&language=${encodeURIComponent(language)}`;
+    const res = await fetchWithTimeout(url, { headers: { Accept: "application/json" } }, signal);
+    if (!res.ok)
+        throw new ProviderError(`SearXNG ${res.status}: ${await res.text().catch(() => "")}`, "searxng");
+    const data = (await res.json());
+    const results = (data.results ?? []).slice(0, limit).map((r) => ({
+        title: r.title ?? "",
+        url: r.url ?? "",
+        description: r.content ?? "",
+    }));
+    return { query, provider: "SearXNG", aiAnswer: null, totalReturned: results.length, results };
+}
+// ── Dispatch ───────────────────────────────────────────────────
+/** Detects configured providers in priority order, always appends DDG as the keyless fallback. */
+function detectProviders(cfg) {
+    const out = [];
+    if (cfg.vault.has("FIRECRAWL_API_KEY"))
+        out.push("firecrawl");
+    if (cfg.vault.has("TAVILY_API_KEY"))
+        out.push("tavily");
+    if (cfg.vault.has("PERPLEXITY_API_KEY"))
+        out.push("perplexity");
+    if (cfg.vault.has("BRAVE_SEARCH_API_KEY") || cfg.vault.has("BRAVE_API_KEY"))
+        out.push("brave");
+    if (cfg.settings.getGeneric("SEARXNG_URL"))
+        out.push("searxng");
+    out.push("ddg");
+    return out;
+}
+async function runProvider(id, cfg, query, limit, freshness, language, signal) {
+    switch (id) {
+        case "firecrawl": return searchFirecrawl(cfg, query, limit, freshness, signal);
+        case "tavily": return searchTavily(cfg, query, limit, freshness, signal);
+        case "perplexity": return searchPerplexity(cfg, query, limit, freshness, signal);
+        case "brave": return searchBrave(cfg, query, limit, freshness, language, signal);
+        case "searxng": return searchSearXNG(cfg, query, limit, freshness, language, signal);
+        case "ddg": return searchDDG(query, limit, freshness, signal);
+    }
+}
+export function makeWebSearchTool(cfg) {
+    return {
+        name: "web_search",
+        description: "Search the web. Auto-detects best available provider (Firecrawl > Tavily > Perplexity > Brave > SearXNG > DuckDuckGo) and falls through on failure or empty results. DuckDuckGo needs no key. Use fetch_url or web_fetch afterwards to read a specific page.",
+        category: "search",
+        source: { kind: "core" },
+        alwaysOn: true,
+        tags: ["search", "web"],
+        inputSchema,
+        async execute({ query, count, freshness, language, provider }, { abortSignal, logger }) {
+            const key = cacheKey(query, count, freshness, provider, language);
+            const cached = cacheGet(key);
+            if (cached) {
+                logger.info("web_search cache hit", { query, provider: cached.provider });
+                return cached;
+            }
+            const available = detectProviders(cfg);
+            const chain = provider
+                ? [provider, ...available.filter((p) => p !== provider)]
+                : available;
+            let lastError = null;
+            let lastEmpty = null;
+            for (let i = 0; i < chain.length; i++) {
+                const id = chain[i];
+                const isLast = i === chain.length - 1;
+                try {
+                    const result = await runProvider(id, cfg, query, count, freshness, language, abortSignal);
+                    // Treat empty result sets as a SOFT failure when other
+                    // providers remain — DDG in particular returns 200 with zero
+                    // results when it serves a captcha/anti-scrape page, which
+                    // previously caused the chain to stop with a useless empty
+                    // response. Only return empty if this is genuinely the last
+                    // provider in the chain.
+                    if (result.results.length === 0 && !isLast) {
+                        logger.warn("web_search empty result — trying next provider", { provider: result.provider });
+                        lastEmpty = result;
+                        continue;
+                    }
+                    logger.info("web_search ok", { query, provider: result.provider, count: result.results.length });
+                    cachePut(key, result);
+                    return result;
+                }
+                catch (e) {
+                    const err = e;
+                    logger.warn("web_search provider failed", { provider: id, error: err.message });
+                    lastError = err;
+                    if (abortSignal.aborted)
+                        throw new ValidationError("Search cancelled");
+                    continue;
+                }
+            }
+            // All providers either errored or returned empty. Prefer the
+            // empty-set return over an error so the agent can see "search
+            // ran but found nothing" — but only when no provider hard-failed.
+            if (lastEmpty && !lastError) {
+                cachePut(key, lastEmpty);
+                return lastEmpty;
+            }
+            throw lastError instanceof ProviderError
+                ? lastError
+                : new ProviderError(`All search providers failed${lastError ? `: ${lastError.message}` : ""}`, "web_search");
+        },
+    };
+}
+// ── Helpers ─────────────────────────────────────────────────────
+const HTML_ENTITIES = {
+    "&amp;": "&", "&lt;": "<", "&gt;": ">", "&quot;": '"',
+    "&#39;": "'", "&apos;": "'", "&#x27;": "'", "&#x2F;": "/",
+    "&nbsp;": " ", "&#38;": "&", "&#60;": "<", "&#62;": ">",
+};
+const ENTITY_RE = /&(?:#x[0-9a-f]+|#\d+|[a-z]+);/gi;
+function decodeEntities(str) {
+    if (!str)
+        return "";
+    return str.replace(ENTITY_RE, (m) => {
+        if (HTML_ENTITIES[m])
+            return HTML_ENTITIES[m];
+        if (m.startsWith("&#x"))
+            return String.fromCharCode(parseInt(m.slice(3, -1), 16));
+        if (m.startsWith("&#"))
+            return String.fromCharCode(parseInt(m.slice(2, -1), 10));
+        return m;
+    });
+}
+function stripTags(html) {
+    return html ? html.replace(/<[^>]+>/g, "").replace(/\s+/g, " ").trim() : "";
+}
+function composeSignals(signals) {
+    const native = AbortSignal.any;
+    if (typeof native === "function")
+        return native(Array.from(signals));
+    const ctrl = new AbortController();
+    for (const s of signals) {
+        if (s.aborted) {
+            ctrl.abort(s.reason);
+            break;
+        }
+        s.addEventListener("abort", () => ctrl.abort(s.reason), { once: true });
+    }
+    return ctrl.signal;
+}
+// Unused import placeholder to keep RateLimitError importable for future use.
+export { TimeoutError };
+//# sourceMappingURL=webSearch.js.map

package/dist/tools/core/webSearch.js.map

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

package/dist/tools/core/writeFile.d.ts

@@ -0,0 +1,27 @@
+import { z } from "zod";
+import type { FilesystemGuard } from "../../safety/FilesystemGuard.js";
+import type { ToolDef } from "../types.js";
+declare const inputSchema: z.ZodObject<{
+    path: z.ZodString;
+    content: z.ZodString;
+    /** If false (default), refuse to overwrite an existing file. */
+    overwrite: z.ZodDefault<z.ZodBoolean>;
+    /** Create parent directories if missing. Default true — agent shouldn't have to mkdir manually. */
+    mkdirp: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    content: string;
+    overwrite: boolean;
+    mkdirp: boolean;
+}, {
+    path: string;
+    content: string;
+    overwrite?: boolean | undefined;
+    mkdirp?: boolean | undefined;
+}>;
+export declare function makeWriteFileTool(guard: FilesystemGuard): ToolDef<typeof inputSchema, {
+    bytes: number;
+    path: string;
+}>;
+export {};
+//# sourceMappingURL=writeFile.d.ts.map

package/dist/tools/core/writeFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFile.d.ts","sourceRoot":"","sources":["../../../src/tools/core/writeFile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAEvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,QAAA,MAAM,WAAW;;;IAGf,gEAAgE;;IAEhE,mGAAmG;;;;;;;;;;;;EAEnG,CAAC;AAEH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,WAAW,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAoCtH"}

package/dist/tools/core/writeFile.js

@@ -0,0 +1,51 @@
+import { mkdir, writeFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { z } from "zod";
+import { PermissionDeniedError, ValidationError } from "../../util/errors.js";
+const inputSchema = z.object({
+    path: z.string().min(1),
+    content: z.string(),
+    /** If false (default), refuse to overwrite an existing file. */
+    overwrite: z.boolean().default(false),
+    /** Create parent directories if missing. Default true — agent shouldn't have to mkdir manually. */
+    mkdirp: z.boolean().default(true),
+});
+export function makeWriteFileTool(guard) {
+    return {
+        name: "write_file",
+        description: "Write text to a file. Refuses to overwrite by default — pass overwrite:true to replace.",
+        category: "filesystem",
+        source: { kind: "core" },
+        alwaysOn: true,
+        destructive: true,
+        inputSchema,
+        async execute({ path, content, overwrite, mkdirp }) {
+            const canonical = guard.ensureAllowed(path, "write");
+            if (mkdirp) {
+                try {
+                    await mkdir(dirname(canonical), { recursive: true });
+                }
+                catch (e) {
+                    const err = e;
+                    if (err.code === "EACCES")
+                        throw new PermissionDeniedError(`Cannot create directory: ${dirname(canonical)}`);
+                    throw err;
+                }
+            }
+            try {
+                await writeFile(canonical, content, { encoding: "utf-8", flag: overwrite ? "w" : "wx" });
+            }
+            catch (e) {
+                const err = e;
+                if (err.code === "EEXIST") {
+                    throw new ValidationError(`Refusing to overwrite ${canonical} (pass overwrite:true to allow).`);
+                }
+                if (err.code === "EACCES")
+                    throw new PermissionDeniedError(`Write denied: ${canonical}`);
+                throw err;
+            }
+            return { bytes: Buffer.byteLength(content, "utf-8"), path: canonical };
+        },
+    };
+}
+//# sourceMappingURL=writeFile.js.map

package/dist/tools/core/writeFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeFile.js","sourceRoot":"","sources":["../../../src/tools/core/writeFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG9E,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,gEAAgE;IAChE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IACrC,mGAAmG;IACnG,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,KAAsB;IACtD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,yFAAyF;QACtG,QAAQ,EAAE,YAAY;QACtB,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE;QACxB,QAAQ,EAAE,IAAI;QACd,WAAW,EAAE,IAAI;QACjB,WAAW;QACX,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE;YAChD,MAAM,SAAS,GAAG,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAErD,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC;oBACH,MAAM,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACvD,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,GAAG,GAAG,CAA0B,CAAC;oBACvC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;wBAAE,MAAM,IAAI,qBAAqB,CAAC,4BAA4B,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;oBAC7G,MAAM,GAAG,CAAC;gBACZ,CAAC;YACH,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,SAAS,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3F,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,MAAM,GAAG,GAAG,CAA0B,CAAC;gBACvC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC1B,MAAM,IAAI,eAAe,CAAC,yBAAyB,SAAS,kCAAkC,CAAC,CAAC;gBAClG,CAAC;gBACD,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;oBAAE,MAAM,IAAI,qBAAqB,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC;gBACzF,MAAM,GAAG,CAAC;YACZ,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACzE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/registry.d.ts

@@ -0,0 +1,36 @@
+/**
+ * ToolRegistry — central place tools register themselves.
+ *
+ * Two responsibilities:
+ *   1. Hold every known tool keyed by name (no duplicates allowed).
+ *   2. Build the model-facing tool list per request: always-on tools
+ *      + tools matched by skill discovery, with tools from disabled
+ *      integrations excluded.
+ */
+import type { ToolDef } from "./types.js";
+export interface ToolFilter {
+    /** Integration IDs the user has enabled. Tools sourced from disabled integrations are excluded. */
+    readonly enabledIntegrations: ReadonlySet<string>;
+    /** Tool names the agent can additionally see this turn (from skill matching). */
+    readonly skillMatchedTools?: ReadonlySet<string>;
+}
+export declare class ToolRegistry {
+    private readonly byName;
+    register(def: ToolDef): void;
+    registerAll(defs: readonly ToolDef[]): void;
+    unregisterBySource(source: ToolDef["source"]): number;
+    has(name: string): boolean;
+    get(name: string): ToolDef | undefined;
+    list(): readonly ToolDef[];
+    /** Tools available given the user's currently-enabled integrations. */
+    available(enabledIntegrations: ReadonlySet<string>): readonly ToolDef[];
+    /**
+     * Build the tool list to send to the model on this turn.
+     * Includes:
+     *   - All `alwaysOn` tools (delegate, discoverTools, core io)
+     *   - Tools whose name appears in `skillMatchedTools`
+     * Excludes tools from disabled integrations entirely.
+     */
+    selectFor(filter: ToolFilter): readonly ToolDef[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,WAAW,UAAU;IACzB,mGAAmG;IACnG,QAAQ,CAAC,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAClD,iFAAiF;IACjF,QAAQ,CAAC,iBAAiB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAClD;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA8B;IAErD,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAU5B,WAAW,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI;IAI3C,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM;IAWrD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAItC,IAAI,IAAI,SAAS,OAAO,EAAE;IAI1B,uEAAuE;IACvE,SAAS,CAAC,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,OAAO,EAAE;IAOvE;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,UAAU,GAAG,SAAS,OAAO,EAAE;CAMlD"}