pi-simocracy 0.2.0 → 0.4.1

package/README.md

@@ -1,18 +1,28 @@
 # pi-simocracy
 
 Load a [Simocracy](https://simocracy.org) sim into your [`pi`](https://github.com/mariozechner/pi-coding-agent) chat — see its
-pixel-art sprite render in the terminal and chat with the agent **as that sim**.
+sprite render in the terminal and chat with the agent **as that sim**.
 
 ```
 /sim mr meow
 ```
 
 …fetches Mr Meow from Simocracy's ATProto indexer, renders his 32×32
-sprite as colored ANSI half-blocks directly in the chat, and pushes
-his constitution + speaking style into pi's system prompt so pi
+pixel-art sprite as colored ANSI half-blocks directly in the chat, and
+pushes his constitution + speaking style into pi's system prompt so pi
 roleplays as Mr Meow until you `/sim unload`.
 
-![Mr Meow loaded inline in pi](demo/sim-load.gif)
+<p align="center">
+  <img src="https://raw.githubusercontent.com/GainForest/pi-simocracy/main/demo/sim-load.gif" alt="Mr Meow (a pipoya pixel-art cat) loaded inline in pi's chat" width="760">
+</p>
+
+As of v0.4.0, codex pet sims (OpenAI hatch-pet skill output) render too —
+load **Einstein** with `/sim einstein` and the WebP atlas decodes, the
+idle frame crops, and the half-block ANSI render fires inline:
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/GainForest/pi-simocracy/main/demo/codex-pet-load.gif" alt="Einstein (a codex pet sim with a WebP petSheet) loaded inline in pi's chat" width="760">
+</p>
 
 ---
 
@@ -33,13 +43,17 @@ doesn't need it — it just rewrites pi's system prompt.
 
 ## Slash commands
 
-| Command          | What it does                                                |
-|------------------|-------------------------------------------------------------|
-| `/sim <name>`    | Load a sim by name (fuzzy search). Multiple matches → picker. |
-| `/sim <at-uri>`  | Load a sim by AT-URI directly (no search).                  |
-| `/sim status`    | Show which sim is currently loaded.                         |
-| `/sim unload`    | Drop the persona and break character cleanly.               |
-| `/sim help`      | Print usage.                                                |
+| Command           | What it does                                                |
+|-------------------|-------------------------------------------------------------|
+| `/sim <name>`     | Load a sim by name (fuzzy search). Multiple matches → picker. |
+| `/sim <at-uri>`   | Load a sim by AT-URI directly (no search).                  |
+| `/sim status`     | Show which sim is currently loaded.                         |
+| `/sim unload`     | Drop the persona and break character cleanly.               |
+| `/sim login [handle]` | Sign in to **ATProto / Bluesky** via loopback OAuth (NOT Anthropic — pi's built-in `/login` is what does that). Required before pi can update your sim. |
+| `/sim logout`     | Clear the local ATProto OAuth session.                      |
+| `/sim whoami`     | Show the signed-in handle / DID.                            |
+| `/sim my [name]`  | List / pick / fuzzy-load sims you own on your PDS. Single match auto-loads; ambiguous matches open a picker. Requires `/sim login`. |
+| `/sim help`       | Print usage.                                                |
 
 Examples:
 
@@ -47,20 +61,48 @@ Examples:
 /sim mr meow
 /sim Marie Curie
 /sim at://did:plc:qc42fmqqlsmdq7jiypiiigww/org.simocracy.sim/3mfo6vwfaka24
+/sim login alice.bsky.social
+/sim my
 /sim unload
 ```
 
 ---
 
+## Editing a sim's constitution / speaking style
+
+There is no slash-command pipeline for this. Once you've signed in via
+`/sim login` and loaded a sim you own (`/sim my`, then pick), just
+**describe the change you want to pi**:
+
+```
+> add a red line about animal welfare to the constitution
+> rewrite the speaking style to drop the lenny faces and be more concise
+> shorten the constitution to ~300 words and emphasise renewable energy
+```
+
+Pi rewrites the constitution and/or speaking style itself, then calls
+the `simocracy_update_sim` tool to persist the result. The tool refuses
+to run if you're not signed in or you don't own the loaded sim. The
+new persona takes effect on the next reply — no reload needed.
+
+Writing goes directly to your PDS via
+`com.atproto.repo.createRecord` / `putRecord` against the
+`org.simocracy.agents` (constitution) and `org.simocracy.style`
+(speaking style) collections — the same lexicons simocracy.org reads
+back.
+
+---
+
 ## LLM-callable tools
 
 The same actions are exposed to pi as tools, so the model can drive them itself:
 
-| Tool                     | Use when                                                        |
-|--------------------------|-----------------------------------------------------------------|
-| `simocracy_load_sim`     | Load a sim into the current session (sets the persona).         |
-| `simocracy_unload_sim`   | Stop roleplaying.                                               |
-| `simocracy_chat`         | Send one message to a sim and get a quoted reply, **without** changing the active session persona. Useful for "ask Mr Meow what he thinks of this PR." Requires `OPENROUTER_API_KEY`. |
+| Tool                    | Use when                                                        |
+|-------------------------|-----------------------------------------------------------------|
+| `simocracy_load_sim`    | Load a sim into the current session (sets the persona).         |
+| `simocracy_unload_sim`  | Stop roleplaying.                                               |
+| `simocracy_chat`        | Send one message to a sim and get a quoted reply, **without** changing the active session persona. Useful for "ask Mr Meow what he thinks of this PR." Requires `OPENROUTER_API_KEY`. |
+| `simocracy_update_sim`  | Write a new constitution (`shortDescription` + `description`) and/or speaking `style` for the **loaded** sim to your PDS. Requires `/sim login` AND ownership of the loaded sim. |
 
 ---
 
@@ -77,11 +119,18 @@ The same actions are exposed to pi as tools, so the model can drive them itself:
    - `org.simocracy.sim`     — display name + sprite + avatar blob refs
    - `org.simocracy.agents`  — short description + full constitution
    - `org.simocracy.style`   — speaking style / mannerisms
-4. **Render.** Fetch the sprite-sheet blob (128×128 PNG, 4×4 of 32×32
-   walking frames) via `com.atproto.sync.getBlob`, decode with `pngjs`,
-   crop the front-facing walk-1 frame, emit as 24-bit ANSI using the
-   upper-half-block character `▀` so each terminal cell paints two
-   pixels. Transparent regions show pi's background through.
+4. **Render.** Fetch the sprite blob via `com.atproto.sync.getBlob`,
+   decode it, crop the front-facing idle frame, and emit as 24-bit ANSI
+   using the upper-half-block character `▀` so each terminal cell paints
+   two pixels. Two render paths depending on the sim's `spriteKind`:
+   - **`pipoya`** (legacy + default): 128×128 PNG, 4×4 of 32×32 walking
+     frames; decode with `pngjs`, take row 0 col 0 at native size.
+   - **`codexPet`** (OpenAI hatch-pet output): 1536×1872 atlas, 8×9 of
+     192×208 cells. PNG sheets decode through `pngjs`; WebP sheets
+     decode through `@jsquash/webp` (wasm, lazy-init). The idle cell
+     (row 0 col 0) is box-downscaled to ~32 wide so the inline render
+     stays comparable in height to a pipoya sprite.
+   Transparent regions show pi's background through.
 5. **Inject.** A `before_agent_start` event handler appends the sim's
    identity + constitution + speaking style to pi's system prompt **every
    turn**. After `/sim unload`, a one-shot override fires on the next
@@ -97,12 +146,17 @@ keeps the terminal it's already running in.
 
 ```
 src/
-├── index.ts        # extension entry: slash command, tools, persona injection
-├── simocracy.ts    # indexer + PDS client (read-only)
-├── png-to-ansi.ts  # RGBA half-block ANSI renderer
-└── openrouter.ts   # minimal OpenRouter client (only used by simocracy_chat)
+├── index.ts          # extension entry: slash command, tools, persona injection
+├── persona.ts        # buildSimPrompt(sim) — the system-prompt fragment
+├── simocracy.ts      # indexer + PDS client (read-only fetchers)
+├── writes.ts         # PDS writers + ownership / sign-in preconditions
+├── png-to-ansi.ts    # RGBA half-block ANSI renderer + downscalers
+├── webp-to-rgba.ts   # @jsquash/webp wrapper for codex pet WebP sheets
+├── openrouter.ts     # minimal OpenRouter client (only used by simocracy_chat)
+└── auth/             # ATProto OAuth loopback flow + session storage
 demo/
-└── sim-load.tape   # vhs tape — render with `vhs demo/sim-load.tape`
+├── sim-load.tape       # vhs tape — Mr Meow (pipoya)
+└── codex-pet-load.tape # vhs tape — Einstein (codex pet)
 ```
 
 ---
@@ -118,11 +172,12 @@ pi -e $(pwd)/src/index.ts -ne -ns  # load the extension directly
 
 Then in `pi`: `/sim mr meow`.
 
-To rebuild the demo recording:
+To rebuild the demo recordings:
 
 ```bash
 brew install vhs                   # one-time
-vhs demo/sim-load.tape             # writes demo/sim-load.{webm,gif}
+vhs demo/sim-load.tape             # Mr Meow (pipoya) — demo/sim-load.{webm,gif}
+vhs demo/codex-pet-load.tape       # Einstein (codex pet) — demo/codex-pet-load.{webm,gif}
 ```
 
 ---
@@ -137,7 +192,11 @@ These come bundled with `pi` itself, so installing pi-simocracy via
 
 Direct npm dependencies (auto-installed):
 
-- `pngjs` — PNG decoder for sprite blobs
+- `pngjs` — PNG decoder for pipoya sprite blobs and codex pet PNG sheets
+- `@jsquash/webp` — wasm WebP decoder for codex pet WebP sheets
+  (lazy-init, no native bindings)
+- `@atproto/api` + `@atproto/oauth-client-node` — ATProto loopback OAuth
+  for `/sim login` and PDS writes via `simocracy_update_sim`
 - `typebox` — tool parameter schemas
 
 ---
@@ -157,4 +216,4 @@ Direct npm dependencies (auto-installed):
 
 ## License
 
-MIT — see [LICENSE](./LICENSE).
+MIT — see [LICENSE](https://github.com/GainForest/pi-simocracy/blob/main/LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-simocracy",
-  "version": "0.2.0",
+  "version": "0.4.1",
   "description": "Pi extension: load a Simocracy sim into your chat — see its pixel-art sprite render inline in the terminal and roleplay with it.",
   "type": "module",
   "author": "David Dao <david@gainforest.earth> (https://github.com/daviddao)",
@@ -45,6 +45,7 @@
   "dependencies": {
     "@atproto/api": "^0.19.11",
     "@atproto/oauth-client-node": "^0.3.17",
+    "@jsquash/webp": "^1.5.0",
     "pngjs": "^7.0.0",
     "typebox": "^1.1.24"
   },

package/src/auth/commands.ts

@@ -106,8 +106,8 @@ export async function runLogin(
 
     ctx.ui.notify(
       handleResolved
-        ? `🔐 Signed in to ATProto as @${handleResolved} (${did}). You can now use /sim interview --apply and /sim train apply --apply to write to your PDS.`
-        : `🔐 Signed in to ATProto as ${did}. You can now use /sim interview --apply and /sim train apply --apply to write to your PDS.`,
+        ? `🔐 Signed in to ATProto as @${handleResolved} (${did}). Pi can now update the constitution / speaking style of any sim you own via the simocracy_update_sim tool — just load one of your sims with /sim my and ask pi for the change you want.`
+        : `🔐 Signed in to ATProto as ${did}. Pi can now update the constitution / speaking style of any sim you own via the simocracy_update_sim tool — just load one of your sims with /sim my and ask pi for the change you want.`,
       "info",
     );
   } finally {
@@ -139,8 +139,8 @@ export async function runWhoami(ctx: ExtensionCommandContext): Promise<void> {
   }
   ctx.ui.notify(
     auth.handle
-      ? `Signed into ATProto as @${auth.handle} (${auth.did}) since ${auth.lastLogin}. Use /sim interview --apply or /sim train apply --apply to write records to your PDS.`
-      : `Signed into ATProto as ${auth.did} since ${auth.lastLogin}. Use /sim interview --apply or /sim train apply --apply to write records to your PDS.`,
+      ? `Signed into ATProto as @${auth.handle} (${auth.did}) since ${auth.lastLogin}. Pi can update the constitution / speaking style of any sim you own (loaded via /sim my) by calling the simocracy_update_sim tool.`
+      : `Signed into ATProto as ${auth.did} since ${auth.lastLogin}. Pi can update the constitution / speaking style of any sim you own (loaded via /sim my) by calling the simocracy_update_sim tool.`,
     "info",
   );
 }