apiVersion: naftiko.dev/v1
kind: WorkflowCapability
metadata:
  name: duckduckgo-instant-answer-search
  description: >-
    Compose the Instant Answer API into a single privacy-respecting topic
    lookup that combines topic abstract retrieval, disambiguation, and
    bang-aware redirect handling.
spec:
  inputs:
    - name: query
      type: string
      required: true
  steps:
    - id: try_bang
      capability: ddg.instant_answer.resolve_bang
      when: input.query startsWith '!'
      output: bangRedirect
    - id: lookup
      capability: ddg.instant_answer.lookup_topic
      when: not steps.try_bang.executed
      output: topic
    - id: disambig
      capability: ddg.instant_answer.disambiguate
      when: steps.lookup.output.Type == 'D'
      output: choices
  output:
    bangRedirect: steps.try_bang.output.Redirect
    abstract: steps.lookup.output
    disambiguation: steps.disambig.output
  governance:
    attribution_required: true
    attribution_text: "Results via DuckDuckGo"