Interface: CompileOptions

Defined in: apps/paracosm/src/engine/compiler/types.ts:37

Options for compileScenario().

Properties

cache?

optional cache: boolean

Defined in: apps/paracosm/src/engine/compiler/types.ts:43

Whether to use disk caching. Default: true.

---

cacheDir?

optional cacheDir: string

Defined in: apps/paracosm/src/engine/compiler/types.ts:45

Base directory for the disk cache. Default: '.paracosm/cache'.

---

generateText?

optional generateText: GenerateTextFn

Defined in: apps/paracosm/src/engine/compiler/types.ts:47

Custom generateText function (overrides provider/model).

---

maxSearches?

optional maxSearches: number

Defined in: apps/paracosm/src/engine/compiler/types.ts:57

Max web searches during seed ingestion. Default: 5.

---

model?

optional model: string

Defined in: apps/paracosm/src/engine/compiler/types.ts:41

Model name for hook generation.

---

onProgress()?

optional onProgress: (hookName, status) => void

Defined in: apps/paracosm/src/engine/compiler/types.ts:49

Progress callback for each hook being generated.

Parameters

hookName

string

status

"generating" | "cached" | "done" | "fallback"

Returns

void

---

provider?

optional provider: LlmProvider

Defined in: apps/paracosm/src/engine/compiler/types.ts:39

LLM provider to use for hook generation.

---

seedText?

optional seedText: string

Defined in: apps/paracosm/src/engine/compiler/types.ts:51

Seed text to ingest into the scenario's knowledge bundle via LLM extraction + optional web search.

---

seedUrl?

optional seedUrl: string

Defined in: apps/paracosm/src/engine/compiler/types.ts:53

Seed URL to fetch and ingest. If set, seedText is ignored.

---

telemetry?

optional telemetry: CompilerTelemetry

Defined in: apps/paracosm/src/engine/compiler/types.ts:64

Optional telemetry sink that collects per-hook attempt counts and any exhausted-retry fallbacks. Use when you want to surface compile reliability in a dashboard or snapshot into /retry-stats. See CompilerTelemetry.

---

webSearch?

optional webSearch: boolean

Defined in: apps/paracosm/src/engine/compiler/types.ts:55

Enable live web search during seed ingestion. Requires search API keys. Default: true.