@agentsean/surfaces 1.0.0

package/dist/bing-ai.js

@@ -0,0 +1,56 @@
+/** Bing Webmaster AI Performance has no API. Ingest a CSV export. */
+export function parseBingAiCsv(csv) {
+    const lines = csv.trim().split(/\r?\n/).filter(Boolean);
+    if (lines.length < 2)
+        return [];
+    const header = (lines[0] ?? "").toLowerCase();
+    const out = [];
+    for (const line of lines.slice(1)) {
+        const cols = splitCsv(line);
+        const date = cols[0] ?? "";
+        const groundingQuery = cols[1] ?? "";
+        const citations = Number(cols[2] ?? 0);
+        const citationShare = Number(cols[3] ?? 0);
+        if (!groundingQuery)
+            continue;
+        out.push({
+            date,
+            groundingQuery,
+            citations: Number.isFinite(citations) ? citations : 0,
+            citationShare: Number.isFinite(citationShare) ? citationShare : 0,
+        });
+    }
+    void header;
+    return out;
+}
+function splitCsv(line) {
+    const out = [];
+    let cur = "";
+    let q = false;
+    for (const ch of line) {
+        if (ch === '"') {
+            q = !q;
+            continue;
+        }
+        if (ch === "," && !q) {
+            out.push(cur.trim());
+            cur = "";
+            continue;
+        }
+        cur += ch;
+    }
+    out.push(cur.trim());
+    return out;
+}
+export function bingCitationShare(rows) {
+    if (rows.length === 0)
+        return 0;
+    let w = 0;
+    let n = 0;
+    for (const r of rows) {
+        w += r.citationShare * Math.max(r.citations, 1);
+        n += Math.max(r.citations, 1);
+    }
+    return n === 0 ? 0 : w / n;
+}
+//# sourceMappingURL=bing-ai.js.map

package/dist/bing-ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bing-ai.js","sourceRoot":"","sources":["../src/bing-ai.ts"],"names":[],"mappings":"AAAA,qEAAqE;AASrE,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC3B,MAAM,cAAc,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,cAAc;YAAE,SAAS;QAC9B,GAAG,CAAC,IAAI,CAAC;YACP,IAAI;YACJ,cAAc;YACd,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACrD,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SAClE,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,CAAC;IACZ,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,GAAG,KAAK,CAAC;IACd,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,CAAC,GAAG,CAAC,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC;YACrB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YACrB,GAAG,GAAG,EAAE,CAAC;YACT,SAAS;QACX,CAAC;QACD,GAAG,IAAI,EAAE,CAAC;IACZ,CAAC;IACD,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAiB;IACjD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAChC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,CAAC,IAAI,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAChD,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC"}

package/dist/engine.d.ts

@@ -0,0 +1,40 @@
+import { type SqliteDatabase } from "@agentsean/db";
+import type { GenerateFn } from "@agentsean/llm";
+import { detectVertical, type VerticalInput, type VerticalPreset } from "./verticals.js";
+export type SurfacesJobResult = {
+    citationShare: number;
+    shareOfVoice: number;
+    estimatedUsd: number;
+    bingShare: number | null;
+    vertical: VerticalPreset;
+    verticalConfidence: number;
+    suppressedChecks: number;
+    mentions: number;
+    inbound404s: number;
+    gbpLocations: number;
+    aiCitationGap: boolean;
+    generationBlocked: boolean;
+    rules: string[];
+};
+export declare function runVerticalDetect(db: SqliteDatabase, siteId: string, extra?: Partial<VerticalInput>): ReturnType<typeof detectVertical>;
+export declare function runSurfacesJob(db: SqliteDatabase, opts: {
+    siteId: string;
+    origin: string;
+    brand?: string | undefined;
+    generate?: GenerateFn | undefined;
+    bingCsv?: string | undefined;
+    mentionPages?: Array<{
+        url: string;
+        text: string;
+        links: string[];
+    }> | undefined;
+    crawl404s?: Array<{
+        url: string;
+        statusCode: number | null;
+        inlinks: string[];
+    }> | undefined;
+    now?: Date | undefined;
+}): Promise<SurfacesJobResult>;
+export declare function saveOnboardingAnswers(db: SqliteDatabase, siteId: string, answers: Record<string, string>): ReturnType<typeof detectVertical>;
+export declare function t4CityServiceIsRefused(): boolean;
+//# sourceMappingURL=engine.d.ts.map

