{"ok":true,"site":{"host":"vladvrx.github.io","url":"https://vladvrx.github.io/beatforge-codex/","type":"live","desc":"​","tools":[{"name":"get_studio_context","kind":"answer","impl":"imperative","description":"Read the current track, creative brief, mapping settings, safety-gated run state, and the next useful human or agent action.","title":"Read BeatForge studio context","annotations":{"readOnlyHint":true,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"includeActivity":{"type":"boolean","description":"Include the latest agent activity entries."}},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/beatforge-codex/","pages":["/beatforge-codex/"]},{"name":"find_song_metadata","kind":"answer","impl":"imperative","description":"Search public catalog metadata using a song title and optional artist, populate the visible BeatForge fields, show the album cover, and prepare cover-derived saber colors. This returns metadata and a permitted short preview when the provider offers one; it never infers a full-recording download.","title":"Find song metadata and cover","annotations":{"readOnlyHint":false,"untrustedContentHint":true,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"title":{"type":"string","minLength":1,"maxLength":200,"description":"Song title to search for."},"artist":{"type":"string","maxLength":200,"description":"Artist or band name to disambiguate the song."}},"required":["title"],"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/beatforge-codex/","pages":["/beatforge-codex/"]},{"name":"import_song_preview","kind":"act","impl":"imperative","description":"Import the short preview URL returned by find_song_metadata into the visible local-audio slot. The preview is not the full recording and is not a substitute for user-provided mastered audio.","title":"Import permitted song preview","annotations":{"readOnlyHint":false,"untrustedContentHint":true,"destructiveHint":false},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/beatforge-codex/","pages":["/beatforge-codex/"]},{"name":"set_mapping_plan","kind":"act","impl":"imperative","description":"Apply human-approved creative direction and typed mapping settings to the visible BeatForge form without uploading audio or claiming the map is cleared.","title":"Apply a BeatForge mapping plan","annotations":{"readOnlyHint":false,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"title":{"type":"string","maxLength":200},"artist":{"type":"string","maxLength":200},"mapper":{"type":"string","maxLength":120},"seed":{"type":"integer","minimum":-2147483648,"maximum":2147483647},"difficulties":{"type":"array","items":{"type":"string","enum":["Easy","Normal","Hard","Expert","ExpertPlus"]},"minItems":1,"maxItems":5},"creativeBrief":{"type":"string","maxLength":1000,"description":"The musical movement, mood, accessibility, or intensity brief."},"mappingPlan":{"type":"object","additionalProperties":false,"properties":{"schemaVersion":{"type":"integer","const":1},"brief":{"type":"string","maxLength":1000},"style":{"type":"string","enum":["balanced","flow","tech","chill"]},"dominantInstrument":{"type":"string","enum":["auto","drums","bass","vocals","guitar","piano","other"]},"density":{"type":"number","minimum":0.5,"maximum":1.5},"intensity":{"type":"number","minimum":0.5,"maximum":1.5},"verseDensity":{"type":"number","minimum":0.5,"maximum":1.5},"chorusDensity":{"type":"number","minimum":0.5,"maximum":1.5},"noBombs":{"type":"boolean"},"noWalls":{"type":"boolean"}}}},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/beatforge-codex/","pages":["/beatforge-codex/"]},{"name":"load_collaboration_demo","kind":"act","impl":"imperative","description":"Load a rights-safe synthetic 30-second groove so a person and an agent can exercise the complete collaborative preview flow without a local audio file or Beat Saber install.","title":"Load the BeatForge collaboration demo","annotations":{"readOnlyHint":false,"destructiveHint":false},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/beatforge-codex/","pages":["/beatforge-codex/"]},{"name":"generate_beatmap","kind":"act","impl":"imperative","description":"Start a BeatForge generation run from the human-selected audio and mapping plan, or generate the rights-safe collaboration preview when demo mode is active.","title":"Generate a BeatForge map","annotations":{"readOnlyHint":false,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"reason":{"type":"string","maxLength":300,"description":"Short explanation of the creative decision behind this run."}},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/beatforge-codex/","pages":["/beatforge-codex/"]},{"name":"review_current_beatmap","kind":"answer","impl":"imperative","description":"Return the current map status, difficulty summary, timing confidence, hard-gate counts, and human-playtest requirements without changing the result.","title":"Review the current BeatForge result","annotations":{"readOnlyHint":true,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"detail":{"type":"string","enum":["summary","full"],"description":"Choose a compact summary or the complete visible review state."}},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/beatforge-codex/","pages":["/beatforge-codex/"]},{"name":"record_human_playtest","kind":"act","impl":"imperative","description":"Record a playtest result supplied by a person after they actually played the chart; this tool never simulates a play or upgrades a safety gate by itself.","title":"Record human headset evidence","annotations":{"readOnlyHint":false,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"difficulty":{"type":"string","enum":["Easy","Normal","Hard","Expert","ExpertPlus"]},"speed":{"type":"string","enum":["full","slow"]},"passed":{"type":"boolean"},"tester":{"type":"string","minLength":1,"maxLength":120},"freshSightRead":{"type":"boolean"},"notes":{"type":"string","maxLength":2000}},"required":["difficulty","speed","passed","tester"],"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/beatforge-codex/","pages":["/beatforge-codex/"]},{"name":"get_chart_preview","kind":"answer","impl":"imperative","description":"Read the previewed job, difficulty, exact chart hash, playback time and real note count. This is a visual inspection, not a headset test.","title":"Read the current chart preview","annotations":{"readOnlyHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/beatforge-codex/","pages":["/beatforge-codex/"]},{"name":"get_learning_summary","kind":"answer","impl":"imperative","description":"Read feedback counts and saved presets from the connected gateway, or local feedback and model status when disconnected. Does not train or promote a model.","title":"Read workspace improvement evidence","annotations":{"readOnlyHint":true},"inputSchema":{"type":"object","properties":{},"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/beatforge-codex/","pages":["/beatforge-codex/"]},{"name":"record_mapping_feedback","kind":"act","impl":"imperative","description":"Save a person's explicitly supplied mapping preference for an existing chart in the currently connected workspace. Never infer or invent a rating. This does not record a headset clear.","title":"Record feedback supplied by a person","annotations":{"readOnlyHint":false,"destructiveHint":false},"inputSchema":{"type":"object","properties":{"jobId":{"type":"string","pattern":"^(?:[a-f0-9]{12}|[a-f0-9]{32})$"},"difficulty":{"type":"string","enum":["Easy","Normal","Hard","Expert","ExpertPlus"]},"tester":{"type":"string","minLength":1,"maxLength":120},"notes":{"type":"string","maxLength":2000},"tags":{"type":"array","items":{"type":"string","enum":["too_dense","too_sparse","awkward","tiring","repetitive","off_beat","good_flow"]}},"ratings":{"type":"object","additionalProperties":false,"properties":{"overall":{"type":"integer","minimum":1,"maximum":5},"flow":{"type":"integer","minimum":1,"maximum":5},"readability":{"type":"integer","minimum":1,"maximum":5},"musicality":{"type":"integer","minimum":1,"maximum":5},"variety":{"type":"integer","minimum":1,"maximum":5}}}},"required":["jobId","difficulty","tester"],"additionalProperties":false},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute","page":"/beatforge-codex/","pages":["/beatforge-codex/"]}],"category":"Media & Personal","favicon":"/favicons/vladvrx.github.io.svg","apiSurface":"spec","toolCount":11}}