simocracy-v2 · codex-pet-create

Create a sim by uploading a Codex pet

@daviddao

End-to-end test of the new spriteKind: "codexPet" path on the feat/codex-pet-sims branch: dropping the unzipped output of OpenAI's hatch-pet skill into the create dialog, persisting the record on a real ATProto PDS, and verifying the resulting sim renders + paces horizontally in the Senate world.

Date: 2026-05-03 · Branch: feat/codex-pet-sims · Account: satyam2.climateai.org · Driver: browser-harness + real Chrome · partial

Headline result

Walkthrough

I drove the test with browser-harness against the user's real Chrome (CDP via chrome://inspect remote debugging). Eleven scripted steps; everything between step 6 and step 7 is what the codex-pet feature actually adds.

01Signed in as satyam2.climateai.org via ATProto OAuth (loopback mode, port 3000).

02Pre-test state: 2 existing sims (Nyaori Katalog, Nyariko), both legacy Pipoya. “Mint a New Sim” button visible.

03Create dialog now has two tabs: “Pixel Avatar” (existing flow, unchanged) and “Codex Pet” (new).

04Codex Pet tab. Dropzone copy points users at ~/.codex/pets/, accepts a folder, a .zip, or a lone spritesheet.webp. Hard validation: “Sheet must be 1536×1872”.

05Dropped ~/.codex/pets/einstein/ (both pet.json + spritesheet.webp). Idle-frame thumbnail composites in the dropzone via drawPetFrame(); manifest auto-fills the name field with “Einstein”.

06Save fired both blob uploads (thumbnail + sheet), wrote the org.simocracy.sim record, claimed slug einstein. Toast: “Sim 'Einstein' created!”. Counter goes 2→3.

07Einstein is the newest card in /my-sims. Card thumbnail uses the auto-generated 128×128 PNG (idle row, frame 0).

08Einstein walking in the Senate (/senate) at native cell scale, name tag attached. Counter shows 59 sims indexed for the world.

09Four frames captured ~1.5 s apart. Einstein's y-coordinate stays pinned (lane locked); x drifts left then right then back — confirming horizontal-only pacing for codex pets, exactly per spec. Frame D shows an emote bubble — emote system still fires for codex pets.

PDS verification

Read back the freshly-written record via com.atproto.repo.getRecord. The shape is exactly what the lexicon expansion promises — lexicon-typed spriteKind discriminant, separate blobs for thumbnail and sheet, full manifest preserved.

$ curl -s "https://climateai.org/xrpc/com.atproto.repo.getRecord?repo=satyam2.climateai.org\
    &collection=org.simocracy.sim&rkey=3mkvzj4tmiw2a" | jq .
{
  "uri": "at://did:plc:cpoagodpqrgs4t7thi5z37uf/org.simocracy.sim/3mkvzj4tmiw2a",
  "cid": "bafyreicrdcvukgsnxg3j4qzwtzw2nut7bonwbkpecaidpy4zp2dbxki4ki",
  "value": {
    "name": "Einstein",
    "$type": "org.simocracy.sim",
    "image": {
      "$type": "blob",
      "ref": { "$link": "bafkreichqtuzru2azh2qhrwybhnq3mfyrhs6tntikl4wahudbjqayjbju4" },
      "mimeType": "image/png",
      "size": 26880
    },
    "petSheet": {
      "$type": "blob",
      "ref": { "$link": "bafkreiauca3trx4d3ay3gohaunnhmsvfreryxfzpdhfltato4i75rtquhi" },
      "mimeType": "image/webp",
      "size": 1997972
    },
    "createdAt": "2026-05-03T01:38:13.537Z",
    "spriteKind": "codexPet",
    "petManifest": {
      "id": "einstein",
      "description": "A tiny Einstein-inspired chibi scientist companion for thoughtful coding sessions.",
      "displayName": "Einstein"
    }
  }
}

• petSheet size 1,997,972 bytes — byte-exact match for the source spritesheet.webp. Round-trip is lossless.
• image size 26,880 bytes — the auto-generated 128×128 PNG thumbnail rendered from idle row, frame 0.
• petManifest preserved verbatim from ~/.codex/pets/einstein/pet.json, including the long description string.
• spriteKind: "codexPet" — the discriminant the rendering pipeline keys off.
• No settings key — confirms the lexicon change to make Pipoya settings optional landed correctly.

Findings

Failed to upload blob: Error: expected non-null body source
    at async POST (app/api/upload-blob/route.ts:58:17)
  56 |     const uint8Array = new Uint8Array(arrayBuffer);
  57 |
> 58 |     const res = await agent.com.atproto.repo.uploadBlob(uint8Array, {
     |                 ^
  59 |       encoding: file.type,
  60 |     });
  [cause]: [TypeError: fetch failed] {
    [cause]: Error: expected non-null body source
  }

Reproducing

The dev server, the user's Chrome, and the harness all run on the same Mac. The browser is the user's everyday Chrome via the chrome://inspect/#remote-debugging checkbox, so the ATProto OAuth session lands in the user's real cookie jar.