package/dist/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../src/engine.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAYjD,OAAO,EAEL,cAAc,EAGd,KAAK,aAAa,EAClB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,iBAAiB,GAAG;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,CAAC;AAEF,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GAC7B,UAAU,CAAC,OAAO,cAAc,CAAC,CA2DnC;AAED,wBAAsB,cAAc,CAClC,EAAE,EAAE,cAAc,EAClB,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,YAAY,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IACjF,SAAS,CAAC,EACR,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;IACnF,GAAG,CAAC,EAAE,IAAI,GAAG,SAAS,CAAC;CACxB,GACA,OAAO,CAAC,iBAAiB,CAAC,CAoG5B;AAED,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,UAAU,CAAC,OAAO,cAAc,CAAC,CAiBnC;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD"}

package/dist/engine.js

@@ -0,0 +1,187 @@
+import { randomUUID } from "node:crypto";
+import { eq } from "drizzle-orm";
+import { aiCitations, aiRuns, bingAiRows, pages, sites, verticalProfiles, } from "@agentsean/db";
+import { KIND_TIER } from "@agentsean/actions";
+import { bingCitationShare, parseBingAiCsv } from "./bing-ai.js";
+import { PANEL_COST_USD } from "./honest.js";
+import { listGbpLocations, localCitationGap } from "./gbp.js";
+import { discoverMentions, findInbound404s, listMentions, saveInbound404s, saveMentions, } from "./offpage.js";
+import { runPromptPanel } from "./panel.js";
+import { contentGenerationBlocked, detectVertical, verticalRules, ymylCategoryFor, } from "./verticals.js";
+export function runVerticalDetect(db, siteId, extra) {
+    const pageRows = db.select().from(pages).where(eq(pages.siteId, siteId)).all();
+    const urls = pageRows.map((p) => p.url);
+    const titles = pageRows.map((p) => p.title ?? "");
+    const input = {
+        urls,
+        titles,
+        jsonLdTypes: extra?.jsonLdTypes ?? [],
+        outboundSponsoredShare: extra?.outboundSponsoredShare ?? 0,
+        telLinkShare: extra?.telLinkShare ?? 0,
+        gscNewsRows: extra?.gscNewsRows ?? 0,
+        gscDiscoverShare: extra?.gscDiscoverShare ?? 0,
+        newsSitemap: extra?.newsSitemap ?? false,
+        publishVelocity30d: extra?.publishVelocity30d ?? 0,
+        jobPostingCount: extra?.jobPostingCount ?? 0,
+        sitemapUrlCount: extra?.sitemapUrlCount ?? urls.length,
+        productSellerVaries: extra?.productSellerVaries ?? false,
+        profileUrlCount: extra?.profileUrlCount ?? 0,
+        localityCount: extra?.localityCount ?? 0,
+        eeaTrafficShare: extra?.eeaTrafficShare ?? 0,
+        hasPricing: urls.some((u) => /\/pricing\b/i.test(u)),
+        hasDemoOrSignup: urls.some((u) => /\/(demo|signup|free-trial)\b/i.test(u)),
+        hasComparePaths: urls.some((u) => /\/(vs|alternatives|compare|integrations)\b/i.test(u)),
+        medicalLexiconShare: extra?.medicalLexiconShare ?? 0,
+    };
+    const detected = detectVertical(input);
+    const existing = db
+        .select()
+        .from(verticalProfiles)
+        .where(eq(verticalProfiles.siteId, siteId))
+        .get();
+    const values = {
+        preset: detected.preset,
+        confidence: detected.confidence,
+        signalsJson: JSON.stringify(detected.signals),
+        answersJson: existing?.answersJson ?? "{}",
+        suppressedChecks: detected.suppressedChecks,
+        updatedAt: new Date().toISOString(),
+    };
+    if (existing) {
+        db.update(verticalProfiles)
+            .set(values)
+            .where(eq(verticalProfiles.id, existing.id))
+            .run();
+    }
+    else {
+        db.insert(verticalProfiles)
+            .values({ id: randomUUID(), siteId, ...values })
+            .run();
+    }
+    const cat = ymylCategoryFor(detected.preset);
+    if (cat) {
+        db.update(sites)
+            .set({ ymylCategory: cat, updatedAt: new Date().toISOString() })
+            .where(eq(sites.id, siteId))
+            .run();
+    }
+    return detected;
+}
+export async function runSurfacesJob(db, opts) {
+    const now = opts.now ?? new Date();
+    const brand = opts.brand ??
+        new URL(opts.origin).hostname.replace(/^www\./, "").split(".")[0] ??
+        "brand";
+    const detected = runVerticalDetect(db, opts.siteId);
+    let citationShare = 0;
+    let shareOfVoice = 0;
+    let estimatedUsd = 0;
+    if (opts.generate) {
+        const panel = await runPromptPanel({
+            origin: opts.origin,
+            brand,
+            generate: opts.generate,
+        });
+        citationShare = panel.citationShare;
+        shareOfVoice = panel.shareOfVoice;
+        estimatedUsd = panel.estimatedUsd;
+        const runId = randomUUID();
+        db.insert(aiRuns)
+            .values({
+            id: runId,
+            siteId: opts.siteId,
+            engine: "panel",
+            promptCount: panel.hits.length,
+            citationShare,
+            shareOfVoice,
+            estimatedUsd,
+            ranAt: now.toISOString(),
+        })
+            .run();
+        for (const hit of panel.hits) {
+            db.insert(aiCitations)
+                .values({
+                id: randomUUID(),
+                runId,
+                engine: hit.engine,
+                prompt: hit.prompt,
+                citedUrl: hit.citedUrl,
+                citedDomain: hit.citedDomain,
+                isOurs: hit.isOurs ? 1 : 0,
+            })
+                .run();
+        }
+    }
+    let bingShare = null;
+    if (opts.bingCsv) {
+        const rows = parseBingAiCsv(opts.bingCsv);
+        bingShare = bingCitationShare(rows);
+        for (const row of rows) {
+            db.insert(bingAiRows)
+                .values({
+                id: randomUUID(),
+                siteId: opts.siteId,
+                date: row.date,
+                groundingQuery: row.groundingQuery,
+                citations: row.citations,
+                citationShare: row.citationShare,
+                source: "csv",
+            })
+                .run();
+        }
+        if (!opts.generate)
+            citationShare = bingShare;
+    }
+    const mentionPages = opts.mentionPages ?? [];
+    const found = discoverMentions({
+        brand,
+        originHost: new URL(opts.origin).hostname,
+        pages: mentionPages,
+    });
+    saveMentions(db, opts.siteId, found, now);
+    const broken = findInbound404s(opts.crawl404s ?? []);
+    const inboundN = saveInbound404s(db, opts.siteId, broken, now);
+    const gbps = listGbpLocations(db, opts.siteId);
+    const gap = localCitationGap({
+        gbpListed: gbps.length > 0,
+        aiMentions: listMentions(db, opts.siteId).length,
+        localPackVisible: gbps.length > 0,
+    });
+    return {
+        citationShare,
+        shareOfVoice,
+        estimatedUsd: estimatedUsd || (opts.generate ? PANEL_COST_USD : 0),
+        bingShare,
+        vertical: detected.preset,
+        verticalConfidence: detected.confidence,
+        suppressedChecks: detected.suppressedChecks,
+        mentions: listMentions(db, opts.siteId).length,
+        inbound404s: inboundN,
+        gbpLocations: gbps.length,
+        aiCitationGap: gap.gap,
+        generationBlocked: contentGenerationBlocked(detected.preset),
+        rules: verticalRules(detected.preset),
+    };
+}
+export function saveOnboardingAnswers(db, siteId, answers) {
+    const detected = runVerticalDetect(db, siteId);
+    const existing = db
+        .select()
+        .from(verticalProfiles)
+        .where(eq(verticalProfiles.siteId, siteId))
+        .get();
+    if (existing) {
+        db.update(verticalProfiles)
+            .set({
+            answersJson: JSON.stringify(answers),
+            updatedAt: new Date().toISOString(),
+        })
+            .where(eq(verticalProfiles.id, existing.id))
+            .run();
+    }
+    return detected;
+}
+export function t4CityServiceIsRefused() {
+    return KIND_TIER.create_city_service_page === 4;
+}
+//# sourceMappingURL=engine.js.map

