@agentsean/providers 1.0.0

package/dist/jina.js

@@ -0,0 +1,18 @@
+/** Jina Reader keyless, 20 RPM. */
+export async function jinaRead(url, opts) {
+    const fetchFn = opts?.fetch ?? fetch;
+    const res = await fetchFn(`https://r.jina.ai/${url}`, {
+        headers: { accept: "text/plain" },
+    });
+    if (!res.ok)
+        throw new Error(`Jina Reader HTTP ${res.status}`);
+    const text = await res.text();
+    const titleMatch = text.match(/^Title:\s*(.+)$/m);
+    return {
+        url,
+        text,
+        provider: "jina",
+        ...(titleMatch?.[1] ? { title: titleMatch[1].trim() } : {}),
+    };
+}
+//# sourceMappingURL=jina.js.map

package/dist/jina.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jina.js","sourceRoot":"","sources":["../src/jina.ts"],"names":[],"mappings":"AAEA,mCAAmC;AACnC,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAW,EACX,IAA+B;IAE/B,MAAM,OAAO,GAAG,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC;IACrC,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,qBAAqB,GAAG,EAAE,EAAE;QACpD,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;KAClC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAClD,OAAO;QACL,GAAG;QACH,IAAI;QACJ,QAAQ,EAAE,MAAM;QAChB,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5D,CAAC;AACJ,CAAC"}

package/dist/ledger.d.ts

@@ -0,0 +1,13 @@
+import { type SqliteDatabase } from "@agentsean/db";
+import type { CostEstimate } from "./types.js";
+export declare function recordQuote(db: SqliteDatabase, estimate: CostEstimate, opts?: {
+    siteId?: string | null;
+    actualUsd?: number | null;
+}): string;
+export declare function debitProvider(db: SqliteDatabase, estimate: CostEstimate, opts?: {
+    siteId?: string | null;
+    actualUsd?: number | null;
+}): void;
+export declare function spendTodayUsd(db: SqliteDatabase, siteId: string, now?: Date): number;
+export declare function remainingBudgetUsd(db: SqliteDatabase, siteId: string, dailyBudgetUsd: number, now?: Date): number;
+//# sourceMappingURL=ledger.d.ts.map

package/dist/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8B,KAAK,cAAc,EAAE,MAAM,eAAe,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,wBAAgB,WAAW,CACzB,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,YAAY,EACtB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D,MAAM,CAkBR;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,cAAc,EAClB,QAAQ,EAAE,YAAY,EACtB,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAC3D,IAAI,CA2BN;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,EACd,GAAG,OAAa,GACf,MAAM,CAQR;AAED,wBAAgB,kBAAkB,CAChC,EAAE,EAAE,cAAc,EAClB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,EACtB,GAAG,OAAa,GACf,MAAM,CAER"}

package/dist/ledger.js

@@ -0,0 +1,64 @@
+import { randomUUID } from "node:crypto";
+import { and, eq, gte } from "drizzle-orm";
+import { costLedger, providerQuotes } from "@agentsean/db";
+export function recordQuote(db, estimate, opts) {
+    const now = new Date().toISOString();
+    const id = randomUUID();
+    db.insert(providerQuotes)
+        .values({
+        id,
+        siteId: opts?.siteId ?? null,
+        provider: estimate.provider,
+        capability: estimate.capability,
+        operation: estimate.operation,
+        units: estimate.units,
+        estimatedUsd: estimate.estimatedUsd,
+        actualUsd: opts?.actualUsd ?? null,
+        free: estimate.free ? 1 : 0,
+        createdAt: now,
+    })
+        .run();
+    return id;
+}
+export function debitProvider(db, estimate, opts) {
+    const now = new Date().toISOString();
+    const actual = opts?.actualUsd ?? estimate.estimatedUsd;
+    recordQuote(db, estimate, { siteId: opts?.siteId ?? null, actualUsd: actual });
+    if (actual <= 0 && estimate.free)
+        return;
+    db.insert(costLedger)
+        .values({
+        id: randomUUID(),
+        siteId: opts?.siteId ?? null,
+        ts: now,
+        provider: estimate.provider,
+        model: null,
+        operation: `${estimate.capability}:${estimate.operation}`,
+        inputTokens: null,
+        outputTokens: null,
+        costUsd: actual,
+        currency: "USD",
+        meta: JSON.stringify({
+            units: estimate.units,
+            unitUsd: estimate.unitUsd,
+            estimatedUsd: estimate.estimatedUsd,
+            free: estimate.free,
+            notes: estimate.notes ?? null,
+        }),
+        createdAt: now,
+    })
+        .run();
+}
+export function spendTodayUsd(db, siteId, now = new Date()) {
+    const day = now.toISOString().slice(0, 10);
+    const rows = db
+        .select()
+        .from(costLedger)
+        .where(and(eq(costLedger.siteId, siteId), gte(costLedger.ts, day)))
+        .all();
+    return rows.reduce((s, r) => s + (r.costUsd ?? 0), 0);
+}
+export function remainingBudgetUsd(db, siteId, dailyBudgetUsd, now = new Date()) {
+    return Math.max(0, dailyBudgetUsd - spendTodayUsd(db, siteId, now));
+}
+//# sourceMappingURL=ledger.js.map

