[BUG] Web UI session list stays empty when embedded in iframe, requires manual server/directory click to populate #36237

Description

Description

When the OpenCode web UI is embedded in an iframe (e.g., via the opencode-chat VS Code extension), the session list in the sidebar stays empty on initial load, even though:

• Sessions exist in the database (opencode.db)
• The /api/session endpoint returns sessions correctly
• The directory paths match exactly
• session_directory_filter_enabled is set to false in kv.json

The sessions only appear after manually clicking the server icon, then clicking the project directory from the "Recent projects" list. This forces a re-bootstrap of the directory context, which triggers session loading.

Root Cause (Analysis)

This appears to be the same race condition described in #27837: the server.connected SSE event fires before the frontend's M.children (registered workspaces) is populated, so session loading never triggers automatically on initial render.

When embedded in an iframe, this race condition is more pronounced because:

1. The iframe loads asynchronously
2. The SSE connection may establish before the frontend state is ready
3. There is no fallback mechanism to load sessions if the server.connected event is missed

Expected Behavior

Sessions should load automatically when the web UI initialises, regardless of whether it is running in a full browser window or embedded in an iframe.

Actual Behavior

Sessions stay hidden until the user manually re-triggers the directory bootstrap by clicking through the server and project flow.

Environment

• OpenCode version: v1.17.18
• OS: Debian (VPS, accessed via VS Code Remote SSH)
• Terminal: VS Code webview iframe (via opencode-chat extension v2.11.0)
• Database path: /root/.local/share/opencode/opencode.db

Evidence

API returns sessions correctly:

$ curl -s http://localhost:19084/api/session | python3 -m json.tool | head -20
{
    "data": [
        {
            "id": "ses_0b467cb71ffe4UAjw9AMgZwkWX",
            "title": "Find sessions command (@explore subagent)",
            "location": {
                "directory": "/root/vscodeprojects/tourwithalan"
            },
            ...
        }
    ]
}

Database query confirms sessions exist:

$ opencode db "SELECT id, title, directory FROM session ORDER BY time_created DESC LIMIT 5;"
ses_0b467cb71ffe4UAjw9AMgZwkWX  Find sessions command  /root/vscodeprojects/tourwithalan
ses_0b46fc404ffeA0NVja4RrPdD3N  Image visibility request  /root/vscodeprojects/tourwithalan
...

kv.json:

{"session_directory_filter_enabled": false}

Workaround

Manually click the server icon, then click the project from "Recent projects", and sessions appear.

Related Issues

• Web UI: session list empty on left panel when using web server mode #27837: session list empty on left panel when using web server mode (same root cause: SSE timing)
• Web UI not showing my sessions #10519: Web UI not showing my sessions
• Sessions created in Desktop app are not visible in CLI TUI session list #29071: Sessions created in Desktop app are not visible in CLI TUI session list
• Web: projects/sessions disappear when accessing same server via LAN or Tailscale IP instead of localhost #28340: Projects/sessions disappear when accessing same server via LAN/Tailscale IP

Suggested Fix

Add a fallback mechanism: if M.children is empty when server.connected fires, retry session loading after a short delay or when the first workspace is registered. Alternatively, trigger session loading on first render regardless of SSE events.

Plugins

None

OpenCode version

v1.17.18

Steps to reproduce

1. Install the opencode-chat VS Code extension (v2.11.0)
2. Open a project folder in VS Code that has existing OpenCode sessions
3. Open the OpenCode panel in the sidebar
4. Observe: session list is empty, only "Build anything" screen is shown
5. Click the server icon (top right, stacked rectangles)
6. Click the project from "Recent projects"
7. Sessions now appear in the sidebar

Screenshot and/or share link

Operating System

Debian 12 (VPS, accessed via VS Code Remote SSH)

Terminal

VS Code webview iframe (via opencode-chat extension v2.11.0)