fix(agent-manager): preserve tab and panel state across project switches

[marius-kilocode]

Issue

No existing issue. This was reported directly while testing multi-project Agent Manager.

Context

When Agent Manager switches between projects or between a project and a managed worktree, the view the user left was not restored reliably. The selected tab could change, tab order could be replaced, and the right sidebar could reopen a stale context or lose its content. Late terminal creation replies could also change the selection of a context the user had already left.

Implementation

• Scope remembered drafts and terminals to their owning project instead of accepting any pending or terminal id.
• Save the outgoing tab memory before a host-driven project activation, and clear transient selection before restoring the incoming target.
• Keep a Review tab's backing session so restoring Review selects the right session, and closing it returns to that session rather than the first one.
• Merge durable tab order with webview-only tabs (terminals, drafts, Review) instead of replacing the order on each state push.
• Namespace diff scope memory by project while keeping the plain context for diff ids, and keep review drafts when switching away.
• Ignore late terminal creation replies whose owner context is no longer active, and append the terminal to the owner's tab order.

The state hydration logic moved into project/hydration.ts to keep AgentManagerApp.tsx within its line limit.

Screenshots / Video

N/A. The change is interaction state, not static layout. Media is omitted because the Agent Manager header shows account data in this environment and PR assets are public.

How to Test

Manual/local verification

• Ran the isolated VS Code self-test with two projects and one managed worktree.
• Selected the second terminal, kept a mixed draft and terminal tab order, opened the right diff panel, then switched projects and returned. The second terminal stayed selected, the tab order was unchanged, and the right panel stayed open with its own diff scope.
• Repeated with Review selected, then closed the restored Review tab and confirmed the original session came back.
• Ran Add Project while a terminal was selected and confirmed the terminal selection and panel survived instead of reopening a stale Review.
• Confirmed an explicitly closed right panel stayed closed after a round trip.

Reviewer test steps

1. Enable the multi-project experimental setting.
2. Open Agent Manager and add a second project.
3. In project A, select a non-first session or a terminal tab and open the right diff panel.
4. Switch to project B, then back to project A.
5. Confirm the selected tab, tab order, and right panel are unchanged.
6. Repeat with Review selected, and with the panel closed.

Blocked checks and substitute verification

• No blocked checks.

Checklist

• Issue linked above, or exception explained
• Tests/verification described
• Screenshots/video included for visual changes, or marked N/A
• Changeset considered for user-facing changes
• I personally reviewed the diff and can explain the changes, including any AI-assisted work.

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

The prior SUGGESTION (hardcoded "review" / "pending:" in project/store.ts) is resolved: REVIEW_TAB_ID and PENDING_PREFIX now live in tab-ids.ts and are imported by both AgentManagerApp.tsx and project/store.ts.

Files Reviewed (3 files, incremental)

• packages/kilo-vscode/webview-ui/agent-manager/AgentManagerApp.tsx
• packages/kilo-vscode/webview-ui/agent-manager/project/store.ts
• packages/kilo-vscode/webview-ui/agent-manager/tab-ids.ts - new file

Previous Review Summary (commit df604a1)

Current summary above is authoritative. Previous snapshots are kept for context only.

Previous review (commit df604a1)

Status: 1 Issue Found | Recommendation: Address before merge

Overview

Severity	Count
CRITICAL	0
WARNING	0
SUGGESTION	1

Issue Details (click to expand)

SUGGESTION

File	Line	Issue
packages/kilo-vscode/webview-ui/agent-manager/project/store.ts	106	New mergeTransientTabs predicate hardcodes "review" / "pending:", duplicating REVIEW_TAB_ID / PENDING_PREFIX from AgentManagerApp.tsx; a rename would silently break tab-order preservation.

Files Reviewed (16 files)

• .changeset/fix-local-project-switch.md
• packages/kilo-vscode/tests/unit/agent-manager-diff-scope-state.test.ts
• packages/kilo-vscode/tests/unit/agent-manager-review-routing.test.ts
• packages/kilo-vscode/tests/unit/agent-manager-selection-actions.test.ts
• packages/kilo-vscode/tests/unit/agent-manager-terminal-state.test.ts
• packages/kilo-vscode/tests/unit/agent-manager-worktree-diffs.test.ts
• packages/kilo-vscode/tests/unit/project-review-state.test.ts
• packages/kilo-vscode/tests/unit/project-store.test.ts
• packages/kilo-vscode/webview-ui/agent-manager/AgentManagerApp.tsx
• packages/kilo-vscode/webview-ui/agent-manager/diff-review-scope.ts
• packages/kilo-vscode/webview-ui/agent-manager/diff-scope-state.ts
• packages/kilo-vscode/webview-ui/agent-manager/project/hydration.ts
• packages/kilo-vscode/webview-ui/agent-manager/project/store.ts - 1 issue
• packages/kilo-vscode/webview-ui/agent-manager/selection-actions.ts
• packages/kilo-vscode/webview-ui/agent-manager/tab-order.ts
• packages/kilo-vscode/webview-ui/agent-manager/terminal/state.ts

Fix these issues in Kilo Cloud

---

_{Reviewed by deepseek-v4.1-flash · Input: 0 · Output: 0 · Cached: 0}

_{Review guidance: REVIEW.md from base branch main}