# vikhyath-thelazycoder/techie-mind-browsing-agent architecture

> Architecture diagram of the GitHub repository vikhyath-thelazycoder/techie-mind-browsing-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vikhyath-thelazycoder/techie-mind-browsing-agent
- Repository: https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent

## Overview

Techie Mind is a privacy-first browser agent delivered as a browser extension, with an optional Supabase service for persistent price and page monitoring. The main flow is user request → task runner → observe and protect page data → authorize and execute browser actions → verify and return a result; uncertain actions can be handed back to the user. The README documents this flow and the product capabilities. Source excerpts and the index support key module relationships, but not every runtime dispatch, so unsampled links are omitted.

Main entry points: [`packages/agent-core/src/runner.ts`](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/agent-core/src/runner.ts) (Task runner), [`apps/backend/supabase/functions/monitor-worker/index.ts`](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/backend/supabase/functions/monitor-worker/index.ts) (Monitor worker), [`apps/extension/src/sidepanel/App.tsx`](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/extension/src/sidepanel/App.tsx) (Side panel), [`apps/extension/src/content/handler.ts`](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/extension/src/content/handler.ts) (Page handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_extension["Browser extension"]
  node_panel["Side panel<br/>[App.tsx]"]
  node_task_port["Task handler<br/>[tasks.ts]"]
  node_content["Page handler<br/>[handler.ts]"]
  node_browser["Browser adapter<br/>[adapter.ts]"]
end

subgraph group_agent["Agent runtime"]
  node_intent["Intent and routing<br/>[router.ts]"]
  node_agent_modules["Agent capabilities"]
  node_runner["Task runner<br/>[runner.ts]"]
end

subgraph group_safety["Safety and perception"]
  node_perception["Page perception"]
  node_firewall["Action firewall<br/>[firewall.ts]"]
  node_privacy["Privacy controls"]
end

subgraph group_services["Models and contracts"]
  node_models["Model intelligence<br/>[intelligence.ts]"]
  node_transport["Model transport<br/>[transport.ts]"]
  node_contracts["Shared contracts"]
  node_config["Settings<br/>[settings.ts]"]
  node_telemetry["Audit and telemetry<br/>[audit.ts]"]
end

subgraph group_monitoring["Persistent monitoring"]
  node_monitor_client["Monitoring client"]
  node_monitor_api["Monitor API<br/>[index.ts]"]
  node_monitor_worker["Monitor worker<br/>[index.ts]"]
  node_monitor_core["Monitor rules<br/>[core.ts]"]
  node_monitor_db["Monitor database access<br/>[db.ts]"]
end

node_user(("User"))
node_supabase[("Supabase")]
node_site["Web page"]
node_model_service["Local or gateway model"]

node_user -->|"requests task"| node_panel
node_panel -->|"submits task"| node_task_port
node_task_port -->|"runs task"| node_runner
node_runner -->|"routes intent"| node_intent
node_runner -->|"uses capabilities"| node_agent_modules
node_runner -->|"observes page"| node_perception
node_runner -->|"scans and redacts"| node_privacy
node_runner -->|"authorizes actions"| node_firewall
node_runner -->|"requests inference"| node_models
node_models -->|"sends model request"| node_transport
node_models -.->|"calls model"| node_model_service
node_runner -->|"dispatches page work"| node_content
node_content -->|"observes and executes"| node_perception
node_content -->|"reads and acts"| node_site
node_runner -->|"uses browser APIs"| node_browser
node_runner -->|"uses task contracts"| node_contracts
node_runner -->|"loads settings"| node_config
node_runner -->|"records audit"| node_telemetry
node_runner -->|"hands over"| node_user
node_runner -->|"returns result"| node_user
node_panel -.->|"manages monitoring"| node_monitor_client
node_monitor_client -->|"calls API"| node_monitor_api
node_monitor_api -->|"uses database access"| node_monitor_db
node_monitor_worker -->|"uses database access"| node_monitor_db
node_monitor_worker -->|"evaluates monitors"| node_monitor_core
node_monitor_api -->|"serves requests"| node_supabase
node_monitor_worker -->|"runs scheduled checks"| node_supabase
node_monitor_db -.->|"reads and writes"| node_supabase

click node_panel "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/extension/src/sidepanel/App.tsx"
click node_task_port "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/extension/src/background/tasks.ts"
click node_content "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/extension/src/content/handler.ts"
click node_browser "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/browser/src/adapter.ts"
click node_intent "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/agent-core/src/router.ts"
click node_agent_modules "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/tree/main/packages/agent-core/src"
click node_runner "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/agent-core/src/runner.ts"
click node_perception "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/tree/main/packages/perception/src"
click node_firewall "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/security/src/firewall.ts"
click node_privacy "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/tree/main/packages/privacy/src"
click node_models "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/models/src/intelligence.ts"
click node_transport "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/models/src/transport.ts"
click node_contracts "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/tree/main/packages/contracts/src"
click node_config "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/config/src/settings.ts"
click node_telemetry "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/telemetry/src/audit.ts"
click node_monitor_client "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/extension/src/shared/monitoring-client.ts"
click node_monitor_api "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/backend/supabase/functions/monitor-api/index.ts"
click node_monitor_worker "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/backend/supabase/functions/monitor-worker/index.ts"
click node_monitor_core "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/backend/supabase/functions/_shared/core.ts"
click node_monitor_db "https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/backend/supabase/functions/_shared/db.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_panel,node_task_port,node_content,node_browser,node_user toneBlue
class node_intent,node_agent_modules,node_runner,node_supabase toneAmber
class node_perception,node_firewall,node_privacy toneMint
class node_models,node_transport,node_contracts,node_config,node_telemetry toneRose
class node_monitor_client,node_monitor_api,node_monitor_worker,node_monitor_core,node_monitor_db,node_site,node_model_service toneIndigo
```

## Components

### Browser extension

- [Side panel](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/extension/src/sidepanel/App.tsx): `apps/extension/src/sidepanel/App.tsx`
- [Task handler](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/extension/src/background/tasks.ts): `apps/extension/src/background/tasks.ts`
- [Page handler](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/extension/src/content/handler.ts): `apps/extension/src/content/handler.ts`
- [Browser adapter](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/browser/src/adapter.ts): `packages/browser/src/adapter.ts`

### Agent runtime

- [Intent and routing](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/agent-core/src/router.ts): `packages/agent-core/src/router.ts`
- [Agent capabilities](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/tree/main/packages/agent-core/src): `packages/agent-core/src`
- [Task runner](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/agent-core/src/runner.ts): `packages/agent-core/src/runner.ts`

### Safety and perception

- [Page perception](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/tree/main/packages/perception/src): `packages/perception/src`
- [Action firewall](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/security/src/firewall.ts): `packages/security/src/firewall.ts`
- [Privacy controls](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/tree/main/packages/privacy/src): `packages/privacy/src`

### Models and contracts

- [Model intelligence](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/models/src/intelligence.ts): `packages/models/src/intelligence.ts`
- [Model transport](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/models/src/transport.ts): `packages/models/src/transport.ts`
- [Shared contracts](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/tree/main/packages/contracts/src): `packages/contracts/src`
- [Settings](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/config/src/settings.ts): `packages/config/src/settings.ts`
- [Audit and telemetry](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/packages/telemetry/src/audit.ts): `packages/telemetry/src/audit.ts`

### Persistent monitoring

- [Monitoring client](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/extension/src/shared/monitoring-client.ts): `apps/extension/src/shared/monitoring-client.ts`
- [Monitor API](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/backend/supabase/functions/monitor-api/index.ts): `apps/backend/supabase/functions/monitor-api/index.ts`
- [Monitor worker](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/backend/supabase/functions/monitor-worker/index.ts): `apps/backend/supabase/functions/monitor-worker/index.ts`
- [Monitor rules](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/backend/supabase/functions/_shared/core.ts): `apps/backend/supabase/functions/_shared/core.ts`
- [Monitor database access](https://github.com/vikhyath-thelazycoder/techie-mind-browsing-agent/blob/main/apps/backend/supabase/functions/_shared/db.ts): `apps/backend/supabase/functions/_shared/db.ts`

### Other components

- **User**
- **Supabase**
- **Web page**
- **Local or gateway model**

## Connections

- User → Side panel: requests task (evidence: `README.md`)
- Side panel → Task handler: submits task (evidence: `apps/extension/src/sidepanel/App.tsx`)
- Task handler → Task runner: runs task (evidence: `apps/extension/src/background/tasks.ts`)
- Task runner → Intent and routing: routes intent (evidence: `packages/agent-core/src/runner.ts`)
- Task runner → Agent capabilities: uses capabilities (evidence: `packages/agent-core/src/runner.ts`)
- Task runner → Page perception: observes page (evidence: `README.md`)
- Task runner → Privacy controls: scans and redacts (evidence: `README.md`)
- Task runner → Action firewall: authorizes actions (evidence: `README.md`)
- Task runner → Model intelligence: requests inference (evidence: `README.md`)
- Model intelligence → Model transport: sends model request (evidence: `packages/models/src/intelligence.ts`)
- Model intelligence → Local or gateway model: calls model (evidence: `README.md`)
- Task runner → Page handler: dispatches page work (evidence: `README.md`)
- Page handler → Page perception: observes and executes (evidence: `apps/extension/src/content/handler.ts`)
- Page handler → Web page: reads and acts (evidence: `apps/extension/src/content/handler.ts`)
- Task runner → Browser adapter: uses browser APIs
- Task runner → Shared contracts: uses task contracts (evidence: `packages/agent-core/src/runner.ts`)
- Task runner → Settings: loads settings (evidence: `packages/agent-core/src/runner.ts`)
- Task runner → Audit and telemetry: records audit (evidence: `packages/agent-core/src/runner.ts`)
- Task runner → User: hands over (evidence: `README.md`)
- Task runner → User: returns result (evidence: `README.md`)
- Side panel → Monitoring client: manages monitoring
- Monitoring client → Monitor API: calls API (evidence: `apps/extension/src/shared/monitoring-client.ts`)
- Monitor API → Monitor database access: uses database access (evidence: `apps/backend/supabase/functions/monitor-api/index.ts`)
- Monitor worker → Monitor database access: uses database access (evidence: `apps/backend/supabase/functions/monitor-worker/index.ts`)
- Monitor worker → Monitor rules: evaluates monitors (evidence: `apps/backend/supabase/functions/monitor-worker/index.ts`)
- Monitor API → Supabase: serves requests (evidence: `README.md`)
- Monitor worker → Supabase: runs scheduled checks (evidence: `README.md`)
- Monitor database access → Supabase: reads and writes
