MingaEditor.State.AgentAccess (Minga v0.1.0)

Direct accessors for agent state on EditorState.

Agent-related state is split across three locations:

state.shell_state.agent (MingaEditor.State.Agent) — rendering cache for the user's current view. Holds runtime (status), error, pending_approval, spinner_timer, and buffer. Repopulated on every tab/card switch from the active session's MingaAgent.Session.editor_snapshot/1. Not the source of truth for the session pid.
The active session pid lives on Tab.session (Traditional shell) or Card.session (Board shell). session/1 reads it through Shell.active_session/1.
state.workspace.agent_ui (Agent.UIState) — full UI state wrapping Panel and View. Per-tab.
- state.workspace.agent_ui.panel (UIState.Panel) — prompt editing and chat display.
- state.workspace.agent_ui.view (UIState.View) — layout, search, preview, toasts.

This module provides read/write functions so callers don't need to know the field layout.

Summary

Functions

agent(arg1)

Returns the agent session lifecycle state.

agent_ui(arg1)

Returns the full agent UI state (wrapping Panel and View).

focus(state)

Returns the agent UI focus.

input_focused?(state)

Returns true if the agent panel input is focused.

panel(arg1)

Returns the agent panel state (prompt editing and chat display).

session(arg1)

Returns the agent session pid for the user's current view, or nil.

update_agent(state, fun)

Updates agent session lifecycle state via a transform function.

update_agent_ui(state, fun) deprecated

Updates the full agent UI state. Prefer update_panel/2 or update_view/2.

update_panel(state, fun)

Updates just the panel sub-struct via a transform function.

update_view(state, fun)

Updates just the view sub-struct via a transform function.

view(arg1)

Returns the agent view state (layout, search, preview, toasts).

Functions

agent(arg1)

@spec agent(MingaEditor.State.t() | map()) :: MingaEditor.State.Agent.t()

Returns the agent session lifecycle state.

agent_ui(arg1)

@spec agent_ui(MingaEditor.State.t() | map()) :: MingaEditor.Agent.UIState.t()

Returns the full agent UI state (wrapping Panel and View).

focus(state)

@spec focus(MingaEditor.State.t() | map()) :: atom()

Returns the agent UI focus.

input_focused?(state)

@spec input_focused?(MingaEditor.State.t() | map()) :: boolean()

Returns true if the agent panel input is focused.

panel(arg1)

@spec panel(MingaEditor.State.t() | map()) :: MingaEditor.Agent.UIState.Panel.t()

Returns the agent panel state (prompt editing and chat display).

session(arg1)

@spec session(MingaEditor.State.t() | map()) :: pid() | nil

Returns the agent session pid for the user's current view, or nil.

Reads through the shell behaviour: Traditional returns the active tab's session, Board returns the zoomed card's session. The session pid is owned by the tab/card; state.shell_state.agent only caches the rendering fields (status, error, pending_approval) for that session.

update_agent(state, fun)

@spec update_agent(MingaEditor.State.t() | map(), (MingaEditor.State.Agent.t() ->
                                               MingaEditor.State.Agent.t())) ::
  MingaEditor.State.t() | map()

Updates agent session lifecycle state via a transform function.

update_agent_ui(state, fun)

This function is deprecated. Use update_panel/2 or update_view/2 for targeted sub-struct updates.

@spec update_agent_ui(MingaEditor.State.t() | map(), (MingaEditor.Agent.UIState.t() ->
                                                  MingaEditor.Agent.UIState.t())) ::
  MingaEditor.State.t() | map()

Updates the full agent UI state. Prefer update_panel/2 or update_view/2.

update_panel(state, fun)

@spec update_panel(
  MingaEditor.State.t() | map(),
  (MingaEditor.Agent.UIState.Panel.t() ->
     MingaEditor.Agent.UIState.Panel.t())
) ::
  MingaEditor.State.t() | map()

Updates just the panel sub-struct via a transform function.

update_view(state, fun)

@spec update_view(
  MingaEditor.State.t() | map(),
  (MingaEditor.Agent.UIState.View.t() ->
     MingaEditor.Agent.UIState.View.t())
) ::
  MingaEditor.State.t() | map()

Updates just the view sub-struct via a transform function.

view(arg1)

@spec view(MingaEditor.State.t() | map()) :: MingaEditor.Agent.UIState.View.t()

Returns the agent view state (layout, search, preview, toasts).