IDagntn@agntn/*

One interface. Every provider.

Every library takes one domain and puts one TypeScript interface in front of all the providers in it. You get it as a library, a CLI, an AI SDK tool, an MCP server and Pi and OMP extensions. Change the provider string, the rest of your code stays.

Libraries: 22; in 5 domains
On npm: 14; 10 with a docs site
Providers: 135+; named in the catalogue

Browse the libraries agntn on GitHub

Install$ pnpm add @agntn/web

ID@agntn/web01 / 14Web · docs

Library / Web

@agntn/web

Web search, reverse image search and page reading over Brave, Exa, Tavily, Firecrawl, Jina, SearXNG and six more.

Providers

Brave
Exa
Tavily
Firecrawl
Jina
SearXNG
Mojeek
SerpAPI
SerpBase
TinyFish
Context
OpenAI Codex

Status: docs
Providers: 12
Repository: public
Docs: web.agntn.dev

surfaces 6 / 6

Same calls, every library

Pick the domain, pick the provider by name, call the method. Web search, package registries, git forges, block explorers, the call site looks the same. This file walks through the 14 published libraries, one real export each.

create('name') resolves a registered class. Adapters register themselves, nothing to extend by hand
Every answer is the shared type. Provider quirks stay in the adapter and never leak out
Typed errors: RateLimitError with retryAfter, NotFoundError, HTTPError with the key already redacted

Read How a library is built

Fileagent.ts@agntn/web

Call

1import { create } from "@agntn/web";23const provider = await create("brave");4const answer = await provider.search("typescript 7 native", { maxResults: 5 });56// [{ url, title, snippet }], the same shape from every engine

1import { createArchive } from "@agntn/archives";23const provider = createArchive("wayback");4const answer = await provider.snapshots("nuxt.com", { limit: 10 });56// { success: true, pages: [{ url, timestamp, snapshot }] }

1import { fetchPackageFromPURL } from "@agntn/registries";23const answer = await fetchPackageFromPURL("pkg:npm/lodash");45// { name, version, license, repository }

1import { createProvider } from "@agntn/forges";23const provider = await createProvider("github");4const answer = await provider.pullRequests.list("agntn", "web");56// { items: [{ number, title, state }], hasNextPage }

1import { blockchains } from "@agntn/keys";23const provider = await blockchains.bitcoin()();4const answer = await provider.generateWallet();56// { address, keyPublic, keyPrivate } as a Wallet

1import { detectHarness } from "@agntn/harnesses";23const answer = await detectHarness(process.cwd());45// Harness | null, with binary, config and session paths

1import { create } from "@agntn/explorers";23const provider = await create("etherscan");4const answer = await provider.getBalance("0xd8dA…6045");56// { address, chain, balance, fetchedAt }

1import { identify } from "@agntn/chains";23const answer = await identify("0xd8dA…6045");45// { matches: [Ethereum, Base, …], unchecked: [] }

1import { create } from "@agntn/ciphers";23const provider = create("vigenere");4const answer = await provider.decode("LXFOPVEFRNHR", { key: "LEMON" });56// { text: "ATTACKATDAWN", cipher: "vigenere" }

1import { get } from "@agntn/puzzles";23const answer = await get("b1000/71");45// Puzzle | undefined, with address(), keyRange() and balance()

1import { create } from "@agntn/browsers";23const provider = await create("steel");4const answer = await provider.scrape("https://nuxt.com");56// { url, title, markdown, text, statusCode }

1import { create } from "@agntn/urls";23const provider = await create("wayback");4const answer = await provider.discover("nuxt.com", { limit: 50 });56// [{ url, source, input, ext }], deduplicated and in scope

1import { create } from "@agntn/lyrics";23const provider = create("lrclib");4const answer = await provider.lyrics({ artist: "Radiohead", track: "Nude" });56// { provider, artist, track, plain, synced }

1import oxlint from "@agntn/ox/oxlint";23export default { ...oxlint, ignorePatterns: ["dist"] };45// the shared rules, options and all, plus one repo-local setting

Installpnpm add @agntn/web

Docsweb.agntn.dev

Write once, run from any host

A human types the command in a shell. An agent calls the same executor through MCP, the Vercel AI SDK, Pi or OMP. Same answer, same provider diagnostics, so what the model reads is what you'd have read yourself.

CLI, MCP server and the Pi and OMP extensions share one set of tool executors
AI SDK tools come from the /ai subpath with Zod schemas, the host abort signal passed straight through
Nothing bundled twice. The extension sources ship inside the npm package

Read Library, CLI, AI SDK, MCP, Pi, OMP

Listsurfacesone set of executors

Library: ESM, strict TypeScript, typed errors.
CLI: Same calls from a shell, --json for scripts.
AI SDK: Vercel AI SDK tools from the /ai subpath.
MCP: One server over stdio for every host.
Pi: Extension shipped inside the package.
OMP: Same executors, OMP packaging.

5 domains, 22 libraries

Published ones link to their page here, with the docs site or the npm package from there. The rest are still in private repos and sit here so you know what's coming.

List@agntn/*22 libraries · 14 on npm

Web

Code

Chains

Agents

harnesses
sessions
memory
wiki

Data

ciphers
storages
maps
lyrics
books

Boring on purpose

Every repo starts from the same template and keeps the same scripts, so jumping from one library to the next costs nothing. All of it is before 1.0, pin exact versions.

Node.js 22 or 24 and up per package, ESM only, strict TypeScript
obuild, vitest, oxlint and oxfmt through the shared @agntn/ox policy
Releases from GitHub Actions with npm trusted publishing, no tokens lying around

Read Stack and conventions

Listscriptsevery repo

# same scripts in every @agntn packagepnpm build       # obuild, ESM, .d.mtspnpm test        # vitestpnpm lint        # oxlint + oxfmt via @agntn/oxpnpm typecheck   # tsc, TypeScript 7pnpm release     # changelogen, OIDC publish

Startpnpm add @agntn/webNode.js 22 or 24, per package

Pick a domain, add one package

One install gives you the library, plus the CLI and the MCP server where the package ships them. Name a provider, ask it something, read the same shape whoever answered.

PinEverything is before 1.0, so pin exact versions.
KeysEach provider reads its key from its own env var unless you hand one to create().
SwapChange the string in create() and the rest of the file stays.

Browse the libraries About agntn

First call

$ pnpm add @agntn/webimport { create } from "@agntn/web";const brave = await create("brave");const results = await brave.search("typescript 7 native");// [{ url, title, snippet }], the same shape from every engine