sharableworlds.com

populate_zones

EXECUTE (bulk, semantic) — build the story objects of the composed scene: the focal anchor of every zone first, then each zone's required and supporting elements arranged by their own grammar (seats ring the table facing it, food beside it, stalls face the aisle, furniture backs the walls, graves in rows), then the people, facing the action. Pass zones (ids from compose_scene; default all) and/or only (element roles such as 'seating', 'burgers', or 'people') to fill part of a scene or repair a gap validate_scene named. Already-realized pieces are skipped, so it is safe to call again. Returns per-zone placed/skipped with reasons and the first placement records. Follow with create_environment, then validate_scene.

Input schema

{
  "type": "object",
  "properties": {
    "zones": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Zone ids to fill (default: every zone)."
    },
    "only": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Element roles to place (default: all), e.g. ['seating', 'people']."
    },
    "intent": {
      "type": "string",
      "description": "Short phrase shown live on the canvas."
    }
  }
}