# cognizant-ai-labs/agentic-web architecture

> Architecture diagram of the GitHub repository cognizant-ai-labs/agentic-web, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cognizant-ai-labs/agentic-web
- Repository: https://github.com/cognizant-ai-labs/agentic-web

## Overview

This repository is a starter toolkit and browser runtime for creating open agentic websites: websites publish agent-network configuration, and visitors use an embedded browser assistant to run agents, invoke site actions, and connect to remote networks or tools. The graph follows that workflow through runtime boot, configuration loading, agent execution, and presentation/action handling, while retaining the website-authoring skill as a separate capability. Relationships are limited to excerpted imports/calls and README statements; unsampled integrations are not expanded.

Main entry points: [`skills/agentify-website/runtime/runner.js`](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/runner.js) (Agent runner), [`skills/agentify-website/runtime/engine.js`](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/engine.js) (Network loader), [`skills/agentify-website/runtime/action-transport.js`](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/action-transport.js) (Action transport), [`skills/agentify-website/runtime/index.js`](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/index.js) (Runtime boot)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Website authoring"]
  node_authoring_skill["Agentify skill<br/>[SKILL.md]"]
  node_site_templates["Site templates"]
end

subgraph group_boot["Browser runtime"]
  node_runtime_entry["Runtime boot<br/>[index.js]"]
  node_engine["Network loader<br/>[engine.js]"]
  node_remote["Network fetch<br/>[remote.js]"]
  node_hocon["Config parser<br/>[hocon.js]"]
end

subgraph group_execution["Agent execution"]
  node_kernel["Agent network<br/>[kernel.js]"]
  node_runner["Agent runner<br/>[runner.js]"]
  node_model["Model selection<br/>[model.js]"]
  node_llm["LLM client<br/>[llm.js]"]
end

subgraph group_interaction["Visitor interaction"]
  node_ui["Chat and trace UI<br/>[ui.js]"]
  node_byok[("Provider settings<br/>[byok.js]")]
  node_cruse["Structured responses<br/>[cruse.js]"]
  node_cruse_render["Response rendering<br/>[cruse-render.js]"]
end

subgraph group_actions["Site capabilities"]
  node_action_transport["Action transport"]
  node_action_registry["Action registry<br/>[actions.js]"]
  node_form_actions["Form actions<br/>[form-actions.js]"]
  node_discovered_actions["Discovered actions"]
  node_site_actions["Website actions<br/>[site-actions.js]"]
end

node_visitor(("Visitor"))
node_linked_agents{{"Linked networks"}}
node_mcp_tools{{"MCP tools"}}

node_visitor -->|"opens site"| node_runtime_entry
node_authoring_skill -->|"provides templates"| node_site_templates
node_runtime_entry -->|"loads network"| node_engine
node_runtime_entry -->|"mounts interface"| node_ui
node_runtime_entry -->|"loads setup"| node_byok
node_engine -->|"fetches manifests"| node_remote
node_engine -->|"parses config"| node_hocon
node_engine -->|"builds network"| node_kernel
node_engine -->|"runs agent"| node_runner
node_kernel -->|"uses config helpers"| node_hocon
node_runner -->|"classifies tools"| node_kernel
node_runner -->|"checks model"| node_model
node_runner -->|"parses response"| node_cruse
node_runner -->|"delegates remotely"| node_linked_agents
node_runner -->|"calls tools"| node_mcp_tools
node_ui -->|"configures provider"| node_byok
node_ui -->|"renders response"| node_cruse_render
node_visitor -->|"chats with"| node_ui
node_action_transport -->|"registers actions"| node_action_registry
node_action_transport -->|"registers forms"| node_form_actions
node_action_transport -->|"loads catalog"| node_discovered_actions
node_site_actions -->|"registers capabilities"| node_action_transport
node_runner -->|"invokes site actions"| node_action_transport
node_byok -->|"supplies user key"| node_llm
node_llm -->|"normalizes model"| node_model
node_llm -.->|"requests provider output"| node_visitor

