pi-harness-runtime 1.1.13 → 1.1.14

package/CHANGELOG.md

@@ -2,8 +2,14 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-### [1.1.13](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v1.1.12...v1.1.13) (2026-08-21)
+### [1.1.14](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v1.1.13...v1.1.14) (2026-08-24)
+
+
+### Features
 
+* **glm-quota:** add robust GLM quota countdown with auto-resume ([cb78a2b](https://github.com/ManotLuijiu/pi-harness-runtime/commit/cb78a2bdf5ecf79fc028030d43e3ce40767253cb))
+
+### [1.1.13](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v1.1.12...v1.1.13) (2026-08-21)
 
 ### Bug Fixes
 
@@ -11,14 +17,12 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [1.1.12](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v1.1.11...v1.1.12) (2026-08-20)
 
-
 ### Bug Fixes
 
 * **runtime:** refresh minimax quota from provider mirror ([a8976b4](https://github.com/ManotLuijiu/pi-harness-runtime/commit/a8976b4ff61e28b964bf76405142672798714647))
 
 ### [1.1.11](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.42...v1.1.11) (2026-08-20)
 
-
 ### Features
 
 * add quota scrapers for ChatGPT and GLM providers ([17f9d0e](https://github.com/ManotLuijiu/pi-harness-runtime/commit/17f9d0e7d6f486210a30244f2fecc0131e8b7d57))
@@ -26,7 +30,6 @@ All notable changes to this project will be documented in this file. See [standa
 * index.ts ([d0fc002](https://github.com/ManotLuijiu/pi-harness-runtime/commit/d0fc002d6d16e59318155677cb6128846bc993a4))
 * update workflow run name to show version number ([ee8c59f](https://github.com/ManotLuijiu/pi-harness-runtime/commit/ee8c59fec4c0116a5948b2ae04ad4609edaed3ac))
 
-
 ### Bug Fixes
 
 * add typescript as devDependency, build notification dist ([c76b522](https://github.com/ManotLuijiu/pi-harness-runtime/commit/c76b5221c33262c38615c6117ecf9db13ab7b5d2))
@@ -49,7 +52,6 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [1.1.10](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.42...v1.1.10) (2026-08-20)
 
-
 ### Features
 
 * add quota scrapers for ChatGPT and GLM providers ([17f9d0e](https://github.com/ManotLuijiu/pi-harness-runtime/commit/17f9d0e7d6f486210a30244f2fecc0131e8b7d57))
@@ -57,7 +59,6 @@ All notable changes to this project will be documented in this file. See [standa
 * index.ts ([d0fc002](https://github.com/ManotLuijiu/pi-harness-runtime/commit/d0fc002d6d16e59318155677cb6128846bc993a4))
 * update workflow run name to show version number ([ee8c59f](https://github.com/ManotLuijiu/pi-harness-runtime/commit/ee8c59fec4c0116a5948b2ae04ad4609edaed3ac))
 
-
 ### Bug Fixes
 
 * add typescript as devDependency, build notification dist ([c76b522](https://github.com/ManotLuijiu/pi-harness-runtime/commit/c76b5221c33262c38615c6117ecf9db13ab7b5d2))
@@ -79,7 +80,6 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.10.30](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.29...v0.10.30) (2026-08-11)
 
-
 ### Bug Fixes
 
 * **file-copy-helper:** require explicit intent for copy rule injection ([ddfece0](https://github.com/ManotLuijiu/pi-harness-runtime/commit/ddfece0bcbf440dfd4edc0d442b078e84e906c68))
@@ -98,13 +98,11 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.10.27](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.14...v0.10.27) (2026-08-10)
 
-
 ### Features
 
 * create packages for missing RFC implementations ([e6ce2ff](https://github.com/ManotLuijiu/pi-harness-runtime/commit/e6ce2ffdd455b33c55212ec2b61eedcdcfb43b5e))
 * **file-copy-helper:** inject cp rule when user asks to mimic/copy files ([f089f0d](https://github.com/ManotLuijiu/pi-harness-runtime/commit/f089f0d5e3e933231c99ee38cf18fa208c8eb8b2))
 
-
 ### Bug Fixes
 
 * align TS formatting with main (remove 3-line logError) ([2515ad5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/2515ad54f43f0566123c686d3ec4f92ad363ea13))
@@ -120,12 +118,10 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.10.26](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.14...v0.10.26) (2026-08-10)
 
-
 ### Features
 
 * **file-copy-helper:** inject cp rule when user asks to mimic/copy files ([f089f0d](https://github.com/ManotLuijiu/pi-harness-runtime/commit/f089f0d5e3e933231c99ee38cf18fa208c8eb8b2))
 
-
 ### Bug Fixes
 
 * align TS formatting with main (remove 3-line logError) ([2515ad5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/2515ad54f43f0566123c686d3ec4f92ad363ea13))
@@ -141,12 +137,10 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.10.25](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.14...v0.10.25) (2026-08-10)
 
-
 ### Features
 
 * **file-copy-helper:** inject cp rule when user asks to mimic/copy files ([f089f0d](https://github.com/ManotLuijiu/pi-harness-runtime/commit/f089f0d5e3e933231c99ee38cf18fa208c8eb8b2))
 
-
 ### Bug Fixes
 
 * align TS formatting with main (remove 3-line logError) ([2515ad5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/2515ad54f43f0566123c686d3ec4f92ad363ea13))
@@ -161,12 +155,10 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.10.24](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.14...v0.10.24) (2026-08-09)
 
-
 ### Features
 
 * **file-copy-helper:** inject cp rule when user asks to mimic/copy files ([f089f0d](https://github.com/ManotLuijiu/pi-harness-runtime/commit/f089f0d5e3e933231c99ee38cf18fa208c8eb8b2))
 
-
 ### Bug Fixes
 
 * align TS formatting with main (remove 3-line logError) ([2515ad5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/2515ad54f43f0566123c686d3ec4f92ad363ea13))
@@ -180,12 +172,10 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.10.23](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.14...v0.10.23) (2026-08-09)
 
-
 ### Features
 
 * **file-copy-helper:** inject cp rule when user asks to mimic/copy files ([f089f0d](https://github.com/ManotLuijiu/pi-harness-runtime/commit/f089f0d5e3e933231c99ee38cf18fa208c8eb8b2))
 
-
 ### Bug Fixes
 
 * align TS formatting with main (remove 3-line logError) ([2515ad5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/2515ad54f43f0566123c686d3ec4f92ad363ea13))
@@ -198,7 +188,6 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.10.22](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.14...v0.10.22) (2026-08-09)
 
-
 ### Bug Fixes
 
 * align TS formatting with main (remove 3-line logError) ([2515ad5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/2515ad54f43f0566123c686d3ec4f92ad363ea13))
@@ -211,7 +200,6 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.10.21](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.14...v0.10.21) (2026-08-08)
 
-
 ### Bug Fixes
 
 * align TS formatting with main (remove 3-line logError) ([2515ad5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/2515ad54f43f0566123c686d3ec4f92ad363ea13))
@@ -223,7 +211,6 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.10.20](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.14...v0.10.20) (2026-08-08)
 
-
 ### Bug Fixes
 
 * align TS formatting with main (remove 3-line logError) ([2515ad5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/2515ad54f43f0566123c686d3ec4f92ad363ea13))
@@ -234,14 +221,12 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.10.11](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.10.9...v0.10.11) (2026-08-03)
 
-
 ### Features
 
 * add knowledge-retrieval package for TencentDB-Agent-Memory MCP (RFC-0105) ([a4558d0](https://github.com/ManotLuijiu/pi-harness-runtime/commit/a4558d098c7b662b01d9502c8560219eafbf1941))
 * add okf-indexer package for SKILL.md indexing (RFC-0106) ([a3cc7da](https://github.com/ManotLuijiu/pi-harness-runtime/commit/a3cc7da0a390d5c8176d0d871418780facabcb5c))
 * extend a2a-adapter with discovery server (RFC-0104) ([0c4fc18](https://github.com/ManotLuijiu/pi-harness-runtime/commit/0c4fc1826fd55f10305bfbd894b32b5b55f1ab86))
 
-
 ### Bug Fixes
 
 * act on CONFLICTING immediately even when mergeStateStatus=DIRTY ([b7f290e](https://github.com/ManotLuijiu/pi-harness-runtime/commit/b7f290ece8e0e989635aacc456fffd4ee19183ec))
@@ -263,14 +248,12 @@ All notable changes to this project will be documented in this file. See [standa
 
 ## [0.10.0](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.9.24...v0.10.0) (2026-07-30)
 
-
 ### Features
 
 * blackboard-coordinated loop controller with early exit ([f3cf3ea](https://github.com/ManotLuijiu/pi-harness-runtime/commit/f3cf3ea479170dd75b7e9a7c3515dde230bb0da7))
 * herdr inter-agent event bus for autonomous code review ([1490cdd](https://github.com/ManotLuijiu/pi-harness-runtime/commit/1490cddec80dac812065c3c681984524ad3194e1))
 * loop controller for write-review cycles with early exit ([95066ce](https://github.com/ManotLuijiu/pi-harness-runtime/commit/95066ce8cb58c55eaa14d69fd826b5aaff680c16))
 
-
 ### Bug Fixes
 
 * **clipboard:** pass UTF-8 bytes directly to xclip via stdin, avoid pipeline corruption ([051ca18](https://github.com/ManotLuijiu/pi-harness-runtime/commit/051ca18fb1deb1169a8a4da16aa9314d2e6ec66d))
@@ -283,7 +266,6 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.9.25](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.9.21...v0.9.25) (2026-07-27)
 
-
 ### Bug Fixes
 
 * **ci:** explicitly list test files to exclude cookie auth tests in release workflow ([1c96002](https://github.com/ManotLuijiu/pi-harness-runtime/commit/1c9600232282a1ef9323300fbd763c962aff49f6))
@@ -294,7 +276,6 @@ All notable changes to this project will be documented in this file. See [standa
 
 ### [0.9.24](https://github.com/ManotLuijiu/pi-harness-runtime/compare/v0.9.21...v0.9.24) (2026-07-27)
 
-
 ### Bug Fixes
 
 * **ci:** skip browser auth tests in release workflow ([6117ed5](https://github.com/ManotLuijiu/pi-harness-runtime/commit/6117ed5af11357c6f12d11f4cd8d3441de519043))

package/footer-status.ts

@@ -6,6 +6,51 @@ import {
 	type ParsedContextWindowUsage,
 	type ParsedQuotaUsageData,
 } from "./status-parsers.ts";
+
+/**
+ * Format countdown seconds into a human-readable string for TUI display.
+ * Examples: "4h 32m", "45m 12s", "12s"
+ */
+export function formatCountdownForDisplay(seconds: number): string {
+	if (seconds <= 0) return "RESET";
+
+	const days = Math.floor(seconds / 86400);
+	const hours = Math.floor((seconds % 86400) / 3600);
+	const minutes = Math.floor((seconds % 3600) / 60);
+	const secs = seconds % 60;
+
+	if (days > 0) {
+		return `${days}d ${hours}h`;
+	}
+	if (hours > 0) {
+		return `${hours}h ${minutes}m`;
+	}
+	if (minutes > 0) {
+		return `${minutes}m ${secs}s`;
+	}
+	return `${secs}s`;
+}
+
+/**
+ * Build a TUI-signal exhaustion status line with optional countdown.
+ * This is used when a provider (like GLM) hits its limit.
+ */
+export function buildExhaustionStatusLine(
+	provider: string,
+	view: ProviderMirrorRecord,
+	countdownSeconds?: number,
+): string {
+	const label = providerDisplayName(provider);
+	const limitType = view.limitType ?? "tokens";
+	const reset = view.resets_at ?? view.h5_resets_at ?? "soon";
+
+	if (countdownSeconds !== undefined && countdownSeconds > 0) {
+		const countdown = formatCountdownForDisplay(countdownSeconds);
+		return `${label}: ⏳ ${countdown} (${limitType} hit)`;
+	}
+
+	return `${label}: limit hit (${limitType}), reset ${reset}`;
+}
 import { getProviderLabel } from "./packages/types/src/ai-providers.js";
 import {
 	providerHasContinuousScrape,
@@ -153,14 +198,14 @@ export function buildFooterStatusValue(
 		const weeklyResets = view.weekly_resets_at ?? "soon";
 
 		let statusLine: string;
-		if (view.h5_used_pct !== undefined) {
+		if (view.h5_used_pct === undefined) {
+			// OpenAI: weekly-only (no 5h window)
+			statusLine = `week: ${weeklyLeft.toFixed(0)}% left (resets ${weeklyResets})`;
+		} else {
 			// MiniMax: has both 5h and weekly windows
 			const h5Pct = view.h5_used_pct;
 			const h5Left = Math.max(0, 100 - h5Pct);
 			statusLine = `5h: ${h5Left.toFixed(0)}% left · week: ${weeklyLeft.toFixed(0)}% left`;
-		} else {
-			// OpenAI: weekly-only (no 5h window)
-			statusLine = `week: ${weeklyLeft.toFixed(0)}% left (resets ${weeklyResets})`;
 		}
 
 		const freshnessSuffix =

package/harness/glm-quota-countdown.test.ts

@@ -0,0 +1,323 @@
+/**
+ * GLM Quota Countdown Tests
+ *
+ * Run with: bun test harness/glm-quota-countdown.test.ts
+ */
+
+import { describe, it, expect, beforeEach, afterEach } from "bun:test";
+import {
+	parseGLMResetTime,
+	formatCountdown,
+	GLMQuotaCountdown,
+} from "./glm-quota-countdown.js";
+
+describe("parseGLMResetTime", () => {
+	it("parses full datetime format 'reset at 2026-08-25 01:47:16'", () => {
+		const result = parseGLMResetTime(
+			'Error: 429: {"code":"1308","message":"Usage limit reached for 5 hour. Your limit will reset at 2026-08-25 01:47:16"}',
+		);
+		expect(result).not.toBeNull();
+		const date = new Date(result!);
+		expect(date.getUTCFullYear()).toBe(2026);
+		expect(date.getUTCMonth()).toBe(7); // August is 7 (0-indexed)
+		expect(date.getUTCDate()).toBe(25);
+	});
+
+	it("parses full datetime format with T separator", () => {
+		const result = parseGLMResetTime(
+			"Your limit will reset at 2026-08-25T01:47:16",
+		);
+		expect(result).not.toBeNull();
+		const date = new Date(result!);
+		expect(date.getUTCFullYear()).toBe(2026);
+	});
+
+	it("parses time-only format when date is implied", () => {
+		const result = parseGLMResetTime("will reset at 14:30:00");
+		expect(result).not.toBeNull();
+		const date = new Date(result!);
+		expect(date.getUTCHours()).toBe(14);
+		expect(date.getUTCMinutes()).toBe(30);
+	});
+
+	it("returns null for non-GLM messages", () => {
+		expect(parseGLMResetTime("Hello world")).toBeNull();
+		expect(parseGLMResetTime("OpenAI rate limit exceeded")).toBeNull();
+	});
+
+	it("handles GLM error with code 1308", () => {
+		const result = parseGLMResetTime(
+			'{"code":"1308","message":"Usage limit reached for 5 hour. Your limit will reset at 2026-08-25 01:47:16"}',
+		);
+		expect(result).not.toBeNull();
+	});
+
+	it("parses alternative format 'reset at 2026-08-25 01:47:16'", () => {
+		const result = parseGLMResetTime(
+			"reset at 2026-08-25 01:47:16 - please retry later",
+		);
+		expect(result).not.toBeNull();
+	});
+});
+
+describe("formatCountdown", () => {
+	it("formats days, hours, minutes, seconds", () => {
+		expect(formatCountdown(90061)).toBe("1d 1h 1m 1s"); // 1 day, 1 hour, 1 min, 1 sec
+	});
+
+	it("formats hours and minutes when no days", () => {
+		expect(formatCountdown(3661)).toBe("1h 1m 1s");
+	});
+
+	it("formats minutes and seconds when no hours", () => {
+		expect(formatCountdown(125)).toBe("2m 5s");
+	});
+
+	it("formats seconds only when less than a minute", () => {
+		expect(formatCountdown(45)).toBe("45s");
+	});
+
+	it("returns 'RESET NOW' for zero or negative", () => {
+		expect(formatCountdown(0)).toBe("RESET NOW");
+		expect(formatCountdown(-100)).toBe("RESET NOW");
+	});
+
+	it("handles exactly 24 hours", () => {
+		expect(formatCountdown(86400)).toBe("1d 0h 0m 0s");
+	});
+
+	it("handles exactly 1 hour", () => {
+		expect(formatCountdown(3600)).toBe("1h 0m 0s");
+	});
+
+	it("handles exactly 1 minute", () => {
+		expect(formatCountdown(60)).toBe("1m 0s");
+	});
+});
+
+describe("GLMQuotaCountdown", () => {
+	let countdown: GLMQuotaCountdown;
+	let mockCheckpoint: any;
+	let mockTransition: any;
+	let mockReadProvider: any;
+
+	beforeEach(() => {
+		countdown = new GLMQuotaCountdown();
+
+		// Track calls for verification
+		mockCheckpoint = { jobId: "test-job", status: "paused_quota" };
+		mockTransition = { success: true };
+		mockReadProvider = null;
+	});
+
+	afterEach(() => {
+		countdown.dispose();
+	});
+
+	describe("hasCountdown / getCountdown", () => {
+		it("returns false initially for unknown job", () => {
+			expect(countdown.hasCountdown("unknown")).toBe(false);
+			expect(countdown.getCountdown("unknown")).toBeNull();
+		});
+	});
+
+	describe("startCountdown", () => {
+		it("starts countdown and stores state", async () => {
+			const futureDate = new Date(Date.now() + 3600000).toISOString(); // 1 hour from now
+			const mockMachine = createMockMachine(mockCheckpoint, mockTransition);
+			const mockMirror = createMockMirror(() => mockReadProvider, noopWrite);
+
+			const state = await countdown.startCountdown(
+				"job-1",
+				futureDate,
+				mockMirror,
+				mockMachine,
+			);
+
+			expect(state.jobId).toBe("job-1");
+			expect(state.resetAt).toBe(futureDate);
+			expect(state.totalSeconds).toBeGreaterThan(3500); // ~1 hour
+			expect(countdown.hasCountdown("job-1")).toBe(true);
+		});
+
+		it("cancels existing countdown before starting new one", async () => {
+			const futureDate1 = new Date(Date.now() + 3600000).toISOString();
+			const futureDate2 = new Date(Date.now() + 7200000).toISOString();
+			const mockMachine = createMockMachine(mockCheckpoint, mockTransition);
+			const mockMirror = createMockMirror(() => mockReadProvider, noopWrite);
+
+			await countdown.startCountdown(
+				"job-1",
+				futureDate1,
+				mockMirror,
+				mockMachine,
+			);
+
+			const state = await countdown.startCountdown(
+				"job-1",
+				futureDate2,
+				mockMirror,
+				mockMachine,
+			);
+
+			// Should have only one countdown
+			expect(countdown.getAllCountdowns().length).toBe(1);
+			expect(state.resetAt).toBe(futureDate2);
+		});
+
+		it("updates mirror store with reset time", async () => {
+			const futureDate = new Date(Date.now() + 3600000).toISOString();
+			const mockMachine = createMockMachine(mockCheckpoint, mockTransition);
+			let capturedRecord: any = null;
+			const mockMirror = createMockMirror(
+				() => mockReadProvider,
+				(_p, r) => {
+					capturedRecord = r;
+				},
+			);
+
+			await countdown.startCountdown("job-1", futureDate, mockMirror, mockMachine);
+
+			expect(capturedRecord).not.toBeNull();
+			expect(capturedRecord.provider).toBe("glm");
+			expect(capturedRecord.exhausted).toBe(true);
+			expect(capturedRecord.h5_resets_at).toBe(futureDate);
+		});
+	});
+
+	describe("startFromError", () => {
+		it("parses reset time from error message", async () => {
+			const errorMsg =
+				'Error: 429: {"code":"1308","message":"Usage limit reached for 5 hour. Your limit will reset at 2099-12-31 23:59:59"}';
+			const mockMachine = createMockMachine(mockCheckpoint, mockTransition);
+			const mockMirror = createMockMirror(() => mockReadProvider, noopWrite);
+
+			const state = await countdown.startFromError(
+				"job-1",
+				errorMsg,
+				mockMirror,
+				mockMachine,
+			);
+
+			expect(state).not.toBeNull();
+			expect(state!.jobId).toBe("job-1");
+			expect(countdown.hasCountdown("job-1")).toBe(true);
+		});
+
+		it("returns null when reset time cannot be parsed", async () => {
+			const mockMachine = createMockMachine(mockCheckpoint, mockTransition);
+			const mockMirror = createMockMirror(() => mockReadProvider, noopWrite);
+
+			const state = await countdown.startFromError(
+				"job-1",
+				"Some unrelated error message",
+				mockMirror,
+				mockMachine,
+			);
+
+			expect(state).toBeNull();
+		});
+	});
+
+	describe("cancelCountdown", () => {
+		it("cancels active countdown", async () => {
+			const futureDate = new Date(Date.now() + 3600000).toISOString();
+			const mockMachine = createMockMachine(mockCheckpoint, mockTransition);
+			const mockMirror = createMockMirror(() => mockReadProvider, noopWrite);
+
+			await countdown.startCountdown("job-1", futureDate, mockMirror, mockMachine);
+
+			expect(countdown.hasCountdown("job-1")).toBe(true);
+
+			countdown.cancelCountdown("job-1");
+
+			expect(countdown.hasCountdown("job-1")).toBe(false);
+		});
+
+		it("handles cancelling non-existent countdown", () => {
+			// Should not throw
+			expect(() => countdown.cancelCountdown("non-existent")).not.toThrow();
+		});
+	});
+
+	describe("onTick callback", () => {
+		it("receives tick events", async () => {
+			const ticks: any[] = [];
+			const futureDate = new Date(Date.now() + 3600000).toISOString();
+			const mockMachine = createMockMachine(mockCheckpoint, mockTransition);
+			const mockMirror = createMockMirror(() => mockReadProvider, noopWrite);
+
+			const unsubscribe = countdown.onTick((event) => {
+				ticks.push(event);
+			});
+
+			await countdown.startCountdown("job-1", futureDate, mockMirror, mockMachine);
+
+			// Wait a bit for initial tick
+			await new Promise((r) => setTimeout(r, 100));
+
+			expect(ticks.length).toBeGreaterThan(0);
+			expect(ticks[0].jobId).toBe("job-1");
+			expect(ticks[0].remainingFormatted).toBeDefined();
+
+			unsubscribe();
+		});
+	});
+
+	describe("getAllCountdowns", () => {
+		it("returns all active countdowns", async () => {
+			const futureDate = new Date(Date.now() + 3600000).toISOString();
+			const mockMachine = createMockMachine(mockCheckpoint, mockTransition);
+			const mockMirror = createMockMirror(() => mockReadProvider, noopWrite);
+
+			await countdown.startCountdown("job-1", futureDate, mockMirror, mockMachine);
+
+			await countdown.startCountdown("job-2", futureDate, mockMirror, mockMachine);
+
+			const all = countdown.getAllCountdowns();
+			expect(all.length).toBe(2);
+			expect(all.map((c) => c.jobId)).toContain("job-1");
+			expect(all.map((c) => c.jobId)).toContain("job-2");
+		});
+	});
+
+	describe("dispose", () => {
+		it("clears all timers and countdowns", async () => {
+			const futureDate = new Date(Date.now() + 3600000).toISOString();
+			const mockMachine = createMockMachine(mockCheckpoint, mockTransition);
+			const mockMirror = createMockMirror(() => mockReadProvider, noopWrite);
+
+			await countdown.startCountdown("job-1", futureDate, mockMirror, mockMachine);
+
+			await countdown.startCountdown("job-2", futureDate, mockMirror, mockMachine);
+
+			expect(countdown.getAllCountdowns().length).toBe(2);
+
+			countdown.dispose();
+
+			expect(countdown.getAllCountdowns().length).toBe(0);
+		});
+	});
+});
+
+// No-op write function for tests that don't need to verify write calls
+function noopWrite(_provider: string, _record: any): void {}
+
+// Helper: Create mock JobStateMachine
+function createMockMachine(getCheckpointResult: any, transitionResult: any) {
+	return {
+		getCheckpoint: () => getCheckpointResult,
+		transition: async () => transitionResult,
+	} as any;
+}
+
+// Helper: Create mock MirrorStore
+function createMockMirror(
+	readProviderFn: () => any,
+	writeProviderFn: (provider: string, record: any) => void,
+) {
+	return {
+		readProvider: readProviderFn,
+		writeProvider: writeProviderFn,
+	} as any;
+}