agent-layer.calm.json

{
  "nodes": [
    {
      "unique-id": "agent-layer",
      "node-type": "container",
      "name": "Agent Layer",
      "description": "Core reasoning, coordination, and task-execution layer of the multi-agent system."
    },
    {
      "unique-id": "agent-collaboration-patterns",
      "node-type": "container",
      "name": "Agent Collaboration Patterns",
      "description": "High-level strategies for how agents work together, decompose tasks, and route work."
    },
    {
      "unique-id": "supervisor-worker",
      "node-type": "component",
      "name": "Supervisor / Worker",
      "description": "A supervisor agent decomposes a complex task and orchestrates a team of specialized worker agents."
    },
    {
      "unique-id": "skill-based-routing",
      "node-type": "component",
      "name": "Skill Based Routing",
      "description": "A request is routed based on a required skill to an available agent that possesses that skill."
    },
    {
      "unique-id": "agent-as-tool",
      "node-type": "component",
      "name": "Agent as a Tool",
      "description": "A dynamic pattern where one agent can invoke another agent as if it were a tool, enabling handoff to specialists."
    },
    {
      "unique-id": "unified-agent-runtime",
      "node-type": "container",
      "name": "Unified Agent Runtime",
      "description": "The secure, sandboxed environment where all agentic reasoning and execution occurs."
    },
    {
      "unique-id": "state-management",
      "node-type": "component",
      "name": "State Management",
      "description": "Manages complete state of a task to enable pause, resume, and handoff capabilities."
    },
    {
      "unique-id": "secure-execution",
      "node-type": "component",
      "name": "Secure Execution",
      "description": "Intercepts and validates all tool call requests from the agent, handling execution and credentials securely within the sandbox."
    },
    {
      "unique-id": "collaboration-handoff",
      "node-type": "component",
      "name": "Collaboration/Handoff",
      "description": "Enables stateful collaboration between agents through shared access to memory and state."
    },
    {
      "unique-id": "adaptive-learning",
      "node-type": "component",
      "name": "Adaptive Learning",
      "description": "Generates learning signals based on execution outcomes to refine prompts, adjust agent configurations, or improve tool selection strategies."
    },
    {
      "unique-id": "workspace-file-system",
      "node-type": "component",
      "name": "Workspace File System",
      "description": "Provides a sandboxed, persistent file system that agents can use for reading and writing files."
    },
    {
      "unique-id": "tools-layer",
      "node-type": "container",
      "name": "Tools Layer",
      "description": "A collection of built-in, trusted tools that provide fundamental capabilities to agents."
    },
    {
      "unique-id": "mcp-client",
      "node-type": "component",
      "name": "MCP Client",
      "description": "Secure bridge from the runtime to the external MCP Layer for accessing specialized, high-risk or enterprise-specific tools."
    },
    {
      "unique-id": "shell-tool",
      "node-type": "component",
      "name": "Shell Tool",
      "description": "A sandboxed shell environment for executing basic commands."
    },
    {
      "unique-id": "io-tool",
      "node-type": "component",
      "name": "I/O Tool",
      "description": "Provides capabilities for reading from and writing to the workspace file system."
    },
    {
      "unique-id": "web-search-tool",
      "node-type": "component",
      "name": "Web Search Tool",
      "description": "A built-in tool for performing web searches."
    },
    {
      "unique-id": "short-term-memory",
      "node-type": "container",
      "name": "Short Term Memory",
      "description": "Manages the immediate context for the agent's reasoning loop."
    },
    {
      "unique-id": "in-session-context-manager",
      "node-type": "component",
      "name": "In-Session Context Manager",
      "description": "Employs strategies like trimming and summarization to manage context length, cost and latency."
    },
    {
      "unique-id": "long-term-memory",
      "node-type": "container",
      "name": "Long Term Memory",
      "description": "Maintains durable information across sessions to provide personalization and continuity."
    },
    {
      "unique-id": "session-summaries",
      "node-type": "component",
      "name": "Session Summaries",
      "description": "Stores summaries of past interactions for future reference."
    },
    {
      "unique-id": "user-task-personalization",
      "node-type": "component",
      "name": "User/Task Personalization",
      "description": "Retains user preferences and task-specific information to tailor future interactions."
    }
  ],
  "relationships": [
    {
      "unique-id": "rel-agent-layer-contains",
      "relationship-type": {
        "composed-of": {
          "container": "agent-layer",
          "nodes": [
            "agent-collaboration-patterns",
            "unified-agent-runtime"
          ]
        }
      },
      "description": "Agent Layer contains Agent Collaboration Patterns and Unified Agent Runtime"
    },
    {
      "unique-id": "rel-acp-contains",
      "relationship-type": {
        "composed-of": {
          "container": "agent-collaboration-patterns",
          "nodes": [
            "supervisor-worker",
            "skill-based-routing",
            "agent-as-tool"
          ]
        }
      },
      "description": "Agent Collaboration Patterns contains collaboration strategy components"
    },
    {
      "unique-id": "rel-uar-contains",
      "relationship-type": {
        "composed-of": {
          "container": "unified-agent-runtime",
          "nodes": [
            "state-management",
            "secure-execution",
            "collaboration-handoff",
            "adaptive-learning",
            "workspace-file-system",
            "tools-layer",
            "short-term-memory",
            "long-term-memory"
          ]
        }
      },
      "description": "Unified Agent Runtime contains all runtime components"
    },
    {
      "unique-id": "rel-tools-contains",
      "relationship-type": {
        "composed-of": {
          "container": "tools-layer",
          "nodes": [
            "mcp-client",
            "shell-tool",
            "io-tool",
            "web-search-tool"
          ]
        }
      },
      "description": "Tools Layer contains built-in tool components"
    },
    {
      "unique-id": "rel-stm-contains",
      "relationship-type": {
        "composed-of": {
          "container": "short-term-memory",
          "nodes": [
            "in-session-context-manager"
          ]
        }
      },
      "description": "Short Term Memory contains In-Session Context Manager"
    },
    {
      "unique-id": "rel-ltm-contains",
      "relationship-type": {
        "composed-of": {
          "container": "long-term-memory",
          "nodes": [
            "session-summaries",
            "user-task-personalization"
          ]
        }
      },
      "description": "Long Term Memory contains session summaries and personalization components"
    },
    {
      "unique-id": "rel-acp-to-uar",
      "relationship-type": {
        "connects": {
          "source": {
            "node": "agent-collaboration-patterns"
          },
          "destination": {
            "node": "unified-agent-runtime"
          }
        }
      },
      "description": "Agent Collaboration Patterns delegate execution to Unified Agent Runtime"
    },
    {
      "unique-id": "rel-uar-to-acp",
      "relationship-type": {
        "connects": {
          "source": {
            "node": "unified-agent-runtime"
          },
          "destination": {
            "node": "agent-collaboration-patterns"
          }
        }
      },
      "description": "Unified Agent Runtime returns results to Agent Collaboration Patterns"
    }
  ]
}