nika: v1
workflow:
  id: transcript-shownotes
  description: "Raw transcript → typed show-notes (chapters · quotes · summary) · one bounded infer"

model: ollama/llama3.2:3b # local · zero key · deliberately NOT the qwen3.5 convention: a thinking model can burn max_tokens in its think block before the JSON (engine#428) — schema showcases pick a non-thinking model

vars:
  transcript: "./data/transcript.txt"

permits:
  exec: false
  fs:
    read: ["data/**"]
    write: ["out/**"]
  tools: ["nika:read", "nika:jq", "nika:write"]

tasks:
  raw:
    invoke:
      tool: "nika:read"
      args: { path: "${{ vars.transcript }}" }

  # ONE bounded model call · the schema is the contract, not a suggestion.
  notes:
    with:
      raw: ${{ tasks.raw.output }}
    infer:
      prompt: |
        Turn this transcript into show-notes. Ground every chapter title
        and quote in the text — invent nothing.

        Transcript ·
        ${{ with.raw }}
      max_tokens: 800
      schema:
        type: object
        additionalProperties: false # a deterministic shape across providers (the checker's strictness hint)
        required: [summary, chapters, quotes]
        properties:
          summary: { type: string }
          chapters:
            type: array
            items:
              type: object
              additionalProperties: false
              required: [title, gist]
              properties:
                title: { type: string }
                gist: { type: string }
          quotes:
            type: array
            items: { type: string }

  # Typed JSON → markdown lines · mechanical, zero second model call.
  sections:
    with:
      notes: ${{ tasks.notes.output }}
    invoke:
      tool: "nika:jq"
      args:
        input: "${{ with.notes }}"
        expression: >-
          {
            chapters: (.chapters | map("- **\(.title)** — \(.gist)") | join("\n")),
            quotes: (.quotes | map("> \(.)") | join("\n\n"))
          }

  page:
    with:
      notes_summary: ${{ tasks.notes.output.summary }}
      sections_chapters: ${{ tasks.sections.output.chapters }}
      sections_quotes: ${{ tasks.sections.output.quotes }}
    invoke:
      tool: "nika:write"
      args:
        path: out/show-notes.md
        content: |
          # Show notes

          ${{ with.notes_summary }}

          ## Chapters

          ${{ with.sections_chapters }}

          ## Pull quotes

          ${{ with.sections_quotes }}

          *Generated by [nika](https://nika.sh) · one bounded infer, typed output · the run's trace is the receipt.*

outputs:
  notes:
    value: ${{ tasks.notes.output }}
    description: "The typed show-notes · summary + chapters + quotes"

{"a":{"graph_format":2,"workflow":"transcript-shownotes","nodes":[{"id":"raw","verb":"invoke","tool":"nika:read","permits":["tool: nika:read"]},{"id":"notes","verb":"infer","model":"ollama/llama3.2:3b","permits":[]},{"id":"sections","verb":"invoke","tool":"nika:jq","permits":["tool: nika:jq"]},{"id":"page","verb":"invoke","tool":"nika:write","permits":["fs.write: out/show-notes.md","tool: nika:write"]}],"edges":[{"from":"notes","to":"page","kind":"value"},{"from":"notes","to":"sections","kind":"value"},{"from":"raw","to":"notes","kind":"value"},{"from":"sections","to":"page","kind":"value"},{"from":"sections","to":"page","kind":"value"}]},"engine":"0.105.0"}

showcase · tier 2 · content

Transcript show-notes

One bounded infer extracts chapters, quotes and summary as schema-typed data; jq and write render the page.

Episode recorded → notes publishable, for the price of exactly one model call. · conformance-gated in nika-spec ↗ · re-proven at every push

The whole file

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

t2-transcript-shownotes.nika.yamlsource

1nika: v12workflow:3  id: transcript-shownotes4  description: "Raw transcript → typed show-notes (chapters · quotes · summary) · one bounded infer"56model: ollama/llama3.2:3b # local · zero key · deliberately NOT the qwen3.5 convention: a thinking model can burn max_tokens in its think block before the JSON (engine#428) — schema showcases pick a non-thinking model78vars:9  transcript: "./data/transcript.txt"1011permits:12  ▷exec: false13  fs:14    read: ["data/**"]15    write: ["out/**"]16  tools: ["nika:read", "nika:jq", "nika:write"]1718tasks:19  raw:20    ◆invoke:21      tool: "nika:read"22      args: { path: "${{ vars.transcript }}" }2324  # ONE bounded model call · the schema is the contract, not a suggestion.25  notes:26    with:27      raw: ${{ tasks.raw.output }}28    ◇infer:29      prompt: |30        Turn this transcript into show-notes. Ground every chapter title31        and quote in the text — invent nothing.3233        Transcript ·34        ${{ with.raw }}35      max_tokens: 80036      schema:37        type: object38        additionalProperties: false # a deterministic shape across providers (the checker's strictness hint)39        required: [summary, chapters, quotes]40        properties:41          summary: { type: string }42          chapters:43            type: array44            items:45              type: object46              additionalProperties: false47              required: [title, gist]48              properties:49                title: { type: string }50                gist: { type: string }51          quotes:52            type: array53            items: { type: string }5455  # Typed JSON → markdown lines · mechanical, zero second model call.56  sections:57    with:58      notes: ${{ tasks.notes.output }}59    ◆invoke:60      tool: "nika:jq"61      args:62        input: "${{ with.notes }}"63        expression: >-64          {65            chapters: (.chapters | map("- **\(.title)** — \(.gist)") | join("\n")),66            quotes: (.quotes | map("> \(.)") | join("\n\n"))67          }6869  page:70    with:71      notes_summary: ${{ tasks.notes.output.summary }}72      sections_chapters: ${{ tasks.sections.output.chapters }}73      sections_quotes: ${{ tasks.sections.output.quotes }}74    ◆invoke:75      tool: "nika:write"76      args:77        path: out/show-notes.md78        content: |79          # Show notes8081          ${{ with.notes_summary }}8283          ## Chapters8485          ${{ with.sections_chapters }}8687          ## Pull quotes8889          ${{ with.sections_quotes }}9091          *Generated by [nika](https://nika.sh) · one bounded infer, typed output · the run's trace is the receipt.*9293outputs:94  notes:95    value: ${{ tasks.notes.output }}96    description: "The typed show-notes · summary + chapters + quotes"97

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

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

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