@automatelab/citation-intelligence 0.5.1 → 0.7.0

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

@@ -1,5 +1,8 @@
 import { z } from "zod";
 import { checkCitations } from "./check-citations.js";
+import { ToolFetchError } from "../lib/fetch.js";
+import { envKey } from "../lib/config.js";
+import { ENGINE_SURFACE, ENGINE_INTERPRETATION_NOTE } from "../types.js";
 export const amICitedInputSchema = {
     domain: z
         .string()
@@ -11,9 +14,10 @@ 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_serp", "brave_serp", "google_ai_mode", "auto"])
         .default("auto")
-        .describe("AI engine to query."),
+        .describe("LLM engine to check for citations. 'auto' runs all available LLM engines and returns per-engine breakdown + cross-engine consensus. " +
+        "Pin to a specific engine to reduce cost. 'bing_serp' and 'brave_serp' measure web rank, not LLM citations — use check_citations for those."),
 };
 const inputSchema = z.object(amICitedInputSchema);
 function normalizeDomain(d) {
@@ -33,18 +37,28 @@ function urlMatchesDomain(url, needle) {
         return false;
     }
 }
-export async function amICited(input) {
-    const parsed = inputSchema.parse(input);
-    const needle = normalizeDomain(parsed.domain);
+/** LLM engines available for auto-multi mode (no web_rank engines). */
+function availableLlmEngines() {
+    const list = [];
+    if (envKey("SERPAPI_KEY"))
+        list.push("google_ai_mode");
+    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");
+    return list;
+}
+async function runEngineForDomain(engine, queries, needle) {
     const results = [];
-    let resolvedEngine = parsed.engine;
-    for (const query of parsed.queries) {
-        const res = await checkCitations({
-            query,
-            engine: parsed.engine,
-            max_results: 20,
-        });
-        resolvedEngine = res.engine;
+    for (const query of queries) {
+        const res = await checkCitations({ query, engine, max_results: 20 });
+        if (res.engine === "brave_serp") {
+            await new Promise((resolve) => setTimeout(resolve, 1100));
+        }
         const matches = res.citations.filter((c) => urlMatchesDomain(c.url, needle));
         const rank = matches.length > 0 ? matches[0].rank : undefined;
         results.push({
@@ -54,13 +68,99 @@ export async function amICited(input) {
             matching_urls: matches.map((m) => m.url),
         });
     }
+    return { engine, results };
+}
+export async function amICited(input) {
+    const parsed = inputSchema.parse(input);
+    // bing_serp / brave_serp measure web rank, not LLM citations — refuse them here.
+    if (parsed.engine === "bing_serp" || parsed.engine === "brave_serp") {
+        throw new ToolFetchError({
+            type: "invalid_input",
+            field: "engine",
+            message: `'${parsed.engine}' is a web_rank engine (traditional SERP), not an LLM citation engine. ` +
+                `am_i_cited only measures LLM citation behavior. Use check_citations with engine='${parsed.engine}' ` +
+                `to measure web rank instead, or set engine='auto' to fan across all LLM engines.`,
+        });
+    }
+    const needle = normalizeDomain(parsed.domain);
+    const fetched_at = new Date().toISOString();
+    // Multi-engine mode: when engine='auto', fan across all available LLM engines.
+    if (parsed.engine === "auto") {
+        const engines = availableLlmEngines();
+        if (engines.length === 0) {
+            return {
+                domain: parsed.domain,
+                mode: "multi_engine",
+                fetched_at,
+                engines: [],
+                per_engine: [],
+                consensus: { queries_cited_by_all: 0, queries_total: parsed.queries.length, consensus_rate: 0 },
+                note: "No LLM engine API keys configured. Set at least one of SERPAPI_KEY, PERPLEXITY_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY.",
+            };
+        }
+        // Run all engines in parallel.
+        const engineRuns = await Promise.all(engines.map((e) => runEngineForDomain(e, parsed.queries, needle).catch((err) => ({
+            engine: e,
+            results: [],
+            error: err instanceof Error ? err.message : String(err),
+        }))));
+        const perEngine = engineRuns.map((run) => {
+            const engineKey = run.engine;
+            const cited = run.results.filter((r) => r.cited);
+            const ranks = cited.map((r) => r.rank).filter((r) => r !== undefined);
+            return {
+                engine: run.engine,
+                surface: ENGINE_SURFACE[engineKey],
+                interpretation_note: ENGINE_INTERPRETATION_NOTE[engineKey],
+                ok: !("error" in run),
+                error: "error" in run ? run.error : undefined,
+                results: run.results,
+                summary: {
+                    queries_total: parsed.queries.length,
+                    queries_cited: cited.length,
+                    citation_rate: parsed.queries.length > 0 ? cited.length / parsed.queries.length : 0,
+                    average_rank: ranks.length > 0 ? ranks.reduce((a, b) => a + b, 0) / ranks.length : undefined,
+                },
+            };
+        });
+        // Cross-engine consensus: queries cited by ALL succeeding engines.
+        const okRuns = perEngine.filter((r) => r.ok && r.results.length > 0);
+        const consensusQueries = parsed.queries.filter((q) => okRuns.length > 0 && okRuns.every((r) => r.results.find((qr) => qr.query === q)?.cited));
+        return {
+            domain: parsed.domain,
+            mode: "multi_engine",
+            fetched_at,
+            engines: perEngine.map((r) => ({
+                engine: r.engine,
+                surface: r.surface,
+                ok: r.ok,
+                queries_cited: r.summary.queries_cited,
+                citation_rate: r.summary.citation_rate,
+            })),
+            per_engine: perEngine,
+            consensus: {
+                queries_cited_by_all: consensusQueries.length,
+                queries_total: parsed.queries.length,
+                consensus_rate: parsed.queries.length > 0 ? consensusQueries.length / parsed.queries.length : 0,
+                queries: consensusQueries,
+            },
+            note: "consensus = queries where domain is cited by ALL succeeding engines. " +
+                "High consensus_rate = strong multi-engine signal. Low = engine-specific citation.",
+        };
+    }
+    // Single-engine mode: explicit engine specified.
+    const { results } = await runEngineForDomain(parsed.engine, parsed.queries, needle);
+    const engineKey = parsed.engine;
     const cited = results.filter((r) => r.cited);
     const ranks = cited.map((r) => r.rank).filter((r) => r !== undefined);
     const average_rank = ranks.length > 0 ? ranks.reduce((a, b) => a + b, 0) / ranks.length : undefined;
     return {
         domain: parsed.domain,
-        engine: resolvedEngine,
-        fetched_at: new Date().toISOString(),
+        mode: "single_engine",
+        engine: parsed.engine,
+        surface: ENGINE_SURFACE[engineKey],
+        interpretation_note: ENGINE_INTERPRETATION_NOTE[engineKey],
+        fetched_at,
         results,
         summary: {
             queries_total: parsed.queries.length,

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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CAAC,4DAA4D,CAAC;IACzE,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;SACvG,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CACP,sIAAsI;QACtI,4IAA4I,CAC7I;CACJ,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;AAElD,SAAS,eAAe,CAAC,CAAS;IAChC,OAAO,CAAC;SACL,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;SAC3B,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAW,EAAE,MAAc;IACnD,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC5D,OAAO,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,uEAAuE;AACvE,SAAS,mBAAmB;IAC1B,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,MAAM,CAAC,aAAa,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvD,IAAI,MAAM,CAAC,oBAAoB,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1D,IAAI,MAAM,CAAC,mBAAmB,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrD,IAAI,MAAM,CAAC,gBAAgB,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,MAAM,CAAC,gBAAgB,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AASD,KAAK,UAAU,kBAAkB,CAC/B,MAAc,EACd,OAA0B,EAC1B,MAAc;IAEd,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,cAAc,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;QACrE,IAAI,GAAG,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;YAChC,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7E,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAC9D,OAAO,CAAC,IAAI,CAAC;YACX,KAAK;YACL,KAAK,EAAE,OAAO,CAAC,MAAM,GAAG,CAAC;YACzB,IAAI;YACJ,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;SACzC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,KAAkC;IAC/D,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAExC,iFAAiF;IACjF,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,YAAY,EAAE,CAAC;QACpE,MAAM,IAAI,cAAc,CAAC;YACvB,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,QAAQ;YACf,OAAO,EACL,IAAI,MAAM,CAAC,MAAM,yEAAyE;gBAC1F,oFAAoF,MAAM,CAAC,MAAM,IAAI;gBACrG,kFAAkF;SACrF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE5C,+EAA+E;IAC/E,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,mBAAmB,EAAE,CAAC;QACtC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,IAAI,EAAE,cAAc;gBACpB,UAAU;gBACV,OAAO,EAAE,EAAE;gBACX,UAAU,EAAE,EAAE;gBACd,SAAS,EAAE,EAAE,oBAAoB,EAAE,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,EAAE;gBAC/F,IAAI,EAAE,4IAA4I;aACnJ,CAAC;QACJ,CAAC;QAED,+BAA+B;QAC/B,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC/E,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,EAAsB;YAC/B,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC,CAAC,CAAC,CACL,CAAC;QAEF,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACvC,MAAM,SAAS,GAAG,GAAG,CAAC,MAAiC,CAAC;YACxD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;YACnF,OAAO;gBACL,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC;gBAClC,mBAAmB,EAAE,0BAA0B,CAAC,SAAS,CAAC;gBAC1D,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,GAAG,CAAC;gBACrB,KAAK,EAAE,OAAO,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;gBAC7C,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,OAAO,EAAE;oBACP,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;oBACpC,aAAa,EAAE,KAAK,CAAC,MAAM;oBAC3B,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;oBACnF,YAAY,EAAE,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;iBAC7F;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,mEAAmE;QACnE,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACrE,MAAM,gBAAgB,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACnD,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CACxF,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,IAAI,EAAE,cAAc;YACpB,UAAU;YACV,OAAO,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC7B,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa;gBACtC,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,aAAa;aACvC,CAAC,CAAC;YACH,UAAU,EAAE,SAAS;YACrB,SAAS,EAAE;gBACT,oBAAoB,EAAE,gBAAgB,CAAC,MAAM;gBAC7C,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;gBACpC,cAAc,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC/F,OAAO,EAAE,gBAAgB;aAC1B;YACD,IAAI,EACF,uEAAuE;gBACvE,mFAAmF;SACtF,CAAC;IACJ,CAAC;IAED,iDAAiD;IACjD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACpF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAiC,CAAC;IAE3D,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC7C,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;IACnF,MAAM,YAAY,GAChB,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAEjF,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,cAAc,CAAC,SAAS,CAAC;QAClC,mBAAmB,EAAE,0BAA0B,CAAC,SAAS,CAAC;QAC1D,UAAU;QACV,OAAO;QACP,OAAO,EAAE;YACP,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM;YACpC,aAAa,EAAE,KAAK,CAAC,MAAM;YAC3B,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACnF,YAAY;SACb;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/answer-box-position.d.ts

@@ -1,20 +1,20 @@
 import { z } from "zod";
 export declare const answerBoxPositionInputSchema: {
     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_serp", "brave_serp", "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_serp", "brave_serp", "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_serp" | "brave_serp" | "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_serp" | "brave_serp" | "brave" | "google_ai_mode" | "auto" | undefined;
     max_results?: number | undefined;
 }>;
 type Position = "early" | "middle" | "late" | "unknown";

package/dist/tools/answer-box-position.js

@@ -4,9 +4,9 @@ import { log } from "../lib/log.js";
 export const answerBoxPositionInputSchema = {
     query: z.string().min(1).describe("Search query whose AI answer to measure citation positions on."),
     engine: z
-        .enum(["perplexity", "claude", "openai", "gemini", "bing", "brave", "auto"])
+        .enum(["perplexity", "claude", "openai", "gemini", "bing_serp", "brave_serp", "brave", "google_ai_mode", "auto"])
         .default("auto")
-        .describe("AI engine to query. Engines without raw_answer (Bing, Brave) return position 'unknown'."),
+        .describe("AI engine to query. web_rank engines (bing_serp, brave_serp) lack raw_answer and will return position 'unknown'."),
     max_results: z
         .number()
         .int()

package/dist/tools/answer-box-position.js.map

@@ -1 +1 @@
-{"version":3,"file":"answer-box-position.js","sourceRoot":"","sources":["../../src/tools/answer-box-position.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"answer-box-position.js","sourceRoot":"","sources":["../../src/tools/answer-box-position.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", "google_ai_mode", "bing_serp", "brave_serp"]>, "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", "google_ai_mode", "bing_serp", "brave_serp"]>, "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_serp" | "brave_serp" | "google_ai_mode")[] | undefined;
+    exclude_domains?: string[] | undefined;
+}, {
+    query: string;
+    max_results?: number | undefined;
+    engines?: ("perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "google_ai_mode")[] | 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,208 @@
+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", "google_ai_mode", "bing_serp", "brave_serp"]))
+        .min(1)
+        .max(7)
+        .optional()
+        .describe("Engines to query. If omitted, uses all LLM engines with a configured API key (google_ai_mode, perplexity, claude, openai, gemini). Include bing_serp/brave_serp only for web_rank comparison."),
+    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("SERPAPI_KEY"))
+        list.push("google_ai_mode");
+    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");
+    // bing_serp/brave_serp not included by default — they measure web rank, not LLM citations
+    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

@@ -1,26 +1,32 @@
 import { z } from "zod";
-import type { Engine } from "../types.js";
+import type { Engine, Surface } 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_serp", "brave_serp", "brave", "google_ai_mode", "auto"]>>;
     max_results: z.ZodDefault<z.ZodNumber>;
+    perplexity_model: z.ZodOptional<z.ZodString>;
 };
 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_serp", "brave_serp", "brave", "google_ai_mode", "auto"]>>;
     max_results: z.ZodDefault<z.ZodNumber>;
+    perplexity_model: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     query: string;
-    engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto";
+    engine: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "brave" | "google_ai_mode" | "auto";
     max_results: number;
+    perplexity_model?: string | undefined;
 }, {
     query: string;
-    engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "brave" | "auto" | undefined;
+    engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing_serp" | "brave_serp" | "brave" | "google_ai_mode" | "auto" | undefined;
     max_results?: number | undefined;
+    perplexity_model?: string | undefined;
 }>;
 export declare function checkCitations(input: z.infer<typeof inputSchema>): Promise<{
     query: string;
     engine: Engine;
+    surface: Surface;
+    interpretation_note: string;
     fetched_at: string;
     citations: import("../types.js").Citation[];
     raw_answer: string | undefined;

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,OAAO,EAAE,MAAM,aAAa,CAAC;AAGlE,eAAO,MAAM,yBAAyB;;;;;CAiCrC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;EAAsC,CAAC;AAyCxD,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;GA2DtE"}