click node_authoring_skill "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/SKILL.md"
click node_site_templates "https://github.com/cognizant-ai-labs/agentic-web/tree/main/skills/agentify-website/templates"
click node_runtime_entry "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/index.js"
click node_engine "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/engine.js"
click node_remote "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/remote.js"
click node_hocon "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/hocon.js"
click node_kernel "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/kernel.js"
click node_runner "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/runner.js"
click node_model "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/model.js"
click node_llm "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/llm.js"
click node_ui "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/ui.js"
click node_byok "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/byok.js"
click node_cruse "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/cruse.js"
click node_cruse_render "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/cruse-render.js"
click node_action_transport "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/action-transport.js"
click node_action_registry "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/actions.js"
click node_form_actions "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/form-actions.js"
click node_discovered_actions "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/discovered-actions.js"
click node_site_actions "https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/templates/site-actions.js"

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_authoring_skill,node_site_templates toneBlue
class node_runtime_entry,node_engine,node_remote,node_hocon toneAmber
class node_kernel,node_runner,node_model,node_llm toneMint
class node_ui,node_byok,node_cruse,node_cruse_render toneRose
class node_action_transport,node_action_registry,node_form_actions,node_discovered_actions,node_site_actions,node_visitor,node_linked_agents,node_mcp_tools toneIndigo
```

## Components

### Website authoring

- [Agentify skill](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/SKILL.md): `skills/agentify-website/SKILL.md`
- [Site templates](https://github.com/cognizant-ai-labs/agentic-web/tree/main/skills/agentify-website/templates): `skills/agentify-website/templates`

### Browser runtime

- [Runtime boot](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/index.js): `skills/agentify-website/runtime/index.js`
- [Network loader](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/engine.js): `skills/agentify-website/runtime/engine.js`
- [Network fetch](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/remote.js): `skills/agentify-website/runtime/remote.js`
- [Config parser](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/hocon.js): `skills/agentify-website/runtime/hocon.js`

### Agent execution

- [Agent network](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/kernel.js): `skills/agentify-website/runtime/kernel.js`
- [Agent runner](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/runner.js): `skills/agentify-website/runtime/runner.js`
- [Model selection](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/model.js): `skills/agentify-website/runtime/model.js`
- [LLM client](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/llm.js): `skills/agentify-website/runtime/llm.js`

### Visitor interaction

- [Chat and trace UI](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/ui.js): `skills/agentify-website/runtime/ui.js`
- [Provider settings](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/byok.js): `skills/agentify-website/runtime/byok.js`
- [Structured responses](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/cruse.js): `skills/agentify-website/runtime/cruse.js`
- [Response rendering](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/cruse-render.js): `skills/agentify-website/runtime/cruse-render.js`

### Site capabilities

- [Action transport](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/action-transport.js): `skills/agentify-website/runtime/action-transport.js`
- [Action registry](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/actions.js): `skills/agentify-website/runtime/actions.js`
- [Form actions](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/form-actions.js): `skills/agentify-website/runtime/form-actions.js`
- [Discovered actions](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/runtime/discovered-actions.js): `skills/agentify-website/runtime/discovered-actions.js`
- [Website actions](https://github.com/cognizant-ai-labs/agentic-web/blob/main/skills/agentify-website/templates/site-actions.js): `skills/agentify-website/templates/site-actions.js`

### Other components

- **Visitor**
- **Linked networks**
- **MCP tools**

## Connections

- Visitor → Runtime boot: opens site (evidence: `README.md`)
- Agentify skill → Site templates: provides templates
- Runtime boot → Network loader: loads network (evidence: `skills/agentify-website/runtime/index.js`)
- Runtime boot → Chat and trace UI: mounts interface (evidence: `skills/agentify-website/runtime/index.js`)
- Runtime boot → Provider settings: loads setup (evidence: `skills/agentify-website/runtime/index.js`)
- Network loader → Network fetch: fetches manifests (evidence: `skills/agentify-website/runtime/engine.js`)
- Network loader → Config parser: parses config (evidence: `skills/agentify-website/runtime/engine.js`)
- Network loader → Agent network: builds network (evidence: `skills/agentify-website/runtime/engine.js`)
- Network loader → Agent runner: runs agent (evidence: `skills/agentify-website/runtime/engine.js`)
- Agent network → Config parser: uses config helpers (evidence: `skills/agentify-website/runtime/kernel.js`)
- Agent runner → Agent network: classifies tools (evidence: `skills/agentify-website/runtime/runner.js`)
- Agent runner → Model selection: checks model (evidence: `skills/agentify-website/runtime/runner.js`)
- Agent runner → Structured responses: parses response (evidence: `skills/agentify-website/runtime/runner.js`)
- Agent runner → Linked networks: delegates remotely (evidence: `README.md`)
- Agent runner → MCP tools: calls tools (evidence: `README.md`)
- Chat and trace UI → Provider settings: configures provider (evidence: `skills/agentify-website/runtime/ui.js`)
- Chat and trace UI → Response rendering: renders response (evidence: `skills/agentify-website/runtime/ui.js`)
- Visitor → Chat and trace UI: chats with (evidence: `README.md`)
- Action transport → Action registry: registers actions (evidence: `skills/agentify-website/runtime/action-transport.js`)
- Action transport → Form actions: registers forms (evidence: `skills/agentify-website/runtime/action-transport.js`)
- Action transport → Discovered actions: loads catalog (evidence: `skills/agentify-website/runtime/action-transport.js`)
- Website actions → Action transport: registers capabilities (evidence: `README.md`)
- Agent runner → Action transport: invokes site actions (evidence: `README.md`)
- Provider settings → LLM client: supplies user key (evidence: `README.md`)
- LLM client → Model selection: normalizes model (evidence: `skills/agentify-website/runtime/llm.js`)
- LLM client → Visitor: requests provider output