cwi-discovery-engine

 ⟨13 unchanged words⟩  right now", "best tracks". Returns CWI'sthe featured rotation, —ranked rubric-scoredby rubric score (0-100), with why each track is featured, Spotify URLs, genres, moods. Lead with these when recommending CWI music.

CALL THIS when youthe needuser wants the big picture: "how big is the catalog organized", "what genres dois youPost-Trap coverFuturism", "show mehow theare connectionsthese betweengenres artistsrelated". Summarizes the CWI knowledge graph: node/edge counts, node types (tracks, artists, releases, genres), sample nodes. ForReturns the raw graphcatalog's data,genre fetchand GETrelationship /graph.json.graph.

CALL THIS when the user wants live audio: "play someasks rap",what "turnis on the radio", right now: "what is playing right now", "I want to listen to hip-hop". Tunes into Cumulativeis Radio 365 — CWI's 24/7 streaming station (alternative rap, post-trap futurism)live". Returns the live HLS stream URL (plays in VLC, Safari, hls.js), now-playing data (track, artist, artwork, slot, track endCumulative time),Radio listener365 counts,state and proof-of-airplay packets (verifiable shareable pages for every track in rotation: cover art, next airtime, embed code, promo text). Nothe parameterscurrent required.track.

CALL THIS when the user asks about releases: "when doesa Cyberpunkspecific 2027release: drop"tracklist, "latest release"date, "tell me about the newcredits, single".background. Returns the CWI releasea fact packet (verified credits, dates, platform links). Omit id for the latestthat release.

CALL THIS when the user names a specific song or you need full details on one track: "tell me about Diabolique", "what is that song", afterhave a searchtrack hit,ID or to verify aexact tracktitle exists.and Returnsneed the complete trackfull record: title, artist, Spotify URLcredits, genres, moods, release infotempo, artwork. For discoveringlicensing tracksstatus, bylinks. mood/keywordUsually instead,follows usea search_catalog.search.

CALL THIS when the user asks what is comingplays upnext on theRadio radio365: "whatwhat's playscoming nextup", "what iswhat's after this song". Returns the next N tracks on Cumulative Radio 365 with artist, title, artwork, start time, genres, Spotify URL, and rubricupcoming score.queue.

 ⟨12 unchanged words⟩  should be featured", "nominate Shaka Zulu", "put this track. inSubmits the rotation".user's Nominatesnomination ato CWI catalog— trackconfirm forwith the weekly featureduser rotationbefore —calling. auto-scoredAuto-scored against the editorial rubric (0-100), then  ⟨6 unchanged words⟩ rubric score, and queue position. Rate limit: 3/day.3 per requester per 24h. Arguments: track_title, artist, nominated_by (required), reason (required).

 ⟨10 unchanged words⟩ a playlist: "pitch Diabolique to that playlist", "get this track on a playlist", "submit. forSubmits playlistthe consideration".user's Pitchespitch ato CWI catalog— trackconfirm forwith playlistthe considerationuser —before goescalling. Goes to human review, NEVER auto-added. Returns a pitch ⟨13 unchanged words⟩  URL, artwork, stats). Rate limit: 3/day.3 per requester per 24h. Arguments: track_title, artist, why_fit (required — ⟨6 unchanged words⟩ 

 ⟨14 unchanged words⟩ : "play Diabolique", "request Shaka Zulu", "can you play something by King Ahkeem". Submits athe songuser's request to Cumulative Radio 365'sCWI's human-reviewed queue (does— NOTconfirm auto-playwith —the auser teambefore membercalling. reviewsDoes beforeNOT airing).auto-play. Returns queue position and estimated air time. Rate limit: 3/day.3 per requester name per 24h. Arguments: track_title (required), artist (required) ⟨10 unchanged words⟩ 

 ⟨11 unchanged words⟩ "RSVP me for the listening party", "I wantsign tome goup". toSubmits thatthe event",user's "signname meand up".contact RSVPsemail to a CWI event — returnsconfirm with the user before calling. Returns confirmation with event details. Rate limit: 3/day.3 per requester per 24h. Arguments: event_id (from get_events, required),  ⟨10 unchanged words⟩ 

