@automatelab/citation-intelligence 0.4.0

package/dist/tools/gsc-citation-gap.d.ts

@@ -0,0 +1,77 @@
+import { z } from "zod";
+export declare const gscCitationGapInputSchema: {
+    domain: z.ZodString;
+    queries: z.ZodArray<z.ZodString, "many">;
+    site_url: z.ZodOptional<z.ZodString>;
+    start_date: z.ZodString;
+    end_date: z.ZodString;
+    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "auto"]>>;
+    credentials_path: z.ZodOptional<z.ZodString>;
+};
+declare const inputSchema: z.ZodObject<{
+    domain: z.ZodString;
+    queries: z.ZodArray<z.ZodString, "many">;
+    site_url: z.ZodOptional<z.ZodString>;
+    start_date: z.ZodString;
+    end_date: z.ZodString;
+    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "auto"]>>;
+    credentials_path: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "auto";
+    domain: string;
+    queries: string[];
+    start_date: string;
+    end_date: string;
+    site_url?: string | undefined;
+    credentials_path?: string | undefined;
+}, {
+    domain: string;
+    queries: string[];
+    start_date: string;
+    end_date: string;
+    engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "auto" | undefined;
+    site_url?: string | undefined;
+    credentials_path?: string | undefined;
+}>;
+export declare function gscCitationGap(input: z.infer<typeof inputSchema>): Promise<{
+    error: string;
+    domain?: undefined;
+    site_url?: undefined;
+    range?: undefined;
+    engine?: undefined;
+    rows?: undefined;
+    closest_wins?: undefined;
+} | {
+    domain: string;
+    site_url: string;
+    range: {
+        start: string;
+        end: string;
+    };
+    engine: import("../types.js").Engine;
+    rows: {
+        query: string;
+        gsc: {
+            impressions: number;
+            clicks: number;
+            position: number | undefined;
+            ctr: number | undefined;
+        };
+        ai_cited: boolean;
+        ai_rank: number | undefined;
+    }[];
+    closest_wins: {
+        query: string;
+        gsc: {
+            impressions: number;
+            clicks: number;
+            position: number | undefined;
+            ctr: number | undefined;
+        };
+        ai_cited: boolean;
+        ai_rank: number | undefined;
+    }[];
+    error?: undefined;
+}>;
+export {};
+//# sourceMappingURL=gsc-citation-gap.d.ts.map

package/dist/tools/gsc-citation-gap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsc-citation-gap.d.ts","sourceRoot":"","sources":["../../src/tools/gsc-citation-gap.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,eAAO,MAAM,yBAAyB;;;;;;;;CA4BrC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;EAAsC,CAAC;AAgDxD,wBAAsB,cAAc,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDtE"}

package/dist/tools/gsc-citation-gap.js

