@gajae-code/coding-agent 0.11.11 → 0.12.1

package/src/modes/controllers/input-controller.ts

@@ -2044,9 +2044,24 @@ export class InputController {
 	}
 
 	toggleThinkingBlockVisibility(): void {
-		this.ctx.hideThinkingBlock = !this.ctx.hideThinkingBlock;
-		settings.set("hideThinkingBlock", this.ctx.hideThinkingBlock);
-		this.ctx.session.agent.hideThinkingSummary = this.ctx.hideThinkingBlock;
+		if (!settings.canWriteDurableConfig()) {
+			this.ctx.showError(
+				"Cannot change settings while config.yml has invalid YAML syntax. Repair config.yml and reload settings.",
+			);
+			return;
+		}
+		const hideThinkingBlock = !this.ctx.hideThinkingBlock;
+		try {
+			settings.set("hideThinkingBlock", hideThinkingBlock);
+		} catch (error) {
+			if (!settings.canWriteDurableConfig()) {
+				this.ctx.showError(error instanceof Error ? error.message : String(error));
+				return;
+			}
+			throw error;
+		}
+		this.ctx.hideThinkingBlock = hideThinkingBlock;
+		this.ctx.session.setThinkingVisibility(hideThinkingBlock ? "hidden" : "visible");
 
 		// Rebuild chat from session messages
 		// Detach the live streaming component before the disposing clear() so the

package/src/modes/controllers/selector-controller.ts

@@ -30,6 +30,7 @@ import {
 	getPluginsCacheDir,
 	MarketplaceManager,
 } from "../../extensibility/plugins/marketplace";
+import { INTERACTIVE_SELECTOR_RESUME_ORIGIN } from "../../extensibility/shared-events";
 import {
 	getAvailableThemes,
 	getCurrentThemeName,
@@ -129,6 +130,7 @@ import { CustomProviderWizardComponent, type CustomProviderWizardSubmit } from "
 import { ExtensionDashboard } from "../components/extensions";
 import type { PetMode } from "../components/gajae-pet-widget";
 import { HistorySearchComponent } from "../components/history-search";
+import { HookSelectorComponent } from "../components/hook-selector";
 import { JobsOverlayComponent } from "../components/jobs-overlay";
 import { ModelSelectorComponent } from "../components/model-selector";
 import type {
@@ -165,6 +167,7 @@ import type { JobsObserver } from "../jobs-observer";
 import type { SessionObserverRegistry } from "../session-observer-registry";
 import type { TasksAggregator } from "../tasks-aggregator";
 import type { TranscriptItemRegistry } from "../transcript-item-registry";
+import { acquireResumeProgressLease } from "../utils/ui-helpers";
 
 const CALLBACK_SERVER_PROVIDERS = new Set<string>([
 	"anthropic",
@@ -349,6 +352,7 @@ export function createNotificationsEditorOperations(
 					richDraftEnabled: config.richDraft.enabled,
 					toolActivityEnabled: config.toolActivity.enabled,
 					streamingEnabled: config.streaming.enabled,
+					sound: config.sound,
 				},
 			};
 		},
@@ -722,6 +726,7 @@ export function createNotificationsEditorOperations(
 						{ path: "notifications.redact", op: "set", value: preferences.redact },
 						{ path: "notifications.verbosity", op: "set", value: preferences.verbosity },
 						{ path: "notifications.sessionScope", op: "set", value: preferences.sessionScope },
+						{ path: "notifications.telegram.sound", op: "set", value: preferences.sound },
 						{ path: "notifications.telegram.rich.enabled", op: "set", value: preferences.richEnabled },
 						{ path: "notifications.telegram.richDraft.enabled", op: "set", value: preferences.richDraftEnabled },
 						{ path: "notifications.telegram.streaming.enabled", op: "set", value: preferences.streamingEnabled },
@@ -1151,6 +1156,12 @@ export class SelectorController {
 		);
 		if (scope === undefined) return;
 		const persistDefault = scope.trim().toLowerCase() === "default";
+		if (persistDefault && !this.ctx.settings.canWriteDurableConfig()) {
+			this.ctx.showError(
+				"Cannot change settings while config.yml has invalid YAML syntax. Repair config.yml and reload settings.",
+			);
+			return;
+		}
 
 		const imageProvider = normalized as
 			| "auto"
@@ -1224,13 +1235,18 @@ export class SelectorController {
 			const selector = new ThinkingSelectorComponent(
 				this.ctx.session.thinkingLevel,
 				availableLevels,
-				selection => {
-					done();
-
+				async selection => {
 					const { level, persistDefault } = selection;
 					const configuredDefault = this.ctx.settings.get("defaultThinkingLevel");
 					const levelToApply = level === ThinkingLevel.Inherit ? configuredDefault : level;
-					this.ctx.session.setThinkingLevel(levelToApply, persistDefault);
+					try {
+						await this.ctx.session.setThinkingLevelForControl(level, persistDefault);
+					} catch (error) {
+						this.ctx.showError(error instanceof Error ? error.message : String(error));
+						return;
+					}
+					done();
+
 					const effectiveLevel = this.ctx.session.thinkingLevel ?? ThinkingLevel.Off;
 					const requestedLabel =
 						level === ThinkingLevel.Inherit ? `${level} (configured default: ${configuredDefault})` : level;
@@ -1267,9 +1283,12 @@ export class SelectorController {
 						availableThemes,
 						availableModelProfiles: [...this.ctx.session.modelRegistry.getModelProfiles().keys()],
 						cwd: getProjectDir(),
+						gjcRuntimeSnapshot: this.ctx.session.gjcRuntimeSnapshot,
+						gjcActivationGeneration: this.ctx.session.gjcActivationGeneration,
 					},
 					{
 						onChange: (id, value) => this.handleSettingChange(id, value),
+						onError: message => this.ctx.showError(message),
 						onThemePreview: themeName => {
 							return previewTheme(themeName).then(result => {
 								if (!result.success && result.error && !isThemePreviewSuperseded(result)) {
@@ -1289,6 +1308,7 @@ export class SelectorController {
 						onPetPreview: mode => {
 							this.ctx.previewPetMode(mode as PetMode);
 						},
+						onPetCommit: mode => this.ctx.commitPetPreviewMode(mode as PetMode),
 						onStatusLinePreview: previewSettings => {
 							// Update status line with preview settings
 							this.ctx.statusLine.updateSettings({
@@ -1332,24 +1352,40 @@ export class SelectorController {
 		getAvailableThemes().then(availableThemes => {
 			const initialTheme = getCurrentThemeName() ?? "red-claw";
 			this.showSelector(done => {
+				const restoreAndClose = () => {
+					void restoreThemePreview(initialTheme).then(result => {
+						if (!result.success && result.error) {
+							this.ctx.showError(`Failed to restore theme preview: ${result.error}`);
+						}
+						this.#refreshThemeUi();
+					});
+					done();
+				};
 				const selector = new ThemeSelectorComponent(
 					initialTheme,
 					availableThemes,
 					themeName => {
-						const settingPath = getDetectedThemeSettingsPath();
-						settings.set(settingPath, themeName);
-						this.#refreshThemeUi();
-						done();
-					},
-					() => {
-						void restoreThemePreview(initialTheme).then(result => {
-							if (!result.success && result.error) {
-								this.ctx.showError(`Failed to restore theme preview: ${result.error}`);
+						if (!settings.canWriteDurableConfig()) {
+							this.ctx.showError(
+								"Cannot change settings while config.yml has invalid YAML syntax. Repair config.yml and reload settings.",
+							);
+							restoreAndClose();
+							return;
+						}
+						try {
+							settings.set(getDetectedThemeSettingsPath(), themeName);
+						} catch (error) {
+							if (!settings.canWriteDurableConfig()) {
+								this.ctx.showError(error instanceof Error ? error.message : String(error));
+								restoreAndClose();
+								return;
 							}
-							this.#refreshThemeUi();
-						});
+							throw error;
+						}
+						this.#refreshThemeUi();
 						done();
 					},
+					restoreAndClose,
 					themeName => {
 						void previewTheme(themeName).then(result => {
 							if (!result.success && result.error) {
@@ -1373,8 +1409,9 @@ export class SelectorController {
 			const selector = new PetSelectorComponent(
 				initial,
 				mode => {
-					this.ctx.setPetMode(mode);
-					done();
+					if (this.ctx.setPetMode(mode)) {
+						done();
+					}
 				},
 				() => {
 					this.ctx.previewPetMode(initial);
@@ -2262,28 +2299,82 @@ export class SelectorController {
 	async handleResumeSession(sessionPath: string): Promise<void> {
 		const previousSessionId = this.ctx.sessionManager.getSessionId();
 		this.#clearTransientSessionUi();
-		const migrationPolicy =
-			this.ctx.settings?.get("session.directoryMigration") === "disabled" ? "disabled" : "copy-retain";
-		let writableSessionPath = sessionPath;
-		if (this.ctx.sessionManager.isManagedDestination()) {
-			const inspection = await SessionManager.inspectSessionTailReadOnly(sessionPath);
-			if (inspection.kind === "error") throw new Error(`Could not inspect selected session: ${inspection.reason}`);
-			writableSessionPath = await this.ctx.sessionManager.prepareManagedCandidateForStrictAdoption(
-				sessionPath,
-				migrationPolicy,
-				inspection.identity,
+		const progressLease = acquireResumeProgressLease(this.ctx);
+		try {
+			await progressLease.committed;
+			const migrationPolicy =
+				this.ctx.settings?.get("session.directoryMigration") === "disabled" ? "disabled" : "copy-retain";
+			let writableSessionPath = sessionPath;
+			if (this.ctx.sessionManager.isManagedDestination()) {
+				const inspection = await SessionManager.inspectSessionTailReadOnly(sessionPath);
+				if (inspection.kind === "error")
+					throw new Error(`Could not inspect selected session: ${inspection.reason}`);
+				writableSessionPath = await this.ctx.sessionManager.prepareManagedCandidateForStrictAdoption(
+					sessionPath,
+					migrationPolicy,
+					inspection.identity,
+				);
+			}
+			// Switch session via AgentSession (emits hook and tool session events)
+			if (
+				!(await this.ctx.session.switchSession(writableSessionPath, {
+					transition: { origin: INTERACTIVE_SELECTOR_RESUME_ORIGIN },
+				}))
+			)
+				return;
+			const switchingToDifferentSession = previousSessionId !== this.ctx.sessionManager.getSessionId();
+			if (switchingToDifferentSession) this.ctx.resetIrcSidebarSession();
+			this.#refreshSessionTerminalTitle();
+			this.ctx.updateEditorBorderColor();
+
+			this.ctx.rebuildInitialMessages(
+				switchingToDifferentSession ? "replace-identity" : "reconcile-same-transcript",
 			);
+			await this.ctx.reloadTodos();
+			this.ctx.showStatus("Resumed session");
+			this.#maybePromptResumeModelChoice();
+		} finally {
+			progressLease.clear();
 		}
-		// Switch session via AgentSession (emits hook and tool session events)
-		if (!(await this.ctx.session.switchSession(writableSessionPath))) return;
-		const switchingToDifferentSession = previousSessionId !== this.ctx.sessionManager.getSessionId();
-		if (switchingToDifferentSession) this.ctx.resetIrcSidebarSession();
-		this.#refreshSessionTerminalTitle();
-		this.ctx.updateEditorBorderColor();
+	}
 
-		this.ctx.rebuildInitialMessages(switchingToDifferentSession ? "replace-identity" : "reconcile-same-transcript");
-		await this.ctx.reloadTodos();
-		this.ctx.showStatus("Resumed session");
+	/**
+	 * When `session.resumeModelBehavior` is "ask", offer a one-shot choice after
+	 * resuming: keep the model the session was last using, or switch to whatever
+	 * `modelRoles.default` currently resolves to. No-op if the setting is unset,
+	 * the two models already match, or either model can't be resolved.
+	 */
+	#maybePromptResumeModelChoice(): void {
+		if (this.ctx.settings?.get("session.resumeModelBehavior") !== "ask") return;
+		const sessionModel = this.ctx.session.model;
+		const currentDefault = this.ctx.session.resolveConfiguredDefaultModel?.();
+		if (!sessionModel || !currentDefault) return;
+		if (sessionModel.provider === currentDefault.provider && sessionModel.id === currentDefault.id) return;
+
+		this.showSelector(done => {
+			const selector = new HookSelectorComponent(
+				`This session last used ${sessionModel.provider}/${sessionModel.id}.\n` +
+					`Current default model is ${currentDefault.provider}/${currentDefault.id}.`,
+				[`Keep ${sessionModel.id}`, `Use ${currentDefault.id}`],
+				async (option: string) => {
+					done();
+					if (option === `Use ${currentDefault.id}`) {
+						try {
+							await this.ctx.session.setModel(currentDefault);
+							this.ctx.showStatus(`Switched to ${currentDefault.provider}/${currentDefault.id}`);
+						} catch (err) {
+							this.ctx.showError(err instanceof Error ? err.message : String(err));
+						}
+					}
+					this.ctx.ui.requestRender();
+				},
+				() => {
+					done();
+					this.ctx.ui.requestRender();
+				},
+			);
+			return { component: selector, focus: selector };
+		});
 	}
 
 	async handleSessionDeleteCommand(): Promise<void> {

package/src/modes/interactive-mode.ts

@@ -61,7 +61,7 @@ import { GajaePetWidget, type PetMode } from "./components/gajae-pet-widget";
 import type { HookEditorComponent } from "./components/hook-editor";
 import type { HookInputComponent } from "./components/hook-input";
 import type { HookSelectorComponent } from "./components/hook-selector";
-import { IrcSplitViewComponent } from "./components/irc-sidebar";
+import { computeIrcSplitWidths, getIrcSidebarSemanticToken, IrcSplitViewComponent } from "./components/irc-sidebar";
 import {
 	getPetUnavailableWarning,
 	isPetAvailable,
@@ -416,6 +416,9 @@ export class InteractiveMode implements InteractiveModeContext {
 	#sttController: SttModeController | undefined;
 	#resizeHandler?: () => void;
 	#observerRegistry: SessionObserverRegistry;
+	#viewportOutputRevision = 0n;
+	#viewportOutputIdentity: string;
+
 	#transcriptRegistry = new TranscriptItemRegistry();
 
 	/** Direct controller capabilities for consumers that coordinate mode transitions. */
@@ -484,6 +487,8 @@ export class InteractiveMode implements InteractiveModeContext {
 		this.mcpManager = mcpManager;
 		this.#eventBus = eventBus;
 		this.#keyDisplayContext = keyDisplayContext;
+		this.#viewportOutputIdentity = `session:${this.sessionManager.getSessionId()}`;
+
 		this.keybindings.setDisplayContext(this.#keyDisplayContext);
 		const thisMode = this;
 		this.#goalModeController = new GoalModeController({
@@ -738,6 +743,11 @@ export class InteractiveMode implements InteractiveModeContext {
 		this.ui.addChild(this.hookWidgetContainerBelow);
 		this.ui.setBottomPinnedComponent(this.statusLine);
 		this.ui.setFocus(this.editor);
+		this.ui.setViewportOutputSource({
+			identity: this.#viewportOutputIdentity,
+			revision: this.#viewportOutputRevision,
+		});
+
 		this.petWidget?.dispose();
 		this.petWidget = this.#createPetWidget(this.editor);
 		const configuredPetMode = settings.get("pet.mode");
@@ -770,6 +780,12 @@ export class InteractiveMode implements InteractiveModeContext {
 
 		this.#inputController.setupKeyHandlers();
 		this.#inputController.setupEditorSubmitHandler();
+		this.editor.onViewportPageScroll = direction => {
+			this.ui.scrollViewportPages(direction);
+		};
+		this.editor.onViewportFollowLive = () => {
+			this.ui.followLiveViewport();
+		};
 
 		// Wire observer registry to EventBus
 		if (this.#eventBus) {
@@ -891,6 +907,7 @@ export class InteractiveMode implements InteractiveModeContext {
 		// Set up theme file watcher
 		onThemeChange(() => {
 			clearRenderCache();
+			this.#ircSplitView.invalidateTheme();
 			configureDefaultComposerChrome(this.editor);
 			this.editor.setPlaceholder(this.#getComposerPlaceholder());
 			this.ui.invalidate();
@@ -1132,6 +1149,7 @@ export class InteractiveMode implements InteractiveModeContext {
 			this.statusLine,
 			this.hookWidgetContainerAbove,
 			this.editorContainer,
+			this.petFloorContainer,
 			this.hookWidgetContainerBelow,
 		].reduce((rows, component) => rows + component.render(width).length, 0);
 
@@ -1199,8 +1217,22 @@ export class InteractiveMode implements InteractiveModeContext {
 			this.ui.requestRender();
 			return false;
 		}
+		if (!settings.canWriteDurableConfig()) {
+			this.showError(
+				"Cannot change settings while config.yml has invalid YAML syntax. Repair config.yml and reload settings.",
+			);
+			return false;
+		}
+		try {
+			settings.set("pet.mode", mode);
+		} catch (error) {
+			if (!settings.canWriteDurableConfig()) {
+				this.showError(error instanceof Error ? error.message : String(error));
+				return false;
+			}
+			throw error;
+		}
 		apply(mode);
-		settings.set("pet.mode", mode);
 		this.ui.requestRender();
 		return true;
 	}
@@ -1499,6 +1531,12 @@ export class InteractiveMode implements InteractiveModeContext {
 
 		this.#inputController.setupKeyHandlers();
 		this.#inputController.setupEditorSubmitHandler();
+		this.editor.onViewportPageScroll = direction => {
+			this.ui.scrollViewportPages(direction);
+		};
+		this.editor.onViewportFollowLive = () => {
+			this.ui.followLiveViewport();
+		};
 
 		void this.refreshSlashCommandState().catch(error => {
 			logger.warn("Failed to refresh slash command state for custom editor", { error: String(error) });
@@ -1649,6 +1687,21 @@ export class InteractiveMode implements InteractiveModeContext {
 		return this.#uiHelpers.isKnownSlashCommand(text);
 	}
 
+	/** Advances the sticky-viewport source only for semantic transcript output. */
+	recordVisibleTranscriptMutation(): void {
+		const identity = `session:${this.sessionManager.getSessionId()}`;
+		if (identity !== this.#viewportOutputIdentity) {
+			this.#viewportOutputIdentity = identity;
+			this.#viewportOutputRevision = 0n;
+		} else {
+			this.#viewportOutputRevision += 1n;
+		}
+		this.ui.setViewportOutputSource({
+			identity: this.#viewportOutputIdentity,
+			revision: this.#viewportOutputRevision,
+		});
+	}
+
 	addMessageToChat(message: AgentMessage, options?: { populateHistory?: boolean }): Component[] {
 		return this.#uiHelpers.addMessageToChat(message, options);
 	}
@@ -2176,12 +2229,18 @@ export class InteractiveMode implements InteractiveModeContext {
 	}
 
 	resetIrcSidebarSession(): void {
-		this.ircLedger.reset();
+		const sidebarVisible = this.#ircSplitView.effectiveSidebarVisible(this.ui.terminal.columns);
+		const rightWidth = computeIrcSplitWidths(this.ui.terminal.columns).rightWidth;
+		const beforeToken = sidebarVisible ? getIrcSidebarSemanticToken(this.ircLedger, rightWidth) : "";
+		this.ircLedger.reset({ retireCurrentSessionIdentities: true });
+		this.#ircSplitView.resetSource();
+		const afterToken = sidebarVisible ? getIrcSidebarSemanticToken(this.ircLedger, rightWidth) : "";
 		this.#eventController.resetIrcObservations();
 		this.#ircSidebarRequestedVisible = false;
 		this.#ircSplitView.setVisible(false);
 		this.#uiHelpers.resetIrcSidebarHint();
 		this.#syncIrcSidebarAvailabilityFromSettings();
+		if (sidebarVisible && beforeToken !== afterToken) this.recordVisibleTranscriptMutation();
 	}
 
 	#invalidateIrcSidebarRender(): void {

package/src/modes/irc-observation-ledger.ts

@@ -4,9 +4,26 @@ import type { ParsedIrcMessage } from "./utils/irc-message";
 
 type InlineMode = "persistent" | "ephemeral";
 
-const MAX_RECORDS = 10_000;
-const MAX_RETAINED_UTF8_BYTES = 16 * 1024 * 1024;
-const MAX_SEEN_IDENTITIES = 100_000;
+export const IRC_OBSERVATION_LEDGER_MAX_RECORDS = 10_000;
+export const IRC_OBSERVATION_LEDGER_MAX_RETAINED_UTF8_BYTES = 16 * 1024 * 1024;
+export const IRC_OBSERVATION_LEDGER_MAX_SEEN_IDENTITIES = 100_000;
+
+export const __ircLedgerPerfCounters = {
+	enabled: false,
+	epochAdvances: 0,
+	snapshot() {
+		return { epochAdvances: this.epochAdvances };
+	},
+	enable(): void {
+		this.enabled = true;
+	},
+	disable(): void {
+		this.enabled = false;
+	},
+	reset(): void {
+		this.epochAdvances = 0;
+	},
+};
 
 export type IrcObservationRecord = Readonly<
 	ParsedIrcMessage & {
@@ -22,7 +39,7 @@ function measureRetainedUtf8Bytes(message: ParsedIrcMessage): number {
 	let bytes = 4;
 	for (const value of [message.observationId, message.from, message.to, message.text, message.kind]) {
 		bytes += Buffer.byteLength(value, "utf8");
-		if (bytes > MAX_RETAINED_UTF8_BYTES) return bytes;
+		if (bytes > IRC_OBSERVATION_LEDGER_MAX_RETAINED_UTF8_BYTES) return bytes;
 	}
 	return bytes;
 }
@@ -43,12 +60,28 @@ export class IrcObservationLedger {
 	#nextSequence = 0;
 	#seenObservationIdentities = new Set<string>();
 	#identityCapacityExhausted = false;
+	#retiredSessionIdentities = new Set<string>();
 	#evictedObservationIds = new Set<string>();
+	#mutationEpoch = 0;
+
+	get mutationEpoch(): number {
+		return this.#mutationEpoch;
+	}
+
+	#advanceMutationEpoch(): void {
+		this.#mutationEpoch++;
+		if (__ircLedgerPerfCounters.enabled) __ircLedgerPerfCounters.epochAdvances++;
+	}
 
 	#rememberObservationIdentity(observationId: string): boolean {
 		const identity = tombstoneIdentity(observationId);
-		if (this.#seenObservationIdentities.has(identity) || this.#identityCapacityExhausted) return false;
-		if (this.#seenObservationIdentities.size >= MAX_SEEN_IDENTITIES) {
+		if (
+			this.#seenObservationIdentities.has(identity) ||
+			this.#retiredSessionIdentities.has(identity) ||
+			this.#identityCapacityExhausted
+		)
+			return false;
+		if (this.#seenObservationIdentities.size >= IRC_OBSERVATION_LEDGER_MAX_SEEN_IDENTITIES) {
 			this.#identityCapacityExhausted = true;
 			return false;
 		}
@@ -56,6 +89,18 @@ export class IrcObservationLedger {
 		return true;
 	}
 
+	#retireCurrentSessionIdentities(): void {
+		for (const identity of this.#seenObservationIdentities) {
+			this.#retiredSessionIdentities.delete(identity);
+			this.#retiredSessionIdentities.add(identity);
+			while (this.#retiredSessionIdentities.size > IRC_OBSERVATION_LEDGER_MAX_SEEN_IDENTITIES) {
+				const oldest = this.#retiredSessionIdentities.values().next().value;
+				if (oldest === undefined) break;
+				this.#retiredSessionIdentities.delete(oldest);
+			}
+		}
+	}
+
 	#evict(observationId: string): void {
 		const record = this.#records.get(observationId);
 		if (!record) return;
@@ -65,7 +110,10 @@ export class IrcObservationLedger {
 	}
 
 	#enforceBounds(): void {
-		while (this.#records.size > MAX_RECORDS || this.#retainedUtf8Bytes > MAX_RETAINED_UTF8_BYTES) {
+		while (
+			this.#records.size > IRC_OBSERVATION_LEDGER_MAX_RECORDS ||
+			this.#retainedUtf8Bytes > IRC_OBSERVATION_LEDGER_MAX_RETAINED_UTF8_BYTES
+		) {
 			const oldestObservationId = this.#records.keys().next().value;
 			if (oldestObservationId === undefined) return;
 			this.#evict(oldestObservationId);
@@ -76,10 +124,9 @@ export class IrcObservationLedger {
 	observe(message: ParsedIrcMessage, panelVisibleAtObservation: boolean): IrcObservationRecord | undefined {
 		const existing = this.#records.get(message.observationId);
 		if (existing) return existing;
-		if (!this.#rememberObservationIdentity(message.observationId)) return undefined;
-
 		const estimatedBytes = measureRetainedUtf8Bytes(message);
-		if (estimatedBytes > MAX_RETAINED_UTF8_BYTES) return undefined;
+		if (estimatedBytes > IRC_OBSERVATION_LEDGER_MAX_RETAINED_UTF8_BYTES) return undefined;
+		if (!this.#rememberObservationIdentity(message.observationId)) return undefined;
 
 		const observedAt = Date.now();
 		const mode: InlineMode = panelVisibleAtObservation ? "ephemeral" : "persistent";
@@ -94,6 +141,7 @@ export class IrcObservationLedger {
 		this.#records.set(record.observationId, record);
 		this.#retainedUtf8Bytes += estimatedBytes;
 		this.#enforceBounds();
+		this.#advanceMutationEpoch();
 		return this.#records.get(record.observationId);
 	}
 
@@ -116,12 +164,20 @@ export class IrcObservationLedger {
 		return observationIds;
 	}
 
-	reset(): void {
-		for (const observationId of this.#records.keys()) {
-			this.#evictedObservationIds.add(observationId);
+	reset(options?: { retireCurrentSessionIdentities?: boolean }): void {
+		const retainedRecordsChanged = this.#records.size > 0;
+		if (options?.retireCurrentSessionIdentities) this.#retireCurrentSessionIdentities();
+		else this.#retiredSessionIdentities.clear();
+		if (retainedRecordsChanged) {
+			for (const observationId of this.#records.keys()) {
+				this.#evictedObservationIds.add(observationId);
+			}
+			this.#records.clear();
+			this.#retainedUtf8Bytes = 0;
 		}
-		this.#records.clear();
-		this.#retainedUtf8Bytes = 0;
 		this.#nextSequence = 0;
+		this.#seenObservationIdentities.clear();
+		this.#identityCapacityExhausted = false;
+		if (retainedRecordsChanged) this.#advanceMutationEpoch();
 	}
 }

package/src/modes/runtime-init.ts

@@ -94,7 +94,9 @@ export async function initializeExtensions(session: AgentSession, options: Initi
 		{
 			getModel: () => session.model,
 			isIdle: () => !session.isStreaming,
+			getActivePromptHandle: () => session.activePromptHandle,
 			abort: () => session.abort(),
+			abortPromptAndWait: (handle, abortOptions) => session.abortPromptAndWait(handle, abortOptions),
 			hasPendingMessages: () => session.queuedMessageCount > 0,
 			getPendingMessageCounts: () => session.pendingMessageCounts,
 			getTranscript: () => session.getTranscript(),
@@ -132,7 +134,7 @@ export async function initializeExtensions(session: AgentSession, options: Initi
 				}
 				return false;
 			},
-			invokeSkill: (name, args) => session.invokeSkill(name, args),
+			invokeSkill: (name, args, options) => session.invokeSkill(name, args, options),
 			setPlanMode: on => session.setSdkPlanMode(on),
 			operateGoal: (op, objective) => session.operateGoal(op, objective),
 			getSkillState: () => session.skills.map(skill => ({ name: skill.name, description: skill.description })),
@@ -168,6 +170,7 @@ export async function initializeExtensions(session: AgentSession, options: Initi
 			},
 			getJobs: () => session.getAsyncJobSnapshot(),
 			setSdkPermissionProvider: provider => session.setSdkPermissionProvider(provider),
+			setSdkClientBridge: bridge => session.setClientBridge(bridge),
 			sdkControl: async (operation, input) => {
 				switch (operation) {
 					case "model.set": {
@@ -380,7 +383,24 @@ export async function initializeExtensions(session: AgentSession, options: Initi
 						const disabled = [...(session.settings.get("disabledExtensions") ?? [])];
 						const on = input.on === true;
 						const next = on ? disabled.filter(value => value !== id) : [...new Set([...disabled, id])];
-						session.settings.set("disabledExtensions", next);
+						if (!session.settings.canWriteDurableConfig()) {
+							throw Object.assign(
+								new Error(
+									"Cannot change settings while config.yml has invalid YAML syntax. Repair config.yml and reload settings.",
+								),
+								{ code: "invalid_request" },
+							);
+						}
+						try {
+							session.settings.set("disabledExtensions", next);
+						} catch (error) {
+							if (!session.settings.canWriteDurableConfig()) {
+								throw Object.assign(new Error(error instanceof Error ? error.message : String(error)), {
+									code: "invalid_request",
+								});
+							}
+							throw error;
+						}
 						return { changed: true, enabled: on };
 					}
 					case "session.delete":

package/src/modes/types.ts

@@ -248,6 +248,8 @@ export interface InteractiveModeContext {
 	getAssistantViewportAnchorId?(message: AssistantMessage): string;
 	findLastAssistantMessage(): AssistantMessage | undefined;
 	extractAssistantText(message: AssistantMessage): string;
+	/** Records one semantic visible-transcript mutation for the sticky viewport. */
+	recordVisibleTranscriptMutation?(): void;
 	updateEditorTopBorder(): void;
 	updateEditorBorderColor(): void;
 	rebuildChatFromMessages(policy: TranscriptRebuildPolicy): void;