Shell 31: fluxer-status-api default avatars, control ops #823

Closed
opened 2026-11-17 23:03:02 +00:00 by charles · 0 comments
Owner

Task 31 of the Desktop shell plan (docs/superpowers/plans/2026-11-17-desktop-shell.md, section "### Task 31:"). The plan on the shell branch is the source of truth; this copy is for reading.

Closes: #734 Depends on: 15

Files:

  • Modify: crates/fluxer-status-api/src/{server.rs,ws.rs,payload.rs,lib.rs}, README · Test: crates/fluxer-status-api/tests/{avatars.rs,control.rs}

Interfaces:

  • Produces: GET /avatars/default/<index>.png?token=… (same token and origin rules, image/png, Cache-Control: max-age=86400, 404 for an unknown index; the images handed in by the caller as Arc<[Bytes]>, so the crate reads no files); hello gains "capabilities": ["control"] when StatusApiConfig::control is on (set_control(bool)); WebSocket ops set_mute, set_deaf ("value": bool), toggle_mute, toggle_deaf, disconnect forwarded as CompanionOp through a channel the runtime reads, at most 10 per second per client (more are dropped), ignored while control is off; StatusApi::bind_error() -> Option<io::ErrorKind> for the port warning; the stale comment of #734 item 4 removed.

  • Step 1: failing tests: default_avatar_served_with_token_only, web_origin_refused_for_avatars, hello_capabilities, ops_forwarded_when_enabled, ops_ignored_when_disabled, op_rate_limited, unknown_op_ignored, bind_error_reported.

  • Step 2–5: FAIL → implement → PASS → commit feat(status-api): default avatars and control ops.

Task 31 of the Desktop shell plan (`docs/superpowers/plans/2026-11-17-desktop-shell.md`, section "### Task 31:"). The plan on the `shell` branch is the source of truth; this copy is for reading. **Closes:** #734 **Depends on:** 15 **Files:** - Modify: `crates/fluxer-status-api/src/{server.rs,ws.rs,payload.rs,lib.rs}`, README · Test: `crates/fluxer-status-api/tests/{avatars.rs,control.rs}` **Interfaces:** - Produces: `GET /avatars/default/<index>.png?token=…` (same token and origin rules, `image/png`, `Cache-Control: max-age=86400`, 404 for an unknown index; the images handed in by the caller as `Arc<[Bytes]>`, so the crate reads no files); `hello` gains `"capabilities": ["control"]` when `StatusApiConfig::control` is on (`set_control(bool)`); WebSocket ops `set_mute`, `set_deaf` (`"value": bool`), `toggle_mute`, `toggle_deaf`, `disconnect` forwarded as `CompanionOp` through a channel the runtime reads, at most 10 per second per client (more are dropped), ignored while control is off; `StatusApi::bind_error() -> Option<io::ErrorKind>` for the port warning; the stale comment of #734 item 4 removed. - [ ] **Step 1: failing tests**: `default_avatar_served_with_token_only`, `web_origin_refused_for_avatars`, `hello_capabilities`, `ops_forwarded_when_enabled`, `ops_ignored_when_disabled`, `op_rate_limited`, `unknown_op_ignored`, `bind_error_reported`. - [ ] **Step 2–5:** FAIL → implement → PASS → commit `feat(status-api): default avatars and control ops`.
charles added this to the Desktop shell milestone 2026-11-17 23:03:02 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
charles/fluxer-native#823
No description provided.