@@ -0,0 +1,121 @@
+import { z } from "zod";
+import { JWT } from "google-auth-library";
+import { readFile } from "node:fs/promises";
+import { fetchJson } from "../lib/fetch.js";
+import { amICited } from "./am-i-cited.js";
+import { envKey } from "../lib/config.js";
+export const gscCitationGapInputSchema = {
+    domain: z
+        .string()
+        .min(1)
+        .describe("Domain to analyze, e.g. 'automatelab.tech'. Used both for the GSC site URL and the citation check."),
+    queries: z
+        .array(z.string().min(1))
+        .min(1)
+        .max(20)
+        .describe("Queries to cross-reference. 1-20 per call."),
+    site_url: z
+        .string()
+        .optional()
+        .describe("Override the GSC siteUrl. Defaults to 'sc-domain:<domain>'."),
+    start_date: z
+        .string()
+        .describe("ISO date for GSC range start, e.g. '2026-04-01'."),
+    end_date: z
+        .string()
+        .describe("ISO date for GSC range end, e.g. '2026-05-01'."),
+    engine: z
+        .enum(["perplexity", "claude", "openai", "gemini", "bing", "auto"])
+        .default("auto")
+        .describe("AI engine for the citation check."),
+    credentials_path: z
+        .string()
+        .optional()
+        .describe("Path to GCP service account JSON. Defaults to env GOOGLE_APPLICATION_CREDENTIALS."),
+};
+const inputSchema = z.object(gscCitationGapInputSchema);
+async function gscSearchAnalytics(args) {
+    const raw = await readFile(args.credentialsPath, "utf8");
+    const creds = JSON.parse(raw);
+    const jwt = new JWT({
+        email: creds.client_email,
+        key: creds.private_key,
+        scopes: ["https://www.googleapis.com/auth/webmasters.readonly"],
+    });
+    const { token } = await jwt.getAccessToken();
+    if (!token)
+        throw new Error("failed to acquire GSC access token");
+    const url = `https://www.googleapis.com/webmasters/v3/sites/${encodeURIComponent(args.siteUrl)}/searchAnalytics/query`;
+    const body = JSON.stringify({
+        startDate: args.startDate,
+        endDate: args.endDate,
+        dimensions: ["query"],
+        dimensionFilterGroups: [
+            {
+                filters: args.queries.map((q) => ({ dimension: "query", operator: "equals", expression: q })),
+                groupType: "or",
+            },
+        ],
+        rowLimit: 1000,
+    });
+    const res = await fetchJson(url, {
+        method: "POST",
+        headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
+        body,
+        timeoutMs: 20_000,
+    });
+    const map = new Map();
+    for (const r of res.rows ?? []) {
+        const key = r.keys?.[0];
+        if (key)
+            map.set(key.toLowerCase(), r);
+    }
+    return map;
+}
+export async function gscCitationGap(input) {
+    const parsed = inputSchema.parse(input);
+    const credentialsPath = parsed.credentials_path ?? envKey("GOOGLE_APPLICATION_CREDENTIALS");
+    if (!credentialsPath) {
+        return {
+            error: "no GSC credentials path; pass credentials_path or set GOOGLE_APPLICATION_CREDENTIALS to a service account JSON",
+        };
+    }
+    const siteUrl = parsed.site_url ?? `sc-domain:${parsed.domain.replace(/^https?:\/\//, "").replace(/\/$/, "")}`;
+    const [gscMap, citation] = await Promise.all([
+        gscSearchAnalytics({
+            credentialsPath,
+            siteUrl,
+            startDate: parsed.start_date,
+            endDate: parsed.end_date,
+            queries: parsed.queries,
+        }),
+        amICited({ domain: parsed.domain, queries: parsed.queries, engine: parsed.engine }),
+    ]);
+    const rows = parsed.queries.map((q) => {
+        const gsc = gscMap.get(q.toLowerCase());
+        const cite = citation.results.find((r) => r.query === q);
+        return {
+            query: q,
+            gsc: {
+                impressions: gsc?.impressions ?? 0,
+                clicks: gsc?.clicks ?? 0,
+                position: gsc?.position,
+                ctr: gsc?.ctr,
+            },
+            ai_cited: cite?.cited ?? false,
+            ai_rank: cite?.rank,
+        };
+    });
+    const gaps = rows
+        .filter((r) => !r.ai_cited && r.gsc.impressions > 0 && (r.gsc.position ?? 999) <= 10)
+        .sort((a, b) => b.gsc.impressions - a.gsc.impressions);
+    return {
+        domain: parsed.domain,
+        site_url: siteUrl,
+        range: { start: parsed.start_date, end: parsed.end_date },
+        engine: citation.engine,
+        rows,
+        closest_wins: gaps,
+    };
+}
+//# sourceMappingURL=gsc-citation-gap.js.map

package/dist/tools/gsc-citation-gap.js.map

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

package/dist/tools/predict-citation.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod";
+export declare const predictCitationInputSchema: {
+    url: z.ZodString;
+};
+declare const inputSchema: z.ZodObject<{
+    url: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+}, {
+    url: string;
+}>;
+export declare function predictCitation(input: z.infer<typeof inputSchema>): Promise<{
+    url: string;
+    fetched_at: string;
+    score: number;
+    grade: "A" | "B" | "C" | "D" | "F";
+    signals: import("../adapters/predictors.js").PredictorSignals;
+    fixes: {
+        signal: string;
+        suggestion: string;
+        estimated_lift: "low" | "medium" | "high";
+    }[];
+}>;
+export {};
+//# sourceMappingURL=predict-citation.d.ts.map

