feat: add BoxBrain persona runtime APIs

README.md

@@ -1,22 +1,28 @@
 # BoxBrain
 
-BoxBrain is an IdentityDB-backed TypeScript framework for creating synthetic personas that can behave like human-like DM contacts.
+BoxBrain is an IdentityDB-backed TypeScript framework for creating synthetic personas that behave like human-like DM contacts.
 
-The project is framework-first rather than product-first. The current foundation provides:
+The project is framework-first rather than product-first. The current core library provides:
 
-- provider-agnostic text, structured-output, and image adapter contracts
+- provider-agnostic text, structured-output, image, conversation-memory, and special-date adapter contracts
 - one IdentityDB memory space per persona
 - persona initialization from personality, history, values, preferences, and relationships
 - LLM-generated biography ingestion into IdentityDB fact drafts
 - optional profile image generation through an image adapter
-- human-like typing and first-reply delay utilities
+- schedule generation for day/week/month scopes with optional external special-date context
+- schedule persistence, listing, and pruning APIs
+- availability state persistence with schedule/manual/tool overrides
+- availability snapshots with current + next transition calculation
+- DM-style conversation orchestration for inbound replies and proactive openings
+- delegated mandatory/contextual memory retrieval pipelines for conversation turns
+- human-like first-reply delay and typing delay utilities
+- farewell-style refusal flows that can trigger availability-changing tool calls
 
-Planned next APIs include:
+Still planned:
 
-- schedule generation and availability state persistence
-- inbound DM-style conversation turns with mandatory/contextual memory retrieval
-- proactive outbound messages without user input
 - HTTP/RPC wrappers around the core library APIs
+- ready-made provider adapter packages for specific AI vendors
+- production-focused persistence/runtime integrations beyond the in-process core library
 
 ## Development
 
@@ -29,6 +35,6 @@ bun run build
 
 ## Current status
 
-The repository is in foundation development. See the implementation plan:
+The repository now contains the framework core for persona initialization, schedule/status management, and conversation orchestration. See the implementation plan:
 
 - `docs/plans/2026-05-11-boxbrain-foundation.md`