Struct AgentInstance 

pub struct AgentInstance {

    pub id: String,
    pub definition_id: String,
    pub parent_instance_id: String,
    pub block_id: String,
    pub session_id: String,
    pub status: String,
    pub github_context: String,
    pub started_at: i64,
    pub ended_at: i64,
    pub created_at: i64,
    pub identity_id: String,
    pub memory_id: String,
    pub instance_name: String,
    pub working_directory: String,
    pub display_hidden: bool,
}

One row per running/historical execution of an agent definition. block_id / session_id / github_context are modelled as empty strings on the wire rather than Option<String> to match the existing schema conventions (NOT NULL DEFAULT ''). Callers that need structured absence can use .is_empty().

Fields

id: String

definition_id: String

parent_instance_id: String

block_id: String

session_id: String

status: String

github_context: String

JSON-encoded GitHubContext, or empty string.

started_at: i64

ended_at: i64

created_at: i64

identity_id: String

FK to db_identity_bundles.id. Empty string means “use the blank singleton” (= ambient creds, no env-var injection). Set at instantiation via the launch modal’s Identity dropdown.

memory_id: String

FK to db_memory_bundles.id. Empty string means “use the blank singleton” (= vanilla CLI, no instructions). Set at instantiation via the launch modal’s Memory dropdown.

instance_name: String

User-chosen instance name (becomes AGENTMUX_AGENT_ID in the spawn env). Empty for pre-v8 rows and for un-named launches. Drives the “Continue agent” dropdown in the launch modal.

working_directory: String

Absolute path returned by allocate_agent_workdir at spawn. Stored explicitly (rather than re-derived from the slug at continue-time) so the continue flow is robust against slug-rule changes and user-side renames.

display_hidden: bool

Soft-delete flag for the “Forget agent” affordance. Hidden rows stay on disk for audit + recovery.

Trait Implementations

impl Clone for AgentInstance

fn clone(&self) -> AgentInstance

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AgentInstance

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for AgentInstance

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for AgentInstance

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.