package/dist/engine.js.map

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

package/dist/gbp.d.ts

@@ -0,0 +1,51 @@
+import { type SqliteDatabase } from "@agentsean/db";
+/** 10 edits/min per profile, non-increasable. 300 QPM per API. Quota starts at 0 until approval. */
+export declare const GBP_EDITS_PER_MIN = 10;
+export declare const GBP_QPM = 300;
+export declare class GbpQuotaError extends Error {
+    readonly name = "GbpQuotaError";
+}
+export declare class GbpNotApprovedError extends Error {
+    readonly name = "GbpNotApprovedError";
+}
+export type GbpLocation = {
+    id: string;
+    locationName: string;
+    title: string | null;
+    primaryCategory: string | null;
+    approvalStatus: string;
+};
+export type GbpWrite = {
+    locationId: string;
+    kind: "hours" | "category" | "title";
+    payload: Record<string, unknown>;
+};
+export declare function allowGbpEdit(locationId: string, now?: number): boolean;
+export declare function refuseReviewGeneration(): never;
+export declare function refuseCityServicePages(): never;
+export declare function refuseGbpTitleWrite(): never;
+export declare function applyGbpEdit(db: SqliteDatabase, siteId: string, write: GbpWrite, now?: Date): Promise<{
+    id: string;
+}>;
+export declare function upsertGbpLocation(db: SqliteDatabase, siteId: string, loc: Omit<GbpLocation, "id"> & {
+    id?: string | undefined;
+}): string;
+export declare function listGbpLocations(db: SqliteDatabase, siteId: string): {
+    id: string;
+    siteId: string;
+    locationName: string;
+    title: string | null;
+    primaryCategory: string | null;
+    placeId: string | null;
+    approvalStatus: string;
+    verifiedAt: string | null;
+}[];
+export declare function localCitationGap(opts: {
+    gbpListed: boolean;
+    aiMentions: number;
+    localPackVisible: boolean;
+}): {
+    gap: boolean;
+    message: string;
+};
+//# sourceMappingURL=gbp.d.ts.map

