Module actor 

Actor presence reports and completion planning.

Owns:

• listing registry entries into a typed report with stable JSON field names
• pure active-only (and related) filters over ActorPresence slices
• assembling a single actor entry plus ancestry chain for presence JSON
• pure complete_actor_entry / plan_actor_done and thin mark_actor_done for presence complete

Human/JSON rendering and implicit session resolution (current-lane / path / any-active fallbacks) stay CLI-owned because they couple to recovery advice and checkout state. Thread-ref creation on mint also stays CLI-owned.

Structs

ActorChainEntry

One hop in an actor ancestry chain for machine JSON.

ActorDoneOptions

Caller inputs for actor done planning (identity already resolved).

ActorDonePlan

Pure plan describing the done transition for machine/human output.

ActorEntryReport

One actor registry entry as surfaced by list/show machine JSON.

ActorListReport

Machine JSON for heddle agent presence list domain fields (stable field names).

ActorShowReport

Machine JSON for a single actor-presence payload.

Functions

assemble_actor_entry

Assemble a single actor entry plus ancestry chain (pure relative to I/O).

complete_actor_entry

Pure status transition for actor done: mark complete with a timestamp.

filter_actors

Pure filter: when active_only, retain only ActorPresenceStatus::Active entries.

filter_actors_ref

Pure filter over a borrowed slice (for callers that already hold entries).

list_actors

List actors from the repository agent registry into a typed report.

list_actors_from_registry

List actors from an already-opened ActorPresenceStore.

mark_actor_done

Mark an actor complete in the registry (thin store mutation).

plan_actor_done

Build a done plan from a resolved registry entry (no I/O).

show_actor_by_session

Load and assemble one actor by explicit session id.

show_actor_from_entry

Assemble show payload from a resolved entry (after CLI implicit resolve).