@gajae-code/coding-agent 0.12.0 → 0.12.1

package/src/modes/components/settings-selector.ts

@@ -22,10 +22,12 @@ import type {
 	StatusLineSeparatorStyle,
 } from "../../config/settings-schema";
 import { SETTING_TABS, TAB_METADATA } from "../../config/settings-schema";
+import type { GjcRuntimeSnapshotProvider } from "../../extensibility/gjc-plugins/runtime-quarantine";
 import { getCurrentThemeName, getSelectListTheme, getSettingsListTheme, theme } from "../../modes/theme/theme";
 import { matchesAppInterrupt } from "../../modes/utils/keybinding-matchers";
 import { getTabBarTheme } from "../shared";
 import { DynamicBorder } from "./dynamic-border";
+import { GjcBundleSettingsComponent } from "./gjc-bundle-settings";
 import {
 	type NotificationsEditorOperations,
 	NotificationsSettingsEditorComponent,
@@ -650,6 +652,7 @@ function getSettingsTabs(): Tab[] {
 			return { id, label: `${icon} ${meta.label}` };
 		}),
 		{ id: "plugins", label: `${theme.icon.package} Plugins` },
+		{ id: "gjc-bundles", label: `${theme.icon.package} GJC Bundles` },
 	];
 }
 
@@ -672,6 +675,14 @@ export interface SettingsRuntimeContext {
 	petAvailable?: boolean;
 	/** Terminal environment used to select unavailable-pet guidance. Omitted in production to use Bun.env. */
 	terminalEnv?: NodeJS.ProcessEnv;
+	/**
+	 * Runtime evidence published by the session for the current activation
+	 * generation. Omitted when no session published one, in which case the GJC
+	 * Bundles tab honestly reports runtime status as unavailable.
+	 */
+	gjcRuntimeSnapshot?: GjcRuntimeSnapshotProvider;
+	/** Activation generation the published snapshot must match to be merged. */
+	gjcActivationGeneration?: number;
 }
 
 /** Status line settings subset for preview */
