# @openmaic/generation

Pure generation pipeline contracts and packaged prompt assets for MAIC consumers.

`AICallFn` is the package's model seam: callers provide a function that accepts
system and user prompts and returns model output. The package does not select a
provider, read environment configuration, or own persistence.

Prompt templates and their referenced snippets ship as readable Markdown assets
under `templates/` and `snippets/`. The loader resolves them relative to the
installed package, so it works from both source tests and compiled output.

Scene generation is available as independent content, action, and assembly
primitives. A caller can generate one outline, pass it to `generateSceneContent`
and `generateSceneActions`, then assemble the DSL value with
`buildCompleteScene`. Retrying consumers can supply `sceneId` to preserve scene
identity across replays.

PBL scenes use the same `AICallFn` seam for single-call planning. Hosts that
need an agentic fallback may inject `pblLoopFallback`; provider selection and
fallback execution remain caller-owned. The two planner templates ship under
`prompts-pbl/` and resolve relative to the installed package.