topchester-ai 0.22.0 → 0.24.0

package/dist/cli.mjs

@@ -98,7 +98,7 @@ async function enqueueFileMutation(path, mutate) {
 }
 //#endregion
 //#region src/agent/instructions.ts
-const PROJECT_INSTRUCTION_FILENAMES = ["AGENTS.override.md", "AGENTS.md"];
+const PROJECT_INSTRUCTION_FILENAMES = ["AGENTS.md", "AGENTS.override.md"];
 async function resolveProjectInstructions(workspaceRoot, options = {}) {
 	const filenames = getProjectInstructionFilenames(options);
 	if (filenames.length === 0) return {
@@ -114,21 +114,23 @@ async function resolveProjectInstructions(workspaceRoot, options = {}) {
 	const sources = [];
 	let remainingBytes = Math.max(0, maxTotalBytes);
 	for (const directory of directories) {
-		const candidate = await readFirstInstructionCandidate(resolvedWorkspace, directory, filenames, options.logger);
-		if (!candidate) continue;
-		const scopedContentLimit = Math.min(Math.max(0, maxBytesPerFile), remainingBytes);
-		const content = truncateUtf8(candidate.content, scopedContentLimit);
-		const truncated = content !== candidate.content;
-		remainingBytes -= Buffer.byteLength(content, "utf8");
-		sources.push({
-			path: candidate.absolutePath,
-			relativePath: candidate.relativePath,
-			scopePath: formatScopePath(relative(resolvedWorkspace, directory)),
-			depth: getScopeDepth(relative(resolvedWorkspace, directory)),
-			bytes: candidate.bytes,
-			truncated,
-			content
-		});
+		const candidates = await readInstructionCandidates(resolvedWorkspace, directory, filenames, options.logger);
+		if (candidates.length === 0) continue;
+		for (const candidate of candidates) {
+			const scopedContentLimit = Math.min(Math.max(0, maxBytesPerFile), remainingBytes);
+			const content = truncateUtf8(candidate.content, scopedContentLimit);
+			const truncated = content !== candidate.content;
+			remainingBytes -= Buffer.byteLength(content, "utf8");
+			sources.push({
+				path: candidate.absolutePath,
+				relativePath: candidate.relativePath,
+				scopePath: formatScopePath(relative(resolvedWorkspace, directory)),
+				depth: getScopeDepth(relative(resolvedWorkspace, directory)),
+				bytes: candidate.bytes,
+				truncated,
+				content
+			});
+		}
 	}
 	options.logger?.debug({
 		event: "project_instructions_resolved",
@@ -212,7 +214,8 @@ function getInstructionDirectories(resolvedWorkspace, targetDirectory) {
 	}
 	return directories;
 }
-async function readFirstInstructionCandidate(resolvedWorkspace, directory, filenames, logger) {
+async function readInstructionCandidates(resolvedWorkspace, directory, filenames, logger) {
+	const candidates = [];
 	for (const filename of filenames) {
 		const absolutePath = resolve(directory, filename);
 		const relativePath = formatRelativePath(relative(resolvedWorkspace, absolutePath));
@@ -235,12 +238,12 @@ async function readFirstInstructionCandidate(resolvedWorkspace, directory, filen
 				}, "project instruction skipped");
 				continue;
 			}
-			return {
+			candidates.push({
 				absolutePath,
 				relativePath,
 				content,
 				bytes: bytes.byteLength
-			};
+			});
 		} catch (error) {
 			const code = typeof error === "object" && error && "code" in error ? String(error.code) : void 0;
 			if (code === "ENOENT" || code === "ENOTDIR") continue;
@@ -252,6 +255,7 @@ async function readFirstInstructionCandidate(resolvedWorkspace, directory, filen
 			}, "project instruction skipped");
 		}
 	}
+	return candidates;
 }
 function truncateUtf8(content, maxBytes) {
 	if (maxBytes <= 0) return "";
@@ -5269,6 +5273,7 @@ const hookHandlerSchema = z.object({
 	type: z.literal("command").optional(),
 	command: z.string().min(1),
 	timeoutMs: hookTimeoutMsSchema.optional(),
+	statusMessage: z.string().min(1).optional(),
 	matcher: hookMatcherSchema
 }).strict();
 const canonicalHooksConfigSchema = z.object({
@@ -7563,6 +7568,14 @@ function toolCallMessage(call, label, resultSummary) {
 		resultSummary
 	};
 }
+function hookStatusMessage(label, eventName, statusMessage) {
+	return {
+		kind: "hook_status",
+		label,
+		...eventName === void 0 ? {} : { eventName },
+		...statusMessage === void 0 ? {} : { statusMessage }
+	};
+}
 function subagentMessage(message) {
 	return {
 		kind: "subagent",
@@ -7579,6 +7592,7 @@ const DEFAULT_MODAL_VISIBLE_ACTION_LIMIT = 16;
 function renderChatMessage(message, options = {}) {
 	if (message.kind === "modal") return renderChatModal(message, options.selectedActionIndex, options.maxModalHeight);
 	if (message.kind === "tool_call") return renderToolCallMessage(message);
+	if (message.kind === "hook_status") return renderHookStatusMessage(message);
 	if (message.kind === "subagent") return renderSubagentMessage(message);
 	if (message.kind === "thinking") return message.text.split("\n").map((line) => ui.muted(line));
 	if (message.text.length === 0) return [""];
@@ -7613,6 +7627,9 @@ function renderToolCallMessage(message) {
 	const visibleLabel = message.resultSummary && !message.label.includes(message.resultSummary) ? `${message.label} ${message.resultSummary}` : message.label;
 	return [`   ${ui.muted(expandTabs(visibleLabel))}`];
 }
+function renderHookStatusMessage(message) {
+	return [`   ${ui.muted(expandTabs(message.label))}`];
+}
 function renderSubagentMessage(message) {
 	const label = message.title ?? shortSessionId(message.sessionId);
 	switch (message.status) {
@@ -7770,6 +7787,12 @@ const toolCallPayloadSchema = z.object({
 	label: z.string(),
 	call: z.record(z.string(), jsonValueSchema)
 });
+const hookStatusPayloadSchema = z.object({
+	kind: z.literal("hook_status"),
+	eventName: z.string(),
+	statusMessage: z.string(),
+	label: z.string()
+});
 const taskPlanItemPayloadSchema = z.object({
 	text: z.string(),
 	status: z.enum([
@@ -7836,6 +7859,7 @@ const subagentFailedPayloadSchema = subagentLifecycleBasePayloadSchema.extend({
 const sessionEventPayloadSchema = z.discriminatedUnion("kind", [
 	messagePayloadSchema,
 	toolCallPayloadSchema,
+	hookStatusPayloadSchema,
 	taskPlanPayloadSchema,
 	instructionContextPayloadSchema,
 	statusPayloadSchema,
@@ -8008,6 +8032,9 @@ function rehydrateSession(events) {
 		case "tool_call":
 			messages.push(toolCallMessage(event.call, event.label));
 			break;
+		case "hook_status":
+			messages.push(hookStatusMessage(event.label, event.eventName, event.statusMessage));
+			break;
 		case "task_plan":
 			taskPlan = {
 				items: event.items,
@@ -8634,6 +8661,14 @@ const agentEvent = {
 			label
 		};
 	},
+	hookStatus(eventName, statusMessage) {
+		return {
+			type: "hook_status",
+			eventName,
+			statusMessage,
+			label: `🪝 hook>${formatHookEventName(eventName)}: ${statusMessage}`
+		};
+	},
 	taskPlan(plan) {
 		return {
 			type: "task_plan",
@@ -8694,6 +8729,9 @@ function choiceAction(label, value) {
 		value
 	};
 }
+function formatHookEventName(eventName) {
+	return eventName.replace(/([a-z])([A-Z])/gu, "$1-$2").toLowerCase();
+}
 //#endregion
 //#region src/tui/keys.ts
 function isUpKey(data) {
@@ -8783,6 +8821,7 @@ var PromptHistory = class {
 };
 //#endregion
 //#region src/tui/status.ts
+const STARTUP_PROMPT_HINT = "Prompt hint: Enter sends, Shift+Enter adds a line, / opens commands, ↑↓ browse history.";
 function getStartupThreadMessages(context) {
 	const assignments = context.config.models?.assignments ?? {};
 	const providers = context.config.models?.providers ?? {};
@@ -8932,6 +8971,7 @@ var ChatLayout = class {
 	promptCursor = 0;
 	status = "ready";
 	knowledgeStatus;
+	startupHintLine;
 	ephemeralLine;
 	taskPlanNoticeLine;
 	noticeLine;
@@ -8993,6 +9033,9 @@ var ChatLayout = class {
 	isReady() {
 		return this.status === "ready";
 	}
+	setStartupHintLine(line) {
+		this.startupHintLine = line;
+	}
 	setEphemeralLine(line) {
 		this.ephemeralLine = line;
 	}
@@ -9026,6 +9069,7 @@ var ChatLayout = class {
 		this.promptCursor = 0;
 		this.status = "ready";
 		this.knowledgeStatus = void 0;
+		this.startupHintLine = void 0;
 		this.ephemeralLine = void 0;
 		this.taskPlanNoticeLine = void 0;
 		this.noticeLine = void 0;
@@ -9056,6 +9100,7 @@ var ChatLayout = class {
 				case "system":
 				case "thinking":
 				case "tool_call":
+				case "hook_status":
 				case "subagent":
 				case "modal": return [];
 			}
@@ -9110,6 +9155,7 @@ var ChatLayout = class {
 			const spacer = index === this.messages.length - 1 ? [] : [padThreadLine("", width)];
 			return [...this.renderThreadMessageLines(messageLines, innerWidth, width, message.kind === "user"), ...spacer];
 		});
+		if (this.startupHintLine) lines.push(...this.renderThreadMessageLines([` ${ui.muted(this.startupHintLine)}`], innerWidth, width, false));
 		if (this.ephemeralLine) lines.push(...this.renderThreadMessageLines([` ${this.ephemeralLine}`], innerWidth, width, false));
 		if (this.taskPlanNoticeLine) lines.push(...this.renderThreadMessageLines([` ${this.taskPlanNoticeLine}`], innerWidth, width, false));
 		if (this.noticeLine) lines.push(...this.renderThreadMessageLines([` ${this.noticeLine}`], innerWidth, width, false));
@@ -9123,6 +9169,7 @@ var ChatLayout = class {
 		});
 	}
 	renderPrompt(width) {
+		const slashSuggestions = this.getSlashSuggestions();
 		const top = `┌${"─".repeat(Math.max(0, width - 2))}┐`;
 		const bottom = `└${"─".repeat(Math.max(0, width - 2))}┘`;
 		const prefix = "> ";
@@ -9131,7 +9178,7 @@ var ChatLayout = class {
 		const statusInnerWidth = Math.max(1, width - 2);
 		const status = truncateToWidth(` ${formatStatusLine(this.folderName, this.modelLabel, this.status, this.knowledgeStatus, statusInnerWidth)} `, width, "…", true);
 		return [
-			...this.renderSlashSuggestions(width),
+			...this.renderSlashSuggestions(width, slashSuggestions),
 			...this.renderTaskPlan(width),
 			top,
 			...inputLines.map((line, index) => `│ ${index === 0 ? prefix : "  "}${padPromptInputLine(line, innerWidth)} │`),
@@ -9190,8 +9237,7 @@ var ChatLayout = class {
 		if (!this.taskPlan) return [];
 		return formatTaskPlanForTui(this.taskPlan, Math.max(1, width));
 	}
-	renderSlashSuggestions(width) {
-		const suggestions = this.getSlashSuggestions();
+	renderSlashSuggestions(width, suggestions = this.getSlashSuggestions()) {
 		if (suggestions.length === 0 || this.promptHint) return [];
 		this.activeSlashSuggestionIndex = Math.min(this.activeSlashSuggestionIndex, suggestions.length - 1);
 		const innerWidth = Math.max(1, width - 4);
@@ -9542,6 +9588,8 @@ var ChatLayout = class {
 	}
 	submitUserInput(message) {
 		this.setTaskPlanNotice(void 0);
+		this.setStartupHintLine(void 0);
+		this.setEphemeralLine(void 0);
 		this.promptHistory.add(message);
 		if (message.startsWith("/")) this.submitCommand?.(message);
 		else this.submitMessage?.(message);
@@ -9625,6 +9673,11 @@ async function runTopchesterHooks(context, event, payload, options = {}) {
 	};
 	for (const handler of handlers) {
 		result.handlerCount += 1;
+		const statusMessage = handler.statusMessage?.trim();
+		if (statusMessage) options.onHookStart?.({
+			event,
+			statusMessage
+		});
 		const handlerResult = await runCommandHandler(context, event, payload, handler, options);
 		result.contexts.push(...handlerResult.contexts);
 		result.messages.push(...handlerResult.messages);
@@ -10197,6 +10250,12 @@ function runtimeEventToSessionPayload(event) {
 			label: event.label,
 			call: event.call
 		};
+		case "hook_status": return {
+			kind: "hook_status",
+			eventName: event.eventName,
+			statusMessage: event.statusMessage,
+			label: event.label
+		};
 		case "task_plan": return {
 			kind: "task_plan",
 			items: event.plan.items,
@@ -10838,15 +10897,27 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 		const sessionKey = session?.sessionId ?? `workspace:${this.context.workspaceRoot}`;
 		if (this.startedHookSessionKeys.has(sessionKey)) return [];
 		this.startedHookSessionKeys.add(sessionKey);
+		const startedEvents = [];
 		const result = await this.runHookEvent("SessionStart", this.createBaseHookPayload("SessionStart", session, {
 			isResumed: Boolean(options.isResumed),
 			taskStartAlias: "TaskStart"
-		}), { abortSignal: options.abortSignal });
-		return this.hookResultToEvents(result);
+		}), {
+			abortSignal: options.abortSignal,
+			onHookStart: (status) => {
+				startedEvents.push(agentEvent.hookStatus(status.event, status.statusMessage));
+			}
+		});
+		return [...startedEvents, ...this.hookResultToEvents(result)];
 	}
 	async runPreCompactHooks(session, options = {}) {
-		const result = await this.runHookEvent("PreCompact", this.createBaseHookPayload("PreCompact", session, { reason: options.reason ?? "Compaction is about to start." }), { abortSignal: options.abortSignal });
-		return this.hookResultToEvents(result);
+		const startedEvents = [];
+		const result = await this.runHookEvent("PreCompact", this.createBaseHookPayload("PreCompact", session, { reason: options.reason ?? "Compaction is about to start." }), {
+			abortSignal: options.abortSignal,
+			onHookStart: (status) => {
+				startedEvents.push(agentEvent.hookStatus(status.event, status.statusMessage));
+			}
+		});
+		return [...startedEvents, ...this.hookResultToEvents(result)];
 	}
 	/**
 	* Streams one user chat turn through the agent loop. It builds the model
@@ -10862,11 +10933,13 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 	async *submitMessageStream(conversation, message, abortSignal, options = {}) {
 		const session = options.session ?? this.options.session;
 		for (const event of await this.runSessionStartHooks(session, { abortSignal })) yield event;
-		const userPromptHook = await this.runHookEvent("UserPromptSubmit", this.createBaseHookPayload("UserPromptSubmit", session, {
+		const userPromptHookRun = this.startHookEvent("UserPromptSubmit", this.createBaseHookPayload("UserPromptSubmit", session, {
 			prompt: { text: message },
 			prompt_text: message,
 			user_prompt: message
 		}), { abortSignal });
+		for await (const event of userPromptHookRun.statusEvents) yield event;
+		const userPromptHook = await userPromptHookRun.result;
 		for (const event of this.hookResultToEvents(userPromptHook)) yield event;
 		if (userPromptHook.blocked || userPromptHook.stopped) {
 			const interruption = userPromptHook.blocked ?? userPromptHook.stopped;
@@ -10995,7 +11068,7 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 				}
 				const finalMessage = finalText.trim() || "I got an empty response from the model.";
 				yield agentEvent.assistantMessage(finalMessage, formatAgentMessageMeta(result.modelId, totalDurationMs, tokenUsageTotals));
-				for (const event of await this.runStopHookEvents(session, finalMessage, "completed", abortSignal)) yield event;
+				for await (const event of this.streamStopHookEvents(session, finalMessage, "completed", abortSignal)) yield event;
 				yield agentEvent.status("ready");
 				return;
 			}
@@ -11019,7 +11092,9 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 					for (let batchIndex = 0; batchIndex < batch.length; batchIndex += 1) {
 						const call = batch[batchIndex];
 						const resultIndex = index + batchIndex;
-						const preHook = await this.runPreToolUseHook(call, modelToolCalls[resultIndex]?.id, session, abortSignal);
+						const preHookRun = this.startPreToolUseHook(call, modelToolCalls[resultIndex]?.id, session, abortSignal);
+						for await (const event of preHookRun.statusEvents) yield event;
+						const preHook = await preHookRun.result;
 						for (const event of this.hookResultToEvents(preHook)) yield event;
 						if (preHook.stopped) {
 							if (preHook.messages.length === 0) yield agentEvent.systemMessage(preHook.stopped.message);
@@ -11065,7 +11140,9 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 					const toolResult = taskResults[index];
 					for (const event of createInstructionContextEventsFromToolResult(toolResult, persistedProjectInstructionKeys)) yield event;
 					yield agentEvent.toolCall(call, formatToolCallMessage(call, toolResult));
-					const postHook = await this.runPostToolUseHook(call, modelToolCalls[index]?.id, toolResult, session, abortSignal);
+					const postHookRun = this.startPostToolUseHook(call, modelToolCalls[index]?.id, toolResult, session, abortSignal);
+					for await (const event of postHookRun.statusEvents) yield event;
+					const postHook = await postHookRun.result;
 					for (const event of this.hookResultToEvents(postHook)) yield event;
 					postHookContexts.push(...postHook.contexts);
 					if (postHook.stopped) {
@@ -11085,7 +11162,9 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 				const postHookContexts = [];
 				for (let index = 0; index < parallelCalls.length; index += 1) {
 					const call = parallelCalls[index];
-					const preHook = await this.runPreToolUseHook(call, modelToolCalls[index]?.id, session, abortSignal);
+					const preHookRun = this.startPreToolUseHook(call, modelToolCalls[index]?.id, session, abortSignal);
+					for await (const event of preHookRun.statusEvents) yield event;
+					const preHook = await preHookRun.result;
 					for (const event of this.hookResultToEvents(preHook)) yield event;
 					if (preHook.stopped) {
 						if (preHook.messages.length === 0) yield agentEvent.systemMessage(preHook.stopped.message);
@@ -11123,7 +11202,9 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 					const toolResult = parallelResults[index];
 					for (const event of createInstructionContextEventsFromToolResult(toolResult, persistedProjectInstructionKeys)) yield event;
 					yield agentEvent.toolCall(call, formatToolCallMessage(call, toolResult));
-					const postHook = await this.runPostToolUseHook(call, modelToolCalls[index]?.id, toolResult, session, abortSignal);
+					const postHookRun = this.startPostToolUseHook(call, modelToolCalls[index]?.id, toolResult, session, abortSignal);
+					for await (const event of postHookRun.statusEvents) yield event;
+					const postHook = await postHookRun.result;
 					for (const event of this.hookResultToEvents(postHook)) yield event;
 					postHookContexts.push(...postHook.contexts);
 					if (postHook.stopped) {
@@ -11141,11 +11222,13 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 			if (suppressiblePlanTodoAnswer !== void 0) {
 				const finalMessage = suppressiblePlanTodoAnswer || "I got an empty response from the model.";
 				yield agentEvent.assistantMessage(finalMessage, formatAgentMessageMeta(result.modelId, totalDurationMs, tokenUsageTotals));
-				for (const event of await this.runStopHookEvents(session, finalMessage, "completed", abortSignal)) yield event;
+				for await (const event of this.streamStopHookEvents(session, finalMessage, "completed", abortSignal)) yield event;
 				yield agentEvent.status("ready");
 				return;
 			}
-			const preHook = await this.runPreToolUseHook(executableToolCall, toolCall.id, session, abortSignal);
+			const preHookRun = this.startPreToolUseHook(executableToolCall, toolCall.id, session, abortSignal);
+			for await (const event of preHookRun.statusEvents) yield event;
+			const preHook = await preHookRun.result;
 			for (const event of this.hookResultToEvents(preHook)) yield event;
 			let toolResult;
 			if (preHook.stopped) {
@@ -11183,7 +11266,9 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 			for (const event of createInstructionContextEventsFromToolResult(toolResult, persistedProjectInstructionKeys)) yield event;
 			yield agentEvent.toolCall(executableToolCall, formatToolCallMessage(executableToolCall, toolResult));
 			if (!isToolErrorResult(toolResult) && toolResult.tool === "plan_todo") yield agentEvent.taskPlan(toolResult.plan);
-			const postHook = await this.runPostToolUseHook(executableToolCall, toolCall.id, toolResult, session, abortSignal);
+			const postHookRun = this.startPostToolUseHook(executableToolCall, toolCall.id, toolResult, session, abortSignal);
+			for await (const event of postHookRun.statusEvents) yield event;
+			const postHook = await postHookRun.result;
 			for (const event of this.hookResultToEvents(postHook)) yield event;
 			if (postHook.stopped) {
 				if (postHook.messages.length === 0) yield agentEvent.systemMessage(postHook.stopped.message);
@@ -11195,7 +11280,7 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 		}
 		const finalMessage = "I stopped because the tool loop ended unexpectedly.";
 		yield agentEvent.assistantMessage(finalMessage, formatAgentMessageMeta(lastModelId, totalDurationMs, tokenUsageTotals));
-		for (const event of await this.runStopHookEvents(session, finalMessage, "failed", abortSignal)) yield event;
+		for await (const event of this.streamStopHookEvents(session, finalMessage, "failed", abortSignal)) yield event;
 		yield agentEvent.status("ready");
 	}
 	/**
@@ -11210,29 +11295,45 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 		}
 		return events;
 	}
-	async runPreToolUseHook(call, toolCallId, session, abortSignal) {
-		return this.runHookEvent("PreToolUse", this.createToolHookPayload("PreToolUse", call, toolCallId, session), {
+	startPreToolUseHook(call, toolCallId, session, abortSignal) {
+		return this.startHookEvent("PreToolUse", this.createToolHookPayload("PreToolUse", call, toolCallId, session), {
 			toolName: call.tool,
 			abortSignal
 		});
 	}
-	async runPostToolUseHook(call, toolCallId, result, session, abortSignal) {
-		return this.runHookEvent("PostToolUse", this.createToolHookPayload("PostToolUse", call, toolCallId, session, { result }), {
+	startPostToolUseHook(call, toolCallId, result, session, abortSignal) {
+		return this.startHookEvent("PostToolUse", this.createToolHookPayload("PostToolUse", call, toolCallId, session, { result }), {
 			toolName: call.tool,
 			abortSignal
 		});
 	}
-	async runStopHookEvents(session, finalMessage, status, abortSignal) {
-		const result = await this.runHookEvent("Stop", this.createBaseHookPayload("Stop", session, {
+	async *streamStopHookEvents(session, finalMessage, status, abortSignal) {
+		const hookRun = this.startHookEvent("Stop", this.createBaseHookPayload("Stop", session, {
 			taskCompleteAlias: "TaskComplete",
 			finalMessage,
 			status
 		}), { abortSignal });
-		return this.hookResultToEvents(result);
+		for await (const event of hookRun.statusEvents) yield event;
+		const result = await hookRun.result;
+		for (const event of this.hookResultToEvents(result)) yield event;
 	}
 	async runHookEvent(event, payload, options = {}) {
 		return runTopchesterHooks(this.context, event, payload, options);
 	}
+	startHookEvent(event, payload, options = {}) {
+		const queue = createRuntimeEventQueue();
+		return {
+			statusEvents: queue,
+			result: this.runHookEvent(event, payload, {
+				...options,
+				onHookStart: (status) => {
+					queue.push(agentEvent.hookStatus(status.event, status.statusMessage));
+				}
+			}).finally(() => {
+				queue.close();
+			})
+		};
+	}
 	createBaseHookPayload(event, session, extra = {}) {
 		return {
 			hook_event_name: event,
@@ -11240,6 +11341,7 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 			cwd: this.context.workspaceRoot,
 			workspaceRoot: this.context.workspaceRoot,
 			source: "topchester",
+			...this.createHookModelPayload("agent.primary"),
 			...session ? {
 				session_id: session.sessionId,
 				sessionId: session.sessionId,
@@ -11253,6 +11355,33 @@ var TopchesterAgentRuntime = class TopchesterAgentRuntime {
 			...extra
 		};
 	}
+	createHookModelPayload(purpose) {
+		const resolveModel = this.context.modelGateway.resolveModel;
+		if (typeof resolveModel !== "function") return {};
+		try {
+			const resolved = resolveModel.call(this.context.modelGateway, purpose);
+			const modelRef = `${resolved.providerId}/${resolved.modelId}`;
+			return {
+				model_purpose: resolved.purpose,
+				model_provider: resolved.providerId,
+				model_id: resolved.modelId,
+				model_ref: modelRef,
+				model: {
+					purpose: resolved.purpose,
+					providerId: resolved.providerId,
+					modelId: resolved.modelId,
+					ref: modelRef
+				}
+			};
+		} catch (error) {
+			this.context.logger.debug({
+				event: "hook_model_resolution_skipped",
+				purpose,
+				error: error instanceof Error ? error.message : String(error)
+			}, "hook model metadata unavailable");
+			return {};
+		}
+	}
 	createToolHookPayload(event, call, toolCallId, session, extra = {}) {
 		return this.createBaseHookPayload(event, session, {
 			tool_name: call.tool,
@@ -11481,6 +11610,7 @@ function renderRuntimeEvent(event) {
 	switch (event.type) {
 		case "message": return [event.role === "assistant" ? agentMessage(event.text, event.meta) : systemMessage(event.text)];
 		case "tool_call": return [toolCallMessage(event.call, event.label)];
+		case "hook_status": return [hookStatusMessage(event.label, event.eventName, event.statusMessage)];
 		case "knowledge_status": return [systemMessage([`KB status: ${formatKnowledgePathStatus(event.status)}${formatKbPathSource(event.status)}`, event.guidance].filter(Boolean).join("\n"))];
 		case "choice": return [modalMessage({
 			tone: event.tone,
@@ -11520,6 +11650,11 @@ function formatForwardedSubagentEvent(sessionId, event) {
 		sessionId,
 		text: event.label
 	})];
+	if (event.type === "hook_status") return [subagentMessage({
+		status: "event",
+		sessionId,
+		text: event.label
+	})];
 	return [];
 }
 function formatKbPathSource(status) {
@@ -11718,6 +11853,12 @@ function chatMessageToSessionPayload(message) {
 	};
 	if (message.kind === "thinking") return;
 	if (message.kind === "subagent") return;
+	if (message.kind === "hook_status") return message.eventName && message.statusMessage ? {
+		kind: "hook_status",
+		eventName: message.eventName,
+		statusMessage: message.statusMessage,
+		label: message.label
+	} : void 0;
 	if (message.kind === "modal") return {
 		kind: "choice",
 		tone: message.tone,
@@ -11969,6 +12110,7 @@ var TopchesterTuiShell = class {
 			}
 		});
 		app.setTaskPlan(this.options.initialTaskPlan);
+		if (!isResumed) app.setStartupHintLine(STARTUP_PROMPT_HINT);
 		app.setSubmitMessage((message) => {
 			this.startBackgroundTask(app, tui, "Chat", () => this.submitChatMessage(app, tui, message));
 		});
@@ -12580,6 +12722,7 @@ var TopchesterTuiShell = class {
 		await this.appendStartupRuntimeEvents(session, messages, await this.runtime.runSessionStartHooks?.(session, { isResumed: false }) ?? []);
 		await this.appendStartupRuntimeEvents(session, messages, await this.runtime.checkProjectInstructions?.() ?? []);
 		app.resetForNewSession(messages);
+		app.setStartupHintLine(STARTUP_PROMPT_HINT);
 		tui.requestRender();
 		await this.checkAgent(app, tui);
 	}
@@ -12787,6 +12930,7 @@ async function loadConversation(workspaceRoot, resume) {
 			case "system":
 			case "thinking":
 			case "tool_call":
+			case "hook_status":
 			case "subagent":
 			case "modal": return [];
 		}
@@ -12819,6 +12963,10 @@ function printPlainEvent(event) {
 		console.log(event.label);
 		return;
 	}
+	if (event.type === "hook_status") {
+		console.log(event.label);
+		return;
+	}
 	if (event.type === "knowledge_status" && event.guidance) {
 		console.log(event.guidance);
 		return;