@automatelab/citation-intelligence 0.5.0 → 0.6.0

package/dist/resources.js

@@ -0,0 +1,242 @@
+// MCP resources surfaced by this server. Each resource returns cache state
+// the client can read or subscribe to without firing tool calls.
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join } from "node:path";
+import { ResourceTemplate, } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { CONFIG_DIR, CACHE_FILE } from "./lib/config.js";
+import { citedForDomain } from "./lib/cache.js";
+function asJson(uri, value) {
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: "application/json",
+                text: JSON.stringify(value, null, 2),
+            },
+        ],
+    };
+}
+async function loadCacheSummary() {
+    let size = 0;
+    let exists = false;
+    try {
+        const s = await stat(CACHE_FILE);
+        size = s.size;
+        exists = true;
+    }
+    catch {
+        // missing cache file - return empty summary
+    }
+    let entries = [];
+    if (exists) {
+        try {
+            const raw = await readFile(CACHE_FILE, "utf8");
+            const parsed = JSON.parse(raw);
+            entries = parsed.entries ?? [];
+        }
+        catch {
+            // ignore corrupt cache
+        }
+    }
+    const byType = {};
+    const byEngine = {};
+    const queries = new Set();
+    const urls = new Set();
+    let oldest = null;
+    let newest = null;
+    for (const e of entries) {
+        if (e.type)
+            byType[e.type] = (byType[e.type] ?? 0) + 1;
+        if (e.engine)
+            byEngine[e.engine] = (byEngine[e.engine] ?? 0) + 1;
+        if (e.query)
+            queries.add(e.query.toLowerCase());
+        for (const c of e.citations ?? [])
+            if (c.url)
+                urls.add(c.url);
+        for (const c of e.sources ?? [])
+            if (c.url)
+                urls.add(c.url);
+        if (e.fetched_at) {
+            if (!oldest || e.fetched_at < oldest)
+                oldest = e.fetched_at;
+            if (!newest || e.fetched_at > newest)
+                newest = e.fetched_at;
+        }
+    }
+    return {
+        cache_file: CACHE_FILE,
+        exists,
+        size_bytes: size,
+        entries_total: entries.length,
+        by_type: byType,
+        by_engine: byEngine,
+        unique_queries: queries.size,
+        unique_urls: urls.size,
+        oldest_fetched_at: oldest,
+        newest_fetched_at: newest,
+    };
+}
+async function loadPanelsList() {
+    const panelDir = join(CONFIG_DIR, "panels");
+    const snapshotDir = join(CONFIG_DIR, "snapshots");
+    const panels = [];
+    try {
+        const files = await readdir(panelDir);
+        for (const f of files.filter((f) => f.endsWith(".json"))) {
+            const name = f.slice(0, -5);
+            try {
+                const raw = await readFile(join(panelDir, f), "utf8");
+                const p = JSON.parse(raw);
+                panels.push({
+                    name,
+                    queries: p.queries?.length ?? 0,
+                    domain: p.domain,
+                    updated_at: p.updated_at,
+                });
+            }
+            catch {
+                panels.push({ name, queries: 0 });
+            }
+        }
+    }
+    catch {
+        // panels dir doesn't exist yet
+    }
+    const snapshotsByPanel = {};
+    try {
+        const panelDirs = await readdir(snapshotDir);
+        for (const p of panelDirs) {
+            try {
+                const files = await readdir(join(snapshotDir, p));
+                snapshotsByPanel[p] = files.filter((f) => f.endsWith(".json")).length;
+            }
+            catch {
+                // skip
+            }
+        }
+    }
+    catch {
+        // snapshots dir doesn't exist yet
+    }
+    return {
+        config_dir: CONFIG_DIR,
+        panels,
+        snapshots_by_panel: snapshotsByPanel,
+    };
+}
+const LLMS_TXT_PRIMER = [
+    "# llms.txt — what it is",
+    "",
+    "Proposed by llmstxt.org. A markdown file at /llms.txt that orients LLM",
+    "crawlers to your site: H1 title, short blurb, then sectioned link lists.",
+    "Distinct from robots.txt (gates) and sitemap.xml (URL enumeration) - it",
+    "tells the model *what's important*, not just *what exists*.",
+    "",
+    "## Mainstream signal status",
+    "",
+    "- OpenAI, Anthropic, Perplexity: no public statement of consumption.",
+    "- Adopters use it as a documentation / discoverability nudge.",
+    "- Generally harmless to ship; benefit > zero, cost ~ zero.",
+    "",
+    "## How this server helps",
+    "",
+    "- `llms_txt_generator` builds a draft from your sitemap.",
+    "- `audit_sitemap` ranks pages by citation-readiness before you include them.",
+    "- `predict_citation` scores any URL on the public signals (llms.txt is one).",
+    "",
+    "## Spec",
+    "",
+    "https://llmstxt.org",
+].join("\n");
+const CRAWLERS_PRIMER = [
+    "# AI crawlers cheatsheet",
+    "",
+    "## Training/index bots (robots.txt gate)",
+    "",
+    "- GPTBot — OpenAI ChatGPT training",
+    "- OAI-SearchBot — ChatGPT Search index",
+    "- ClaudeBot — Anthropic training",
+    "- PerplexityBot — Perplexity index",
+    "- CCBot — Common Crawl (feeds many LLM corpora)",
+    "- Google-Extended — robots-only opt-out token for Gemini training",
+    "- Applebot-Extended — robots-only opt-out for Apple Intelligence",
+    "- Bytespider — ByteDance Doubao",
+    "- Meta-ExternalAgent — Llama",
+    "",
+    "## Real-time fetch bots (UA gate)",
+    "",
+    "- ChatGPT-User — OpenAI on-prompt fetch",
+    "- Claude-Web — Anthropic on-prompt fetch",
+    "- Perplexity-User — Perplexity on-query fetch",
+    "",
+    "## Audit",
+    "",
+    "Use `crawler_access_audit` to verify these can each fetch a URL. Use the",
+    "`ai_crawler_checkup` prompt for an LLM-driven write-up.",
+].join("\n");
+export function registerResources(server) {
+    server.registerResource("cache_summary", "citation://cache/summary", {
+        title: "Citation cache summary",
+        description: "Aggregate counts of cached entries by type, engine, unique queries, and unique URLs. Read-only view of the local citation cache.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const summary = await loadCacheSummary();
+        return asJson(uri.toString(), summary);
+    });
+    server.registerResource("panels_list", "citation://panels", {
+        title: "Saved panels",
+        description: "List of saved query panels and per-panel snapshot counts. Mirrors track_queries action=list with snapshot context.",
+        mimeType: "application/json",
+    }, async (uri) => {
+        const panels = await loadPanelsList();
+        return asJson(uri.toString(), panels);
+    });
+    server.registerResource("llms_txt_primer", "citation://docs/llms-txt", {
+        title: "llms.txt primer",
+        description: "What llms.txt is, what it isn't, and how this server's tools help build one. Short markdown primer.",
+        mimeType: "text/markdown",
+    }, (uri) => ({
+        contents: [
+            {
+                uri: uri.toString(),
+                mimeType: "text/markdown",
+                text: LLMS_TXT_PRIMER,
+            },
+        ],
+    }));
+    server.registerResource("crawlers_primer", "citation://docs/ai-crawlers", {
+        title: "AI crawlers cheatsheet",
+        description: "Quick reference for the AI crawlers `crawler_access_audit` checks, grouped by training vs real-time fetch.",
+        mimeType: "text/markdown",
+    }, (uri) => ({
+        contents: [
+            {
+                uri: uri.toString(),
+                mimeType: "text/markdown",
+                text: CRAWLERS_PRIMER,
+            },
+        ],
+    }));
+    server.registerResource("cited_for_domain", new ResourceTemplate("citation://domain/{domain}/cited-for", {
+        list: undefined,
+    }), {
+        title: "Citations for a domain",
+        description: "Cached citations for {domain}. Returns the most recent 200 entries. Same source as cited_for tool, surfaced as a resource for clients that subscribe.",
+        mimeType: "application/json",
+    }, async (uri, variables) => {
+        const domainVar = variables.domain;
+        const domain = Array.isArray(domainVar) ? domainVar[0] : domainVar;
+        const safe = typeof domain === "string" ? domain : "";
+        const results = safe
+            ? await citedForDomain(safe, undefined, undefined, 200)
+            : [];
+        return asJson(uri.toString(), {
+            domain: safe,
+            results,
+            total: results.length,
+            source: "local_cache",
+        });
+    });
+}
+//# sourceMappingURL=resources.js.map

