@gajae-code/coding-agent 0.11.10 → 0.11.11

package/src/modes/interactive-mode.ts

@@ -18,6 +18,7 @@ import chalk from "chalk";
 import { AsyncJobManager } from "../async";
 import {
 	type AppKeybinding,
+	defaultMessageQueueKeysForPlatform,
 	formatKeyHint,
 	formatKeyHints,
 	KeybindingsManager,
@@ -47,6 +48,7 @@ import type { SessionContext, SessionManager } from "../session/session-manager"
 import { getRecentSessions, getSessionMessageEntryId } from "../session/session-manager";
 import type { LspStartupServerInfo } from "../tools";
 import { formatPhaseDisplayName } from "../tools/todo-write";
+import { copyToClipboard } from "../utils/clipboard";
 import type { EventBus } from "../utils/event-bus";
 import { getSessionAccentAnsi, getSessionAccentHex } from "../utils/session-color";
 import { popTerminalTitle, pushTerminalTitle, setSessionTerminalTitle } from "../utils/title-generator";
@@ -113,16 +115,60 @@ import {
 import type { ParsedIrcMessage } from "./utils/irc-message";
 import { addChatChild, prepareTranscriptRebuild, UiHelpers } from "./utils/ui-helpers";
 
-export function getDefaultComposerPlaceholder(context: KeyDisplayContext = { platform: process.platform }): string {
+function buildComposerPlaceholder(
+	keybindings: Pick<KeybindingsManager, "getDisplayString">,
+	context: KeyDisplayContext,
+	options: { readonly busy: boolean; readonly busyPromptMode: "steer" | "queue" },
+): string {
+	const parts: string[] = [];
+	const submitKey = options.busy ? keybindings.getDisplayString("tui.input.submit", context) : "";
+	if (submitKey) {
+		const submitAction = options.busyPromptMode === "steer" ? "Steer" : "Queue";
+		parts.push(`${submitKey}: ${submitAction}`);
+	}
+
+	const queueKey = keybindings.getDisplayString("app.message.queue", context);
+	const submitQueues = options.busy && options.busyPromptMode === "queue" && submitKey;
+	if (queueKey && !submitQueues) parts.push(`${queueKey}: ${options.busy ? "Queue" : "Queue (busy)"}`);
+
+	const actionHints = [
+		["app.thinking.cycle", "Thinking"],
+		["app.model.select", "Model"],
+		["app.history.search", "History"],
+	] as const;
+	for (const [id, label] of actionHints) {
+		const key = keybindings.getDisplayString(id, context);
+		if (key) parts.push(`${key}: ${label}`);
+	}
+
 	const newlineKeys = context.platform === "win32" ? ["alt+enter", "ctrl+j"] : ["shift+enter", "ctrl+j"];
-	return `Type your message... ${formatKeyHints(newlineKeys, context)}: New line · ${formatKeyHint(
-		"ctrl+c",
-		context,
-	)}: Clear · ${formatKeyHint("ctrl+r", context)}: Search history · ${formatKeyHint("shift+tab", context)}: Reasoning`;
+	parts.push(`${formatKeyHints(newlineKeys, context)}: New line`, `${formatKeyHint("ctrl+c", context)}: Clear`);
+	return `Type your message... ${parts.join(" · ")}`;
+}
+
+export function getDefaultComposerPlaceholder(
+	context: KeyDisplayContext = { platform: process.platform },
+	keybindings?: Pick<KeybindingsManager, "getDisplayString">,
+): string {
+	const effectiveKeybindings =
+		keybindings ??
+		KeybindingsManager.inMemory({
+			"app.message.queue": defaultMessageQueueKeysForPlatform(context.platform),
+		});
+	return buildComposerPlaceholder(effectiveKeybindings, context, { busy: false, busyPromptMode: "steer" });
 }
 
 export const DEFAULT_COMPOSER_PLACEHOLDER = getDefaultComposerPlaceholder();
+
+export function getComposerPlaceholder(
+	keybindings: Pick<KeybindingsManager, "getDisplayString">,
+	context: KeyDisplayContext,
+	options: { readonly busy: boolean; readonly busyPromptMode: "steer" | "queue" },
+): string {
+	return buildComposerPlaceholder(keybindings, context, options);
+}
 const WELCOME_RESERVED_CONTAINER_CHILD_LIMIT = 8;
+const COMPOSER_RIGHT_GUTTER_WIDTH = 1;
 
 const IRC_SIDEBAR_TOGGLE_SHADOWING_ACTIONS: readonly AppKeybinding[] = [
 	"app.plan.toggle",
@@ -169,7 +215,7 @@ function configureDefaultComposerChrome(editor: CustomEditor): void {
 	editor.setInputPrefix(getDefaultInputPrefix());
 	editor.setPlaceholder(getDefaultComposerPlaceholder());
 	editor.setPaddingX(1);
-	editor.setRightGutterWidth(1);
+	editor.setRightGutterWidth(COMPOSER_RIGHT_GUTTER_WIDTH);
 	editor.setTopBorder(undefined);
 }
 
@@ -510,6 +556,14 @@ export class InteractiveMode implements InteractiveModeContext {
 
 		this.ui = new TUI(new ProcessTerminal(), settings.get("showHardwareCursor"), {
 			enableMouse: settings.get("mouse.enabled"),
+			copySelection: async text => {
+				try {
+					await copyToClipboard(text);
+					this.showStatus("Selection copied to clipboard");
+				} catch (error) {
+					this.showError(`Failed to copy selection: ${error instanceof Error ? error.message : String(error)}`);
+				}
+			},
 		});
 		this.ui.setClearOnShrink(settings.get("clearOnShrink"));
 		this.chatContainer = new Container();
@@ -660,6 +714,7 @@ export class InteractiveMode implements InteractiveModeContext {
 					getViewportRows: () => this.ui.terminal.rows,
 					getReservedBottomRows: getWelcomeReservedBottomRows,
 					changelogMarkdown: this.#changelogMarkdown,
+					rightGutterWidth: COMPOSER_RIGHT_GUTTER_WIDTH,
 					collapseChangelog: settings.get("collapseChangelog"),
 					keyDisplayContext: this.#keyDisplayContext,
 				},
@@ -1056,27 +1111,11 @@ export class InteractiveMode implements InteractiveModeContext {
 		return this.session.isStreaming || this.session.isCompacting;
 	}
 
-	#getFirstKeyForAction(action: AppKeybinding): string | undefined {
-		return this.keybindings.getKeys(action)[0];
-	}
-
-	#getMessageQueueShortcut(): string | undefined {
-		const preferredAction: AppKeybinding =
-			process.platform === "darwin" ? "app.message.followUp" : "app.message.queue";
-		const fallbackAction: AppKeybinding =
-			process.platform === "darwin" ? "app.message.queue" : "app.message.followUp";
-		return this.#getFirstKeyForAction(preferredAction) ?? this.#getFirstKeyForAction(fallbackAction);
-	}
-
 	#getComposerPlaceholder(): string {
-		const defaultPlaceholder = getDefaultComposerPlaceholder(this.#keyDisplayContext);
-		if (!this.#isPromptDeliveryBusy()) return defaultPlaceholder;
-		const submitAction = this.settings.get("busyPromptMode") === "steer" ? "Steer" : "Queue";
-		const submitKey = this.keybindings.getDisplayString("tui.input.submit", this.#keyDisplayContext);
-		const parts = submitKey ? [`${submitKey}: ${submitAction}`] : [];
-		const queueKey = this.#getMessageQueueShortcut();
-		if (queueKey) parts.push(`${formatKeyHint(queueKey, this.#keyDisplayContext)}: Queue`);
-		return parts.length > 0 ? `${defaultPlaceholder} · ${parts.join(" · ")}` : defaultPlaceholder;
+		return getComposerPlaceholder(this.keybindings, this.#keyDisplayContext, {
+			busy: this.#isPromptDeliveryBusy(),
+			busyPromptMode: this.settings.get("busyPromptMode"),
+		});
 	}
 
 	#getWelcomeReservedRows(width: number): number {

package/src/modes/runtime-init.ts

@@ -115,6 +115,7 @@ export async function initializeExtensions(session: AgentSession, options: Initi
 			compact: instructionsOrOptions => runExtensionCompact(session, instructionsOrOptions),
 			clearContext: () => session.clearContext(),
 			cycleModel: () => session.cycleModel(),
+			setModelProfile: name => session.activateModelProfileForControl(name),
 			cycleThinkingLevel: () => session.cycleThinkingLevel(),
 			setQueueMode: (kind, mode) => {
 				if (kind === "steering" && (mode === "all" || mode === "one-at-a-time")) {

package/src/prompts/agents/executor.md

@@ -34,7 +34,7 @@ Explore just enough context, implement the smallest correct change, and leave co
 {{#if ultragoalRedTeam}}
 
 <ultragoal_red_team_mode>
-This mode activates only when the assignment explicitly labels Executor as Ultragoal completion QA/red-team or asks for `executorQa` red-team evidence. Otherwise, preserve ordinary Executor behavior.
+This mode activates only when the task sets typed `executionMode: "ultragoal-red-team"`, or — as a compatibility fallback — when the assignment text explicitly labels Executor as Ultragoal completion QA/red-team or asks for `executorQa` red-team evidence (not a bare `executorQa` field-name mention). Prefer the typed flag. Otherwise, preserve ordinary Executor behavior.
 
 When active:
 - Follow the exact `executorQa` contract provided in the assignment (matrix shape, row fields, artifact/replay rules); the runtime validates it strictly. If the assignment omits the contract, read the ultragoal SKILL's executor QA section before producing evidence.

package/src/runtime/memory-domain.ts

@@ -0,0 +1,66 @@
+import type {
+	MemoryGuardDomainSnapshot,
+	MemoryGuardWorkerAccounting,
+	MemoryGuardWorkerSample,
+} from "./memory-guard-contract";
+
+export interface MemoryGuardDomainInput {
+	effectiveLimitBytes: number;
+	totalUsageBytes: number;
+	parentBytes: number;
+	parentReserveBytes: number;
+	workers: readonly MemoryGuardWorkerSample[];
+}
+
+function assertNonNegativeSafeInteger(name: string, value: number): number {
+	if (!Number.isSafeInteger(value) || value < 0) throw new Error(`invalid_${name}`);
+	return value;
+}
+
+function sumWorkerBytes(workers: readonly MemoryGuardWorkerSample[]): number {
+	let total = 0;
+	for (const worker of workers) {
+		total += assertNonNegativeSafeInteger(`worker_bytes:${worker.workerId}`, worker.bytes);
+		if (!Number.isSafeInteger(total)) throw new Error("invalid_worker_total_bytes");
+	}
+	return total;
+}
+
+export function computeMemoryGuardDomain(input: MemoryGuardDomainInput): MemoryGuardDomainSnapshot {
+	const effectiveLimitBytes = assertNonNegativeSafeInteger("effective_limit_bytes", input.effectiveLimitBytes);
+	const totalUsageBytes = assertNonNegativeSafeInteger("total_usage_bytes", input.totalUsageBytes);
+	const parentBytes = assertNonNegativeSafeInteger("parent_bytes", input.parentBytes);
+	const parentReserveBytes = assertNonNegativeSafeInteger("parent_reserve_bytes", input.parentReserveBytes);
+	const totalWorkerBytes = sumWorkerBytes(input.workers);
+	const acceptedWorkers = input.workers.filter(worker => worker.accepted !== false);
+	const acceptedWorkerBytes = sumWorkerBytes(acceptedWorkers);
+	const acceptedWorkerCount = acceptedWorkers.length;
+	const unmanagedBytes = Math.max(0, totalUsageBytes - parentBytes - acceptedWorkerBytes);
+	const headroomBytes = Math.max(0, effectiveLimitBytes - totalUsageBytes);
+	const workerBudgetBytes = Math.max(0, effectiveLimitBytes - unmanagedBytes - parentReserveBytes);
+	const perWorkerAllowanceBytes = acceptedWorkerCount === 0 ? 0 : workerBudgetBytes / acceptedWorkerCount;
+	const workers: MemoryGuardWorkerAccounting[] = input.workers.map(worker => {
+		const accepted = worker.accepted !== false;
+		return {
+			workerId: worker.workerId,
+			bytes: worker.bytes,
+			accepted,
+			allowanceBytes: accepted ? perWorkerAllowanceBytes : 0,
+			excessBytes: accepted ? Math.max(0, worker.bytes - perWorkerAllowanceBytes) : 0,
+		};
+	});
+	return {
+		effectiveLimitBytes,
+		totalUsageBytes,
+		parentBytes,
+		parentReserveBytes,
+		totalWorkerBytes,
+		acceptedWorkerCount,
+		unmanagedBytes,
+		headroomBytes,
+		workerBudgetBytes,
+		perWorkerAllowanceBytes,
+		hostExcessBytes: Math.max(0, parentBytes - parentReserveBytes),
+		workers,
+	};
+}

package/src/runtime/memory-guard-contract.ts

@@ -0,0 +1,73 @@
+export interface MemoryGuardPolicy {
+	enabled: boolean;
+	checkIntervalMs: number;
+	gcThresholdRatio: number;
+	restartThresholdRatio: number;
+	restartThresholdWindowMs: number;
+	cooldownMs: number;
+	parentReserveBytes: number;
+	policyLimitBytes: number | null;
+}
+
+export interface MemoryGuardWorkerSample {
+	workerId: string;
+	bytes: number;
+	accepted?: boolean;
+}
+
+export interface MemoryGuardWorkerAccounting {
+	workerId: string;
+	bytes: number;
+	accepted: boolean;
+	allowanceBytes: number;
+	excessBytes: number;
+}
+
+export interface MemoryGuardDomainSnapshot {
+	effectiveLimitBytes: number;
+	totalUsageBytes: number;
+	parentBytes: number;
+	parentReserveBytes: number;
+	totalWorkerBytes: number;
+	acceptedWorkerCount: number;
+	unmanagedBytes: number;
+	headroomBytes: number;
+	workerBudgetBytes: number;
+	perWorkerAllowanceBytes: number;
+	hostExcessBytes: number;
+	workers: MemoryGuardWorkerAccounting[];
+}
+
+export interface MemoryGuardHostTarget {
+	kind: "host";
+	excessBytes: number;
+}
+
+export interface MemoryGuardWorkerTarget {
+	kind: "worker";
+	workerId: string;
+	excessBytes: number;
+}
+
+export type MemoryGuardActionTarget = MemoryGuardHostTarget | MemoryGuardWorkerTarget;
+
+export type MemoryGuardNoopReason =
+	| "memory_guard_action_noop_unmanaged_or_within_allowance"
+	| "memory_guard_action_noop_unsupported";
+
+export type MemoryGuardDecision =
+	| { kind: "execute"; target: MemoryGuardActionTarget }
+	| { kind: "noop"; reason: MemoryGuardNoopReason }
+	| { kind: "revalidated_out"; reason: "memory_guard_action_revalidated_out" };
+
+export interface MemoryGuardSchedulerState {
+	timerActive: boolean;
+	registrationCount: number;
+	inProgress: boolean;
+	generation: number;
+	pendingDeadline: number | null;
+	pendingOwner: { generation: number; token: number } | null;
+	deferredDeadline: number | null;
+	deferredGeneration: number | null;
+	activeGeneration: number | null;
+}

package/src/runtime/memory-guard.ts

@@ -0,0 +1,292 @@
+import type { Settings } from "../config/settings";
+import type {
+	MemoryGuardActionTarget,
+	MemoryGuardDecision,
+	MemoryGuardDomainSnapshot,
+	MemoryGuardPolicy,
+	MemoryGuardSchedulerState,
+} from "./memory-guard-contract";
+
+const BYTES_PER_MB = 1024 * 1024;
+const DEFAULT_CHECK_INTERVAL_MS = 30_000;
+
+type ScheduleOwner = { generation: number; token: number };
+type DeferredSchedule = { generation: number; deadline: number };
+type WorkOwner = { generation: number; source: "timer" | "external" };
+
+export interface MemoryGuardHostRegistration {
+	ownerId: string;
+	intervalMs: number;
+}
+
+export interface MemoryGuardHostOptions {
+	run: () => Promise<void>;
+	logDebug?: (message: string, meta?: Record<string, unknown>) => void;
+	schedulerNow?: () => number;
+}
+
+function normalizePositiveIntervalMs(intervalMs: number): number {
+	if (!Number.isFinite(intervalMs) || intervalMs <= 0) throw new Error("invalid_interval_ms");
+	return intervalMs;
+}
+
+function toRatio(percent: number): number {
+	return percent / 100;
+}
+
+function mbToBytes(value: number): number {
+	return Math.round(value * BYTES_PER_MB);
+}
+
+function sortTargets(left: MemoryGuardActionTarget, right: MemoryGuardActionTarget): number {
+	if (left.excessBytes !== right.excessBytes) return right.excessBytes - left.excessBytes;
+	if (left.kind !== right.kind) return left.kind === "host" ? -1 : 1;
+	if (left.kind === "worker" && right.kind === "worker") return left.workerId.localeCompare(right.workerId);
+	return 0;
+}
+
+export function resolveMemoryGuardPolicy(settings: Settings): MemoryGuardPolicy {
+	const configuredPolicyLimitMb = settings.get("memoryGuard.policyLimitMb");
+	return {
+		enabled: settings.get("memoryGuard.enabled"),
+		checkIntervalMs: settings.get("memoryGuard.checkIntervalMs"),
+		gcThresholdRatio: toRatio(settings.get("memoryGuard.gcThresholdPercent")),
+		restartThresholdRatio: toRatio(settings.get("memoryGuard.restartThresholdPercent")),
+		restartThresholdWindowMs: settings.get("memoryGuard.restartThresholdWindowMs"),
+		cooldownMs: settings.get("memoryGuard.cooldownMs"),
+		parentReserveBytes: mbToBytes(settings.get("memoryGuard.parentReserveMb")),
+		policyLimitBytes: configuredPolicyLimitMb > 0 ? mbToBytes(configuredPolicyLimitMb) : null,
+	};
+}
+
+export function chooseMemoryGuardAction(input: {
+	domain: MemoryGuardDomainSnapshot;
+	hostSupported: boolean;
+	workerSupported: (workerId: string) => boolean;
+}): MemoryGuardDecision {
+	const candidates: MemoryGuardActionTarget[] = [];
+	if (input.hostSupported && input.domain.hostExcessBytes > 0) {
+		candidates.push({ kind: "host", excessBytes: input.domain.hostExcessBytes });
+	}
+	for (const worker of input.domain.workers) {
+		if (!worker.accepted || worker.excessBytes <= 0 || !input.workerSupported(worker.workerId)) continue;
+		candidates.push({ kind: "worker", workerId: worker.workerId, excessBytes: worker.excessBytes });
+	}
+	if (candidates.length > 0) {
+		candidates.sort(sortTargets);
+		return { kind: "execute", target: candidates[0]! };
+	}
+	const unsupportedExcessExists =
+		input.domain.hostExcessBytes > 0 ||
+		input.domain.workers.some(worker => worker.accepted && worker.excessBytes > 0);
+	if (unsupportedExcessExists) return { kind: "noop", reason: "memory_guard_action_noop_unsupported" };
+	return { kind: "noop", reason: "memory_guard_action_noop_unmanaged_or_within_allowance" };
+}
+
+export function revalidateMemoryGuardAction(
+	previous: Extract<MemoryGuardDecision, { kind: "execute" }>,
+	revalidated: MemoryGuardDecision,
+): MemoryGuardDecision {
+	if (revalidated.kind !== "execute")
+		return { kind: "revalidated_out", reason: "memory_guard_action_revalidated_out" };
+	if (previous.target.kind !== revalidated.target.kind)
+		return { kind: "revalidated_out", reason: "memory_guard_action_revalidated_out" };
+	if (
+		previous.target.kind === "worker" &&
+		revalidated.target.kind === "worker" &&
+		previous.target.workerId !== revalidated.target.workerId
+	) {
+		return { kind: "revalidated_out", reason: "memory_guard_action_revalidated_out" };
+	}
+	return revalidated;
+}
+
+export class MemoryGuardHost {
+	#run: () => Promise<void>;
+	#logDebug: (message: string, meta?: Record<string, unknown>) => void;
+	#defaultSchedulerNow: () => number;
+	#schedulerNow: () => number;
+	#registrations = new Map<string, { intervalMs: number; nextDueMs: number }>();
+	#pendingTimer: NodeJS.Timeout | null = null;
+	#pendingDeadline: number | null = null;
+	#pendingOwner: ScheduleOwner | null = null;
+	#deferredSchedule: DeferredSchedule | null = null;
+	#inProgressOwner: WorkOwner | null = null;
+	#stopped = false;
+	#generation = 0;
+	#nextTimerToken = 0;
+
+	constructor(options: MemoryGuardHostOptions) {
+		this.#run = options.run;
+		this.#logDebug = options.logDebug ?? (() => undefined);
+		this.#defaultSchedulerNow = options.schedulerNow ?? (() => performance.now());
+		this.#schedulerNow = this.#defaultSchedulerNow;
+	}
+
+	register(registration: MemoryGuardHostRegistration): () => void {
+		const intervalMs = normalizePositiveIntervalMs(registration.intervalMs);
+		const now = this.#schedulerNow();
+		const existing = this.#registrations.get(registration.ownerId);
+		const isNewRegistration = !existing;
+		const nextDueMs = existing ? Math.min(existing.nextDueMs, now + intervalMs) : now + intervalMs;
+		this.#registrations.set(registration.ownerId, { intervalMs, nextDueMs });
+		this.#stopped = false;
+		if (isNewRegistration) {
+			const deadline = nextDueMs;
+			if (
+				this.#inProgressOwner?.generation === this.#generation &&
+				(this.#pendingDeadline === null || this.#pendingDeadline <= deadline)
+			) {
+				this.#deferSchedule(this.#generation, deadline);
+			} else {
+				this.#requestSchedule(deadline);
+			}
+		}
+		let unregistered = false;
+		return () => {
+			if (unregistered) return;
+			unregistered = true;
+			this.#registrations.delete(registration.ownerId);
+			if (this.#registrations.size === 0) this.#stop();
+		};
+	}
+
+	updateInterval(ownerId: string, intervalMs: number): void {
+		const existing = this.#registrations.get(ownerId);
+		if (!existing) return;
+		const normalized = normalizePositiveIntervalMs(intervalMs);
+		if (existing.intervalMs === normalized) return;
+		const now = this.#schedulerNow();
+		const nextDueMs = now + normalized;
+		this.#registrations.set(ownerId, { intervalMs: normalized, nextDueMs });
+		if (this.#inProgressOwner) return;
+		const nextDeadline = this.#nextDeadlineMs();
+		if (this.#pendingDeadline !== null && nextDeadline > this.#pendingDeadline) {
+			this.#clearPendingSchedule();
+		}
+		this.#requestSchedule(nextDeadline);
+	}
+
+	async runTick(generation = this.#generation, source: WorkOwner["source"] = "external"): Promise<void> {
+		if (this.#inProgressOwner || this.#registrations.size === 0) return;
+		const owner: WorkOwner = { generation, source };
+		this.#inProgressOwner = owner;
+		try {
+			await this.#run();
+		} catch (error) {
+			this.#logDebug("memory guard tick failed", { error: error instanceof Error ? error.message : String(error) });
+		} finally {
+			if (this.#inProgressOwner === owner) this.#inProgressOwner = null;
+			this.#advanceDueTimes();
+			this.#reconcileCurrentSchedule();
+		}
+	}
+
+	async runTimerCallbackForTest(owner: { generation: number; token: number }, deadline: number): Promise<void> {
+		await this.#handleTimerCallback(owner, deadline);
+	}
+
+	setSchedulerNowForTest(now: () => number): void {
+		this.#schedulerNow = now;
+	}
+
+	getStateForTest(): MemoryGuardSchedulerState {
+		return {
+			timerActive: this.#pendingTimer !== null,
+			registrationCount: this.#registrations.size,
+			inProgress: this.#inProgressOwner !== null,
+			generation: this.#generation,
+			pendingDeadline: this.#pendingDeadline,
+			pendingOwner: this.#pendingOwner ? { ...this.#pendingOwner } : null,
+			deferredDeadline: this.#deferredSchedule?.deadline ?? null,
+			deferredGeneration: this.#deferredSchedule?.generation ?? null,
+			activeGeneration: this.#inProgressOwner?.generation ?? null,
+		};
+	}
+
+	resetForTest(): void {
+		this.#stop();
+		this.#registrations.clear();
+		this.#inProgressOwner = null;
+		this.#deferredSchedule = null;
+		this.#nextTimerToken = 0;
+		this.#schedulerNow = this.#defaultSchedulerNow;
+	}
+
+	#nextDeadlineMs(): number {
+		let minDue = Number.POSITIVE_INFINITY;
+		for (const reg of this.#registrations.values()) {
+			minDue = Math.min(minDue, reg.nextDueMs);
+		}
+		return Number.isFinite(minDue) ? minDue : this.#schedulerNow() + DEFAULT_CHECK_INTERVAL_MS;
+	}
+
+	#advanceDueTimes(): void {
+		const now = this.#schedulerNow();
+		for (const reg of this.#registrations.values()) {
+			if (reg.nextDueMs <= now) {
+				reg.nextDueMs = now + reg.intervalMs;
+			}
+		}
+	}
+
+	#clearPendingSchedule(): void {
+		if (this.#pendingTimer) clearTimeout(this.#pendingTimer);
+		this.#pendingTimer = null;
+		this.#pendingDeadline = null;
+		this.#pendingOwner = null;
+	}
+
+	#requestSchedule(deadline: number): void {
+		if (this.#stopped || this.#registrations.size === 0) return;
+		if (this.#pendingDeadline !== null && this.#pendingDeadline <= deadline) return;
+		this.#clearPendingSchedule();
+		const owner = { generation: this.#generation, token: ++this.#nextTimerToken };
+		this.#pendingDeadline = deadline;
+		this.#pendingOwner = owner;
+		this.#pendingTimer = setTimeout(
+			() => {
+				void this.#handleTimerCallback(owner, deadline);
+			},
+			Math.max(0, deadline - this.#schedulerNow()),
+		);
+		this.#pendingTimer.unref?.();
+	}
+
+	#deferSchedule(generation: number, deadline: number): void {
+		if (generation !== this.#generation) return;
+		if (this.#deferredSchedule?.generation === generation) {
+			this.#deferredSchedule.deadline = Math.min(this.#deferredSchedule.deadline, deadline);
+			return;
+		}
+		this.#deferredSchedule = { generation, deadline };
+	}
+
+	async #handleTimerCallback(owner: ScheduleOwner, deadline: number): Promise<void> {
+		if (this.#pendingOwner?.generation !== owner.generation || this.#pendingOwner.token !== owner.token) return;
+		this.#pendingTimer = null;
+		this.#pendingDeadline = null;
+		this.#pendingOwner = null;
+		if (this.#inProgressOwner) {
+			this.#deferSchedule(owner.generation, deadline);
+			return;
+		}
+		await this.runTick(owner.generation, "timer");
+	}
+
+	#reconcileCurrentSchedule(): void {
+		if (this.#stopped || this.#registrations.size === 0 || this.#inProgressOwner) return;
+		const normalDeadline = this.#nextDeadlineMs();
+		const deferredDeadline =
+			this.#deferredSchedule?.generation === this.#generation ? this.#deferredSchedule.deadline : null;
+		if (deferredDeadline !== null) this.#deferredSchedule = null;
+		this.#requestSchedule(deferredDeadline === null ? normalDeadline : Math.min(deferredDeadline, normalDeadline));
+	}
+
+	#stop(): void {
+		this.#stopped = true;
+		this.#generation++;
+		this.#clearPendingSchedule();
+		this.#deferredSchedule = null;
+	}
+}

package/src/runtime/memory-limit.ts

@@ -0,0 +1,50 @@
+export interface EffectiveMemoryLimitInput {
+	hardCapBytes?: number | null;
+	policyLimitBytes?: number | null;
+}
+
+export interface EffectiveMemoryLimit {
+	hardCapBytes: number | null;
+	policyLimitBytes: number | null;
+	effectiveBytes: number | null;
+	source: "none" | "hard_cap" | "policy_limit" | "hard_cap_and_policy_limit";
+}
+
+function normalizePositiveByteCount(value: number | null | undefined): number | null {
+	return Number.isSafeInteger(value) && typeof value === "number" && value > 0 ? value : null;
+}
+
+export function resolveEffectiveMemoryLimit(input: EffectiveMemoryLimitInput): EffectiveMemoryLimit {
+	const hardCapBytes = normalizePositiveByteCount(input.hardCapBytes);
+	const policyLimitBytes = normalizePositiveByteCount(input.policyLimitBytes);
+	if (hardCapBytes !== null && policyLimitBytes !== null) {
+		return {
+			hardCapBytes,
+			policyLimitBytes,
+			effectiveBytes: Math.min(hardCapBytes, policyLimitBytes),
+			source: "hard_cap_and_policy_limit",
+		};
+	}
+	if (hardCapBytes !== null) {
+		return {
+			hardCapBytes,
+			policyLimitBytes: null,
+			effectiveBytes: hardCapBytes,
+			source: "hard_cap",
+		};
+	}
+	if (policyLimitBytes !== null) {
+		return {
+			hardCapBytes: null,
+			policyLimitBytes,
+			effectiveBytes: policyLimitBytes,
+			source: "policy_limit",
+		};
+	}
+	return {
+		hardCapBytes: null,
+		policyLimitBytes: null,
+		effectiveBytes: null,
+		source: "none",
+	};
+}