package/dist/gbp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gbp.d.ts","sourceRoot":"","sources":["../src/gbp.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAE5E,oGAAoG;AACpG,eAAO,MAAM,iBAAiB,KAAK,CAAC;AACpC,eAAO,MAAM,OAAO,MAAM,CAAC;AAE3B,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAkB,IAAI,mBAAmB;CAC1C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAkB,IAAI,yBAAyB;CAChD;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;IACrC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAIF,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,OAAO,CAO1E;AAED,wBAAgB,sBAAsB,IAAI,KAAK,CAI9C;AAED,wBAAgB,sBAAsB,IAAI,KAAK,CAI9C;AAED,wBAAgB,mBAAmB,IAAI,KAAK,CAI3C;AAED,wBAAsB,YAAY,CAChC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,QAAQ,EACf,GAAG,OAAa,GACf,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,CA0DzB;AAED,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACzD,MAAM,CAmBR;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM;;;;;;;;;IAElE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,OAAO,CAAC;CAC3B,GAAG;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CASpC"}

package/dist/gbp.js

@@ -0,0 +1,114 @@
+import { randomUUID } from "node:crypto";
+import { eq } from "drizzle-orm";
+import { gbpEdits, gbpLocations } from "@agentsean/db";
+/** 10 edits/min per profile, non-increasable. 300 QPM per API. Quota starts at 0 until approval. */
+export const GBP_EDITS_PER_MIN = 10;
+export const GBP_QPM = 300;
+export class GbpQuotaError extends Error {
+    name = "GbpQuotaError";
+}
+export class GbpNotApprovedError extends Error {
+    name = "GbpNotApprovedError";
+}
+const buckets = new Map();
+export function allowGbpEdit(locationId, now = Date.now()) {
+    const windowStart = now - 60_000;
+    const hits = (buckets.get(locationId) ?? []).filter((t) => t > windowStart);
+    if (hits.length >= GBP_EDITS_PER_MIN)
+        return false;
+    hits.push(now);
+    buckets.set(locationId, hits);
+    return true;
+}
+export function refuseReviewGeneration() {
+    throw new Error("Review generation is T4. Incentives, gating, and staff-name asks are explicit GBP policy violations. No setting exists.");
+}
+export function refuseCityServicePages() {
+    throw new Error("Unbounded city×service page generation is T4. It is named under both doorway abuse and scaled content abuse.");
+}
+export function refuseGbpTitleWrite() {
+    throw new Error("Never auto-write the GBP business title. Keywords in the title are a policy trap. Advisory only.");
+}
+export async function applyGbpEdit(db, siteId, write, now = new Date()) {
+    const loc = db
+        .select()
+        .from(gbpLocations)
+        .where(eq(gbpLocations.id, write.locationId))
+        .get();
+    if (!loc || loc.approvalStatus !== "approved") {
+        throw new GbpNotApprovedError("GBP write APIs start at 0 QPM until Google approves Basic API Access and the profile is verified 60+ days.");
+    }
+    if (write.kind === "title")
+        refuseGbpTitleWrite();
+    const windowStart = new Date(now.getTime() - 60_000).toISOString();
+    const recentForProfile = db
+        .select()
+        .from(gbpEdits)
+        .where(eq(gbpEdits.locationId, write.locationId))
+        .all()
+        .filter((e) => e.appliedAt >= windowStart);
+    if (recentForProfile.length >= GBP_EDITS_PER_MIN ||
+        !allowGbpEdit(write.locationId, now.getTime())) {
+        throw new GbpQuotaError(`GBP cap is ${GBP_EDITS_PER_MIN} edits/min per profile and is not increasable.`);
+    }
+    const recentAll = db
+        .select()
+        .from(gbpEdits)
+        .all()
+        .filter((e) => e.appliedAt >= windowStart);
+    if (recentAll.length >= GBP_QPM) {
+        throw new GbpQuotaError(`GBP API cap is ${GBP_QPM} QPM and starts at 0 until Google approves Basic API Access.`);
+    }
+    if (write.kind === "category" &&
+        typeof write.payload["primaryCategory"] === "string") {
+        db.update(gbpLocations)
+            .set({ primaryCategory: write.payload["primaryCategory"] })
+            .where(eq(gbpLocations.id, write.locationId))
+            .run();
+    }
+    const id = randomUUID();
+    db.insert(gbpEdits)
+        .values({
+        id,
+        siteId,
+        locationId: write.locationId,
+        kind: write.kind,
+        payload: JSON.stringify(write.payload),
+        appliedAt: now.toISOString(),
+    })
+        .run();
+    return { id };
+}
+export function upsertGbpLocation(db, siteId, loc) {
+    const id = loc.id ?? randomUUID();
+    const existing = db.select().from(gbpLocations).where(eq(gbpLocations.id, id)).get();
+    const values = {
+        siteId,
+        locationName: loc.locationName,
+        title: loc.title,
+        primaryCategory: loc.primaryCategory,
+        approvalStatus: loc.approvalStatus,
+        verifiedAt: loc.approvalStatus === "approved" ? new Date().toISOString() : null,
+    };
+    if (existing) {
+        db.update(gbpLocations).set(values).where(eq(gbpLocations.id, id)).run();
+        return id;
+    }
+    db.insert(gbpLocations)
+        .values({ id, placeId: null, ...values })
+        .run();
+    return id;
+}
+export function listGbpLocations(db, siteId) {
+    return db.select().from(gbpLocations).where(eq(gbpLocations.siteId, siteId)).all();
+}
+export function localCitationGap(opts) {
+    if (opts.gbpListed && opts.localPackVisible && opts.aiMentions === 0) {
+        return {
+            gap: true,
+            message: "BrightLocal 2026: AI tools jumped from 6% to 45% of local discovery while Google review-reading fell 83% → 71%. An AI citation gap is now worth more than another local rank tracker.",
+        };
+    }
+    return { gap: false, message: "No AI citation gap flagged." };
+}
+//# sourceMappingURL=gbp.js.map

