Consultar el estado de las conexiones

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "sistema": {
      "description": "Filtra por código de sistema.",
      "type": "string"
    },
    "conexionId": {
      "description": "conn_…, filtra una conexión puntual.",
      "type": "string"
    }
  }
}

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "conexiones": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "El id de la conexión (conn_…). Es lo que va en la cabecera 'X-Connect-Connection' de cada llamada a este sistema."
          },
          "sistema": {
            "type": "string",
            "description": "El código del sistema al que pertenece esta conexión."
          },
          "nombre": {
            "type": "string",
            "description": "El nombre con que se creó la conexión, normalmente la empresa a la que pertenece la credencial."
          },
          "estado": {
            "type": "string",
            "enum": [
              "active",
              "disabled",
              "pending"
            ],
            "description": "En qué estado está la conexión. 'active' = utilizable. 'disabled' = pausada, sus tools responden 'connection_disabled'. 'pending' = creada pero todavía sin credencial vinculada."
          },
          "credencial": {
            "type": "string",
            "enum": [
              "linked",
              "invalid",
              "revoked",
              "ausente"
            ],
            "description": "En qué estado está la credencial de esta conexión. 'linked' = vinculada y utilizable. 'invalid' = el sistema externo la rechazó, hay que reconectar. 'revoked' = se revocó a propósito. 'ausente' = nunca se entregó. Todo lo que no sea 'linked' se arregla con 'conexiones.enlace.crear' en modo 'reconectar'."
          },
          "verificadaEn": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "description": "Cuándo se probó por última vez la credencial contra el sistema externo (ISO 8601). 'null' si nunca se probó. Una fecha vieja no invalida la credencial por sí sola."
          },
          "alcances": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Los módulos de datos habilitados en esta conexión. Pedir uno que no esté en esta lista responde 'alcance_not_enabled'."
          },
          "cadencia": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "off",
                  "daily",
                  "12h",
                  "6h"
                ]
              },
              {
                "type": "null"
              }
            ],
            "description": "Cada cuánto sincroniza sola esta conexión. 'off' o 'null' significan que nadie la sincroniza por ti: llama a la tool 'conexion.sincronizar' del sistema cuando quieras datos frescos."
          },
          "trabajos": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "El id de esta sincronización programada (sjb_…)."
                },
                "estado": {
                  "type": "string",
                  "enum": [
                    "queued",
                    "running",
                    "succeeded",
                    "failed",
                    "partial"
                  ],
                  "description": "En qué va la sincronización. 'queued' y 'running' significan que todavía está trabajando: espera antes de concluir que no hay datos. 'succeeded' terminó bien, 'partial' escribió una parte y 'failed' no escribió nada, con la causa en 'error'."
                },
                "periodo": {
                  "type": "string",
                  "description": "El mes que sincronizó esta corrida, en formato AAAA-MM."
                },
                "alcances": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  },
                  "description": "Qué módulos de datos abarcó esta corrida."
                },
                "registros": {
                  "anyOf": [
                    {
                      "type": "integer",
                      "minimum": -9007199254740991,
                      "maximum": 9007199254740991
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "Cuántos registros escribió. 'null' significa que todavía no se sabe (la corrida no terminó), y es distinto de un 0, que sí es un resultado: ese período no tenía nada."
                },
                "error": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "description": "La causa de la falla cuando 'estado' es 'failed'. 'null' en cualquier otro caso."
                }
              },
              "required": [
                "id",
                "estado",
                "periodo",
                "alcances",
                "registros",
                "error"
              ],
              "additionalProperties": false
            },
            "description": "Las últimas sincronizaciones programadas de esta conexión, de la más reciente a la más antigua."
          },
          "datosListos": {
            "type": "boolean",
            "description": "La respuesta a «¿ya puedo leer?»: alguna sincronización terminó bien y ninguna está en curso. Revísalo antes de concluir que no hay datos, porque un listado vacío con 'datosListos' en false significa «espera», no «no tienes nada». Un período legítimamente sin registros cuenta como sincronización exitosa: este campo no mira si hay filas."
          },
          "herramientas": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Los ids de tool que ya puedes invocar sobre esta conexión. Si tu cliente MCP todavía no los muestra, llámalos con 'execute' pasando el id en 'tool'."
          }
        },
        "required": [
          "id",
          "sistema",
          "nombre",
          "estado",
          "credencial",
          "verificadaEn",
          "alcances",
          "cadencia",
          "trabajos",
          "datosListos",
          "herramientas"
        ],
        "additionalProperties": false
      },
      "description": "Las conexiones de esta organización que pasan el filtro, con su estado y sus últimas sincronizaciones."
    }
  },
  "required": [
    "conexiones"
  ],
  "additionalProperties": false
}