gpt-image-2 multi-image + fix: tools need reasoning_effort none on gpt-5.6 (ggg mute bug)

specs/SPEC-001-responder-envelope.md

@@ -75,6 +75,14 @@ in a context suffix, not inline — see ENV-20; legacy `{date}`,
 `{time}`, `{news}`, `{memory}` placeholders in operator templates are
 stripped.
 
+### ENV-21 — Tool calls disable reasoning effort (coverage: test)
+
+When function tools are attached to a chat call, the call carries
+`reasoning_effort` (config `reasoning-effort`, default `"none"`) —
+gpt-5.6 models reject tools + reasoning on chat/completions with a
+400 otherwise (found live on ggg 2026-07-13: IGDB tools made Luma
+mute after the Luna cutover). Tool-less calls stay untouched.
+
 ### ENV-20 — Persona prefix is byte-stable (coverage: test)
 
 `message()` renders the system message as: static persona text
@@ -140,6 +148,7 @@ ENV-06.
 
 Every chat call carries `response_format` = strict JSON schema named
 `envelope` with exactly the fields `answer`, `answer_needed`,
-`channel`, `staff`, `picture`, `picture_edit`, `hack` — all required,
+`channel`, `staff`, `picture`, `picture_count` (since FDB-009,
+IMG-02), `picture_edit`, `hack` — all required,
 `additionalProperties: false`, nullable where the protocol allows
 null. Tool-followup calls carry the same format.

specs/SPEC-004-images.md

@@ -0,0 +1,39 @@
+# SPEC-004 — Image generation
+
+Generation on `image-model` (default `gpt-image-2`), base64 end to
+end — no URL downloads, no expiring CDN links in the generation path.
+Optional knobs: `image-size` (default 1024x1024), `image-quality`
+(passed through only when set). The Leonardo path stays behind
+`leonardo-token` until parity is confirmed, then dies. The input
+pipeline (attachment cache, vision, edit/remix) is FDB-010 / IMG-10+.
+
+### IMG-01 — Images arrive as base64 buffers (coverage: test)
+
+`draw_openai(description, count)` requests `count` images and returns
+a list of decoded image buffers straight from the API response; every
+generated image is metered in the ledger (SAF-05).
+
+### IMG-02 — The envelope carries picture_count (coverage: test)
+
+The envelope gains `picture_count` (integer). `post_process` clamps
+it to 1..4 and defaults to 1 when absent (legacy history entries,
+old-model output). ENV-19's field list is revised accordingly.
+
+### IMG-03 — Multiple images, one message (coverage: test)
+
+`picture_count` images are attached as multiple files to a single
+Discord send (the last part when the answer is split, per BEH-06).
+
+### IMG-04 — Legacy image models degrade safely (coverage: test)
+
+When `image-model` is not a `gpt-image-*` model (e.g. `dall-e-3`),
+the count is clamped to 1 and `response_format="b64_json"` is
+requested explicitly (gpt-image models return base64 natively and
+reject the parameter).
+
+### IMG-05 — Picture prompts go to the API untouched (coverage: test)
+
+The translate-before-draw step is deleted: the model's picture prompt
+reaches the image API verbatim (current image models handle
+Norwegian/German natively). The `translate()` method and its
+`fix-model` dependency are gone (closes D-009).