package/dist/tools/predict-citation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"predict-citation.d.ts","sourceRoot":"","sources":["../../src/tools/predict-citation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAQxB,eAAO,MAAM,0BAA0B;;CAEtC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;EAAuC,CAAC;AAEzD,wBAAsB,eAAe,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;GAyBvE"}

package/dist/tools/predict-citation.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import { collectSignals, scoreSignals, suggestFixes, } from "../adapters/predictors.js";
+import { ToolFetchError } from "../lib/fetch.js";
+export const predictCitationInputSchema = {
+    url: z.string().url().describe("URL to score for citation likelihood. Must be absolute http(s)."),
+};
+const inputSchema = z.object(predictCitationInputSchema);
+export async function predictCitation(input) {
+    const parsed = inputSchema.parse(input);
+    try {
+        new URL(parsed.url);
+    }
+    catch {
+        throw new ToolFetchError({
+            type: "invalid_input",
+            field: "url",
+            message: `Not a valid URL: ${parsed.url}`,
+        });
+    }
+    const signals = await collectSignals(parsed.url);
+    const { score, grade } = scoreSignals(signals);
+    const fixes = suggestFixes(signals);
+    return {
+        url: parsed.url,
+        fetched_at: new Date().toISOString(),
+        score,
+        grade,
+        signals,
+        fixes,
+    };
+}
+//# sourceMappingURL=predict-citation.js.map

package/dist/tools/predict-citation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"predict-citation.js","sourceRoot":"","sources":["../../src/tools/predict-citation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,cAAc,EACd,YAAY,EACZ,YAAY,GACb,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;CAClG,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAEzD,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,KAAkC;IACtE,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAExC,IAAI,CAAC;QACH,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,cAAc,CAAC;YACvB,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,oBAAoB,MAAM,CAAC,GAAG,EAAE;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjD,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IAEpC,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,KAAK;QACL,KAAK;QACL,OAAO;QACP,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/tools/run-panel.d.ts

@@ -0,0 +1,46 @@
+import { z } from "zod";
+export declare const runPanelInputSchema: {
+    name: z.ZodString;
+    domain: z.ZodOptional<z.ZodString>;
+    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "auto"]>>;
+};
+declare const inputSchema: z.ZodObject<{
+    name: z.ZodString;
+    domain: z.ZodOptional<z.ZodString>;
+    engine: z.ZodDefault<z.ZodEnum<["perplexity", "claude", "openai", "gemini", "bing", "auto"]>>;
+}, "strip", z.ZodTypeAny, {
+    engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "auto";
+    name: string;
+    domain?: string | undefined;
+}, {
+    name: string;
+    engine?: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "auto" | undefined;
+    domain?: string | undefined;
+}>;
+export declare function runPanel(input: z.infer<typeof inputSchema>): Promise<{
+    error: string;
+    saved_to?: undefined;
+    snapshot?: undefined;
+} | {
+    saved_to: string;
+    snapshot: {
+        panel: string;
+        domain: string;
+        engine: "perplexity" | "claude" | "openai" | "gemini" | "bing" | "auto";
+        taken_at: string;
+        per_query: {
+            query: string;
+            cited: boolean;
+            rank?: number;
+            matching_urls: string[];
+        }[];
+        summary: {
+            queries_total: number;
+            queries_cited: number;
+            citation_rate: number;
+        };
+    };
+    error?: undefined;
+}>;
+export {};
+//# sourceMappingURL=run-panel.d.ts.map

package/dist/tools/run-panel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-panel.d.ts","sourceRoot":"","sources":["../../src/tools/run-panel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,mBAAmB;;;;CAa/B,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;EAAgC,CAAC;AAElD,wBAAsB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;mBAoBhC,MAAM;mBAAS,OAAO;mBAAS,MAAM;2BAAiB,MAAM,EAAE;;;;;;;;;GAwB9F"}

