feat(cloud-agent-next): add saved worktree file viewer

[eshurakov]

Summary

• Capture saved worktree-file content and expose authorized file reads through the control plane.
• Add workspace file tabs and a read-only file/diff pane.
• Extend snapshot-protocol and file-viewer regression coverage.

Verification

• manual verification

Visual Changes

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (55 files)

• apps/web/package.json
• apps/web/src/components/cloud-agent-next/CloudAgentWorkspaceTabs.test.ts
• apps/web/src/components/cloud-agent-next/CloudAgentWorkspaceTabs.tsx
• apps/web/src/components/cloud-agent-next/CloudChatPage.tsx
• apps/web/src/components/cloud-agent-next/WorktreeChanges.tsx
• apps/web/src/components/cloud-agent-next/WorktreeFilePane.tsx
• apps/web/src/components/cloud-agent-next/WorktreeFileRenderer.tsx
• apps/web/src/components/cloud-agent-next/terminal-tabs.test.ts
• apps/web/src/components/cloud-agent-next/terminal-tabs.ts
• apps/web/src/components/cloud-agent-next/useWorktreeFile.ts
• apps/web/src/components/cloud-agent-next/workspace-tabs.test.ts
• apps/web/src/components/cloud-agent-next/workspace-tabs.ts
• apps/web/src/components/cloud-agent-next/worktree-changes.test.ts
• apps/web/src/components/cloud-agent-next/worktree-file-diff.ts
• apps/web/src/components/cloud-agent-next/worktree-file.test.mts
• apps/web/src/components/cloud-agent-next/worktree-file.test.ts
• apps/web/src/components/cloud-agent-next/worktree-file.ts
• apps/web/src/lib/cloud-agent-next/cloud-agent-client.test.ts
• apps/web/src/lib/cloud-agent-next/cloud-agent-client.ts
• apps/web/src/routers/cloud-agent-next-router.test.ts
• apps/web/src/routers/cloud-agent-next-router.ts
• apps/web/src/routers/cloud-agent-next-schemas.test.ts
• apps/web/src/routers/cloud-agent-next-schemas.ts
• apps/web/src/routers/organizations/organization-cloud-agent-next-router.test.ts
• apps/web/src/routers/organizations/organization-cloud-agent-next-router.ts
• apps/web/tests/e2e/cloud-agent-sandbox-status.spec.ts
• packages/worker-utils/src/cloud-agent-worktree-changes.test.ts
• packages/worker-utils/src/cloud-agent-worktree-changes.ts
• pnpm-lock.yaml
• services/cloud-agent-next/src/persistence/SandboxControl.ts
• services/cloud-agent-next/src/router/handlers/session-worktree-changes.test.ts
• services/cloud-agent-next/src/router/handlers/session-worktree-changes.ts
• services/cloud-agent-next/src/router/schemas.ts
• services/cloud-agent-next/src/sandbox-control/frames.test.ts
• services/cloud-agent-next/src/sandbox-control/frames.ts
• services/cloud-agent-next/src/sandbox-control/socket.test.ts
• services/cloud-agent-next/src/sandbox-control/socket.ts
• services/cloud-agent-next/src/sandbox-session/SandboxSession.ts
• services/cloud-agent-next/src/sandbox-session/session-message-queue.test.ts
• services/cloud-agent-next/src/sandbox-session/worktree-changes.test.ts
• services/cloud-agent-next/src/sandbox-session/worktree-changes.ts
• services/cloud-agent-next/src/shared/sandbox-control-protocol.ts
• services/cloud-agent-next/src/shared/worktree-changes-wire.test.ts
• services/cloud-agent-next/src/shared/worktree-changes-wire.ts
• services/cloud-agent-next/test/integration/sandbox-control.test.ts
• services/cloud-agent-next/test/unit/wrapper/utils.test.ts
• services/cloud-agent-next/wrapper/src/control/retained-operation-notifications.test.ts
• services/cloud-agent-next/wrapper/src/control/sandbox-control-client.test.ts
• services/cloud-agent-next/wrapper/src/control/sandbox-control-client.ts
• services/cloud-agent-next/wrapper/src/control/sandbox-control-handlers.test.ts
• services/cloud-agent-next/wrapper/src/control/sandbox-control-handlers.ts
• services/cloud-agent-next/wrapper/src/control/worktree-changes.test.ts
• services/cloud-agent-next/wrapper/src/control/worktree-changes.ts
• services/cloud-agent-next/wrapper/src/control/worktree-file-capture.ts
• services/cloud-agent-next/wrapper/src/utils.ts

---

_{Reviewed by grok-4.6 · Input: 363.3K · Output: 28.3K · Cached: 2M}

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