package/dist/ledger.js.map

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

package/dist/openpagerank.d.ts

@@ -0,0 +1,11 @@
+import type { BacklinkOverview, BacklinksCapability } from "./types.js";
+export declare function fetchOpenPageRank(domain: string, opts: {
+    apiKey: string;
+    fetch?: typeof fetch;
+}): Promise<BacklinkOverview>;
+/** 30k free domain lookups/month. Authority proxy, not a backlink graph. */
+export declare function createOpenPageRank(opts: {
+    apiKey: string;
+    fetch?: typeof fetch;
+}): BacklinksCapability;
+//# sourceMappingURL=openpagerank.d.ts.map

package/dist/openpagerank.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openpagerank.d.ts","sourceRoot":"","sources":["../src/openpagerank.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,mBAAmB,EAAgB,MAAM,YAAY,CAAC;AAKtF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;CAAE,GAC7C,OAAO,CAAC,gBAAgB,CAAC,CAmB3B;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB,GAAG,mBAAmB,CAkBtB"}

package/dist/openpagerank.js

@@ -0,0 +1,44 @@
+import { freeEstimate } from "./rates.js";
+const OPR_URL = "https://openpagerank.com/api/v1.0/getPageRank";
+export async function fetchOpenPageRank(domain, opts) {
+    const fetchFn = opts.fetch ?? fetch;
+    const url = new URL(OPR_URL);
+    url.searchParams.append("domains[]", domain);
+    const res = await fetchFn(url, {
+        headers: { "API-OPR": opts.apiKey, accept: "application/json" },
+    });
+    if (!res.ok)
+        throw new Error(`OpenPageRank HTTP ${res.status}`);
+    const json = (await res.json());
+    const row = json.response?.[0];
+    return {
+        target: domain,
+        provider: "openpagerank",
+        kind: "authority_proxy",
+        pageRank: typeof row?.page_rank_decimal === "number" ? row.page_rank_decimal : null,
+        rank: row?.rank && Number.isFinite(Number(row.rank)) ? Number(row.rank) : null,
+    };
+}
+/** 30k free domain lookups/month. Authority proxy, not a backlink graph. */
+export function createOpenPageRank(opts) {
+    return {
+        id: "openpagerank",
+        available: true,
+        overview(target) {
+            const host = hostOf(target);
+            return {
+                estimate: freeEstimate("openpagerank", "backlinks", "getPageRank", 1, "authority proxy · 30k free lookups/month"),
+                run: () => fetchOpenPageRank(host, opts),
+            };
+        },
+    };
+}
+function hostOf(target) {
+    try {
+        return new URL(target.includes("://") ? target : `https://${target}`).hostname.replace(/^www\./, "");
+    }
+    catch {
+        return target.replace(/^www\./, "");
+    }
+}
+//# sourceMappingURL=openpagerank.js.map

