Jentic Arazzo Workflow Import

naftiko: "1.0.0-alpha2"

info:
  title: Jentic Arazzo Workflow Import
  description: >-
    Imports a Jentic-cataloged Arazzo workflow (wf_*) and synthesizes a
    Naftiko capability YAML from its multi-step recipe — every step in
    the Arazzo workflow becomes a Naftiko consume operation; the workflow
    becomes the capability's exposed surface. Lets a Naftiko Fleet absorb
    the entire 2,000+ Jentic Arazzo workflow catalog as governed
    capabilities. The bridge between Jentic's standards-first catalog
    and Naftiko's spec-driven engine.
  tags:
    - Naftiko
    - Jentic
    - Partnership
    - Arazzo
    - Workflow-Import
    - Capability-Synthesis
    - Standards
  created: '2026-05-15'
  modified: '2026-05-15'

binds:
  - namespace: jentic-env
    description: Jentic agent-scoped API key.
    keys:
      JENTIC_API_KEY: JENTIC_API_KEY

capability:
  consumes:
    - namespace: jentic
      type: http
      baseUri: https://api.jentic.com
      authentication:
        type: bearer
        token: '{{JENTIC_API_KEY}}'
      resources:
        - name: load-workflow
          path: '/agents/load'
          operations:
            - name: load-workflow-spec
              method: POST
        - name: search-workflows
          path: '/agents/search'
          operations:
            - name: search-workflows
              method: POST
        - name: get-arazzo-source
          path: '/arazzo/{{workflow_id}}'
          operations:
            - name: get-arazzo-source
              method: GET
              inputParameters:
                - { name: workflow_id, in: path, required: true }

  exposes:
    - type: rest
      address: 0.0.0.0
      port: 8080
      namespace: jentic-arazzo-workflow-import-rest
      description: REST surface for synthesizing Naftiko capability YAML from Jentic Arazzo workflows.
      resources:
        - name: load-workflow-spec
          path: '/workflows/load'
          operations:
            - name: load-workflow-spec
              method: POST
              call: jentic.load-workflow-spec
        - name: search-workflows
          path: '/workflows/search'
          operations:
            - name: search-workflows
              method: POST
              call: jentic.search-workflows
        - name: get-arazzo-source
          path: '/workflows/{workflow_id}/arazzo'
          operations:
            - name: get-arazzo-source
              method: GET
              inputParameters:
                - { name: workflow_id, in: path, type: string, required: true }
              call: jentic.get-arazzo-source

    - type: mcp
      address: 0.0.0.0
      port: 3010
      namespace: jentic-arazzo-workflow-import-mcp
      description: MCP server for synthesizing Naftiko capabilities from Jentic Arazzo workflows.
      tools:
        - name: load-workflow-spec
          description: Hydrate the execution spec for one or more Jentic Arazzo workflows (used as input for capability synthesis).
          hints: { readOnly: true }
          call: jentic.load-workflow-spec
        - name: search-workflows
          description: Semantic search Jentic's 2,000+ Arazzo workflows.
          hints: { readOnly: true }
          call: jentic.search-workflows
        - name: get-arazzo-source
          description: Get the raw Arazzo source spec for a workflow (the input to Naftiko capability synthesis).
          hints: { readOnly: true }
          inputParameters:
            - { name: workflow_id, type: string, required: true, description: Jentic workflow UUID (wf_*). }
          call: jentic.get-arazzo-source