OptionalmaxTokens?: numberUpper bound on completion tokens for this call. Caps tail spend when a model misbehaves and yaps beyond the intended output size (provider defaults sit at 4-8k tokens). Use ~2× the typical response size so well-behaved calls finish naturally and only runaway generations hit the cap.
Optionalsystem?: { cacheBreakpoint?: boolean; text: string }[]
Function signature for LLM text generation calls used by compile hooks.
Supports two call shapes:
{ system, prompt }to route the stable prefix through cacheBreakpoint-tagged system blocksWrappers in llm-invocations/ always use the cache-aware form; direct callers (CLI scripts, tests) can still use the string form.