{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/cognizant-technology/json-schema/cognizant-technology-connectivity-response-schema.json",
  "title": "ConnectivityResponse",
  "description": "Response structure for Connectivity gRPC method",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/cognizant-technology-agentservice-api-openapi.yml#/components/schemas/ConnectivityResponse",
  "type": "object",
  "properties": {
    "connectivity_info": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/ConnectivityInfo"
      },
      "description": "The description of the agent network's internal connectivity ... as far as the agent wants the outside world to know.."
    },
    "metadata": {
      "type": "object",
      "description": "Metadata for the network as a whole. This comes as a free-form dictionary which can have agent-network defined semantics. Some key/value pairs might eventually become standardized as part of the neuro-san API as time goes on, for instance for network-level Responsible AI (RAI) scores. As those keys become standardized, they will be added here in the docs."
    }
  },
  "$defs": {
    "ConnectivityInfo": {
      "type": "object",
      "properties": {
        "origin": {
          "type": "string",
          "description": "The agent network node whose connectivity is being described"
        },
        "tools": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "A list of tool nodes that are possible to reach from the origin This might include references into external agent networks, perhaps hosted on other servers.  Separate calls to those guys will need to be made in order to gain information about their own connectivity, if this is actually desired by the client. Worth noting that server-side agent descriptions are allowed to withhold connectivity info they deem private, or too much of an implementation detail.  That is, connectivity reported is only as much as the server wants a client to know."
        },
        "display_as": {
          "type": "string",
          "description": "A string describing the nature of the agent so that a client UI can add an indication of its differences between other nodes in the graph. Values from the neuro-san include:  * llm_agent  (default)  * coded_tool  * langchain_tool  * external_agent ... however individual agent networks can define their own strings on a per-node basis to customize their own visualizations."
        },
        "metadata": {
          "type": "object",
          "description": "Metadata for the node. This comes as a free-form dictionary which can have agent-network defined semantics. Some key/value pairs might eventually become standardized as part of the neuro-san API as time goes on, for instance for fine-grained Responsible AI (RAI) scores. As those keys become standardized, they will be added here in the docs."
        }
      }
    }
  }
}