@axiomworks/agentreader 0.0.0-stage → 1.6.0

package/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 AgentReader
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1,3 +1,107 @@
-# Temporary Holding Version
+# @axiomworks/agentreader
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Typed JS/TS SDK for **Axiom Works AgentReader** — pay-per-call tools for AI agents.
+
+> Not affiliated with other products named “AgentReader”. This is **Axiom Works AgentReader** at [api.axiomworks.co.uk](https://api.axiomworks.co.uk).
+
+```bash
+npm i @axiomworks/agentreader
+```
+
+```ts
+import { createClient } from "@axiomworks/agentreader";
+
+// Preview mode (no key): free truncated samples
+const preview = createClient();
+console.log(await preview.checkDomain({ domain: "example.com" }));
+
+// Paid mode: auto x402 USDC on Base
+const client = createClient({ privateKey: process.env.AGENTREADER_PRIVATE_KEY });
+const report = await client.ukCompanyLite({ number: "00445790" });
+```
+
+Also reads `AGENTREADER_PRIVATE_KEY` / `EVM_PRIVATE_KEY` / `PRIVATE_KEY` from the environment when `privateKey` is omitted.
+
+- **API:** https://api.axiomworks.co.uk  
+- **MCP (stdio npm):** [`@axiomworks/agentreader-mcp`](https://www.npmjs.com/package/@axiomworks/agentreader-mcp) — `npx -y @axiomworks/agentreader-mcp`  
+- **Remote MCP:** https://api.axiomworks.co.uk/mcp  
+- **Dashboard:** https://api.axiomworks.co.uk/dashboard  
+- **Landing:** https://grokbot1233.github.io/agentreader/  
+- **Repo:** https://github.com/grokbot1233/agentreader  
+
+## x402 payments
+
+Paid routes return HTTP 402. With a private key, the SDK wraps `fetch` via [`@x402/fetch`](https://www.npmjs.com/package/@x402/fetch) + `ExactEvmScheme` (`@x402/evm`) and settles **USDC on Base** (`eip155:8453`) automatically (EIP-3009 — no ETH gas for the payer).
+
+Without a key, GET methods append `preview=1` (free truncated JSON, 8/IP/day). A paid response without settlement throws `PaymentRequiredError` with the payment requirements attached.
+
+```ts
+import { createClient, PaymentRequiredError } from "@axiomworks/agentreader";
+
+try {
+  await createClient().ukCompany({ number: "00445790" }); // preview unless key set
+} catch (e) {
+  if (e instanceof PaymentRequiredError) console.log(e.paymentRequired);
+}
+```
+
+## Methods (USDC prices)
+
+| Method | Route | Price |
+|---|---|---|
+| `readUrl({ url })` | `/read` | $0.002 |
+| `extractLinks({ url })` | `/links` | $0.001 |
+| `checkDomain({ domain })` | `/check` | $0.001 |
+| `companyResearch({ domain })` | `/company` | $0.25 |
+| `ukCompany({ number?, name? })` | `/uk-company` | $0.50 |
+| `ukCompanyLite({ number?, name? })` | `/uk-company-lite` | $0.05 |
+| `companyFull({ domain })` | `/company-full` | $0.65 |
+| `ukCharity({ number?, name? })` | `/uk-charity` | $0.05 |
+| `ukCharityFull({ number?, name? })` | `/uk-charity-full` | $0.25 |
+| `convertDocument({ url, format? })` | `/convert` | $0.03 |
+| `createMonitor({ url, webhook, … })` | `POST /monitor` | $1.00 / 30d |
+| `walletBalances({ address, chain? })` | `/wallet` | $0.003 |
+| `txStatus({ hash, chain? })` | `/tx` | $0.003 |
+| `tokenCheck({ address, chain? })` | `/token-check` | $0.01 |
+| `fxRates({ base?, symbols?, … })` | `/fx` | $0.002 |
+| `ensLookup({ name?, address? })` | `/ens` | $0.002 |
+| `tokenMetadata({ address, chain? })` | `/token` | $0.001 |
+| `tokenAllowance({ token, owner, spender })` | `/allowance` | $0.002 |
+| `contractInfo({ address, chain? })` | `/contract` | $0.003 |
+| `gasFees({ chain? })` | `/gas` | $0.001 |
+| `blockLookup({ number?, timestamp? })` | `/block` | $0.001 |
+| `nftLookup({ contract, token_id, chain? })` | `/nft` | $0.002 |
+| `webSearch({ q })` | `/search` | $0.003 |
+| `ukPropertyPrices({ postcode })` | `/uk-property` | $0.01 |
+| `ukAreaProfile({ postcode })` | `/uk-area` | $0.005 |
+| `pricing()` | `/.well-known/x402` | free |
+
+Pass `{ preview: true }` / `{ preview: false }` on any call to override the default.
+
+```ts
+const client = createClient({ privateKey: "0x…" });
+// Force a free truncated sample even with a key:
+await client.companyResearch({ domain: "stripe.com" }, { preview: true });
+```
+
+## MCP for Claude Desktop / Cursor
+
+Prefer the companion package:
+
+```bash
+npx -y @axiomworks/agentreader-mcp
+```
+
+```json
+{
+  "mcpServers": {
+    "agentreader": {
+      "command": "npx",
+      "args": ["-y", "@axiomworks/agentreader-mcp"],
+      "env": { "AGENTREADER_PRIVATE_KEY": "0x…" }
+    }
+  }
+}
+```
+
+MIT © Axiom Works · info@axiomworks.co.uk

package/dist/index.d.ts

@@ -0,0 +1,151 @@
+type Chain = "base" | "ethereum" | "arbitrum" | "optimism" | "polygon";
+type ClientOptions = {
+    /** EVM private key (0x… or bare hex). Enables auto x402 payment on Base. */
+    privateKey?: string;
+    /** API origin. Default https://api.axiomworks.co.uk */
+    origin?: string;
+    /**
+     * When true (default if no privateKey), append preview=1 on GET paid routes
+     * for free truncated samples (8/IP/day). Ignored when paying.
+     */
+    preview?: boolean;
+    /** Optional fetch implementation (defaults to global fetch, wrapped with x402 when paying). */
+    fetch?: typeof fetch;
+    /** User-Agent suffix */
+    userAgent?: string;
+};
+type RequestOpts = {
+    /** Force preview=1 even when a key is set (still free truncated). */
+    preview?: boolean;
+    /** Extra query params */
+    query?: Record<string, string | number | boolean | undefined | null>;
+};
+
+declare class PaymentRequiredError extends Error {
+    readonly status = 402;
+    readonly paymentRequired: unknown;
+    readonly body: unknown;
+    readonly url: string;
+    constructor(url: string, paymentRequired: unknown, body: unknown);
+}
+declare class AgentReaderClient {
+    readonly origin: string;
+    readonly paying: boolean;
+    private readonly fetchFn;
+    private readonly defaultPreview;
+    private readonly ua;
+    constructor(opts?: ClientOptions);
+    private request;
+    private get;
+    /** Free: x402 catalog / prices */
+    pricing(opts?: RequestOpts): Promise<any>;
+    readUrl(input: {
+        url: string;
+    }, opts?: RequestOpts): Promise<any>;
+    extractLinks(input: {
+        url: string;
+    }, opts?: RequestOpts): Promise<any>;
+    checkDomain(input: {
+        domain: string;
+    }, opts?: RequestOpts): Promise<any>;
+    companyResearch(input: {
+        domain: string;
+    }, opts?: RequestOpts): Promise<any>;
+    ukCompany(input: {
+        number?: string;
+        name?: string;
+    }, opts?: RequestOpts): Promise<any>;
+    ukCompanyLite(input: {
+        number?: string;
+        name?: string;
+    }, opts?: RequestOpts): Promise<any>;
+    companyFull(input: {
+        domain: string;
+    }, opts?: RequestOpts): Promise<any>;
+    convertDocument(input: {
+        url: string;
+        format?: "markdown" | "text";
+    }, opts?: RequestOpts): Promise<any>;
+    createMonitor(input: {
+        url: string;
+        webhook: string;
+        selector?: string;
+        keyword?: string;
+    }, opts?: RequestOpts): Promise<any>;
+    walletBalances(input: {
+        address: string;
+        chain?: Chain;
+        tokens?: string;
+    }, opts?: RequestOpts): Promise<any>;
+    txStatus(input: {
+        hash: string;
+        chain?: Chain;
+    }, opts?: RequestOpts): Promise<any>;
+    tokenCheck(input: {
+        address: string;
+        chain?: Chain;
+    }, opts?: RequestOpts): Promise<any>;
+    fxRates(input?: {
+        base?: string;
+        symbols?: string;
+        date?: string;
+        amount?: string;
+    }, opts?: RequestOpts): Promise<any>;
+    ensLookup(input: {
+        name?: string;
+        address?: string;
+    }, opts?: RequestOpts): Promise<any>;
+    tokenMetadata(input: {
+        address: string;
+        chain?: Chain;
+    }, opts?: RequestOpts): Promise<any>;
+    tokenAllowance(input: {
+        token: string;
+        owner: string;
+        spender: string;
+        chain?: Chain;
+    }, opts?: RequestOpts): Promise<any>;
+    contractInfo(input: {
+        address: string;
+        chain?: Chain;
+    }, opts?: RequestOpts): Promise<any>;
+    gasFees(input?: {
+        chain?: Chain;
+    }, opts?: RequestOpts): Promise<any>;
+    blockLookup(input?: {
+        number?: string;
+        timestamp?: string;
+        chain?: Chain;
+    }, opts?: RequestOpts): Promise<any>;
+    nftLookup(input: {
+        contract: string;
+        token_id: string;
+        chain?: Chain;
+    }, opts?: RequestOpts): Promise<any>;
+    webSearch(input: {
+        q: string;
+        sources?: string;
+        limit?: string | number;
+    }, opts?: RequestOpts): Promise<any>;
+    ukPropertyPrices(input: {
+        postcode: string;
+        radius?: string;
+    }, opts?: RequestOpts): Promise<any>;
+    ukAreaProfile(input: {
+        postcode: string;
+    }, opts?: RequestOpts): Promise<any>;
+    ukCharity(input: {
+        number?: string;
+        name?: string;
+        suffix?: string;
+    }, opts?: RequestOpts): Promise<any>;
+    ukCharityFull(input: {
+        number?: string;
+        name?: string;
+        suffix?: string;
+    }, opts?: RequestOpts): Promise<any>;
+}
+/** Create a typed AgentReader client. Pass privateKey (or set AGENTREADER_PRIVATE_KEY) to auto-pay. */
+declare function createClient(opts?: ClientOptions): AgentReaderClient;
+
+export { AgentReaderClient, type Chain, type ClientOptions, PaymentRequiredError, type RequestOpts, createClient };

package/dist/index.js

@@ -0,0 +1,207 @@
+// src/client.ts
+import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
+import { ExactEvmScheme } from "@x402/evm/exact/client";
+import { privateKeyToAccount } from "viem/accounts";
+var DEFAULT_ORIGIN = "https://api.axiomworks.co.uk";
+var VERSION = "1.6.0";
+function normalizeKey(raw) {
+  if (!raw) return void 0;
+  const key = raw.startsWith("0x") ? raw : `0x${raw}`;
+  if (!/^0x[0-9a-fA-F]{64}$/.test(key)) {
+    throw new Error("privateKey must be a 32-byte hex string (optional 0x prefix)");
+  }
+  return key;
+}
+function qs(params) {
+  const sp = new URLSearchParams();
+  for (const [k, v] of Object.entries(params)) {
+    if (v == null || v === "") continue;
+    sp.set(k, String(v));
+  }
+  return sp.toString();
+}
+var PaymentRequiredError = class extends Error {
+  status = 402;
+  paymentRequired;
+  body;
+  url;
+  constructor(url, paymentRequired, body) {
+    super("Payment required (x402). Pass privateKey to createClient or fund/retry with @x402/fetch.");
+    this.name = "PaymentRequiredError";
+    this.url = url;
+    this.paymentRequired = paymentRequired;
+    this.body = body;
+  }
+};
+var AgentReaderClient = class {
+  origin;
+  paying;
+  fetchFn;
+  defaultPreview;
+  ua;
+  constructor(opts = {}) {
+    this.origin = (opts.origin || DEFAULT_ORIGIN).replace(/\/$/, "");
+    const key = normalizeKey(
+      opts.privateKey || process.env.AGENTREADER_PRIVATE_KEY || process.env.EVM_PRIVATE_KEY || process.env.PRIVATE_KEY
+    );
+    this.paying = !!key;
+    this.defaultPreview = opts.preview ?? !this.paying;
+    this.ua = opts.userAgent || `axiomworks-agentreader-sdk/${VERSION}`;
+    if (key) {
+      const account = privateKeyToAccount(key);
+      const client = new x402Client().register("eip155:8453", new ExactEvmScheme(account));
+      const base = opts.fetch || globalThis.fetch.bind(globalThis);
+      this.fetchFn = wrapFetchWithPayment(base, client);
+    } else {
+      this.fetchFn = opts.fetch || globalThis.fetch.bind(globalThis);
+    }
+  }
+  async request(path, init = {}, opts = {}) {
+    const url = new URL(path.startsWith("http") ? path : `${this.origin}${path}`);
+    if (opts.query) {
+      for (const [k, v] of Object.entries(opts.query)) {
+        if (v == null || v === "") continue;
+        url.searchParams.set(k, String(v));
+      }
+    }
+    const wantPreview = opts.preview === true || opts.preview !== false && this.defaultPreview && init.method !== "POST" && init.previewable !== false;
+    if (wantPreview && !url.searchParams.has("preview")) {
+      url.searchParams.set("preview", "1");
+    }
+    const res = await this.fetchFn(url.toString(), {
+      ...init,
+      headers: {
+        accept: "application/json",
+        "user-agent": this.ua,
+        ...init.headers || {}
+      }
+    });
+    const pr = res.headers.get("payment-required") || res.headers.get("PAYMENT-REQUIRED");
+    const text = await res.text();
+    let body;
+    try {
+      body = JSON.parse(text);
+    } catch {
+      body = { raw: text.slice(0, 4e3) };
+    }
+    if (res.status === 402 || pr) {
+      let payment = null;
+      if (pr) {
+        try {
+          payment = JSON.parse(Buffer.from(pr, "base64").toString("utf8"));
+        } catch {
+          payment = { raw: pr.slice(0, 200) };
+        }
+      }
+      throw new PaymentRequiredError(url.toString(), payment ?? body, body);
+    }
+    if (!res.ok) {
+      const err = new Error(body?.error || `HTTP ${res.status}`);
+      err.status = res.status;
+      err.body = body;
+      throw err;
+    }
+    return body;
+  }
+  get(path, query, opts) {
+    const q = qs({ ...query || {}, ...opts?.query || {} });
+    return this.request(`${path}${q ? `?${q}` : ""}`, { method: "GET" }, opts);
+  }
+  /** Free: x402 catalog / prices */
+  pricing(opts) {
+    return this.request(`${this.origin}/.well-known/x402`, { method: "GET", previewable: false }, { ...opts, preview: false });
+  }
+  readUrl(input, opts) {
+    return this.get("/read", input, opts);
+  }
+  extractLinks(input, opts) {
+    return this.get("/links", input, opts);
+  }
+  checkDomain(input, opts) {
+    return this.get("/check", input, opts);
+  }
+  companyResearch(input, opts) {
+    return this.get("/company", input, opts);
+  }
+  ukCompany(input, opts) {
+    return this.get("/uk-company", input, opts);
+  }
+  ukCompanyLite(input, opts) {
+    return this.get("/uk-company-lite", input, opts);
+  }
+  companyFull(input, opts) {
+    return this.get("/company-full", input, opts);
+  }
+  convertDocument(input, opts) {
+    return this.get("/convert", { format: "markdown", ...input }, opts);
+  }
+  createMonitor(input, opts) {
+    return this.request(
+      `${this.origin}/monitor`,
+      {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(input),
+        previewable: false
+      },
+      { ...opts, preview: false }
+    );
+  }
+  walletBalances(input, opts) {
+    return this.get("/wallet", input, opts);
+  }
+  txStatus(input, opts) {
+    return this.get("/tx", input, opts);
+  }
+  tokenCheck(input, opts) {
+    return this.get("/token-check", input, opts);
+  }
+  fxRates(input = {}, opts) {
+    return this.get("/fx", input, opts);
+  }
+  ensLookup(input, opts) {
+    return this.get("/ens", input, opts);
+  }
+  tokenMetadata(input, opts) {
+    return this.get("/token", input, opts);
+  }
+  tokenAllowance(input, opts) {
+    return this.get("/allowance", input, opts);
+  }
+  contractInfo(input, opts) {
+    return this.get("/contract", input, opts);
+  }
+  gasFees(input = {}, opts) {
+    return this.get("/gas", input, opts);
+  }
+  blockLookup(input = {}, opts) {
+    return this.get("/block", input, opts);
+  }
+  nftLookup(input, opts) {
+    return this.get("/nft", input, opts);
+  }
+  webSearch(input, opts) {
+    return this.get("/search", input, opts);
+  }
+  ukPropertyPrices(input, opts) {
+    return this.get("/uk-property", input, opts);
+  }
+  ukAreaProfile(input, opts) {
+    return this.get("/uk-area", input, opts);
+  }
+  ukCharity(input, opts) {
+    return this.get("/uk-charity", input, opts);
+  }
+  ukCharityFull(input, opts) {
+    return this.get("/uk-charity-full", input, opts);
+  }
+};
+function createClient(opts = {}) {
+  return new AgentReaderClient(opts);
+}
+export {
+  AgentReaderClient,
+  PaymentRequiredError,
+  createClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import { wrapFetchWithPayment, x402Client } from \"@x402/fetch\";\nimport { ExactEvmScheme } from \"@x402/evm/exact/client\";\nimport { privateKeyToAccount } from \"viem/accounts\";\nimport type { Chain, ClientOptions, RequestOpts } from \"./types.js\";\n\nconst DEFAULT_ORIGIN = \"https://api.axiomworks.co.uk\";\nconst VERSION = \"1.6.0\";\n\nfunction normalizeKey(raw?: string): `0x${string}` | undefined {\n  if (!raw) return undefined;\n  const key = raw.startsWith(\"0x\") ? raw : `0x${raw}`;\n  if (!/^0x[0-9a-fA-F]{64}$/.test(key)) {\n    throw new Error(\"privateKey must be a 32-byte hex string (optional 0x prefix)\");\n  }\n  return key as `0x${string}`;\n}\n\nfunction qs(params: Record<string, unknown>): string {\n  const sp = new URLSearchParams();\n  for (const [k, v] of Object.entries(params)) {\n    if (v == null || v === \"\") continue;\n    sp.set(k, String(v));\n  }\n  return sp.toString();\n}\n\nexport class PaymentRequiredError extends Error {\n  readonly status = 402;\n  readonly paymentRequired: unknown;\n  readonly body: unknown;\n  readonly url: string;\n  constructor(url: string, paymentRequired: unknown, body: unknown) {\n    super(\"Payment required (x402). Pass privateKey to createClient or fund/retry with @x402/fetch.\");\n    this.name = \"PaymentRequiredError\";\n    this.url = url;\n    this.paymentRequired = paymentRequired;\n    this.body = body;\n  }\n}\n\nexport class AgentReaderClient {\n  readonly origin: string;\n  readonly paying: boolean;\n  private readonly fetchFn: typeof fetch;\n  private readonly defaultPreview: boolean;\n  private readonly ua: string;\n\n  constructor(opts: ClientOptions = {}) {\n    this.origin = (opts.origin || DEFAULT_ORIGIN).replace(/\\/$/, \"\");\n    const key = normalizeKey(\n      opts.privateKey ||\n        process.env.AGENTREADER_PRIVATE_KEY ||\n        process.env.EVM_PRIVATE_KEY ||\n        process.env.PRIVATE_KEY,\n    );\n    this.paying = !!key;\n    this.defaultPreview = opts.preview ?? !this.paying;\n    this.ua = opts.userAgent || `axiomworks-agentreader-sdk/${VERSION}`;\n    if (key) {\n      const account = privateKeyToAccount(key);\n      const client = new x402Client().register(\"eip155:8453\", new ExactEvmScheme(account));\n      const base = opts.fetch || globalThis.fetch.bind(globalThis);\n      this.fetchFn = wrapFetchWithPayment(base, client);\n    } else {\n      this.fetchFn = opts.fetch || globalThis.fetch.bind(globalThis);\n    }\n  }\n\n  private async request(\n    path: string,\n    init: RequestInit & { previewable?: boolean } = {},\n    opts: RequestOpts = {},\n  ): Promise<any> {\n    const url = new URL(path.startsWith(\"http\") ? path : `${this.origin}${path}`);\n    if (opts.query) {\n      for (const [k, v] of Object.entries(opts.query)) {\n        if (v == null || v === \"\") continue;\n        url.searchParams.set(k, String(v));\n      }\n    }\n    const wantPreview =\n      opts.preview === true ||\n      (opts.preview !== false && this.defaultPreview && init.method !== \"POST\" && init.previewable !== false);\n    if (wantPreview && !url.searchParams.has(\"preview\")) {\n      url.searchParams.set(\"preview\", \"1\");\n    }\n    const res = await this.fetchFn(url.toString(), {\n      ...init,\n      headers: {\n        accept: \"application/json\",\n        \"user-agent\": this.ua,\n        ...(init.headers || {}),\n      },\n    });\n    const pr = res.headers.get(\"payment-required\") || res.headers.get(\"PAYMENT-REQUIRED\");\n    const text = await res.text();\n    let body: any;\n    try {\n      body = JSON.parse(text);\n    } catch {\n      body = { raw: text.slice(0, 4000) };\n    }\n    if (res.status === 402 || pr) {\n      let payment: unknown = null;\n      if (pr) {\n        try {\n          payment = JSON.parse(Buffer.from(pr, \"base64\").toString(\"utf8\"));\n        } catch {\n          payment = { raw: pr.slice(0, 200) };\n        }\n      }\n      throw new PaymentRequiredError(url.toString(), payment ?? body, body);\n    }\n    if (!res.ok) {\n      const err: any = new Error(body?.error || `HTTP ${res.status}`);\n      err.status = res.status;\n      err.body = body;\n      throw err;\n    }\n    return body;\n  }\n\n  private get(path: string, query?: Record<string, unknown>, opts?: RequestOpts) {\n    const q = qs({ ...(query || {}), ...(opts?.query || {}) });\n    return this.request(`${path}${q ? `?${q}` : \"\"}`, { method: \"GET\" }, opts);\n  }\n\n  /** Free: x402 catalog / prices */\n  pricing(opts?: RequestOpts) {\n    return this.request(`${this.origin}/.well-known/x402`, { method: \"GET\", previewable: false }, { ...opts, preview: false });\n  }\n\n  readUrl(input: { url: string }, opts?: RequestOpts) {\n    return this.get(\"/read\", input, opts);\n  }\n  extractLinks(input: { url: string }, opts?: RequestOpts) {\n    return this.get(\"/links\", input, opts);\n  }\n  checkDomain(input: { domain: string }, opts?: RequestOpts) {\n    return this.get(\"/check\", input, opts);\n  }\n  companyResearch(input: { domain: string }, opts?: RequestOpts) {\n    return this.get(\"/company\", input, opts);\n  }\n  ukCompany(input: { number?: string; name?: string }, opts?: RequestOpts) {\n    return this.get(\"/uk-company\", input, opts);\n  }\n  ukCompanyLite(input: { number?: string; name?: string }, opts?: RequestOpts) {\n    return this.get(\"/uk-company-lite\", input, opts);\n  }\n  companyFull(input: { domain: string }, opts?: RequestOpts) {\n    return this.get(\"/company-full\", input, opts);\n  }\n  convertDocument(input: { url: string; format?: \"markdown\" | \"text\" }, opts?: RequestOpts) {\n    return this.get(\"/convert\", { format: \"markdown\", ...input }, opts);\n  }\n  createMonitor(\n    input: { url: string; webhook: string; selector?: string; keyword?: string },\n    opts?: RequestOpts,\n  ) {\n    return this.request(\n      `${this.origin}/monitor`,\n      {\n        method: \"POST\",\n        headers: { \"content-type\": \"application/json\" },\n        body: JSON.stringify(input),\n        previewable: false,\n      },\n      { ...opts, preview: false },\n    );\n  }\n  walletBalances(input: { address: string; chain?: Chain; tokens?: string }, opts?: RequestOpts) {\n    return this.get(\"/wallet\", input, opts);\n  }\n  txStatus(input: { hash: string; chain?: Chain }, opts?: RequestOpts) {\n    return this.get(\"/tx\", input, opts);\n  }\n  tokenCheck(input: { address: string; chain?: Chain }, opts?: RequestOpts) {\n    return this.get(\"/token-check\", input, opts);\n  }\n  fxRates(\n    input: { base?: string; symbols?: string; date?: string; amount?: string } = {},\n    opts?: RequestOpts,\n  ) {\n    return this.get(\"/fx\", input, opts);\n  }\n  ensLookup(input: { name?: string; address?: string }, opts?: RequestOpts) {\n    return this.get(\"/ens\", input, opts);\n  }\n  tokenMetadata(input: { address: string; chain?: Chain }, opts?: RequestOpts) {\n    return this.get(\"/token\", input, opts);\n  }\n  tokenAllowance(\n    input: { token: string; owner: string; spender: string; chain?: Chain },\n    opts?: RequestOpts,\n  ) {\n    return this.get(\"/allowance\", input, opts);\n  }\n  contractInfo(input: { address: string; chain?: Chain }, opts?: RequestOpts) {\n    return this.get(\"/contract\", input, opts);\n  }\n  gasFees(input: { chain?: Chain } = {}, opts?: RequestOpts) {\n    return this.get(\"/gas\", input, opts);\n  }\n  blockLookup(input: { number?: string; timestamp?: string; chain?: Chain } = {}, opts?: RequestOpts) {\n    return this.get(\"/block\", input, opts);\n  }\n  nftLookup(input: { contract: string; token_id: string; chain?: Chain }, opts?: RequestOpts) {\n    return this.get(\"/nft\", input, opts);\n  }\n  webSearch(input: { q: string; sources?: string; limit?: string | number }, opts?: RequestOpts) {\n    return this.get(\"/search\", input, opts);\n  }\n  ukPropertyPrices(input: { postcode: string; radius?: string }, opts?: RequestOpts) {\n    return this.get(\"/uk-property\", input, opts);\n  }\n  ukAreaProfile(input: { postcode: string }, opts?: RequestOpts) {\n    return this.get(\"/uk-area\", input, opts);\n  }\n  ukCharity(input: { number?: string; name?: string; suffix?: string }, opts?: RequestOpts) {\n    return this.get(\"/uk-charity\", input, opts);\n  }\n  ukCharityFull(input: { number?: string; name?: string; suffix?: string }, opts?: RequestOpts) {\n    return this.get(\"/uk-charity-full\", input, opts);\n  }\n}\n\n/** Create a typed AgentReader client. Pass privateKey (or set AGENTREADER_PRIVATE_KEY) to auto-pay. */\nexport function createClient(opts: ClientOptions = {}): AgentReaderClient {\n  return new AgentReaderClient(opts);\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,80 @@
 {
   "name": "@axiomworks/agentreader",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.6.0",
+  "description": "Axiom Works AgentReader typed JS/TS SDK — createClient({ privateKey }) with one method per tool, auto x402 USDC payment on Base, free preview mode. Web read, UK company/charity/property, EVM, FX, search.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "agentreader",
+    "axiomworks",
+    "axiom-works",
+    "x402",
+    "ai-agent",
+    "agents",
+    "sdk",
+    "typescript",
+    "mcp",
+    "model-context-protocol",
+    "web-scraping",
+    "markdown",
+    "companies-house",
+    "uk-company",
+    "uk-charity",
+    "charity-commission",
+    "due-diligence",
+    "blockchain",
+    "base",
+    "usdc",
+    "crypto",
+    "evm",
+    "ens",
+    "nft",
+    "fx",
+    "langchain",
+    "pay-per-call",
+    "fetch"
+  ],
+  "author": "Axiom Works <info@axiomworks.co.uk>",
+  "license": "MIT",
+  "homepage": "https://grokbot1233.github.io/agentreader/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/grokbot1233/agentreader.git",
+    "directory": "packages/agentreader"
+  },
+  "bugs": {
+    "url": "https://github.com/grokbot1233/agentreader/issues"
+  },
+  "dependencies": {
+    "@x402/evm": "^2.30.0",
+    "@x402/fetch": "^2.30.0",
+    "viem": "^2.57.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.4",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.3"
+  },
+  "allowScripts": {
+    "esbuild@0.27.7": true
+  }
+}