Multi Api Composition Capability

naftiko: 1.0.0-alpha2
info:
  title: Multi Api Composition Capability
  description: A capability illustrating composition over an arbitrary set of upstream APIs — generic multi-API orchestration with a single shaped response.
  tags: [Naftiko, Composition, Multi-API]
  created: '2026-05-01'
  modified: '2026-05-04'
binds:
- namespace: naftiko-env
  keys: {NAFTIKO_API_KEY: NAFTIKO_API_KEY}
capability:
  consumes:
  - namespace: naftiko-control
    type: http
    baseUri: https://api.naftiko.com
    authentication: {type: bearer, token: '{{NAFTIKO_API_KEY}}'}
    resources:
    - {name: compositions, path: /v1/compositions, operations: [{name: list-compositions, method: GET}]}
    - name: composition-run
      path: '/v1/compositions/{{composition_id}}/run'
      operations:
      - {name: run-composition, method: POST, inputParameters: [{name: composition_id, in: path}]}
  exposes:
  - type: rest
    address: 0.0.0.0
    port: 8080
    namespace: multi-api-composition-capability-rest
    description: REST surface for multi-API composition.
    resources:
    - {name: run, path: '/run/{{composition_id}}', operations: [{method: POST, name: run-composition, inputParameters: [{name: composition_id, in: path, type: string}], call: naftiko-control.run-composition}]}
  - type: mcp
    address: 0.0.0.0
    port: 3010
    namespace: multi-api-composition-capability-mcp
    description: MCP for composition.
    tools:
    - {name: list-compositions, hints: {readOnly: true}, call: naftiko-control.list-compositions}
    - name: run-composition
      inputParameters: [{name: composition_id, type: string, required: true}]
      call: naftiko-control.run-composition
  - type: skill
    address: 0.0.0.0
    port: 3011
    namespace: multi-api-composition-capability-skills
    description: Skill for composition.
    skills:
    - name: multi-api-composition-capability
      description: Multi-API composition.
      location: file:///opt/naftiko/skills/multi-api-composition-capability
      allowed-tools: list-compositions,run-composition
      tools:
      - {name: list-compositions, from: {sourceNamespace: multi-api-composition-capability-mcp, action: list-compositions}}
      - {name: run-composition, from: {sourceNamespace: multi-api-composition-capability-mcp, action: run-composition}}