AGPL-3.0-or-later · forever.

the standard library

nika:inspect

Introspect the running workflow · view: cost | records | dag_info | threads. One of 28 builtins in the closed nika: namespace.

the introspection familythe workflow looking at itself

  • introspectionfamily2 tools
  • 1argsdeclared contract
  • 1requiredcheck teaches a miss
  • craftedusage filecheck-green below

the contract

1 args · 1 required

A missing required arg is a nika check finding before anything runs; the vocabulary below comes from the binary itself (nika catalog --tools --json), not from prose.

view*
stringcost | records | dag_info | threads

in a real file

a complete workflow
inspect.nika.yaml
nika: v1workflow:  id: watch-the-meter  description: "the workflow looks at its own run — cost as data, mid-flight"tasks:  spend:    invoke:      tool: "nika:inspect"      args: { view: cost }  report:    with:      spend: ${{ tasks.spend.output }}    invoke:      tool: "nika:log"      args:        level: info        message: "cost so far"        data: ${{ with.spend }}

a complete file, nika check green; the drift gate re-validates this copy against the schema on every test run. open it in the playground →

cross-references

ships in skeletons

no skeleton ships it; the crafted file above is the reference.

the check gates

the introspection family

2 tools

the workflow looking at itself.

Machines read the same vocabulary at /tools/catalog.json; the contract lives in spec 06 · stdlib. Install and ask the binary itself: nika catalog --tools. Read the spec →