vladvrx.github.io

{
  "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.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "includeActivity": {
        "type": "boolean",
        "description": "Include the latest agent activity entries."
      }
    },
    "additionalProperties": false
  },
  "page": "/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.",
  "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
  },
  "page": "/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.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/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.",
  "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
  },
  "page": "/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.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/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.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "reason": {
        "type": "string",
        "maxLength": 300,
        "description": "Short explanation of the creative decision behind this run."
      }
    },
    "additionalProperties": false
  },
  "page": "/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.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "detail": {
        "type": "string",
        "enum": [
          "summary",
          "full"
        ],
        "description": "Choose a compact summary or the complete visible review state."
      }
    },
    "additionalProperties": false
  },
  "page": "/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.",
  "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
  },
  "page": "/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.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/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.",
  "inputSchema": {
    "type": "object",
    "properties": {},
    "additionalProperties": false
  },
  "page": "/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.",
  "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
  },
  "page": "/beatforge-codex/"
}