# agen-mesh/wailist-agentmesh architecture

> Architecture diagram of the GitHub repository agen-mesh/wailist-agentmesh, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/agen-mesh/wailist-agentmesh
- Repository: https://github.com/agen-mesh/wailist-agentmesh

## Overview

AgentMesh is a visual platform for creating and running autonomous agent workflows. Users configure agents and tools in the canvas, deploy and fund agent wallets, then run workflows and watch streamed progress and results. The backend exposes authenticated workflow APIs and executes runs through an agent engine; separate product areas cover paid API discovery and settlement, connector authorization, billing, and compute. The README documents several capabilities whose implementation was not sampled, so those branches are represented at their supported directory paths; edges are limited to documented or indexed relationships.

Main entry points: [`backend/internal/engine/nodes`](https://github.com/agen-mesh/wailist-agentmesh/tree/master/backend/internal/engine/nodes) (Tool connectors), [`backend/internal/api/router.go`](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/api/router.go) (HTTP router), [`backend/internal/engine/runner.go`](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/engine/runner.go) (Agent engine), [`frontend/src/components/canvas/CanvasPage.tsx`](https://github.com/agen-mesh/wailist-agentmesh/blob/master/frontend/src/components/canvas/CanvasPage.tsx) (Workflow canvas)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_author["Workflow authoring"]
  node_canvas["Workflow canvas<br/>[CanvasPage.tsx]"]
  node_chat["Build chat<br/>[useChatSession.ts]"]
  node_workflow_api["Workflow API"]
end

subgraph group_runtime["Run execution"]
  node_engine["Agent engine<br/>[runner.go]"]
  node_connectors["Tool connectors"]
  node_transcript["Run transcript"]
end

subgraph group_commerce["Payments and discovery"]
  node_wallet["Algorand wallet<br/>[algorand.go]"]
  node_x402["x402 payments<br/>[facilitator.go]"]
  node_bazaar["Paid API Bazaar<br/>[search.go]"]
  node_billing["Credit billing"]
  node_checkout["Credit checkout"]
end

subgraph group_account["Accounts and integrations"]
  node_auth["Authentication<br/>[auth.go]"]
  node_connector_oauth["Connector OAuth<br/>[connector_oauth.go]"]
  node_oauth_credentials["OAuth credentials<br/>[oauthcred.go]"]
end

subgraph group_platform["Platform services"]
  node_router["HTTP router<br/>[router.go]"]
  node_run_store[("Run and workflow data")]
  node_chat_store[("Chat sessions<br/>[chat_sessions.go]")]
  node_stream["Live run events<br/>[broker.go]"]
  node_scheduling["Scheduled runs<br/>[scheduler.go]"]
  node_tendril["Tendril compute<br/>[client.go]"]
  node_mobile["Native app plugins<br/>[MainActivity.java]"]
end

node_user(("User"))

node_user -->|"builds workflows"| node_canvas
node_canvas -.->|"edits with chat"| node_chat
node_canvas -.->|"configures workflows"| node_workflow_api
node_workflow_api -->|"routes through"| node_router
node_router -->|"routes auth"| node_auth
node_router -->|"routes OAuth"| node_connector_oauth
node_router -->|"routes workflow requests"| node_workflow_api
node_chat -->|"persists transcript"| node_chat_store
node_engine -->|"executes tools"| node_connectors
node_engine -.->|"records runs"| node_run_store
node_engine -.->|"streams progress"| node_stream
node_transcript -.->|"receives events"| node_stream
node_transcript -->|"polls run details"| node_run_store
node_connectors -->|"gets access tokens"| node_oauth_credentials
node_connectors -.->|"signs payments"| node_wallet
node_connectors -.->|"pays gated APIs"| node_x402
node_bazaar -.->|"adds APIs"| node_canvas
node_checkout -->|"loads providers"| node_billing
node_scheduling -->|"starts workflows"| node_engine
node_tendril -.->|"provides rented compute"| node_user
node_mobile -.->|"enables native features"| node_user

click node_canvas "https://github.com/agen-mesh/wailist-agentmesh/blob/master/frontend/src/components/canvas/CanvasPage.tsx"
click node_chat "https://github.com/agen-mesh/wailist-agentmesh/blob/master/frontend/src/components/canvas/chat/useChatSession.ts"
click node_workflow_api "https://github.com/agen-mesh/wailist-agentmesh/tree/master/backend/internal/api/handlers"
click node_router "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/api/router.go"
click node_engine "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/engine/runner.go"
click node_connectors "https://github.com/agen-mesh/wailist-agentmesh/tree/master/backend/internal/engine/nodes"
click node_wallet "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/wallet/algorand.go"
click node_x402 "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/x402/facilitator.go"
click node_bazaar "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/bazaar/search.go"
click node_transcript "https://github.com/agen-mesh/wailist-agentmesh/blob/master/frontend/src/components/canvas/useRunTranscript.ts"
click node_run_store "https://github.com/agen-mesh/wailist-agentmesh/tree/master/backend/internal/db"
click node_chat_store "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/db/chat_sessions.go"
click node_stream "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/sse/broker.go"
click node_auth "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/api/handlers/auth.go"
click node_connector_oauth "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/api/handlers/connector_oauth.go"
click node_oauth_credentials "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/oauthcred/oauthcred.go"
click node_billing "https://github.com/agen-mesh/wailist-agentmesh/tree/master/backend/internal/payments"
click node_checkout "https://github.com/agen-mesh/wailist-agentmesh/blob/master/frontend/src/components/checkout/paymentProviders.ts"
click node_scheduling "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/scheduler/scheduler.go"
click node_tendril "https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/tendril/client.go"
click node_mobile "https://github.com/agen-mesh/wailist-agentmesh/blob/master/mobile/android/app/src/main/java/ai/agentmesh/app/MainActivity.java"

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_canvas,node_chat,node_workflow_api,node_user toneBlue
class node_engine,node_connectors,node_transcript toneAmber
class node_wallet,node_x402,node_bazaar,node_billing,node_checkout toneMint
class node_auth,node_connector_oauth,node_oauth_credentials toneRose
class node_router,node_run_store,node_chat_store,node_stream,node_scheduling,node_tendril,node_mobile toneIndigo
```

## Components

### Workflow authoring

- [Workflow canvas](https://github.com/agen-mesh/wailist-agentmesh/blob/master/frontend/src/components/canvas/CanvasPage.tsx): `frontend/src/components/canvas/CanvasPage.tsx`
- [Build chat](https://github.com/agen-mesh/wailist-agentmesh/blob/master/frontend/src/components/canvas/chat/useChatSession.ts): `frontend/src/components/canvas/chat/useChatSession.ts`
- [Workflow API](https://github.com/agen-mesh/wailist-agentmesh/tree/master/backend/internal/api/handlers): `backend/internal/api/handlers`

### Run execution

- [Agent engine](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/engine/runner.go): `backend/internal/engine/runner.go`
- [Tool connectors](https://github.com/agen-mesh/wailist-agentmesh/tree/master/backend/internal/engine/nodes): `backend/internal/engine/nodes`
- [Run transcript](https://github.com/agen-mesh/wailist-agentmesh/blob/master/frontend/src/components/canvas/useRunTranscript.ts): `frontend/src/components/canvas/useRunTranscript.ts`

### Payments and discovery

- [Algorand wallet](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/wallet/algorand.go): `backend/internal/wallet/algorand.go`
- [x402 payments](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/x402/facilitator.go): `backend/internal/x402/facilitator.go`
- [Paid API Bazaar](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/bazaar/search.go): `backend/internal/bazaar/search.go`
- [Credit billing](https://github.com/agen-mesh/wailist-agentmesh/tree/master/backend/internal/payments): `backend/internal/payments`
- [Credit checkout](https://github.com/agen-mesh/wailist-agentmesh/blob/master/frontend/src/components/checkout/paymentProviders.ts): `frontend/src/components/checkout/paymentProviders.ts`

### Accounts and integrations

- [Authentication](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/api/handlers/auth.go): `backend/internal/api/handlers/auth.go`
- [Connector OAuth](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/api/handlers/connector_oauth.go): `backend/internal/api/handlers/connector_oauth.go`
- [OAuth credentials](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/oauthcred/oauthcred.go): `backend/internal/oauthcred/oauthcred.go`

### Platform services

- [HTTP router](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/api/router.go): `backend/internal/api/router.go`
- [Run and workflow data](https://github.com/agen-mesh/wailist-agentmesh/tree/master/backend/internal/db): `backend/internal/db`
- [Chat sessions](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/db/chat_sessions.go): `backend/internal/db/chat_sessions.go`
- [Live run events](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/sse/broker.go): `backend/internal/sse/broker.go`
- [Scheduled runs](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/scheduler/scheduler.go): `backend/internal/scheduler/scheduler.go`
- [Tendril compute](https://github.com/agen-mesh/wailist-agentmesh/blob/master/backend/internal/tendril/client.go): `backend/internal/tendril/client.go`
- [Native app plugins](https://github.com/agen-mesh/wailist-agentmesh/blob/master/mobile/android/app/src/main/java/ai/agentmesh/app/MainActivity.java): `mobile/android/app/src/main/java/ai/agentmesh/app/MainActivity.java`

### Other components

- **User**

## Connections

- User → Workflow canvas: builds workflows
- Workflow canvas → Build chat: edits with chat
- Workflow canvas → Workflow API: configures workflows
- Workflow API → HTTP router: routes through (evidence: `backend/internal/api/router.go`)
- HTTP router → Authentication: routes auth (evidence: `backend/internal/api/router.go`)
- HTTP router → Connector OAuth: routes OAuth (evidence: `backend/internal/api/router.go`)
- HTTP router → Workflow API: routes workflow requests (evidence: `backend/internal/api/router.go`)
- Build chat → Chat sessions: persists transcript (evidence: `frontend/src/components/canvas/chat/useChatSession.ts`)
- Agent engine → Tool connectors: executes tools
- Agent engine → Run and workflow data: records runs
- Agent engine → Live run events: streams progress
- Run transcript → Live run events: receives events
- Run transcript → Run and workflow data: polls run details (evidence: `frontend/src/components/canvas/useRunTranscript.ts`)
- Tool connectors → OAuth credentials: gets access tokens (evidence: `backend/internal/oauthcred/oauthcred.go`)
- Tool connectors → Algorand wallet: signs payments
- Tool connectors → x402 payments: pays gated APIs
- Paid API Bazaar → Workflow canvas: adds APIs
- Credit checkout → Credit billing: loads providers
- Scheduled runs → Agent engine: starts workflows
- Tendril compute → User: provides rented compute
- Native app plugins → User: enables native features (evidence: `mobile/android/app/src/main/java/ai/agentmesh/app/MainActivity.java`)
