federation_get_agent_runs
ActiveTool of ComOS Federation Gateway
Get execution history for an agent. Requires authentication via auth_token. Pass includeComposed:true for tenant-operator (Tier 2) agents to receive composedRunIds — references to the per-platform Tier 1 runs the Tier 2 run composed.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"auth_token",
"agentId"
],
"properties": {
"limit": {
"type": "number",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum results to return"
},
"status": {
"enum": [
"success",
"failure",
"running",
"all"
],
"type": "string",
"default": "all",
"description": "Filter by run status"
},
"agentId": {
"type": "string",
"description": "The agent ID"
},
"auth_token": {
"type": "string",
"description": "JWT auth token for authentication"
},
"includeComposed": {
"type": "boolean",
"default": false,
"description": "When true, returns composedRunIds and composedCost per record (Phase 5). For tenant-operator agents reads from comos-tenant-agents.agent_runs; otherwise from the federation network-ops collection. Per D4, fetching the referenced Tier 1 runs is the caller's responsibility (via the platform's MCP surface); the federation does not cross-DB join."
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
ComOS Federation Gateway
https://github.com/ronrey/comos-federation
2/7 registries