The ledger

Process-wide `LazyLock<HashMap<&'static str, &'static BuiltinTool>>` built exactly once so hot-path dispatchers skip HashMap reconstruction on every tool call.

Phase 8II-2 — image generation crate. ImageGenerator trait + CodexHostedGenerator impl (Codex Responses API hosted image_generation tool) + ImageStore re-send-by-prompt cache. OOP-shaped, provider-agnostic, behind OPENALICE_IMAGE_GEN env flag (default OFF in prod).

Phase 8BB-1 — Prometheus counter `oa_agent_spawn_total{depth,outcome}`. Bumped once per `handle_agent_spawn` invocation in the api-router process: alice-cli's canonical counter lives in the child subprocess where /metrics can never see it. Labels: outcome ∈ {success, fail}, depth = `?` (parent never knows the runtime spawn depth — alice-cli surfaces it in its own counter once both processes share a /metrics aggregator).

Phase 8WW — inbound-triggered avatar auto-fetch into refs. Provides slug derivation (`tg-{user_id}` / `dc-{user_id}` / …), `avatar.meta` sidecar IO with 24h staleness + sha256 dedup, `apply_avatar_to_refs` that creates the bundle / archives the old file when content changed, and a smart-usage gate so participant refs only surface when the prompt explicitly mentions them.

Phase 8VVV — fix for the 8WW pipeline bug where `apply_avatar_to_refs` round-tripped through `add_image` with a `.avatar.jpg.staging` source path, leaking the staging name into `metadata.yaml` as `file: .avatar.jpg.staging`. The staging file got cleaned up while metadata pointed at a non-existent path. Fix: splice the image entry directly with the canonical filename (`avatar.jpg`), no staging dance.

Phase 8SS — refs registry. Canonical FS-backed store for Alice's reference images (self / people / places / objects) at `~/.openalice/data/{agent}/refs/`. Foundation for image_gen multi-photo scenarios — image_gen resolves names like 'me' / 'Katya' / 'person/nao' to concrete files via `resolve_ref`.

Phase 8SS — `resolve_ref(store, name)` smart resolver. Maps 'me' / 'self' / 'myself' / 'я' / 'Алиса' / 'alice' to the self bundle; bare names like 'Katya' to `person/katya`; slug-shaped inputs (`person/nao`, `place/voronezh`) to their bundles.

Phase 8VVV — SOTA multi-key resolver. Three new match arms: (1) prefix-strip (`person/nao` retries as bare `nao`), (2) user-defined `aliases:` list in metadata.yaml (case-insensitive equality, e.g. `bassel` → `person/tg-...`), (3) display-name extracted from the 8WW auto-fetch description pattern `Auto-fetched from <connector> (<NAME>, user_id=...)`. Fixes the live NAO finding where `image_gen{refs: ["person/nao"]}` returned None despite the bundle existing under `person/tg-670376626`.

Phase 8SS — `RefsStore` handle. `new` / `for_agent` ctor, `list_all` / `list_kind` / `get` reads, `create` / `add_image` / `remove` writes. Metadata.yaml is the source of truth; image files are referenced by bundle-relative name.

Phase 8VVV — `RefsStore::add_alias` / `RefsStore::remove_alias` mutate the `aliases:` list on a bundle's metadata.yaml. Aliases are case-insensitive lookup keys consumed by `resolve_ref` so a single bundle can answer to multiple names without renaming the canonical slug.

workspace_glob promoted to preloaded + essential so Alice can find files by name without spending tool-discovery tokens first.

workspace_grep promoted to preloaded + essential so Alice can grep large attachments before reading them — pairs with workspace_stat and workspace_read_range as the large-file SOTA toolkit.

Returns markdown/code outline + optional regex matches for a workspace file in one call. Lets Alice navigate a 500K-line attachment by TOC instead of dumping it. Pairs with workspace_read_range for selective deep-dive after the outline scan. Closes the 2026-04-27 large-file gap (572 KB book = 80K tokens per turn).

A2A send/check/channel_info + collab (group/broadcast/subscribe/channels).

Agent create/discover/send — scheduler-backed.

Appstore search/install/info/list_installed.

Calendar CRUD + today/upcoming/search/conflicts/export.

Canvas create + add_node — per-chat scoped.

Git status/diff/log/show/add/commit/push with agent-scoped dispatch.

Group form + invite.

Hybrid room create/add/list (humans + agents in one thread).

Knowledge graph + RAG (kg_add_entity/search/traverse, rag_search/ingest).

LSP hover/definitions/references/document_symbols/diagnostics.

Leaflet maps — create, search, list, delete, screenshot.

Memory read/write/list/delete/search/decay + chat_history_search + tool_search.

Microagent spawn/list_templates + trajectory replay/list.

Mission create/status/list/stop + consolidation_run.

Image + audio generation, send_selfie, minimax_usage.

Goal set, plan+decompose, replan, project_rename, reflect.

Rank status/leaderboard/audit.