# srivishnugv-dev/agentix architecture

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

- Interactive diagram: https://gitdiagram.com/srivishnugv-dev/agentix
- Repository: https://github.com/srivishnugv-dev/agentix

## Overview

AgentIX is trust and authorization infrastructure for autonomous agents. Its primary documented workflow starts with an MCP client managing an agent; the runtime also accepts REST intents, compiles them into execution plans, applies policy and risk checks, and supports session- and wallet-based on-chain execution. The repository includes both the AgentIX runtime and a separate backend/frontend control plane. The README documents the major product capabilities; source excerpts establish only some internal calls, so uncertain subsystem links are omitted or marked unverified.

Main entry points: [`agentix/src/compiler-gateway.ts`](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/compiler-gateway.ts) (Compiler gateway), [`agentix/packages/compiler/pipeline/index.ts`](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/compiler/pipeline/index.ts) (Compiler pipeline), [`agentix/src/core/database.ts`](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/core/database.ts) (Runtime database), [`agentix/src/runtime/server.ts`](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/runtime/server.ts) (REST runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Agent interfaces"]
  node_mcp["MCP server<br/>[server.ts]"]
  node_rest["REST runtime<br/>[server.ts]"]
  node_dashboard["Operator dashboard<br/>[page.tsx]"]
end

subgraph group_control["Runtime control"]
  node_gateway["Compiler gateway"]
  node_config["Runtime configuration<br/>[config.ts]"]
  node_db[("Runtime database<br/>[database.ts]")]
  node_policy["Owner policy<br/>[owner-policy.ts]"]
  node_provider["Chain provider<br/>[provider.ts]"]
end

subgraph group_compile["Intent compilation"]
  node_compiler["Compiler pipeline<br/>[index.ts]"]
  node_intent["Intent parsing"]
  node_plugins["Plugin registry<br/>[registry.ts]"]
  node_risk["Risk assessment<br/>[engine.ts]"]
  node_types["Compilation types<br/>[compilation.ts]"]
end

subgraph group_trust["Trust and chain"]
  node_services["Agent services"]
  node_wallet["Wallet execution<br/>[bundler.ts]"]
  node_contracts{{"Protocol contracts"}}
  node_zk["Proof services<br/>[index.ts]"]
end

subgraph group_operations["Platform operations"]
  node_backend["Backend API<br/>[index.ts]"]
  node_frontend["Platform frontend<br/>[page.tsx]"]
  node_indexer["Event indexer<br/>[event-indexer.ts]"]
  node_backup["Backup engine<br/>[index.ts]"]
  node_fund["Funding tool<br/>[fund.ts]"]
  node_wizard["Setup wizard<br/>[wizard.ts]"]
end

node_agent(("MCP client"))

node_agent -->|"sends requests"| node_mcp
node_mcp -->|"manages agents"| node_services
node_rest -->|"compiles intents"| node_gateway
node_gateway -->|"submits intents"| node_compiler
node_gateway -->|"loads addresses"| node_config
node_gateway -->|"checks policy"| node_policy
node_gateway -->|"records execution"| node_db
node_compiler -->|"uses types"| node_types
node_compiler -->|"creates registry"| node_plugins
node_compiler -->|"exposes parsing"| node_intent
node_risk -->|"assesses rules"| node_plugins
node_rest -->|"serves trust APIs"| node_services
node_wallet -.->|"executes on-chain"| node_contracts
node_zk -.->|"verifies proofs"| node_contracts
node_backend -.->|"serves platform"| node_frontend
node_indexer -.->|"stores events"| node_db
node_backup -->|"backs up data"| node_db
node_fund -.->|"funds wallets"| node_provider
node_wizard -.->|"sets up runtime"| node_config
node_dashboard -.->|"uses platform API"| node_backend

click node_mcp "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/mcp/server.ts"
click node_rest "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/runtime/server.ts"
click node_dashboard "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/apps/dashboard/src/app/page.tsx"
click node_gateway "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/compiler-gateway.ts"
click node_config "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/core/config.ts"
click node_db "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/core/database.ts"
click node_policy "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/core/owner-policy.ts"
click node_provider "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/core/provider.ts"
click node_compiler "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/compiler/pipeline/index.ts"
click node_intent "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/compiler/pipeline/nl-intent-parser.ts"
click node_plugins "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/compiler/plugins/registry.ts"
click node_risk "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/compiler/risk/engine.ts"
click node_types "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/compiler/types/compilation.ts"
click node_services "https://github.com/srivishnugv-dev/agentix/tree/main/agentix/packages/services"
click node_wallet "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/runtime/bundler.ts"
click node_contracts "https://github.com/srivishnugv-dev/agentix/tree/main/contracts"
click node_zk "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/services/proof-service/index.ts"
click node_backend "https://github.com/srivishnugv-dev/agentix/blob/main/backend/src/index.ts"
click node_frontend "https://github.com/srivishnugv-dev/agentix/blob/main/frontend/app/dashboard/page.tsx"
click node_indexer "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/core/event-indexer.ts"
click node_backup "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/core/backup-engine/index.ts"
click node_fund "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/tools/fund.ts"
click node_wizard "https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/tools/wizard.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_mcp,node_rest,node_dashboard,node_agent toneBlue
class node_gateway,node_config,node_db,node_policy,node_provider toneAmber
class node_compiler,node_intent,node_plugins,node_risk,node_types toneMint
class node_services,node_wallet,node_contracts,node_zk toneRose
class node_backend,node_frontend,node_indexer,node_backup,node_fund,node_wizard toneIndigo
```

## Components

### Agent interfaces

- [MCP server](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/mcp/server.ts): `agentix/src/mcp/server.ts`
- [REST runtime](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/runtime/server.ts): `agentix/src/runtime/server.ts`
- [Operator dashboard](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/apps/dashboard/src/app/page.tsx): `agentix/apps/dashboard/src/app/page.tsx`

### Runtime control

- [Compiler gateway](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/compiler-gateway.ts): `agentix/src/compiler-gateway.ts`
- [Runtime configuration](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/core/config.ts): `agentix/src/core/config.ts`
- [Runtime database](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/core/database.ts): `agentix/src/core/database.ts`
- [Owner policy](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/core/owner-policy.ts): `agentix/src/core/owner-policy.ts`
- [Chain provider](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/core/provider.ts): `agentix/src/core/provider.ts`

### Intent compilation

- [Compiler pipeline](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/compiler/pipeline/index.ts): `agentix/packages/compiler/pipeline/index.ts`
- [Intent parsing](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/compiler/pipeline/nl-intent-parser.ts): `agentix/packages/compiler/pipeline/nl-intent-parser.ts`
- [Plugin registry](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/compiler/plugins/registry.ts): `agentix/packages/compiler/plugins/registry.ts`
- [Risk assessment](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/compiler/risk/engine.ts): `agentix/packages/compiler/risk/engine.ts`
- [Compilation types](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/compiler/types/compilation.ts): `agentix/packages/compiler/types/compilation.ts`

### Trust and chain

- [Agent services](https://github.com/srivishnugv-dev/agentix/tree/main/agentix/packages/services): `agentix/packages/services`
- [Wallet execution](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/runtime/bundler.ts): `agentix/src/runtime/bundler.ts`
- [Protocol contracts](https://github.com/srivishnugv-dev/agentix/tree/main/contracts): `contracts`
- [Proof services](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/services/proof-service/index.ts): `agentix/packages/services/proof-service/index.ts`

### Platform operations

- [Backend API](https://github.com/srivishnugv-dev/agentix/blob/main/backend/src/index.ts): `backend/src/index.ts`
- [Platform frontend](https://github.com/srivishnugv-dev/agentix/blob/main/frontend/app/dashboard/page.tsx): `frontend/app/dashboard/page.tsx`
- [Event indexer](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/core/event-indexer.ts): `agentix/src/core/event-indexer.ts`
- [Backup engine](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/packages/core/backup-engine/index.ts): `agentix/packages/core/backup-engine/index.ts`
- [Funding tool](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/tools/fund.ts): `agentix/src/tools/fund.ts`
- [Setup wizard](https://github.com/srivishnugv-dev/agentix/blob/main/agentix/src/tools/wizard.ts): `agentix/src/tools/wizard.ts`

### Other components

- **MCP client**

## Connections

- MCP client → MCP server: sends requests (evidence: `README.md`)
- MCP server → Agent services: manages agents (evidence: `agentix/src/mcp/server.ts`)
- REST runtime → Compiler gateway: compiles intents (evidence: `agentix/src/runtime/server.ts`)
- Compiler gateway → Compiler pipeline: submits intents (evidence: `agentix/src/compiler-gateway.ts`)
- Compiler gateway → Runtime configuration: loads addresses (evidence: `agentix/src/compiler-gateway.ts`)
- Compiler gateway → Owner policy: checks policy (evidence: `agentix/src/compiler-gateway.ts`)
- Compiler gateway → Runtime database: records execution (evidence: `agentix/src/compiler-gateway.ts`)
- Compiler pipeline → Compilation types: uses types (evidence: `agentix/packages/compiler/index.ts`)
- Compiler pipeline → Plugin registry: creates registry (evidence: `agentix/packages/compiler/index.ts`)
- Compiler pipeline → Intent parsing: exposes parsing (evidence: `agentix/packages/compiler/index.ts`)
- Risk assessment → Plugin registry: assesses rules (evidence: `agentix/packages/compiler/risk/engine.ts`)
- REST runtime → Agent services: serves trust APIs (evidence: `agentix/src/runtime/server.ts`)
- Wallet execution → Protocol contracts: executes on-chain (evidence: `README.md`)
- Proof services → Protocol contracts: verifies proofs (evidence: `README.md`)
- Backend API → Platform frontend: serves platform (evidence: `README.md`)
- Event indexer → Runtime database: stores events (evidence: `README.md`)
- Backup engine → Runtime database: backs up data (evidence: `agentix/packages/core/backup-engine/index.ts`)
- Funding tool → Chain provider: funds wallets
- Setup wizard → Runtime configuration: sets up runtime
- Operator dashboard → Backend API: uses platform API
