Inngest Durable Workflow

naftiko: 1.0.0-alpha2
info:
  label: Inngest Durable Workflow
  description: 'Composed Naftiko capability that drives a complete Inngest durable workflow lifecycle: send an event, list functions triggered, fetch the canonical run summary, fetch the trace tree, and cancel if needed. Wraps Inngest Events, Functions, and Runs as a single business capability.'
  tags:
  - Inngest
  - Workflows
  - Durable Execution
  - Composition
  - AI Agents
  created: '2026-05-22'
  modified: '2026-05-22'
binds:
- namespace: env
  keys:
    INNGEST_SIGNING_KEY: INNGEST_SIGNING_KEY
    INNGEST_EVENT_KEY: INNGEST_EVENT_KEY
capability:
  consumes:
  - type: http
    namespace: inngest-workflow
    baseUri: https://api.inngest.com
    description: Compose end-to-end durable workflow orchestration over the Inngest REST surface.
    resources:
    - name: ingest
      path: /e/{eventKey}
      operations:
      - name: triggerWorkflow
        method: POST
        description: Trigger an Inngest workflow by sending the originating event.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: eventKey
          in: path
          type: string
          required: true
        - name: body
          in: body
          type: object
          required: true
    - name: functions
      path: /v1/functions
      operations:
      - name: discoverFunctions
        method: GET
        description: Discover the deployed functions that can be triggered.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: run
      path: /v2/runs/{runId}
      operations:
      - name: getCanonicalRun
        method: GET
        description: Fetch the canonical run summary for a workflow execution.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: runId
          in: path
          type: string
          required: true
    - name: trace
      path: /v2/runs/{runId}/trace
      operations:
      - name: getRunTrace
        method: GET
        description: Fetch the trace tree of a workflow execution.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: runId
          in: path
          type: string
          required: true
    - name: cancel
      path: /v1/runs/{runId}/cancel
      operations:
      - name: cancelWorkflow
        method: POST
        description: Cancel a queued or running workflow.
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: runId
          in: path
          type: string
          required: true
    authentication:
      type: bearer
      token: '{{env.INNGEST_SIGNING_KEY}}'
  exposes:
  - type: rest
    namespace: inngest-workflow-rest
    port: 8080
    description: REST adapter that exposes the composed Inngest durable workflow lifecycle.
    resources:
    - path: /v1/workflows/trigger/{eventkey}
      name: workflows-trigger
      description: Trigger a workflow by ingesting an event.
      operations:
      - method: POST
        name: triggerWorkflow
        description: Trigger a workflow.
        call: inngest-workflow.triggerWorkflow
        with:
          eventKey: rest.eventKey
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workflows/functions
      name: workflows-functions
      description: Discover functions that can be triggered.
      operations:
      - method: GET
        name: discoverFunctions
        description: Discover deployed functions.
        call: inngest-workflow.discoverFunctions
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workflows/runs/{runid}
      name: workflows-run
      description: Get a workflow run summary.
      operations:
      - method: GET
        name: getCanonicalRun
        description: Get canonical workflow run.
        call: inngest-workflow.getCanonicalRun
        with:
          runId: rest.runId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workflows/runs/{runid}/trace
      name: workflows-run-trace
      description: Get a workflow run trace tree.
      operations:
      - method: GET
        name: getRunTrace
        description: Get workflow trace tree.
        call: inngest-workflow.getRunTrace
        with:
          runId: rest.runId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/workflows/runs/{runid}/cancel
      name: workflows-run-cancel
      description: Cancel a workflow.
      operations:
      - method: POST
        name: cancelWorkflow
        description: Cancel a workflow run.
        call: inngest-workflow.cancelWorkflow
        with:
          runId: rest.runId
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: inngest-workflow-mcp
    port: 9090
    transport: http
    description: MCP adapter that exposes durable workflow orchestration tools to coding agents.
    tools:
    - name: trigger-workflow
      description: Trigger a durable Inngest workflow by sending an event.
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: inngest-workflow.triggerWorkflow
      with:
        eventKey: tools.eventKey
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: discover-functions
      description: Discover deployed Inngest functions.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: inngest-workflow.discoverFunctions
      outputParameters:
      - type: object
        mapping: $.
    - name: get-canonical-run
      description: Get the canonical run summary for a workflow.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: inngest-workflow.getCanonicalRun
      with:
        runId: tools.runId
      outputParameters:
      - type: object
        mapping: $.
    - name: get-run-trace
      description: Get the trace tree for a workflow run.
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: inngest-workflow.getRunTrace
      with:
        runId: tools.runId
      outputParameters:
      - type: object
        mapping: $.
    - name: cancel-workflow
      description: Cancel a workflow run.
      hints:
        readOnly: false
        destructive: true
        idempotent: false
      call: inngest-workflow.cancelWorkflow
      with:
        runId: tools.runId
      outputParameters:
      - type: object
        mapping: $.