agent-command-surface.md

Agent command surface

/easyagent is diagnostic/admin/debug tooling. It is not the main runtime integration surface for plugins.

Real data flow should use:

imperazim\agent\api\*
imperazim\agent\constant\*
imperazim\agent\event\*

Command config:

agent:
  commands:
    enabled: true
    advanced: false
    debug: false

When agent.enabled=false, /easyagent is not registered at all. When agent.commands.enabled=false, the bridge can still run for plugins, but the command is not registered.

Recommended production surface:

/easyagent status
/easyagent health
/easyagent doctor
/easyagent report
/easyagent reload

Advanced/debug commands such as KV writes, flags, RPC probes, command dispatch and delivery retry are for controlled testing and admin diagnostics.