fix(opencode): filter session list by resolved instance directory

[Hona]

What does this PR do?

Fixes the "sessions disappear from the sidebar" bug on Windows desktop (#34723) by making the session list filter use the same canonical directory that session create uses — with no database or schema changes.

Root cause (reproduced live against latest dev with the desktop's exact wire values):

• Session create resolves the x-opencode-directory hint via FSUtil.resolve when the instance boots (instance-store.ts), so a hint like / or a path with a trailing separator is stored in canonical form (e.g. / resolves to C:\ on Windows and the row stores C:/).
• Session list passed the raw ctx.query.directory string into the exact-match SQL filter. Any hint whose spelling differs from its canonical form (/, C:, trailing separators, symlinked tmp dirs) creates sessions that the same hint can never list back.

The desktop hits this when a global-project session is opened from Home: project.worktree ?? session.directory persists the global worktree sentinel "/" as a workspace. That workspace then lists directory=/ (always []) while creating sessions that resolve to the drive root — so every previous session "disappears" when a new one is created, and restarting doesn't help. This is a directory value mismatch; it is unrelated to the \ vs / storage encoding fixed in #29666 (which is working correctly).

Fix: the workspace-routing middleware already resolves the requested directory to select the instance. The list handlers now filter by that resolved instance directory instead of re-reading the raw query string, so list(hint) always finds create(hint) by construction:

• SessionHttpApi.list (GET /session)
• ExperimentalHttpApi.session (GET /experimental/session)

Existing databases self-heal: previously invisible rows become listable immediately because only the comparison value changes, not the data.

Type of change

• Bug fix (non-breaking change which fixes an issue)

How did you verify your code works?

• New HTTP-level test (lists sessions created through an equivalent directory hint) exercising the full middleware + handler chain: create via a hint whose canonical form differs (trailing separator), then list with the same hint on both endpoints. Fails on dev with Received: [], passes with this change.
• Live end-to-end repro on Windows against an isolated server: POST /session with x-opencode-directory: %2F followed by GET /session?directory=%2F&roots=true returned [] before this change and returns the created sessions after it; directory=C%3A%5C and directory=C%3A%2F continue to work.
• bun test test/server/session-list.test.ts test/server/global-session-list.test.ts test/server/workspace-routing.test.ts test/server/httpapi-instance-context.test.ts test/server/httpapi-query-schema-drift.test.ts — 50/50 pass.
• bun typecheck in packages/opencode — clean.

Checklist

• I have tested my changes locally
• I have included no unrelated changes

Issue for this PR

Fixes #34723

[Copilot]

Pull request overview

Fixes a Windows-specific “sessions disappear from the sidebar” issue by ensuring session-list endpoints filter using the same canonical, middleware-resolved instance directory that session creation uses, so equivalent directory hints (e.g. trailing separators, / resolving to a drive root) consistently match stored rows without any DB/schema changes.

Changes:

• Update GET /session to filter by InstanceState.directory (canonical instance directory) rather than the raw directory query string.
• Update GET /experimental/session to apply the same canonical-directory filtering behavior.
• Add an HTTP-level regression test covering “create with one spelling, list with equivalent spelling” across both endpoints.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.

File	Description
packages/opencode/src/server/routes/instance/httpapi/handlers/session.ts	Session list filtering now uses the resolved instance directory to avoid raw-hint mismatches.
packages/opencode/src/server/routes/instance/httpapi/handlers/experimental.ts	Global experimental session listing now filters by the resolved instance directory when a directory hint is provided.
packages/opencode/test/server/httpapi-session.test.ts	Adds an end-to-end test that creates a session with a trailing-separator hint and verifies it is listable via both list endpoints using the same hint.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.