@mulmoclaude/core 0.19.0 → 0.19.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -118,6 +118,35 @@ The filename (sans `.css`) is the theme slug; only `[A-Za-z0-9_-]` is
118
118
  allowed. Reload the browser tab after adding a theme — preview caches
119
119
  per session.
120
120
 
121
+ ## MulmoScript render — "generate error" from image / movie / audio generation
122
+
123
+ ### Symptoms
124
+
125
+ - A beat render, character image, movie, or PDF generation fails with a
126
+ message like `generateReferenceImage: generate error: key=<name>` or
127
+ `Image was not generated`.
128
+ - `autoGenerateMovie` leaves a `<script>.json.error.txt` sidecar next to
129
+ the story file with a similar message.
130
+
131
+ ### Cause
132
+
133
+ Generation providers are chosen **per script**: `imageParams.provider`,
134
+ `movieParams.provider`, and `speechParams.speakers.<name>.provider`. The
135
+ underlying failure is usually a missing/invalid API key for whichever
136
+ provider the script names (`openai` → `OPENAI_API_KEY`, `google` /
137
+ `gemini` → `GEMINI_API_KEY`, `replicate` → `REPLICATE_API_TOKEN`), or a
138
+ quota / moderation rejection from that provider.
139
+
140
+ ### Fix
141
+
142
+ The server appends the provider's own error to the message (e.g.
143
+ `… — 401 Incorrect API key provided`) and logs it under the
144
+ `mulmocast` prefix — read that detail first. Then either add the
145
+ missing key to `.env` (restart the server) or rewrite the script's
146
+ `imageParams` / `movieParams` / speaker providers to ones that have
147
+ keys configured. Don't retry the render unchanged — the same provider
148
+ will fail the same way.
149
+
121
150
  ## Build / yarn workspace ordering
122
151
 
123
152
  ### Symptoms
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mulmoclaude/core",
3
- "version": "0.19.0",
3
+ "version": "0.19.1",
4
4
  "description": "Shared server-side core for MulmoClaude and MulmoTerminal — the always-shipped-together subsystems consolidated behind subpath exports so the two hosts can't drift. Server-only except the browser-safe ./whisper/client, ./workspace-setup/slug, ./translation/client, ./remote-view and ./remote-host entries. All host specifics are injected.",
5
5
  "type": "module",
6
6
  "exports": {