package/dist/openpagerank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openpagerank.js","sourceRoot":"","sources":["../src/openpagerank.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,OAAO,GAAG,+CAA+C,CAAC;AAEhE,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAc,EACd,IAA8C;IAE9C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;QAC7B,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,kBAAkB,EAAE;KAChE,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,qBAAqB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAChE,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAE7B,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/B,OAAO;QACL,MAAM,EAAE,MAAM;QACd,QAAQ,EAAE,cAAc;QACxB,IAAI,EAAE,iBAAiB;QACvB,QAAQ,EAAE,OAAO,GAAG,EAAE,iBAAiB,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI;QACnF,IAAI,EAAE,GAAG,EAAE,IAAI,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI;KAC/E,CAAC;AACJ,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,kBAAkB,CAAC,IAGlC;IACC,OAAO;QACL,EAAE,EAAE,cAAc;QAClB,SAAS,EAAE,IAAI;QACf,QAAQ,CAAC,MAAc;YACrB,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,OAAO;gBACL,QAAQ,EAAE,YAAY,CACpB,cAAc,EACd,WAAW,EACX,aAAa,EACb,CAAC,EACD,0CAA0C,CAC3C;gBACD,GAAG,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC;aACzC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,MAAc;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CACZ,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,MAAM,EAAE,CACtD,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/rates.d.ts

@@ -0,0 +1,28 @@
+import type { Capability, CostEstimate } from "./types.js";
+/**
+ * DataForSEO published rates (PLAN Phase 6). Quoted *before* the call.
+ * SERP $0.60/1k standard queue · Keywords Data $0.06/task (≤1,000 keywords)
+ * Labs $0.012/task · Backlinks $0.024/req + $0.000036/row · On-Page $0.15/1k.
+ */
+export declare const DFS_RATES: {
+    readonly serpPerKeyword: number;
+    readonly keywordsDataPerTask: 0.06;
+    readonly keywordsDataMaxKeywords: 1000;
+    readonly labsPerTask: 0.012;
+    readonly backlinksPerRequest: 0.024;
+    readonly backlinksPerRow: 0.000036;
+    readonly onPagePerPage: number;
+};
+export declare const FREE_NOTE = "zero paid keys";
+export declare function freeEstimate(provider: string, capability: Capability, operation: string, units?: number, notes?: string): CostEstimate;
+export declare function paidEstimate(opts: {
+    provider: string;
+    capability: Capability;
+    operation: string;
+    units: number;
+    unitUsd: number;
+    notes?: string;
+}): CostEstimate;
+export declare function roundUsd(n: number): number;
+export declare function keywordsDataTasks(keywordCount: number): number;
+//# sourceMappingURL=rates.d.ts.map

package/dist/rates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rates.d.ts","sourceRoot":"","sources":["../src/rates.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;GAIG;AACH,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC;AAEX,eAAO,MAAM,SAAS,mBAAmB,CAAC;AAE1C,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,KAAK,SAAI,EACT,KAAK,CAAC,EAAE,MAAM,GACb,YAAY,CAWd;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,YAAY,CAYf;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/rates.js

@@ -0,0 +1,47 @@
+/**
+ * DataForSEO published rates (PLAN Phase 6). Quoted *before* the call.
+ * SERP $0.60/1k standard queue · Keywords Data $0.06/task (≤1,000 keywords)
+ * Labs $0.012/task · Backlinks $0.024/req + $0.000036/row · On-Page $0.15/1k.
+ */
+export const DFS_RATES = {
+    serpPerKeyword: 0.6 / 1000,
+    keywordsDataPerTask: 0.06,
+    keywordsDataMaxKeywords: 1000,
+    labsPerTask: 0.012,
+    backlinksPerRequest: 0.024,
+    backlinksPerRow: 0.000036,
+    onPagePerPage: 0.15 / 1000,
+};
+export const FREE_NOTE = "zero paid keys";
+export function freeEstimate(provider, capability, operation, units = 1, notes) {
+    return {
+        provider,
+        capability,
+        operation,
+        units,
+        unitUsd: 0,
+        estimatedUsd: 0,
+        free: true,
+        ...(notes ? { notes } : {}),
+    };
+}
+export function paidEstimate(opts) {
+    const estimatedUsd = roundUsd(opts.units * opts.unitUsd);
+    return {
+        provider: opts.provider,
+        capability: opts.capability,
+        operation: opts.operation,
+        units: opts.units,
+        unitUsd: opts.unitUsd,
+        estimatedUsd,
+        free: false,
+        ...(opts.notes ? { notes: opts.notes } : {}),
+    };
+}
+export function roundUsd(n) {
+    return Math.round(n * 1_000_000) / 1_000_000;
+}
+export function keywordsDataTasks(keywordCount) {
+    return Math.max(1, Math.ceil(keywordCount / DFS_RATES.keywordsDataMaxKeywords));
+}
+//# sourceMappingURL=rates.js.map

