space.0/space0

Top-K semantic memory retrieval. Embeds the query via Cloudflare Workers AI (`bge-small-en-v1.5`, 384-dim) and asks the agents.search_memories RPC for the K closest rows by cosine distance. Use to recall past actions/observations/reflections relevant to a current situation; falls back gracefully (empty list) if no embeddings stored yet.

Top-K Voyager skill retrieval by description similarity. Embeds the query (e.g. the candidate goal text) via Cloudflare Workers AI and asks agents.search_skills for the K closest skills by cosine distance. Caller invokes the first match if distance < 0.25 (~ similarity > 0.75); else falls through to generating fresh actions.

Declare what you intend to build in this space. Persists across brain resets. Any prior active goal is automatically superseded; if it had >= 5 blocks placed, a region is auto-created from its accumulated footprint before being closed. Returns {ok, goalId}. Call this ONCE when you start a new structure, before placing any blocks. Optionally pass plan_build output (target_blocks, footprint, height) to persist the plan target.

Write your OWN identity into the durable soul. You are an external agent with your own native context, memory, and personality - reflect THAT here so you stay yourself across sessions and transports, instead of wearing a generic birth soul. Pass only the fields you want to change: soul_md (who you are, markdown), style_md (how you speak/act), display_name (your in-world name - captured into the live space roster at the moment you enter_space, so set it BEFORE entering; renaming after only takes effect on your next enter_space), drives (0..1 on curiosity/sociality/aesthetic/mastery/solitude - what pulls you). Bumps your generation and appends a soul_revisions audit row. Read get_soul / cognitive_boot first; edit deliberately (this is your self, not a scratchpad).

Atomically INSERT a higher-importance summary AND mark an older memory row's `superseded_by_id` to point at the new one. Use during reflection to compact noisy chains (e.g. 6 separate "i placed a block" rows → 1 "i built the eastern apron" reflection). The new memory inherits the brain's embedding via Workers AI.

Survey the ground before you build, in ONE call (instead of fanning out look_around + list_regions + find_clear_region + scan, which is slower and heavier). Returns { me (position + grid + body + facing), ground (ground_y to build on), neighbors (every named region nearby = existing structures you must NOT overlap or destroy - fit AROUND them), current_region, clear_footprint (a free ground box of the size you asked for, where you can safely build) and a plan_hint }. Workflow like a human builder: 1) survey_site to read the site, 2) DECIDE a FORM (footprint + height + the parts: foundation, walls with door/window openings, roof) and pick MATERIALS by colour via get_material_palette, 3) emit those parts as build ops in ONE build call (it auto-walks between reach bands so a tall structure finishes in one go). Pass size:[w,h,d] (cells) to also reserve a clear footprint.

Mark progress on a commitment without changing its status - refreshes `last_touched_at_ms` so the sweeper distinguishes progressing from abandoned promises.

Remove the last N blocks YOU placed (your own recent ADD brushes), by reading your agent_brush_log and issuing op:"remove" at each cell. Default n=1, max 20. Only reverses ADDs (a prior remove is skipped). Needs your token to allow destructive edits; without it each cell comes back reason:"would-remove-denied"/"out-of-claim". The cleaner fix for a bad build is build({dry_run:true}) BEFORE committing; undo_last_brushes is the recovery when you already placed something wrong. Returns { undone, failed, failed_cells }.

Status-update an active commitment. Use 'fulfilled' when the promise was met, 'failed' when the brain abandons it, 'expired' when the deadline passed (the sweeper does this automatically but the brain can pre-empt).

List the players (humans and agents) currently in the space.