"nika: v1\nworkflow:\n  id: meeting-actions\n  description: \"Transcript → typed action items {owner, task, due}\"\n\n# A NON-thinking local model, deliberately: a thinking model can spend the\n# whole `max_tokens` budget in its think block and return before the JSON\n# (engine#428). Schema showcases pick a model that answers directly.\nmodel: ollama/llama3.2:3b\n\ninputs:\n  transcript_path:\n    type: string\n    default: \"examples/fixtures/meeting-transcript.txt\"\n    description: \"Path to the raw meeting transcript\"\npermits:\n  tools: [\"nika:log\", \"nika:read\", \"nika:write\"]\n  fs:\n    # The sample transcript, named as a LITERAL. `permits:` cannot interpolate\n    # (NIKA-AUTH-007), so this line does not follow `inputs.transcript_path`\n    # around: pointing the var at your own file means editing this entry too,\n    # or the read is refused at run with NIKA-SEC-004. That is the wall doing\n    # its job — a boundary you can read is a boundary a reviewer can check.\n    read: [\"examples/fixtures/meeting-transcript.txt\"]\n    write: [\"out/action-items.json\"]\n\ntasks:\n  transcript:\n    invoke:\n      tool: \"nika:read\"\n      args: { path: \"\u0024{{ inputs.transcript_path }}\" }\n\n  extract:\n    with:\n      transcript: \u0024{{ tasks.transcript.output }}\n    infer:\n      max_tokens: 900                  # a ceiling makes the cost report a number, not UNBOUNDED\n      prompt: |\n        Extract every action item from this meeting transcript ·\n        \u0024{{ with.transcript }}\n        One entry per commitment somebody actually made. `due` only when a\n        date or deadline was stated — never invent one.\n      schema:                          # the contract the model must satisfy\n        type: object\n        additionalProperties: false\n        required: [actions]\n        properties:\n          actions:\n            type: array\n            items:\n              type: object\n              additionalProperties: false\n              required: [owner, task]\n              properties:\n                owner: { type: string }\n                task: { type: string }\n                due: { type: string }\n\n  save:\n    with:\n      extract_actions: \u0024{{ tasks.extract.output.actions }}\n    invoke:\n      tool: \"nika:write\"\n      args:\n        # `.json` content is ONE interpolation of a real value — the engine\n        # serializes it. Typing `{ \"actions\": \u0024{{ … }} }` by hand emits\n        # unquoted fields and the artifact stops being JSON.\n        path: out/action-items.json\n        content: \"\u0024{{ with.extract_actions }}\"\n        create_dirs: true\n\n  trace:\n    after:\n      extract: success\n    invoke:\n      tool: \"nika:log\"\n      args:\n        level: info\n        message: \"Action items extracted to out/action-items.json\"\n\noutputs:\n  actions:\n    value: \u0024{{ tasks.extract.output.actions }}\n    description: \"Typed action items, tracker-ready\"\n"

{"a":{"graph_format":2,"workflow":"meeting-actions","nodes":[{"id":"transcript","verb":"invoke","tool":"nika:read","permits":["tool: nika:read"]},{"id":"extract","verb":"infer","model":"ollama/llama3.2:3b","permits":[]},{"id":"save","verb":"invoke","tool":"nika:write","permits":["fs.write: out/action-items.json","tool: nika:write"]},{"id":"trace","verb":"invoke","tool":"nika:log","permits":["tool: nika:log"]}],"edges":[{"from":"extract","to":"save","kind":"value"},{"from":"extract","to":"trace","kind":"control"},{"from":"transcript","to":"extract","kind":"value"}]},"engine":"0.106.1"}

showcase · tier 1 · business

Meeting actions

A transcript goes in, typed {owner, task, due} items come out, validated and ready for your tracker.

Nobody re-reads the transcript. The tracker import is already done. · conformance-gated in nika-spec ↗ · re-proven at every push

4tasksthe plan falls out of the bindings
3wavesparallel by construction
2verbs exercisedinvoke · infer
T1the tierbusiness

The whole file

4 tasks · 3 waves

The plan falls out of the bindings, nothing is scheduled by hand.

meeting-actions.nika.yamlsource

1nika: v12workflow:3  id: meeting-actions4  description: "Transcript → typed action items {owner, task, due}"56# A NON-thinking local model, deliberately: a thinking model can spend the7# whole `max_tokens` budget in its think block and return before the JSON8# (engine#428). Schema showcases pick a model that answers directly.9model: ollama/llama3.2:3b1011inputs:12  transcript_path:13    type: string14    default: "examples/fixtures/meeting-transcript.txt"15    description: "Path to the raw meeting transcript"16⛨permits:17  ⛨tools: ["nika:log", "nika:read", "nika:write"]18  ⛨fs:19    # The sample transcript, named as a LITERAL. `permits:` cannot interpolate20    # (NIKA-AUTH-007), so this line does not follow `inputs.transcript_path`21    # around: pointing the var at your own file means editing this entry too,22    # or the read is refused at run with NIKA-SEC-004. That is the wall doing23    # its job — a boundary you can read is a boundary a reviewer can check.24    ⛨read: ["examples/fixtures/meeting-transcript.txt"]25    ⛨write: ["out/action-items.json"]2627tasks:28  transcript:29    ◆invoke:30      tool: "nika:read"31      args: { path: "${{ inputs.transcript_path }}" }3233  extract:34    with:35      transcript: ${{ tasks.transcript.output }}36    ◇infer:37      max_tokens: 900                  # a ceiling makes the cost report a number, not UNBOUNDED38      prompt: |39        Extract every action item from this meeting transcript ·40        ${{ with.transcript }}41        One entry per commitment somebody actually made. `due` only when a42        date or deadline was stated — never invent one.43      schema:                          # the contract the model must satisfy44        type: object45        additionalProperties: false46        required: [actions]47        properties:48          actions:49            type: array50            items:51              type: object52              additionalProperties: false53              required: [owner, task]54              properties:55                owner: { type: string }56                task: { type: string }57                due: { type: string }5859  save:60    with:61      extract_actions: ${{ tasks.extract.output.actions }}62    ◆invoke:63      tool: "nika:write"64      args:65        # `.json` content is ONE interpolation of a real value — the engine66        # serializes it. Typing `{ "actions": ${{ … }} }` by hand emits67        # unquoted fields and the artifact stops being JSON.68        path: out/action-items.json69        content: "${{ with.extract_actions }}"70        create_dirs: true7172  trace:73    after:74      extract: success75    ◆invoke:76      tool: "nika:log"77      args:78        level: info79        message: "Action items extracted to out/action-items.json"8081outputs:82  actions:83    value: ${{ tasks.extract.output.actions }}84    description: "Typed action items, tracker-ready"85

audited · 3 tasks · 3 waves · permits declared · 1 hintnika 0.106.1

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

3 declared edges · 3 waves · the plan falls out of the bindings

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