nika: v1
workflow:
  id: support-triage
  description: "Ticket queue → typed triage → urgent escalation → triage board"

model: ollama/qwen3.5:4b   # local · zero key · swap for groq/llama-3.3-70b (triage wants speed)

vars:
  queue_path: "./support/overnight-queue.json"

secrets:
  oncall_webhook:
    source: env
    key: ONCALL_WEBHOOK_URL
    egress:                       # sanction the one send · the secret IS the URL
      - to: "nika:notify"
        host_from_self: true

tasks:
  batch:
    invoke:
      tool: "nika:uuid"
      args: { version: v7 }

  queue:
    invoke:
      tool: "nika:read"
      args: { path: "${{ vars.queue_path }}" }

  triage:
    with:
      queue: ${{ tasks.queue.output }}
    infer:
      prompt: |
        Triage every ticket in this queue ·
        ${{ with.queue }}
        For each · classify category and urgency, draft a 2-sentence first reply.
      schema:
        type: object
        required: [tickets]
        properties:
          tickets:
            type: array
            items:
              type: object
              required: [id, category, urgency, first_reply]
              properties:
                id: { type: string }
                category: { type: string, enum: [billing, bug, how-to, account, other] }
                urgency: { type: string, enum: [low, normal, high, critical] }
                first_reply: { type: string }

  urgent:
    with:
      tickets: ${{ tasks.triage.output.tickets }}
    invoke:
      tool: "nika:jq"
      args:
        input: "${{ with.tickets }}"
        expression: 'map(select(.urgency == "high" or .urgency == "critical"))'

  escalate:
    with:
      urgent: ${{ tasks.urgent.output }}
      batch: ${{ tasks.batch.output }}
    when: ${{ size(with.urgent) > 0 }}
    invoke:
      tool: "nika:notify"
      args:
        channel: webhook
        target: "${{ secrets.oncall_webhook }}"
        message: "Urgent tickets in triage batch ${{ with.batch }} · ${{ with.urgent }}"
        severity: warning

  board:
    with:
      tickets: ${{ tasks.triage.output.tickets }}
      batch: ${{ tasks.batch.output }}
    invoke:
      tool: "nika:write"
      args:
        path: "./support/triage-${{ with.batch }}.json"
        content: "${{ with.tickets }}"

outputs:
  tickets:
    value: ${{ tasks.triage.output.tickets }}
    description: "The classified queue with drafted first replies"

{"a":{"graph_format":2,"workflow":"support-triage","nodes":[{"id":"batch","verb":"invoke","tool":"nika:uuid","permits":["tool: nika:uuid"]},{"id":"queue","verb":"invoke","tool":"nika:read","permits":["tool: nika:read"]},{"id":"triage","verb":"infer","model":"ollama/qwen3.5:4b","permits":[]},{"id":"urgent","verb":"invoke","tool":"nika:jq","permits":["tool: nika:jq"]},{"id":"board","verb":"invoke","tool":"nika:write","permits":["tool: nika:write"]},{"id":"escalate","verb":"invoke","tool":"nika:notify","when":"${{ size(with.urgent) > 0 }}","permits":["tool: nika:notify"]}],"edges":[{"from":"batch","to":"board","kind":"value"},{"from":"batch","to":"escalate","kind":"value"},{"from":"queue","to":"triage","kind":"value"},{"from":"triage","to":"board","kind":"value"},{"from":"triage","to":"urgent","kind":"value"},{"from":"urgent","to":"escalate","kind":"value"}]},"engine":"0.105.0"}

showcase · tier 2 · ops & support

Support triage

The overnight queue gets classified with schema enums, first replies drafted, urgent tickets escalated.

By 9am the board is tagged, drafted and batched. Humans handle the hard ones. · conformance-gated in nika-spec ↗ · re-proven at every push

The whole file

6 tasks · 4 waves · the plan falls out of the bindings, nothing is scheduled by hand.

t2-support-triage.nika.yamlsource

1nika: v12workflow:3  id: support-triage4  description: "Ticket queue → typed triage → urgent escalation → triage board"56model: ollama/qwen3.5:4b   # local · zero key · swap for groq/llama-3.3-70b (triage wants speed)78vars:9  queue_path: "./support/overnight-queue.json"1011secrets:12  oncall_webhook:13    source: env14    key: ONCALL_WEBHOOK_URL15    egress:                       # sanction the one send · the secret IS the URL16      - to: "nika:notify"17        host_from_self: true1819tasks:20  batch:21    ◆invoke:22      tool: "nika:uuid"23      args: { version: v7 }2425  queue:26    ◆invoke:27      tool: "nika:read"28      args: { path: "${{ vars.queue_path }}" }2930  triage:31    with:32      queue: ${{ tasks.queue.output }}33    ◇infer:34      prompt: |35        Triage every ticket in this queue ·36        ${{ with.queue }}37        For each · classify category and urgency, draft a 2-sentence first reply.38      schema:39        type: object40        required: [tickets]41        properties:42          tickets:43            type: array44            items:45              type: object46              required: [id, category, urgency, first_reply]47              properties:48                id: { type: string }49                category: { type: string, enum: [billing, bug, how-to, account, other] }50                urgency: { type: string, enum: [low, normal, high, critical] }51                first_reply: { type: string }5253  urgent:54    with:55      tickets: ${{ tasks.triage.output.tickets }}56    ◆invoke:57      tool: "nika:jq"58      args:59        input: "${{ with.tickets }}"60        expression: 'map(select(.urgency == "high" or .urgency == "critical"))'6162  escalate:63    with:64      urgent: ${{ tasks.urgent.output }}65      batch: ${{ tasks.batch.output }}66    when: ${{ size(with.urgent) > 0 }}67    ◆invoke:68      tool: "nika:notify"69      args:70        channel: webhook71        target: "${{ secrets.oncall_webhook }}"72        message: "Urgent tickets in triage batch ${{ with.batch }} · ${{ with.urgent }}"73        severity: warning7475  board:76    with:77      tickets: ${{ tasks.triage.output.tickets }}78      batch: ${{ tasks.batch.output }}79    ◆invoke:80      tool: "nika:write"81      args:82        path: "./support/triage-${{ with.batch }}.json"83        content: "${{ with.tickets }}"8485outputs:86  tickets:87    value: ${{ tasks.triage.output.tickets }}88    description: "The classified queue with drafted first replies"89

nika inspect · engine 0.105.0 · vendored graph, never re-derived

6 declared edges · 4 waves · the plan falls out of the bindings

try itopen in the playground guidethe walkthrough · docs verbinvoke verbinfer toolnika:uuid toolnika:read toolnika:jq toolnika:notify toolnika:write