Cloudsmith API (v1) — quota

naftiko: 1.0.0-alpha2
info:
  label: Cloudsmith API (v1) — quota
  description: 'Cloudsmith API (v1) — quota. 4 operations. Lead operation: Quota history for a given namespace.. Self-contained
    Naftiko capability covering one Cloudsmith business surface.'
  tags:
  - Cloudsmith
  - quota
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    CLOUDSMITH_API_KEY: CLOUDSMITH_API_KEY
capability:
  consumes:
  - type: http
    namespace: cloudsmith-quota
    baseUri: https://api.cloudsmith.io
    description: Cloudsmith API (v1) — quota business capability. Self-contained, no shared references.
    resources:
    - name: quota-history-owner
      path: /quota/history/{owner}/
      operations:
      - name: quotahistoryread
        method: GET
        description: Quota history for a given namespace.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: quota-oss-history-owner
      path: /quota/oss/history/{owner}/
      operations:
      - name: quotaosshistoryread
        method: GET
        description: Open-source Quota history for a given namespace.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: quota-oss-owner
      path: /quota/oss/{owner}/
      operations:
      - name: quotaossread
        method: GET
        description: Open-source Quota usage for a given namespace.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: quota-owner
      path: /quota/{owner}/
      operations:
      - name: quotaread
        method: GET
        description: Quota usage for a given namespace.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    namespace: cloudsmith-quota-rest
    port: 8080
    description: REST adapter for Cloudsmith API (v1) — quota. One Spectral-compliant resource per consumed operation, prefixed
      with /v1.
    resources:
    - path: /v1/quota/history/{owner}
      name: quota-history-owner
      description: REST surface for quota-history-owner.
      operations:
      - method: GET
        name: quotahistoryread
        description: Quota history for a given namespace.
        call: cloudsmith-quota.quotahistoryread
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/quota/oss/history/{owner}
      name: quota-oss-history-owner
      description: REST surface for quota-oss-history-owner.
      operations:
      - method: GET
        name: quotaosshistoryread
        description: Open-source Quota history for a given namespace.
        call: cloudsmith-quota.quotaosshistoryread
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/quota/oss/{owner}
      name: quota-oss-owner
      description: REST surface for quota-oss-owner.
      operations:
      - method: GET
        name: quotaossread
        description: Open-source Quota usage for a given namespace.
        call: cloudsmith-quota.quotaossread
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/quota/{owner}
      name: quota-owner
      description: REST surface for quota-owner.
      operations:
      - method: GET
        name: quotaread
        description: Quota usage for a given namespace.
        call: cloudsmith-quota.quotaread
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: cloudsmith-quota-mcp
    port: 9090
    transport: http
    description: MCP adapter for Cloudsmith API (v1) — quota. One tool per consumed operation, routed inline through this
      capability's consumes block.
    tools:
    - name: quota-history-given-namespace
      description: Quota history for a given namespace.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloudsmith-quota.quotahistoryread
      outputParameters:
      - type: object
        mapping: $.
    - name: open-source-quota-history-given
      description: Open-source Quota history for a given namespace.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloudsmith-quota.quotaosshistoryread
      outputParameters:
      - type: object
        mapping: $.
    - name: open-source-quota-usage-given
      description: Open-source Quota usage for a given namespace.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloudsmith-quota.quotaossread
      outputParameters:
      - type: object
        mapping: $.
    - name: quota-usage-given-namespace
      description: Quota usage for a given namespace.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: cloudsmith-quota.quotaread
      outputParameters:
      - type: object
        mapping: $.