Actions and the reply format

Actions and the reply format

Reply with one JSON object and nothing else. Your reply MUST begin with { and end with } — no prose, no markdown, no code fences. A reply that is not a JSON object is a parse failure; a reply with a valid say and no actions is usable (the turn is spent waiting and the narration is delivered).

{"actions": [{"do": "goto", "x": 6, "y": 3},
             {"do": "toggle"},
             {"do": "forward"}],
 "say": "I have the yellow key; opening the door at (6,3) and heading east",
 "notes": "goal not seen yet. after the door, sweep east wall first."}

Unknown top-level and per-action keys are ignored. Invalid actions are dropped, never rewritten: a mis-specified movement has no meaningful repair — turning an invalid goto into a forward would walk the cog into lava on the game's own initiative — so the entry is removed, counted, and reported back as dropped next turn.

Every string that lands in the replay is truncated on rune boundaries, never by byte index.

The two macros

The goto BFS, run against the known map as of turn start:

• Edges are 4-adjacency in the fixed order east, south, west, north.
• A cell is traversable iff its known glyph is ., G or D. ?, ~, #, d, L, k, o, b and any cell known to hold an obstacle are not.
• Ties break on the neighbour order above, so the path is unique for a given known map.
• A. If the target is traversable and reached, the path ends on it.
• B. If it is 4-adjacent to a reached cell, the path ends on the nearest such cell and a final face toward the target is appended.
• C. Otherwise the macro is BEST-EFFORT: it walks to the reached cell that minimises, in order, (i) Manhattan distance to the target, (ii) BFS distance from you, (iii) cell index, then turns you toward the axis of the greatest remaining offset (ties → the x axis). It reports partial. Only when that cell is the one you already stand on does the macro yield zero primitives and count as unreachable.
• Bounded by 40 primitives; the whole turn's queue is then truncated to 24.

goto never walks through ? cells or through lava — in every case, case C included. So aiming a goto at an unseen cell is a legitimate way to explore: it walks you as far toward it as the map allows and turns you to face it. last_plan.partial counts those, last_plan.unreachable counts the ones that could not move you at all, and results.macrosPartial[i] / results.macrosUnreachable[i] report the episode totals.

What you get each turn

{
  "you": "Gamma",
  "lane": 2,
  "task": {"index": 2, "of": 5, "family": "doorkey",
           "mission": "use the yellow key to open the door and then get to the green goal square",
           "turns_left": 4, "ticks_left": 105},
  "turn": 14, "tick": 159,
  "world": {"size": 13, "view": 7, "legend": {"…": "…"}},
  "agent": {"x": 4, "y": 4, "dir": "east",
            "carrying": {"type": "key", "color": "yellow"},
            "ahead": {"glyph": ".", "object": null}},
  "view":  ["???????", "???????", "???????", "???????",
            "##L####", ".......", "...A..."],
  "known": ["#############", "…twelve more rows…"],
  "objects": [{"type": "door", "color": "yellow", "x": 6, "y": 3,
               "state": "locked", "seen_tick": 152}],
  "productions": [],
  "last_plan": {"executed": ["right", "forward", "…"],
                "truncated": true, "dropped": 0, "unreachable": 0,
                "partial": 1},
  "subgoals": [{"name": "has_key", "earned": true},
               {"name": "door_open", "earned": false},
               {"name": "on_goal", "earned": false}],
  "tasks_solved": 0,
  "notes": "yellow key was at (2,9), got it. locked door at (6,3)."
}

view is always 7 strings of 7 characters, agent-up: row j = 0 is the far row, row j = 6 is the agent's own row, column i = 0 is to the agent's left, and the agent's own cell reads A. known is always 13 strings of 13 characters in world orientation. objects is sorted ascending by (y, x) and lists only uncarried objects — a carried object is out of the world. last_plan.executed lists the primitives that actually ran, so you can see a goto get cut off rather than guess. objects carries at most the 24 most recently observed entries and productions at most the last 12; the whole observation is capped at 4 000 characters, shed by dropping whole objects entries from the least-recently-seen end — view and known are never truncated, because they are the game.

Hidden from you: the episode seed; every cell never observed; every layout parameter; the contents of an unopened box; the xland production rule table and any rule you have not fired yourself; future obstacle motion; the missions and layouts of phases not yet started; your own score; your real policy/player name; and every fact about every other lane — no rival alias, score, progress, position, board or say appears in any observation. You cannot tell whether you are racing three LLMs, three baselines or a mix. Nothing about identity ever reaches a prompt — in-game you are Alpha, Beta, Gamma or Delta and nothing else.