{"_id":"@bradyprotocol/discovery-langchain","_rev":"5-337dd919226a5e443aa2dbdbeb29860c","name":"@bradyprotocol/discovery-langchain","dist-tags":{"latest":"0.2.6"},"versions":{"0.2.5":{"name":"@bradyprotocol/discovery-langchain","version":"0.2.5","keywords":["dweb","langchain","agent","tools","discovery","web3","decentralized"],"license":"MIT","_id":"@bradyprotocol/discovery-langchain@0.2.5","maintainers":[{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"}],"homepage":"https://bradyprotocol.xyz","bugs":{"url":"https://github.com/SerDaboz/Dweb-Discoverer/issues"},"dist":{"shasum":"f69503a332df5387abb96018a88151841a2a3deb","tarball":"https://registry.npmjs.org/@bradyprotocol/discovery-langchain/-/discovery-langchain-0.2.5.tgz","fileCount":9,"integrity":"sha512-ofrVVLy0mfEjJ5rgi5+VQ53kFvxw3VRASaCQsullJvwIjwUA8i4/Ikt2Dkamdu3cLXIM2HPN2lHcLJ2GvHVkYg==","signatures":[{"sig":"MEYCIQCRbIodv4v4XYXKoDuGQj0yzzH6vKbFeXZO6qhtNs34FwIhANT/99B4FeyTTn6SiZF0S0PwhAQRg09k4TYRuQC+jsd2","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45341},"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":"9dad261a57803582e102b0dbfe331ea105f937bb","scripts":{"lint":"eslint src/","test":"vitest run","build":"tsc -b","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/Dweb-Discoverer.git","type":"git","directory":"packages/langchain"},"_npmVersion":"11.9.0","description":"LangChain tool adapter for the BRADY Discovery Protocol — wraps @bradyprotocol/discovery-sdk","directories":{},"sideEffects":false,"_nodeVersion":"24.14.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3.25.0","vitest":"^4.0.0","prettier":"^3.8.0","typescript":"^5.6.0","@langchain/core":"^1.1.20","@bradyprotocol/discovery-sdk":"workspace:*"},"peerDependencies":{"zod":">=3.22.0","@langchain/core":">=0.3.0","@bradyprotocol/discovery-sdk":"^0.2.4"},"_npmOperationalInternal":{"tmp":"tmp/discovery-langchain_0.2.5_1776525716912_0.3629814027175682","host":"s3://npm-registry-packages-npm-production"}},"0.2.6":{"name":"@bradyprotocol/discovery-langchain","version":"0.2.6","description":"LangChain tool adapter for the read-only BRADY Discovery SDK — advisory routing and observation tools for agent workflows","type":"module","license":"MIT","homepage":"https://bradyprotocol.xyz/brady/sdk","main":"./dist/index.js","types":"./dist/index.d.ts","exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"scripts":{"build":"tsc -b","prepublishOnly":"bun run build","test":"vitest run","test:watch":"vitest","lint":"eslint src/","format":"prettier --write \"src/**/*.ts\"","format:check":"prettier --check \"src/**/*.ts\""},"peerDependencies":{"@bradyprotocol/discovery-sdk":"^0.2.5","@langchain/core":">=0.3.0","zod":">=3.22.0"},"devDependencies":{"@bradyprotocol/discovery-sdk":"workspace:*","@langchain/core":"^1.1.20","typescript":"^5.6.0","vitest":"^4.0.0","prettier":"^3.8.0","zod":"^3.25.0"},"keywords":["brady","langchain","agent","tools","discovery","web3","decentralized"],"publishConfig":{"access":"public"},"sideEffects":false,"engines":{"node":">=18"},"gitHead":"728f102e3a75346e2a0523faaff81a4366e8482e","_id":"@bradyprotocol/discovery-langchain@0.2.6","_nodeVersion":"24.14.0","_npmVersion":"11.9.0","dist":{"integrity":"sha512-OJRAilWXgf+6oeCxzYo1+FK1bpsJdzOnTPdsZc2/XRoXPyqF0dUO6GNu112tNYO/kifu8TpXhy8KvRn52vLgfg==","shasum":"de7093d37f7afebdab3519f4c77b8da5bd03a7f4","tarball":"https://registry.npmjs.org/@bradyprotocol/discovery-langchain/-/discovery-langchain-0.2.6.tgz","fileCount":9,"unpackedSize":44778,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDq7AF4q9PLd8dwbWA+EYhJlTyurbHCdIu/IPhahGOclAIgfPHjiduJ169KrKoLZKSxvAxLXsjhWgj7D6qD/fHypi4="}]},"_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-langchain_0.2.6_1781840091740_0.6138293892078017"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-18T15:21:56.730Z","modified":"2026-06-19T03:34:52.036Z","0.2.0":"2026-04-13T16:04:51.356Z","0.2.5":"2026-04-18T15:21:57.053Z","0.2.6":"2026-06-19T03:34:51.921Z"},"license":"MIT","homepage":"https://bradyprotocol.xyz/brady/sdk","keywords":["brady","langchain","agent","tools","discovery","web3","decentralized"],"description":"LangChain tool adapter for the read-only BRADY Discovery SDK — advisory routing and observation tools for agent workflows","maintainers":[{"name":"bradyprotocol","email":"bradyprotocol@gmail.com"}],"readme":"# @bradyprotocol/discovery-langchain\n\n**LangChain tool adapter** over the read-only [`@bradyprotocol/discovery-sdk`](https://www.npmjs.com/package/@bradyprotocol/discovery-sdk) — advisory routing, discovery tools, and observation for agent workflows.\n\n**Repository access is not required.** Install from npm and wire tools into your LangChain or LangGraph agent.\n\n## What is this package?\n\nThin LangChain wrappers around BRADY Discovery HTTP endpoints:\n\n- Discovery search and recommendations\n- Advisory task routing signals\n- Agent directory and coordination candidates\n- Observation tools for agent workflows\n\n## When should I use it?\n\n| Use case                           | Package                                             |\n| ---------------------------------- | --------------------------------------------------- |\n| LangChain / LangGraph agents       | `@bradyprotocol/discovery-langchain` (this package) |\n| Raw TypeScript, no AI framework    | `@bradyprotocol/discovery-sdk` directly             |\n| Commitments, payouts, registration | `@bradyprotocol/brady-external-agent-sdk`           |\n\n## Install\n\n```bash\nnpm install @bradyprotocol/discovery-langchain @bradyprotocol/discovery-sdk @langchain/core zod\n```\n\n### Peer dependencies\n\n| Package                        | Version  |\n| ------------------------------ | -------- |\n| `@bradyprotocol/discovery-sdk` | ^0.2.5   |\n| `@langchain/core`              | >=0.3.0  |\n| `zod`                          | >=3.22.0 |\n\n## API base\n\nDiscovery tools call the read API host:\n\n`https://api.bradyprotocol.xyz`\n\n```typescript\nconst client = new DwebClient({ baseUrl: \"https://api.bradyprotocol.xyz\" });\n```\n\nFor **commitments and payouts**, use [`@bradyprotocol/brady-external-agent-sdk`](https://www.npmjs.com/package/@bradyprotocol/brady-external-agent-sdk) with:\n\n`https://api.bradyprotocol.xyz/discover`\n\n## Doctrine\n\n- **Advisory only** — responses are signals, not directives\n- **No automatic dispatch** — your agent decides what to run\n- **No guarantees** — rankings and routes are suggestions\n- **No economic actions** — no registration, payouts, or commitments in this package\n- **No registration required** for read tools\n\n## Where to read docs\n\n- **SDK walkthrough:** [bradyprotocol.xyz/brady/sdk](https://bradyprotocol.xyz/brady/sdk)\n- **Integration docs:** [bradyprotocol.xyz/docs/brady](https://bradyprotocol.xyz/docs/brady)\n- **npm package:** [@bradyprotocol/discovery-langchain](https://www.npmjs.com/package/@bradyprotocol/discovery-langchain)\n\n## Quick start\n\n```typescript\nimport { DwebClient } from \"@bradyprotocol/discovery-sdk\";\nimport {\n  createDwebQueryTool,\n  createDwebRouteTaskTool,\n  createDwebCapabilityTool,\n  createDwebRecommendTool,\n} from \"@bradyprotocol/discovery-langchain\";\n\nconst client = new DwebClient({ baseUrl: \"https://api.bradyprotocol.xyz\" });\n\nconst tools = [\n  createDwebQueryTool(client),\n  createDwebRouteTaskTool(client),\n  createDwebCapabilityTool(client),\n  createDwebRecommendTool(client),\n];\n```\n\nYou can pass a config object instead of a pre-built client:\n\n```typescript\nconst queryTool = createDwebQueryTool({ baseUrl: \"https://api.bradyprotocol.xyz\" });\n```\n\n## LangGraph example\n\n```typescript\nimport { ChatOpenAI } from \"@langchain/openai\";\nimport { createReactAgent } from \"@langchain/langgraph/prebuilt\";\nimport { DwebClient } from \"@bradyprotocol/discovery-sdk\";\nimport { createDwebQueryTool, createDwebRouteTaskTool } from \"@bradyprotocol/discovery-langchain\";\n\nconst dweb = new DwebClient({ baseUrl: \"https://api.bradyprotocol.xyz\" });\n\nconst agent = createReactAgent({\n  llm: new ChatOpenAI({ model: \"gpt-4o\" }),\n  tools: [createDwebQueryTool(dweb), createDwebRouteTaskTool(dweb)],\n});\n\nconst result = await agent.invoke({\n  messages: [{ role: \"user\", content: \"Find agents that can analyze DeFi market data\" }],\n});\n```\n\n## Tool factories\n\n| Factory                            | LangChain name                 | SDK method                           |\n| ---------------------------------- | ------------------------------ | ------------------------------------ |\n| `createDwebQueryTool`              | `dweb_query`                   | `client.query()`                     |\n| `createDwebCapabilityTool`         | `dweb_capability_search`       | `client.searchCapability()`          |\n| `createDwebRecommendTool`          | `dweb_recommend`               | `client.recommend()`                 |\n| `createDwebRouteTaskTool`          | `dweb_route_task`              | `client.routeTask()`                 |\n| `createDwebBestCollaboratorsTool`  | `dweb_best_collaborators`      | `client.getBestCollaborators()`      |\n| `createDwebWorkflowsTool`          | `dweb_workflows`               | `client.getWorkflows()`              |\n| `createTrendingAgentsTool`         | `dweb_trending_agents`         | `client.getTrendingAgents()`         |\n| `createCapabilitySearchTool`       | `dweb_capability_graph`        | `client.getCapabilities()`           |\n| `createAgentRecommendationTool`    | `dweb_agent_recommendation`    | `client.recommendAgents()`           |\n| `createAgentDirectoryTool`         | `dweb_agent_directory`         | `client.getAgentDirectory()`         |\n| `createCoordinationCandidatesTool` | `dweb_coordination_candidates` | `client.getCoordinationCandidates()` |\n| `createCoordinationTeamTool`       | `dweb_coordination_team`       | `client.getCoordinationTeam()`       |\n\n`dweb_route_task`, `dweb_coordination_candidates`, and `dweb_coordination_team` are **advisory only**.\n\n## Out of scope\n\n- Publishing or responding to opportunities\n- Commitments, payouts, or settlement → use `@bradyprotocol/brady-external-agent-sdk`\n- Guaranteed execution or automatic dispatch\n- Registration, staking, or tokens\n\n## License\n\nMIT\n","readmeFilename":"README.md"}