package/dist/resources.js.map

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

package/dist/tools/am-i-cited.d.ts

@@ -3,20 +3,20 @@ import type { Engine } from "../types.js";
 export declare const amICitedInputSchema: {
     domain: z.ZodString;
     queries: z.ZodArray<z.ZodString, "many">;
-    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "auto"]>>;
+    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "google_ai_mode", "auto"]>>;
 };
 declare const inputSchema: z.ZodObject<{
     domain: z.ZodString;
     queries: z.ZodArray<z.ZodString, "many">;
-    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "auto"]>>;
+    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "google_ai_mode", "auto"]>>;
 }, "strip", z.ZodTypeAny, {
-    engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto";
+    engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "google_ai_mode" | "auto";
     domain: string;
     queries: string[];
 }, {
     domain: string;
     queries: string[];
-    engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto" | undefined;
+    engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "google_ai_mode" | "auto" | undefined;
 }>;
 export declare function amICited(input: z.infer<typeof inputSchema>): Promise<{
     domain: string;

package/dist/tools/am-i-cited.js

@@ -11,7 +11,7 @@ export const amICitedInputSchema = {
         .max(20)
         .describe("Queries to test the domain against. 1-20 queries per call."),
     engine: z
-        .enum(["perplexity", "claude", "openai", "gemini", "bing", "brave", "auto"])
+        .enum(["perplexity", "claude", "openai", "gemini", "bing", "brave", "google_ai_mode", "auto"])
         .default("auto")
         .describe("AI engine to query."),
 };

package/dist/tools/am-i-cited.js.map

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

package/dist/tools/canonical-competitor-set.d.ts

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import type { Engine } from "../types.js";
+export declare const canonicalCompetitorSetInputSchema: {
+    query: z.ZodString;
+    engines: z.ZodOptional<z.ZodArray<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave"]>, "many">>;
+    top_n: z.ZodDefault<z.ZodNumber>;
+    max_results: z.ZodDefault<z.ZodNumber>;
+    exclude_domains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+};
+declare const inputSchema: z.ZodObject<{
+    query: z.ZodString;
+    engines: z.ZodOptional<z.ZodArray<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave"]>, "many">>;
+    top_n: z.ZodDefault<z.ZodNumber>;
+    max_results: z.ZodDefault<z.ZodNumber>;
+    exclude_domains: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    max_results: number;
+    top_n: number;
+    engines?: ("perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave")[] | undefined;
+    exclude_domains?: string[] | undefined;
+}, {
+    query: string;
+    max_results?: number | undefined;
+    engines?: ("perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave")[] | undefined;
+    top_n?: number | undefined;
+    exclude_domains?: string[] | undefined;
+}>;
+export declare function canonicalCompetitorSet(input: z.infer<typeof inputSchema>): Promise<{
+    query: string;
+    fetched_at: string;
+    engines: never[];
+    domains: never[];
+    note: string;
+    engines_queried?: undefined;
+    engines_succeeded?: undefined;
+    excluded_domains?: undefined;
+    total_unique_domains?: undefined;
+    top_n?: undefined;
+} | {
+    query: string;
+    fetched_at: string;
+    engines: {
+        engine: Engine;
+        ok: boolean;
+        citations: number;
+        error: string | undefined;
+    }[];
+    engines_queried: number;
+    engines_succeeded: number;
+    excluded_domains: string[];
+    total_unique_domains: number;
+    top_n: number;
+    domains: {
+        domain: string;
+        total_citations: number;
+        engine_count: number;
+        best_rank: number;
+        by_engine: {
+            engine: Engine;
+            citations: number;
+            best_rank: number;
+            sample_urls: string[];
+        }[];
+        top_urls: {
+            url: string;
+            count: number;
+        }[];
+    }[];
+    note: string;
+}>;
+export {};
+//# sourceMappingURL=canonical-competitor-set.d.ts.map

package/dist/tools/canonical-competitor-set.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonical-competitor-set.d.ts","sourceRoot":"","sources":["../../src/tools/canonical-competitor-set.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,eAAO,MAAM,iCAAiC;;;;;;CAgC7C,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;EAA8C,CAAC;AA4DhE,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsI9E"}

package/dist/tools/canonical-competitor-set.js

@@ -0,0 +1,209 @@
+import { z } from "zod";
+import { envKey } from "../lib/config.js";
+import { checkCitations } from "./check-citations.js";
+import { log } from "../lib/log.js";
+export const canonicalCompetitorSetInputSchema = {
+    query: z
+        .string()
+        .min(1)
+        .describe("Search query to fan out across engines."),
+    engines: z
+        .array(z.enum(["perplexity", "claude", "openai", "gemini", "bing", "brave"]))
+        .min(1)
+        .max(6)
+        .optional()
+        .describe("Engines to query. If omitted, uses all engines with a configured API key."),
+    top_n: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .default(10)
+        .describe("Max competitor domains to return."),
+    max_results: z
+        .number()
+        .int()
+        .min(1)
+        .max(20)
+        .default(10)
+        .describe("Max citations per engine."),
+    exclude_domains: z
+        .array(z.string())
+        .max(50)
+        .optional()
+        .describe("Domains to filter out (e.g. your own brand, Wikipedia, Reddit). Suffix-match."),
+};
+const inputSchema = z.object(canonicalCompetitorSetInputSchema);
+// Crude registered-domain extractor. Strips www. and handles the common
+// two-label suffixes (co.uk, com.au, com.br, etc.). Good enough for grouping
+// competitor citations; not RFC-correct.
+const TWO_LABEL_TLDS = new Set([
+    "co.uk",
+    "co.jp",
+    "co.kr",
+    "co.in",
+    "co.nz",
+    "co.za",
+    "com.au",
+    "com.br",
+    "com.mx",
+    "com.tr",
+    "com.sg",
+    "com.tw",
+    "com.hk",
+    "com.cn",
+    "com.ar",
+    "ac.uk",
+    "gov.uk",
+    "gov.au",
+    "net.au",
+    "org.uk",
+    "or.jp",
+    "ne.jp",
+    "ac.jp",
+]);
+function registeredDomain(host) {
+    const lower = host.toLowerCase().replace(/^www\./, "");
+    const parts = lower.split(".");
+    if (parts.length <= 2)
+        return lower;
+    const tail2 = parts.slice(-2).join(".");
+    const tail3 = parts.slice(-3).join(".");
+    if (TWO_LABEL_TLDS.has(tail2))
+        return tail3;
+    return tail2;
+}
+function hostOf(url) {
+    try {
+        return new URL(url).hostname;
+    }
+    catch {
+        return null;
+    }
+}
+function availableEngines() {
+    const list = [];
+    if (envKey("PERPLEXITY_API_KEY"))
+        list.push("perplexity");
+    if (envKey("ANTHROPIC_API_KEY"))
+        list.push("claude");
+    if (envKey("OPENAI_API_KEY"))
+        list.push("openai");
+    if (envKey("GEMINI_API_KEY"))
+        list.push("gemini");
+    if (envKey("BRAVE_API_KEY"))
+        list.push("brave");
+    if (envKey("BING_API_KEY"))
+        list.push("bing");
+    return list;
+}
+export async function canonicalCompetitorSet(input) {
+    const parsed = inputSchema.parse(input);
+    log.debug("canonical_competitor_set start", { query: parsed.query });
+    const engines = parsed.engines ?? availableEngines();
+    if (engines.length === 0) {
+        return {
+            query: parsed.query,
+            fetched_at: new Date().toISOString(),
+            engines: [],
+            domains: [],
+            note: "No engine API keys configured. Set at least one of PERPLEXITY_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, BRAVE_API_KEY, BING_API_KEY.",
+        };
+    }
+    const excludeRegistered = (parsed.exclude_domains ?? []).map((d) => registeredDomain(d.replace(/^https?:\/\//, "").replace(/\/.*/, "")));
+    const runs = await Promise.all(engines.map(async (engine) => {
+        try {
+            const res = await checkCitations({
+                query: parsed.query,
+                engine,
+                max_results: parsed.max_results,
+            });
+            return { engine, ok: true, citations: res.citations };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            return { engine, ok: false, citations: [], error: msg };
+        }
+    }));
+    const okRuns = runs.filter((r) => r.ok);
+    const agg = new Map();
+    for (const r of okRuns) {
+        for (const c of r.citations) {
+            const host = hostOf(c.url);
+            if (!host)
+                continue;
+            const dom = registeredDomain(host);
+            if (excludeRegistered.some((d) => dom === d || dom.endsWith(`.${d}`)))
+                continue;
+            let entry = agg.get(dom);
+            if (!entry) {
+                entry = {
+                    domain: dom,
+                    total_citations: 0,
+                    best_rank: c.rank,
+                    engines: new Map(),
+                    urls: new Map(),
+                };
+                agg.set(dom, entry);
+            }
+            entry.total_citations += 1;
+            entry.best_rank = Math.min(entry.best_rank, c.rank);
+            let perEngine = entry.engines.get(r.engine);
+            if (!perEngine) {
+                perEngine = { count: 0, best_rank: c.rank, sample_urls: new Set() };
+                entry.engines.set(r.engine, perEngine);
+            }
+            perEngine.count += 1;
+            perEngine.best_rank = Math.min(perEngine.best_rank, c.rank);
+            perEngine.sample_urls.add(c.url);
+            entry.urls.set(c.url, (entry.urls.get(c.url) ?? 0) + 1);
+        }
+    }
+    const ranked = [...agg.values()]
+        .map((e) => ({
+        domain: e.domain,
+        total_citations: e.total_citations,
+        engine_count: e.engines.size,
+        best_rank: e.best_rank,
+        by_engine: [...e.engines.entries()]
+            .map(([engine, v]) => ({
+            engine,
+            citations: v.count,
+            best_rank: v.best_rank,
+            sample_urls: [...v.sample_urls].slice(0, 3),
+        }))
+            .sort((a, b) => b.citations - a.citations),
+        top_urls: [...e.urls.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .slice(0, 5)
+            .map(([url, count]) => ({ url, count })),
+    }))
+        .sort((a, b) => {
+        // Primary: cited by more engines (cross-engine consensus).
+        if (b.engine_count !== a.engine_count)
+            return b.engine_count - a.engine_count;
+        // Secondary: total citations.
+        if (b.total_citations !== a.total_citations)
+            return b.total_citations - a.total_citations;
+        // Tertiary: best rank (lower = earlier).
+        return a.best_rank - b.best_rank;
+    });
+    return {
+        query: parsed.query,
+        fetched_at: new Date().toISOString(),
+        engines: runs.map((r) => ({
+            engine: r.engine,
+            ok: r.ok,
+            citations: r.citations.length,
+            error: r.error,
+        })),
+        engines_queried: runs.length,
+        engines_succeeded: okRuns.length,
+        excluded_domains: excludeRegistered,
+        total_unique_domains: ranked.length,
+        top_n: parsed.top_n,
+        domains: ranked.slice(0, parsed.top_n),
+        note: "domains aggregated by registered domain (eTLD+1 approximation). engine_count = how many engines cited this domain (cross-engine consensus). by_engine breaks down per-engine citation counts and best rank. Order: engine_count desc, then total_citations desc, then best_rank asc.",
+    };
+}
+//# sourceMappingURL=canonical-competitor-set.js.map

package/dist/tools/canonical-competitor-set.js.map

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

package/dist/tools/check-citations.d.ts

@@ -2,20 +2,20 @@ import { z } from "zod";
 import type { Engine } from "../types.js";
 export declare const checkCitationsInputSchema: {
     query: z.ZodString;
-    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "auto"]>>;
+    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "google_ai_mode", "auto"]>>;
     max_results: z.ZodDefault<z.ZodNumber>;
 };
 declare const inputSchema: z.ZodObject<{
     query: z.ZodString;
-    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "auto"]>>;
+    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "brave", "google_ai_mode", "auto"]>>;
     max_results: z.ZodDefault<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     query: string;
-    engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto";
+    engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "google_ai_mode" | "auto";
     max_results: number;
 }, {
     query: string;
-    engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto" | undefined;
+    engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "google_ai_mode" | "auto" | undefined;
     max_results?: number | undefined;
 }>;
 export declare function checkCitations(input: z.infer<typeof inputSchema>): Promise<{

package/dist/tools/check-citations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-citations.d.ts","sourceRoot":"","sources":["../../src/tools/check-citations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,yBAAyB;;;;CAarC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;EAAsC,CAAC;AAmCxD,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;GAmDtE"}
+{"version":3,"file":"check-citations.d.ts","sourceRoot":"","sources":["../../src/tools/check-citations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,OAAO,KAAK,EAAiB,MAAM,EAAE,MAAM,aAAa,CAAC;AAEzD,eAAO,MAAM,yBAAyB;;;;CAsBrC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;EAAsC,CAAC;AAsCxD,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;GAmDtE"}