yoi/.yoi/tickets/00001KY1ZKCPC/thread.md

作成

LocalTicketBackend によって作成されました。

---

項目更新

Ticket item updated: title, body.

---

項目更新

Ticket item updated: title, body.

---

Plan

Implementation started.

Plan for this pass:

• Inspect local Worker protocol transport and current Backend/frontend HTTP operation mappings.
• Add a Backend/runtime protocol command transport that accepts existing protocol::Method payloads rather than per-operation HTTP endpoints.
• Route TUI Backend Runtime client through that protocol transport for run/notify/completion/cancel/pause/resume/compact/rewind operations.
• Route browser Console operations through the same protocol transport and stop using HTTP operation endpoints as the normal path.
• Keep existing HTTP endpoints only as compatibility where needed, not as frontend/TUI authority.

---

Implementation report

Implementation update:

Implemented the first full protocol-transport pass for Backend/runtime Worker controls.

Backend/runtime:

• Added Runtime::send_protocol_method(...) in worker-runtime.
  • Method::ListCompletions returns direct Event::Completions for same-command-connection semantics.
  • Other methods are delivered unchanged to the execution backend.
• Added WorkerExecutionBackend::dispatch_method(...) and concrete support in WorkerRuntimeExecutionBackend.
  • This accepts existing protocol::Method values instead of translating through operation-specific HTTP request DTOs.
• Added runtime command WebSocket:
  • /v1/workers/{worker_id}/protocol/ws
  • accepts raw protocol::Method JSON frames
  • returns raw direct protocol::Event JSON frames where needed
• Added workspace-server command WebSocket:
  • /api/runtimes/{runtime_id}/workers/{worker_id}/protocol/ws
  • /api/w/{workspace_id}/runtimes/{runtime_id}/workers/{worker_id}/protocol/ws
• Added RuntimeRegistry::send_protocol_method(...) and embedded runtime forwarding.

TUI client:

• Reworked BackendRuntimeClient so send(&Method) no longer maps to HTTP /input, lifecycle, or unsupported diagnostics.
• It now opens a command WS to /protocol/ws and sends cloned raw protocol::Method values.
• Direct command response events are merged into the existing event queue alongside observation WS events.
• This removes the previous unsupported handling for pause/resume/compact/completions/rewind at the TUI client transport layer.

Browser Console:

• Added command WS connection to /protocol/ws while keeping /events/ws as observation stream.
• Removed normal operation use of HTTP POST /input and POST /completions from the Console page.
• Composer send now maps to protocol methods:
  • user input -> Method::Run with protocol Segment[]
  • system input -> Method::Notify { auto_run: true }
  • :compact -> Method::Compact
  • :rewind -> Method::ListRewindTargets
  • :peer -> Method::RegisterPeer
• Completion lookup now sends Method::ListCompletions over command WS and waits for direct Event::Completions.
• Added frontend controls for cancel / pause / resume / compact / rewind target request / rewind to target.

Compatibility note:

• Existing HTTP operation endpoints remain in backend/server as compatibility for now, but the TUI Backend client and browser Console normal path now use protocol transport.

Verification run under nix develop:

• cargo fmt -- --check
• cargo check -p worker-runtime -p yoi-workspace-server -p client -p tui
• cargo test -p client backend_runtime --lib
• cargo test -p yoi-workspace-server registry_worker_list_can_be_scoped_by_runtime_id --lib
• cargo test -p worker-runtime --features ws-server --lib worker_backend
• git diff --check

Frontend check note:

• web/workspace/package.json currently has no check script and local frontend dependencies are not installed in this worktree.
• Attempted temporary npm exec --package svelte-check --package typescript -- svelte-check, but the tool bootstrap failed before checking project code.
• The Svelte page was updated against the generated protocol types in web/workspace/src/lib/generated/protocol.ts, but a frontend-native check still needs to be run in an environment with the frontend deps installed.

---

Implementation report

Follow-up implementation after design clarification:

Changed the transport split so /events/ws no longer exists. /protocol/ws is now the single Worker protocol WebSocket for both directions:

• client -> runtime/backend: raw protocol::Method JSON frames
• runtime/backend -> client: raw protocol::Event JSON frames

Runtime changes:

• Removed /v1/workers/{worker_id}/events/ws route.
• Removed runtime-specific event WS envelope/diagnostic frame types.
• Extended /v1/workers/{worker_id}/protocol/ws to stream snapshot/backlog/live observation events as raw protocol::Event while also accepting method frames on the same socket.

Workspace Backend changes:

• Removed public /api/.../events/ws and /api/w/.../events/ws routes.
• Removed Backend client event WS envelope types.
• Workspace /protocol/ws now proxies/streams raw protocol events and forwards raw protocol methods on the same socket.
• Runtime observation source endpoint generation now targets runtime /protocol/ws instead of /events/ws.

Client/frontend changes:

• TUI BackendRuntimeClient no longer opens a separate observation socket. It uses only /protocol/ws for send and receive.
• Browser Console no longer opens both observation and command sockets. It uses one protocol socket for replay/live events, completions, rewind targets, and controls.
• Removed old frontend ClientWorkerEventWs* types.
• Updated frontend UI tests to assert protocol-only Console behavior and absence of operation HTTP paths.

Verification:

• nix develop -c cargo fmt -- --check
• nix develop -c cargo check -p worker-runtime -p yoi-workspace-server -p client -p tui
• nix develop -c cargo test -p client backend_runtime --lib
• nix develop -c cargo test -p worker-runtime --features ws-server --lib protocol_ws
• nix develop -c cargo test -p yoi-workspace-server protocol_ws --lib
• nix develop -c cargo test -p yoi-workspace-server proxy_maps_runtime_worker_not_found_http_404_to_protocol_error_event --lib
• deno test --allow-read web/workspace/src/lib/workspace/console/worker-console.ui.test.ts from web/workspace
• git diff --check

---

Implementation report

Bug fix after manual TUI send failure:

Observed symptom:

• TUI send over Backend protocol reported a does not support Worker protocol command transport style error.

Root cause:

• /events/ws had been removed and /protocol/ws unified, but workspace-server still handled inbound client protocol::Method by calling RuntimeRegistry::send_protocol_method(...).
• For remote runtime-backed workers, Backend must be only a protocol WS proxy. Calling the registry default method hits the unsupported path instead of tunneling the frame to the runtime's /protocol/ws.

Fix:

• Workspace-server now branches by observation/protocol source:
  • RemoteWs: proxy raw WebSocket frames bidirectionally between client /api/.../protocol/ws and runtime /v1/.../protocol/ws. Backend does not deserialize or interpret method frames in this path.
  • Embedded: use in-process runtime adapter for method dispatch while streaming embedded observation events.
• Added/updated test so sending Method::ListCompletions through the workspace-server protocol proxy returns Event::Completions from the runtime, proving method frames reach the runtime instead of the Backend unsupported fallback.

Verification:

• nix develop -c cargo fmt -- --check
• nix develop -c cargo check -p yoi-workspace-server -p client -p worker-runtime
• nix develop -c cargo test -p yoi-workspace-server proxies_worker_protocol_ws_as_raw_events --lib
• nix develop -c cargo test -p client backend_runtime --lib
• nix develop -c cargo test -p worker-runtime --features ws-server --lib protocol_ws
• nix develop -c cargo test -p yoi-workspace-server protocol_ws --lib
• deno test --allow-read web/workspace/src/lib/workspace/console/worker-console.ui.test.ts
• git diff --check

---