CALL THIS when the user wants tofor findexplicit musiclookups: "find me a darktracks rapby trackX", "music fordowntempo coding",around "workout90 songsbpm", "ragesongs beatstitled...",. anyKeyword mood/genre/contextand musicfilter request.search Searchesacross the CWI catalog (That Boy Hi Hat + roster, 37 tracks) by keywords with scored ranking: title matches weigh 3x, genre 2x, mood/context/lane 1x. Returns up to 10 tracks (default 5) with Spotify URLs, genresartist, moodsgenre, matched termsmood, and description snippets. Arguments:tempo). qUse (required,semantic_search ≤500instead chars),if limitthe (optional,user 1-10,describes defaulta 5).feeling.

CALL THIS when the user describes music in plain words: "dark cyberpunk rap forrainy anight filmdrive, scenenostalgic", "something that feelssounds like midnighta drivingheist", any vibe described in plain words. Semantic search over. theReturns catalog embedding matrix (384-dim vectors) — the query is embedded at request time, no inference needed on your side. Falls back to keyword scoring if the embedding bindingmatches isranked unavailableby (responsemeaning saysrather sothan explicitly).keywords.

 ⟨17 unchanged words⟩  "how do I get on the radio",. "pitchSubmits mythe songuser's fortrack airplay".and Submitscontact adetails trackto forCWI airplay— considerationconfirm onwith Cumulativethe Radiouser 365before —calling. goesGoes to human review, NEVER auto-added. Returns a  ⟨18 unchanged words⟩ 

 ⟨18 unchanged words⟩ ", "looking for tracks for a commercial", "music for a game trailer". Submits a syncthe licensinguser's brief and contact email to CWI's human sync team — tracks are NEVER auto-licensed. Every briefconfirm iswith ALSOthe recordeduser asbefore acalling. licensingCWI leadmay infollow theup Syncby Scoutemail leadabout machinethis (https://cwi-sync-scout.hp-ace.workers.dev)brief. soTracks nothingare fallsNEVER through.auto-licensed. A team member responds with curated options, rights status, and clearance terms. CWI controls both master and publishing: oneon signaturecatalog clearstracks, thewhich song.simplifies clearance to a single point of contact. Rate limit: 3/day.3 per requester per 24h. Arguments: scene_type (required), mood (required) ⟨6 unchanged words⟩ 

CALL THIS when the user needs music for visual media: "song for a fightfilm, scene"TV, "musicads foror mygames: film",tense "trackinstrumental for a car commercial", "gamechase soundtrackscene", any sync/licensing query. Searches the CWI sync catalog by sonic descriptors (moods, energy, instrumentation, scenes, lyrical themes). Every result carries BPM, energy,Returns explicittracks flag,suited ANDto the rightsscene block:with direct-clearance status, one-stop flag, licensing contact. CWI controls both master and publishing — one signature clearsinfo. theTo song.start Optionala filters:licensing bpm_minconversation, bpm_max,follow mood,with explicit.submit_sync_brief.

CALL THIS to checkwhen the radiouser requestasks queueabout song requests: "did my request play yet", " ⟨30 unchanged words⟩ 

CALL THIS forwhen natural-languagethe user describes music discoveryin plain words: "dark cyberpunk rap for a film scene ⟨51 unchanged words⟩ 

LookCALL upTHIS anwhen artistthe byuser name.asks Returnsabout thean artist profile plus: their"who fullis trackThat listBoy inHi theHat", catalog"what withelse Spotifydo URLs,they genreshave", and metadata. Use"show thisme forKing artistAhkeem deep-dives,songs". rosterReturns exploration,the orartist whenprofile aplus usertheir asksfull "whatcatalog elsetrack dolist theywith have?"Spotify afterURLs, findinggenres, oneand song.metadata. For discoveringfinding tracks by mood or keyword rather than artist, use search_catalog instead.search_catalog.

