Toolhouse Bundles Management

naftiko: "1.0.0-alpha2"

info:
  title: Toolhouse Bundles Management
  description: >-
    Manages Toolhouse Bundles (named, reusable tool collections) from
    Naftiko spec — lets a Naftiko capability declare a bundle of tools
    its agents should ship with, and provision that bundle in Toolhouse
    declaratively. Closes the loop between "Naftiko declared the
    capability" and "Toolhouse agents inherit the right toolset."
  tags:
    - Naftiko
    - Toolhouse
    - Partnership
    - Bundles
    - Tools
    - Declarative
  created: '2026-05-15'
  modified: '2026-05-15'

binds:
  - namespace: toolhouse-env
    description: Toolhouse Platform API key.
    keys:
      TOOLHOUSE_API_KEY: TOOLHOUSE_API_KEY

capability:
  consumes:
    - namespace: toolhouse
      type: http
      baseUri: https://api.toolhouse.ai
      authentication:
        type: bearer
        token: '{{TOOLHOUSE_API_KEY}}'
      resources:
        - name: list-bundles
          path: '/me/bundles'
          operations:
            - name: list-bundles
              method: GET
            - name: create-bundle
              method: POST
        - name: bundle
          path: '/me/bundles/{{bundle_id}}'
          operations:
            - name: get-bundle
              method: GET
              inputParameters:
                - { name: bundle_id, in: path, required: true }
            - name: update-bundle
              method: PUT
              inputParameters:
                - { name: bundle_id, in: path, required: true }
            - name: delete-bundle
              method: DELETE
              inputParameters:
                - { name: bundle_id, in: path, required: true }

  exposes:
    - type: rest
      address: 0.0.0.0
      port: 8080
      namespace: toolhouse-bundles-management-rest
      description: REST surface for managing Toolhouse Bundles from Naftiko spec.
      resources:
        - name: bundles
          path: '/bundles'
          operations:
            - name: list-bundles
              method: GET
              call: toolhouse.list-bundles
            - name: create-bundle
              method: POST
              call: toolhouse.create-bundle
        - name: bundle
          path: '/bundles/{bundle_id}'
          operations:
            - name: get-bundle
              method: GET
              inputParameters:
                - { name: bundle_id, in: path, type: string, required: true }
              call: toolhouse.get-bundle
            - name: update-bundle
              method: PUT
              inputParameters:
                - { name: bundle_id, in: path, type: string, required: true }
              call: toolhouse.update-bundle
            - name: delete-bundle
              method: DELETE
              inputParameters:
                - { name: bundle_id, in: path, type: string, required: true }
              call: toolhouse.delete-bundle

    - type: mcp
      address: 0.0.0.0
      port: 3010
      namespace: toolhouse-bundles-management-mcp
      description: MCP server for managing Toolhouse Bundles from agents.
      tools:
        - name: list-bundles
          description: List Toolhouse Bundles (named tool collections).
          hints: { readOnly: true }
          call: toolhouse.list-bundles
        - name: create-bundle
          description: Create a new Toolhouse Bundle from a Naftiko declarative spec.
          hints: { destructiveHint: false }
          call: toolhouse.create-bundle
        - name: get-bundle
          description: Get a Toolhouse Bundle by ID with its tool list.
          hints: { readOnly: true }
          inputParameters:
            - { name: bundle_id, type: string, required: true, description: Toolhouse bundle ID. }
          call: toolhouse.get-bundle
        - name: update-bundle
          description: Update a Toolhouse Bundle (add or remove tools).
          hints: { destructiveHint: true }
          inputParameters:
            - { name: bundle_id, type: string, required: true, description: Toolhouse bundle ID. }
          call: toolhouse.update-bundle
        - name: delete-bundle
          description: Delete a Toolhouse Bundle.
          hints: { destructiveHint: true }
          inputParameters:
            - { name: bundle_id, type: string, required: true, description: Toolhouse bundle ID. }
          call: toolhouse.delete-bundle