How mananmodi1487/orvyn works
ORVYN’s supplied README describes a UI foundation with an intentionally unwired composer, but the source index and excerpts show a substantially expanded application: authenticated workspace, AI chat and usage accounting, conversation APIs backed by Supabase, and a local coding-agent CLI. The principal evidenced flow is a signed-in request to the chat route, which validates it, resolves a gateway, streams events, and records usage. Many UI, provider, auth, and CLI implementations were not sampled, so their internal connections are omitted rather than inferred.
Main entry points: chat/route.ts Chat endpoint · page.tsx Home entry · gateway.ts Model gateway · messages/route.ts Message endpoints
Components 25
Workspace UI
- Home entry
src/app/page.tsx - Workspace shell
src/components/workspace/workspace-shell.tsx
Identity
- Sign-in panel
src/components/workspace/auth-panel.tsx - Auth actions
src/lib/auth/actions.ts - Session lookup
src/lib/auth/session.ts - Chat auth guard
src/lib/auth/guard.ts
AI chat
- Chat endpoint
src/app/api/chat/route.ts - Request validation
src/lib/ai/chat-request.ts - Stream service
src/lib/ai/chat-service.ts - AI runtime
src/lib/ai/runtime.ts - Model gateway
src/lib/ai/gateway.ts - Model providers
src/lib/ai/providers - Usage accounting
src/lib/ai/usage-store.ts - Usage endpoint
src/app/api/usage/route.ts
Conversation data
- Conversation endpoints
src/app/api/conversations - Message endpoints
src/app/api/conversations/[id]/messages/route.ts - Conversation titles
src/lib/ai/conversation-titles.ts - Supabase data service
src/utils/supabase/server.ts - Supabase database
Coding agent
- Agent CLI
packages/agent-cli/bin/orvyn-agent.ts - Agent server
packages/agent-cli/src/server/agent.ts - Task planner
packages/agent-cli/src/server/planner.ts - Agent tools
packages/agent-cli/src/server/tools.ts - Browser bridge
src/lib/agent/bridge.ts
Other components
- Workspace user
Connections 25
- Workspace user → Home entry: opens workspace
src/app/page.tsx - Home entry → Session lookup: reads session
src/app/page.tsx - Home entry → Sign-in panel: renders signed-out
src/app/page.tsx - Home entry → Workspace shell: renders signed-in
src/app/page.tsx - Sign-in panel → Auth actions: submits credentials
src/components/workspace/auth-panel.tsx - Workspace user → Chat endpoint: posts chat
- Chat endpoint → Chat auth guard: checks access
src/app/api/chat/route.ts - Chat endpoint → Request validation: validates body
src/app/api/chat/route.ts - Chat endpoint → AI runtime: gets gateway
src/app/api/chat/route.ts - AI runtime → Model gateway: provides gateway
- Chat endpoint → Model gateway: ranks candidates
src/app/api/chat/route.ts - Chat endpoint → Stream service: streams events
src/app/api/chat/route.ts - Stream service → Model gateway: streams selected
src/lib/ai/chat-service.ts - Model gateway → Model providers: dispatches generation
- Chat endpoint → Usage accounting: records usage
src/app/api/chat/route.ts - Usage endpoint → Usage accounting: reads summary
src/app/api/usage/route.ts - Conversation endpoints → Supabase data service: queries data
src/app/api/conversations/route.ts - Message endpoints → Supabase data service: reads and writes
src/app/api/conversations/[id]/messages/route.ts - Conversation endpoints → Supabase database: persists conversations
src/app/api/conversations/route.ts - Message endpoints → Supabase database: persists messages
src/app/api/conversations/[id]/messages/route.ts - Message endpoints → Conversation titles: schedules title
src/app/api/conversations/[id]/messages/route.ts - Agent CLI → Agent server: starts server
- Agent server → Task planner: uses planner
- Agent server → Agent tools: uses tools
- Workspace shell → Browser bridge: connects agent