{
  "_note": "DRAFT agent tool schemas (OpenAI/Anthropic function-call format). A generated, versioned set is planned; names may change.",
  "tools": [
    {
      "name": "search",
      "description": "Search SecureScout SI's stored index of approved public sources. Returns compact, cited, freshness-labeled evidence (plain text). Use mode=passages for longer quotable passages.",
      "parameters": {
        "type": "object", "additionalProperties": false, "required": ["q"],
        "properties": {
          "q": { "type": "string", "minLength": 1, "maxLength": 300 },
          "mode": { "type": "string", "enum": ["compact", "passages"], "default": "compact" },
          "limit": { "type": "integer", "minimum": 1, "maximum": 20, "default": 10 },
          "max_bytes": { "type": "integer", "minimum": 1024, "maximum": 65536, "default": 8192 },
          "sort": { "type": "string", "enum": ["relevance", "newest"], "default": "relevance" },
          "live_only": { "type": "boolean", "default": false },
          "filter": { "type": "string", "enum": ["all", "news", "vulnerabilities", "regulations", "research", "standards", "weather"] },
          "source_ids": { "type": "array", "items": { "type": "string" }, "maxItems": 20 },
          "highlight": { "type": "boolean", "default": false },
          "cursor": { "type": "string" }
        }
      }
    },
    {
      "name": "lookup",
      "description": "Exact lookup of identifiers (CVE IDs, Federal Register document numbers, arXiv IDs, NIST SP numbers). Returns structured records.",
      "parameters": {
        "type": "object", "additionalProperties": false, "required": ["ids"],
        "properties": {
          "ids": { "type": "array", "items": { "type": "string" }, "minItems": 1, "maxItems": 25 },
          "limit_per_id": { "type": "integer", "minimum": 1, "maximum": 10, "default": 3 },
          "max_bytes": { "type": "integer", "minimum": 1024, "maximum": 65536, "default": 8192 }
        }
      }
    },
    {
      "name": "get_document",
      "description": "Fetch a document's permitted full text, metadata and versions by doc_id (from a search result). Free (not billed).",
      "parameters": { "type": "object", "additionalProperties": false, "required": ["doc_id"], "properties": { "doc_id": { "type": "string" }, "max_bytes": { "type": "integer", "minimum": 1024, "maximum": 65536, "default": 8192 }, "cursor": { "type": "string" } } }
    },
    {
      "name": "get_context",
      "description": "Fetch stored passages adjacent to a passage_id (from mode=passages). Free (not billed).",
      "parameters": {
        "type": "object", "additionalProperties": false, "required": ["passage_id"],
        "properties": { "passage_id": { "type": "string" }, "before": { "type": "integer", "minimum": 0, "maximum": 5, "default": 1 }, "after": { "type": "integer", "minimum": 0, "maximum": 5, "default": 1 } }
      }
    }
  ]
}