Swagger Generator API — Languages

naftiko: 1.0.0-alpha2
info:
  label: Swagger Generator API — Languages
  description: 'Swagger Generator API — Languages. 2 operations. Lead operation: List Languages by Multiple Types. Self-contained
    Naftiko capability covering one Swagger Codegen business surface.'
  tags:
  - Swagger Codegen
  - Languages
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    SWAGGER_CODEGEN_API_KEY: SWAGGER_CODEGEN_API_KEY
capability:
  consumes:
  - type: http
    namespace: swagger-generator-languages
    baseUri: https://generator3.swagger.io
    description: Swagger Generator API — Languages business capability. Self-contained, no shared references.
    resources:
    - name: types
      path: /types
      operations:
      - name: listlanguagesmulti
        method: GET
        description: List Languages by Multiple Types
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: types
          in: query
          type: string
          description: Comma-separated list of generator types (client,server,documentation,config)
        - name: version
          in: query
          type: string
          description: OpenAPI specification version filter
    - name: type-version
      path: /{type}/{version}
      operations:
      - name: listlanguages
        method: GET
        description: List Generator Languages
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: type
          in: path
          type: string
          description: Generator type to list
          required: true
        - name: version
          in: path
          type: string
          description: OpenAPI specification version
          required: true
  exposes:
  - type: rest
    namespace: swagger-generator-languages-rest
    port: 8080
    description: REST adapter for Swagger Generator API — Languages. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/types
      name: types
      description: REST surface for types.
      operations:
      - method: GET
        name: listlanguagesmulti
        description: List Languages by Multiple Types
        call: swagger-generator-languages.listlanguagesmulti
        with:
          types: rest.types
          version: rest.version
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/{type}/{version}
      name: type-version
      description: REST surface for type-version.
      operations:
      - method: GET
        name: listlanguages
        description: List Generator Languages
        call: swagger-generator-languages.listlanguages
        with:
          type: rest.type
          version: rest.version
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: swagger-generator-languages-mcp
    port: 9090
    transport: http
    description: MCP adapter for Swagger Generator API — Languages. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: list-languages-multiple-types
      description: List Languages by Multiple Types
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: swagger-generator-languages.listlanguagesmulti
      with:
        types: tools.types
        version: tools.version
      outputParameters:
      - type: object
        mapping: $.
    - name: list-generator-languages
      description: List Generator Languages
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: swagger-generator-languages.listlanguages
      with:
        type: tools.type
        version: tools.version
      outputParameters:
      - type: object
        mapping: $.