package/dist/gbp.js.map

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

package/dist/honest.d.ts

@@ -0,0 +1,17 @@
+/** Claims we refuse to sell as AEO levers. PLAN Phase 9 / Ahrefs DiD / arXiv:2604.25707. */
+export declare const AEO_REFUSALS: readonly [{
+    readonly claim: "Add schema markup to win AI citations";
+    readonly truth: "Ahrefs matched difference-in-differences (1,885 pages): schema has no measurable effect on AI citations.";
+}, {
+    readonly claim: "Longer pages get cited more";
+    readonly truth: "Content length is uncorrelated with AI citations (r = 0.04).";
+}, {
+    readonly claim: "Publish llms.txt for GEO";
+    readonly truth: "97% of published llms.txt files are never fetched (Ahrefs, 137,210 domains). Google does not support the file.";
+}];
+export declare const EVIDENCE_SPEC: readonly ["definitions", "numeric_facts", "comparisons", "procedures"];
+export declare const PANEL_COST_USD = 1.11;
+export declare const PANEL_PROMPTS = 20;
+export declare const PANEL_ENGINES: readonly ["chatgpt", "gemini"];
+export declare function refuseAeoLever(claim: string): string;
+//# sourceMappingURL=honest.d.ts.map

package/dist/honest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"honest.d.ts","sourceRoot":"","sources":["../src/honest.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAE5F,eAAO,MAAM,YAAY;;;;;;;;;EAef,CAAC;AAEX,eAAO,MAAM,aAAa,wEAKhB,CAAC;AAEX,eAAO,MAAM,cAAc,OAAO,CAAC;AACnC,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,aAAa,gCAAiC,CAAC;AAE5D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIpD"}