package/dist/tools/run-panel.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import { amICited } from "./am-i-cited.js";
+import { loadPanel, appendSnapshot } from "../lib/panels.js";
+export const runPanelInputSchema = {
+    name: z
+        .string()
+        .min(1)
+        .describe("Panel name previously saved via track_queries."),
+    domain: z
+        .string()
+        .optional()
+        .describe("Override the panel's default domain for this run."),
+    engine: z
+        .enum(["perplexity", "claude", "openai", "gemini", "bing", "auto"])
+        .default("auto")
+        .describe("AI engine to query."),
+};
+const inputSchema = z.object(runPanelInputSchema);
+export async function runPanel(input) {
+    const parsed = inputSchema.parse(input);
+    const panel = await loadPanel(parsed.name);
+    if (!panel) {
+        return { error: `panel '${parsed.name}' not found` };
+    }
+    const domain = parsed.domain ?? panel.domain;
+    if (!domain) {
+        return {
+            error: "no domain set on panel and none passed; specify domain on the panel or per call",
+        };
+    }
+    const CHUNK = 20;
+    const chunks = [];
+    for (let i = 0; i < panel.queries.length; i += CHUNK) {
+        chunks.push(panel.queries.slice(i, i + CHUNK));
+    }
+    const perQuery = [];
+    let engineUsed = parsed.engine;
+    const fetchedAt = new Date().toISOString();
+    for (const queries of chunks) {
+        const res = await amICited({ domain, queries, engine: parsed.engine });
+        engineUsed = res.engine;
+        perQuery.push(...res.results);
+    }
+    const queriesCited = perQuery.filter((q) => q.cited).length;
+    const snapshot = {
+        panel: panel.name,
+        domain,
+        engine: engineUsed,
+        taken_at: fetchedAt,
+        per_query: perQuery,
+        summary: {
+            queries_total: perQuery.length,
+            queries_cited: queriesCited,
+            citation_rate: perQuery.length > 0 ? queriesCited / perQuery.length : 0,
+        },
+    };
+    const path = await appendSnapshot(snapshot);
+    return { saved_to: path, snapshot };
+}
+//# sourceMappingURL=run-panel.js.map

package/dist/tools/run-panel.js.map

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

package/dist/tools/track-queries.d.ts

@@ -0,0 +1,52 @@
+import { z } from "zod";
+export declare const trackQueriesInputSchema: {
+    name: z.ZodString;
+    queries: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    domain: z.ZodOptional<z.ZodString>;
+    action: z.ZodDefault<z.ZodEnum<["save", "load", "list"]>>;
+};
+declare const inputSchema: z.ZodObject<{
+    name: z.ZodString;
+    queries: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    domain: z.ZodOptional<z.ZodString>;
+    action: z.ZodDefault<z.ZodEnum<["save", "load", "list"]>>;
+}, "strip", z.ZodTypeAny, {
+    action: "list" | "save" | "load";
+    name: string;
+    domain?: string | undefined;
+    queries?: string[] | undefined;
+}, {
+    name: string;
+    domain?: string | undefined;
+    queries?: string[] | undefined;
+    action?: "list" | "save" | "load" | undefined;
+}>;
+export declare function trackQueries(input: z.infer<typeof inputSchema>): Promise<import("../lib/panels.js").Panel | {
+    panels: string[];
+    error?: undefined;
+    saved?: undefined;
+    panel?: undefined;
+} | {
+    error: string;
+    panels: string[];
+    saved?: undefined;
+    panel?: undefined;
+} | {
+    error: string;
+    panels?: undefined;
+    saved?: undefined;
+    panel?: undefined;
+} | {
+    saved: boolean;
+    panel: {
+        name: string;
+        queries: string[];
+        domain: string | undefined;
+        created_at: string;
+        updated_at: string;
+    };
+    panels?: undefined;
+    error?: undefined;
+}>;
+export {};
+//# sourceMappingURL=track-queries.d.ts.map

package/dist/tools/track-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-queries.d.ts","sourceRoot":"","sources":["../../src/tools/track-queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,uBAAuB;;;;;CAkBnC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;;;;EAAoC,CAAC;AAEtD,wBAAsB,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCpE"}

package/dist/tools/track-queries.js

