Module server

Module server 

Source

ModulesΒ§

agent_handlers πŸ”’
app_api πŸ”’
App API β€” high-level commands for programmatic control of AgentMux.
cli_handlers πŸ”’
drone_handlers πŸ”’
WSH RPC handlers for the Drone pane (issue #753 Phase 1).
editor_handlers πŸ”’
files πŸ”’
identity_handlers πŸ”’
Pre-launch OAuth flow RPC handlers.
install_handlers
install.start / install.cancel RPC handlers.
lsp_handlers πŸ”’
messagebus πŸ”’
HTTP endpoint handlers for the local MessageBus.
muxbus_handlers πŸ”’
MuxBus cloud connectivity RPC handlers.
native_memory_handlers πŸ”’
Native memory RPCs β€” read/write the agent’s ~/.claude/projects/<sanitized>/memory/ folder that Claude Code uses for autonomous, cross-session fact storage.
reactive πŸ”’
service πŸ”’
shell_handlers πŸ”’
tool_handlers πŸ”’
HTTP/WebSocket RPC handlers for the tool store. Registers gettoolstatus and installtool commands with the WshRpcEngine.
voice πŸ”’
Voice speech-to-text endpoint β€” POST /api/v1/voice/transcribe.
wave_obj_bridge πŸ”’
WaveObjUpdate broadcast bridge.
websocket πŸ”’

StructsΒ§

AppState
ListTabsQuery πŸ”’
SelfQuery πŸ”’

FunctionsΒ§

auth_middleware πŸ”’
Auth middleware matching Go pkg/authkey/authkey.go:18-42.
build_router
Build the Axum router with all routes, auth middleware, and CORS.
clean_name πŸ”’
Trim a user-supplied name and clamp to max chars; None if empty.
finish_name_call πŸ”’
Run a naming service call and map the result to a JSON HTTP response.
handle_diag_sagas πŸ”’
Saga durability PR 2 β€” operator visibility into the durable saga log. Returns the most-recent 50 saga lifecycle rows + an in-flight count derived from unresolved_sagas.
handle_discovery πŸ”’
GET /agentmux/discovery β€” a unified, agent-facing view of what exists and what is reachable across the muxbus delivery tiers, so an agent can resolve a target before sending. Aggregates:
handle_lan_instances πŸ”’
handle_layout πŸ”’
GET /api/v1/layout β€” read-only window β†’ workspace β†’ tab β†’ pane tree.
handle_list_tabs πŸ”’
GET /api/v1/tabs β€” flat list of tabs, optionally scoped to a workspace (explicit workspace_id, or the caller’s own via block_id).
handle_list_windows πŸ”’
GET /api/v1/windows β€” flat list of windows.
handle_list_workspaces πŸ”’
GET /api/v1/workspaces β€” flat list of workspaces.
handle_pane_open πŸ”’
POST /api/v1/pane/open β€” open a pane (editor/term/browser/…).
handle_pane_title πŸ”’
POST /api/v1/pane/title β€” set a pane’s display title (frame:title). Targets the caller’s own pane (its block_id). Routes through object.UpdateObjectMeta.
handle_self πŸ”’
GET /api/v1/self?block_id=<id> β€” resolve the calling agent’s place in the object tree (block β†’ tab β†’ window β†’ workspace, with their names). The sidecar serves many agents, so the caller identifies itself by its block id (the MCP WhoAmI tool passes AGENTMUX_BLOCKID). Naming verbs reuse the same resolver to default their target to the agent’s own context.
handle_shell_create πŸ”’
POST /api/v1/shell/create β€” start a persistent background shell.
handle_shell_stop πŸ”’
POST /api/v1/shell/stop β€” stop a running persistent shell.
handle_tab_activate πŸ”’
POST /api/v1/tab/activate β€” make tab_id the active tab in its workspace. Routes through workspace.SetActiveTab.
handle_tab_name πŸ”’
POST /api/v1/tab/name β€” rename a tab. Defaults to the caller’s own tab (resolved from block_id). Routes through object.UpdateTabName.
handle_tab_new πŸ”’
POST /api/v1/tab/new β€” create (and activate) a new tab in the caller’s workspace (or an explicit workspace_id). Routes through workspace.CreateTab.
handle_window_focus πŸ”’
POST /api/v1/window/focus β€” bring a window to the foreground. Defaults to the caller’s own window. Routes through client.FocusWindow.
handle_window_name πŸ”’
POST /api/v1/window/name β€” set a window’s display name (window:displayname), which the frontend turns into the OS/taskbar title. Defaults to the caller’s own window (resolved from block_id). Routes through the same object.UpdateObjectMeta service path the InstancePanel rename uses, so persistence + live-title update are identical. agentmux-mcp’s SetWindowName tool POSTs here.
handle_workspace_name πŸ”’
POST /api/v1/workspace/name β€” rename a workspace. Defaults to the caller’s own workspace (resolved from block_id). Routes through workspace.UpdateWorkspace.
handle_wps_publish πŸ”’
Auth-gated WPS publish endpoint (SPEC_STREAMING_BASH_RUNNER_2026_05_11.md Β§3.2). agentmux-bashwrap POSTs here while running a Bash command; we forward to the in-process WPS broker so subscribed frontends receive the event.
health_handler πŸ”’
resolve_own πŸ”’
Resolve a target id from the caller’s own context (via block_id), using pick to select the field. Returns the route’s error response on failure (missing block_id, unresolvable block, or the field is None).
stub_501 πŸ”’