How dami904/dreamkeeper works
DreamKeeper is a safety and execution layer for Daydreams agents that submit value-moving actions through KeeperHub or a direct onchain fallback. The principal flow is agent → registered actions → client preflight and execution → transport, with reconciliation for uncertain outcomes. Separate capabilities include conditional check-and-execute, curated protocol actions, Tempo hold/release/cancel, audit and trust reporting, and spending-limit queries. Source excerpts show the client’s firewall, idempotency, and persistence responsibilities; some wiring for other listed subsystems is inferred only from documented product capabilities and is left unlinked where ownership is not evident.
Main entry points: client.ts KeeperHub Client · actions.ts Agent Actions · transport.ts Transport Interface · extension.ts DreamKeeper Extension
Components 21
Agent Integration
- DreamKeeper Extension
packages/core/src/daydreams/extension.ts - Agent Actions
packages/core/src/daydreams/actions.ts
Safety Controls
- Firewall Validator
packages/core/src/firewall/validator.ts - Preflight Invariants
packages/core/src/firewall/invariants.ts - Circuit Breaker
packages/core/src/firewall/circuit-breaker.ts
Execution
- KeeperHub Client
packages/core/src/keeperhub/client.ts - Transport Interface
packages/core/src/keeperhub/transport.ts - KeeperHub Transport
packages/core/src/keeperhub/live-transport.ts - Mock Transport
packages/core/src/keeperhub/mock-transport.ts - Onchain Fallback
packages/core/src/keeperhub/onchain-transport.ts - Tempo Payments
packages/core/src/keeperhub/client.ts - Protocol Actions
packages/core/src/daydreams/actions.ts
State and Reporting
- Trust Ledger
packages/core/src/firewall/trust-ledger.ts - Idempotency Store
packages/core/src/keeperhub/idempotency.ts - Execution State Machine
packages/core/src/keeperhub/state-machine.ts - File Persistence
packages/core/src/persistence/file-store.ts - Audit and Trust Reports
packages/core/src/daydreams/actions.ts
Other components
- Daydreams Agent
- Daydreams Runtime
- KeeperHub Service
- Blockchain RPC
Connections 21
- Daydreams Agent → Daydreams Runtime: submits intent
- Daydreams Runtime → DreamKeeper Extension: loads extension
- DreamKeeper Extension → KeeperHub Client: creates client
- DreamKeeper Extension → Agent Actions: registers actions
- Daydreams Agent → Agent Actions: invokes tools
- Agent Actions → KeeperHub Client: calls operations
- KeeperHub Client → Firewall Validator: validates intents
- KeeperHub Client → Circuit Breaker: checks execution gate
- KeeperHub Client → Trust Ledger: records trust events
- KeeperHub Client → Idempotency Store: checks keys
- KeeperHub Client → Execution State Machine: tracks outcomes
- KeeperHub Client → Transport Interface: dispatches operations
- KeeperHub Client → File Persistence: persists snapshots
- Transport Interface → KeeperHub Transport: implemented by
- Transport Interface → Mock Transport: implemented by
- Transport Interface → Onchain Fallback: implemented by
- KeeperHub Transport → KeeperHub Service: calls tools
- Onchain Fallback → Blockchain RPC: reads and broadcasts
- KeeperHub Client → Tempo Payments: manages holds
- Agent Actions → Protocol Actions: exposes curated calls
- Agent Actions → Audit and Trust Reports: exposes queries