← Back to registry

TOOL · diagnose_services

No description provided.

Canonical Definition

{
  "function": {
    "description": "Run a comprehensive diagnostic of all ImagineOS services. Reads the Sentinel service map, cross-references with PM2 process list and actual port listeners (ss -tlnp), HTTP-probes each endpoint, reads recent error logs, and produces a correlated report with root cause hypotheses and proposed fixes. Use this when the user reports something is broken, asks about service health, or wants to understand why an app isn't working.",
    "name": "diagnose_services",
    "parameters": {
      "properties": {
        "include_logs": {
          "description": "Whether to include recent error log excerpts in the report. Defaults to true.",
          "type": "boolean"
        },
        "service_filter": {
          "description": "Optional: filter diagnosis to a specific service name (e.g., 'vetra-rust', 'cartera-rust'). Leave empty to diagnose all services.",
          "type": "string"
        }
      },
      "required": [],
      "type": "object"
    }
  },
  "type": "function"
}