Module mps_events

Expand description

Broker events with a typed payload (docs/specs/SPEC_TYPED_EVENT_PAYLOADS_2026_10_13.md).

Each event is a marker type naming its wire name and its payload type, declared once in the events! list below. That list is also the schema: schema() (exported to frontend/types/rpc/event-schema.json) feeds the generated MuxEventPayloads map, so the frontend’s onMuxEvent(WpsEvent.X, (data) => …) gets data as the Rust type. Publish one with Broker::publish_event. An event not listed here is still published as a plain MuxEvent with untyped data.

An event sent under a name per id (agent:memory:changed:<agent id>) is a PerIdEvent, declared in the per_id_events! list by the name before the id, and published with Broker::publish_event_for.

Macros§

client_events 🔒
events 🔒
per_id_events 🔒

Structs§

AgentContentChanged: An agent’s stored content changed (setagentcontent).
AgentContextUsageChanged: Where an agent’s CLI auto-compacts.
AgentCredentialsRevoked: An agent’s provider login was unlinked (agentcredentials:revoked:<agent id>).
AgentEventStream: An agent pane’s output, translated (agent_event:<block id>).
AgentFailed: An agent failed, classified (agents::failure).
AgentHistoryChanged: An entry was appended to an agent’s history.
AgentIdentitiesChanged: An agent’s identity links changed (agentidentities:changed:<agent id>).
AgentInstancesChanged: A definition’s instances changed (agentinstances:changed:<definition id>).
AgentMemoryChanged: An agent’s native memory files changed (agent:memory:changed:<agent id>).
AgentMessageAccepted: A queued message reached the agent.
AgentProcessAdded: A process joined an agent pane’s tree, or left it (process_tracker::registry).
AgentProcessExited
AgentProgress: An agent’s checklist and current tool (reactive::progress_watcher).
AgentProgressEvent: agent:progress: an agent’s checklist and the tool it is running.
AgentReactiveRegistered: A reactive agent pane registered, or went (the Swarm refreshes).
AgentReactiveUnregistered
AgentResumeRetry: A stale --resume is being retried, or the retry resolved.
AgentRuntime: What an agent process runs with, and whether a restart is pending.
AgentShutdown: One line of a closing agent pane’s shutdown log (sagas::close_pane::publish_shutdown).
AgentShutdownPending: A shutdown waiting for the user to keep the agent, and its end (sagas::pending_shutdown).
AgentShutdownPendingCleared
AgentSkillsChanged: The skills installed for an agent changed.
AgentTurn: An agent’s turn ledger changed (blockcontroller::health::ledger_publisher).
AgentsChanged: The agents list changed.
AmbientNarration: A line of narration for an agent pane (continued_note, the narrate route).
AmbientNarrationEvent: ambient-narration: a line to show in an agent pane.
AmbientSpent: What one ambient model call spent (ambient::spend).
AppServerOutput: One protocol frame from an app-server agent (app_server_controller).
AttachmentBatchDone
AttachmentFailed
AttachmentProgress: An attachment batch’s progress, per item (backend::attachments).
AttachmentReady
BackgroundTaskUpdated: A pane’s background tasks changed; the dashboard reads the list again.
BlockActivity: An agent pane’s activity, from its terminal title (mps::publish_block_activity).
BlockActivityEvent: block:activity: what an agent pane is doing, from its terminal title.
BlockFile: A block file changed: terminal output, an agent transcript append (blockcontroller).
BlockRefEvent: An event about one pane: background-task-updated, mcp:observed, agent:reactive-(un)registered.
BlockReveal: Tell a window’s renderer to reveal a block (notify::router).
BlockStats: One pane’s process-tree stats sample (sysinfo).
BtwAnswerChunk: One streamed piece of a side question’s answer (agent_handlers::side_question).
BtwAnswerChunkEvent: btw_answer_chunk: one event of a side question’s answer. done (not event.type) says the answer is complete.
CompactionStarted: Claude Code began compacting (agentmux-bashwrap precompact).
Config: The full config, redacted for the renderer: on connect, and when it changes.
ConfigEvent: config: the full config, redacted for the renderer.
ConnChange: A connection’s status changed (backend::remote::status).
ControllerStatus: A block controller’s runtime status (publish_controller_status).
CredentialsRevokedEvent: agentcredentials:revoked:<agent id>: the agent still holds the provider’s tokens until it restarts.
CronChanged: Scheduled jobs changed.
DispatchActivity: A workflow dispatch’s coalesced new events.
DispatchUpdated
DockClear: muxspect dock clear removed a node from a pane’s dock.
DockClearEvent: dock:clear: the dock node to remove.
DroneRun: One step of a drone run (dronerun:<run id>).
DronesChanged: The drones changed.
EditorFileChanged: A file an editor pane shows changed on disk.
FilesChanged: A folder a Files pane lists changed.
FilesChangedEvent: files:changed: the folder that changed, as the Files pane shows it.
FilesOp: A copy/move/delete job’s progress (fs_ops::jobs).
IdentityAccountsChanged: The provider accounts changed.
IdentityNoDirectLinks: An agent instance’s identity has no direct links (identity::resolver::inject); a diagnostic.
InstallChunk: One line of an install’s output, or its end (install.start, system.install).
InstallProgress: A line of an agent CLI’s install progress, for its pane (mps::publish_install_progress).
InstallProgressEvent: install_progress: one line of install progress.
LanInstances: The LAN peers this instance sees (lan_discovery).
LanInstancesError: LAN discovery couldn’t start, or a daemon rebuild failed.
LanInstancesFirewall: The OS firewall’s verdict on LAN peers reaching this machine (lan_firewall).
LanInstancesHealth: Whether this instance is discoverable on every LAN interface (the mDNS watchdog).
LspMessage: One message from a language server (lsp::supervisor).
LspMessageEvent: lsp:message: one JSON-RPC message from a language server, as it sent it.
McpChanged: The MCP servers changed.
McpObserved: A pane’s reported MCP servers changed (mcp_observed).
MediaFileChanged: A file a media pane shows changed on disk.
MemoriesChanged: Memory entries changed.
MuxObjBatchedUpdates: Several object updates from one atomic transition, applied in one flush (EventBus::broadcast_mux_obj_updates).
MuxObjUpdated: A wave object changed (wcore::event).
MuxbusStatus: Cloud delivery’s state changed (muxbus::delivery_status).
NamedAgentsChanged: A named agent was hidden.
NoDirectLinksEvent: identity:no-direct-links: the instance and the identity that has no direct links.
Notification: An OS notification to show, retract or act on (notify::router).
NotificationActivate
NotificationRetract
NotificationState: What the notification tray shows (notify::router).
OpenFloatingPane: Ask one window to open a pane as its own floating OS window (app_api::pane).
OpenFloatingPaneEvent: openfloatingpane: the pane to float, now alone in its own workspace.
PathChangedEvent: editor:file_changed / media:file_changed: the file that changed.
ProcessAddedEvent: agent:process-added: a process joined an agent pane’s tree.
ProcessExitedEvent: agent:process-exited: a process left an agent pane’s tree.
ProcessStatusChanged: A pane’s process status changed (broker::process).
ProtocolFrame: output: one app-server protocol frame, as the agent sent it.
RemotesChanged: The configured remotes changed.
ResumeRetryEvent: The agent-resume-retry event’s payload (mps_events::AgentResumeRetry).
ShellChunk: One line a Shell command wrote, or its exit (backend::shell_node).
ShellNodeCreate: A Shell command started (server::http_shell).
SingletonClaim: A window claimed or released a singleton modal (frontend/app/store/singleton-modal.ts).
SingletonClaimEvent: singleton:claim, to singleton:<kind> with persist: 1: the latest one names the window holding that kind of singleton modal.
SkillsChanged: The skill library changed.
SrvInfo: srv’s version and machine, sent once on every WebSocket connect.
SubagentAbandoned
SubagentActivity: New events from one subagent (subagent_watcher).
SubagentBackfillStatus: A resumed pane’s subagent backfill started or finished.
SubagentBlockPruned
SubagentCompleted
SubagentNamed
SubagentSpawned
SubagentUpdated
SysInfo: One sysinfo sample for a connection (sysinfo::run_sysinfo_loop).
ToolChunk: A line of a Bash call’s output, its exit, its pid or which call it is (agentmux-bashwrap).
TrackedBlocksChanged: The process broker’s set of tracked blocks changed.
UserAttention: A call to action srv holds open started, or ended (backend::user_attention).
ViewerPaired: A mobile viewer paired with this machine (http_viewer).
ViewerPairedEvent: viewer:paired: the device that just paired.
WidgetPackages: The installed widget packages.
WidgetPackagesEvent: widgetpackages: every installed widget package.
WidgetRequests: The agents’ widget install requests waiting for the user.
WidgetRequestsEvent: widgetrequests: the install requests waiting for the user.
WidgetStorage: A widget package’s storage changed: which keys, never their values.
WidgetStorageEvent: widgetstorage: the keys of a widget package’s storage that changed.
WorkQueueChanged: The work queue changed.

Traits§

Event: A broker event with a typed payload.
PerIdEvent: A broker event sent under a name per id: its prefix, then the id.

Functions§

is_client_event: Whether name is one of the client events.
is_per_id_event: Whether name is a per-id event’s name: one of the prefixes above, then an id.
is_srv_event: Whether only srv publishes name: a declared event, or a per-id one, that isn’t a client event. Its subscribers read it as its payload type, so the relay doesn’t take it from outside.
is_typed_event: Whether name is one of the events above (not a per-id one: is_per_id_event).
payload_data: An event’s data: its payload as JSON, or none for an event that carries none ((), a pure “something changed” signal), so such an event goes out with no data field at all.
publish_client_event: Publishes an event a process outside srv sent (POST /agentmux/wps/publish) if it is a client event: None if name isn’t one, an error if data isn’t its payload type.