refarch.json

{
  "nodes": [
    {
      "unique-id": "user",
      "node-type": "actor",
      "name": "User",
      "description": "End user or automated process initiating requests to the multi-agent system"
    },
    {
      "unique-id": "application",
      "node-type": "webclient",
      "name": "Application",
      "description": "Web/mobile/chatbot interface receiving user inputs and returning agent responses; implements human-in-the-loop controls"
    },
    {
      "unique-id": "agent-registry",
      "node-type": "service",
      "name": "Agent Registry",
      "description": "Catalog of available agents, their capabilities, metadata, versioning, and lifecycle management"
    },
    {
      "unique-id": "agent-gateway",
      "node-type": "ai:api-gateway",
      "name": "Agent Gateway",
      "description": "Routes requests from the application to appropriate agents; validates inputs and enforces routing rules"
    },
    {
      "unique-id": "gateway-guardrails",
      "node-type": "ai:guardrail",
      "name": "Gateway Guardrails",
      "description": "Zero-trust enforcement: authentication, authorization, input validation, content filtering, and rate limits on all incoming requests"
    },
    {
      "unique-id": "orchestrator",
      "node-type": "ai:orchestrator",
      "name": "Orchestrator",
      "description": "Supervisor agent decomposing complex tasks and coordinating worker agents via supervisor/worker, skills-based routing, and agent-as-tool patterns"
    },
    {
      "unique-id": "agent-runtime",
      "node-type": "ai:agent",
      "name": "Unified Agent Runtime",
      "description": "Secure sandboxed environment for agentic reasoning and task execution; provides state management, secure tool execution, collaboration, and adaptive learning"
    },
    {
      "unique-id": "agent-memory-short",
      "node-type": "ai:memory",
      "name": "Short-Term Memory",
      "description": "In-session context manager employing trimming and summarization to manage active reasoning loop context length, cost, and latency"
    },
    {
      "unique-id": "agent-memory-long",
      "node-type": "ai:memory",
      "name": "Long-Term Memory",
      "description": "Durable cross-session memory storing session summaries and user/task personalization data for continuity across interactions"
    },
    {
      "unique-id": "agent-tools",
      "node-type": "ai:tool",
      "name": "Tools Layer",
      "description": "Built-in trusted tools: MCP client bridge, sandboxed shell, I/O for workspace file system, and web search"
    },
    {
      "unique-id": "knowledge-base",
      "node-type": "ai:knowledge-base",
      "name": "Knowledge Base",
      "description": "Internal and external document repositories providing structured and unstructured grounding data for agent reasoning"
    },
    {
      "unique-id": "vector-store",
      "node-type": "ai:vector-store",
      "name": "Vector Store",
      "description": "Vector database providing semantic search and grounding over large text corpora"
    },
    {
      "unique-id": "llm-gateway",
      "node-type": "ai:api-gateway",
      "name": "LLM Gateway",
      "description": "Controlled interface routing inference requests to approved models; enforces model-level policies and standardizes access"
    },
    {
      "unique-id": "llm-guardrails",
      "node-type": "ai:guardrail",
      "name": "LLM Guardrails",
      "description": "Zero-trust model for LLM interactions: prompt injection prevention, output filtering, access control, and cost management policies"
    },
    {
      "unique-id": "llm",
      "node-type": "ai:llm",
      "name": "Foundation Model",
      "description": "Registry of approved foundation models and inference endpoints, accessed exclusively through the LLM Gateway"
    },
    {
      "unique-id": "mcp-gateway",
      "node-type": "ai:mcp-server",
      "name": "MCP Gateway",
      "description": "Controlled gateway for approved MCP servers; routes agent MCP connection requests and enforces MCP protocol constraints"
    },
    {
      "unique-id": "mcp-guardrails",
      "node-type": "ai:guardrail",
      "name": "MCP Guardrails",
      "description": "Zero-trust policies governing agent MCP connections: authentication, tool call parameter validation, and rate limits"
    },
    {
      "unique-id": "feedback-engine",
      "node-type": "ai:eval-monitor",
      "name": "Feedback Engine",
      "description": "Collects structured and unstructured feedback signals from users, evaluators, and automated systems to inform agent improvement"
    },
    {
      "unique-id": "human-supervision",
      "node-type": "ai:human-in-the-loop",
      "name": "Human Supervision",
      "description": "Mechanisms for human reviewers to inspect, approve, correct, or override agent outputs for compliance and risk mitigation"
    },
    {
      "unique-id": "runtime-protection",
      "node-type": "ai:guardrail",
      "name": "Runtime Protection",
      "description": "Monitors agent actions and model outputs during execution to detect unsafe, non-compliant, or anomalous behavior"
    },
    {
      "unique-id": "observability",
      "node-type": "ai:observability",
      "name": "Observability",
      "description": "Collects logs, traces, metrics, events, and anomaly signals from all layers; correlation engine provides unified end-to-end system visibility"
    }
  ],
  "relationships": [
    {
      "unique-id": "user-to-app",
      "relationship-type": "interacts",
      "source": "user",
      "destination": "application",
      "description": "User initiates requests and reviews agent outputs via the application"
    },
    {
      "unique-id": "app-to-gateway",
      "relationship-type": "connects",
      "source": "application",
      "destination": "agent-gateway",
      "protocol": "HTTPS",
      "description": "Application forwards user requests to the agent gateway"
    },
    {
      "unique-id": "gateway-to-registry",
      "relationship-type": "connects",
      "source": "agent-gateway",
      "destination": "agent-registry",
      "protocol": "HTTPS",
      "description": "Gateway queries agent registry to identify target agents for routing"
    },
    {
      "unique-id": "gateway-composed-of-guardrails",
      "relationship-type": "composed-of",
      "source": "agent-gateway",
      "destination": "gateway-guardrails",
      "description": "Agent gateway is composed of guardrails and policies for zero-trust enforcement"
    },
    {
      "unique-id": "gateway-to-orchestrator",
      "relationship-type": "connects",
      "source": "agent-gateway",
      "destination": "orchestrator",
      "protocol": "HTTPS",
      "description": "Gateway routes validated requests to the orchestrator"
    },
    {
      "unique-id": "orchestrator-to-runtime",
      "relationship-type": "connects",
      "source": "orchestrator",
      "destination": "agent-runtime",
      "description": "Orchestrator decomposes tasks and dispatches work to agent runtimes"
    },
    {
      "unique-id": "runtime-composed-of-tools",
      "relationship-type": "composed-of",
      "source": "agent-runtime",
      "destination": "agent-tools",
      "description": "Agent runtime contains the built-in tools layer"
    },
    {
      "unique-id": "runtime-composed-of-short-memory",
      "relationship-type": "composed-of",
      "source": "agent-runtime",
      "destination": "agent-memory-short",
      "description": "Agent runtime contains in-session short-term memory"
    },
    {
      "unique-id": "runtime-to-long-memory",
      "relationship-type": "connects",
      "source": "agent-runtime",
      "destination": "agent-memory-long",
      "description": "Agent runtime reads and writes durable long-term memory across sessions"
    },
    {
      "unique-id": "runtime-to-knowledge",
      "relationship-type": "connects",
      "source": "agent-runtime",
      "destination": "knowledge-base",
      "protocol": "HTTPS",
      "description": "Agent queries knowledge base for grounding information during task execution"
    },
    {
      "unique-id": "runtime-to-vector",
      "relationship-type": "connects",
      "source": "agent-runtime",
      "destination": "vector-store",
      "protocol": "HTTPS",
      "description": "Agent performs semantic retrieval from vector store for grounding"
    },
    {
      "unique-id": "runtime-to-llm-gateway",
      "relationship-type": "connects",
      "source": "agent-runtime",
      "destination": "llm-gateway",
      "protocol": "HTTPS",
      "description": "Agent submits inference requests through the LLM gateway"
    },
    {
      "unique-id": "llm-gateway-composed-of-guardrails",
      "relationship-type": "composed-of",
      "source": "llm-gateway",
      "destination": "llm-guardrails",
      "description": "LLM gateway is composed of guardrails enforcing zero-trust for model interactions"
    },
    {
      "unique-id": "llm-gateway-to-llm",
      "relationship-type": "connects",
      "source": "llm-gateway",
      "destination": "llm",
      "protocol": "HTTPS",
      "description": "LLM gateway routes validated inference requests to approved foundation models"
    },
    {
      "unique-id": "tools-to-mcp-gateway",
      "relationship-type": "connects",
      "source": "agent-tools",
      "destination": "mcp-gateway",
      "protocol": "HTTPS",
      "description": "MCP client in tools layer bridges agent runtime to the external MCP gateway"
    },
    {
      "unique-id": "mcp-gateway-composed-of-guardrails",
      "relationship-type": "composed-of",
      "source": "mcp-gateway",
      "destination": "mcp-guardrails",
      "description": "MCP gateway is composed of guardrails enforcing zero-trust for MCP protocol interactions"
    },
    {
      "unique-id": "feedback-to-runtime",
      "relationship-type": "connects",
      "source": "feedback-engine",
      "destination": "agent-runtime",
      "description": "Feedback engine feeds evaluation signals back to agent runtime for adaptive learning"
    },
    {
      "unique-id": "human-to-orchestrator",
      "relationship-type": "connects",
      "source": "human-supervision",
      "destination": "orchestrator",
      "description": "Human supervisors inspect, approve, or override orchestrator decisions for compliance"
    },
    {
      "unique-id": "protection-to-runtime",
      "relationship-type": "connects",
      "source": "runtime-protection",
      "destination": "agent-runtime",
      "description": "Runtime protection monitors agent execution for unsafe or non-compliant behavior"
    },
    {
      "unique-id": "app-to-obs",
      "relationship-type": "connects",
      "source": "application",
      "destination": "observability",
      "description": "Application emits interaction logs and session events"
    },
    {
      "unique-id": "gateway-to-obs",
      "relationship-type": "connects",
      "source": "agent-gateway",
      "destination": "observability",
      "description": "Agent gateway emits routing, policy enforcement, and access signals"
    },
    {
      "unique-id": "runtime-to-obs",
      "relationship-type": "connects",
      "source": "agent-runtime",
      "destination": "observability",
      "description": "Agent runtime emits reasoning traces, refinement steps, and execution metrics"
    },
    {
      "unique-id": "llm-gateway-to-obs",
      "relationship-type": "connects",
      "source": "llm-gateway",
      "destination": "observability",
      "description": "LLM gateway emits model selection decisions, routing events, and inference metrics"
    },
    {
      "unique-id": "mcp-gateway-to-obs",
      "relationship-type": "connects",
      "source": "mcp-gateway",
      "destination": "observability",
      "description": "MCP gateway emits tool interaction events and policy enforcement signals"
    },
    {
      "unique-id": "knowledge-to-obs",
      "relationship-type": "connects",
      "source": "knowledge-base",
      "destination": "observability",
      "description": "Knowledge layer emits retrieval metrics and search traces"
    },
    {
      "unique-id": "feedback-to-obs",
      "relationship-type": "connects",
      "source": "feedback-engine",
      "destination": "observability",
      "description": "Feedback engine emits evaluation outcomes and feedback aggregation events"
    },
    {
      "unique-id": "protection-to-obs",
      "relationship-type": "connects",
      "source": "runtime-protection",
      "destination": "observability",
      "description": "Runtime protection emits anomaly detections and compliance violation signals"
    }
  ]
}