@@ -0,0 +1,52 @@
+import { z } from "zod";
+import { loadPanel, savePanel, listPanels } from "../lib/panels.js";
+export const trackQueriesInputSchema = {
+    name: z
+        .string()
+        .min(1)
+        .describe("Panel name, e.g. 'editorial-watchlist'. Used to save and recall the query set."),
+    queries: z
+        .array(z.string().min(1))
+        .max(100)
+        .optional()
+        .describe("Queries to save under this panel. Omit to read the existing panel."),
+    domain: z
+        .string()
+        .optional()
+        .describe("Default domain to track for this panel, e.g. 'automatelab.tech'."),
+    action: z
+        .enum(["save", "load", "list"])
+        .default("save")
+        .describe("'save' writes the panel, 'load' returns an existing panel, 'list' enumerates all panels."),
+};
+const inputSchema = z.object(trackQueriesInputSchema);
+export async function trackQueries(input) {
+    const parsed = inputSchema.parse(input);
+    if (parsed.action === "list") {
+        return { panels: await listPanels() };
+    }
+    if (parsed.action === "load") {
+        const panel = await loadPanel(parsed.name);
+        if (!panel) {
+            return { error: `panel '${parsed.name}' not found`, panels: await listPanels() };
+        }
+        return panel;
+    }
+    if (!parsed.queries || parsed.queries.length === 0) {
+        return {
+            error: "action=save requires non-empty queries. To read an existing panel pass action=load.",
+        };
+    }
+    const existing = await loadPanel(parsed.name);
+    const now = new Date().toISOString();
+    const panel = {
+        name: parsed.name,
+        queries: parsed.queries,
+        domain: parsed.domain ?? existing?.domain,
+        created_at: existing?.created_at ?? now,
+        updated_at: now,
+    };
+    await savePanel(panel);
+    return { saved: true, panel };
+}
+//# sourceMappingURL=track-queries.js.map

package/dist/tools/track-queries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track-queries.js","sourceRoot":"","sources":["../../src/tools/track-queries.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEpE,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,gFAAgF,CAAC;IAC7F,OAAO,EAAE,CAAC;SACP,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oEAAoE,CAAC;IACjF,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kEAAkE,CAAC;IAC/E,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;SAC9B,OAAO,CAAC,MAAM,CAAC;SACf,QAAQ,CAAC,0FAA0F,CAAC;CACxG,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAkC;IACnE,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAExC,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,EAAE,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,KAAK,EAAE,UAAU,MAAM,CAAC,IAAI,aAAa,EAAE,MAAM,EAAE,MAAM,UAAU,EAAE,EAAE,CAAC;QACnF,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO;YACL,KAAK,EACH,qFAAqF;SACxF,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG;QACZ,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,QAAQ,EAAE,MAAM;QACzC,UAAU,EAAE,QAAQ,EAAE,UAAU,IAAI,GAAG;QACvC,UAAU,EAAE,GAAG;KAChB,CAAC;IACF,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IACvB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAChC,CAAC"}

package/dist/tools/wikipedia-mentions.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+export declare const wikipediaMentionsInputSchema: {
+    domain: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    lang: z.ZodDefault<z.ZodString>;
+};
+declare const inputSchema: z.ZodObject<{
+    domain: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    lang: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    domain: string;
+    limit: number;
+    lang: string;
+}, {
+    domain: string;
+    limit?: number | undefined;
+    lang?: string | undefined;
+}>;
+export declare function wikipediaMentions(input: z.infer<typeof inputSchema>): Promise<{
+    domain: string;
+    lang: string;
+    fetched_at: string;
+    total: number;
+    mentions: {
+        article_title: string | undefined;
+        article_url: string | undefined;
+        cited_url: string | undefined;
+    }[];
+}>;
+export {};
+//# sourceMappingURL=wikipedia-mentions.d.ts.map

package/dist/tools/wikipedia-mentions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikipedia-mentions.d.ts","sourceRoot":"","sources":["../../src/tools/wikipedia-mentions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,4BAA4B;;;;CAgBxC,CAAC;AAEF,QAAA,MAAM,WAAW;;;;;;;;;;;;EAAyC,CAAC;AAiB3D,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC;;;;;;;;;;GAkCzE"}

package/dist/tools/wikipedia-mentions.js