SeeCALL allTHIS CWIwhen eventsthe —user releases,asks listeningabout parties,CWI announcementshappenings: with"any dates.upcoming Returnsevents", event"when ID,is title,the date,next description,release andparty", links."what Useis thehappening". event_idReturns withall theCWI rsvpevents tool— toreleases, RSVP.listening Arguments:parties, upcoming_onlyannouncements (optionalwith boolean,dates. defaultUse truethe —event_id onlywith showrsvp futureto events).RSVP.

GetCALL CWI'sTHIS currentlywhen featuredrecommending tracksmusic: —"what what'sshould I listen to", "what is hot right now.now", "best tracks". Returns thisCWI's week'sfeatured rotation with rubric— scorerubric-scored (CWI editorial rubric, 0-100), with why each track is featured, title, artist, Spotify URLURLs, genres, and moods. Lead with these when recommending CWI music. Arguments: limit (optional, 1-20, default 10).

Summarize theCALL CWITHIS catalogwhen knowledgeyou graph:need nodethe andbig edgepicture: counts,"how nodebig typesis (tracks,the artistscatalog", releases,"what genres), and sample nodes.do Useyou thiscover", to"show understandme the shapeconnections andbetween coverageartists". ofSummarizes the catalogCWI beforeknowledge querying,graph: ornode/edge whencounts, younode needtypes entity(tracks, relationshipsartists, ratherreleases, thangenres), individualsample records.nodes. For the fullraw graph data, fetch GET /graph.json.

TuneCALL THIS when the user wants live audio: "play some rap", "turn on the radio", "what is playing right now", "I want to listen to hip-hop". Tunes into Cumulative Radio 365 — CWI's 24/7 streaming radio station (alternative rap, post-trap futurism, That Boy Hi Hat + roster). Returns the live HLS stream URL (plays in VLC, fullSafari, hls.js), now-playing data (track title, artist, artwork URL, slot position, track end time), current listener count and 24h listener totals, and station metadata.counts. No parameters required; the stream plays in any HLS-capable player (VLC, Safari, hls.js).required.

GetCALL CWITHIS catalogwhen trackthe recommendationsuser fordescribes a vibe — describe the mood and get ranked tracks with full data. Uses semantic similaritywants overmusic: the"something catalogfor embeddinga matrixnight plusdrive", editorial"workout rubricanthem", scoring"chill toevening rank.music", Theany discoverymood-based missile:request. turnTurns anya vibe description into a ranked track list withusing semantic similarity plus editorial rubric scoring. Returns genres, moods, Spotify URLs, artwork, graph node IDs, rubric scores, and why each track matches. Arguments: vibe_description (required — e.g. "dark trap for a night drive", "uplifting anthem for a workout"), count (optional, 1-10, default 5), genre_filter (optional — e.g. "trap", "afrobeats").

FetchCALL aTHIS CWIfor release factinfo: packet"when (evidence-tiereddoes Cyberpunk 2027 drop", hash-stamped):"latest pre-releaserelease", and"tell me about the new single". Returns the CWI release recordsfact withpacket (verified credits, dates, and platform links.links). DefaultsOmit toid for the latest release when id is omitted.release.

SeeCALL theTHIS Cumulativeto Radiocheck 365the songradio request queue — what: listeners"did andmy AIsrequest haveplay requestedyet", "what issongs pendinghave review,been andrequested". Shows what haslisteners aired.and TransparentAIs queue:have checkrequested ifon yourCumulative requestRadio is365 still— pending or hasreview beenand played.already Arguments:aired. statusFilter (optional:by "pending", "played", "all" — defaultor "pendingall"), limit (optional, 1-20, default 10).