@@ -740,10 +751,11 @@ export class SettingsSelectorComponent extends Container {
 	#tabBar: TabBar;
 	#currentList: SettingsList | null = null;
 	#pluginComponent: PluginSettingsComponent | null = null;
+	#gjcBundleComponent: GjcBundleSettingsComponent | null = null;
 	#notificationsEditor: NotificationsSettingsEditorComponent | null = null;
 	#statusPreviewContainer: Container | null = null;
 	#statusPreviewText: Text | null = null;
-	#currentTabId: SettingTab | "plugins" = "appearance";
+	#currentTabId: SettingTab | "plugins" | "gjc-bundles" = "appearance";
 	#textInputActive = false;
 
 	constructor(
@@ -759,7 +771,7 @@ export class SettingsSelectorComponent extends Container {
 		// Tab bar
 		this.#tabBar = new TabBar("Settings", getSettingsTabs(), getTabBarTheme());
 		this.#tabBar.onTabChange = () => {
-			this.#switchToTab(this.#tabBar.getActiveTab().id as SettingTab | "plugins");
+			this.#switchToTab(this.#tabBar.getActiveTab().id as SettingTab | "plugins" | "gjc-bundles");
 		};
 
 		this.addChild(this.#tabBar);
@@ -774,7 +786,7 @@ export class SettingsSelectorComponent extends Container {
 		this.addChild(new DynamicBorder());
 	}
 
-	#switchToTab(tabId: SettingTab | "plugins"): void {
+	#switchToTab(tabId: SettingTab | "plugins" | "gjc-bundles"): void {
 		if (this.#currentTabId === "notifications" && tabId !== "notifications" && !this.#disposeNotificationsEditor()) {
 			return;
 		}
@@ -789,6 +801,11 @@ export class SettingsSelectorComponent extends Container {
 			this.removeChild(this.#pluginComponent);
 			this.#pluginComponent = null;
 		}
+		if (this.#gjcBundleComponent) {
+			this.removeChild(this.#gjcBundleComponent);
+			this.#gjcBundleComponent.dispose();
+			this.#gjcBundleComponent = null;
+		}
 		if (this.#statusPreviewContainer) {
 			this.removeChild(this.#statusPreviewContainer);
 			this.#statusPreviewContainer = null;
@@ -801,6 +818,8 @@ export class SettingsSelectorComponent extends Container {
 
 		if (tabId === "plugins") {
 			this.#showPluginsTab();
+		} else if (tabId === "gjc-bundles") {
+			this.#showGjcBundlesTab();
 		} else if (tabId === "notifications") {
 			this.#showNotificationsTab();
 		} else {
@@ -1224,7 +1243,7 @@ export class SettingsSelectorComponent extends Container {
 
 	/** Re-evaluate condition gates against the current settings and refresh the active list. */
 	#refreshCurrentTabItems(defs: SettingDef[]): void {
-		if (this.#currentTabId === "plugins" || !this.#currentList) return;
+		if (this.#currentTabId === "plugins" || this.#currentTabId === "gjc-bundles" || !this.#currentList) return;
 		this.#currentList.setItems(this.#buildItemsForTab(defs, this.#currentTabId));
 	}
 
@@ -1271,15 +1290,31 @@ export class SettingsSelectorComponent extends Container {
 		});
 		this.addChild(this.#pluginComponent);
 	}
+	#showGjcBundlesTab(): void {
+		this.#gjcBundleComponent = new GjcBundleSettingsComponent(
+			this.context.cwd,
+			{
+				onClose: () => this.callbacks.onCancel(),
+				onBundlesChanged: () => this.callbacks.onPluginsChanged?.(),
+			},
+			{
+				runtimeSnapshotProvider: this.context.gjcRuntimeSnapshot,
+				activationGeneration: this.context.gjcActivationGeneration,
+			},
+		);
+		this.addChild(this.#gjcBundleComponent);
+	}
 
 	getFocusComponent(): Component {
-		return (this.#currentList || this.#pluginComponent || this.#notificationsEditor)!;
+		return (this.#currentList || this.#pluginComponent || this.#gjcBundleComponent || this.#notificationsEditor)!;
 	}
 
 	override dispose(): void {
 		if (this.#notificationsEditor?.navigationLocked) return;
 		this.#notificationsEditor?.dispose();
 		this.#notificationsEditor = null;
+		this.#gjcBundleComponent?.dispose();
+		this.#gjcBundleComponent = null;
 		super.dispose();
 	}
 
@@ -1301,6 +1336,18 @@ export class SettingsSelectorComponent extends Container {
 			this.#notificationsEditor.handleInput(data);
 			return;
 		}
+		if (this.#gjcBundleComponent && this.#currentTabId === "gjc-bundles") {
+			if (tabNavigation) {
+				if (this.#gjcBundleComponent.navigationLocked) {
+					this.#gjcBundleComponent.handleInput(data);
+					return;
+				}
+				this.#tabBar.handleInput(data);
+				return;
+			}
+			this.#gjcBundleComponent.handleInput(data);
+			return;
+		}
 
 		// Handle tab switching — but NOT when a text input is active, since
 		// arrow keys must reach the cursor and Tab must not switch tabs.
@@ -1319,6 +1366,10 @@ export class SettingsSelectorComponent extends Container {
 			this.#pluginComponent.handleInput(data);
 			return;
 		}
+		if (this.#gjcBundleComponent) {
+			this.#gjcBundleComponent.handleInput(data);
+			return;
+		}
 
 		// Fallback for future top-level content that does not own cancellation.
 		if (matchesAppInterrupt(data)) {

package/src/modes/components/status-line/gh.ts

@@ -0,0 +1,16 @@
+import { type RunGh, runGhDefault } from "../../../utils/gh";
+
+const STATUS_LINE_GH_TIMEOUT_MS = 5_000;
+
+export async function lookupCurrentPr(runGh: RunGh = runGhDefault): Promise<{ number: number; url: string } | null> {
+	try {
+		const result = await runGh(["pr", "view", "--json", "number,url"], { timeoutMs: STATUS_LINE_GH_TIMEOUT_MS });
+		if (result.exitCode !== 0 || result.timedOut) return null;
+
+		const pr = JSON.parse(result.stdout) as { number?: unknown; url?: unknown };
+		if (typeof pr.number !== "number" || typeof pr.url !== "string") return null;
+		return { number: pr.number, url: pr.url };
+	} catch {
+		return null;
+	}
+}

package/src/modes/components/tool-status-header.ts

@@ -2,7 +2,6 @@ import * as fs from "node:fs";
 
 import { type Component, truncateToWidth, visibleWidth } from "@gajae-code/tui";
 import { formatCount, getProjectDir } from "@gajae-code/utils";
-import { $ } from "bun";
 import {
 	type AppKeybinding,
 	KEYBINDINGS,
@@ -20,6 +19,7 @@ import type { ActionRegistry, FocusDomain } from "../action-registry";
 import { EMPTY_JOBS_SNAPSHOT, type JobsSnapshot } from "../jobs-observer";
 import { sanitizeStatusText } from "../shared";
 import { renderSkillHudBar } from "./skill-hud/render";
+import { lookupCurrentPr } from "./status-line/gh";
 import {
 	canReuseCachedPr,
 	createPrCacheContext,
@@ -416,19 +416,8 @@ export class StatusLineComponent implements Component {
 			};
 			try {
 				// Requires `gh repo set-default` to be configured; fails gracefully if not
-				const result = await $`gh pr view --json number,url`.quiet().nothrow();
-				if (result.exitCode !== 0) {
-					setCachedPr(null);
-					return;
-				}
-				const pr = JSON.parse(result.stdout.toString()) as { number: number; url: string };
-				if (typeof pr.number === "number") {
-					setCachedPr({ number: pr.number, url: pr.url });
-				} else {
-					setCachedPr(null);
-				}
-			} catch {
-				setCachedPr(null);
+				const pr = await lookupCurrentPr();
+				setCachedPr(pr);
 			} finally {
 				this.#prLookupInFlight = false;
 				if (this.#onBranchChange) {

package/src/modes/components/transcript-viewer-overlay.ts

@@ -54,6 +54,34 @@ export type TranscriptViewerOverlayOptions = {
 
 type RenderedEntry = { lineStart: number; lineCount: number };
 
+export const __transcriptViewerPerfCounters = {
+	enabled: false,
+	layoutCacheHits: 0,
+	layoutCacheMisses: 0,
+	refreshRuns: 0,
+	rebuildRuns: 0,
+	snapshot() {
+		return {
+			layoutCacheHits: this.layoutCacheHits,
+			layoutCacheMisses: this.layoutCacheMisses,
+			refreshRuns: this.refreshRuns,
+			rebuildRuns: this.rebuildRuns,
+		};
+	},
+	enable(): void {
+		this.enabled = true;
+	},
+	disable(): void {
+		this.enabled = false;
+	},
+	reset(): void {
+		this.layoutCacheHits = 0;
+		this.layoutCacheMisses = 0;
+		this.refreshRuns = 0;
+		this.rebuildRuns = 0;
+	},
+};
+
 /** Message-agnostic, modal transcript browser over resolved projection entries. */
 export class TranscriptViewerOverlay extends Container {
 	#options: TranscriptViewerOverlayOptions;
@@ -73,6 +101,7 @@ export class TranscriptViewerOverlay extends Container {
 	#followTailPending = false;
 	#skipFollowTailOnce = false;
 	#followTailActive = false;
+	#layoutCache = new Map<string, Map<string, string[]>>();
 
 	constructor(options: TranscriptViewerOverlayOptions) {
 		super();
@@ -87,7 +116,11 @@ export class TranscriptViewerOverlay extends Container {
 	get isFullscreen(): boolean {
 		return this.#fullscreen;
 	}
-	refresh(identityMap?: ReadonlyMap<string, string>): void {
+	refresh(identityMap?: ReadonlyMap<string, string>, preserveLayoutCache = false): void {
+		if (__transcriptViewerPerfCounters.enabled) __transcriptViewerPerfCounters.refreshRuns++;
+		// Incremental sources explicitly invalidate same-id payload patches before requesting a
+		// preserving refresh. Other source changes conservatively drop all layout variants.
+		if (!preserveLayoutCache) this.#layoutCache.clear();
 		const previous = this.selectedEntryId;
 		const previousPosition = this.#selected;
 		const reconciledPrevious = previous ? (identityMap?.get(previous) ?? previous) : undefined;
@@ -109,9 +142,15 @@ export class TranscriptViewerOverlay extends Container {
 		this.#initialized = true;
 		this.#rebuild();
 	}
+	invalidateLayoutEntries(entryIds: readonly string[]): void {
+		for (const id of entryIds) this.#layoutCache.delete(id);
+	}
 	override render(width: number): string[] {
-		this.#width = Math.max(1, width);
-		this.refresh();
+		const nextWidth = Math.max(1, width);
+		const widthChanged = nextWidth !== this.#width;
+		this.#width = nextWidth;
+		if (widthChanged) this.#layoutCache.clear();
+		if (widthChanged || getMarkdownTheme() !== this.#mdTheme) this.#rebuild();
 		const defaultHeader = this.#fullscreen
 			? [theme.fg("accent", "Transcript block")]
 			: [theme.fg("accent", sanitizeText(this.#options.title ?? "Transcript"))];
@@ -179,6 +218,7 @@ export class TranscriptViewerOverlay extends Container {
 			if (this.#fullscreen) {
 				this.#fullscreen = false;
 				this.#scrollOffset = 0;
+				this.#rebuild();
 				this.#requestRender();
 			} else this.#options.onClose();
 			return;
@@ -208,6 +248,7 @@ export class TranscriptViewerOverlay extends Container {
 			this.#followTailActive = false;
 			this.#followTailPending = false;
 			this.#selected = 0;
+			this.#rebuild();
 			this.#scrollOffset = 0;
 			this.#requestRender();
 			return;
@@ -216,6 +257,7 @@ export class TranscriptViewerOverlay extends Container {
 			this.#followTailActive = true;
 			this.#followTailPending = true;
 			this.#selected = Math.max(0, count - 1);
+			this.#rebuild();
 			this.#scrollOffset = this.#lines.length;
 			this.#requestRender();
 			return;
@@ -228,6 +270,7 @@ export class TranscriptViewerOverlay extends Container {
 			this.#followTailActive = false;
 			this.#fullscreen = true;
 			this.#scrollOffset = 0;
+			this.#rebuild();
 			this.#requestRender();
 			return;
 		}
@@ -243,6 +286,7 @@ export class TranscriptViewerOverlay extends Container {
 			const entry = this.#entries[this.#selected];
 			if (entry?.rawViewable !== false) {
 				this.#raw.has(entry.id) ? this.#raw.delete(entry.id) : this.#raw.add(entry.id);
+				this.#rebuild();
 				this.#requestRender();
 			}
 		}
@@ -284,6 +328,7 @@ export class TranscriptViewerOverlay extends Container {
 		this.#followTailActive = false;
 		this.#followTailPending = false;
 		this.#selected = Math.max(0, Math.min(this.#selected + direction * 5, this.#entries.length - 1));
+		this.#rebuild();
 		this.#scrollOffset += direction * PAGE_SIZE;
 		this.#requestRender();
 	}
@@ -327,32 +372,58 @@ export class TranscriptViewerOverlay extends Container {
 		this.#options.requestRender?.();
 	}
 	#rebuild(): void {
+		if (__transcriptViewerPerfCounters.enabled) __transcriptViewerPerfCounters.rebuildRuns++;
+		// Theme is tracked by reference outside the variant key; a reference change clears
+		// the whole cache so plain and markdown layouts pick up new markdown colors.
+		const currentMdTheme = getMarkdownTheme();
+		if (currentMdTheme !== this.#mdTheme) {
+			this.#mdTheme = currentMdTheme;
+			this.#layoutCache.clear();
+		}
 		const lines: string[] = [];
 		this.#renderedEntries = [];
 		const display = this.#fullscreen ? this.#entries.slice(this.#selected, this.#selected + 1) : this.#entries;
 		const contentWidth = Math.max(1, this.#width - INDENT.length - 1);
 		for (const entry of display) {
 			const start = lines.length;
-			const selected = entry.id === this.selectedEntryId;
-			const expanded = this.#fullscreen || this.#expanded.has(entry.id);
-			const raw = this.#raw.has(entry.id);
-			lines.push("");
-			lines.push(
-				`${selected ? theme.fg("accent", "▶") : " "} ${theme.fg("muted", `[${sanitizeText(entry.label ?? entry.kind)}]`)}`,
-			);
-			if (
-				!raw &&
-				expanded &&
-				selected &&
-				entry.kind === "tool" &&
-				entry.richRenderEligible === true &&
-				entry.renderDescriptor
-			) {
-				for (const line of renderToolDisplayLines(entry.renderDescriptor, contentWidth, theme))
-					lines.push(`${INDENT}${line}`);
-				this.#renderedEntries.push({ lineStart: start, lineCount: lines.length - start });
-				continue;
+			const entryLines = this.#renderEntryLines(entry, contentWidth);
+			lines.push(...entryLines);
+			// Cumulative positions are recomputed from cached line lengths on every rebuild
+			// so PR2c can later separate virtual coordinates from materialized lines.
+			this.#renderedEntries.push({ lineStart: start, lineCount: entryLines.length });
+		}
+		this.#lines = lines.length ? lines : [theme.fg("dim", "No transcript entries yet.")];
+	}
+	#renderEntryLines(entry: TranscriptViewerEntry, contentWidth: number): string[] {
+		const selected = entry.id === this.selectedEntryId;
+		const expanded = this.#fullscreen || this.#expanded.has(entry.id);
+		const raw = this.#raw.has(entry.id);
+		const variantKey = `${expanded ? 1 : 0}|${raw ? 1 : 0}|${selected ? 1 : 0}|${contentWidth}`;
+		let variants = this.#layoutCache.get(entry.id);
+		if (variants) {
+			const cached = variants.get(variantKey);
+			if (cached) {
+				if (__transcriptViewerPerfCounters.enabled) __transcriptViewerPerfCounters.layoutCacheHits++;
+				return cached;
 			}
+		}
+		if (__transcriptViewerPerfCounters.enabled) __transcriptViewerPerfCounters.layoutCacheMisses++;
+		const lines: string[] = [];
+		lines.push("");
+		lines.push(
+			`${selected ? theme.fg("accent", "▶") : " "} ${theme.fg("muted", `[${sanitizeText(entry.label ?? entry.kind)}]`)}`,
+		);
+		if (
+			!raw &&
+			expanded &&
+			selected &&
+			entry.kind === "tool" &&
+			entry.richRenderEligible === true &&
+			entry.renderDescriptor
+		) {
+			for (const line of renderToolDisplayLines(entry.renderDescriptor, contentWidth, theme))
+				lines.push(`${INDENT}${line}`);
+		} else {
 			const text = sanitizeText(
 				(raw
 					? entry.payload.text
@@ -375,9 +446,13 @@ export class TranscriptViewerOverlay extends Container {
 				for (const line of preview) lines.push(`${INDENT}${truncateToWidth(line, contentWidth)}`);
 				if (text.split("\n").length > PREVIEW_LINES) lines.push(`${INDENT}${theme.fg("dim", "... more (Space)")}`);
 			}
-			this.#renderedEntries.push({ lineStart: start, lineCount: lines.length - start });
 		}
-		this.#lines = lines.length ? lines : [theme.fg("dim", "No transcript entries yet.")];
+		if (!variants) {
+			variants = new Map();
+			this.#layoutCache.set(entry.id, variants);
+		}
+		variants.set(variantKey, lines);
+		return lines;
 	}
 	#markdown(text: string, width: number): string[] {
 		return new Markdown(text, 0, 0, this.#mdTheme).render(width).map(line => `${INDENT}${line.trimEnd()}`);

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

@@ -1175,6 +1175,10 @@ export class CommandController {
 			}
 			this.ctx.showError(`Bash command failed: ${error instanceof Error ? error.message : "Unknown error"}`);
 		}
+		const bashComponent = this.ctx.bashComponent;
+		if (isDeferred && bashComponent && this.ctx.pendingBashComponents.includes(bashComponent)) {
+			this.ctx.pendingMessagesContainer.detachChild(bashComponent);
+		}
 
 		this.ctx.bashComponent = undefined;
 		this.ctx.ui.requestRender();

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

@@ -416,7 +416,9 @@ export class ExtensionUiController {
 		const contextActions: ExtensionContextActions = {
 			getModel: () => this.ctx.session.model,
 			isIdle: () => !this.ctx.session.isStreaming,
+			getActivePromptHandle: () => this.ctx.session.activePromptHandle,
 			abort: () => this.ctx.session.abort(),
+			abortPromptAndWait: (handle, options) => this.ctx.session.abortPromptAndWait(handle, options),
 			hasPendingMessages: () => this.ctx.session.queuedMessageCount > 0,
 			getPendingMessageCounts: () => this.ctx.session.pendingMessageCounts,
 			getTranscript: () => this.ctx.session.getTranscript(),
@@ -468,6 +470,7 @@ export class ExtensionUiController {
 			getBranchCandidates: () => this.ctx.sessionManager.getTree(),
 			getExtensions: () => this.ctx.session.extensionRunner?.getExtensionPaths() ?? [],
 			setSdkPermissionProvider: provider => this.ctx.session.setSdkPermissionProvider(provider),
+			setSdkClientBridge: bridge => this.ctx.session.setClientBridge(bridge),
 			sdkControl: this.#sdkControl,
 		};
 		const commandActions: ExtensionCommandContextActions = {
@@ -715,7 +718,9 @@ export class ExtensionUiController {
 		const contextActions: ExtensionContextActions = {
 			getModel: () => this.ctx.session.model,
 			isIdle: () => !this.ctx.session.isStreaming,
+			getActivePromptHandle: () => this.ctx.session.activePromptHandle,
 			abort: () => this.ctx.session.abort(),
+			abortPromptAndWait: (handle, options) => this.ctx.session.abortPromptAndWait(handle, options),
 			hasPendingMessages: () => this.ctx.session.queuedMessageCount > 0,
 			getPendingMessageCounts: () => this.ctx.session.pendingMessageCounts,
 			getTranscript: () => this.ctx.session.getTranscript(),
@@ -764,6 +769,7 @@ export class ExtensionUiController {
 			getBranchCandidates: () => this.ctx.sessionManager.getTree(),
 			getExtensions: () => this.ctx.session.extensionRunner?.getExtensionPaths() ?? [],
 			setSdkPermissionProvider: provider => this.ctx.session.setSdkPermissionProvider(provider),
+			setSdkClientBridge: bridge => this.ctx.session.setClientBridge(bridge),
 			sdkControl: this.#sdkControl,
 		};
 		const commandActions: ExtensionCommandContextActions = {
@@ -935,6 +941,7 @@ export class ExtensionUiController {
 						sessionManager: createReadonlySessionManager(this.ctx.session.sessionManager),
 						modelRegistry: this.ctx.session.modelRegistry,
 						model: this.ctx.session.model,
+						getActivePromptHandle: () => this.ctx.session.activePromptHandle,
 						isIdle: () => !this.ctx.session.isStreaming,
 						hasPendingMessages: () => this.ctx.session.queuedMessageCount > 0,
 						getPendingMessageCounts: () => this.ctx.session.pendingMessageCounts,

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

@@ -130,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 {
@@ -351,6 +352,7 @@ export function createNotificationsEditorOperations(
 					richDraftEnabled: config.richDraft.enabled,
 					toolActivityEnabled: config.toolActivity.enabled,
 					streamingEnabled: config.streaming.enabled,
+					sound: config.sound,
 				},
 			};
 		},
@@ -724,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 },
@@ -1280,6 +1283,8 @@ 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),
@@ -2327,11 +2332,51 @@ export class SelectorController {
 			);
 			await this.ctx.reloadTodos();
 			this.ctx.showStatus("Resumed session");
+			this.#maybePromptResumeModelChoice();
 		} finally {
 			progressLease.clear();
 		}
 	}
 
+	/**
+	 * 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> {
 		const sessionFile = this.ctx.sessionManager.getSessionFile();
 		if (!sessionFile) {

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(),
@@ -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": {

package/src/prompts/agent-fragments/ralplan-persistence.md

@@ -1,6 +1,7 @@
 Persistence (ralplan runs only):
-- Only when the assignment references a ralplan stage or `stage_n`, persist the full artifact through:
+- Only when the assignment references a ralplan stage or `stage_n`, it must also provide the ralplan owner `session_id` and `run_id`. If either identifier is missing, do not persist; return a compact error asking the caller to supply both.
+- Persist the full artifact through:
 
-  gjc ralplan --write --stage {{stage}} --stage_n <N> --artifact-env GJC_RALPLAN_ARTIFACT --json
+  gjc ralplan --write --session-id <owner-session-id> --run-id <run-id> --stage {{stage}} --stage_n <N> --artifact-env GJC_RALPLAN_ARTIFACT --json
 
-  Use the assignment-provided `stage_n`; on a duplicate-write error retry with the incremented N. Return the write receipt (`run_id`, `path`, `sha256`, `stage`, `stage_n`) and the role's compact verdict only. Otherwise, do not call `gjc ralplan --write`; return the full result in `yield.result.data`.
+  Use the assignment-provided owner `session_id`, `run_id`, and `stage_n`; never substitute the role subagent's own session id. On a duplicate-write error retry with the incremented N. Return the write receipt (`session_id`, `run_id`, `path`, `sha256`, `stage`, `stage_n`) and the role's compact verdict only. Otherwise, do not call `gjc ralplan --write`; return the full result in `yield.result.data`.

package/src/prompts/system/eager-todo.md

@@ -2,11 +2,15 @@
 Before substantive work, create a phased todo.
 
 You MUST call `todo_write` first in this turn.
-You MUST initialize the todo list with a single `init` op.
+Your call MUST use the top-level `ops` array with exactly one `init` operation.
+The `init` operation MUST contain `list`, whose entries each have a unique `phase` and an `items` array of task strings.
+Use this canonical shape:
+```json
+{"ops":[{"op":"init","list":[{"phase":"Investigation","items":["Locate relevant source and existing tests","Reproduce failure with focused contract test"]},{"phase":"Implementation","items":["Apply root cause fix across callsites"]},{"phase":"Verification","items":["Run focused tests and static checks"]}]}]}
+```
 You MUST cover the entire request from investigation through implementation and verification — not just the next immediate step.
-Task descriptions MUST be specific. A future turn MUST execute them without re-planning.
-You MUST keep task `content` to a short label (5-10 words). Put file paths, implementation steps, and specifics in `details`.
-You MUST keep exactly one task `in_progress` and all later tasks `pending`.
+Task strings MUST be specific, unique labels of 5-10 words. A future turn MUST execute them without re-planning.
+The tool automatically promotes the first task after initialization. Add extra context later with a separate `note` operation only when needed.
 
 After `todo_write` succeeds, continue the request in the same turn.
 Do not call `todo_write` again unless task state materially changed.

package/src/prompts/system/system-prompt.md

@@ -22,12 +22,13 @@ Optimize for correctness first, maintainability second, and brevity third. Prefe
 - Clear, low-risk implementation requests use direct tools and focused verification; do not invoke workflows or role agents for ceremony. Small verification needs do not turn a clear request into a planning workflow.
 - Ambiguous implementation asks with a missing target, scope, acceptance criteria, or safety boundary require clarification or the appropriate planning workflow before mutation.
 - Informational questions are answer-only/read-only unless the user explicitly requests a change, command, or execution.
-- Vague requirements use `/skill:deep-interview`: a requirements-only workflow that must not mutate product code. Its spec hands off as deep-interview → ralplan consensus → pending approval → separately approved execution.
-- Clear work with non-trivial architecture or sequencing risk uses `/skill:ralplan --deliberate` and stops pending approval.
+- Vague requirements use `/skill:deep-interview`: a requirements-only workflow that must not mutate product code. Its spec hands off as deep-interview → ralplan consensus → final receipt → approval or valid non-off runtime admission → separately authorized execution.
+- Clear work with non-trivial architecture or sequencing risk uses `/skill:ralplan --deliberate`; reconciliation must persist its final receipt before choosing approval or an admitted handoff. A valid non-off final runtime receipt enters the existing handoff chain; otherwise it stops pending approval.
 - Use `/skill:ultragoal` for durable goal ledgers and `/skill:team` for approved coordinated persistent work.
 - Delegate large implementation slices to `executor`; use `planner`, `architect`, or `critic` for bounded planning and review.
+- An explicit user request to use a worktree (for example, "use worktree") overrides direct editing: delegate implementation through `task` with `isolated: true`. This is the in-session counterpart of launching `gjc --worktree`; if task isolation is unavailable, report that conflict instead of editing in the parent session.
 - Active skills are authoritative: never ignore an invoked skill; read the full skill text and follow it exactly.
-- Before explicit execution approval, planning and interview workflows NEVER edit product source, run mutating shell commands, commit, push, open PRs, or delegate implementation.
+- Before explicit execution approval or a valid non-off ralplan final runtime receipt, planning and interview workflows NEVER edit product source, run mutating shell commands, commit, push, open PRs, or delegate implementation.
 </routing>
 </gjc-runtime>
 {{/unless}}
@@ -82,8 +83,14 @@ Use tools whenever they materially improve correctness, completeness, or groundi
 
 {{#if toolDiscoveryActive}}
 <tool-discovery>
-Use `{{toolRefs.search_tool_bm25}}` to activate hidden tools when a purpose-built capability would improve the task; then call the activated tool. Essential tools stay loaded up front.
+Use `{{toolRefs.search_tool_bm25}}` to activate hidden tools when a purpose-built capability would improve the task; then call the activated tool. Activation makes a tool available, but does not perform its action. Essential tools stay loaded up front.
 Discoverable capabilities include browser automation, scheduling, debugging, and external integrations.
+{{#has tools "task"}}
+For requested subagents, delegation, or independent parallel lanes, call `{{toolRefs.task}}` before saying agents are running.
+{{else}}
+For requested subagents, delegation, or independent parallel lanes, search for `subagent delegation` before saying agents are running.
+{{/has}}
+Do not claim a web search, browser action, integration, or subagent ran without that tool's result.
 </tool-discovery>
 {{/if}}