Struct ViewerSession 

pub struct ViewerSession {

    pub subagents: SubagentPolicy,
    pub at: Option<String>,
    pub branch: Option<String>,
    pub base: Option<String>,
    pub targeted_turn_control_supported: bool,
    pub native_subagents: Vec<NativeAgent>,
    pub steering: Option<SteeringOperation>,
    pub active_prompt_id: Option<String>,
    pub cancelling_prompt_id: Option<String>,
    pub capacity_retry: Option<CapacityRetry>,
    pub retry_assessment_pending: bool,
    pub quota_recovery: Option<QuotaRecovery>,
    pub id: String,
    pub publication_state: Option<PublicationState>,
    pub managed_checkout_kind: Option<ManagedCheckoutKind>,
    pub workspace_id: String,
    pub title: String,
    pub subagent_parent_id: Option<String>,
    pub subagent_task_name: Option<String>,
    pub subagent_session_ids: Vec<String>,
    pub harness_kind: String,
    pub profile_id: String,
    pub bundle_id: String,
    pub target_id: String,
    pub state: String,
    pub created_at: String,
    pub updated_at: String,
    pub has_error: bool,
    pub has_checkpoint: bool,
    pub configuration_issue: Option<String>,
    pub launch_error: Option<String>,
    pub preview: Vec<String>,
    pub queued_prompts: Vec<ViewerQueuedPrompt>,
    pub active_user_shells: Vec<ViewerUserShell>,
    pub background_tasks: Vec<ViewerBackgroundTask>,
    pub pending_elicitations: Vec<ElicitationRequest>,
    pub conversation_available: bool,
    pub prompt_images_supported: bool,
    pub incompatible_resume_targets: Vec<String>,
    pub resume_refusals: BTreeMap<String, String>,
    pub compatible_resume_targets: Vec<String>,
    pub project_label: String,
    pub project_key: String,
    pub display_location: String,
    pub container_cpus: Option<String>,
    pub container_memory: Option<String>,
    pub additional_mounts: Vec<AdditionalMount>,
    pub lifecycle: ViewerLifecycleCategory,
    pub transitioning: bool,
    pub latest_event_ordinal: u64,
    pub last_activity_at_ms: Option<i64>,
    pub last_message_at_ms: Option<i64>,
    pub activity_details: Option<ViewerActivityDetails>,
    pub operation: Option<ViewerOperation>,
    pub move_recovery: Option<ViewerMoveRecovery>,
    pub chat_phase: ViewerChatPhase,
    pub is_idle: bool,
    pub activity_state: Option<ActivityState>,
    pub activity: String,
    pub config_options: Vec<ViewerConfigOption>,
    pub plan_mode_active: Option<bool>,
    pub turn_review: Option<ViewerTurnReview>,
    pub available_commands: Vec<ViewerMjCommand>,
    pub capabilities: ViewerSessionCapabilities,
}

Fields

subagents: SubagentPolicy

at: Option<String>

Commit the workspace started checked out at, when one was named.

branch: Option<String>

Branch created at at, or the existing branch checked out without it.

base: Option<String>

Diff base the session was started with; at unless another was named.

targeted_turn_control_supported: bool

native_subagents: Vec<NativeAgent>

steering: Option<SteeringOperation>

active_prompt_id: Option<String>

cancelling_prompt_id: Option<String>

capacity_retry: Option<CapacityRetry>

retry_assessment_pending: bool

quota_recovery: Option<QuotaRecovery>

id: String

publication_state: Option<PublicationState>

managed_checkout_kind: Option<ManagedCheckoutKind>

workspace_id: String

title: String

subagent_parent_id: Option<String>

Parent ownership for a borrowed-target child session.

subagent_task_name: Option<String>

The stable task label chosen by the parent when it spawned this child.

subagent_session_ids: Vec<String>

Direct children of this parent. Children are deliberately never nested.

harness_kind: String

profile_id: String

bundle_id: String

target_id: String

state: String

created_at: String

updated_at: String

has_error: bool

has_checkpoint: bool

Whether the session has a checkpoint to resume from. A resume restores a checkpoint and nothing else, so a session without one, such as a launch that failed before its first, cannot be resumed (launch finding R6-1). Only the fact travels; the archive’s path stays on the controller.

configuration_issue: Option<String>

Public identifiers and repair guidance only; never raw runtime errors.

launch_error: Option<String>

Why a launch failed, for a session that ended in the error state. This is the same provisioning error text last_error already publishes through mj events, surfaced here so mj sessions/mj wait can show the reason instead of a bare “failed to launch”.

preview: Vec<String>

queued_prompts: Vec<ViewerQueuedPrompt>

active_user_shells: Vec<ViewerUserShell>

