Agent Plugins 1.0.0 Specification & DSOM Protocol Integration

Entry Point 20: This document defines the packaging, distribution, and runtime interoperability architecture for Agent Plugins 1.0.0 within the Deep State of Mind (DSOM) framework.

​

🎯 Executive Summary & Context

​

🏛️ The 5-Layer Agent Ecosystem Architecture

1. Find it, Agentic Resource Discovery (ARD): Discovers available plugins and capabilities prior to invocation.
2. Describe it, AI Catalog: Indexes plugin descriptors and resource mappings.
3. Package it, Agent Plugins 1.0.0: Standardised directory layout, manifest (plugin.json), and MCP descriptor (mcp.json).
4. Run it, MCP & Agent Skills: Portable execution contracts across transports (stdio, streamable-http, sse).
5. Govern it, DSOM Metacognition: Tri-Phasic Mind cognitive continuity, 10 Custom Guardrails, and GitOps audit trail.

​

📐 Package Layout Standard (Rule 30)

my-dsom-plugin/
├── plugin.json              # Required: Closed manifest (schema 1.0.0)
├── mcp.json                 # Optional: Explicit MCP server descriptors
├── skills/                  # Optional: Fixed directory for Agent Skills
│   └── summarize/
│       ├── SKILL.md         # Open Knowledge Format (OKF v0.2)
│       ├── scripts/         # Idempotent execution scripts
│       └── references/      # Progressive disclosure documentation
├── org.dsom.protocol/       # Optional: Client extension namespace
│   ├── guardrails.json      # DSOM custom validators configuration
│   └── hooks/               # Tri-Phasic interception hooks
├── LICENSE                  # GNU GPL v3.0 / SPDX identifier
└── CHANGELOG.md             # Semantic version ledger

​

📜 Manifest Contracts

​

1. plugin.json (Root Manifest)

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "deep-state-of-mind",
  "version": "10.4.0",
  "description": "Deep State of Mind (DSOM) Sovereign AI Agent Cognitive Architecture, Open Knowledge Format (OKF), and Model Context Protocol (MCP) toolset.",
  "author": {
    "name": "Harisfazillah Jamel (LinuxMalaysia)",
    "email": "linuxmalaysia@gmail.com",
    "url": "https://github.com/linuxmalaysia"
  },
  "homepage": "https://linuxmalaysia.github.io/deep-state-of-mind-for-my-ai/",
  "repository": "https://github.com/linuxmalaysia/deep-state-of-mind-for-my-ai",
  "license": "GPL-3.0-or-later",
  "keywords": [
    "dsom",
    "ai-agents",
    "mcp",
    "agent-skills",
    "agent-plugins"
  ],
  "extensions": {
    "org.dsom.protocol": {
      "tri_phasic_mind": true,
      "okf_version": "0.2"
    }
  }
}

​

2. mcp.json (MCP Configuration)

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
  "mcpServers": {
    "dsom-knowledge-server": {
      "type": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "--with",
        "pyyaml",
        "python",
        "${PLUGIN_ROOT}/tools/mcp/server.py"
      ],
      "env": {
        "DSOM_PALACE_ROOT": "${PLUGIN_ROOT}",
        "DSOM_STORAGE_DIR": "${PLUGIN_DATA}/storage"
      },
      "cwd": "${PLUGIN_ROOT}"
    }
  }
}

​

🛡️ Variable Expansion & Path Containment

1. ${PLUGIN_ROOT}: Absolute path to the resolved plugin root. Used for referencing bundled binaries, Python scripts (tools/mcp/server.py), and documentation palaces.
2. ${PLUGIN_DATA}: Client-managed persistent directory dedicated to that installed plugin instance. Used for virtual environments, local SQLite caches, and generated artifacts.

[!CAUTION] Path Containment Invariant (§4.1): All relative paths defined in mcp.json or plugin configurations MUST resolve strictly within ${PLUGIN_ROOT} or ${PLUGIN_DATA}. Any attempt to traverse upward (../) outside the root boundary will cause compliant clients to reject the component.

​

🛠️ Step-by-Step: Packaging a DSOM Skill as an Agent Plugin

1. Create the Plugin Directory:
   mkdir -p plugins/my-ops-plugin/skills/sys-audit
   
2. Write plugin.json:
   {
     "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
     "name": "my-ops-plugin"
   }
   
3. Add OKF v0.2 SKILL.md: Place your standard DSOM skill inside skills/sys-audit/SKILL.md.
4. Attach MCP Server (Optional): Add mcp.json declaring any auxiliary stdio or streamable HTTP tools.
5. Verify with DSOM Guardrails:
   uv run python tools/install_git_guardrails.py
   uv run pytest tests/test_agent_plugins_spec.py
   

​

📚 Related Governance & References

• docs/governance/DSOM-MCP-ARCHITECTURE.md, FastMCP Server Reference.
• docs/governance/AI-GUARDRAILS-MASTER-GUIDE.md, Pre-Commit & Runtime Interception.
• Agent Plugins 1.0.0 Specification, Normative Standard.