Add Dynamo to an agent framework
Not in the preview yet. This feature is built in the repository but is off in the v2.2.6 preview (test mode). Do not treat this page as available on a preview core. See ../preview.md and the release notes.
Each agent framework has its own Dynamo plugin. A plugin gives every agent in your app its own capped slice of one budget: a hand-off or a sub-agent opens a child slice that can never exceed what its parent has left, a model call that would go over its slice is refused before the model is called, one revoke stops a whole branch, and every hop is signed so you can check it offline.
None of these packages is published yet. Each installs from a clone of the repository, and each README starts with an offline quickstart (a local core in Control Mode, a scripted mock model, no provider key) and then shows the lines you add to your own app. Each framework below links to a page with the install commands, the code that wraps an agent run in a budget, and what a refusal looks like; the code on those pages is checked byte for byte against the plugin's README and example files.
Maintaining a framework, gateway, rail or platform? See the partner integration guide.
Before you start
- A core. Boot a local instance
in Control Mode (no money moves), or use your hosted instance. Every quickstart below boots its own local core for you.
- Python plugins. Use Python 3.11. Each plugin's venv, except the OpenAI
Agents SDK plugin's, is built from binary wheels pinned and hash-checked by its locks/test.txt; the OpenAI Agents SDK plugin has no lock file and installs from the package index with only its direct dependencies pinned. Upgrade pip in the new venv first from the hash-pinned scripts/py/pip-bootstrap.txt (.venv/bin/python -m pip install --require-hashes -r scripts/py/pip-bootstrap.txt): the pip bundled with Python 3.11 can refuse these locks.
- Node and pnpm. The repository asks for Node 22.12 or later and pnpm 9
(its engines and packageManager fields); every quickstart builds the core with them. Build a TypeScript plugin with pnpm --filter <package>... -r build.
- A price table. Every priced model needs a row with a source and an
as-of date; a model without one is refused. The quickstarts use mock_prices() (Python) or mockPrices() (TypeScript); with a real model pass your own table, for example quickstart/dynamo-guard/prices.json.
Credentials: owner token or scoped credentials
Most plugins connect with the owner token (DYNAMO_OWNER_TOKEN) and open the budget themselves. Some take only scoped credentials, so the agent process never holds an owner key; the operator mints them where the owner token lives:
| Kind | Mint with | Reaches |
|---|---|---|
hook | POST /owner/v1/scoped-credentials {"kind": "hook", "budgetId": "…"} | that budget only: read it, its tree and its streams' headroom, finality and authority chain; mint allowance credentials; reserve, confirm, release. It never opens, revokes, freezes or approves |
delegator | POST /owner/v1/scoped-credentials {"kind": "delegator", "streamId": "…"} | that stream and its subtree: open children under that stream; read headroom, the authority chain, payment records, the payment authority and billed rows in its subtree, and the stream's status on the plugin wire; mint allowance credentials; issue payment authorizations and receipts |
The answer carries the secret once (dsc1.hook.…, dsc1.delegator.…). A call outside its scope answers credential_scope. A delegator credential expires 24 hours after it is minted, or after expiresInSeconds (60 seconds to 30 days, Dynamo-Version 1.9.0), and never later than its stream's or budget's own expiry; after that it answers 401. To keep going, mint a new one. Clients pinned at 1.9.0 see expiresAt on every credential. A third kind, payee, is for a payee itself (its /payee/v1/* routes and meters on streams that pay it) and is minted only with the payee's own fresh signature; no plugin on these pages uses it.
Funding modes
What every plugin on these pages does today:
- Control Mode (Live). A budget a plugin opens itself is always a
Control Mode budget: every check runs and no money moves. Every quickstart and every plugin test uses one.
- A funded budget passed by id. A plugin that re-attaches an existing
stablecoin or credit card budget does not refuse it, but no plugin test runs on one. In those modes the core requires signed hops by default (CORE_OWN_HOPS), and a child slice opened without its delegator's signature is refused hop_unsigned. Pass the plugin's hops option (a LayerHops from the agents layer: the delegator's key and each payee's own signed offer) so it signs every hop it opens. n8n and Dify have no such option; see their pages.
- Coding-agent hooks.
@dynamoprotocol/coding-agent-hooks(Cursor, Codex
CLI, Gemini CLI) opens Control Mode budgets and cannot sign hops, so a core that requires signed hops (the default in every money mode) refuses its streams. It is Control Mode only.
- Real money (Release-gated). A core runs a money mode only when its
operator allows it, and real-money settlement is not released.
Python plugins
| Framework | Package | Framework pin | README (in the repository) | Test target |
|---|---|---|---|---|
| OpenAI Agents SDK | dynamoprotocol-openai-agents 0.6.0 | openai-agents 0.23.1 | packages/plugin-openai-agents/README.md | make test-py-agents |
| LangChain, LangGraph, Deep Agents | dynamoprotocol-langchain 0.3.0 | langchain 1.4.3, langgraph 1.2.14, deepagents 0.7.23 | packages/plugin-langchain/README.md | make test-plugin-langchain |
| LlamaIndex agents | dynamoprotocol-llamaindex 0.1.0 (scoped credentials) | llama-index-core 0.14.25 | packages/plugin-llamaindex/README.md | make test-plugin-llamaindex |
| CrewAI (Linux; Docker on Intel macOS) | dynamoprotocol-crewai 0.3.0 | crewai 1.15.23 | packages/plugin-crewai/README.md | make test-plugin-crewai |
| Google ADK | dynamoprotocol-adk 0.3.0 | google-adk 2.11.0 | packages/plugin-adk/README.md | make test-plugin-adk |
| Claude Agent SDK | dynamoprotocol-claude-agent-sdk 0.3.0 | claude-agent-sdk 0.2.163 | packages/plugin-claude-agent-sdk/README.md | make test-plugin-claude-agent-sdk |
| Microsoft Agent Framework | dynamoprotocol-msaf 0.2.0 | agent-framework-core 1.20.0 | packages/plugin-msaf/README.md | make test-plugin-msaf |
| Pydantic AI | dynamoprotocol-pydantic-ai 0.2.0 | pydantic-ai-slim 2.54.0 | packages/plugin-pydantic-ai/README.md | make test-plugin-pydantic-ai |
| Strands Agents | dynamoprotocol-strands 0.2.0 | strands-agents 1.57.2 | packages/plugin-strands/README.md | make test-plugin-strands |
| NVIDIA NeMo Agent Toolkit | dynamoprotocol-nemo 0.2.0 | nvidia-nat-core 1.9.0 | packages/plugin-nemo/README.md | make test-plugin-nemo |
TypeScript plugins
| Framework | Package | Framework pin | README (in the repository) | Test target |
|---|---|---|---|---|
| OpenAI Agents JS | @dynamoprotocol/openai-agents 0.2.0 | @openai/agents 0.19.0 | packages/plugin-openai-agents-js/README.md | make test-plugin-openai-agents-js |
| Vercel AI SDK | @dynamoprotocol/ai-sdk 0.2.0 | ai 7.0.133 | packages/plugin-ai-sdk/README.md | make test-plugin-ai-sdk |
| Mastra | @dynamoprotocol/mastra 0.2.0 | @mastra/core 1.74.0 | packages/plugin-mastra/README.md | make test-plugin-mastra |
| LangGraph.js | @dynamoprotocol/langgraph 0.2.0 | @langchain/langgraph 1.4.21 | packages/plugin-langgraph-js/README.md | make test-plugin-langgraph-js |
| Claude Agent SDK (TypeScript) | @dynamoprotocol/claude-agent-sdk 0.3.0 | @anthropic-ai/claude-agent-sdk 0.3.293 | packages/plugin-claude-agent-sdk-ts/README.md | make test-plugin-claude-agent-sdk-ts |
Workflow platforms
| Platform | Package | README (in the repository) |
|---|---|---|
| n8n | @dynamoprotocol/n8n-nodes-dynamo | packages/n8n-nodes-dynamo/README.md |
| Dify | the dynamo Dify tool plugin | packages/plugin-dify/README.md |
For a gateway in front of any OpenAI-compatible endpoint instead, see LiteLLM and the guard.
What next
- The agent network example: agents built on four of
these plugins hire each other across owners under one bounded budget.
- Policies: narrow what every budget of an
organisation or team may do.
- Task Allowance: pay an agent for delivered work once it
is accepted.
The tested versions and the record of each pin decision are in docs/integrations/matrix.md.