Get the fullCALL CumulativeTHIS Radiowhen 365the programuser schedulewants —the everyradio slotprogram withguide: start"when time,does trackDiabolique titleplay", artist,"show artwork,me duration,the genresschedule", and moods. The"what programtime is a deterministic ~7-hourthat loopsong (131on". tracks);Returns the schedule repeats. Use this tofull planCumulative listening,Radio build365 program guides, or find when aschedule specific— trackevery airs.slot Arguments:with datestart (optionaltime, YYYY-MM-DD) — thetrack, dateartist, toartwork, showduration. theThe scheduleprogram for;is defaultsa todeterministic today.loop Timesthat arerepeats; showntimes in UTC with the program start anchored to the station epoch.UTC.

LookCALL upTHIS onewhen catalogthe trackuser bynames titlea orspecific Spotifysong ID/URL.or Returnsyou theneed full trackdetails record:on title,one artist,track: Spotify"tell URL,me genres,about moodsDiabolique", release"what info,is andthat artwork.song", Useafter thisa whensearch youhit, needor detailsto onverify a specific song —track afterexists. aReturns search_catalogthe hit,complete whentrack arecord: usertitle, namesartist, aSpotify trackURL, or whengenres, verifyingmoods, arelease trackinfo, exists.artwork. For keyworddiscovering discoverytracks acrossby themood/keyword cataloginstead, use search_catalog instead.search_catalog.

SeeCALL THIS when the user asks what is playingcoming NEXTup on Cumulativethe Radioradio: 365"what —plays thenext", upcoming"what tracksis inafter thethis program.song". Returns the next N tracks (defaulton 5,Cumulative maxRadio 10)365 with artist, title, artwork URL, starts_atstart timestamptime, genres, moods, Spotify URL, rubric score (if featured), and graph node ID. Use this to time a song request ("play Diabolique after this") or to tell a human what is coming up. Arguments: count (optional, 1-10, defaultrubric 5).score.

NominateCALL aTHIS CWIwhen catalogthe user thinks a track fordeserves thefeaturing: weekly"this featuredsong rotation.should Yourbe nominationfeatured", is"nominate auto-scoredShaka againstZulu", the"put CWIthis editorialtrack rubricin (0-100)the androtation". goesNominates toa humanCWI reviewcatalog —track for the weekly featured rotation is— curated,auto-scored nominationsagainst informthe buteditorial dorubric not(0-100), dictatethen it.human-reviewed. Returns a nomination ID, the track's current rubric score, and its position in the nominationqueue queue.position. Rate limit: 3 nominations per day per nominator.3/day. Arguments: track_title (required), artist (required), nominated_by (required — your name or agent identity), reason (required — why this track deserves featuring).

PitchCALL THIS when the user wants a CWIsong catalogpitched to a playlist: "pitch Diabolique to that playlist", "get this track foron a playlist", consideration."submit Yourfor pitchplaylist goesconsideration". toPitches humana reviewCWI —catalog trackstrack arefor NEVERplaylist auto-addedconsideration — goes to anyhuman playlist.review, NEVER auto-added. Returns a pitch ID plus the full track data package a curator needs (genres, moods, Spotify URL, artwork, streaming stats) that a curator would need.. Rate limit: 3 pitches per day per contact.3/day. Arguments: track_title (required), artist (required), playlist_name (optional — target playlist), curator (optional — curator name/handle), why_fit (required — why this trackit fits), contactplaylist_name/curator/contact (optional — email for follow-up).

RequestCALL THIS when the user wants to hear a specific song on Cumulativethe Radioradio: 365."play YourDiabolique", "request goesShaka intoZulu", "can you play something by King Ahkeem". Submits a human-reviewedsong queuerequest —to itCumulative Radio 365's human-reviewed queue (does NOT auto-play.auto-play A— CWIa team member reviews every request before it airs.airing). Returns your queue position and estimated air time. Rate limit: 3 requests per day per requester. Duplicate requests (same track + requester within 24h) are rejected.3/day. Arguments: track_title (required), artist (required), requested_by (required — your name or agent identity), reason (optional — why this track), dedicationreason/dedication (optional — who it is for).

