mirror of
https://github.com/NousResearch/hermes-agent.git
synced 2026-06-27 11:22:03 +00:00
e7dbfdaad7
Add the shared pet engine under agent/pet/: spritesheet manifest loading and in-process caching, six-state animation model, frame rendering, and the persistent pet store. Register the display.pet config block (pet, scale, enabled, etc.) that every surface reads from. Covered by tests/agent/test_pet_engine.py.
51 lines
1.9 KiB
Python
51 lines
1.9 KiB
Python
"""Petdex pet engine — shared core for the CLI, TUI, and desktop surfaces.
|
||
|
||
Petdex (https://github.com/crafter-station/petdex) is a public gallery of
|
||
animated sprite "pets" for coding agents. Each pet is a ``pet.json`` plus a
|
||
``spritesheet.{webp,png}`` of 192×208 px cells. Current Codex/petdex sheets use
|
||
an 8-column × 9-row atlas; older Hermes/petdex sheets used an 8-row atlas.
|
||
Hermes infers the row taxonomy from the sheet and maps agent activity onto
|
||
idle/run/review/failed/wave/jump.
|
||
|
||
This package is the **single source of truth** for the feature so the base
|
||
CLI (Python) and TUI (Ink, via ``tui_gateway``) never duplicate the hard
|
||
parts:
|
||
|
||
- :mod:`agent.pet.constants` — frame geometry + the :class:`PetState` enum.
|
||
- :mod:`agent.pet.state` — map agent activity → a :class:`PetState`.
|
||
- :mod:`agent.pet.manifest` — fetch the public petdex manifest.
|
||
- :mod:`agent.pet.store` — install / list / resolve pets on disk
|
||
(profile-aware via ``get_hermes_home()``).
|
||
- :mod:`agent.pet.render` — decode a spritesheet and encode frames for a
|
||
terminal (kitty / iTerm2 / sixel graphics
|
||
protocols, with a Unicode half-block
|
||
fallback).
|
||
|
||
Rendering in the Electron desktop is necessarily TypeScript (canvas), but it
|
||
reuses the same on-disk store and the same state semantics.
|
||
|
||
The whole feature is a *display* concern: it adds no model tool, mutates no
|
||
system prompt or toolset, and therefore has zero effect on prompt caching.
|
||
"""
|
||
|
||
from agent.pet.constants import (
|
||
DEFAULT_SCALE,
|
||
FRAME_H,
|
||
FRAME_W,
|
||
FRAMES_PER_STATE,
|
||
LOOP_MS,
|
||
STATE_ROWS,
|
||
PetState,
|
||
)
|
||
from agent.pet.state import derive_pet_state
|
||
|
||
__all__ = [
|
||
"DEFAULT_SCALE",
|
||
"FRAME_H",
|
||
"FRAME_W",
|
||
"FRAMES_PER_STATE",
|
||
"LOOP_MS",
|
||
"STATE_ROWS",
|
||
"PetState",
|
||
"derive_pet_state",
|
||
]
|