How deepagents-ai/agent-backend works
Agent Backend provides filesystem and memory access to agents through client libraries and sandbox daemons; Agent Document Room builds a search-to-workspace-to-commit workflow on top. Its documented capabilities include MCP and SSH access, scoped backends, multiple workspace runtimes, semantic text/image search, and durable versioned storage. The graph combines these products with the indexing and storage packages. Several implementation paths are unsampled, so links for those branches rely only on README or source-index evidence.
Main entry points: index.ts Backend Clients · room-service.ts Room Service · manifest-room-catalog.ts Room Catalog · server.ts Room MCP API
Components 23
Agent Backend
- Backend Clients
packages/agent-backend/typescript/src/backends/index.ts - Local Backend
packages/agent-backend/typescript/src/backends/LocalFilesystemBackend.ts - Memory Backend
packages/agent-backend/typescript/src/backends/MemoryBackend.ts - Remote Backend
packages/agent-backend/typescript/src/backends/RemoteFilesystemBackend.ts - Scoped Backends
packages/agent-backend/typescript/src/backends/ScopedFilesystemBackend.ts - Backend Pool
packages/agent-backend/typescript/src/BackendPoolManager.ts - MCP and SSH
packages/agent-backend/typescript/src/server/AgentBackendMCPServer.ts
Document Room
- Room MCP API
room/src/mcp/server.ts - Room Service
room/src/room-service.ts - Warm Sessions
room/src/session-registry.ts - Room Catalog
room/src/manifest-room-catalog.ts - Workspace Providers
room/src/workspace-docker.ts - Working Tree Adapter
room/src/lib/backend-working-tree.ts
Search and Ingestion
- PDF Ingestion
packages/ingestion/src/pdf.ts - Index Synchronization
packages/index-sync/src/index-sync.ts - Image Indexing
packages/index-sync/src/image-index-sync.ts - Embedding Providers
packages/embeddings/src/factory.ts - Vector Store Adapter
packages/index-sync/src/vector-store.ts - Postgres Vectors
packages/vector-pg/src/index.ts
Versioned Storage
- Versioned Store
packages/versioned-store/src/versioned-store.ts - Manifest and Hashing
packages/versioned-store/src/manifest.ts - S3 Storage
packages/versioned-store/src/stores/s3.ts
Other components
- AI Agent
Connections 22
- AI Agent → Backend Clients: uses
- Backend Clients → Local Backend: selects
packages/agent-backend/typescript/src/backends/index.ts - Backend Clients → Remote Backend: selects
packages/agent-backend/typescript/src/backends/index.ts - Backend Clients → Memory Backend: selects
packages/agent-backend/typescript/src/backends/index.ts - Backend Clients → Scoped Backends: selects
packages/agent-backend/typescript/src/backends/index.ts - Backend Pool → Backend Clients: manages
packages/agent-backend/typescript/src/BackendPoolManager.ts - AI Agent → MCP and SSH: accesses
- AI Agent → Room MCP API: uses
- Room MCP API → Room Service: invokes
room/src/mcp/server.ts - Room MCP API → Warm Sessions: manages
room/src/mcp/server.ts - Room Service → Room Catalog: queries
room/src/room-service.ts - Room Service → Workspace Providers: provisions
- Room Service → Working Tree Adapter: adapts
room/src/room-service.ts - Room Catalog → Index Synchronization: indexes and searches
room/src/manifest-room-catalog.ts - Room Catalog → Versioned Store: reads and commits
room/src/manifest-room-catalog.ts - PDF Ingestion → Room Catalog: supplies documents
- Index Synchronization → Embedding Providers: embeds
- Index Synchronization → Vector Store Adapter: uses
packages/index-sync/src/index-sync.ts - Image Indexing → Embedding Providers: embeds images
- Postgres Vectors → Vector Store Adapter: implements
packages/vector-pg/src/index.ts - Versioned Store → Manifest and Hashing: hashes and merges
packages/versioned-store/src/versioned-store.ts - Versioned Store → S3 Storage: persists blobs and manifests