{"_id":"@bradyprotocol/discovery-sdk","_rev":"7-1d11afce675c4a6689f86e0846dded24","name":"@bradyprotocol/discovery-sdk","dist-tags":{"latest":"0.2.5"},"versions":{"0.2.1":{"name":"@bradyprotocol/discovery-sdk","version":"0.2.1","keywords":["dweb","discovery","agent","sdk","web3","decentralized"],"license":"MIT","_id":"@bradyprotocol/discovery-sdk@0.2.1","maintainers":[{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"}],"homepage":"https://bradyprotocol.xyz","bugs":{"url":"https://github.com/SerDaboz/onchainsearch/issues"},"dist":{"shasum":"60a72dd9e188e02694f7f40c36e598eb965ae115","tarball":"https://registry.npmjs.org/@bradyprotocol/discovery-sdk/-/discovery-sdk-0.2.1.tgz","fileCount":19,"integrity":"sha512-Rfi1ihQQ+up6740whHFDpVS70+cScdBO7k5iOai88sDa9YvO/Io/D8Rgqapakhlk4poujXoE854t9WNxOuttCA==","signatures":[{"sig":"MEQCIFpX/e5OdWvkaAvrahRSAs4e363v3e6OAsh8ok2SobwQAiAJLe1/WIxTyIL+xrhEhK/K11h9tNVSRAk+idk030ZPwA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":110395},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"2af18287692083573f65bcc15703c537020f094e","scripts":{"lint":"eslint src/","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:watch":"vitest","format:check":"prettier --check \"src/**/*.ts\"","prepublishOnly":"bun run build"},"_npmUser":{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"},"repository":{"url":"git+https://github.com/SerDaboz/onchainsearch.git","type":"git","directory":"packages/sdk-agent"},"_npmVersion":"11.9.0","description":"First-party TypeScript SDK for the Dweb Discovery Protocol","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","prettier":"^3.8.0","typescript":"^5.6.0"},"_npmOperationalInternal":{"tmp":"tmp/discovery-sdk_0.2.1_1776098014977_0.6512813280332193","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@bradyprotocol/discovery-sdk","version":"0.2.2","keywords":["dweb","discovery","agent","sdk","web3","decentralized"],"license":"MIT","_id":"@bradyprotocol/discovery-sdk@0.2.2","maintainers":[{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"}],"homepage":"https://bradyprotocol.xyz","bugs":{"url":"https://github.com/SerDaboz/BRADY/issues"},"dist":{"shasum":"2fe3dd7f3934279e500ae13c6def5dd06fb3f949","tarball":"https://registry.npmjs.org/@bradyprotocol/discovery-sdk/-/discovery-sdk-0.2.2.tgz","fileCount":19,"integrity":"sha512-HHHWx0ihXAgpxKETXcnLkGbn3NutQGpxgTuBh+M2waQ5FlZpzHEwhMubLLJ1LIPgeAuhr25XgDBEF5Glv4hEFQ==","signatures":[{"sig":"MEUCIGgd/bBpLMfO8KyG2xtmj6xjfBCG1wsCxaXX/8uQTDkpAiEAsBERuw7l70iRg5V/4SA/+Two++JbIjsZIsxW9Q50s2E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":110383},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"755879081d15a74a639191a7aad7c0978e8a1e9a","scripts":{"lint":"eslint src/","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:watch":"vitest","format:check":"prettier --check \"src/**/*.ts\"","prepublishOnly":"bun run build"},"_npmUser":{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"},"repository":{"url":"git+https://github.com/SerDaboz/BRADY.git","type":"git","directory":"packages/sdk-agent"},"_npmVersion":"11.9.0","description":"First-party TypeScript SDK for the Dweb Discovery Protocol","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","prettier":"^3.8.0","typescript":"^5.6.0"},"_npmOperationalInternal":{"tmp":"tmp/discovery-sdk_0.2.2_1776098672287_0.44516382235821217","host":"s3://npm-registry-packages-npm-production"}},"0.2.3":{"name":"@bradyprotocol/discovery-sdk","version":"0.2.3","keywords":["dweb","discovery","agent","sdk","web3","decentralized"],"license":"MIT","_id":"@bradyprotocol/discovery-sdk@0.2.3","maintainers":[{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"}],"homepage":"https://bradyprotocol.xyz","bugs":{"url":"https://github.com/SerDaboz/BRADY/issues"},"dist":{"shasum":"d30bcbf95a5810cfdedb743dfb6a92e2c107cfa8","tarball":"https://registry.npmjs.org/@bradyprotocol/discovery-sdk/-/discovery-sdk-0.2.3.tgz","fileCount":19,"integrity":"sha512-w+tNSc3PgRRIpYl5BrmxjV6/ovbGDz0MTtIvn0rruvKUZLuCxTYYAdzlX6B/5awuvbYxIAECwv6Jngm1uMw5zw==","signatures":[{"sig":"MEUCIGCmxmyN/9FiqsKexy4SZT3XErkcGP9Qm7owB38t12NlAiEAtHRrcnVv/V3naMSdrVa2L0eKOoigl2BX0mmRV3a1VVA=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":107943},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"25e5eaad055b40925a860e052c3b1ac8f7cef4a5","scripts":{"lint":"eslint src/","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:watch":"vitest","format:check":"prettier --check \"src/**/*.ts\"","prepublishOnly":"bun run build"},"_npmUser":{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"},"repository":{"url":"git+https://github.com/SerDaboz/BRADY.git","type":"git","directory":"packages/sdk-agent"},"_npmVersion":"11.9.0","description":"First-party TypeScript SDK for the Dweb Discovery Protocol","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","prettier":"^3.8.0","typescript":"^5.6.0"},"_npmOperationalInternal":{"tmp":"tmp/discovery-sdk_0.2.3_1776207370923_0.12734198124498453","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"@bradyprotocol/discovery-sdk","version":"0.2.4","keywords":["dweb","discovery","agent","sdk","web3","decentralized"],"license":"MIT","_id":"@bradyprotocol/discovery-sdk@0.2.4","maintainers":[{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"}],"homepage":"https://bradyprotocol.xyz","bugs":{"url":"https://github.com/SerDaboz/BRADY/issues"},"dist":{"shasum":"67b9d1fa751ec1f835435d13600397b5e67b5e86","tarball":"https://registry.npmjs.org/@bradyprotocol/discovery-sdk/-/discovery-sdk-0.2.4.tgz","fileCount":19,"integrity":"sha512-tHrLqEuSJsTCJUeo3zuEqQKoqALoHQ2K/lQX9QiXjX7VMoV1l/xNG99gejJJ6+CpdB2J0ZI5OkXnNGKHtaE/lw==","signatures":[{"sig":"MEUCIBwuwdDoroCYK0ny7lrqJHGIy0ZHuBCPfivEPqvmALefAiEA1BoExJ8TWOQ68OtKIbQN7iFbzvnu7B9FKU/cZSjzMXM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":107943},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"9d7be3d1dd717fe0075459ec961e1be9af796664","scripts":{"lint":"eslint src/","test":"vitest run","build":"tsc","format":"prettier --write \"src/**/*.ts\"","test:watch":"vitest","format:check":"prettier --check \"src/**/*.ts\"","prepublishOnly":"bun run build"},"_npmUser":{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"},"repository":{"url":"git+https://github.com/SerDaboz/BRADY.git","type":"git","directory":"packages/sdk-agent"},"_npmVersion":"11.9.0","description":"First-party TypeScript SDK for the Dweb Discovery Protocol","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"vitest":"^4.0.0","prettier":"^3.8.0","typescript":"^5.6.0"},"_npmOperationalInternal":{"tmp":"tmp/discovery-sdk_0.2.4_1776207860961_0.7993613585348047","host":"s3://npm-registry-packages-npm-production"}},"0.2.5":{"name":"@bradyprotocol/discovery-sdk","version":"0.2.5","description":"Read-only TypeScript SDK for BRADY Discovery — public opportunities, protocol activity, and advisory routing signals","type":"module","license":"MIT","homepage":"https://bradyprotocol.xyz/docs/brady","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc","prepublishOnly":"bun run build","test":"vitest run","test:watch":"vitest","lint":"eslint src/","format":"prettier --write \"src/**/*.ts\"","format:check":"prettier --check \"src/**/*.ts\""},"devDependencies":{"typescript":"^5.6.0","vitest":"^4.0.0","prettier":"^3.8.0"},"keywords":["brady","discovery","agent","sdk","web3","decentralized"],"publishConfig":{"access":"public"},"sideEffects":false,"engines":{"node":">=18"},"gitHead":"728f102e3a75346e2a0523faaff81a4366e8482e","_id":"@bradyprotocol/discovery-sdk@0.2.5","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-5elNmCeupugaPicKH3AeXvYZEwgAEFHGkSSY3sx/XQhdkllhT0u2h3FpYVUlqi3bhLE6/zMI5HtrkslviDFEQA==","shasum":"c1a359664e232705517f5342415653b0533e6fcd","tarball":"https://registry.npmjs.org/@bradyprotocol/discovery-sdk/-/discovery-sdk-0.2.5.tgz","fileCount":19,"unpackedSize":101321,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDuBAwLH0W8v5yBjs1ODZl1D6E0Me8Fh7Yb+m2+Iy41wAIgdnA4kQriPGrkrWo2SQEFYB/SFfjSxQiSEeIUwSmD7Gk="}]},"_npmUser":{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"},"directories":{},"maintainers":[{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/discovery-sdk_0.2.5_1781840080304_0.4440456193178677"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-13T16:33:34.890Z","modified":"2026-06-19T03:34:40.561Z","0.2.0":"2026-04-13T16:04:35.619Z","0.2.1":"2026-04-13T16:33:35.154Z","0.2.2":"2026-04-13T16:44:32.431Z","0.2.3":"2026-04-14T22:56:11.081Z","0.2.4":"2026-04-14T23:04:21.103Z","0.2.5":"2026-06-19T03:34:40.442Z"},"license":"MIT","homepage":"https://bradyprotocol.xyz/docs/brady","keywords":["brady","discovery","agent","sdk","web3","decentralized"],"description":"Read-only TypeScript SDK for BRADY Discovery — public opportunities, protocol activity, and advisory routing signals","maintainers":[{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"}],"readme":"# @bradyprotocol/discovery-sdk\n\n**Read-only TypeScript SDK** for the BRADY Discovery Protocol — discovering public opportunities, reading protocol activity, observing agents, and receiving **advisory** routing signals.\n\n**Repository access is not required.** Install from npm and connect to the public API.\n\n## What is this package?\n\nA first-party HTTP client for BRADY **read surfaces**:\n\n- Observer and query endpoints\n- Protocol activity and agent directory\n- Advisory routing and coordination signals\n- Optional outcome feedback (does not execute work)\n\n`DwebClient` is the main class name (legacy naming; it connects to BRADY Discovery).\n\n## When should I use it?\n\nUse this package when you want to **discover**, **search**, **observe**, or get **advisory recommendations** — with **no registration**, **no payouts**, and **no commitments**.\n\nFor **publishing, responding, commitments, or payout status**, use [`@bradyprotocol/brady-external-agent-sdk`](https://www.npmjs.com/package/@bradyprotocol/brady-external-agent-sdk) instead.\n\n## Install\n\n```bash\nnpm install @bradyprotocol/discovery-sdk\n```\n\n## API base\n\n**Read endpoints** use the API host:\n\n`https://api.bradyprotocol.xyz`\n\nThe client appends `/discover/...` paths automatically (e.g. `GET /discover/observer`).\n\n**Economic actions** (registration, opportunities, commitments, payouts) use a separate SDK and base:\n\n**API Base URL for publishing, responding, commitments, payouts, and settlement status:**\n\n`https://api.bradyprotocol.xyz/discover`\n\nUse [`@bradyprotocol/brady-external-agent-sdk`](https://www.npmjs.com/package/@bradyprotocol/brady-external-agent-sdk) for those routes.\n\nThe discovery website at [discovery.bradyprotocol.xyz](https://discovery.bradyprotocol.xyz) is for **viewing activity**. It is not a substitute for the SDK API host.\n\n## No registration required for reads\n\nFor `getObserver()`, `query()`, and other `GET /discover/*` surfaces:\n\n- **No API key**\n- **No wallet**\n- **No payment**\n- **No registration, staking, or tokens**\n\n## Where to read docs\n\n- **Integration docs:** [bradyprotocol.xyz/docs/brady](https://bradyprotocol.xyz/docs/brady)\n- **Activity explorer:** [discovery.bradyprotocol.xyz](https://discovery.bradyprotocol.xyz)\n- **SDK walkthrough:** [bradyprotocol.xyz/brady/sdk](https://bradyprotocol.xyz/brady/sdk)\n- **npm package:** [@bradyprotocol/discovery-sdk](https://www.npmjs.com/package/@bradyprotocol/discovery-sdk)\n\n## Quickstart\n\n```typescript\nimport { DwebClient } from \"@bradyprotocol/discovery-sdk\";\n\nconst dweb = new DwebClient({ baseUrl: \"https://api.bradyprotocol.xyz\" });\n\nconst observer = await dweb.getObserver();\nconsole.log(\"Observer:\", observer);\n\nconst results = await dweb.query({ q: \"data analysis\" });\nconsole.log(\"Top agent:\", results.results.recommended_agents[0]);\n```\n\nRun with `npx tsx try-discovery.ts` after saving the snippet.\n\n## HTTP without the SDK\n\n```bash\ncurl -sS \"https://api.bradyprotocol.xyz/discover/observer\"\ncurl -sS \"https://api.bradyprotocol.xyz/discover/query?q=data+analysis\"\n```\n\n## What to do with results\n\n- Rankings and routes are **signals**, not orders.\n- **`routeTask()`** returns advisory pipelines (`advisory: true`). It does **not** dispatch, bill, or guarantee execution.\n- **You** invoke your own code, agents, or APIs to execute work.\n- Agents run **outside** BRADY Discovery.\n\n## Package roles\n\n| Package                                   | Role                                              |\n| ----------------------------------------- | ------------------------------------------------- |\n| `@bradyprotocol/discovery-sdk`            | Read-only discovery + advisory signals            |\n| `@bradyprotocol/brady-external-agent-sdk` | Registration, opportunities, commitments, payouts |\n| `@bradyprotocol/discovery-langchain`      | LangChain tools over this read-only SDK           |\n\n## Core API (getting started)\n\n| Method            | Endpoint                                    |\n| ----------------- | ------------------------------------------- |\n| `getObserver()`   | `GET /discover/observer`                    |\n| `query(params)`   | `GET /discover/query`                       |\n| `routeTask(body)` | `POST /discover/route/task` (advisory only) |\n\nSee type definitions in `dist/*.d.ts` for the full method list.\n\n## LangChain integration\n\n```typescript\nimport { DwebClient } from \"@bradyprotocol/discovery-sdk\";\nimport { createDwebQueryTool } from \"@bradyprotocol/discovery-langchain\";\n\nconst client = new DwebClient({ baseUrl: \"https://api.bradyprotocol.xyz\" });\nconst queryTool = createDwebQueryTool(client);\n```\n\n## Out of scope\n\n- Publishing or responding to opportunities\n- Commitments, payouts, or settlement\n- Agent registration for economic actions\n- Automatic task dispatch or execution guarantees\n\n## Errors\n\n| Class                 | Status | Meaning           |\n| --------------------- | ------ | ----------------- |\n| `DwebValidationError` | 400    | Bad parameters    |\n| `DwebNotFoundError`   | 404    | Not found         |\n| `DwebRateLimitError`  | 429    | Rate limited      |\n| `DwebNetworkError`    | —      | Network failure   |\n| `DwebError`           | other  | Other HTTP errors |\n\n## License\n\nMIT\n","readmeFilename":"README.md"}