Dispatch a command into the srv reducer and return the emitted
events. Locks the reducer mutex briefly; the lock is released
before any I/O (caller is responsible for publishing the events
to the broadcast bus).
Per-agent_id debounce generation for zoom mirroring. Each term:zoom
change bumps the agent’s generation; the spawned trailing-write task only
commits if its captured generation is still current 300ms later, so a
Ctrl+Wheel burst collapses into a single durable write (+ one global
def-registry re-mirror). See SPEC_AGENT_ZOOM_PERSISTENCE §4.3.
Read-only snapshot of the window → workspace → tab → pane tree, for agent
introspection (GET /api/v1/layout). Pure wstore reads — no reducer, so
it’s hermetic and safe. Lookups use linear scans (a handful of objects).
Compensation helper: dispatch a command into the reducer and
apply its emitted events to wstore best-effort. Used when an
earlier sync apply partially wrote SQLite and we need to undo
the leaked rows. SQLite errors during compensation are logged
but ignored — the caller is already returning an error to the
client; throwing on the cleanup just hides the original cause.
(codex P1 + reagent P2 #616 — partial-write cleanup.)
Phase E.4 (Option A) — reverse lookup: given a LayoutState.oid,
find the Tab.oid that owns it (i.e., the tab whose layoutstate
field matches). Returns None when the layout is unowned (legacy
or partially-migrated row) or the wstore read fails — caller treats
either as “skip the reducer dispatch and fall through to the wcore
write.” Linear scan over all tabs; acceptable here because the
layout-update path is low-frequency relative to drag-resize and
the reducer mutex itself is held for sub-millisecond intervals.
Phase E.5.5 — append a layout-delete action to the source tab’s
LayoutState.pendingbackendactions so the source window’s
frontend tears the moved block out of its layout tree on next
poll. Mirrors the action-queueing portion of
wcore::tear_off_block. Layout migration is E.4.
Floating-pane re-dock — enqueue an “insert” action on the TARGET
tab’s LayoutState.pendingbackendactions so the target window’s
frontend adds a new leaf for the redocked block through its
LayoutTreeActionType.InsertNode reducer pathway.
Dispatch a service call and broadcast any resulting WaveObjUpdates to the
event bus — the shared core of handle_service. Factored out so the typed
first-class agent-API verbs (e.g. /api/v1/window/name) get byte-identical
persistence + broadcast to a raw /agentmux/service call without
re-implementing it. See SPEC_AGENT_API_FIRST_CLASS_SURFACE_2026_06_17.md.
Debounced trailing mirror of an agent block’s term:zoom into the per-agent
ui:zoom content blob. zoom = Some(z) upserts; zoom = None (term:zoom
reset to null / 1.0) deletes the row so a default agent persists nothing.
Phase E.5.5 — set up the layout tree for a tab that just received
its first block via the TearOffBlock saga. Called from the
TearOffBlock RPC handler after the saga’s reducer-state portion
(CreateTab + MoveBlock) completes. Mirrors the layout-rootnode
Update a wave object by replacing it wholesale in the store.
The incoming value must have otype and oid fields.
Matches Go’s ObjectService.UpdateObject behavior.
Returns (otype, oid, updated_value_with_new_version) on success.
Existence check used by DeleteWorkspace to decide whether to
run the wcore delete path. Propagates StoreError so the caller
can surface real I/O / corruption failures instead of
misclassifying them as “not found” (codex P2 #615 carryover —
the prior bool return collapsed Err(_) into false, which
led to silent successes when SQLite was unhealthy: reducer would
delete its own copy and report success while the disk row was
never touched).