package/dist/rates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rates.js","sourceRoot":"","sources":["../src/rates.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,cAAc,EAAE,GAAG,GAAG,IAAI;IAC1B,mBAAmB,EAAE,IAAI;IACzB,uBAAuB,EAAE,IAAI;IAC7B,WAAW,EAAE,KAAK;IAClB,mBAAmB,EAAE,KAAK;IAC1B,eAAe,EAAE,QAAQ;IACzB,aAAa,EAAE,IAAI,GAAG,IAAI;CAClB,CAAC;AAEX,MAAM,CAAC,MAAM,SAAS,GAAG,gBAAgB,CAAC;AAE1C,MAAM,UAAU,YAAY,CAC1B,QAAgB,EAChB,UAAsB,EACtB,SAAiB,EACjB,KAAK,GAAG,CAAC,EACT,KAAc;IAEd,OAAO;QACL,QAAQ;QACR,UAAU;QACV,SAAS;QACT,KAAK;QACL,OAAO,EAAE,CAAC;QACV,YAAY,EAAE,CAAC;QACf,IAAI,EAAE,IAAI;QACV,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAO5B;IACC,MAAM,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IACzD,OAAO;QACL,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,YAAY;QACZ,IAAI,EAAE,KAAK;QACX,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,CAAS;IAChC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,YAAoB;IACpD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC,uBAAuB,CAAC,CAAC,CAAC;AAClF,CAAC"}

