# sanjaygrabon/canvas-agent-ops architecture

> Architecture diagram of the GitHub repository sanjaygrabon/canvas-agent-ops, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sanjaygrabon/canvas-agent-ops
- Repository: https://github.com/sanjaygrabon/canvas-agent-ops

## Overview

Agent Hub Central is a team-scoped AI agent management prototype. A user switches workspace, views team outcomes, selects an available agent in Chat, and receives structured responses; teams can submit agent requests that the AI Team reviews in Admin. Shared in-memory state connects tickets, agent availability, conversations, and activity. The README describes a full request-to-dashboard loop, though persistence and external agent services are not shown in the sampled source.

Main entry points: [`src/lib/agent-os/store.tsx`](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/lib/agent-os/store.tsx) (Shared app state), [`src/routeTree.gen.ts`](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routeTree.gen.ts) (Route registry), [`src/routes/admin.tsx`](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/admin.tsx) (Admin console), [`src/components/os/AppShell.tsx`](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/components/os/AppShell.tsx) (Workspace shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace &amp; navigation"]
  node_app["Workspace shell<br/>[AppShell.tsx]"]
  node_router["Route registry<br/>[routeTree.gen.ts]"]
  node_root["App root<br/>[__root.tsx]"]
end

subgraph group_team["Team operations"]
  node_dashboard["Team dashboard<br/>[index.tsx]"]
  node_agents["Agent catalog<br/>[agents.index.tsx]"]
  node_agentdetail["Agent details"]
  node_chat["Agent chat<br/>[chat.tsx]"]
  node_tasks["Team requests<br/>[tasks.tsx]"]
end

subgraph group_control["AI platform control"]
  node_admin["Admin console<br/>[admin.tsx]"]
end

subgraph group_runtime["Agent runtime state"]
  node_store["Shared app state<br/>[store.tsx]"]
  node_catalogdata["Teams &amp; agent data<br/>[data.ts]"]
  node_scripts["Chat response scripts<br/>[chat-scripts.ts]"]
  node_memory["Priority builder<br/>[memory.ts]"]
end

node_user(("Team user"))

node_user -->|"uses workspace"| node_app
node_app -->|"reads workspace state"| node_store
node_app -->|"reads team config"| node_catalogdata
node_root -->|"renders shell"| node_app
node_root -->|"provides state"| node_store
node_router -->|"registers routes"| node_root
node_router -->|"registers route"| node_dashboard
node_router -->|"registers route"| node_admin
node_router -->|"registers route"| node_chat
node_router -->|"registers route"| node_tasks
node_router -->|"registers route"| node_agents
node_router -->|"registers route"| node_agentdetail
node_dashboard -->|"reads team state"| node_store
node_dashboard -->|"renders team metrics"| node_catalogdata
node_agents -->|"reads team agents"| node_store
node_agentdetail -->|"reads execution state"| node_store
node_chat -->|"starts conversations"| node_store
node_chat -->|"uses suggestions"| node_scripts
node_tasks -->|"submits requests"| node_store
node_admin -->|"reviews tickets"| node_store
node_admin -->|"renders request status"| node_tasks
node_store -->|"loads initial data"| node_catalogdata
node_store -->|"generates chat replies"| node_scripts
node_store -->|"builds priorities"| node_memory
node_store -.->|"activity informs outcomes"| node_dashboard
node_tasks -->|"requests become tickets"| node_admin
node_admin -.->|"approval publishes agent"| node_store
node_store -.->|"published agent available"| node_chat

click node_app "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/components/os/AppShell.tsx"
click node_router "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routeTree.gen.ts"
click node_root "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/__root.tsx"
click node_dashboard "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/index.tsx"
click node_agents "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/agents.index.tsx"
click node_agentdetail "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/agents.%24agentId.tsx"
click node_chat "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/chat.tsx"
click node_tasks "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/tasks.tsx"
click node_admin "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/admin.tsx"
click node_store "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/lib/agent-os/store.tsx"
click node_catalogdata "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/lib/agent-os/data.ts"
click node_scripts "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/lib/agent-os/chat-scripts.ts"
click node_memory "https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/lib/agent-os/memory.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_router,node_root,node_user toneBlue
class node_dashboard,node_agents,node_agentdetail,node_chat,node_tasks toneAmber
class node_admin toneMint
class node_store,node_catalogdata,node_scripts,node_memory toneRose
```

## Components

### Workspace & navigation

- [Workspace shell](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/components/os/AppShell.tsx): `src/components/os/AppShell.tsx`
- [Route registry](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routeTree.gen.ts): `src/routeTree.gen.ts`
- [App root](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/__root.tsx): `src/routes/__root.tsx`

### Team operations

- [Team dashboard](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/index.tsx): `src/routes/index.tsx`
- [Agent catalog](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/agents.index.tsx): `src/routes/agents.index.tsx`
- [Agent details](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/agents.%24agentId.tsx): `src/routes/agents.$agentId.tsx`
- [Agent chat](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/chat.tsx): `src/routes/chat.tsx`
- [Team requests](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/tasks.tsx): `src/routes/tasks.tsx`

### AI platform control

- [Admin console](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/routes/admin.tsx): `src/routes/admin.tsx`

### Agent runtime state

- [Shared app state](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/lib/agent-os/store.tsx): `src/lib/agent-os/store.tsx`
- [Teams & agent data](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/lib/agent-os/data.ts): `src/lib/agent-os/data.ts`
- [Chat response scripts](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/lib/agent-os/chat-scripts.ts): `src/lib/agent-os/chat-scripts.ts`
- [Priority builder](https://github.com/sanjaygrabon/canvas-agent-ops/blob/main/src/lib/agent-os/memory.ts): `src/lib/agent-os/memory.ts`

### Other components

- **Team user**

## Connections

- Team user → Workspace shell: uses workspace (evidence: `src/components/os/AppShell.tsx`)
- Workspace shell → Shared app state: reads workspace state (evidence: `src/components/os/AppShell.tsx`)
- Workspace shell → Teams & agent data: reads team config (evidence: `src/components/os/AppShell.tsx`)
- App root → Workspace shell: renders shell (evidence: `src/routes/__root.tsx`)
- App root → Shared app state: provides state (evidence: `src/routes/__root.tsx`)
- Route registry → App root: registers routes (evidence: `src/routeTree.gen.ts`)
- Route registry → Team dashboard: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → Admin console: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → Agent chat: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → Team requests: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → Agent catalog: registers route (evidence: `src/routeTree.gen.ts`)
- Route registry → Agent details: registers route (evidence: `src/routeTree.gen.ts`)
- Team dashboard → Shared app state: reads team state (evidence: `src/routes/index.tsx`)
- Team dashboard → Teams & agent data: renders team metrics (evidence: `src/routes/index.tsx`)
- Agent catalog → Shared app state: reads team agents (evidence: `src/routes/agents.index.tsx`)
- Agent details → Shared app state: reads execution state (evidence: `src/routes/agents.$agentId.tsx`)
- Agent chat → Shared app state: starts conversations (evidence: `src/routes/chat.tsx`)
- Agent chat → Chat response scripts: uses suggestions (evidence: `src/routes/chat.tsx`)
- Team requests → Shared app state: submits requests (evidence: `src/routes/tasks.tsx`)
- Admin console → Shared app state: reviews tickets (evidence: `src/routes/admin.tsx`)
- Admin console → Team requests: renders request status (evidence: `src/routes/admin.tsx`)
- Shared app state → Teams & agent data: loads initial data (evidence: `src/lib/agent-os/store.tsx`)
- Shared app state → Chat response scripts: generates chat replies (evidence: `src/lib/agent-os/store.tsx`)
- Shared app state → Priority builder: builds priorities (evidence: `src/lib/agent-os/store.tsx`)
- Shared app state → Team dashboard: activity informs outcomes (evidence: `README.md`)
- Team requests → Admin console: requests become tickets (evidence: `README.md`)
- Admin console → Shared app state: approval publishes agent (evidence: `README.md`)
- Shared app state → Agent chat: published agent available (evidence: `README.md`)
