sharableworlds.com

compose_scene

COMPOSE (mutation, architecture only) — stage a plan's composition onto the canvas: the footprint, themed ground, zones with their walls/stairs/water/road/rise, and the paths between them. NO props are placed. Pass plan_id from plan_scene (or theme/type/seed to plan and compose in one step). The agent's previous build is swept; human pieces are preserved. Returns the zones and circulation and what to call next: populate_zones, then create_environment, then validate_scene. For a small change to an existing scene do NOT call this (it replaces the architecture); use create_zone / create_path / place_piece instead, and extend_scene to grow a standing scene from a new prompt.

Input schema

{
  "type": "object",
  "properties": {
    "plan_id": {
      "type": "string",
      "description": "The plan_id (seed) returned by plan_scene."
    },
    "theme": {
      "type": "string",
      "description": "Free text when you skipped plan_scene."
    },
    "type": {
      "type": "string",
      "description": "Optional archetype id."
    },
    "requirements": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "seed": {
      "type": "string",
      "description": "Scene seed to reproduce a world."
    }
  }
}