codai-sdk 0.67.0__tar.gz → 0.69.0__tar.gz

{codai_sdk-0.67.0 → codai_sdk-0.69.0}/CHANGELOG.md

@@ -6,6 +6,27 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.69.0] - 2026-10-23
+
+- `MusicRoom.listening`: what the Music Room critic heard (listening features, Audiobox Aesthetics, Gemini listener
+  verdict) — new `MusicRoomListening` TypedDict; `None` before the critic ran. The `critic_text_only` warning is now
+  documented (the critic could not listen to the master and judged from the score).
+
+## [0.68.0] - 2026-10-22
+
+- Music Room (MR-09..MR-17): new `client.studio` namespace with `studio.music_room` — a team of role agents writes,
+  plays, sings and mixes a song with three approval gates. `create(brief, language=, genre=, duration_seconds=,
+vocals=, timbre=, voice_passport_id=, instruments=, auto=, budget_micro_usd=, title=, idempotency_key=)`
+  (`POST /v1/studio/music-room`), `get(id)`, `list(limit=, before=)`, `quota()`, `choose(id, gate, variant=,
+approve=)`, `direct(id, role, direction, section_id=, idempotency_key=)` and `wait(id, until_gate=, interval=,
+timeout=)`; constant `MUSIC_ROOM_TERMINAL_STATUSES`.
+- Regenerated `_types.py`: `MusicRoomCreate`, `MusicRoom`, `MusicRoomPlanVariant`, `MusicRole`, `MusicRoomChoose`,
+  `MusicRoomDirect`, `MusicRoomQuota`, `MusicRoomList`.
+- Voice passport (D37, beta): new `client.voices` with `add_singing_consent(voice_id, session_id)`
+  (`POST /v1/studio/voices/{id}/singing-consent`, never retried) and `revoke_singing_consent(voice_id)` (204): your own
+  custom voice singing in Music Room songs, a separate revocable consent; the result approximates your timbre.
+  Regenerated `_types.py`: `StudioVoice`, `StudioVoiceSinging`, `StudioVoiceSingingConsentRequest`.
+
 ## [0.67.0] - 2026-10-20
 
 - Creatives (CX-07/08/09): `creatives.build(..., format=, format_id=, crop_marks=)` builds carousel (`png` | `pdf`)
@@ -16,7 +37,7 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 - `creatives.transcript_cut(creative_id, node_id=, remove=, base_seq=, force=)`
   (`POST /v1/studio/creatives/{id}/transcript-cut`): delete transcript word ranges from a video clip; free.
 - `creatives.regenerate_node(creative_id, node_id, prompt=, model=, aspect_ratio=, base_seq=, force=,
-  idempotency_key=)` (`POST /v1/studio/creatives/{id}/nodes/{nodeId}/regenerate`): new picture for an image node,
+idempotency_key=)` (`POST /v1/studio/creatives/{id}/nodes/{nodeId}/regenerate`): new picture for an image node,
   cast-consistent; billed like an image generation.
 - `media_ops.quote` / `run` / `run_and_wait` accept `mask_png_b64=` for `image.inpaint` / `image.erase`.
 - `videos.create` / `images.generate` document `reference_asset_ids` (Studio image assets as references).
@@ -34,8 +55,8 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 - Creatives: `CreativeKind` gains `audio` (songs and podcasts); new generated types `CreativeAudio`,
   `CreativeAudioTrack`, `CreativeAudioClip`, `CreativeAudioSection`, `CreativeAudioFx` and the media-op schemas.
 - New `client.lyrics` (MU-06): `write(brief, language, genre=, mood=, structure=, syllables_per_line=,
-  rhyme_scheme=, lines_per_section=, title=, idempotency_key=)` (`POST /v1/studio/lyrics`) and `align(creative_id,
-  clip_id, lyrics_text, language=, apply=, base_seq=, retranscribe=, idempotency_key=)` (`POST /v1/studio/lyrics/align`,
+rhyme_scheme=, lines_per_section=, title=, idempotency_key=)` (`POST /v1/studio/lyrics`) and `align(creative_id,
+clip_id, lyrics_text, language=, apply=, base_seq=, retranscribe=, idempotency_key=)` (`POST /v1/studio/lyrics/align`,
   timed lines + LRC).
 - `client.creatives.render_audio(creative_id, formats=, stems=, lrc=, loudness=, title=, idempotency_key=)` (MU-05):
   mixdown + mastering + exports of an `audio` creative. New generated types `StudioLyrics*`,

