feat: rate limit detection, runtime swap, and session resume

src/commands/agents.test.ts

@@ -96,6 +96,7 @@ describe("discoverAgents", () => {
 			id: "session-1",
 			agentName: "builder-test",
 			capability: "builder",
+			runtime: "claude",
 			worktreePath: join(tempDir, ".overstory", "worktrees", "builder-test"),
 			branchName: "overstory/builder-test/task-123",
 			taskId: "task-123",
@@ -109,6 +110,7 @@ describe("discoverAgents", () => {
 			lastActivity: "2024-01-01T00:01:00Z",
 			escalationLevel: 0,
 			stalledSince: null,
+			rateLimitedSince: null,
 			transcriptPath: null,
 		};
 
@@ -129,6 +131,7 @@ describe("discoverAgents", () => {
 			id: "session-1",
 			agentName: "builder-test",
 			capability: "builder",
+			runtime: "claude",
 			worktreePath: join(tempDir, ".overstory", "worktrees", "builder-test"),
 			branchName: "overstory/builder-test/task-123",
 			taskId: "task-123",
@@ -142,13 +145,15 @@ describe("discoverAgents", () => {
 			lastActivity: "2024-01-01T00:01:00Z",
 			escalationLevel: 0,
 			stalledSince: null,
+			rateLimitedSince: null,
 			transcriptPath: null,
 		};
 
 		const scout: AgentSession = {
 			id: "session-2",
 			agentName: "scout-test",
 			capability: "scout",
+			runtime: "claude",
 			worktreePath: join(tempDir, ".overstory", "worktrees", "scout-test"),
 			branchName: "overstory/scout-test/task-456",
 			taskId: "task-456",
@@ -162,6 +167,7 @@ describe("discoverAgents", () => {
 			lastActivity: "2024-01-01T00:01:00Z",
 			escalationLevel: 0,
 			stalledSince: null,
+			rateLimitedSince: null,
 			transcriptPath: null,
 		};
 
@@ -182,6 +188,7 @@ describe("discoverAgents", () => {
 			id: "session-1",
 			agentName: "builder-working",
 			capability: "builder",
+			runtime: "claude",
 			worktreePath: join(tempDir, ".overstory", "worktrees", "builder-working"),
 			branchName: "overstory/builder-working/task-123",
 			taskId: "task-123",
@@ -195,13 +202,15 @@ describe("discoverAgents", () => {
 			lastActivity: "2024-01-01T00:01:00Z",
 			escalationLevel: 0,
 			stalledSince: null,
+			rateLimitedSince: null,
 			transcriptPath: null,
 		};
 
 		const completed: AgentSession = {
 			id: "session-2",
 			agentName: "builder-completed",
 			capability: "builder",
+			runtime: "claude",
 			worktreePath: join(tempDir, ".overstory", "worktrees", "builder-completed"),
 			branchName: "overstory/builder-completed/task-456",
 			taskId: "task-456",
@@ -215,6 +224,7 @@ describe("discoverAgents", () => {
 			lastActivity: "2024-01-01T00:02:00Z",
 			escalationLevel: 0,
 			stalledSince: null,
+			rateLimitedSince: null,
 			transcriptPath: null,
 		};
 

src/commands/clean.test.ts

@@ -152,6 +152,7 @@ describe("--all", () => {
 			id: "s1",
 			agentName: "test-agent",
 			capability: "builder",
+			runtime: "claude",
 			worktreePath: "/tmp/wt",
 			branchName: "overstory/test/task",
 			taskId: "task-1",
@@ -165,6 +166,7 @@ describe("--all", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			rateLimitedSince: null,
 			transcriptPath: null,
 		});
 		store.close();
@@ -297,6 +299,7 @@ describe("individual flags", () => {
 			id: "s1",
 			agentName: "test-agent",
 			capability: "builder",
+			runtime: "claude",
 			worktreePath: "/tmp/wt",
 			branchName: "overstory/test/task",
 			taskId: "task-1",
@@ -310,6 +313,7 @@ describe("individual flags", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			rateLimitedSince: null,
 			transcriptPath: null,
 		});
 		store.close();
@@ -419,6 +423,7 @@ describe("synthetic session-end events", () => {
 			id: "s1",
 			agentName: "test-builder",
 			capability: "builder",
+			runtime: "claude",
 			worktreePath: "/tmp/wt",
 			branchName: "overstory/test-builder/task-1",
 			taskId: "task-1",
@@ -432,6 +437,7 @@ describe("synthetic session-end events", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			rateLimitedSince: null,
 			transcriptPath: null,
 			...overrides,
 		};
@@ -671,6 +677,7 @@ describe("--agent", () => {
 			id: "s1",
 			agentName: "test-builder",
 			capability: "builder",
+			runtime: "claude",
 			worktreePath: join(tempDir, ".overstory", "worktrees", "test-builder"),
 			branchName: "overstory/test-builder/task-1",
 			taskId: "task-1",
@@ -684,6 +691,7 @@ describe("--agent", () => {
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			rateLimitedSince: null,
 			transcriptPath: null,
 			...overrides,
 		};

src/commands/coordinator.test.ts

@@ -297,6 +297,7 @@ function makeCoordinatorSession(overrides: Partial<AgentSession> = {}): AgentSes
 		id: `session-${Date.now()}-coordinator`,
 		agentName: "coordinator",
 		capability: "coordinator",
+		runtime: "claude",
 		worktreePath: tempDir,
 		branchName: "main",
 		taskId: "",
@@ -310,6 +311,7 @@ function makeCoordinatorSession(overrides: Partial<AgentSession> = {}): AgentSes
 		lastActivity: new Date().toISOString(),
 		escalationLevel: 0,
 		stalledSince: null,
+		rateLimitedSince: null,
 		transcriptPath: null,
 		...overrides,
 	};
@@ -2215,6 +2217,7 @@ describe("checkComplete", () => {
 				id: "s1",
 				agentName: "builder-1",
 				capability: "builder",
+				runtime: "claude",
 				worktreePath: tempDir,
 				branchName: "feat/x",
 				taskId: "t1",
@@ -2228,6 +2231,7 @@ describe("checkComplete", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				rateLimitedSince: null,
 				transcriptPath: null,
 			};
 			store.upsert(base);
@@ -2267,6 +2271,7 @@ describe("checkComplete", () => {
 				id: "s1",
 				agentName: "builder-1",
 				capability: "builder",
+				runtime: "claude",
 				worktreePath: tempDir,
 				branchName: "feat/x",
 				taskId: "t1",
@@ -2280,6 +2285,7 @@ describe("checkComplete", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				rateLimitedSince: null,
 				transcriptPath: null,
 			};
 			store.upsert(session);
@@ -2319,6 +2325,7 @@ describe("checkComplete", () => {
 				id: "coord",
 				agentName: "coordinator",
 				capability: "coordinator",
+				runtime: "claude",
 				worktreePath: tempDir,
 				branchName: "main",
 				taskId: "",
@@ -2332,13 +2339,15 @@ describe("checkComplete", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				rateLimitedSince: null,
 				transcriptPath: null,
 			});
 			// worker session that is completed
 			store.upsert({
 				id: "worker",
 				agentName: "builder-1",
 				capability: "builder",
+				runtime: "claude",
 				worktreePath: tempDir,
 				branchName: "feat/x",
 				taskId: "t1",
@@ -2352,6 +2361,7 @@ describe("checkComplete", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				rateLimitedSince: null,
 				transcriptPath: null,
 			});
 		} finally {
@@ -2480,6 +2490,7 @@ describe("checkComplete", () => {
 				id: "s1",
 				agentName: "lead-1",
 				capability: "lead",
+				runtime: "claude",
 				worktreePath: tempDir,
 				branchName: "overstory/lead-1/task-1",
 				taskId: "task-1",
@@ -2493,6 +2504,7 @@ describe("checkComplete", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				rateLimitedSince: null,
 				transcriptPath: null,
 			});
 		} finally {
@@ -2546,6 +2558,7 @@ describe("checkComplete", () => {
 				id: "s1",
 				agentName: "lead-1",
 				capability: "lead",
+				runtime: "claude",
 				worktreePath: tempDir,
 				branchName: "overstory/lead-1/task-1",
 				taskId: "task-1",
@@ -2559,6 +2572,7 @@ describe("checkComplete", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				rateLimitedSince: null,
 				transcriptPath: null,
 			});
 		} finally {

src/commands/coordinator.ts

@@ -409,9 +409,11 @@ async function startCoordinator(
 		if (await agentDefFile.exists()) {
 			appendSystemPromptFile = agentDefPath;
 		}
+		const runtimeSessionId = crypto.randomUUID();
 		const spawnCmd = runtime.buildSpawnCommand({
 			model: resolvedModel.model,
 			permissionMode: "bypass",
+			sessionId: runtimeSessionId,
 			cwd: projectRoot,
 			appendSystemPromptFile,
 			env: {
@@ -451,6 +453,7 @@ async function startCoordinator(
 			id: sessionId,
 			agentName: COORDINATOR_NAME,
 			capability: "coordinator",
+			runtime: runtime.id,
 			worktreePath: projectRoot, // Coordinator uses project root, not a worktree
 			branchName: config.project.canonicalBranch, // Operates on canonical branch
 			taskId: "", // No specific task assignment
@@ -464,6 +467,7 @@ async function startCoordinator(
 			lastActivity: new Date().toISOString(),
 			escalationLevel: 0,
 			stalledSince: null,
+			rateLimitedSince: null,
 			transcriptPath: null,
 		};
 

src/commands/costs.test.ts

@@ -768,6 +768,7 @@ describe("costsCommand", () => {
 				id: "sess-001",
 				agentName: "builder-1",
 				capability: "builder",
+				runtime: "claude",
 				worktreePath: "/tmp/wt1",
 				branchName: "feat/task1",
 				taskId: "task-001",
@@ -781,6 +782,7 @@ describe("costsCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				rateLimitedSince: null,
 				transcriptPath: null,
 			});
 			sessionStore.close();
@@ -826,6 +828,7 @@ describe("costsCommand", () => {
 				id: "sess-001",
 				agentName: "builder-1",
 				capability: "builder",
+				runtime: "claude",
 				worktreePath: "/tmp/wt1",
 				branchName: "feat/task1",
 				taskId: "task-001",
@@ -839,6 +842,7 @@ describe("costsCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				rateLimitedSince: null,
 				transcriptPath: null,
 			});
 			sessionStore.close();
@@ -892,6 +896,7 @@ describe("costsCommand", () => {
 				id: "sess-001",
 				agentName: "builder-1",
 				capability: "builder",
+				runtime: "claude",
 				worktreePath: "/tmp/wt1",
 				branchName: "feat/task1",
 				taskId: "task-001",
@@ -905,12 +910,14 @@ describe("costsCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				rateLimitedSince: null,
 				transcriptPath: null,
 			});
 			sessionStore.upsert({
 				id: "sess-002",
 				agentName: "scout-1",
 				capability: "scout",
+				runtime: "claude",
 				worktreePath: "/tmp/wt2",
 				branchName: "feat/task2",
 				taskId: "task-002",
@@ -924,6 +931,7 @@ describe("costsCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				rateLimitedSince: null,
 				transcriptPath: null,
 			});
 			sessionStore.close();
@@ -973,6 +981,7 @@ describe("costsCommand", () => {
 				id: "sess-001",
 				agentName: "builder-1",
 				capability: "builder",
+				runtime: "claude",
 				worktreePath: "/tmp/wt1",
 				branchName: "feat/task1",
 				taskId: "task-001",
@@ -986,6 +995,7 @@ describe("costsCommand", () => {
 				lastActivity: new Date().toISOString(),
 				escalationLevel: 0,
 				stalledSince: null,
+				rateLimitedSince: null,
 				transcriptPath: null,
 			});
 			sessionStore.close();

src/commands/dashboard.test.ts

@@ -428,6 +428,7 @@ describe("renderAgentPanel", () => {
 						id: "sess-h1",
 						agentName: "headless-worker",
 						capability: "builder",
+						runtime: "claude",
 						worktreePath: "/tmp/wt/headless",
 						branchName: "overstory/headless/task-1",
 						taskId: "task-h1",
@@ -441,6 +442,7 @@ describe("renderAgentPanel", () => {
 						lastActivity: new Date().toISOString(),
 						escalationLevel: 0,
 						stalledSince: null,
+						rateLimitedSince: null,
 						transcriptPath: null,
 					},
 				],
@@ -468,6 +470,7 @@ describe("renderAgentPanel", () => {
 						id: "sess-h2",
 						agentName: "dead-headless", // short enough to not be truncated
 						capability: "builder",
+						runtime: "claude",
 						worktreePath: "/tmp/wt/dead-headless",
 						branchName: "overstory/dead-headless/task-2",
 						taskId: "task-h2",
@@ -481,6 +484,7 @@ describe("renderAgentPanel", () => {
 						lastActivity: new Date().toISOString(),
 						escalationLevel: 0,
 						stalledSince: null,
+						rateLimitedSince: null,
 						transcriptPath: null,
 					},
 				],