@agentsean/providers 1.0.0

package/dist/unavailable.js

@@ -0,0 +1,65 @@
+import { ProviderRefusedError } from "./refuse.js";
+import { freeEstimate } from "./rates.js";
+export function unavailableSerp() {
+    return {
+        id: "none",
+        available: false,
+        serp() {
+            return {
+                estimate: freeEstimate("none", "serp", "unavailable", 0, "no licensed SERP provider"),
+                async run() {
+                    throw new ProviderRefusedError("no_licensed_serp", "No licensed SERP provider configured. Sean never scrapes Google. Add a DataForSEO key to upgrade in place.");
+                },
+            };
+        },
+    };
+}
+export function unavailableVolume() {
+    return {
+        id: "none",
+        volume() {
+            return {
+                estimate: freeEstimate("none", "volume", "unavailable", 0, "no volume provider"),
+                async run() {
+                    return [];
+                },
+            };
+        },
+    };
+}
+export function unavailableBacklinks() {
+    return {
+        id: "none",
+        available: false,
+        overview() {
+            return {
+                estimate: freeEstimate("none", "backlinks", "unavailable", 0),
+                async run() {
+                    throw new ProviderRefusedError("no_backlinks_provider", "No backlink/authority provider configured. OpenPageRank is the free authority proxy; DataForSEO is the paid graph.");
+                },
+            };
+        },
+    };
+}
+export function emptyKeywords() {
+    return {
+        id: "none",
+        demand() {
+            return {
+                estimate: freeEstimate("none", "keywords", "empty", 0),
+                async run() {
+                    return [];
+                },
+            };
+        },
+        related() {
+            return {
+                estimate: freeEstimate("none", "keywords", "empty", 0),
+                async run() {
+                    return [];
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=unavailable.js.map

package/dist/unavailable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unavailable.js","sourceRoot":"","sources":["../src/unavailable.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAY1C,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,EAAE,EAAE,MAAM;QACV,SAAS,EAAE,KAAK;QAChB,IAAI;YACF,OAAO;gBACL,QAAQ,EAAE,YAAY,CACpB,MAAM,EACN,MAAM,EACN,aAAa,EACb,CAAC,EACD,2BAA2B,CAC5B;gBACD,KAAK,CAAC,GAAG;oBACP,MAAM,IAAI,oBAAoB,CAC5B,kBAAkB,EAClB,4GAA4G,CAC7G,CAAC;gBACJ,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,EAAE,EAAE,MAAM;QACV,MAAM;YACJ,OAAO;gBACL,QAAQ,EAAE,YAAY,CACpB,MAAM,EACN,QAAQ,EACR,aAAa,EACb,CAAC,EACD,oBAAoB,CACrB;gBACD,KAAK,CAAC,GAAG;oBACP,OAAO,EAAE,CAAC;gBACZ,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL,EAAE,EAAE,MAAM;QACV,SAAS,EAAE,KAAK;QAChB,QAAQ;YACN,OAAO;gBACL,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,CAAC,CAAC;gBAC7D,KAAK,CAAC,GAAG;oBACP,MAAM,IAAI,oBAAoB,CAC5B,uBAAuB,EACvB,oHAAoH,CACrH,CAAC;gBACJ,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa;IAK3B,OAAO;QACL,EAAE,EAAE,MAAM;QACV,MAAM;YACJ,OAAO;gBACL,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;gBACtD,KAAK,CAAC,GAAG;oBACP,OAAO,EAAE,CAAC;gBACZ,CAAC;aACF,CAAC;QACJ,CAAC;QACD,OAAO;YACL,OAAO;gBACL,QAAQ,EAAE,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,CAAC,CAAC;gBACtD,KAAK,CAAC,GAAG;oBACP,OAAO,EAAE,CAAC;gBACZ,CAAC;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/wayback.d.ts

@@ -0,0 +1,6 @@
+import type { WaybackCapture } from "./types.js";
+export declare function waybackCdx(url: string, opts?: {
+    fetch?: typeof fetch;
+    limit?: number;
+}): Promise<WaybackCapture[]>;
+//# sourceMappingURL=wayback.d.ts.map

package/dist/wayback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wayback.d.ts","sourceRoot":"","sources":["../src/wayback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,cAAc,EAAE,CAAC,CAkB3B"}

package/dist/wayback.js

@@ -0,0 +1,25 @@
+const CDX = "https://web.archive.org/cdx/search/cdx";
+export async function waybackCdx(url, opts) {
+    const fetchFn = opts?.fetch ?? fetch;
+    const endpoint = new URL(CDX);
+    endpoint.searchParams.set("url", url);
+    endpoint.searchParams.set("output", "json");
+    endpoint.searchParams.set("limit", String(opts?.limit ?? 5));
+    endpoint.searchParams.set("fl", "original,timestamp,statuscode");
+    const res = await fetchFn(endpoint, { headers: { accept: "application/json" } });
+    if (!res.ok)
+        throw new Error(`Wayback CDX HTTP ${res.status}`);
+    const json = (await res.json());
+    if (!Array.isArray(json) || json.length < 2)
+        return [];
+    const rows = json.slice(1);
+    return rows.map((row) => {
+        const cap = { url, timestamp: row[1] ?? "" };
+        if (row[0])
+            cap.original = row[0];
+        if (row[2])
+            cap.status = row[2];
+        return cap;
+    });
+}
+//# sourceMappingURL=wayback.js.map

package/dist/wayback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wayback.js","sourceRoot":"","sources":["../src/wayback.ts"],"names":[],"mappings":"AAEA,MAAM,GAAG,GAAG,wCAAwC,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAW,EACX,IAA+C;IAE/C,MAAM,OAAO,GAAG,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC5C,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7D,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAC;IACjE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IACjF,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAY,CAAC;IAC3C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAe,CAAC;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACtB,MAAM,GAAG,GAAmB,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QAC7D,IAAI,GAAG,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,GAAG,CAAC,CAAC,CAAC;YAAE,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAChC,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/wikidata.d.ts

@@ -0,0 +1,6 @@
+import type { EntityHit } from "./types.js";
+export declare function wikidataSearch(q: string, opts?: {
+    fetch?: typeof fetch;
+    limit?: number;
+}): Promise<EntityHit[]>;
+//# sourceMappingURL=wikidata.d.ts.map

package/dist/wikidata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikidata.d.ts","sourceRoot":"","sources":["../src/wikidata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5C,wBAAsB,cAAc,CAClC,CAAC,EAAE,MAAM,EACT,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9C,OAAO,CAAC,SAAS,EAAE,CAAC,CAwBtB"}

package/dist/wikidata.js

@@ -0,0 +1,23 @@
+const WD = "https://www.wikidata.org/w/api.php";
+export async function wikidataSearch(q, opts) {
+    const fetchFn = opts?.fetch ?? fetch;
+    const url = new URL(WD);
+    url.searchParams.set("action", "wbsearchentities");
+    url.searchParams.set("search", q);
+    url.searchParams.set("language", "en");
+    url.searchParams.set("format", "json");
+    url.searchParams.set("limit", String(opts?.limit ?? 5));
+    const res = await fetchFn(url, { headers: { accept: "application/json" } });
+    if (!res.ok)
+        throw new Error(`Wikidata HTTP ${res.status}`);
+    const json = (await res.json());
+    return (json.search ?? []).map((hit) => {
+        const row = { id: hit.id, label: hit.label ?? hit.id };
+        if (hit.description)
+            row.description = hit.description;
+        if (hit.concepturi)
+            row.url = hit.concepturi;
+        return row;
+    });
+}
+//# sourceMappingURL=wikidata.js.map

package/dist/wikidata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikidata.js","sourceRoot":"","sources":["../src/wikidata.ts"],"names":[],"mappings":"AAEA,MAAM,EAAE,GAAG,oCAAoC,CAAC;AAEhD,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,CAAS,EACT,IAA+C;IAE/C,MAAM,OAAO,GAAG,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,CAAC;IACxB,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IACnD,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAClC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACvC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAC5E,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAO7B,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACrC,MAAM,GAAG,GAAc,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,EAAE,EAAE,CAAC;QAClE,IAAI,GAAG,CAAC,WAAW;YAAE,GAAG,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;QACvD,IAAI,GAAG,CAAC,UAAU;YAAE,GAAG,CAAC,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC;QAC7C,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@agentsean/providers",
+  "version": "1.0.0",
+  "license": "AGPL-3.0-only",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "dependencies": {
+    "drizzle-orm": "0.45.2",
+    "@agentsean/credentials": "1.0.0",
+    "@agentsean/db": "1.0.0"
+  },
+  "devDependencies": {
+    "typescript": "~5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/seziro-team/agentsean.git",
+    "directory": "packages/providers"
+  },
+  "homepage": "https://github.com/seziro-team/agentsean#readme",
+  "bugs": {
+    "url": "https://github.com/seziro-team/agentsean/issues"
+  },
+  "author": "Seziro (https://seziro.com)",
+  "description": "Agent Sean — providers module",
+  "keywords": [
+    "seo",
+    "agent",
+    "agentsean",
+    "seo-automation"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run --config ../../vitest.config.ts"
+  }
+}