{codai_sdk-0.67.0 → codai_sdk-0.69.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: codai-sdk
-Version: 0.67.0
+Version: 0.69.0
 Summary: Official Python SDK for the codai AI gateway — chat, messages, responses, streaming, agents, sessions, hosts, tasks, account.
 Project-URL: Homepage, https://codai.ro
 Project-URL: Repository, https://github.com/codai-ro/codai-sdk-python

{codai_sdk-0.67.0 → codai_sdk-0.69.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "codai-sdk"
-version = "0.67.0"
+version = "0.69.0"
 description = "Official Python SDK for the codai AI gateway — chat, messages, responses, streaming, agents, sessions, hosts, tasks, account."
 readme = "README.md"
 

{codai_sdk-0.67.0 → codai_sdk-0.69.0}/src/codai/__init__.py

@@ -52,6 +52,7 @@ from .resources import (
     BrandKits,
     Templates,
     Productions,
+    Studio,
     MediaOps,
     Lyrics,
     MEDIA_JOB_TERMINAL_STATUSES,
@@ -62,6 +63,7 @@ from .resources import (
     Shares,
     share_token_from,
     VoiceRevocations,
+    Voices,
     Vault,
     vault_unlock_message,
     AbuseReports,
@@ -166,7 +168,7 @@ __all__ = [
     "share_token_from",
     "vault_unlock_message",
 ]
-__version__ = "0.67.0"
+__version__ = "0.69.0"
 class _CallableGroup:
     """A resource group that is also callable — keeps ``client.chat(...)``,
     ``client.embeddings(...)``, ``client.models()`` and ``client.feedback(...)``
@@ -244,6 +246,8 @@ class Codai:
         self.templates = Templates(http)
         # Studio productions: brief -> storyboard -> images + voice-over -> creative -> draft render -> review.
         self.productions = Productions(http)
+        # codai Studio namespace: studio.music_room (a team of role agents makes a song with three approval gates).
+        self.studio = Studio(http)
         # Studio media operations: background removal, upscale, inpaint, stems, denoise, MIDI, mastering, ACE-Step music.
         self.media_ops = MediaOps(http)
         # Studio lyrics: write (syllable + rhyme checked, token-metered) and align to an audio clip (LRC + setLyrics).
@@ -256,6 +260,8 @@ class Codai:
         self.shares = Shares(http)
         # Public takedown tickets for voices cloned in codai Studio (no key needed by the route).
         self.voice_revocations = VoiceRevocations(http)
+        # Studio custom voices: the voice passport singing consent (beta; your own voice singing in Music Room songs).
+        self.voices = Voices(http)
         # Zero-knowledge credentials vault: ciphertext only; the agent broker calls never return secret values.
         self.vault = Vault(http)
         # Public DSA notices about codai Studio share / review links (no key needed by the route).

{codai_sdk-0.67.0 → codai_sdk-0.69.0}/src/codai/_operations.py

@@ -104,6 +104,8 @@ OPERATION_METHODS: Dict[str, str] = {
     "reopenPublicReviewThread": "shares.reopen",
     "decidePublicReview": "shares.decide",
     "createVoiceRevocation": "voice_revocations.create",
+    "addStudioVoiceSingingConsent": "voices.add_singing_consent",
+    "revokeStudioVoiceSingingConsent": "voices.revoke_singing_consent",
     "getVaultAccount": "vault.account",
     "putVaultAccount": "vault.put_account",
     "patchVaultSettings": "vault.update_settings",
@@ -150,6 +152,12 @@ OPERATION_METHODS: Dict[str, str] = {
     "listCreativeTemplates": "templates.list",
     "createStudioProduction": "productions.create",
     "getStudioProduction": "productions.retrieve",
+    "createStudioMusicRoom": "studio.music_room.create",
+    "listStudioMusicRooms": "studio.music_room.list",
+    "getStudioMusicRoomQuota": "studio.music_room.quota",
+    "getStudioMusicRoom": "studio.music_room.get",
+    "chooseStudioMusicRoom": "studio.music_room.choose",
+    "directStudioMusicRoom": "studio.music_room.direct",
     "listStudioMediaOps": "media_ops.list",
     "quoteStudioMediaOp": "media_ops.quote",
     "runStudioMediaOp": "media_ops.run",

{codai_sdk-0.67.0 → codai_sdk-0.69.0}/src/codai/_types.py

@@ -2562,6 +2562,233 @@ class StudioProduction(TypedDict):
     created_at: str
 
 
+class _MusicRoomCreateRequired(TypedDict):
+    brief: str
+
+
+class MusicRoomCreate(_MusicRoomCreateRequired, total=False):
+    """Music Room request"""
+    language: Literal['ro', 'en']
+    genre: str
+    duration_seconds: int
+    vocals: bool
+    timbre: str
+    voice_passport_id: str
+    instruments: List[str]
+    auto: bool
+    budget_micro_usd: int
+    title: str
+
+
+class MusicRoomPlanVariantSectionsItem(TypedDict):
+    id: str
+    kind: str
+    bars: int
+
+
+# A member of the Music Room team.
+MusicRole = Literal['producer', 'composer', 'lyricist', 'arranger', 'drums', 'bass', 'guitar', 'keys', 'strings', 'brass', 'winds', 'balkan_lead', 'balkan_rhythm', 'percussion', 'synth', 'vocal_producer', 'sound_designer', 'mix_engineer', 'mastering_engineer', 'critic', 'rights']
+
+
+class MusicRoomPlanVariantInstrumentationItem(TypedDict):
+    role: MusicRole
+    instrument_id: str
+
+
+class MusicRoomPlanVariant(TypedDict):
+    """Music Room plan variant"""
+    title: str
+    genre_id: str
+    bpm: float
+    meter: str
+    mode_id: str
+    sections: List[MusicRoomPlanVariantSectionsItem]
+    instrumentation: List[MusicRoomPlanVariantInstrumentationItem]
+    rationale: str
+
+
+class _MusicRoomGateRequired(TypedDict):
+    kind: Literal['plan', 'demo', 'final']
+    since: str
+
+
+class MusicRoomGate(_MusicRoomGateRequired, total=False):
+    """The gate the song waits at (`null` when it is not waiting)."""
+    variants: List[MusicRoomPlanVariant]
+
+
+class _MusicRoomTeamItemRequired(TypedDict):
+    role: MusicRole
+    name: str
+    status: Literal['done', 'playing', 'waiting']
+
+
+class MusicRoomTeamItem(_MusicRoomTeamItemRequired, total=False):
+    instrument_id: Optional[str]
+    track_id: Optional[str]
+    rationale: Optional[str]
+
+
+class _MusicRoomCritiqueIssuesItemRequired(TypedDict):
+    role: MusicRole
+    problem: str
+    fix: str
+
+
+class MusicRoomCritiqueIssuesItem(_MusicRoomCritiqueIssuesItemRequired, total=False):
+    section_id: Optional[str]
+
+
+class MusicRoomCritique(TypedDict):
+    """The critic's last review."""
+    round: int
+    scores: Dict[str, float]
+    verdict: Literal['ship', 'revise']
+    issues: List[MusicRoomCritiqueIssuesItem]
+
+
+class MusicRoomListeningFeaturesAesthetics(TypedDict):
+    """Meta Audiobox Aesthetics, about 1-10: CE content enjoyment, CU content usefulness, PC production complexity, P…"""
+    CE: float
+    CU: float
+    PC: float
+    PQ: float
+
+
+class MusicRoomListeningFeatures(TypedDict, total=False):
+    """Measured listening features of the master (codai-studio-media). `null` when the measurement was unavailable."""
+    duration_seconds: Optional[float]
+    spectral_centroid_hz: Optional[float]
+    spectral_centroid_std_hz: Optional[float]
+    spectral_flatness: Optional[float]
+    onset_rate_per_s: Optional[float]
+    onset_rate_cv: Optional[float]
+    crest_factor_db: Optional[float]
+    loudness_range_lu: Optional[float]
+    stereo_width: Optional[float]
+    loudness_timeline_lufs: List[Optional[float]]
+    aesthetics: Optional[MusicRoomListeningFeaturesAesthetics]
+
+
+class MusicRoomListeningVerdictImpressions(TypedDict):
+    """Impressions from 0 to 10 per aspect; `vocals` is `null` for an instrumental."""
+    groove: float
+    melody: float
+    mix: float
+    vocals: Optional[float]
+    humanness: float
+    genre_fit: float
+
+
+class MusicRoomListeningVerdictNotesItem(TypedDict):
+    at_seconds: float
+    note: str
+
+
+class MusicRoomListeningVerdict(TypedDict):
+    """The Gemini listener's verdict. `null` when the listener was unavailable."""
+    impressions: MusicRoomListeningVerdictImpressions
+    notes: List[MusicRoomListeningVerdictNotesItem]
+    ai_tells: List[str]
+    summary: str
+
+
+class MusicRoomListening(TypedDict):
+    """Music Room listening"""
+    features: Optional[MusicRoomListeningFeatures]
+    verdict: Optional[MusicRoomListeningVerdict]
+    model: Optional[str]
+
+
+class MusicRoomCopyRiskMatchesItem(TypedDict, total=False):
+    id: str
+    title: str
+    score: float
+
+
+class MusicRoomCopyRisk(TypedDict):
+    """Melody similarity against the reference corpus."""
+    max_score: float
+    matches: List[MusicRoomCopyRiskMatchesItem]
+
+
+class MusicRoomQuota(TypedDict):
+    within: bool
+    used: int
+    included: int
+
+
+class MusicRoom(TypedDict):
+    """Music Room song"""
+    id: str
+    object: Literal['studio.music_room']
+    status: Literal['running', 'waiting', 'succeeded', 'failed']
+    phase: Literal['plan', 'gate_plan', 'compose', 'lyrics', 'arrange', 'parts', 'render_demo', 'gate_demo', 'vocals', 'mix', 'master', 'critique', 'gate_final', 'ready', 'failed']
+    gate: Optional[MusicRoomGate]
+    brief: str
+    language: Literal['ro', 'en']
+    genre_id: Optional[str]
+    title: Optional[str]
+    creative_id: Optional[str]
+    demo_asset_id: Optional[str]
+    final_asset_id: Optional[str]
+    stems_asset_ids: List[str]
+    team: List[MusicRoomTeamItem]
+    critique: Optional[MusicRoomCritique]
+    listening: Optional[MusicRoomListening]
+    robot_score: Optional[float]
+    copy_risk: Optional[MusicRoomCopyRisk]
+    credits: List[str]
+    quota: MusicRoomQuota
+    budget_micro_usd: str
+    spent_micro_usd: str
+    warnings: List[str]
+    error: Optional[str]
+    created_at: str
+
+
+class MusicRoomChooseOption1(TypedDict):
+    """Plan gate answer"""
+    gate: Literal['plan']
+    variant: int
+
+
+class MusicRoomChooseOption2(TypedDict):
+    """Demo gate answer"""
+    gate: Literal['demo']
+    approve: Literal[True]
+
+
+class MusicRoomChooseOption3(TypedDict):
+    """Final gate answer"""
+    gate: Literal['final']
+    approve: Literal[True]
+
+
+# The answer to the gate the song waits at.
+MusicRoomChoose = Union[MusicRoomChooseOption1, MusicRoomChooseOption2, MusicRoomChooseOption3]
+
+
+class _MusicRoomDirectRequired(TypedDict):
+    role: MusicRole
+    direction: str
+
+
+class MusicRoomDirect(_MusicRoomDirectRequired, total=False):
+    """Music Room direction"""
+    section_id: str
+
+
+class _MusicRoomListRequired(TypedDict):
+    object: Literal['list']
+    data: List[MusicRoom]
+
+
+class MusicRoomList(_MusicRoomListRequired, total=False):
+    """Music Room song list"""
+    has_more: bool
+
+
 class CreativeTemplateList(TypedDict):
     """Creative template list"""
     object: Literal['list']
@@ -3002,6 +3229,30 @@ class StudioReviewReplyRequest(TypedDict):
     body: str
 
 
+class StudioVoiceSingingConsentRequest(TypedDict):
+    session_id: str
+
+
+class StudioVoiceSinging(TypedDict):
+    """Singing consent (beta)"""
+    status: Literal['none', 'active', 'revoked']
+    consented_at: Optional[str]
+    revoked_at: Optional[str]
+    quality: Literal['beta']
+
+
+class StudioVoice(TypedDict):
+    """Custom voice"""
+    id: str
+    object: Literal['studio.voice']
+    label: str
+    locale: str
+    kind: Literal['ai_clone']
+    display_name: str
+    created_at: str
+    singing: StudioVoiceSinging
+
+
 class _StudioVoiceRevocationRequestRequired(TypedDict):
     email: str
     voice_owner_name: str
@@ -7430,6 +7681,42 @@ CreateStudioProductionResponse = StudioProduction
 GetStudioProductionResponse = StudioProduction
 
 
+# GET /v1/studio/music-room — 200 response
+ListStudioMusicRoomsResponse = MusicRoomList
+
+
+# POST /v1/studio/music-room — request body
+CreateStudioMusicRoomBody = MusicRoomCreate
+
+
+# POST /v1/studio/music-room — 202 response
+CreateStudioMusicRoomResponse = MusicRoom
+
+
+# GET /v1/studio/music-room/quota — 200 response
+GetStudioMusicRoomQuotaResponse = MusicRoomQuota
+
+
+# GET /v1/studio/music-room/{id} — 200 response
+GetStudioMusicRoomResponse = MusicRoom
+
+
+# POST /v1/studio/music-room/{id}/choose — request body
+ChooseStudioMusicRoomBody = MusicRoomChoose
+
+
+# POST /v1/studio/music-room/{id}/choose — 200 response
+ChooseStudioMusicRoomResponse = MusicRoom
+
+
+# POST /v1/studio/music-room/{id}/direct — request body
+DirectStudioMusicRoomBody = MusicRoomDirect
+
+
+# POST /v1/studio/music-room/{id}/direct — 202 response
+DirectStudioMusicRoomResponse = MusicRoom
+
+
 # GET /v1/studio/media-ops — 200 response
 ListStudioMediaOpsResponse = MediaOpList
 
@@ -7586,6 +7873,14 @@ RemixStudioShareBody = StudioRemixRequest
 RemixStudioShareResponse = StudioRemixResult
 
 
+# POST /v1/studio/voices/{id}/singing-consent — request body
+AddStudioVoiceSingingConsentBody = StudioVoiceSingingConsentRequest
+
+
+# POST /v1/studio/voices/{id}/singing-consent — 200 response
+AddStudioVoiceSingingConsentResponse = StudioVoice
+
+
 # POST /v1/studio/voice-revocations — request body
 CreateVoiceRevocationBody = StudioVoiceRevocationRequest
 
@@ -9458,6 +9753,8 @@ __all__ = [
     'AddListItemResponse',
     'AddOrgMemberBody',
     'AddOrgMemberResponse',
+    'AddStudioVoiceSingingConsentBody',
+    'AddStudioVoiceSingingConsentResponse',
     'AddTranscriptBookmarkBody',
     'AddTranscriptBookmarkResponse',
     'AgentOutputKey',
@@ -9572,6 +9869,8 @@ __all__ = [
     'ChatUsage',
     'ChatUsagePromptTokensDetails',
     'CheckProvenanceResponse',
+    'ChooseStudioMusicRoomBody',
+    'ChooseStudioMusicRoomResponse',
     'ClaimScheduleRunResponse',
     'ClaimSessionLeaseBody',
     'ClaimSessionLeaseResponse',
@@ -9687,6 +9986,8 @@ __all__ = [
     'CreateStudioBatchBody',
     'CreateStudioBatchResponse',
     'CreateStudioBatchResponse201',
+    'CreateStudioMusicRoomBody',
+    'CreateStudioMusicRoomResponse',
     'CreateStudioProductionBody',
     'CreateStudioProductionResponse',
     'CreateSystemOneBody',
@@ -9862,6 +10163,8 @@ __all__ = [
     'DevicePatch',
     'DevicePatched',
     'DevicePlatform',
+    'DirectStudioMusicRoomBody',
+    'DirectStudioMusicRoomResponse',
     'DispatchToDeviceBody',
     'DispatchToDeviceResponse',
     'DocBlock',
@@ -10007,6 +10310,8 @@ __all__ = [
     'GetStudioBatchResponse',
     'GetStudioExportResponse',
     'GetStudioMediaOpJobResponse',
+    'GetStudioMusicRoomQuotaResponse',
+    'GetStudioMusicRoomResponse',
     'GetStudioProductionResponse',
     'GetStudioQuoteResponse',
     'GetTaskResponse',
@@ -10102,6 +10407,7 @@ __all__ = [
     'ListSessionsSharedWithMeResponse',
     'ListStudioBatchesResponse',
     'ListStudioMediaOpsResponse',
+    'ListStudioMusicRoomsResponse',
     'ListTasksResponse',
     'ListTranscriptFoldersResponse',
     'ListTranscriptSharesResponse',
@@ -10161,6 +10467,31 @@ __all__ = [
     'MsgToolChoiceOption1',
     'MsgToolChoiceOption2',
     'MsgUsage',
+    'MusicRole',
+    'MusicRoom',
+    'MusicRoomChoose',
+    'MusicRoomChooseOption1',
+    'MusicRoomChooseOption2',
+    'MusicRoomChooseOption3',
+    'MusicRoomCopyRisk',
+    'MusicRoomCopyRiskMatchesItem',
+    'MusicRoomCreate',
+    'MusicRoomCritique',
+    'MusicRoomCritiqueIssuesItem',
+    'MusicRoomDirect',
+    'MusicRoomGate',
+    'MusicRoomList',
+    'MusicRoomListening',
+    'MusicRoomListeningFeatures',
+    'MusicRoomListeningFeaturesAesthetics',
+    'MusicRoomListeningVerdict',
+    'MusicRoomListeningVerdictImpressions',
+    'MusicRoomListeningVerdictNotesItem',
+    'MusicRoomPlanVariant',
+    'MusicRoomPlanVariantInstrumentationItem',
+    'MusicRoomPlanVariantSectionsItem',
+    'MusicRoomQuota',
+    'MusicRoomTeamItem',
     'MusicTrackMeta',
     'Notification',
     'OrgAddMemberBody',
@@ -10537,8 +10868,11 @@ __all__ = [
     'StudioTimelineScene',
     'StudioTimelineSceneInput',
     'StudioTimelineSceneInputNarration',
+    'StudioVoice',
     'StudioVoiceRevocation',
     'StudioVoiceRevocationRequest',
+    'StudioVoiceSinging',
+    'StudioVoiceSingingConsentRequest',
     'SubmitFeedbackBody',
     'SubmitFeedbackResponse',
     'SubmitSessionControlBody',

{codai_sdk-0.67.0 → codai_sdk-0.69.0}/src/codai/resources/__init__.py

@@ -8,6 +8,7 @@ from .chat import Chat, ChatCompletions, ChatResult, ChatStream, ChatStreamResul
 from .brand_kits import BrandKits
 from .templates import Templates
 from .productions import PRODUCTION_TERMINAL_STATUSES, Productions
+from .music_room import MUSIC_ROOM_TERMINAL_STATUSES, MusicRoom, Studio
 from .media_ops import MEDIA_JOB_TERMINAL_STATUSES, MediaOps, is_media_op_job
 from .lyrics import Lyrics
 from .exports import Exports
@@ -16,6 +17,7 @@ from .vault import Vault, vault_unlock_message
 from .batches import Batches
 from .shares import Shares, share_token_from
 from .voice_revocations import VoiceRevocations
+from .voices import Voices
 from .abuse_reports import AbuseReports
 from .provenance import Provenance
 from .creatives import Creatives, is_paged_build
@@ -124,6 +126,9 @@ __all__ = [
     "Templates",
     "Productions",
     "PRODUCTION_TERMINAL_STATUSES",
+    "MusicRoom",
+    "Studio",
+    "MUSIC_ROOM_TERMINAL_STATUSES",
     "MediaOps",
     "Lyrics",
     "MEDIA_JOB_TERMINAL_STATUSES",
@@ -134,6 +139,7 @@ __all__ = [
     "Shares",
     "share_token_from",
     "VoiceRevocations",
+    "Voices",
     "Vault",
     "vault_unlock_message",
     "AbuseReports",

codai_sdk-0.69.0/src/codai/resources/music_room.py

@@ -0,0 +1,164 @@
+"""``/v1/studio/music-room`` — codai Studio Music Room (MR-09..MR-17): a team of role agents (producer, composer,
+lyricist, arranger, session players, vocal producer, mix and mastering engineers, critic, rights) writes, plays, sings
+and mixes a song that sounds played by people, saved as an editable audio creative.
+
+``create`` starts a song (202), ``get`` advances and reads it, ``list`` pages your songs, ``quota`` reports the songs
+included this month, ``choose`` answers the open gate (``plan`` / ``demo`` / ``final``) and ``direct`` asks one player
+to re-play a part. ``wait`` polls until ``succeeded`` / ``failed`` or, with ``until_gate=True``, until the song waits
+at a gate. Free within the monthly plan quota; beyond it every step is held on the wallet up to ``budget_micro_usd``
+(default 4,000,000 = $4).
+"""
+
+from __future__ import annotations
+
+import time
+from typing import Any, Dict, List, Optional
+
+from .._http import RequestExtensions
+from ._base import Resource, enc
+
+__all__ = ["MusicRoom", "Studio", "MUSIC_ROOM_TERMINAL_STATUSES"]
+
+_BASE = "/v1/studio/music-room"
+MUSIC_ROOM_TERMINAL_STATUSES = ("succeeded", "failed")
+
+
+def _idem(key: Optional[str], ext: Optional[RequestExtensions]) -> Optional[Dict[str, Any]]:
+    if not key:
+        return dict(ext) if ext else None
+    merged: Dict[str, Any] = dict(ext or {})
+    merged["headers"] = {**dict(merged.get("headers") or {}), "Idempotency-Key": key}
+    return merged
+
+
+class MusicRoom(Resource):
+    """Start, steer and wait for Music Room songs."""
+
+    def create(
+        self,
+        brief: str,
+        language: Optional[str] = None,
+        genre: Optional[str] = None,
+        duration_seconds: Optional[int] = None,
+        vocals: Optional[bool] = None,
+        timbre: Optional[str] = None,
+        voice_passport_id: Optional[str] = None,
+        instruments: Optional[List[str]] = None,
+        auto: Optional[bool] = None,
+        budget_micro_usd: Optional[int] = None,
+        title: Optional[str] = None,
+        idempotency_key: Optional[str] = None,
+        ext: Optional[RequestExtensions] = None,
+    ) -> Dict[str, Any]:
+        """``POST /v1/studio/music-room`` — start a song (the producer plans it, then it waits at the plan gate)."""
+        body: Dict[str, Any] = {"brief": brief}
+        for k, v in (
+            ("language", language),
+            ("genre", genre),
+            ("duration_seconds", duration_seconds),
+            ("vocals", vocals),
+            ("timbre", timbre),
+            ("voice_passport_id", voice_passport_id),
+            ("instruments", instruments),
+            ("auto", auto),
+            ("budget_micro_usd", budget_micro_usd),
+            ("title", title),
+        ):
+            if v is not None:
+                body[k] = v
+        return (
+            self._json(
+                _BASE,
+                ext=_idem(idempotency_key, ext),
+                method="POST",
+                body=body,
+                no_retry=not idempotency_key,
+            )
+            or {}
+        )
+
+    def get(self, music_room_id: str, ext: Optional[RequestExtensions] = None) -> Dict[str, Any]:
+        """``GET /v1/studio/music-room/{id}`` — advances the workflow and returns the song. Another account's id is a 404."""
+        return self._json(f"{_BASE}/{enc(music_room_id)}", ext=ext) or {}
+
+    def list(
+        self,
+        limit: Optional[int] = None,
+        before: Optional[str] = None,
+        ext: Optional[RequestExtensions] = None,
+    ) -> Dict[str, Any]:
+        """``GET /v1/studio/music-room`` — ``{object: "list", data, has_more}``, newest first; page with ``before``."""
+        return self._json(_BASE, ext=ext, query={"limit": limit, "before": before}) or {}
+
+    def quota(self, ext: Optional[RequestExtensions] = None) -> Dict[str, Any]:
+        """``GET /v1/studio/music-room/quota`` — ``{plan, included, used, remaining, period_end}`` for this month."""
+        return self._json(f"{_BASE}/quota", ext=ext) or {}
+
+    def choose(
+        self,
+        music_room_id: str,
+        gate: str,
+        variant: Optional[int] = None,
+        approve: Optional[bool] = None,
+        ext: Optional[RequestExtensions] = None,
+    ) -> Dict[str, Any]:
+        """``POST /v1/studio/music-room/{id}/choose`` — answer the open gate: ``gate="plan", variant=0..2`` or
+        ``gate="demo"`` / ``gate="final"`` (approved). 409 ``not_at_gate`` when the song is not waiting there."""
+        body: Dict[str, Any] = {"gate": gate}
+        if gate == "plan":
+            body["variant"] = 0 if variant is None else variant
+        else:
+            body["approve"] = True if approve is None else approve
+        return self._json(f"{_BASE}/{enc(music_room_id)}/choose", ext=ext, method="POST", body=body) or {}
+
+    def direct(
+        self,
+        music_room_id: str,
+        role: str,
+        direction: str,
+        section_id: Optional[str] = None,
+        idempotency_key: Optional[str] = None,
+        ext: Optional[RequestExtensions] = None,
+    ) -> Dict[str, Any]:
+        """``POST /v1/studio/music-room/{id}/direct`` — one player re-plays its part following ``direction`` (≤ 500
+        characters) and the demo is re-rendered. Only at the demo or final gate."""
+        body: Dict[str, Any] = {"role": role, "direction": direction}
+        if section_id is not None:
+            body["section_id"] = section_id
+        return (
+            self._json(
+                f"{_BASE}/{enc(music_room_id)}/direct",
+                ext=_idem(idempotency_key, ext),
+                method="POST",
+                body=body,
+                no_retry=not idempotency_key,
+            )
+            or {}
+        )
+
+    def wait(
+        self,
+        music_room_id: str,
+        until_gate: bool = False,
+        interval: float = 10.0,
+        timeout: float = 1800.0,
+        ext: Optional[RequestExtensions] = None,
+    ) -> Dict[str, Any]:
+        """Poll :meth:`get` until ``status`` is ``succeeded`` or ``failed`` (a failed song is returned too) or, with
+        ``until_gate=True``, until it waits at a gate. Raises ``TimeoutError`` after ``timeout`` seconds (default 30 min)."""
+        deadline = time.monotonic() + timeout
+        while True:
+            r = self.get(music_room_id, ext=ext)
+            status = r.get("status")
+            if status in MUSIC_ROOM_TERMINAL_STATUSES or (until_gate and status == "waiting"):
+                return r
+            if time.monotonic() + interval > deadline:
+                raise TimeoutError(f"codai music room {music_room_id} did not finish within {timeout} s")
+            time.sleep(interval)
+
+
+class Studio:
+    """codai Studio namespace: ``client.studio.music_room``."""
+
+    def __init__(self, http: Any) -> None:
+        self.music_room = MusicRoom(http)

codai_sdk-0.69.0/src/codai/resources/voices.py

@@ -0,0 +1,39 @@
+"""``client.voices`` — codai Studio custom voices, D37 voice passport (beta): the SEPARATE, revocable consent that
+lets your own custom voice sing in your Music Room songs. The consent is recorded in the app (a ``purpose: singing``
+recording session: the singing statement read aloud + a sung sample); these calls arm and revoke it. The sung result
+approximates your timbre; it is not a faithful clone. Only where voice cloning is enabled for the account. Free."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+from .._http import RequestExtensions
+from ._base import Resource, enc
+
+__all__ = ["Voices"]
+
+
+def _singing(voice_id: str) -> str:
+    return f"/v1/studio/voices/{enc(voice_id)}/singing-consent"
+
+
+class Voices(Resource):
+    """Custom voices: the voice passport singing consent."""
+
+    def add_singing_consent(
+        self, voice_id: str, session_id: str, ext: Optional[RequestExtensions] = None
+    ) -> Dict[str, Any]:
+        """``POST /v1/studio/voices/{id}/singing-consent`` — add the singing purpose from a finished singing recording
+        session (liveness-checked statement + sung sample). Returns the voice with ``singing.status == "active"``.
+        Never retried."""
+        return (
+            self._http.request(
+                _singing(voice_id), ext=ext, method="POST", body={"session_id": session_id}, no_retry=True
+            ).json()
+            or {}
+        )
+
+    def revoke_singing_consent(self, voice_id: str, ext: Optional[RequestExtensions] = None) -> None:
+        """``DELETE /v1/studio/voices/{id}/singing-consent`` — revoke ONLY the singing purpose (204). The sung sample is
+        deleted at once; the voice keeps working for narration. Idempotent."""
+        self._http.request(_singing(voice_id), ext=ext, method="DELETE")

codai_sdk-0.69.0/tests/test_music_room.py

@@ -0,0 +1,94 @@
+"""``client.studio.music_room`` (Studio Music Room, MR-09..MR-17) against the http.server stub."""
+
+from __future__ import annotations
+
+import pytest
+
+_ID = "7e2f3a4b-5c6d-4e7f-8091-a2b3c4d5e6f7"
+_BASE = "/v1/studio/music-room"
+_RUNNING = {"id": _ID, "object": "studio.music_room", "status": "running", "phase": "plan", "gate": None}
+_AT_PLAN = {**_RUNNING, "status": "waiting", "phase": "gate_plan", "gate": {"kind": "plan", "since": "2026-10-22T00:01:00Z"}}
+_DONE = {**_RUNNING, "status": "succeeded", "phase": "ready", "final_asset_id": "a9"}
+
+
+def test_create_posts_only_set_fields_and_idempotency_key(client, stub):
+    stub.reply(202, _RUNNING)
+    r = client.studio.music_room.create(
+        "o manea veselă de nuntă", language="ro", genre="manele", vocals=False, instruments=["balkan.accordion"],
+        idempotency_key="mr-1",
+    )
+    assert r["object"] == "studio.music_room"
+    req = stub.requests[0]
+    assert (req.method, req.path) == ("POST", _BASE)
+    assert req.json == {
+        "brief": "o manea veselă de nuntă",
+        "language": "ro",
+        "genre": "manele",
+        "vocals": False,
+        "instruments": ["balkan.accordion"],
+    }
+    assert req.headers["idempotency-key"] == "mr-1"
+
+
+def test_get_encodes_id_and_quota_and_list_paths(client, stub):
+    stub.reply(200, _AT_PLAN)
+    stub.reply(200, {"plan": "pro", "included": 4, "used": 1, "remaining": 3, "period_end": "2026-11-01T00:00:00Z"})
+    stub.reply(200, {"object": "list", "data": [_RUNNING], "has_more": False})
+    stub.reply(200, {"object": "list", "data": []})
+    assert client.studio.music_room.get("a/b")["gate"]["kind"] == "plan"
+    assert client.studio.music_room.quota()["remaining"] == 3
+    assert len(client.studio.music_room.list(limit=5, before="2026-10-01T00:00:00Z")["data"]) == 1
+    client.studio.music_room.list()
+    assert [(r.method, r.path, r.query) for r in stub.requests] == [
+        ("GET", f"{_BASE}/a%2Fb", ""),
+        ("GET", f"{_BASE}/quota", ""),
+        ("GET", _BASE, "limit=5&before=2026-10-01T00%3A00%3A00Z"),
+        ("GET", _BASE, ""),
+    ]
+
+
+def test_choose_builds_each_gate_answer(client, stub):
+    for _ in range(3):
+        stub.reply(200, _RUNNING)
+    client.studio.music_room.choose(_ID, "plan", variant=2)
+    client.studio.music_room.choose(_ID, "demo")
+    client.studio.music_room.choose(_ID, "final", approve=True)
+    assert [(r.method, r.path) for r in stub.requests] == [("POST", f"{_BASE}/{_ID}/choose")] * 3
+    assert [r.json for r in stub.requests] == [
+        {"gate": "plan", "variant": 2},
+        {"gate": "demo", "approve": True},
+        {"gate": "final", "approve": True},
+    ]
+    assert "idempotency-key" not in stub.requests[0].headers
+
+
+def test_direct_posts_direction_with_idempotency_key(client, stub):
+    stub.reply(202, _RUNNING)
+    client.studio.music_room.direct(_ID, "drums", "fewer fills", section_id="chorus1", idempotency_key="d1")
+    req = stub.requests[0]
+    assert (req.method, req.path) == ("POST", f"{_BASE}/{_ID}/direct")
+    assert req.json == {"role": "drums", "direction": "fewer fills", "section_id": "chorus1"}
+    assert req.headers["idempotency-key"] == "d1"
+
+
+def test_wait_polls_past_gates_until_succeeded(client, stub):
+    stub.reply(200, _RUNNING)
+    stub.reply(200, _AT_PLAN)
+    stub.reply(200, _DONE)
+    assert client.studio.music_room.wait(_ID, interval=0.01)["final_asset_id"] == "a9"
+    assert len(stub.requests) == 3
+
+
+def test_wait_until_gate_returns_at_the_first_gate(client, stub):
+    stub.reply(200, _RUNNING)
+    stub.reply(200, _AT_PLAN)
+    stub.reply(200, _DONE)
+    r = client.studio.music_room.wait(_ID, until_gate=True, interval=0.01)
+    assert r["status"] == "waiting" and r["gate"]["kind"] == "plan"
+    assert len(stub.requests) == 2
+
+
+def test_wait_times_out(client, stub):
+    stub.reply(200, _RUNNING)
+    with pytest.raises(TimeoutError):
+        client.studio.music_room.wait(_ID, interval=0.05, timeout=0.01)

{codai_sdk-0.67.0 → codai_sdk-0.69.0}/tests/test_resources.py

@@ -24,7 +24,7 @@ def _chat_response(content="PONG", tool_calls=None):
 
 
 def test_version():
-    assert codai.__version__ == "0.67.0"
+    assert codai.__version__ == "0.69.0"
 def test_chat_completions_create(client, stub):
     stub.reply(
         200,

codai_sdk-0.69.0/tests/test_voices.py

@@ -0,0 +1,28 @@
+"""Voice passport singing consent (D37, beta) against the http.server stub."""
+
+from __future__ import annotations
+
+_VOICE = "7a1b2c3d-0000-4000-8000-0000000000a1"
+_SESSION = "7a1b2c3d-0000-4000-8000-0000000000b2"
+
+
+def test_add_singing_consent_posts_the_session(client, stub):
+    stub.reply(
+        200,
+        {
+            "id": _VOICE,
+            "object": "studio.voice",
+            "singing": {"status": "active", "consented_at": "2026-10-22T10:05:00.000Z", "revoked_at": None,
+                        "quality": "beta"},
+        },
+    )
+    v = client.voices.add_singing_consent(_VOICE, _SESSION)
+    assert v["singing"]["status"] == "active" and v["singing"]["quality"] == "beta"
+    assert [(q.method, q.path) for q in stub.requests] == [("POST", f"/v1/studio/voices/{_VOICE}/singing-consent")]
+    assert stub.last.json == {"session_id": _SESSION}
+
+
+def test_revoke_singing_consent_deletes(client, stub):
+    stub.reply(204)
+    assert client.voices.revoke_singing_consent(_VOICE) is None
+    assert [(q.method, q.path) for q in stub.requests] == [("DELETE", f"/v1/studio/voices/{_VOICE}/singing-consent")]