{"_id":"@402mdvaleo/agent","name":"@402mdvaleo/agent","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@402mdvaleo/agent","version":"0.1.0","description":"Make AI agents 402.md-aware. Discover pricing manifests and pay automatically.","main":"dist/index.js","module":"dist/index.mjs","types":"dist/index.d.ts","scripts":{"build":"tsup src/index.ts --format cjs,esm --dts","test":"vitest run","test:watch":"vitest"},"keywords":["402md","x402","ai-agents","payments","micropayments","USDC"],"license":"MIT","dependencies":{"gray-matter":"^4.0.3","zod":"^3.22.0"},"devDependencies":{"tsup":"^8.0.0","vitest":"^2.1.0","typescript":"^5.7.0"},"peerDependencies":{"viem":">=2.0.0"},"peerDependenciesMeta":{"viem":{"optional":true}},"_id":"@402mdvaleo/agent@0.1.0","_nodeVersion":"25.6.1","_npmVersion":"11.9.0","dist":{"integrity":"sha512-i90dDdyoPOk3PCm5XBEPNdbbxZyBWSNTsUdcrVuHrFpHUGHf0xfrXF9Kto/388iHUHvhAOMPwfxSNn2vuWbhtA==","shasum":"f2a19c9ed740dba29c5ffdd235cb3e9cf3d5d5d3","tarball":"https://registry.npmjs.org/@402mdvaleo/agent/-/agent-0.1.0.tgz","fileCount":6,"unpackedSize":29848,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQD9PeRwg5NXRnVliZrYE0H3KnqDUZEvjILukC7/DNzgSgIhALY2zbiNMWg59PIPxOFIG97aMKZyhyWFhg8Bh+qbkOxN"}]},"_npmUser":{"name":"v402valeo","email":"valeobank@gmail.com"},"directories":{},"maintainers":[{"name":"v402valeo","email":"valeobank@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/agent_0.1.0_1772996204190_0.5463599585680314"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-08T18:56:44.067Z","0.1.0":"2026-03-08T18:56:44.327Z","modified":"2026-03-08T18:56:44.618Z"},"maintainers":[{"name":"v402valeo","email":"valeobank@gmail.com"}],"description":"Make AI agents 402.md-aware. Discover pricing manifests and pay automatically.","keywords":["402md","x402","ai-agents","payments","micropayments","USDC"],"license":"MIT","readme":"# @402mdvaleo/agent\n\nMake AI agents 402.md-aware. Discover pricing manifests and pay for content automatically.\n\n## Install\n\n```bash\nnpm install @402mdvaleo/agent\n```\n\n## Quick Start\n\n```typescript\nimport { check402 } from \"@402mdvaleo/agent\";\n\n// Check if a site has pricing\nconst manifest = await check402(\"example.com\");\n\nif (manifest) {\n  console.log(`${manifest.domain} charges for ${manifest.endpoints.length} endpoints`);\n  console.log(`Cheapest: ${manifest.endpoints[0].price}`);\n  console.log(`Network: ${manifest.network}`);\n  console.log(`Facilitator: ${manifest.facilitator}`);\n}\n```\n\n## Auto-Paying Fetch\n\n```typescript\nimport { createPaidFetcher } from \"@402mdvaleo/agent\";\nimport { createWalletClient, http } from \"viem\";\nimport { privateKeyToAccount } from \"viem/accounts\";\nimport { base } from \"viem/chains\";\n\nconst wallet = createWalletClient({\n  account: privateKeyToAccount(\"0x...\" as `0x${string}`),\n  chain: base,\n  transport: http(),\n});\n\nconst paidFetch = createPaidFetcher({\n  wallet,\n  maxPriceMicros: 50_000, // Max $0.05 per request\n  onPaymentMade: (endpoint, url) => {\n    console.log(`Paid ${endpoint.price} for ${url}`);\n  },\n});\n\n// Works like normal fetch — but pays when needed\nconst response = await paidFetch(\"https://example.com/api/data\");\nconst data = await response.json();\n```\n\n## Check a Specific URL\n\n```typescript\nimport { checkUrl } from \"@402mdvaleo/agent\";\n\nconst match = await checkUrl(\"https://example.com/api/data\");\n\nif (match) {\n  console.log(`This URL costs ${match.endpoint.price}`);\n  console.log(`Proxy: ${match.proxyUrl}`);\n}\n```\n\n## Configuration\n\n```typescript\nconst manifest = await check402(\"example.com\", {\n  timeout: 3000,\n  checkDirect: true,\n  checkRegistry: true,\n  useCache: true,\n  registryUrl: \"https://402md.valeoprotocol.io\",\n});\n```\n\n## How It Works\n\n1. **Discovery**: `check402()` fetches `https://domain.com/402.md` (self-hosted) and falls back to `https://402md.valeoprotocol.io/m/domain.com/raw` (registry).\n\n2. **Parsing**: The YAML frontmatter is parsed to extract endpoints, pricing, wallet address, network, and facilitator.\n\n3. **Matching**: `checkUrl()` matches a specific URL path against the manifest's endpoint patterns (exact, `*`, and `**` globs).\n\n4. **Payment**: `createPaidFetcher()` wraps `fetch()` to detect 402 responses and pay via the 402md proxy or x402 with a configured wallet.\n\n## What is 402.md?\n\n402.md is an open standard for machine-readable pricing manifests. Websites place a `402.md` file at their root to tell AI agents what their content costs.\n\nLearn more: https://402md.valeoprotocol.io\n","readmeFilename":"README.md","_rev":"1-dee3359cb3d6acf4942831be9b934033"}