Arazzo Workflow Execution

naftiko: 1.0.0-alpha2
info:
  label: Arazzo Workflow Execution
  description: >-
    Workflow capability that executes multi-step Arazzo workflows through
    the Jentic platform. Wraps the canonical search → load → execute flow
    so an agent can ask for a capability by name (e.g. "create a Linear
    ticket and notify Slack") and Jentic resolves it to a server-side
    Arazzo workflow with managed credentials, parameter chaining between
    steps, and deterministic execution. Built on the OpenAPI Arazzo
    specification.
  tags:
    - Arazzo
    - Workflows
    - Multi Step
    - Jentic
  created: '2026-05-15'
  modified: '2026-05-15'
capability:
  consumes:
    - type: http
      namespace: jentic
      baseUri: https://api.jentic.com/api/v1
      authentication:
        type: apikey
        in: header
        name: X-JENTIC-API-KEY
        value: '{{JENTIC_AGENT_API_KEY}}'
      resources:
        - name: agents-search
          path: /agents/search
          operations:
            - name: searchWorkflows
              method: POST
              description: Search the catalog, optionally filtering for workflows.
              outputRawFormat: json
              outputParameters:
                - name: results
                  type: array
                  value: $.results[?(@.type=="workflow")]
        - name: agents-load
          path: /agents/load
          operations:
            - name: loadWorkflow
              method: POST
              description: Load the Arazzo workflow input schema and metadata.
              outputRawFormat: json
              outputParameters:
                - name: tool_info
                  type: object
                  value: $.tool_info
        - name: agents-execute
          path: /agents/execute
          operations:
            - name: executeWorkflow
              method: POST
              description: Execute an Arazzo workflow by UUID with chained inputs.
              outputRawFormat: json
              outputParameters:
                - name: output
                  type: object
                  value: $.output
                - name: execution_id
                  type: string
                  value: $.execution_id
  flow:
    - step: discover
      description: Find a workflow whose Arazzo description matches the user's goal.
      call: jentic.searchWorkflows
      inputs:
        query: '{{goal}}'
        limit: 5
    - step: inspect
      description: Load the workflow's input schema before invoking it.
      call: jentic.loadWorkflow
      inputs:
        ids:
          - '{{step.discover.results[0].uuid}}'
    - step: run
      description: Execute the workflow with the validated inputs.
      call: jentic.executeWorkflow
      inputs:
        execution_type: workflow
        uuid: '{{step.discover.results[0].uuid}}'
        inputs: '{{workflow_inputs}}'
  exposes:
    - type: rest
      port: 8080
      namespace: arazzo-workflow-rest
      description: REST adapter for the Arazzo workflow execution flow.
      resources:
        - path: /workflows/run
          name: runWorkflow
          operations:
            - method: POST
              name: runWorkflow
              description: One-shot search-load-execute for an Arazzo workflow.
              call: flow.discover_inspect_run
binds:
  - namespace: env
    keys:
      JENTIC_AGENT_API_KEY: JENTIC_AGENT_API_KEY