naftiko: 1.0.0-alpha2
info:
  label: Vespa State API
  description: Vespa /state/v1 capability exposing per-service health, version, and metrics for any
    Vespa node — consumed by orchestrators, load balancers, and monitoring agents.
  tags:
    - Vespa
    - Health
    - Monitoring
    - State
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      VESPA_ENDPOINT: VESPA_ENDPOINT
capability:
  consumes:
    - type: http
      namespace: vespa-state
      baseUri: '{{env.VESPA_ENDPOINT}}'
      description: Vespa State API business capability. Self-contained.
      resources:
        - name: state-root
          path: /state/v1/
          operations:
            - name: vespaStateRoot
              method: GET
              description: List Available State Resources
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: state-health
          path: /state/v1/health
          operations:
            - name: vespaStateHealth
              method: GET
              description: Get Health Status For A Vespa Service
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: state-version
          path: /state/v1/version
          operations:
            - name: vespaStateVersion
              method: GET
              description: Get Vespa Service Version
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
        - name: state-metrics
          path: /state/v1/metrics
          operations:
            - name: vespaStateMetrics
              method: GET
              description: Get Metrics For A Vespa Service
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
      authentication:
        type: none
  exposes:
    - type: rest
      namespace: vespa-state-rest
      port: 8080