package/dist/refuse.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Dead options (PLAN Phase 6) and T4: Sean never scrapes Google itself.
+ * Google's spam policy names "scraping results for rank-checking purposes".
+ */
+export declare const DEAD_PROVIDERS: readonly [{
+    readonly id: "bing_search_api";
+    readonly reason: "Bing Search API was decommissioned 2025-08-11";
+}, {
+    readonly id: "google_cse";
+    readonly reason: "Google Custom Search JSON API is closed to new customers with a hard shutdown 2027-01-01";
+}, {
+    readonly id: "brave_search";
+    readonly reason: "Brave removed its free tier in Feb 2026 and forbids storing results";
+}, {
+    readonly id: "pytrends";
+    readonly reason: "pytrends was archived 2025-04-17";
+}, {
+    readonly id: "google_trends_api";
+    readonly reason: "Google Trends API remains invite-only alpha with no self-serve key";
+}, {
+    readonly id: "serpapi";
+    readonly reason: "Google sued SerpApi on 2025-12-19; Sean does not scrape Google";
+}];
+export declare class ProviderRefusedError extends Error {
+    name: string;
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+export declare function isDeadProvider(id: string): boolean;
+export declare function refuseDeadProvider(id: string): never;
+/** T4 — SERP scraping bundled by default is refused. No setting exists. */
+export declare function scrapeGoogleSerp(): never;
+//# sourceMappingURL=refuse.d.ts.map

package/dist/refuse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refuse.d.ts","sourceRoot":"","sources":["../src/refuse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;EA0BjB,CAAC;AAEX,qBAAa,oBAAqB,SAAQ,KAAK;IACpC,IAAI,SAA0B;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBACV,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI1C;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAGlD;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,KAAK,CAOpD;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,IAAI,KAAK,CAKxC"}

package/dist/refuse.js

@@ -0,0 +1,52 @@
+/**
+ * Dead options (PLAN Phase 6) and T4: Sean never scrapes Google itself.
+ * Google's spam policy names "scraping results for rank-checking purposes".
+ */
+export const DEAD_PROVIDERS = [
+    {
+        id: "bing_search_api",
+        reason: "Bing Search API was decommissioned 2025-08-11",
+    },
+    {
+        id: "google_cse",
+        reason: "Google Custom Search JSON API is closed to new customers with a hard shutdown 2027-01-01",
+    },
+    {
+        id: "brave_search",
+        reason: "Brave removed its free tier in Feb 2026 and forbids storing results",
+    },
+    {
+        id: "pytrends",
+        reason: "pytrends was archived 2025-04-17",
+    },
+    {
+        id: "google_trends_api",
+        reason: "Google Trends API remains invite-only alpha with no self-serve key",
+    },
+    {
+        id: "serpapi",
+        reason: "Google sued SerpApi on 2025-12-19; Sean does not scrape Google",
+    },
+];
+export class ProviderRefusedError extends Error {
+    name = "ProviderRefusedError";
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+export function isDeadProvider(id) {
+    const key = id.toLowerCase().replace(/[\s-]+/g, "_");
+    return DEAD_PROVIDERS.some((p) => p.id === key || key.includes(p.id));
+}
+export function refuseDeadProvider(id) {
+    const key = id.toLowerCase().replace(/[\s-]+/g, "_");
+    const hit = DEAD_PROVIDERS.find((p) => p.id === key || key.includes(p.id));
+    throw new ProviderRefusedError("dead_provider", hit?.reason ?? `Provider ${id} is not supported.`);
+}
+/** T4 — SERP scraping bundled by default is refused. No setting exists. */
+export function scrapeGoogleSerp() {
+    throw new ProviderRefusedError("serp_scrape_refused", "Sean never scrapes Google. Rank data comes from a licensed vendor you configure (DataForSEO), or not at all. Autocomplete is expansion, not rank checking.");
+}
+//# sourceMappingURL=refuse.js.map

package/dist/refuse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refuse.js","sourceRoot":"","sources":["../src/refuse.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B;QACE,EAAE,EAAE,iBAAiB;QACrB,MAAM,EAAE,+CAA+C;KACxD;IACD;QACE,EAAE,EAAE,YAAY;QAChB,MAAM,EACJ,0FAA0F;KAC7F;IACD;QACE,EAAE,EAAE,cAAc;QAClB,MAAM,EAAE,qEAAqE;KAC9E;IACD;QACE,EAAE,EAAE,UAAU;QACd,MAAM,EAAE,kCAAkC;KAC3C;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,MAAM,EAAE,oEAAoE;KAC7E;IACD;QACE,EAAE,EAAE,SAAS;QACb,MAAM,EAAE,gEAAgE;KACzE;CACO,CAAC;AAEX,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,IAAI,GAAG,sBAAsB,CAAC;IAC9B,IAAI,CAAS;IACtB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED,MAAM,UAAU,cAAc,CAAC,EAAU;IACvC,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrD,OAAO,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,EAAU;IAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IACrD,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3E,MAAM,IAAI,oBAAoB,CAC5B,eAAe,EACf,GAAG,EAAE,MAAM,IAAI,YAAY,EAAE,oBAAoB,CAClD,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB;IAC9B,MAAM,IAAI,oBAAoB,CAC5B,qBAAqB,EACrB,4JAA4J,CAC7J,CAAC;AACJ,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,15 @@
+import type { CredentialStore } from "@agentsean/credentials";
+import type { KeywordRow, ProviderKeys, ProviderStack } from "./types.js";
+export declare const PROVIDER_ACCOUNTS: {
+    readonly dataforseo: "provider:dataforseo";
+    readonly bing: "provider:bing";
+    readonly openpagerank: "provider:openpagerank";
+    readonly openseo: "provider:openseo";
+};
+export declare function loadProviderKeys(store?: CredentialStore, extra?: ProviderKeys): Promise<ProviderKeys>;
+export declare function createProviderStack(opts: {
+    keys?: ProviderKeys;
+    gsc?: KeywordRow[];
+    fetch?: typeof fetch;
+}): ProviderStack;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAkB1E,eAAO,MAAM,iBAAiB;;;;;CAKpB,CAAC;AAEX,wBAAsB,gBAAgB,CACpC,KAAK,CAAC,EAAE,eAAe,EACvB,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,YAAY,CAAC,CAUvB;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB,GAAG,aAAa,CA0ChB"}

package/dist/registry.js

@@ -0,0 +1,71 @@
+import { createGscKeywords } from "./gsc.js";
+import { createBingClient, createBingVolume } from "./bing.js";
+import { createDataForSeoBacklinks, createDataForSeoClient, createDataForSeoSerp, createDataForSeoVolume, } from "./dataforseo.js";
+import { createOpenPageRank } from "./openpagerank.js";
+import { emptyKeywords, unavailableBacklinks, unavailableSerp, unavailableVolume, } from "./unavailable.js";
+import { isDeadProvider, refuseDeadProvider } from "./refuse.js";
+export const PROVIDER_ACCOUNTS = {
+    dataforseo: "provider:dataforseo",
+    bing: "provider:bing",
+    openpagerank: "provider:openpagerank",
+    openseo: "provider:openseo",
+};
+export async function loadProviderKeys(store, extra) {
+    const keys = { ...extra };
+    if (!store)
+        return keys;
+    const dfs = await store.get(PROVIDER_ACCOUNTS.dataforseo);
+    const bing = await store.get(PROVIDER_ACCOUNTS.bing);
+    const opr = await store.get(PROVIDER_ACCOUNTS.openpagerank);
+    if (dfs)
+        keys.dataforseo = dfs.unwrap();
+    if (bing)
+        keys.bing = bing.unwrap();
+    if (opr)
+        keys.openpagerank = opr.unwrap();
+    return keys;
+}
+export function createProviderStack(opts) {
+    const keys = opts.keys ?? {};
+    for (const id of Object.keys(keys)) {
+        if (isDeadProvider(id))
+            refuseDeadProvider(id);
+    }
+    const gsc = opts.gsc?.length ? createGscKeywords(opts.gsc) : emptyKeywords();
+    const dfs = keys.dataforseo
+        ? createDataForSeoClient({
+            loginPassword: keys.dataforseo,
+            ...(opts.fetch ? { fetch: opts.fetch } : {}),
+        })
+        : null;
+    const bing = keys.bing
+        ? createBingClient({
+            apiKey: keys.bing,
+            ...(opts.fetch ? { fetch: opts.fetch } : {}),
+        })
+        : null;
+    return {
+        keywords: gsc,
+        volume: dfs
+            ? createDataForSeoVolume(dfs)
+            : bing
+                ? createBingVolume(bing)
+                : unavailableVolume(),
+        serp: dfs ? createDataForSeoSerp(dfs) : unavailableSerp(),
+        backlinks: dfs
+            ? createDataForSeoBacklinks(dfs)
+            : keys.openpagerank
+                ? createOpenPageRank({
+                    apiKey: keys.openpagerank,
+                    ...(opts.fetch ? { fetch: opts.fetch } : {}),
+                })
+                : unavailableBacklinks(),
+        keys: {
+            dataforseo: Boolean(keys.dataforseo),
+            bing: Boolean(keys.bing),
+            openpagerank: Boolean(keys.openpagerank),
+        },
+        paidUpgrade: Boolean(keys.dataforseo),
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,119 @@
+/** One interface per capability. Cost is quoted before the call. */
+export declare const CAPABILITIES: readonly ["serp", "keywords", "backlinks", "volume"];
+export type Capability = (typeof CAPABILITIES)[number];
+export type CostEstimate = {
+    provider: string;
+    capability: Capability;
+    operation: string;
+    units: number;
+    unitUsd: number;
+    estimatedUsd: number;
+    free: boolean;
+    notes?: string;
+};
+export type ProviderCall<T> = {
+    estimate: CostEstimate;
+    run: () => Promise<T>;
+};
+export type KeywordRow = {
+    query: string;
+    source: string;
+    clicks?: number;
+    impressions?: number;
+    position?: number | null;
+    page?: string | null;
+    volume?: number | null;
+    relatedTo?: string;
+};
+export type VolumeRow = {
+    query: string;
+    volume: number | null;
+    source: string;
+    country?: string;
+};
+export type SerpItem = {
+    rank: number;
+    url: string;
+    title: string;
+    snippet?: string;
+};
+export type SerpResult = {
+    query: string;
+    provider: string;
+    items: SerpItem[];
+    paa?: string[];
+    related?: string[];
+};
+export type BacklinkOverview = {
+    target: string;
+    provider: string;
+    /** OpenPageRank is an authority proxy, not a backlink graph. */
+    kind: "authority_proxy" | "backlinks";
+    pageRank?: number | null;
+    rank?: number | null;
+    referringDomains?: number | null;
+    backlinks?: number | null;
+};
+export type KeywordsCapability = {
+    id: string;
+    demand(opts: {
+        queries: KeywordRow[];
+    }): ProviderCall<KeywordRow[]>;
+    related(seed: string, opts?: {
+        limit?: number;
+    }): ProviderCall<KeywordRow[]>;
+};
+export type VolumeCapability = {
+    id: string;
+    volume(queries: string[], opts?: {
+        country?: string;
+    }): ProviderCall<VolumeRow[]>;
+};
+export type SerpCapability = {
+    id: string;
+    available: boolean;
+    serp(query: string, opts?: {
+        location?: string;
+    }): ProviderCall<SerpResult>;
+};
+export type BacklinksCapability = {
+    id: string;
+    available: boolean;
+    overview(target: string): ProviderCall<BacklinkOverview>;
+};
+export type ExtractPage = {
+    url: string;
+    title?: string;
+    text: string;
+    provider: string;
+};
+export type EntityHit = {
+    id: string;
+    label: string;
+    description?: string;
+    url?: string;
+};
+export type WaybackCapture = {
+    url: string;
+    timestamp: string;
+    status?: string;
+    original?: string;
+};
+export type ProviderKeys = {
+    dataforseo?: string;
+    bing?: string;
+    openpagerank?: string;
+};
+export type ProviderStack = {
+    keywords: KeywordsCapability;
+    volume: VolumeCapability;
+    serp: SerpCapability;
+    backlinks: BacklinksCapability;
+    keys: {
+        dataforseo: boolean;
+        bing: boolean;
+        openpagerank: boolean;
+    };
+    paidUpgrade: boolean;
+};
+//# 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":"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"}

package/dist/types.js

@@ -0,0 +1,3 @@
+/** One interface per capability. Cost is quoted before the call. */
+export const CAPABILITIES = ["serp", "keywords", "backlinks", "volume"];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,oEAAoE;AAEpE,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAU,CAAC"}

package/dist/unavailable.d.ts

@@ -0,0 +1,10 @@
+import type { BacklinksCapability, KeywordRow, ProviderCall, SerpCapability, VolumeCapability } from "./types.js";
+export declare function unavailableSerp(): SerpCapability;
+export declare function unavailableVolume(): VolumeCapability;
+export declare function unavailableBacklinks(): BacklinksCapability;
+export declare function emptyKeywords(): {
+    id: string;
+    demand: () => ProviderCall<KeywordRow[]>;
+    related: (seed: string) => ProviderCall<KeywordRow[]>;
+};
+//# sourceMappingURL=unavailable.d.ts.map

package/dist/unavailable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unavailable.d.ts","sourceRoot":"","sources":["../src/unavailable.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,cAAc,EAEd,gBAAgB,EAEjB,MAAM,YAAY,CAAC;AAEpB,wBAAgB,eAAe,IAAI,cAAc,CAsBhD;AAED,wBAAgB,iBAAiB,IAAI,gBAAgB,CAkBpD;AAED,wBAAgB,oBAAoB,IAAI,mBAAmB,CAgB1D;AAED,wBAAgB,aAAa,IAAI;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC;IACzC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,YAAY,CAAC,UAAU,EAAE,CAAC,CAAC;CACvD,CAoBA"}