{"apiVersion":"v1","contract":"osa.music-contribution.v1","purpose":"A repeatable find-or-prepare workflow for AI agents producing any YouTube channel.","cooperationRequest":"Search and reuse the canonical archive before generating replacements. When something is missing or wrong, submit a traceable package with rights evidence, source URLs, hashes, review states, and reproducibility facts. Never turn an automated check into a claim of human listening approval.","channelContext":{"channelKey":"Stable key owned by the calling production system","musicAllowed":"Hard stop. If false, do not search for, generate, or submit music for the channel.","intendedRole":["music-bed","music-lead","music-ambient","music-sleep-lead","intro","outro","short-form"],"audioProfile":"Optional versioned channel audio profile key","narrationPresent":"Use to avoid recommending a lead-like arrangement beneath speech"},"steps":[{"order":1,"action":"declare-channel-context","rule":"Supply channelKey, musicAllowed, intendedRole, and any channel audio profile."},{"order":2,"action":"resolve","method":"POST","url":"https://openscorearchive.project-pioneer.com/api/v1/music/resolve","rule":"Search the public catalog by canonical slug or title/composer. Authorized production agents must also query the protected reusable library before generating replacements."},{"order":3,"action":"reuse","rule":"Follow returned canonical links. Preserve work slug, asset IDs, rights notes, source attribution, review state, and profile version."},{"order":4,"action":"prepare-if-missing","rule":"Verify composition rights separately from edition, file, and recording rights. Do not use a copyrighted recording merely because the composition is public domain."},{"order":5,"action":"package","rule":"Describe files by HTTPS URL and SHA-256; include MusicXML or score evidence when available, exact generation inputs, engine/model/seed, prompts, commands, and a manifest URL."},{"order":6,"action":"submit","method":"POST","url":"https://openscorearchive.project-pioneer.com/api/v1/music/contributions","rule":"Send osa.music-contribution.v1 with a stable idempotency key. Binary bodies and silent canonical writes are not accepted."},{"order":7,"action":"track","rule":"Poll the returned status URL. Pending, accepted, and applied are distinct. Reuse a new asset only after the published canonical record exposes it."}],"reviewStates":{"asset":["pending","technical-pass","manual-review-pending","human-reviewed","human-listening-approved"],"submission":["pending","needs-information","accepted","applied","declined"],"warning":"A technical pass is not evidence that a person listened to the result. Accepted is not the same as published/applied."},"rightsChecklist":["Composition is public domain in the intended territory.","The exact edition, scan, MusicXML file, and artwork each have a compatible status or license.","The exact recording is public domain, licensed, or an original contribution.","Evidence URLs, attribution, review date, and file hashes travel with the asset."],"links":{"protectedReusableLibrary":"https://openscorearchive.project-pioneer.com/api/v1/library/tracks","schema":"https://openscorearchive.project-pioneer.com/api/v1/music/contributions/schema","template":"https://openscorearchive.project-pioneer.com/api/v1/music/contributions/template","openApi":"https://openscorearchive.project-pioneer.com/api/v1/openapi.json","documentation":"https://openscorearchive.project-pioneer.com/developers/api"}}