agentsvc 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agentsvc.io
+
+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,49 @@
-# Temporary Holding Version
+# agentsvc (JavaScript)
 
-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.
+Pay-per-call tools for AI agents from [agentsvc.io](https://agentsvc.io): 120+ web, data and crypto APIs (web scraping to Markdown, token safety checks, smart-money tracking, agent memory and inbox, PDF and OCR, company data, and more), paid per call in USDC via [x402](https://x402.org). No account, no subscription. Ready-made tools for the **Vercel AI SDK** and **LangChain.js**.
+
+```bash
+npm i agentsvc
+npm i @x402/fetch @x402/evm viem   # only if your agent pays from its own wallet
+```
+
+## Pay
+
+- **Credit token:** buy one at https://agentsvc.io/credits (from $0.10, +10% bonus), then `createAgentsvc({ creditToken: 'asvc_cr_...' })` or set `AGENTSVC_CREDIT_TOKEN`.
+- **Wallet:** `createAgentsvc({ privateKey: '0x...', network: 'eip155:8453' })` with a few dollars of USDC on Base, Polygon (`eip155:137`) or Arbitrum (`eip155:42161`). Use a separate low-balance wallet.
+- **Your own x402 fetch:** `createAgentsvc({ payFetch })`.
+- Neither: `client.sample('web-scrape')` runs the free example of any service.
+
+```js
+import { createAgentsvc } from 'agentsvc';
+
+const svc = createAgentsvc({ creditToken: process.env.AGENTSVC_CREDIT_TOKEN });
+const page = await svc.call('web-scrape', { url: 'https://example.com' });
+const check = await svc.call('token-precheck', { tokens: ['0x4ed4E862860beD51a9570b96d89aF5E1B0Efefed'], chain: 'base' });
+```
+
+## Vercel AI SDK
+
+```js
+import { generateText, isStepCount } from 'ai';
+import { createAgentsvc } from 'agentsvc';
+import { agentsvcTools } from 'agentsvc/ai-sdk';
+
+const tools = await agentsvcTools(createAgentsvc({ creditToken: process.env.AGENTSVC_CREDIT_TOKEN }), ['web-scrape', 'news-search', 'token-smart-money']);
+// Full guide: https://agentsvc.io/docs/ai-sdk
+const { text } = await generateText({ model: 'anthropic/claude-haiku-5.5', tools, stopWhen: isStepCount(5), prompt: 'Who is buying BRETT on Base right now?' });
+```
+
+## LangChain.js
+
+```js
+import { createAgentsvc } from 'agentsvc';
+import { agentsvcLangChainTools } from 'agentsvc/langchain';
+
+const tools = await agentsvcLangChainTools(createAgentsvc({ creditToken: process.env.AGENTSVC_CREDIT_TOKEN }), { category: 'web' });
+// createReactAgent({ llm, tools }) or llm.bindTools(tools)
+```
+
+Pick services by slug list, `{ category: 'finance' }` or a filter function. The full list with prices: https://agentsvc.io/api/v1/services. Failed calls are never charged; errors throw `AgentsvcError` with `status` and `body`.
+
+MIT licensed. The service itself runs at agentsvc.io and is not open source.

package/ai-sdk.mjs

@@ -0,0 +1,16 @@
+// Vercel AI SDK tools: const tools = await agentsvcTools(client, ['web-scrape', 'token-precheck'])
+// then generateText({ model, tools, prompt, stopWhen: stepCountIs(5) }).
+import { tool, jsonSchema } from 'ai';
+import { selectServices, toolName, toolDescription, toolSchema } from './index.mjs';
+
+export async function agentsvcTools(client, pick) {
+  const out = {};
+  for (const s of await selectServices(client, pick)) {
+    const def = { description: toolDescription(s), execute: input => client.call(s.slug, input) };
+    // AI SDK 5 heisst das Feld inputSchema, AI SDK 4 parameters
+    def.inputSchema = jsonSchema(toolSchema(s));
+    def.parameters = def.inputSchema;
+    out[toolName(s.slug)] = tool(def);
+  }
+  return out;
+}

package/index.d.ts

@@ -0,0 +1,15 @@
+export interface AgentsvcOptions { privateKey?: string; network?: string; payFetch?: typeof fetch; creditToken?: string; baseUrl?: string }
+export interface Service { slug: string; name: string; description: string; category: string; price_usdc: number; input_schema: Record<string, unknown>; output_schema?: Record<string, unknown>; example_input?: Record<string, unknown>; is_active?: boolean; tags: string[] }
+export interface AgentsvcClient {
+  call<T = unknown>(slug: string, input?: Record<string, unknown>): Promise<T>;
+  sample<T = unknown>(slug: string): Promise<T>;
+  services(): Promise<Service[]>;
+  baseUrl: string;
+}
+export class AgentsvcError extends Error { status?: number; body?: unknown }
+export function createAgentsvc(opts?: AgentsvcOptions): AgentsvcClient;
+export type ServicePick = string[] | { category: string } | ((s: Service) => boolean);
+export function selectServices(client: AgentsvcClient, pick?: ServicePick): Promise<Service[]>;
+export function toolName(slug: string): string;
+export function toolDescription(s: Service): string;
+export function toolSchema(s: Service): Record<string, unknown>;

package/index.mjs

@@ -0,0 +1,102 @@
+// agentsvc: client for https://agentsvc.io. Every service is one HTTP endpoint, paid per call:
+//  - with x402 from a wallet (pass privateKey, or your own x402-enabled fetch as payFetch), or
+//  - with a prepaid credit token from https://agentsvc.io/credits (pass creditToken).
+// Without either, only the free samples work (each service's example input).
+
+const DEFAULT_BASE = 'https://agentsvc.io';
+
+export class AgentsvcError extends Error {
+  constructor(message, { status, body } = {}) { super(message); this.name = 'AgentsvcError'; this.status = status; this.body = body; }
+}
+
+async function walletFetch(privateKey, network) {
+  let mods;
+  try {
+    mods = await Promise.all([import('@x402/fetch'), import('@x402/evm/exact/client'), import('viem/accounts')]);
+  } catch {
+    throw new AgentsvcError('Paying from a wallet needs the x402 packages: npm i @x402/fetch @x402/evm viem');
+  }
+  const [{ wrapFetchWithPayment, x402Client }, { registerExactEvmScheme }, { privateKeyToAccount }] = mods;
+  const pick = network ? (_v, accepts) => accepts.find(a => a.network === network) || accepts[0] : undefined;
+  const client = new x402Client(pick);
+  registerExactEvmScheme(client, { signer: privateKeyToAccount(privateKey) });
+  return wrapFetchWithPayment(fetch, client);
+}
+
+/**
+ * @param {object} [opts]
+ * @param {string} [opts.privateKey]   EVM key of a wallet with a few dollars of USDC (Base, Polygon or Arbitrum). Use a separate low-balance wallet.
+ * @param {string} [opts.network]      Preferred payment network, e.g. "eip155:8453" (Base, default), "eip155:137" (Polygon)
+ * @param {Function} [opts.payFetch]   Your own fetch that handles x402 (instead of privateKey)
+ * @param {string} [opts.creditToken]  Prepaid credit token (asvc_cr_...) from https://agentsvc.io/credits
+ * @param {string} [opts.baseUrl]
+ */
+export function createAgentsvc(opts = {}) {
+  const base = (opts.baseUrl || DEFAULT_BASE).replace(/\/$/, '');
+  const credit = opts.creditToken || (typeof process !== 'undefined' ? process.env.AGENTSVC_CREDIT_TOKEN : undefined);
+  let fetcher = opts.payFetch || null;
+  let catalog = null;
+
+  async function getFetch() {
+    if (fetcher) return fetcher;
+    if (credit) return (fetcher = fetch);
+    if (opts.privateKey) return (fetcher = await walletFetch(opts.privateKey, opts.network));
+    return fetch;
+  }
+
+  async function services() {
+    if (!catalog) {
+      const r = await fetch(`${base}/api/v1/services`);
+      if (!r.ok) throw new AgentsvcError(`catalog HTTP ${r.status}`, { status: r.status });
+      const j = await r.json();
+      catalog = j.data || j.services || j;
+    }
+    return catalog;
+  }
+
+  /** Call one service. Returns its data; throws AgentsvcError on 402 (no payment), input errors and service errors (none of them are charged). */
+  async function call(slug, input = {}) {
+    const f = await getFetch();
+    const headers = { 'Content-Type': 'application/json', 'User-Agent': 'agentsvc-js/0.1.1' };
+    if (credit) headers.Authorization = `Bearer ${credit}`;
+    const paid = credit || opts.privateKey || opts.payFetch;
+    const url = paid ? `${base}/api/v1/proxy/${slug}` : `${base}/api/v1/try/${slug}`;
+    const r = await f(url, { method: 'POST', headers, body: JSON.stringify(input) });
+    const j = await r.json().catch(() => ({}));
+    if (r.status === 402) throw new AgentsvcError(j.hint || `Payment required for ${slug}: pass privateKey, payFetch or creditToken`, { status: 402, body: j });
+    if (!r.ok || j.success === false) throw new AgentsvcError(j.message || j.error || `HTTP ${r.status}`, { status: r.status, body: j });
+    return j.data ?? j;
+  }
+
+  /** Free sample of a service with its example input (no payment). */
+  async function sample(slug) {
+    const r = await fetch(`${base}/api/v1/try/${slug}`);
+    const j = await r.json().catch(() => ({}));
+    if (!r.ok) throw new AgentsvcError(j.message || `HTTP ${r.status}`, { status: r.status, body: j });
+    return j.data ?? j;
+  }
+
+  return { call, sample, services, baseUrl: base };
+}
+
+/** Pick catalog entries by slug list, category or a filter function. */
+export async function selectServices(client, pick) {
+  const all = (await client.services()).filter(s => s.is_active !== false);
+  if (!pick) return all;
+  if (Array.isArray(pick)) {
+    const set = new Set(pick);
+    const found = all.filter(s => set.has(s.slug));
+    const missing = pick.filter(p => !found.some(s => s.slug === p));
+    if (missing.length) throw new AgentsvcError(`unknown services: ${missing.join(', ')}`);
+    return found;
+  }
+  if (typeof pick === 'function') return all.filter(pick);
+  if (pick.category) return all.filter(s => s.category === pick.category);
+  return all;
+}
+
+export const toolName = slug => slug.replace(/-/g, '_');
+export const toolDescription = s => `${s.description} Costs $${s.price_usdc} per call.`;
+export function toolSchema(s) {
+  return { ...(s.input_schema || {}), type: 'object' };
+}

package/langchain.mjs

@@ -0,0 +1,13 @@
+// LangChain.js tools: const tools = await agentsvcLangChainTools(client, ['web-scrape', 'news-search'])
+// then createReactAgent({ llm, tools }) or llm.bindTools(tools).
+import { DynamicStructuredTool } from '@langchain/core/tools';
+import { selectServices, toolName, toolDescription, toolSchema } from './index.mjs';
+
+export async function agentsvcLangChainTools(client, pick) {
+  return (await selectServices(client, pick)).map(s => new DynamicStructuredTool({
+    name: toolName(s.slug),
+    description: toolDescription(s),
+    schema: toolSchema(s),
+    func: async input => JSON.stringify(await client.call(s.slug, input)),
+  }));
+}

package/package.json

@@ -1,6 +1,34 @@
 {
   "name": "agentsvc",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.1",
+  "description": "Pay-per-call tools for AI agents: 120+ web, data and crypto APIs paid in USDC via x402, with ready-made tools for the Vercel AI SDK and LangChain.js",
+  "type": "module",
+  "main": "./index.mjs",
+  "exports": {
+    ".": "./index.mjs",
+    "./ai-sdk": "./ai-sdk.mjs",
+    "./langchain": "./langchain.mjs"
+  },
+  "files": ["index.mjs", "ai-sdk.mjs", "langchain.mjs", "index.d.ts", "README.md"],
+  "types": "./index.d.ts",
+  "keywords": ["x402", "ai-agents", "mcp", "vercel-ai-sdk", "langchain", "tools", "web-scraping", "crypto", "usdc", "pay-per-call"],
+  "homepage": "https://agentsvc.io",
+  "repository": { "type": "git", "url": "git+https://github.com/agentsvc/agentsvc.git", "directory": "packages/js" },
+  "bugs": "https://github.com/agentsvc/agentsvc/issues",
+  "license": "MIT",
+  "engines": { "node": ">=18" },
+  "peerDependencies": {
+    "@x402/fetch": ">=2.0.0",
+    "@x402/evm": ">=2.0.0",
+    "viem": ">=2.0.0",
+    "ai": ">=4.0.0",
+    "@langchain/core": ">=0.3.0"
+  },
+  "peerDependenciesMeta": {
+    "@x402/fetch": { "optional": true },
+    "@x402/evm": { "optional": true },
+    "viem": { "optional": true },
+    "ai": { "optional": true },
+    "@langchain/core": { "optional": true }
+  }
+}