levrops-contracts 1.3.5 → 1.3.6

package/README.md

@@ -217,21 +217,21 @@ All endpoints are under `/api/v1/editorial/`:
 - `examples/editorial/instagram-channel.json` - Example channel
 - `examples/editorial/fashion-topic.json` - Example topic
 
-## Sketch Bloom (Constellation Audio) Contracts
+## Audio Generation (Platform) Contracts
 
-Shared contracts for the constellation sketch-bloom audio system used by StudioOps and LevrOps. Provider-agnostic; no ElevenLabs or other provider-specific structure in shared schemas.
+Platform-level capability for **audio generation**: short generated audio from contextual inputs (chords, text, concepts). Reusable by any LevrOps surface (constellation, education, meditation, game cues, coaching, etc.). Product surface constructs a request → LevrOps executes generation → provider produces audio.
 
 **Schema Files:**
-- `schemas/sketch_bloom_enums.json` - MoodPreset, InstrumentationPreset, SketchBloomStatus
-- `schemas/sketch_bloom_request.json` - Request for creating a bloom
-- `schemas/sketch_bloom.json` - Bloom entity (response/stored)
-- `schemas/sketch_bloom_regenerate_request.json` - Regenerate request (by bloomId + optional overrides)
-- `schemas/sketch_bloom_error.json` - Structured error codes and payload
-- `schemas/events/sketch_bloom.*.json` - Events: requested, generated, failed, replayed, regenerated
+- `schemas/audio_generation_enums.json` - AudioGenerationStatus, Mood, HarmonicMode, Density, EnergyCurve (guidance)
+- `schemas/audio_generation_request.json` - Request (sourceType, experienceType, sourceRef, inputs, preset, mood, durationMs, options, metadata, optional **guidance**)
+- `schemas/audio_generation.json` - AudioGenerationResult (generationId, status, audioUrl, durationMs, etc.)
+- `schemas/audio_generation_regenerate_request.json` - Regenerate by generationId with optional overrides
+- `schemas/audio_generation_error.json` - Structured error (invalid_request, source_not_eligible, provider_unavailable, generation_failed, asset_missing)
+- `schemas/events/audio_generation.*.json` - Events: requested, completed, failed, replayed, regenerated
 
-**Events (AsyncAPI):** `sketch_bloom.requested`, `sketch_bloom.generated`, `sketch_bloom.failed`, `sketch_bloom.replayed`, `sketch_bloom.regenerated`
+**Events (AsyncAPI):** `audio_generation.requested`, `audio_generation.completed`, `audio_generation.failed`, `audio_generation.replayed`, `audio_generation.regenerated`
 
-See `docs/sketch-bloom-contracts.md` for naming choices, error codes, and migration notes for StudioOps and LevrOps.
+**Guidance:** Optional `guidance` object on the request provides lightweight hints (harmonicMode, tempoHintBpm, density, energyCurve, instrumentFocus, negativeDirectives) for music-aware or scene-aware use cases without polluting the top-level schema. Fully optional; providers may partially honor. See `docs/audio-generation-contracts.md` for request/result shapes, guidance field reference, examples, and migration notes.
 
 ## Versioning
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "levrops-contracts",
-  "version": "1.3.5",
+  "version": "1.3.6",
   "description": "LevrOps API contracts, schemas, code generators, and Sanity content contracts",
   "license": "MIT",
   "repository": {