How dcooperdev/bhive-core works
Hive is a provider-agnostic multi-agent framework. The principal workflow is that a caller configures Bees through BeeManager and submits a task; a Bee uses an LLM adapter, validates and executes tool calls, and returns a result. Bees can delegate to one another through the manager, which enforces delegation checks and can secure, audit, and publish delegation events. The README also documents bounded storage-backed queues, persisted conversation context, lifecycle events, retries, and runtime reconfiguration. Security and queue wiring is shown where documented; unsampled subsystem internals are represented by their enclosing source paths.
Main entry points: BeeManager.ts BeeManager · Bee.ts Bee · adapters Provider adapters · LLMAdapter.ts LLM adapter contract
Components 24
Agent runtime
- BeeManager
src/bee/BeeManager.ts - Bee
src/bee/Bee.ts - Bee configuration
src/bee/BeeConfig.ts - Tool validation
src/security/ToolCallValidator.ts - Task queue
src/bee/Bee.ts
LLM integration
- Provider registry
src/llm/providerRegistry.ts - LLM adapter contract
src/providers/LLMAdapter.ts - Provider adapters
src/llm/adapters - Tool call parser
src/llm/ToolCallingParser.ts
Runtime providers
- Conversation context
src/providers/ContextProvider.ts - Storage contract
src/providers/StorageProvider.ts - In-memory storage
src/storage/InMemoryStorage.ts - Event interfaces
src/providers/EventBus.ts - In-memory event bus
src/events/InMemoryEventBus.ts
Delegation and security
- Delegation tool
src/bee/delegationTools.ts - Delegation policy
src/bee/BeeSecurityContext.ts - Identity manager
src/bee/BeeIdentityManager.ts - Bee keyring
src/bee/BeeKeyring.ts - Secure messages
src/security/SecureMessage.ts - Injection detection
src/security/PromptInjectionDetector.ts - Attestation chain
src/security/AttestationChain.ts - Audit log
src/security/AuditLog.ts
Other components
- Application caller
- LLM services
Connections 28
- Application caller → BeeManager: configures and submits
- BeeManager → Bee: creates and runs
- BeeManager → Provider registry: selects adapter
- BeeManager → Bee configuration: configures limits
- Bee → LLM adapter contract: requests completion
- Provider adapters → LLM adapter contract: implements
- Provider adapters → Tool call parser: parses responses
- Provider adapters → LLM services: sends requests
- LLM adapter contract → Provider adapters: implemented by
- Bee → Tool validation: validates tool calls
- Bee → Task queue: queues tasks
- Bee → Conversation context: persists context
- Bee → Storage contract: uses queue storage
- In-memory storage → Storage contract: implements
- Bee → Event interfaces: publishes lifecycle events
- BeeManager → Event interfaces: publishes delegation events
- In-memory event bus → Event interfaces: implements
- Bee → Delegation tool: offers delegation tool
- Delegation tool → BeeManager: requests delegation
- BeeManager → Bee: dispatches to target
- BeeManager → Delegation policy: checks delegation policy
- BeeManager → Injection detection: scans delegated task
- BeeManager → Secure messages: seals and opens messages
- BeeManager → Identity manager: resolves identities
- Identity manager → Bee keyring: creates keyrings
- Secure messages → Bee keyring: signs and decrypts
- BeeManager → Attestation chain: records message chain
- BeeManager → Audit log: records delegation events