Build specification
Actor Runtime#
State topology#
Each family Actor has:
- Canonical identity/state: public commitments, schedules, current location, durable relationships, current goals, and world-changing decisions.
- Private Actor state: private agenda, uncertainties, protected memories, tool grants, and plans.
- Per-Source relationship memory: claims that Source shared, interaction summaries, explicit boundaries, fulfilled/broken commitments, and the Actor’s revisable assessment. This is not a hidden score.
- Scene projection: portrait stand, message, artifact, instrument, age-glimpse, or absent trace. Projections are disposable; identity is not.
Bounded cycle#
Observe authorized events → interpret against explicit beliefs and uncertainties → select active goals → retrieve permitted memory → evaluate relationships/conflicts → generate candidate Actions → policy/risk rank → act, ask, wait, or decline → update state through a Command → communicate honest status.
Every cycle carries immutable Actor manifest/version, Organization/Project context, tool allowlist, read scopes, budget, deadline, and reason codes. An Actor cannot widen these. It may disagree, withhold a recommendation, or initiate a quest/message within its grant; it may not sign, vote, self-fund, change permissions, or bind a Source.
Decisions and messages#
Actors create typed Decision objects when a human choice is actually needed. The decision lives at a world object (table, lamp, route, instrument) and in a semantic queue. Messages are rate-limited by urgency, relationship, and Source preference. Default: one digest per return session and at most one interruptive message for safety, expiring opportunity explicitly followed by the Source, or a directly blocked collaborator.
Concurrency#
Pitch projections read a canonical snapshot. Session-local dialogue memory stays private. Proposed canonical changes merge only through version-checked Commands. A conflict returns state_changed and prompts the Actor to reassess; last-write-wins is forbidden for goals, relationships, or authority.