package/dist/honest.js

@@ -0,0 +1,31 @@
+/** Claims we refuse to sell as AEO levers. PLAN Phase 9 / Ahrefs DiD / arXiv:2604.25707. */
+export const AEO_REFUSALS = [
+    {
+        claim: "Add schema markup to win AI citations",
+        truth: "Ahrefs matched difference-in-differences (1,885 pages): schema has no measurable effect on AI citations.",
+    },
+    {
+        claim: "Longer pages get cited more",
+        truth: "Content length is uncorrelated with AI citations (r = 0.04).",
+    },
+    {
+        claim: "Publish llms.txt for GEO",
+        truth: "97% of published llms.txt files are never fetched (Ahrefs, 137,210 domains). Google does not support the file.",
+    },
+];
+export const EVIDENCE_SPEC = [
+    "definitions",
+    "numeric_facts",
+    "comparisons",
+    "procedures",
+];
+export const PANEL_COST_USD = 1.11;
+export const PANEL_PROMPTS = 20;
+export const PANEL_ENGINES = ["chatgpt", "gemini"];
+export function refuseAeoLever(claim) {
+    const hit = AEO_REFUSALS.find((r) => r.claim.toLowerCase() === claim.toLowerCase());
+    if (hit)
+        return hit.truth;
+    return "Sean does not sell schema, word count, or llms.txt as AEO levers. Citation selection and answer absorption are distinct outcomes; high-impact pages are dense in extractable evidence.";
+}
+//# sourceMappingURL=honest.js.map

package/dist/honest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"honest.js","sourceRoot":"","sources":["../src/honest.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAE5F,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B;QACE,KAAK,EAAE,uCAAuC;QAC9C,KAAK,EACH,0GAA0G;KAC7G;IACD;QACE,KAAK,EAAE,6BAA6B;QACpC,KAAK,EAAE,8DAA8D;KACtE;IACD;QACE,KAAK,EAAE,0BAA0B;QACjC,KAAK,EACH,gHAAgH;KACnH;CACO,CAAC;AAEX,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,aAAa;IACb,eAAe;IACf,aAAa;IACb,YAAY;CACJ,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AACnC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAU,CAAC;AAE5D,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACpF,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IAC1B,OAAO,wLAAwL,CAAC;AAClM,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { AEO_REFUSALS, EVIDENCE_SPEC, PANEL_COST_USD, PANEL_PROMPTS, PANEL_ENGINES, refuseAeoLever, } from "./honest.js";
+export { defaultPrompts, parseCitations, citationShare, shareOfVoice, runPromptPanel, type CitationHit, type PanelEngine, } from "./panel.js";
+export { parseBingAiCsv, bingCitationShare, type BingAiRow } from "./bing-ai.js";
+export { GBP_EDITS_PER_MIN, GBP_QPM, GbpQuotaError, GbpNotApprovedError, allowGbpEdit, applyGbpEdit, upsertGbpLocation, listGbpLocations, localCitationGap, refuseReviewGeneration, refuseCityServicePages, refuseGbpTitleWrite, } from "./gbp.js";
+export { scoreProspect, discoverMentions, findInbound404s, saveMentions, saveInbound404s, draftOutreach, listMentions, listOutreach, listInbound404s, refuseUnauthedSend, refuseDisavowWithoutManualAction, } from "./offpage.js";
+export { VERTICAL_PRESETS, ONBOARDING_QUESTIONS, detectVertical, scoreSignals, contentGenerationBlocked, ymylCategoryFor, verticalRules, type VerticalPreset, type VerticalInput, type VerticalSignal, } from "./verticals.js";
+export { runSurfacesJob, runVerticalDetect, saveOnboardingAnswers, t4CityServiceIsRefused, type SurfacesJobResult, } from "./engine.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,WAAW,GACjB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,iBAAiB,EACjB,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,gCAAgC,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,wBAAwB,EACxB,eAAe,EACf,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+export { AEO_REFUSALS, EVIDENCE_SPEC, PANEL_COST_USD, PANEL_PROMPTS, PANEL_ENGINES, refuseAeoLever, } from "./honest.js";
+export { defaultPrompts, parseCitations, citationShare, shareOfVoice, runPromptPanel, } from "./panel.js";
+export { parseBingAiCsv, bingCitationShare } from "./bing-ai.js";
+export { GBP_EDITS_PER_MIN, GBP_QPM, GbpQuotaError, GbpNotApprovedError, allowGbpEdit, applyGbpEdit, upsertGbpLocation, listGbpLocations, localCitationGap, refuseReviewGeneration, refuseCityServicePages, refuseGbpTitleWrite, } from "./gbp.js";
+export { scoreProspect, discoverMentions, findInbound404s, saveMentions, saveInbound404s, draftOutreach, listMentions, listOutreach, listInbound404s, refuseUnauthedSend, refuseDisavowWithoutManualAction, } from "./offpage.js";
+export { VERTICAL_PRESETS, ONBOARDING_QUESTIONS, detectVertical, scoreSignals, contentGenerationBlocked, ymylCategoryFor, verticalRules, } from "./verticals.js";
+export { runSurfacesJob, runVerticalDetect, saveOnboardingAnswers, t4CityServiceIsRefused, } from "./engine.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,cAAc,EACd,cAAc,EACd,aAAa,EACb,YAAY,EACZ,cAAc,GAGf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAkB,MAAM,cAAc,CAAC;AACjF,OAAO,EACL,iBAAiB,EACjB,OAAO,EACP,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,YAAY,EACZ,eAAe,EACf,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,kBAAkB,EAClB,gCAAgC,GACjC,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,cAAc,EACd,YAAY,EACZ,wBAAwB,EACxB,eAAe,EACf,aAAa,GAId,MAAM,gBAAgB,CAAC;AACxB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,GAEvB,MAAM,aAAa,CAAC"}