@@ -0,0 +1,56 @@
+import { z } from "zod";
+import { fetchJson } from "../lib/fetch.js";
+export const wikipediaMentionsInputSchema = {
+    domain: z
+        .string()
+        .min(1)
+        .describe("Domain to search for, e.g. 'automatelab.tech' (without protocol)."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(100)
+        .default(20)
+        .describe("Maximum mention rows to return."),
+    lang: z
+        .string()
+        .default("en")
+        .describe("Wikipedia language subdomain, e.g. 'en', 'de', 'fr'."),
+};
+const inputSchema = z.object(wikipediaMentionsInputSchema);
+function normalizeDomain(d) {
+    return d
+        .replace(/^https?:\/\//, "")
+        .replace(/^www\./, "")
+        .replace(/\/$/, "")
+        .toLowerCase();
+}
+export async function wikipediaMentions(input) {
+    const parsed = inputSchema.parse(input);
+    const needle = normalizeDomain(parsed.domain);
+    const params = new URLSearchParams({
+        action: "query",
+        list: "exturlusage",
+        euquery: needle,
+        eulimit: String(parsed.limit),
+        eunamespace: "0",
+        format: "json",
+        origin: "*",
+    });
+    const res = await fetchJson(`https://${parsed.lang}.wikipedia.org/w/api.php?${params.toString()}`, { timeoutMs: 10_000 });
+    const rows = (res.query?.exturlusage ?? []).map((e) => ({
+        article_title: e.title,
+        article_url: e.title
+            ? `https://${parsed.lang}.wikipedia.org/wiki/${encodeURIComponent(e.title.replace(/ /g, "_"))}`
+            : undefined,
+        cited_url: e.url,
+    }));
+    return {
+        domain: parsed.domain,
+        lang: parsed.lang,
+        fetched_at: new Date().toISOString(),
+        total: rows.length,
+        mentions: rows,
+    };
+}
+//# sourceMappingURL=wikipedia-mentions.js.map

package/dist/tools/wikipedia-mentions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikipedia-mentions.js","sourceRoot":"","sources":["../../src/tools/wikipedia-mentions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,MAAM,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,CAAC,mEAAmE,CAAC;IAChF,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,iCAAiC,CAAC;IAC9C,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,OAAO,CAAC,IAAI,CAAC;SACb,QAAQ,CAAC,sDAAsD,CAAC;CACpE,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC;AAS3D,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,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAkC;IACxE,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAE9C,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC;QACjC,MAAM,EAAE,OAAO;QACf,IAAI,EAAE,aAAa;QACnB,OAAO,EAAE,MAAM;QACf,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC;QAC7B,WAAW,EAAE,GAAG;QAChB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,GAAG;KACZ,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,SAAS,CACzB,WAAW,MAAM,CAAC,IAAI,4BAA4B,MAAM,CAAC,QAAQ,EAAE,EAAE,EACrE,EAAE,SAAS,EAAE,MAAM,EAAE,CACtB,CAAC;IAEF,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,WAAW,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACtD,aAAa,EAAE,CAAC,CAAC,KAAK;QACtB,WAAW,EAAE,CAAC,CAAC,KAAK;YAClB,CAAC,CAAC,WAAW,MAAM,CAAC,IAAI,uBAAuB,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,EAAE;YAC/F,CAAC,CAAC,SAAS;QACb,SAAS,EAAE,CAAC,CAAC,GAAG;KACjB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,KAAK,EAAE,IAAI,CAAC,MAAM;QAClB,QAAQ,EAAE,IAAI;KACf,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,42 @@
+export type Engine = "perplexity" | "claude" | "openai" | "gemini" | "bing" | "auto";
+export type Citation = {
+    url: string;
+    title?: string;
+    rank: number;
+    snippet?: string;
+};
+export type NormalizedCitationResult = {
+    query: string;
+    engine: Engine;
+    fetched_at: string;
+    citations: Citation[];
+    raw_answer?: string;
+    cached: boolean;
+};
+export type AdapterResult = {
+    citations: Citation[];
+    raw_answer?: string;
+};
+export type ToolError = {
+    type: "missing_key";
+    engine: Engine;
+    env_var: string;
+    message: string;
+} | {
+    type: "no_engine_available";
+    message: string;
+} | {
+    type: "fetch_error";
+    url: string;
+    message: string;
+    status?: number;
+} | {
+    type: "rate_limited";
+    engine: Engine;
+    message: string;
+} | {
+    type: "invalid_input";
+    field: string;
+    message: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GACd,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,MAAM,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzE;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map