ccdock 0.1.0

package/src/tui/input.ts

@@ -0,0 +1,116 @@
+export type KeyAction =
+	| { type: "up" }
+	| { type: "down" }
+	| { type: "enter" }
+	| { type: "tab" }
+	| { type: "quit" }
+	| { type: "new" }
+	| { type: "delete" }
+	| { type: "compact" }
+	| { type: "log" }
+	| { type: "realign" }
+	| { type: "mouse_click"; row: number; col: number }
+	| { type: "unknown" };
+
+export type WizardKeyAction =
+	| { type: "up" }
+	| { type: "down" }
+	| { type: "enter" }
+	| { type: "escape" }
+	| { type: "backspace" }
+	| { type: "char"; char: string }
+	| { type: "unknown" };
+
+export function parseKey(data: Buffer): KeyAction {
+	// SGR mouse: \x1b[<button;col;rowM (press) or \x1b[<button;col;rowm (release)
+	const s = data.toString();
+	const sgrMatch = s.match(/^\x1b\[<(\d+);(\d+);(\d+)([Mm])$/);
+	if (sgrMatch) {
+		const button = Number.parseInt(sgrMatch[1]!, 10);
+		const col = Number.parseInt(sgrMatch[2]!, 10);
+		const row = Number.parseInt(sgrMatch[3]!, 10);
+		const isPress = sgrMatch[4] === "M";
+		// button 0 = left click press
+		if (isPress && button === 0) {
+			return { type: "mouse_click", row, col };
+		}
+		// Scroll up/down
+		if (isPress && button === 64) return { type: "up" };
+		if (isPress && button === 65) return { type: "down" };
+		return { type: "unknown" };
+	}
+
+	// Escape sequences for arrow keys
+	if (s === "\x1b[A" || s === "k") return { type: "up" };
+	if (s === "\x1b[B" || s === "j") return { type: "down" };
+
+	// Enter
+	if (s === "\r" || s === "\n") return { type: "enter" };
+
+	// Tab
+	if (s === "\t") return { type: "tab" };
+
+	// Quit: q or Ctrl+C
+	if (s === "q" || s === "\x03") return { type: "quit" };
+
+	// New session: n
+	if (s === "n") return { type: "new" };
+
+	// Delete: d or x
+	if (s === "d" || s === "x") return { type: "delete" };
+
+	// Compact mode: c
+	if (s === "c") return { type: "compact" };
+
+	// Activity log: l
+	if (s === "l") return { type: "log" };
+
+	// Realign VS Code windows: r
+	if (s === "r") return { type: "realign" };
+
+	return { type: "unknown" };
+}
+
+export function parseKeyWizard(data: Buffer): WizardKeyAction {
+	const s = data.toString();
+
+	// Escape sequences for arrow keys
+	if (s === "\x1b[A") return { type: "up" };
+	if (s === "\x1b[B") return { type: "down" };
+
+	// Enter
+	if (s === "\r" || s === "\n") return { type: "enter" };
+
+	// Escape or Ctrl+C
+	if (s === "\x1b" || s === "\x03") return { type: "escape" };
+
+	// Backspace
+	if (s === "\x7f" || s === "\x08") return { type: "backspace" };
+
+	// Printable characters
+	if (s.length === 1 && s.charCodeAt(0) >= 32 && s.charCodeAt(0) <= 126) {
+		return { type: "char", char: s };
+	}
+
+	return { type: "unknown" };
+}
+
+// SGR extended mouse mode: supports coordinates > 223
+const MOUSE_ENABLE = "\x1b[?1000h\x1b[?1006h";
+const MOUSE_DISABLE = "\x1b[?1000l\x1b[?1006l";
+
+export function enableRawMode(): void {
+	if (process.stdin.isTTY) {
+		process.stdin.setRawMode(true);
+		process.stdin.resume();
+		process.stdout.write(MOUSE_ENABLE);
+	}
+}
+
+export function disableRawMode(): void {
+	if (process.stdin.isTTY) {
+		process.stdout.write(MOUSE_DISABLE);
+		process.stdin.setRawMode(false);
+		process.stdin.pause();
+	}
+}

package/src/tui/render.ts

@@ -0,0 +1,321 @@
+import type { DeleteConfirm, SidebarState, WorkspaceSession } from "../types.ts";
+
+const SPINNER_FRAMES = [
+	"\u280b",
+	"\u2819",
+	"\u2839",
+	"\u2838",
+	"\u283c",
+	"\u2834",
+	"\u2826",
+	"\u2827",
+	"\u2807",
+	"\u280f",
+];
+import {
+	BOLD,
+	BOX,
+	CLEAR_SCREEN,
+	COLORS,
+	CURSOR_HOME,
+	DIM,
+	RESET,
+	clearLine,
+	moveCursor,
+	shortenHome,
+	statusColor,
+	statusIcon,
+	truncate,
+	visibleLength,
+} from "./ansi.ts";
+
+function padRight(str: string, len: number): string {
+	const visible = visibleLength(str);
+	if (visible >= len) return str;
+	return str + " ".repeat(len - visible);
+}
+
+function renderDeleteConfirm(deleteConfirm: DeleteConfirm, cols: number): string[] {
+	const lines: string[] = [];
+	const width = Math.max(cols - 6, 16);
+
+	lines.push(`  ${COLORS.border}${BOX.horizontal.repeat(width)}${RESET}`);
+	lines.push(`  ${BOLD}${COLORS.error} Delete session?${RESET}`);
+	lines.push("");
+
+	const options = ["Remove session only", "Remove session + worktree"];
+
+	for (let i = 0; i < options.length; i++) {
+		const opt = options[i];
+		if (!opt) continue;
+		const isSelected = i === deleteConfirm.selectedIndex;
+		const marker = isSelected ? `${COLORS.highlight}\u25b6${RESET}` : " ";
+		const label = isSelected
+			? `${BOLD}${COLORS.title}${opt}${RESET}`
+			: `${COLORS.subtitle}${opt}${RESET}`;
+		lines.push(`    ${marker} ${label}`);
+	}
+
+	lines.push("");
+	lines.push(`  ${COLORS.muted}Enter: confirm | Esc: cancel${RESET}`);
+	lines.push(`  ${COLORS.border}${BOX.horizontal.repeat(width)}${RESET}`);
+
+	return lines;
+}
+
+function renderCard(
+	session: WorkspaceSession,
+	isSelected: boolean,
+	cols: number,
+	animFrame: number,
+	compact: boolean,
+	deleteConfirm: DeleteConfirm | null,
+	sessionIndex: number,
+): string[] {
+	const lines: string[] = [];
+	const width = Math.max(cols - 2, 20);
+	const bg = isSelected ? COLORS.bgSelected : "";
+	const resetBg = isSelected ? RESET : "";
+
+	// Colors based on editor state
+	// Focused: white border, normal title
+	// Open: normal border + green ● dot
+	// Closed: dim everything
+	const editorState = session.editorState;
+	const isFocused = editorState === "focused";
+	const isClosed = editorState === "closed";
+	const isLaunching = editorState === "launching";
+	const borderColor = isFocused
+		? COLORS.borderFocused
+		: isClosed
+			? COLORS.borderClosed
+			: COLORS.border;
+	const titleColor = isClosed ? COLORS.editorClosed : COLORS.title;
+	const detailColor = isClosed ? COLORS.editorClosed : COLORS.subtitle;
+	const dimAll = isClosed ? DIM : "";
+
+	// Status dot: spinning for launching, green solid for open/focused, none for closed
+	let openDot = "";
+	if (isLaunching) {
+		const frame = SPINNER_FRAMES[animFrame % SPINNER_FRAMES.length]!;
+		openDot = `${COLORS.waiting}${frame}${RESET} `;
+	} else if (!isClosed) {
+		openDot = `${COLORS.running}\u25cf${RESET} `;
+	}
+
+	// Card border top
+	const topBorder = `${dimAll}${borderColor}${BOX.topLeft}${BOX.horizontal.repeat(width - 2)}${BOX.topRight}${RESET}`;
+	lines.push(topBorder);
+
+	// Title line: #N + dot (if open) + icon + repo:branch
+	const icon = "\uf418";
+	const sessionNum = `${COLORS.muted}#${sessionIndex + 1}${RESET} `;
+	const titleText = `${titleColor}${icon} ${session.repoName}:${session.branch}${RESET}`;
+	const title = `${sessionNum}${openDot}${titleText}`;
+	const titleTruncated = truncate(title, width - 4);
+	const titleLine = `${dimAll}${borderColor}${BOX.vertical}${RESET} ${bg}${padRight(titleTruncated, width - 4)}${resetBg}${RESET} ${dimAll}${borderColor}${BOX.vertical}${RESET}`;
+	lines.push(titleLine);
+
+	if (!compact) {
+		// Path line
+		const shortPath = shortenHome(session.worktreePath);
+		const pathTruncated = truncate(shortPath, width - 4);
+		const pathColor = editorState === "closed" ? COLORS.editorClosed : COLORS.subtitle;
+		const pathLine = `${dimAll}${borderColor}${BOX.vertical}${RESET} ${bg}${pathColor}${padRight(pathTruncated, width - 4)}${resetBg}${RESET} ${dimAll}${borderColor}${BOX.vertical}${RESET}`;
+		lines.push(pathLine);
+
+		// Agent status lines
+		if (session.agents.length === 0) {
+			const noAgent = `${DIM}no agents${RESET}`;
+			const agentLine = `${dimAll}${borderColor}${BOX.vertical}${RESET} ${bg}${padRight(noAgent, width - 4)}${resetBg}${RESET} ${dimAll}${borderColor}${BOX.vertical}${RESET}`;
+			lines.push(agentLine);
+		} else {
+			for (const agent of session.agents) {
+				const sIcon = statusIcon(agent.status, animFrame);
+				const sColor = statusColor(agent.status);
+				const statusText = `${sColor}${sIcon} ${agent.status}${RESET}`;
+				const agentInfo = `${statusText} ${detailColor}${agent.agentType}${RESET}`;
+				const agentLine = `${dimAll}${borderColor}${BOX.vertical}${RESET} ${bg}${padRight(agentInfo, width - 4)}${resetBg}${RESET} ${dimAll}${borderColor}${BOX.vertical}${RESET}`;
+				lines.push(agentLine);
+
+				// Show latest tool activity
+				if (agent.toolName) {
+					const detail = agent.toolDetail
+						? `${detailColor}${agent.toolName}${RESET} ${detailColor}${agent.toolDetail}${RESET}`
+						: `${detailColor}${agent.toolName}${RESET}`;
+					const detailTruncated = truncate(`  ${detail}`, width - 4);
+					const detailLine = `${dimAll}${borderColor}${BOX.vertical}${RESET} ${bg}${padRight(detailTruncated, width - 4)}${resetBg}${RESET} ${dimAll}${borderColor}${BOX.vertical}${RESET}`;
+					lines.push(detailLine);
+				}
+			}
+		}
+	} else {
+		// Compact: just show agent status inline
+		const agentSummary =
+			session.agents.length > 0
+				? session.agents
+						.map((a) => `${statusColor(a.status)}${statusIcon(a.status, animFrame)}${RESET}`)
+						.join(" ")
+				: `${DIM}no agents${RESET}`;
+		const compactLine = `${dimAll}${borderColor}${BOX.vertical}${RESET} ${bg}${padRight(agentSummary, width - 4)}${resetBg}${RESET} ${dimAll}${borderColor}${BOX.vertical}${RESET}`;
+		lines.push(compactLine);
+	}
+
+	// Delete confirmation inline
+	if (isSelected && deleteConfirm && deleteConfirm.sessionId === session.id) {
+		const confirmLines = renderDeleteConfirm(deleteConfirm, cols);
+		for (const cl of confirmLines) {
+			const confirmLine = `${borderColor}${BOX.vertical}${RESET} ${padRight(cl, width - 4)} ${borderColor}${BOX.vertical}${RESET}`;
+			lines.push(confirmLine);
+		}
+	}
+
+	// Card border bottom
+	const bottomBorder = `${dimAll}${borderColor}${BOX.bottomLeft}${BOX.horizontal.repeat(width - 2)}${BOX.bottomRight}${RESET}`;
+	lines.push(bottomBorder);
+
+	return lines;
+}
+
+function renderActivityLog(state: SidebarState, maxLines: number): string[] {
+	const lines: string[] = [];
+	const width = Math.max(state.cols - 2, 20);
+
+	lines.push(`${COLORS.border}${BOX.horizontal.repeat(width)}${RESET}`);
+	lines.push(`${BOLD}${COLORS.highlight} Activity Log${RESET}`);
+
+	const entries = state.activityLog.slice(-maxLines);
+	for (const entry of entries) {
+		const sessionTag =
+			entry.sessionIndex >= 0 ? `${COLORS.accent}#${entry.sessionIndex + 1}${RESET} ` : "";
+		const detail = entry.toolDetail ? ` ${COLORS.muted}${entry.toolDetail}${RESET}` : "";
+		const line = `${COLORS.muted}${entry.time}${RESET} ${sessionTag}${COLORS.highlight}${entry.tool}${RESET}${detail}`;
+		lines.push(` ${truncate(line, width - 2)}`);
+	}
+
+	if (entries.length === 0) {
+		lines.push(`${DIM}  (no activity yet)${RESET}`);
+	}
+
+	return lines;
+}
+
+function renderFooter(cols: number): string[] {
+	const line1 = [
+		`${BOLD}j/k${RESET} nav`,
+		`${BOLD}Enter${RESET} focus`,
+		`${BOLD}n${RESET} new`,
+		`${BOLD}d${RESET} del`,
+		`${BOLD}r${RESET} realign`,
+	].join(`${COLORS.muted} | ${RESET}`);
+	const line2 = [`${BOLD}c${RESET} compact`, `${BOLD}l${RESET} log`, `${BOLD}q${RESET} quit`].join(
+		`${COLORS.muted} | ${RESET}`,
+	);
+	return [
+		`${COLORS.muted}${BOX.horizontal.repeat(Math.max(cols - 2, 1))}${RESET}`,
+		` ${truncate(line1, cols - 2)}`,
+		` ${truncate(line2, cols - 2)}`,
+	];
+}
+
+function renderQuitConfirm(selectedIndex: number, cols: number): string[] {
+	const width = Math.max(cols - 4, 20);
+	const lines: string[] = [];
+	lines.push("");
+	lines.push(`${BOLD}${COLORS.highlight} Quit ccdock?${RESET}`);
+	lines.push("");
+
+	const options = [
+		"Quit sidebar only (keep VS Code open)",
+		"Quit sidebar and close all VS Code windows",
+	];
+
+	for (let i = 0; i < options.length; i++) {
+		const isSelected = i === selectedIndex;
+		const marker = isSelected ? `${COLORS.highlight}\u25b6${RESET}` : " ";
+		const label = isSelected
+			? `${BOLD}${COLORS.title}${options[i]}${RESET}`
+			: `${COLORS.subtitle}${options[i]}${RESET}`;
+		lines.push(truncate(` ${marker} ${label}`, width));
+	}
+
+	lines.push("");
+	lines.push(`${COLORS.muted}  Enter: confirm | Esc: cancel${RESET}`);
+	return lines;
+}
+
+export function renderSidebar(state: SidebarState): string {
+	const output: string[] = [];
+	output.push(CLEAR_SCREEN + CURSOR_HOME);
+
+	// Quit confirmation takes over the screen
+	if (state.quitConfirm) {
+		output.push(...renderQuitConfirm(state.quitConfirm.selectedIndex, state.cols));
+		return output.join("\n");
+	}
+
+	// Header
+	const header = `${BOLD}${COLORS.highlight} ccdock${RESET} ${COLORS.muted}(${state.sessions.length} sessions)${RESET}`;
+	output.push(header);
+	output.push("");
+
+	// Calculate available space
+	const footerHeight = 3;
+	const headerHeight = 2;
+	const logHeight = state.showActivityLog ? Math.min(8, state.activityLog.length + 2) : 0;
+	const availableForCards = state.rows - headerHeight - footerHeight - logHeight;
+
+	// Render session cards
+	let linesUsed = 0;
+	state.cardRowRanges = [];
+	const cardStartOffset = output.length; // rows before cards (header)
+	for (let i = 0; i < state.sessions.length; i++) {
+		const session = state.sessions[i];
+		if (!session) continue;
+		const isSelected = i === state.selectedIndex;
+		const cardLines = renderCard(
+			session,
+			isSelected,
+			state.cols,
+			state.animationFrame,
+			state.compactMode,
+			state.deleteConfirm,
+			i,
+		);
+
+		if (linesUsed + cardLines.length > availableForCards) break;
+		const startRow = cardStartOffset + linesUsed + 1; // 1-based row
+		state.cardRowRanges.push({
+			sessionIndex: i,
+			startRow,
+			endRow: startRow + cardLines.length - 1,
+		});
+		output.push(...cardLines);
+		linesUsed += cardLines.length;
+	}
+
+	if (state.sessions.length === 0) {
+		output.push("");
+		output.push(`${DIM}  No active sessions.${RESET}`);
+		output.push(`${DIM}  Press 'n' to create a new session.${RESET}`);
+	}
+
+	// Fill remaining space
+	const currentLines = output.length;
+	const targetLine = state.rows - footerHeight - logHeight;
+	for (let i = currentLines; i < targetLine; i++) {
+		output.push("");
+	}
+
+	// Activity log
+	if (state.showActivityLog) {
+		const logLines = renderActivityLog(state, 5);
+		output.push(...logLines);
+	}
+
+	// Footer
+	const footerLines = renderFooter(state.cols);
+	output.push(...footerLines);
+
+	return output.join("\n");
+}

package/src/tui/wizard.ts

@@ -0,0 +1,166 @@
+import type { RepoInfo, WizardState, WorktreeEntry } from "../types.ts";
+import { BOLD, BOX, CLEAR_SCREEN, COLORS, CURSOR_HOME, DIM, RESET, truncate } from "./ansi.ts";
+
+function renderRepoList(
+	repos: RepoInfo[],
+	selectedIndex: number,
+	filter: string,
+	cols: number,
+): string[] {
+	const lines: string[] = [];
+	const width = Math.max(cols - 4, 20);
+
+	lines.push(`${BOLD}${COLORS.highlight} Select Repository${RESET}`);
+	lines.push("");
+
+	if (filter) {
+		lines.push(`${COLORS.muted}  Filter: ${RESET}${filter}`);
+		lines.push("");
+	}
+
+	const filtered = repos.filter((r) => r.name.toLowerCase().includes(filter.toLowerCase()));
+
+	if (filtered.length === 0) {
+		lines.push(`${DIM}  No repos matching "${filter}"${RESET}`);
+	} else {
+		for (let i = 0; i < filtered.length; i++) {
+			const repo = filtered[i];
+			if (!repo) continue;
+			const isSelected = i === selectedIndex;
+			const marker = isSelected ? `${COLORS.highlight}\u25b6${RESET}` : " ";
+			const name = isSelected
+				? `${BOLD}${COLORS.title}${repo.name}${RESET}`
+				: `${COLORS.subtitle}${repo.name}${RESET}`;
+			const branch = `${COLORS.muted}(${repo.defaultBranch})${RESET}`;
+			const line = ` ${marker} ${name} ${branch}`;
+			lines.push(truncate(line, width));
+		}
+	}
+
+	lines.push("");
+	lines.push(`${COLORS.muted}  j/k: navigate | Enter: select | Esc: cancel${RESET}`);
+	lines.push(`${COLORS.muted}  Type to filter repos${RESET}`);
+
+	return lines;
+}
+
+function renderModeSelect(repo: RepoInfo, selectedIndex: number, cols: number): string[] {
+	const lines: string[] = [];
+	const width = Math.max(cols - 4, 20);
+
+	lines.push(`${BOLD}${COLORS.highlight} Create Session: ${repo.name}${RESET}`);
+	lines.push("");
+	lines.push(`${COLORS.muted}  Select mode:${RESET}`);
+	lines.push("");
+
+	const modes = [
+		{ label: "Create new worktree (git wt)", desc: "Create a new feature branch worktree" },
+		{ label: "Use existing worktree", desc: "Select from existing worktrees" },
+		{ label: "Open repository root", desc: "Open the main repository directory" },
+	];
+
+	for (let i = 0; i < modes.length; i++) {
+		const mode = modes[i];
+		if (!mode) continue;
+		const isSelected = i === selectedIndex;
+		const marker = isSelected ? `${COLORS.highlight}\u25b6${RESET}` : " ";
+		const label = isSelected
+			? `${BOLD}${COLORS.title}${mode.label}${RESET}`
+			: `${COLORS.subtitle}${mode.label}${RESET}`;
+		const desc = `${COLORS.muted}${mode.desc}${RESET}`;
+		lines.push(truncate(` ${marker} ${label}`, width));
+		lines.push(truncate(`     ${desc}`, width));
+	}
+
+	lines.push("");
+	lines.push(`${COLORS.muted}  j/k: navigate | Enter: select | Esc: back${RESET}`);
+
+	return lines;
+}
+
+function renderWorktreeList(
+	repo: RepoInfo,
+	worktrees: WorktreeEntry[],
+	selectedIndex: number,
+	cols: number,
+): string[] {
+	const lines: string[] = [];
+	const width = Math.max(cols - 4, 20);
+
+	lines.push(`${BOLD}${COLORS.highlight} Select Worktree: ${repo.name}${RESET}`);
+	lines.push("");
+
+	if (worktrees.length === 0) {
+		lines.push(`${DIM}  No existing worktrees found.${RESET}`);
+	} else {
+		for (let i = 0; i < worktrees.length; i++) {
+			const wt = worktrees[i];
+			if (!wt) continue;
+			const isSelected = i === selectedIndex;
+			const marker = isSelected ? `${COLORS.highlight}\u25b6${RESET}` : " ";
+			const branchLabel = isSelected
+				? `${BOLD}${COLORS.title}${wt.branch || "(detached)"}${RESET}`
+				: `${COLORS.subtitle}${wt.branch || "(detached)"}${RESET}`;
+			const pathLabel = `${COLORS.muted}${wt.path}${RESET}`;
+			lines.push(truncate(` ${marker} ${branchLabel}`, width));
+			lines.push(truncate(`     ${pathLabel}`, width));
+		}
+	}
+
+	lines.push("");
+	lines.push(`${COLORS.muted}  j/k: navigate | Enter: select | Esc: back${RESET}`);
+
+	return lines;
+}
+
+function renderBranchInput(repo: RepoInfo, branchName: string, cols: number): string[] {
+	const lines: string[] = [];
+	const width = Math.max(cols - 4, 20);
+
+	lines.push(`${BOLD}${COLORS.highlight} Create Session: ${repo.name}${RESET}`);
+	lines.push("");
+	lines.push(`${COLORS.muted}  Enter branch name:${RESET}`);
+	lines.push("");
+	lines.push(`  ${COLORS.border}${BOX.horizontal.repeat(width - 6)}${RESET}`);
+	lines.push(`  ${BOLD}${branchName}${RESET}\u2588`);
+	lines.push(`  ${COLORS.border}${BOX.horizontal.repeat(width - 6)}${RESET}`);
+	lines.push("");
+
+	if (branchName) {
+		const preview = `${repo.name}--${branchName.replace(/\//g, "-")}`;
+		lines.push(`${COLORS.muted}  Worktree dir: ${preview}${RESET}`);
+	}
+
+	lines.push("");
+	lines.push(`${COLORS.muted}  Enter: create | Esc: back${RESET}`);
+
+	return lines;
+}
+
+export function renderWizard(wizard: WizardState, cols: number): string {
+	if (!wizard) return "";
+
+	const output: string[] = [];
+	output.push(CLEAR_SCREEN + CURSOR_HOME);
+
+	let content: string[];
+
+	switch (wizard.step) {
+		case "select-repo":
+			content = renderRepoList(wizard.repos, wizard.selectedIndex, wizard.filter, cols);
+			break;
+		case "select-mode":
+			content = renderModeSelect(wizard.repo, wizard.selectedIndex, cols);
+			break;
+		case "select-worktree":
+			content = renderWorktreeList(wizard.repo, wizard.worktrees, wizard.selectedIndex, cols);
+			break;
+		case "enter-branch":
+			content = renderBranchInput(wizard.repo, wizard.branchName, cols);
+			break;
+	}
+
+	output.push(...content);
+
+	return output.join("\n");
+}

package/src/types.ts

@@ -0,0 +1,86 @@
+export type AgentType = "claude-code" | "codex";
+export type AgentStatus = "running" | "waiting" | "idle" | "error" | "unknown";
+
+export interface AgentState {
+	sessionId: string;
+	agentType: AgentType;
+	status: AgentStatus;
+	prompt: string;
+	toolName: string;
+	toolDetail: string; // human-readable detail from tool_input
+	cwd: string;
+	updatedAt: number; // Date.now()
+}
+
+export type EditorState = "focused" | "open" | "closed" | "launching";
+
+export interface WorkspaceSession {
+	id: string; // unique session ID (uuid or short hash)
+	sessionName: string; // display name
+	worktreePath: string;
+	branch: string;
+	repoName: string; // extracted from path
+	agents: AgentState[]; // populated from state files
+	editorState: EditorState; // VS Code window state
+	createdAt: number;
+	lastActiveAt: number;
+}
+
+export interface RepoInfo {
+	name: string;
+	path: string;
+	defaultBranch: string;
+}
+
+export interface WorktreeEntry {
+	path: string;
+	branch: string;
+}
+
+export interface DeleteConfirm {
+	sessionId: string;
+	worktreePath: string;
+	selectedIndex: number; // 0 = session only, 1 = session + worktree
+}
+
+export interface SidebarState {
+	sessions: WorkspaceSession[];
+	selectedIndex: number;
+	rows: number;
+	cols: number;
+	animationFrame: number;
+	compactMode: boolean;
+	showActivityLog: boolean;
+	cardRowRanges: Array<{ sessionIndex: number; startRow: number; endRow: number }>;
+	activityLog: Array<{
+		time: string;
+		sessionId: string;
+		sessionIndex: number;
+		agent: string;
+		tool: string;
+		toolDetail: string;
+	}>;
+	wizard: WizardState;
+	deleteConfirm: DeleteConfirm | null;
+	quitConfirm: { selectedIndex: number } | null; // 0=quit only, 1=quit+close editors
+}
+
+// Wizard steps for creating new sessions
+export type WizardStep =
+	| { step: "select-repo"; repos: RepoInfo[]; selectedIndex: number; filter: string }
+	| { step: "select-mode"; repo: RepoInfo; selectedIndex: number; repos: RepoInfo[] }
+	| {
+			step: "select-worktree";
+			repo: RepoInfo;
+			worktrees: WorktreeEntry[];
+			selectedIndex: number;
+			repos: RepoInfo[];
+	  }
+	| { step: "enter-branch"; repo: RepoInfo; branchName: string; repos: RepoInfo[] };
+
+export type WizardState = WizardStep | null;
+
+export interface HubConfig {
+	workspace_dirs: string[];
+	editor: "code" | "cursor";
+}