@gajae-code/coding-agent 0.11.11 → 0.12.0

package/src/modes/controllers/extension-ui-controller.ts

@@ -281,7 +281,24 @@ export class ExtensionUiController {
 				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":
@@ -442,7 +459,7 @@ export class ExtensionUiController {
 				}
 				return false;
 			},
-			invokeSkill: (name, args) => this.ctx.session.invokeSkill(name, args),
+			invokeSkill: (name, args, options) => this.ctx.session.invokeSkill(name, args, options),
 			setPlanMode: on => this.ctx.session.setSdkPlanMode(on),
 			operateGoal: (op, objective) => this.ctx.session.operateGoal(op, objective),
 			getSkillState: () =>

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,
@@ -165,6 +166,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",
@@ -1151,6 +1153,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 +1232,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;
@@ -1270,6 +1283,7 @@ export class SelectorController {
 					},
 					{
 						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 +1303,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 +1347,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 +1404,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 +2294,42 @@ 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");
+		} 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");
 	}
 
 	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

@@ -132,7 +132,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 })),
@@ -380,7 +380,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;