naftiko: 1.0.0-alpha2
info:
  label: Rigetti QCS — Quantum Processors
  description: Self-contained Naftiko capability covering the Rigetti QCS Quantum Processors surface — list and
    inspect QPUs, retrieve Instruction Set Architecture (ISA), accessors, and calibration calendar.
  tags:
  - Rigetti
  - QCS
  - Quantum Processors
  - QPU
  created: '2026-05-24'
  modified: '2026-05-24'
binds:
- namespace: env
  keys:
    QCS_ACCESS_TOKEN: QCS_ACCESS_TOKEN
capability:
  consumes:
  - type: http
    namespace: qcs-quantum-processors
    baseUri: https://api.qcs.rigetti.com
    description: Rigetti QCS Quantum Processors business capability. Self-contained, no shared references.
    resources:
    - name: quantum-processors
      path: /v1/quantumProcessors
      operations:
      - name: listquantumprocessors
        method: GET
        description: List quantum processors visible to the caller.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: pageSize
          in: query
          type: integer
          required: false
        - name: pageToken
          in: query
          type: string
          required: false
    - name: quantum-processor
      path: /v1/quantumProcessors/{processorId}
      operations:
      - name: getquantumprocessor
        method: GET
        description: Retrieve a quantum processor by ID.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: processorId
          in: path
          type: string
          required: true
    - name: quantum-processor-isa
      path: /v1/quantumProcessors/{processorId}/instructionSetArchitecture
      operations:
      - name: getinstructionsetarchitecture
        method: GET
        description: Retrieve the Instruction Set Architecture (ISA) for a quantum processor.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: processorId
          in: path
          type: string
          required: true
    - name: quantum-processor-accessors
      path: /v1/quantumProcessors/{processorId}/accessors
      operations:
      - name: listquantumprocessoraccessors
        method: GET
        description: List accessors for a quantum processor.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: processorId
          in: path
          type: string
          required: true
    - name: quantum-processor-calendar
      path: /v1/quantumProcessors/{processorId}/calendar
      operations:
      - name: getquantumprocessorcalendar
        method: GET
        description: Retrieve the maintenance / calibration calendar for a quantum processor.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: processorId
          in: path
          type: string
          required: true
    authentication:
      type: bearer
      value: '{{env.QCS_ACCESS_TOKEN}}'
      placement: header
  exposes:
  - type: rest
    namespace: qcs-quantum-processors-rest
    port: 8080
    description: REST adapter for Rigetti QCS Quantum Processors.
    resources:
    - path: /v1/quantumProcessors
      name: quantum-processors
      description: REST surface for quantum-processors.
      operations:
      - method: GET
        name: listquantumprocessors
        description: List quantum processors.
        call: qcs-quantum-processors.listquantumprocessors
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/quantumProcessors/{processorId}
      name: quantum-processor
      operations:
      - method: GET
        name: getquantumprocessor
        description: Get quantum processor.
        call: qcs-quantum-processors.getquantumprocessor
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: qcs-quantum-processors-mcp
    port: 9090
    transport: http
    description: MCP adapter for Rigetti QCS Quantum Processors.
    tools:
    - name: rigetti-list-quantum-processors
      description: List quantum processors visible to the caller.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: qcs-quantum-processors.listquantumprocessors
      outputParameters:
      - type: object
        mapping: $.
    - name: rigetti-get-quantum-processor
      description: Get quantum processor by ID.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: qcs-quantum-processors.getquantumprocessor
      outputParameters:
      - type: object
        mapping: $.
    - name: rigetti-get-isa
      description: Get Instruction Set Architecture for a quantum processor.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: qcs-quantum-processors.getinstructionsetarchitecture
      outputParameters:
      - type: object
        mapping: $.
    - name: rigetti-get-quantum-processor-calendar
      description: Get the calibration / maintenance calendar for a quantum processor.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: qcs-quantum-processors.getquantumprocessorcalendar
      outputParameters:
      - type: object
        mapping: $.