{
  "apiVersion": "hub.example.com/v1alpha1",
  "kind": "ToolManifest",
  "metadata": {
    "name": "Fleet Ops Knowledge Search",
    "slug": "mobilityops-knowledge-search"
  },
  "spec": {
    "canonicalName": "mobilityops.knowledge.search",
    "version": "1.0.0",
    "connectorType": "mobilityops",
    "description": "Ask a Fleet Ops procedure question in nl-BE, en-GB or fr-BE (default en-GB) and receive a grounded answer with citations, or an honest insufficient/unavailable result -- never a fabricated answer.",
    "riskClass": "R1",
    "readOnly": true,
    "idempotent": true,
    "inputSchema": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "question": {
          "type": "string",
          "minLength": 3,
          "maxLength": 1000
        },
        "max_sources": {
          "type": "integer",
          "minimum": 1,
          "maximum": 8
        },
        "locale": {
          "type": "string",
          "enum": ["nl-BE", "en-GB", "fr-BE"],
          "default": "en-GB"
        }
      },
      "required": [
        "question"
      ]
    },
    "outputSchema": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "answer": {"type": "string", "maxLength": 4000},
        "evidenceState": {"type": "string", "maxLength": 32},
        "provider": {"type": ["string", "null"], "maxLength": 120},
        "correlationId": {"type": ["string", "null"], "maxLength": 128},
        "sources": {
          "type": "array",
          "maxItems": 8,
          "items": {
            "type": "object",
            "additionalProperties": false,
            "properties": {
              "documentId": {"type": "string", "maxLength": 200},
              "title": {"type": "string", "maxLength": 300},
              "version": {"type": "string", "maxLength": 120},
              "section": {"type": "string", "maxLength": 300},
              "excerpt": {"type": "string", "maxLength": 1500}
            },
            "required": ["documentId", "title", "version", "section", "excerpt"]
          }
        }
      },
      "required": [
        "answer",
        "evidenceState",
        "provider",
        "correlationId",
        "sources"
      ]
    },
    "limits": {
      "timeoutMs": 15000,
      "maxOutputBytes": 65536,
      "maxItems": 8
    },
    "redactionProfile": "documents",
    "requiredScopes": [
      "project:{project}:read"
    ]
  }
}