package/dist/offpage.d.ts

@@ -0,0 +1,69 @@
+import { type SqliteDatabase } from "@agentsean/db";
+export type MentionInput = {
+    url: string;
+    snippet: string;
+    linked: boolean;
+    kind?: "unlinked" | "inbound_404" | "prospect" | undefined;
+};
+export declare function scoreProspect(opts: {
+    linked: boolean;
+    domainRating?: number | undefined;
+    branded: boolean;
+}): number;
+export declare function discoverMentions(opts: {
+    brand: string;
+    originHost: string;
+    pages: Array<{
+        url: string;
+        text: string;
+        links: string[];
+    }>;
+}): MentionInput[];
+export declare function findInbound404s(crawled: Array<{
+    url: string;
+    statusCode: number | null;
+    inlinks: string[];
+}>): Array<{
+    sourceUrl: string;
+    targetUrl: string;
+    status: number | null;
+}>;
+export declare function saveMentions(db: SqliteDatabase, siteId: string, rows: MentionInput[], now?: Date): number;
+export declare function saveInbound404s(db: SqliteDatabase, siteId: string, rows: Array<{
+    sourceUrl: string;
+    targetUrl: string;
+    status: number | null;
+}>, now?: Date): number;
+export declare function draftOutreach(db: SqliteDatabase, siteId: string, mentionId: string, now?: Date): string;
+export declare function refuseUnauthedSend(): never;
+export declare function refuseDisavowWithoutManualAction(): never;
+export declare function listMentions(db: SqliteDatabase, siteId: string): {
+    id: string;
+    siteId: string;
+    url: string;
+    snippet: string;
+    linked: number;
+    score: number;
+    kind: string;
+    createdAt: string;
+}[];
+export declare function listOutreach(db: SqliteDatabase, siteId: string): {
+    id: string;
+    siteId: string;
+    mentionId: string | null;
+    toEmail: string | null;
+    subject: string;
+    body: string;
+    state: string;
+    createdAt: string;
+}[];
+export declare function listInbound404s(db: SqliteDatabase, siteId: string): {
+    id: string;
+    siteId: string;
+    sourceUrl: string;
+    targetUrl: string;
+    status: number | null;
+    createdAt: string;
+}[];
+export declare function brandHostFromOrigin(origin: string): string;
+//# sourceMappingURL=offpage.d.ts.map