API Evangelist enhancements - Cognizant Neuro SAN Concierge Service API

overlay: 1.0.0
info:
  title: API Evangelist enhancements - Cognizant Neuro SAN Concierge Service API
  version: 1.0.0
extends: openapi/cognizant-technology-conciergeservice-api-openapi.yml
x-provenance:
  generated: '2026-11-04'
  method: generated
  source: Derived from the provider's own documentation (neuro-san README, docs/clients.md, docs/mcp_service.md, agent.proto comments) and from
    this repository's artifacts. Every action below adds context the published contract omits; none contradicts it and the original spec is never
    mutated.
  note: 'Split out of the agent-service overlay on 2026-11-04 when refine divided the verbatim contract by gRPC service. The servers[] value is
    templated on purpose: neuro-san is self-hosted, so the host genuinely is a variable and no Cognizant hostname is invented.'
actions:
- target: $
  description: Add a templated server. neuro-san is self-hosted software; the provider's own examples use http://localhost:8080 after the operator
    starts the server. The variables make the host and port explicit rather than guessed.
  update:
    servers:
    - url: '{scheme}://{host}:{port}'
      description: An operator-run neuro-san agent service. Not a Cognizant-hosted endpoint — Cognizant publishes the software, the operator runs
        the server.
      variables:
        scheme:
          default: http
          enum:
          - http
          - https
          description: The provider's documented examples use http on loopback. TLS termination is the operator's responsibility and is not required
            by the contract.
        host:
          default: localhost
          description: The host on which the operator runs server_main_loop.
        port:
          default: '8080'
          description: The port used throughout the provider's own curl examples in docs/mcp_service.md.
- target: $.paths['/api/v1/list'].get
  description: Record that this listing is unpaginated and may be withheld.
  update:
    x-pagination:
      supported: false
      note: Returns the full agents array; no limit, offset, cursor or page parameter exists.
    x-visibility:
      note: Only agent networks the server marks public are listed. The provider states the chat client is deliberately unable to enumerate all
        registered agents.
- target: $.components.schemas.Status
  description: Name the error model explicitly so a client does not expect RFC 9457.
  update:
    x-error-model: google.rpc.Status
    x-rfc9457: false
    x-note: Not application/problem+json. There is no type, title, status, detail or instance member. See errors/cognizant-technology-problem-types.yml.