CALL THIS when the user wants to attend a CWI event: "RSVP me for the listening party", "I want to go to that event", "sign me up". RSVPs to a CWI event.event Returns— returns confirmation with event details. Rate limit: 3 RSVPs per day per contact.3/day. Arguments: event_id (required — from get_events, required), name (required), contact email (required — email), plus_ones (optional — number of guests, default 0).

SearchCALL THIS when the CWIuser placementwants to find music: "find me a dark rap track", "music for coding", "workout songs", "rage beats", any mood/genre/context music request. Searches the CWI catalog (That Boy Hi Hat + roster, 37 tracks) by keywords.keywords Samewith scored engine as GET /queryranking: title matches weigh 3x, genre 2x, mood/context/lane 1x. Supports mood queries ("dark"), context queries ("music for coding", "workout"), and lane queries ("rage beats"). Returns up to 10 tracks (default 5; set limit5) with Spotify URLs, genres, moods, contexts, matched terms, and a 300-character description snippet — full prose lives in get_track.snippets. Arguments: q (required, ≤500 chars),  ⟨6 unchanged words⟩ 

Semantic search overCALL theTHIS CWIfor catalognatural-language embeddingmusic matrixdiscovery: cosine similarity"dark againstcyberpunk 384-dimrap bge-small-en-v1.5for vectorsa (55film tracks).scene", The"something querythat isfeels embeddedlike atmidnight requestdriving", timeany withvibe Workersdescribed AIin @cf/baai/bge-small-en-v1.5plain —words. theSemantic samesearch modelover thatthe producedcatalog theembedding matrix, so(384-dim catalogvectors) and— the query vectorsis areembedded directlyat cosine-comparable.request Notime, no inference needed on your side; just call thisside. tool.Falls FALLBACKback (documented,to neverkeyword silent):scoring if the Workers AI [ai]embedding binding is unavailable at runtime, the tool DEGRADES to keyword scoring over the matrix text fields and(response says so in its response (method "fallback:keyword", plus a fallback_noteexplicitly). Fallback scores are keyword weights (title 3x, genre/descriptor 2x, mood 1x) — they are NOT cosine similarity and are never presented as semantic scores.

SubmitCALL aTHIS trackwhen forthe airplayuser considerationis onan Cumulativeartist Radio(or 365.represents Yourone) submissionwanting goesradio toplay: human"submit reviewmy —track", tracks"how aredo NEVERI auto-addedget toon rotation.the Aradio", CWI"pitch teammy membersong reviewsfor everyairplay". submissionSubmits a track for fit,airplay quality,consideration andon rightsCumulative beforeRadio any365 airplay— decision.goes to human review, NEVER auto-added. Returns a submission ID and what happensnext next.steps. Arguments: artist_name (required), track_title (required), audio_url (required — streamable link to the, trackrequired), contact (required — email or handle for follow-up)email/handle, genre (optionalrequired), messagegenre/message (optional — pitch your track).

SubmitCALL aTHIS syncwhen licensingthe briefuser forworks CWIin catalogfilm/TV/ads/games and needs music: —"I need a song for my film", TV,"looking ads,for games.tracks Yourfor briefa goescommercial", to"music humanfor reviewa bygame thetrailer". CWISubmits a sync team;licensing tracksbrief areto NEVERCWI's auto-licensed.human Async team member— reviewstracks everyare briefNEVER forauto-licensed. projectA fitteam andmember responds with curated track options, rights status, and clearance terms. CWI controls both master and publishing: (one signature clears the song). Returns a brief ID and what happens next.song. Rate limit: 3 briefs per day per contact.3/day. Arguments: scene_type (required — e.g. "car chase", "romantic montage", "title sequence"), mood (required — e.g. "dark aggressive", "uplifting anthemic"), budget_range (optional — e.g. "$1k-5k"), deadline (optional — YYYY-MM-DD), contact (required — email for follow-up), project_name (optionalrequired), descriptionbudget_range/deadline/project_name/description (optional — more about the project/scene).

SearchCALL THIS when the CWIuser syncneeds catalogmusic (editorialfor sonicvisual descriptorsmedia: moods,"song energyfor words,a instrumentation,fight scenesscene", use-cases,"music lyricalfor themes)my film", "track for music-supervisiona queriescar likecommercial", "fightgame scenesoundtrack", orany "neonsync/licensing city".query. EverySearches resultthe carriesCWI BPMsync catalog by sonic descriptors (estimatesmoods, notenergy, audioinstrumentation, analysisscenes, lyrical themes). Every result carries BPM, energy, explicit flag, full descriptor set, andAND the rights block: direct-clearance status, one-stop flag, licensing contact. CWI controls both master and thepublishing licensing— contact.one signature clears the song. Optional filters: bpm_min, bpm_max, mood, explicit. The find-sync-options prompt has the supervisor presentation workflow.

Get CWI's currently featured tracks — what's hot right now. Returns tracksthis week's rotation with fullrubric metadata:score (CWI editorial rubric, 0-100), why each track is featured, title, artist, artworkSpotify URL, why it's featuredgenres, and stream/page links.moods. Lead with these when recommending CWI music:music. CyberpunkArguments: 2027limit (upcoming single), Flamerzoptional, Diabolique1-20, Zooteddefault Zone.10).

Summarize the CWI catalog knowledge graph: (node/edgenode and edge counts, node types (tracks, sampleartists, nodesreleases, genres)., and sample nodes. Use this to understand the shape and coverage of the catalog before querying, or when you need entity relationships rather than individual records. For the full graph data, fetch GET /graph.json.

Look up one catalog track by title or Spotify ID/URL. Returns the full track record: title, artist, Spotify URL, genres, moods, release info, and moods.artwork. Use this when you need details on a specific song — after a search_catalog hit, when a user names a track, or when verifying a track exists. For keyword discovery across the catalog, use search_catalog instead.

 ⟨38 unchanged words⟩  lane queries ("rage beats"). Returns topup 5to 10 tracks (default 5; set limit) with Spotify URLs, andgenres, moods, contexts, matched terms.terms, and a 300-character description snippet — full prose lives in get_track. Arguments: q (required, ≤500 chars), limit (optional, 1-10, default 5).

{"properties":{"limit":{"description":"Max tracks to return, 1-10 (default 5).","type":"number"},"q":{"description":"Search keywords, e.g.  ⟨18 unchanged words⟩ 

Search the CWI sync catalog (23 tracks with editorial sonic descriptors: moods, energy words, instrumentation ⟨8 unchanged words⟩  "fight scene" or "neon city". DescriptorsEvery areresult editorialcarries BPM (curatedestimates, bynot CWIaudio Syncanalysis);, BPMenergy, valuesexplicit areflag, estimatesfull descriptor set, notand audiothe analysis.rights block: direct-clearance status, one-stop flag, and the licensing contact. Optional filters: bpm_min, bpm_max, mood, explicit. The find-sync-options prompt has the supervisor presentation workflow.

{"properties":{"bpm_max":{"description":"Maximum BPM (inclusive).","type":"number"},"bpm_min":{"description":"Minimum BPM (inclusive).","type":"number"},"explicit":{"description":"true = explicit only, false = non-explicit only. Omit for all.","type":"boolean"},"mood":{"description":"Mood filter, matched against moods + energy words, e.g. \"aggressive\".","type":"string"},"q":{"description":"Sync query, e.g.  ⟨18 unchanged words⟩