"nika: v1\nworkflow:\n  id: og-images\n  description: \"Generate the launch OG hero image set into out/og\"\n\npermits:\n  tools: [\"nika:image_generate\"]\n  fs:\n    # `check` judges the `output_dir:` ARGUMENT; the RUN gates every FINAL\n    # file path under it — the images, their provenance sidecars and\n    # manifest.json. `**` covers the directory AND every descendant, so one\n    # entry answers both. Granting the bare directory (`out/og`) passes\n    # `check` and then dies at run on the first asset: measured, and the\n    # reason this comment exists.\n    write: [\"out/og/**\"]\n\ntasks:\n  hero:\n    invoke:\n      tool: \"nika:image_generate\"\n      args:\n        provider: mock                # offline + deterministic · flip to local/gemini/openai to render for real\n        prompt: \"OG hero — a monarch butterfly over a deep-blue nebula, editorial photo, negative space left\"\n        aspect_ratio: \"16:9\"          # exact WxH is an openai gpt-image-2 feature · gemini folds to a size class\n        n: 2                          # two variants to A/B\n        output_dir: \"out/og\"\n        filename_prefix: \"launch-hero\"\n        metadata: { campaign: \"launch\", page_slug: \"home\" }\n\noutputs:\n  paths: \u0024{{ tasks.hero.output.images }}\n  manifest: \u0024{{ tasks.hero.output.manifest_path }}\n"

{"a":{"graph_format":2,"workflow":"og-images","nodes":[{"id":"hero","verb":"invoke","tool":"nika:image_generate","permits":["fs.write: out/og/**","tool: nika:image_generate"]}],"edges":[]},"engine":"0.106.1"}

showcase · tier 1 · business

OG images

Brief in, OG variants on disk + a provenance manifest out. Mock renders real PNGs offline; flip one line for your local server (sovereign), gemini, openai or xai. Real spend lands on the run ledger.

Every save permit-gated, every byte sha256-verified, provenance embedded in the PNG itself. No other engine treats images this honestly. · conformance-gated in nika-spec ↗ · re-proven at every push

1taskthe plan falls out of the bindings
1waveparallel by construction
1verbs exercisedinvoke
T1the tierbusiness

The whole file

1 task · 1 wave

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

og-images.nika.yamlsource

1nika: v12workflow:3  id: og-images4  description: "Generate the launch OG hero image set into out/og"56⛨permits:7  ⛨tools: ["nika:image_generate"]8  ⛨fs:9    # `check` judges the `output_dir:` ARGUMENT; the RUN gates every FINAL10    # file path under it — the images, their provenance sidecars and11    # manifest.json. `**` covers the directory AND every descendant, so one12    # entry answers both. Granting the bare directory (`out/og`) passes13    # `check` and then dies at run on the first asset: measured, and the14    # reason this comment exists.15    ⛨write: ["out/og/**"]1617tasks:18  hero:19    ◆invoke:20      tool: "nika:image_generate"21      args:22        provider: mock                # offline + deterministic · flip to local/gemini/openai to render for real23        prompt: "OG hero — a monarch butterfly over a deep-blue nebula, editorial photo, negative space left"24        aspect_ratio: "16:9"          # exact WxH is an openai gpt-image-2 feature · gemini folds to a size class25        n: 2                          # two variants to A/B26        output_dir: "out/og"27        filename_prefix: "launch-hero"28        metadata: { campaign: "launch", page_slug: "home" }2930outputs:31  paths: ${{ tasks.hero.output.images }}32  manifest: ${{ tasks.hero.output.manifest_path }}33

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

0 declared edges · 1 wave · the plan falls out of the bindings

try itopen in the playground guidethe walkthrough · docs verbinvoke toolnika:image_generate