background_tasks: Vec<ViewerBackgroundTask>

pending_elicitations: Vec<ElicitationRequest>

Form questions the session is blocked on, published so a phone can answer them. These are the agent’s own questions, already visible in the transcript, so they travel whole rather than redacted.

conversation_available: bool

prompt_images_supported: bool

Whether this session’s agent advertised support for image content in prompts. The viewer offers the image controls only when it did, and the server refuses images for a session that did not.

incompatible_resume_targets: Vec<String>

Target ids this session cannot resume on. Only the ids travel: the controller’s reasons name project paths and SSH hosts, which this projection deliberately keeps on the controller.

Retained beside compatible_resume_targets so a viewer cached from before that field existed keeps working through a deployment.

resume_refusals: BTreeMap<String, String>

The controller’s reason for each id in incompatible_resume_targets. It names project paths and SSH hosts, so it is never serialized: only in-process validation reads it, to tell the caller why a resume or move was refused.

compatible_resume_targets: Vec<String>

Target ids this session can resume on, so the browser never has to subtract one set from another to find out.

project_label: String

The canonical short source label for this session: a bundle name, path leaf, or repository name, never a source path itself.

project_key: String

A stable key for grouping sessions by project. The controller’s own source identity stays private, so what travels is a digest of it: enough to group by, and nothing to read.

display_location: String

The configured target’s human-facing project location. This is the same target projection the terminal uses while a session is running.

container_cpus: Option<String>

Per-session container CPU limit overriding the target template’s. It is applied the next time the session’s container is created.

container_memory: Option<String>

Per-session container memory limit overriding the target template’s. It is applied the next time the session’s container is created.

additional_mounts: Vec<AdditionalMount>

Extra directories attached to this session’s container, in the same persisted shape the terminal’s container dialog edits.

lifecycle: ViewerLifecycleCategory

transitioning: bool

A lifecycle transition temporarily owns this session’s conversation. This remains separate from the coarse lifecycle category so Move can hide the old transcript while its durable record is still Running.

latest_event_ordinal: u64

How far the controller’s projection of this session has advanced. A phone compares it against its own read frontier to know what is unread, without fetching a transcript to find out.

last_activity_at_ms: Option<i64>

Durable relay receipt watermark from the materialized projection. It remains absent when the background snapshot pipeline has not yet delivered a projection for this session.

last_message_at_ms: Option<i64>

When the newest top-level user or agent message in the browser transcript was recorded, in epoch milliseconds. Tool calls and status lines do not move it. Absent when the transcript holds no such message with a recording time.

activity_details: Option<ViewerActivityDetails>

Structured live activity, absent when no operational relay snapshot is available for this session.

operation: Option<ViewerOperation>

move_recovery: Option<ViewerMoveRecovery>

Safe recovery choices for a failed or cancelled Move. Diagnostics and checkpoint paths remain on the controller; this contains only the settings a person may choose again.

chat_phase: ViewerChatPhase

is_idle: bool

Known live activity is idle: no foreground turn, tool, or background work. Missing operational state must not be presented as confirmed idle.

activity_state: Option<ActivityState>

What this session is doing, in the shared vocabulary every part of Mjolnir now uses. Richer than chat_phase, which has only four values and must keep them: this can also say that the daemon cannot see the worker and report what was last known about it.

activity: String

What this session is doing, in the words the dashboard row uses: Turn 43m36s Step 12s, BG 43m36s, or [idle].

config_options: Vec<ViewerConfigOption>

The settings the harness advertised, with the values it accepts.

plan_mode_active: Option<bool>

Whether plan mode is on, or None when this harness has no plan mode.

turn_review: Option<ViewerTurnReview>

The review the daemon is running for this session, if any. A phone renders the same review the terminal does and resolves it the same way.

available_commands: Vec<ViewerMjCommand>

The Mjolnir commands this session accepts, published rather than hardcoded in the browser: a command list kept in two places is a command list that drifts, which is how /review went missing from the phone.

capabilities: ViewerSessionCapabilities

Implementations

impl ViewerSession

pub fn set_project_source(&mut self, source: &ProjectSourceIdentity)

Apply a resolved controller source while keeping paths and remotes out of the public projection.

Trait Implementations

impl Clone for ViewerSession

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ViewerSession

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ViewerSession

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<&ViewerSession> for ApiSession

fn from(session: &ViewerSession) -> Self

Converts to this type from the input type.

impl FromIterator<ViewerSession> for ViewerSessions

fn from_iter<T: IntoIterator<Item = ViewerSession>>(rows: T) -> Self

Creates a value from an iterator.

impl PartialEq for ViewerSession

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ViewerSession

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ViewerSession