How ericbss05/openbot-lite works
OpenBot Lite is a browser-based console and Hono API for managing AI agent profiles, channels, routines, plugins and governance. Users authenticate, create or manage agents, and can submit channel messages; the API records the message and queues a turn. Administrative flows configure policy and inspect audit events, while plugin calls are checked and audited before execution. The README describes a simplified product, but the supplied tree contains additional runtime subsystems. Several of their internal links are omitted because their callers were not shown.
Main entry points: app.ts HTTP routes · index.ts PostgreSQL · store.ts Policy gateway · loop.ts Agent runtime
Components 19
Web console
- Sign-in page
web/app/page.tsx - Agent pages
web/app/(protected)/agents/page.tsx - Agent creation
web/app/(protected)/agents/new/_components/createAgentForm.tsx - Agent data hook
web/hooks/useAgents.ts - Agent API client
web/lib/api/agents.ts
API and identity
- HTTP routes
server-lite/src/app.ts - Session auth
server-lite/src/auth/auth.ts
Agent operations
- Agent profiles
server-lite/src/agent-profiles/store.ts - Agent runtime
server-lite/src/agent/runtime/loop.ts - Tool registry
server-lite/src/agent/tools/tools.ts - Channels
server-lite/src/channels/store.ts - Work queue
server-lite/src/work/queue.ts - Routines
server-lite/src/routines/store.ts
Governance and extensions
- Policy gateway
server-lite/src/gateway/store.ts - Audit events
server-lite/src/gateway/audit.ts - Plugin registry
server-lite/src/plugins/store.ts - MCP tools
server-lite/src/plugins/mcp.ts
Persistence
- PostgreSQL
server-lite/src/db/index.ts
Other components
- User
Connections 24
- User → Sign-in page: signs in
web/app/page.tsx - User → Agent pages: manages agents
web/app/(protected)/agents/page.tsx - Agent pages → Agent data hook: loads agents
web/app/(protected)/agents/page.tsx - Agent creation → Agent API client: creates agent
- Agent API client → HTTP routes: requests API
- Sign-in page → Session auth: authenticates
- HTTP routes → Session auth: handles auth routes
server-lite/src/app.ts - HTTP routes → Agent profiles: manages profiles
server-lite/src/app.ts - HTTP routes → Channels: manages channels
server-lite/src/app.ts - HTTP routes → Work queue: queues turns
server-lite/src/app.ts - HTTP routes → Policy gateway: checks policy
server-lite/src/app.ts - HTTP routes → Audit events: records events
server-lite/src/app.ts - HTTP routes → Routines: manages routines
server-lite/src/app.ts - HTTP routes → Plugin registry: manages plugins
server-lite/src/app.ts - HTTP routes → MCP tools: lists or calls tools
server-lite/src/app.ts - Agent profiles → PostgreSQL: reads and writes
server-lite/src/agent-profiles/store.ts - Channels → PostgreSQL: reads and writes
server-lite/src/channels/store.ts - Work queue → PostgreSQL: stores work
server-lite/src/work/queue.ts - Routines → PostgreSQL: reads and writes
server-lite/src/routines/store.ts - Plugin registry → PostgreSQL: reads and writes
server-lite/src/plugins/store.ts - Audit events → PostgreSQL: persists events
server-lite/src/gateway/audit.ts - Policy gateway → PostgreSQL: persists policy
server-lite/src/gateway/store.ts - Agent runtime → Tool registry: uses tools
- Agent runtime → Policy gateway: authorizes actions