Agent Capability Manifest

Agent runtime configuration is manifest-first. Each runnable agent is a structured object under agents.list[]; global defaults come from agents.defaultPreset, and reusable behavior is factored into agents.capabilityPresets.

Manifest Shape

{
  "id": "main",
  "extends": ["safe-coder"],
  "identity": {
    "name": "Main",
    "role": "General assistant",
    "language": "en",
    "tone": "direct"
  },
  "responsibilities": {
    "primary": ["Help the user complete tasks"],
    "outOfScope": ["Actions forbidden by user or policy"]
  },
  "workspace": { "root": "~/.xopc/workspace/main" },
  "tools": {
    "builtin": {
      "shell": { "mode": "confirm", "scope": "workspace" }
    }
  },
  "skills": { "mode": "all" },
  "memory": {
    "mode": "confirmWrite",
    "sources": ["session", "curated"],
    "writePolicy": { "curated": "confirm" }
  },
  "workflows": {},
  "boundaries": {
    "requiresConfirmation": [],
    "forbidden": [],
    "escalation": []
  }
}

Resolution Rules

• agents.default selects the default manifest id.
• agents.list[] is the only runnable agent registry.
• agents.defaultPreset applies one global preset before every agent.
• extends applies named agents.capabilityPresets after the global preset and before the manifest's own fields.
• There is no agents.defaults layer and no implicit compatibility merge.
• Model roles are named slots. Put shared model roles in the global default preset; only add models to an agent when it should override them.
• Tool policy uses explicit allow, confirm, or deny modes instead of disable lists.

Product Surface

The gateway console manages manifests from /agents. Removed settings pages such as /settings/agent-defaults and /settings/agent-browser redirect to /agents.