How sunnyvbi/zavi works
Zavi is a multi-client AI-agent workspace with a backend for agent execution and growth-channel runs, a web workspace for initiating and reviewing engineering work, and an admin console. A typical engineering flow starts with a user request in the workspace, proceeds through backend agent and sandbox services, and returns build/preview status to the workspace; the sampled excerpts do not show the complete request-to-run wiring, so that connection is marked unverified. The repository also includes a database connector, browser extension, mobile client, and broad admin capabilities. Evidence is limited to the supplied excerpts and source index; the README is empty.
Main entry points: EngineerDashboard.tsx Engineer dashboard · runtime.ts Connector runtime · engine.ts Channel run engine · useBuildPreview.ts Build preview state
Components 27
User workspace
- Engineer dashboard
apps/web/src/components/workspace/agent/EngineerDashboard.tsx - Workspace shell
apps/web/src/components/workspace/WorkspaceShell.tsx - Build preview state
apps/web/src/lib/workspace/useBuildPreview.ts - Engineer site preview
apps/web/src/components/workspace/EngineerSitePreview.tsx - Browser assistant
apps/extension/src/panel/App.tsx - Mobile dictation
apps/mobile/src/features/voice/useDictation.ts
Agent backend
- Agent engine
apps/backend/src/services/agents/engine/openai-engine.ts - Tool search
apps/backend/src/services/agents/engine/tool-search.ts - Preview service
apps/backend/src/services/sandbox/engineer-preview.ts - Sandbox client
apps/backend/src/services/sandbox/e2b-client.ts - Preview route
apps/backend/src/routes/workspace/engineer-preview.ts - Post-deploy verification
apps/backend/workers/functions/engineer-postdeploy-verify.ts - Worker client
apps/backend/workers/client.ts
Growth channels
- Channel run engine
apps/backend/src/services/channels/engine.ts - Run claim
apps/backend/src/services/channels/claim.ts - Run budget
apps/backend/src/services/channels/budget.ts - Channel actions
apps/backend/src/services/channels/top-actions.ts
Database connector
- Connector bootstrap
apps/connector/src/main.ts - Connector runtime
apps/connector/src/runtime.ts - Local admin server
apps/connector/src/local/server.ts - Database manager
apps/connector/src/db/index.ts - Backend client
apps/connector/src/client.ts - Query executor
apps/connector/src/execute.ts
Admin operations
- Tenant operations
apps/admin/src/app/(dashboard)/tenants/[id]/page.tsx - Suggestion context
apps/admin/src/components/admin/suggestions/workspace/useClientContext.ts - Admin API client
apps/admin/src/lib/api-admin.ts
Other components
- Workspace user
Connections 20
- Workspace user → Engineer dashboard: requests work
apps/web/src/components/workspace/agent/EngineerDashboard.tsx - Engineer dashboard → Workspace shell: reads workspace
apps/web/src/components/workspace/agent/EngineerDashboard.tsx - Engineer dashboard → Agent engine: submits agent work
- Engineer dashboard → Build preview state: tracks build
- Build preview state → Engineer site preview: provides preview state
- Build preview state → Preview route: requests preview data
- Preview route → Preview service: uses preview service
apps/backend/src/routes/workspace/engineer-preview.ts - Preview service → Sandbox client: runs sandbox commands
apps/backend/src/services/sandbox/engineer-preview.ts - Agent engine → Tool search: uses tool search
apps/backend/src/services/agents/engine/openai-engine.ts - Post-deploy verification → Worker client: registers worker
apps/backend/workers/functions/engineer-postdeploy-verify.ts - Channel run engine → Run claim: claims run
apps/backend/src/services/channels/engine.ts - Channel run engine → Run budget: checks budget
apps/backend/src/services/channels/engine.ts - Channel run engine → Channel actions: resolves action
apps/backend/src/services/channels/engine.ts - Connector bootstrap → Connector runtime: starts runtime
apps/connector/src/main.ts - Connector bootstrap → Local admin server: starts local server
apps/connector/src/main.ts - Connector runtime → Query executor: executes checked request
apps/connector/src/runtime.ts - Connector runtime → Backend client: calls backend
apps/connector/src/runtime.ts - Connector runtime → Database manager: uses database manager
apps/connector/src/runtime.ts - Local admin server → Database manager: uses database manager
apps/connector/src/local/server.ts - Suggestion context → Admin API client: fetches context
apps/admin/src/components/admin/suggestions/workspace/useClientContext.ts