@iowarp/clio-coder 0.4.1 → 0.4.2

package/src/interactive/chat-panel.ts

@@ -603,30 +603,53 @@ function hasStreamingText(entry: Extract<TranscriptEntry, { role: "assistant" }>
 }
 
 /**
- * Split a reply that opens with the skill-suggestion protocol line into that
- * line and the answer beneath it.
+ * Locate the skill-suggestion protocol line inside a reply.
  *
- * The prompt asks the model to *begin its reply* with the suggestion, so the
- * usual shape is one segment holding both. Classifying that whole segment as
- * advisory left the turn with no voice glyph at all: the suggestion did not
- * claim it and the answer never got the chance. Returns null when the segment
- * is only a suggestion, which stays advisory in full.
+ * The prompt asks the model to begin its reply with the line, but a model
+ * that narrates its work first puts the line at the end of the final message
+ * about half the time (round-4 skill batches: 1/2 and 0/2 opened, 2/2 fired).
+ * The line is recognized at the start of any line, provided it is complete
+ * (a newline follows it, or the segment is finalized), so a partially
+ * streamed line stays ordinary prose until it is whole. Returns the line's
+ * byte range or null.
+ */
+function findSkillSuggestionLine(seg: TextSegment): { start: number; end: number } | null {
+	const text = seg.text;
+	let at = text.startsWith(SKILL_SUGGESTION_PREFIX) ? 0 : text.indexOf(`\n${SKILL_SUGGESTION_PREFIX}`);
+	if (at < 0) return null;
+	if (at > 0) at += 1;
+	const lineEnd = text.indexOf("\n", at);
+	if (lineEnd < 0) return seg.finalized ? { start: at, end: text.length } : null;
+	return { start: at, end: lineEnd };
+}
+
+/**
+ * Split a reply that carries the skill-suggestion protocol line into that
+ * line and the answer around it.
+ *
+ * The usual shape is one segment holding both. Classifying that whole segment
+ * as advisory left the turn with no voice glyph at all: the suggestion did not
+ * claim it and the answer never got the chance. The suggestion renders first
+ * wherever the model put it, and the answer is the rest of the segment with
+ * that line removed. Returns null when the segment is only a suggestion,
+ * which stays advisory in full.
  */
 function skillSuggestionSplit(seg: TextSegment): { suggestion: string; answer: TextSegment } | null {
-	if (!seg.text.startsWith(SKILL_SUGGESTION_PREFIX)) return null;
-	const breakIndex = seg.text.indexOf("\n");
-	if (breakIndex < 0) return null;
+	const found = findSkillSuggestionLine(seg);
+	if (!found) return null;
+	const before = seg.text.slice(0, found.start).replace(/\n+$/, "");
+	const after = seg.text.slice(found.end + 1).replace(/^\n+/, "");
 	// A model that puts a blank line between the suggestion and the answer left
 	// the remainder opening with a newline, so the first rendered row was empty
 	// and took the glyph the answer's own text row was owed.
-	const answerText = seg.text.slice(breakIndex + 1).replace(/^\n+/, "");
+	const answerText = before.length > 0 && after.length > 0 ? `${before}\n${after}` : before + after;
 	if (answerText.trim().length === 0) return null;
 	const split = seg.suggestionSplit ?? {
 		suggestion: "",
 		answer: { kind: "text", text: answerText, finalized: seg.finalized } as TextSegment,
 	};
 	seg.suggestionSplit = split;
-	split.suggestion = seg.text.slice(0, breakIndex);
+	split.suggestion = seg.text.slice(found.start, found.end).replace(/\r$/, "");
 	const answer = split.answer;
 	if (answer.text === answerText && answer.finalized === seg.finalized) return split;
 	// The answer half follows the same cache rules as any other segment: the
@@ -1113,7 +1136,7 @@ function renderEntryLines(
 		const rendered =
 			seg.kind === "text" ? renderTextSegmentLines(seg, proseWidth) : renderErrorSegmentLines(seg, proseWidth);
 		if (rendered.length === 0) continue;
-		const isSkillSuggestion = seg.kind === "text" && seg.text.startsWith(SKILL_SUGGESTION_PREFIX);
+		const isSkillSuggestion = seg.kind === "text" && findSkillSuggestionLine(seg) !== null;
 		if (!labeled && !isSkillSuggestion) {
 			lines.push(...hangProseLines(rendered, clioPrefix));
 			labeled = true;

package/src/interactive/chat-renderer.ts

@@ -460,15 +460,73 @@ function richMessageFromEntry(entry: MessageEntry, maxTextChars?: number): Agent
 	return message as unknown as AgentMessage;
 }
 
-function recordToolCallsFromMessage(message: AgentMessage, seen: Set<string>): void {
+function toolCallIdsFromMessage(message: AgentMessage): string[] {
 	const content = (message as { content?: unknown }).content;
-	if (!Array.isArray(content)) return;
+	if (!Array.isArray(content)) return [];
+	const ids: string[] = [];
 	for (const block of content) {
 		if (!block || typeof block !== "object") continue;
 		const b = block as Record<string, unknown>;
 		if (b.type !== "toolCall") continue;
-		if (typeof b.id === "string" && b.id.length > 0) seen.add(b.id);
+		if (typeof b.id === "string" && b.id.length > 0) ids.push(b.id);
 	}
+	return ids;
+}
+
+function recordToolCallsFromMessage(message: AgentMessage, seen: Set<string>): void {
+	for (const id of toolCallIdsFromMessage(message)) seen.add(id);
+}
+
+/**
+ * Replay sink that hands tool results to the model in the order the assistant
+ * issued the calls.
+ *
+ * The ledger appends a tool result when its tool finishes, while the live loop
+ * appends a parallel batch's results by call index (pi executes the batch and
+ * pushes results in the assistant's order). A two-call turn whose second call
+ * finished first is therefore recorded as [b, a] and was sent as [a, b]. A
+ * resume that replayed the ledger order sent different bytes from that point
+ * on, and the provider's prefix cache missed for the rest of the session.
+ * Results are staged until the next non-result message and released in call
+ * order; an id the staged assistant turn never issued keeps its ledger order
+ * after the known ones.
+ */
+function createOrderedReplaySink(): {
+	messages: AgentMessage[];
+	push(message: AgentMessage): void;
+	stageToolResult(message: AgentMessage): void;
+	flush(): void;
+} {
+	const messages: AgentMessage[] = [];
+	let callOrder: string[] = [];
+	let staged: AgentMessage[] = [];
+	const rank = (message: AgentMessage): number => {
+		const id = (message as { toolCallId?: unknown }).toolCallId;
+		const index = typeof id === "string" ? callOrder.indexOf(id) : -1;
+		return index < 0 ? Number.MAX_SAFE_INTEGER : index;
+	};
+	const flush = (): void => {
+		if (staged.length === 0) return;
+		staged.sort((a, b) => rank(a) - rank(b));
+		messages.push(...staged);
+		staged = [];
+		callOrder = [];
+	};
+	return {
+		messages,
+		flush,
+		push(message) {
+			flush();
+			messages.push(message);
+			// Consecutive assistant messages (one legacy standalone tool_call entry
+			// per call) share one batch; anything else starts a new one.
+			if (message.role === "assistant") callOrder.push(...toolCallIdsFromMessage(message));
+			else callOrder = [];
+		},
+		stageToolResult(message) {
+			staged.push(message);
+		},
+	};
 }
 
 function toolCallMessageFromEntry(entry: MessageEntry): AgentMessage {
@@ -998,7 +1056,12 @@ function bashContextText(entry: BashExecutionEntry): string {
 	return bashExecutionToText(message);
 }
 
-function appendContextMessage(out: AgentMessage[], role: "user" | "assistant", text: string, timestamp: string): void {
+function appendContextMessage(
+	out: { push(message: AgentMessage): void },
+	role: "user" | "assistant",
+	text: string,
+	timestamp: string,
+): void {
 	const trimmed = text.trim();
 	if (trimmed.length === 0) return;
 	out.push(makeTextMessage(role, truncateReplayText(trimmed), timestamp));
@@ -1014,7 +1077,7 @@ export function buildReplayAgentMessagesFromTurns(
 	turns: ReadonlyArray<SessionEntry>,
 	options: RehydrateChatPanelOptions = {},
 ): AgentMessage[] {
-	const out: AgentMessage[] = [];
+	const out = createOrderedReplaySink();
 	const seenToolCalls = new Set<string>();
 	for (const entry of selectReplayEntries(turns, options)) {
 		switch (entry.kind) {
@@ -1035,7 +1098,7 @@ export function buildReplayAgentMessagesFromTurns(
 						recordToolCallsFromMessage(message, seenToolCalls);
 					}
 				} else if (entry.role === "tool_result") {
-					out.push(toolResultMessageFromEntry(entry));
+					out.stageToolResult(toolResultMessageFromEntry(entry));
 				} else if (entry.role === "system") {
 					appendContextMessage(out, "user", `System note: ${text}`, entry.timestamp);
 				}
@@ -1082,7 +1145,8 @@ export function buildReplayAgentMessagesFromTurns(
 				break;
 		}
 	}
-	return out;
+	out.flush();
+	return out.messages;
 }
 
 /**

package/src/interactive/dispatch-board.ts

@@ -6,6 +6,7 @@ import {
 	type DispatchProgressPayload,
 	type DispatchRunIdentity,
 } from "../core/bus-events.js";
+import { resolveDispatchFailureStatus } from "../core/dispatch-outcome.js";
 import type { SafeEventBus } from "../core/event-bus.js";
 import { rawDurationMs } from "../core/timers.js";
 import type { AgentAudience } from "../domains/agents/spec.js";
@@ -37,7 +38,7 @@ import {
 	type ObservabilityNotice,
 	type ObservabilitySnapshot,
 } from "../domains/observability/index.js";
-import { type CostProvenance, foregroundStreamUsage } from "../domains/providers/index.js";
+import { type CostProvenance, foregroundStreamUsage, resolveCostProvenance } from "../domains/providers/index.js";
 import { sanitizeCallTargetText } from "../domains/safety/call-target.js";
 import { type Component, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "../engine/tui.js";
 import { formatWorkerContextMeter } from "./context-meter.js";
@@ -121,7 +122,7 @@ export interface DispatchBoardRow {
 	gate?: { role: string; cycle: number };
 	council?: { group: string; label: string; color?: string; round: number };
 	/** Orchestrator-executed declared verification status. */
-	hostVerification?: "verified" | "rejected" | "skipped";
+	hostVerification?: "verified" | "rejected" | "skipped" | "not_implicated";
 	/**
 	 * The canonical trust projection of the sealed receipt, read back from
 	 * disk and authenticated against the ledger row. Absent while the run is
@@ -1285,12 +1286,6 @@ function resolveAgentEndStatus(rawMessages: unknown): DispatchBoardStatus | null
 	return null;
 }
 
-function resolveFailedStatus(reason: unknown): DispatchBoardStatus {
-	if (reason === "dead" || reason === "stalled") return "dead";
-	if (reason === "interrupted" || reason === "canceled") return "aborted";
-	return "failed";
-}
-
 function resolveFailureDetail(
 	payload: Partial<DispatchFailedPayload>,
 	fallback: string | null | undefined,
@@ -1601,7 +1596,7 @@ export function createDispatchBoardStore(
 			entry.durationMs = parseFiniteNumber(payload.durationMs, Math.max(0, rawDurationMs(entry.startedAtMs, now)));
 			entry.tokenCount = parseFiniteNumber(payload.tokenCount, entry.tokenCount);
 			entry.costUsd = parseFiniteNumber(payload.costUsd, entry.costUsd);
-			entry.costProvenance = payload.costProvenance ?? "unknown";
+			entry.costProvenance = resolveCostProvenance(payload.costProvenance, entry.costProvenance ?? "unknown");
 			entry.outcomeDetail = null;
 			if (payload.hostVerification !== undefined) entry.hostVerification = payload.hostVerification;
 			settleFromReceipt(entry);
@@ -1621,7 +1616,7 @@ export function createDispatchBoardStore(
 			const payload: Partial<DispatchFailedPayload> = raw ?? {};
 			const runId = parseRunId(payload.runId);
 			const previousStatus = runId !== null ? entries.get(runId)?.status : undefined;
-			const resolvedStatus = resolveFailedStatus(payload.reason);
+			const resolvedStatus = resolveDispatchFailureStatus(payload.reason);
 			const status = previousStatus === "dead" && resolvedStatus === "failed" ? "dead" : resolvedStatus;
 			const entry = upsertBase(payload, status, now);
 			if (!entry) return;
@@ -1630,7 +1625,7 @@ export function createDispatchBoardStore(
 			entry.durationMs = parseFiniteNumber(payload.durationMs, Math.max(0, rawDurationMs(entry.startedAtMs, now)));
 			entry.tokenCount = parseFiniteNumber(payload.tokenCount, entry.tokenCount);
 			entry.costUsd = parseFiniteNumber(payload.costUsd, entry.costUsd);
-			entry.costProvenance = payload.costProvenance ?? "unknown";
+			entry.costProvenance = resolveCostProvenance(payload.costProvenance, entry.costProvenance ?? "unknown");
 			entry.outcomeDetail = resolveFailureDetail(payload, entry.outcomeDetail);
 			if (payload.hostVerification !== undefined) entry.hostVerification = payload.hostVerification;
 			settleFromReceipt(entry);

package/src/interactive/footer/widgets.ts

@@ -368,6 +368,13 @@ function contextComposition(context: ContextEngineFacts): {
 	};
 }
 
+/** The live window after the percent; null when unknown or the row is too narrow to carry it. */
+export function compactContextWindowLabel(context: ContextEngineFacts, width: number): string | null {
+	if (width < 72) return null;
+	const window = finiteNonNegative(context.ledger?.contextWindow ?? context.contextWindow);
+	return window > 0 ? formatFooterTokens(window) : null;
+}
+
 export function compactSecondaryLine(
 	context: ContextEngineFacts,
 	agent: AgentWorkFacts,
@@ -403,6 +410,12 @@ export function compactSecondaryLine(
 	} else {
 		left = buildSegmentedContextBar(theme, barCells, context.contextWindow ?? 0, contextBreakdownForBar(context));
 	}
+	// A percentage alone does not say whether the window is 128k or 1M, so at
+	// widths that can afford it the live window follows the percent. It comes
+	// from the ledger when one is bound (the layer that answered the window is
+	// also the layer that produced the percent) and from the facts otherwise.
+	const windowLabel = compactContextWindowLabel(context, safeWidth);
+	if (windowLabel) left = `${left} ${theme.fg("dim", "of")} ${theme.fg("muted", windowLabel)}`;
 	const maxRightWidth = Math.max(0, safeWidth - visibleWidth(left) - 1);
 	const right = buildMetricStrip(
 		theme,

package/src/interactive/interactive-application.ts

@@ -46,6 +46,7 @@ import type { createMuxBridge } from "./mux-bridge.js";
 import { createOverlayLifecycle, type OverlayLifecycleController, type OverlayState } from "./overlay-lifecycle.js";
 import { interopOverlaySurface } from "./overlays/interop.js";
 import { paneWatchDecision } from "./pane-policy.js";
+import { describePanesLeftBehind } from "./panes-runtime.js";
 import { writeInputWedgeDump } from "./render-trace.js";
 import { settleChatBeforeSessionSwitch } from "./session-switch-settlement.js";
 import { createSessionTranscript } from "./session-transcript.js";
@@ -54,9 +55,10 @@ import type {
 	InitCommandOptions,
 	RunIo,
 	SettingsAreaId,
+	SlashCommandContext,
 	TaskMemorySeedCommandResult,
 } from "./slash-commands.js";
-import { processAutoPacingAllowed, resolveSmoothStreamingMode } from "./stream-pacing-policy.js";
+import { processAutoPacingAllowed } from "./stream-pacing-policy.js";
 import type { TerminalLease } from "./terminal-lease.js";
 import type { createWatchPaneController } from "./watch-pane.js";
 import { createWorkspaceFacts } from "./workspace-facts.js";
@@ -121,6 +123,8 @@ export interface InteractiveDeps {
 	initialNotices?: ReadonlyArray<string>;
 	resources?: ResourcesContract;
 	extensions?: ExtensionsContract;
+	/** `/resources extensions reload` seam; the composition root supplies the coordinator. */
+	reloadExtensions?: SlashCommandContext["reloadExtensions"];
 	interop?: InteropContract;
 	share?: ShareContract;
 	/**
@@ -311,6 +315,8 @@ export interface KeyBindingDeps {
 	requestShutdown: () => void;
 	toggleStatus: () => void;
 	toggleDispatchBoard: () => void;
+	/** `/files` as a key: open the files pane when closed, close it when open. */
+	toggleFilesPane: () => void;
 	openTasks: () => void;
 	openDecisions: () => void;
 	backgroundDispatch: () => void;
@@ -396,6 +402,9 @@ function dispatchInteractiveAction(id: ClioKeybinding, deps: KeyBindingDeps): bo
 		case "clio-coder.dispatchBoard.toggle":
 			deps.toggleDispatchBoard();
 			return true;
+		case "clio-coder.files.toggle":
+			deps.toggleFilesPane();
+			return true;
 		case "clio-coder.tasks.open":
 			deps.openTasks();
 			return true;
@@ -430,6 +439,7 @@ export function routeInteractiveKey(data: string, deps: KeyBindingDeps): boolean
 		"clio-coder.thinking.cycle",
 		"clio-coder.session.tree",
 		"clio-coder.dispatchBoard.toggle",
+		"clio-coder.files.toggle",
 		"clio-coder.tasks.open",
 		"clio-coder.decisions.open",
 		"clio-coder.dispatch.background",
@@ -448,7 +458,7 @@ export function routeInteractiveKey(data: string, deps: KeyBindingDeps): boolean
 }
 
 export async function createInteractiveApplication(deps: InteractiveDeps): Promise<number> {
-	const initialSmoothStreaming = resolveSmoothStreamingMode(deps.getSettings?.().interface.smoothStreaming ?? "off");
+	const initialSmoothStreaming = deps.getSettings?.().interface.smoothStreaming ?? "off";
 	const initialAutoPacingAllowed = processAutoPacingAllowed(false);
 	const lease = deps.terminalLease;
 	const shell =
@@ -606,7 +616,7 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 					getDraft: () => editor.getText(),
 					setDraft: (text) => editor.setText(text),
 					requestRender: () => tui.requestRender(),
-					notice: (level, text) => notify(level, text, `yazi:${level}`),
+					notice: (level, text) => notify(level, text, `files:${level}`),
 					getCwd: () => process.cwd(),
 					getSettings: () =>
 						deps.getSettings?.().interface.panes.files ?? {
@@ -672,7 +682,7 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 		appendTranscriptNotice: (level, text) => appendNotice(level, text, busNoticeSink),
 		refreshSettingsOverlay: () => overlayLifecycle.refreshSettingsOverlay(),
 		onConfigHotReload: (settings) => {
-			const mode = resolveSmoothStreamingMode(settings.interface.smoothStreaming);
+			const mode = settings.interface.smoothStreaming;
 			const autoAllowed = processAutoPacingAllowed(shell.hasObservedBackpressure());
 			chatRenderer.setSmoothStreamingMode(mode);
 			shell.setStreamPacingActive(mode === "on" || (mode === "auto" && autoAllowed));
@@ -702,6 +712,7 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 		settleVisibleFrame: (reason) => chatRenderer.flushAndCommit(reason),
 		...(deps.resources ? { resources: deps.resources } : {}),
 		...(deps.extensions ? { extensions: deps.extensions } : {}),
+		...(deps.reloadExtensions ? { reloadExtensions: deps.reloadExtensions } : {}),
 		...(interopSurface ? { interop: interopSurface } : {}),
 		...(deps.agents ? { agents: deps.agents } : {}),
 		...(deps.share ? { share: deps.share } : {}),
@@ -1056,6 +1067,25 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 				if (deps.onCycleScopedModelBackward?.() === false) announceEmptyScopedSet();
 			},
 			backgroundActiveDispatch,
+			toggleFilesPane: () => {
+				const panes = deps.panes;
+				if (!panes) {
+					notify(
+						"info",
+						"the files pane is inactive: this session started without panes. Restart with `clio-coder --with-panes`, or set interface.panes.enabled=auto",
+						"files:info",
+					);
+					return;
+				}
+				void panes.files("toggle").then((result) => {
+					if (result.status === "opened") {
+						if (result.paneId !== null)
+							notify("success", `files pane ${result.existing ? "focused" : "opened"}`, "files:open");
+					} else if (result.status === "closed") notify("info", "files pane closed", "files:close");
+					else if (result.status === "missing-binary") notify("warning", result.detail, "files:missing");
+					else notify("warning", result.reason, "files:refused");
+				});
+			},
 		},
 		overlay: overlayLifecycle,
 		refreshFooter: () => footer.refresh(),
@@ -1137,6 +1167,11 @@ export async function createInteractiveApplication(deps: InteractiveDeps): Promi
 		},
 		cancelParkedCalls: (reason) => deps.toolRegistry?.cancelParkedCalls(reason),
 		onShutdown: async () => {
+			// The terminal is already stopped here and the domains have not, so this
+			// is the one moment a plain line about the pane host can both be read
+			// and still see the registry that shutdown is about to forget.
+			const leftBehind = mux && mux.mode !== "none" && mux.available() ? describePanesLeftBehind(mux) : null;
+			if (leftBehind !== null) process.stderr.write(`${leftBehind}\n`);
 			try {
 				if (dumpInputWedgeOnTerminate) process.off("SIGTERM", dumpInputWedgeOnTerminate);
 				await deps.onShutdown();

package/src/interactive/interactive-input-runtime.ts

@@ -21,6 +21,7 @@ export interface InteractiveInputKeyActionDeps {
 	requestShutdown: () => void;
 	toggleStatus: () => void;
 	toggleDispatchBoard: () => void;
+	toggleFilesPane: () => void;
 	openTasks: () => void;
 	openDecisions: () => void;
 	backgroundDispatch: () => void;
@@ -54,6 +55,8 @@ export interface InteractiveInputRuntimeDeps {
 		cycleScopedModelBackward(): void;
 		/** Convert the newest attached dispatch into a detached batch and notice the outcome. */
 		backgroundActiveDispatch(): void;
+		/** Toggle the files pane; the application decides what "inactive" says. */
+		toggleFilesPane(): void;
 	};
 	overlay: {
 		getState(): OverlayState;
@@ -154,6 +157,7 @@ export function createInteractiveInputRuntime(deps: InteractiveInputRuntimeDeps)
 		openTasks: deps.overlay.openTasksOverlayState,
 		openDecisions: deps.overlay.openDecisionsOverlayState,
 		backgroundDispatch: deps.actions.backgroundActiveDispatch,
+		toggleFilesPane: deps.actions.toggleFilesPane,
 		openModelSelector: deps.overlay.openModelOverlayState,
 		openTree: deps.overlay.openTreeOverlayState,
 		cycleScopedModelForward: () => {

package/src/interactive/interactive-presentation.ts

@@ -37,7 +37,7 @@ import { createSlashCommandAutocompleteProvider } from "./slash-autocomplete.js"
 import { parseSlashCommand, type RunIo } from "./slash-commands.js";
 import { createStatusController, type StatusController, type TurnSummary } from "./status/index.js";
 import type { SmoothStreamingMode } from "./stream-pacer.js";
-import { processAutoPacingAllowed, resolveSmoothStreamingMode } from "./stream-pacing-policy.js";
+import { processAutoPacingAllowed } from "./stream-pacing-policy.js";
 import { formatTargetLabel } from "./theme/index.js";
 import { createWelcomeDashboard, type WelcomeDashboardComponent } from "./welcome-dashboard.js";
 import { readWorkerReceiptFacts } from "./worker-receipts.js";
@@ -452,7 +452,7 @@ export function createInteractivePresentation(deps: InteractivePresentationDeps)
 			? {
 					streamIngress: deps.resolveStreamIngress,
 					getSmoothStreamingMode: () => {
-						const mode = resolveSmoothStreamingMode(deps.getSettings?.().interface.smoothStreaming ?? "off");
+						const mode = deps.getSettings?.().interface.smoothStreaming ?? "off";
 						const autoAllowed = processAutoPacingAllowed(deps.hasObservedBackpressure?.() ?? false);
 						deps.onSmoothStreamingMode?.(mode, mode === "on" || (mode === "auto" && autoAllowed));
 						return mode;

package/src/interactive/interactive-slash-runtime.ts

@@ -79,6 +79,7 @@ export interface InteractiveSlashRuntimeDeps {
 	chatPanel: SlashChatPanel;
 	resources?: SlashResources;
 	extensions?: SlashExtensions;
+	reloadExtensions?: SlashCommandContext["reloadExtensions"];
 	interop?: SlashCommandContext["interop"];
 	agents?: SlashAgents;
 	share?: SlashShare;
@@ -566,6 +567,7 @@ export function createInteractiveSlashRuntime(deps: InteractiveSlashRuntimeDeps)
 		openAgents: deps.openAgents,
 		openPrompts: deps.openPrompts,
 		openExtensions: deps.openExtensions,
+		...(deps.reloadExtensions ? { reloadExtensions: deps.reloadExtensions } : {}),
 		...(deps.openInterop ? { openInterop: deps.openInterop } : {}),
 		...(deps.interop ? { interop: deps.interop } : {}),
 		setEditorText: (text) => {

package/src/interactive/overlays/extensions.ts

@@ -10,7 +10,15 @@ export const EXTENSIONS_EMPTY =
 export function openExtensionsOverlay(tui: TUI, ctx: SlashCommandContext, onClose: () => void): OverlayHandle {
 	const list = ctx.listExtensions?.() ?? [];
 	const items: ListOverlayItem[] = list.map((ext) => {
-		const state = !ext.enabled ? "disabled" : ext.effective ? "active" : `shadowed:${ext.overriddenBy ?? "higher"}`;
+		const state = !ext.valid
+			? "invalid"
+			: !ext.compatible
+				? "incompatible"
+				: !ext.enabled
+					? "disabled"
+					: ext.loadable
+						? "active"
+						: `shadowed:${ext.overriddenBy ?? "higher"}`;
 
 		let meta = state;
 		if (state === "active") {

package/src/interactive/overlays/help-reference.ts

@@ -101,6 +101,19 @@ export function openHelpOverlay(
 				"**Tasks versus runs**: `/tasks` shows the agent's plan steps. Fleet runs are concrete delegated worker executions and remain in this board as recent terminal history.",
 			],
 		},
+		{
+			id: "topic-files-pane",
+			label: `${"panes & files".padEnd(30)}The files pane, the logs and shell panes, and what closes them`,
+			group: "Topics",
+			detail: () => [
+				"# Panes & files",
+				"**Where it works**: a session started inside a herdr pane with `clio-coder --with-panes` (or `interface.panes.enabled: auto`). Outside herdr `/files` still works as a full-screen pick that returns to the composer; `/panes open logs|shell` do not.",
+				"**Files pane**: `/files` or the Files toggle key (Alt+E by default) opens the file view below the session and moves the keyboard into it; the same key or command closes it. `/files pick` borrows it for one selection. It is off until `interface.panes.files.enabled` is `true`.",
+				"**Picking**: navigate, select with Space for several, then Ctrl+Y (or Enter in pick mode). The paths land in the composer as `@file` mentions and the keyboard returns to the composer.",
+				"**Logs and shell**: `/panes open logs` follows the newest dispatched run's journal; `/panes open shell` opens a shell in the workspace. A second open focuses the pane that is already there. `/panes close <name|all>` closes them; `/quit` closes the docks it manages (files, workers), leaves a shell or logs pane you opened, and prints which panes it left and how to close them.",
+				"**Engine**: the files pane runs a vendored file manager installed with `clio-coder tools install yazi`; `clio-coder doctor` and `/panes` say whether it resolved.",
+			],
+		},
 		{
 			id: "topic-steering-modes",
 			label: `${"steering modes".padEnd(30)}Interrupt, next slot, or end of turn: when a message lands mid-run`,

package/src/interactive/overlays/settings.ts

@@ -200,7 +200,7 @@ export const SETTINGS_LABELS_BY_ID = {
 	"panes.journal": "Run event journal",
 	"panes.yazi.enabled": "Files pane",
 	"panes.yazi.mode": "Files pane mode",
-	"panes.yazi.profile": "Yazi profile",
+	"panes.yazi.profile": "Files pane profile",
 	"panes.yazi.followCwd": "Follow conversation cwd",
 	"panes.yazi.ratio": "Files dock share",
 	scope: "Model cycle set",
@@ -208,6 +208,7 @@ export const SETTINGS_LABELS_BY_ID = {
 	"modelSelector.favorites": "Pinned favorites",
 	"budget.sessionCeilingUsd": "Session ceiling (USD)",
 	"defaults.maxTokens": "Output budget (tokens)",
+	"context.toolResultMaxBytes": "Tool result cap (bytes)",
 	"budget.concurrency": "Fleet concurrency",
 	"guardrails.turnToolCallBudget": "Turn tool-call budget",
 	"guardrails.workerToolCallCap": "Worker tool-call cap",
@@ -326,6 +327,7 @@ export const SETTINGS_SECTION_ROWS = {
 	budget: [
 		"budget.sessionCeilingUsd",
 		"defaults.maxTokens",
+		"context.toolResultMaxBytes",
 		"budget.concurrency",
 		"guardrails.turnToolCallBudget",
 		"guardrails.workerToolCallCap",
@@ -414,9 +416,10 @@ const SETTINGS_DESCRIPTIONS_BY_ID = {
 	"panes.layout": "What composes itself at interactive boot: nothing, the workers dock, or workers plus files.",
 	"panes.workers.ratio": "Share of the width the workers dock takes, at most half.",
 	"panes.journal": "Whether every dispatched run's event tail is written to disk for `clio-coder fleet view`.",
-	"panes.yazi.enabled": "Whether `/panes open yazi` may open the files pane or one-shot chooser.",
-	"panes.yazi.mode": "Keep Yazi beside the conversation, or close it after one selection.",
-	"panes.yazi.profile": "Use Clio's managed pick profile or leave the operator's Yazi profile untouched.",
+	"panes.yazi.enabled":
+		"Whether `/files`, its key, and `/panes open files` may open the files pane or the one-shot pick.",
+	"panes.yazi.mode": "Keep the files pane beside the conversation, or close it after one selection.",
+	"panes.yazi.profile": "Use Clio's managed, themed engine profile or the operator's own file-manager configuration.",
 	"panes.yazi.followCwd": "Push the conversation directory into an already-open companion pane.",
 	"panes.yazi.ratio": "Share of the height the files dock takes, at most half.",
 	scope: "Alt+J and Alt+K model cycle set.",
@@ -424,6 +427,7 @@ const SETTINGS_DESCRIPTIONS_BY_ID = {
 	"modelSelector.favorites": "Exact target/model refs pinned in /model.",
 	"budget.sessionCeilingUsd": "Per-session cost cap.",
 	"defaults.maxTokens": "Output tokens requested per turn, applied to every target.",
+	"context.toolResultMaxBytes": "Maximum bytes returned from one tool result before the full text spills to scratch.",
 	"budget.concurrency": "Parallel workers allowed during dispatch.",
 	"guardrails.turnToolCallBudget": "Soft per-turn tool-call budget for this chat loop.",
 	"guardrails.workerToolCallCap": "Lifetime ceiling on tool calls one dispatched worker may execute.",
@@ -475,6 +479,8 @@ const SETTINGS_HELP_BY_ID: Partial<Record<EditableSettingId, string>> = {
 		"read-only observes; suggest parks non-read calls; auto-edit edits, dispatches, and runs recognized commands; full-auto runs except command substitution and system-level changes. A confirmation marked exposure=outward parks for you at suggest and auto-edit.",
 	"defaults.maxTokens":
 		"Clamped down to each model's max-output cap and the remaining context window. Set 0 to use per-model caps only.",
+	"context.toolResultMaxBytes":
+		"The 192KB per-turn observation pool remains authoritative. Three full 64KB results consume it, so a fourth finds it filled. Whole number of at least 4096 bytes · default: 65536 (64KB).",
 	"compaction.threshold":
 		"pressure = estimated tokens ÷ context window. Higher keeps more history but risks overflow before a summary runs.",
 	"context.workingSet.enabled":
@@ -487,17 +493,17 @@ const SETTINGS_HELP_BY_ID: Partial<Record<EditableSettingId, string>> = {
 	"context.workingSet.minEvictableTokens":
 		"The floor sweep put marker break-even near 50 tokens; 200 is the churn guard. Whole number, 0 evicts anything · default: 200.",
 	"guardrails.turnToolCallBudget":
-		"Crossing it blocks further calls in the turn with a stop-and-summarize directive, and the hard interrupt ceiling sits a fixed margin above. A backstop against a model spraying unproductive calls, not a routine ceiling: a repo-wide audit legitimately runs dozens. Whole number of at least 1 · default: 60. Env override CLIO_CODER_TURN_TOOL_CALL_BUDGET beats this value.",
+		"Crossing it blocks further calls in the turn with a stop-and-summarize directive, and the hard interrupt ceiling sits a fixed margin above. A backstop against a model spraying unproductive calls, not a routine ceiling: a repo-wide audit legitimately runs dozens. Whole number of at least 1 · default: 60.",
 	"guardrails.workerToolCallCap":
-		"Bounds admitted calls, not attempts: a call the harness refuses never ran and never spends the cap. Dispatch takes the smaller of this and the agent recipe's own budget, so the recipe normally binds. Whole number of at least 1 · default: 150. Env override CLIO_CODER_WORKER_TOOL_CALL_CAP beats this value.",
+		"Bounds admitted calls, not attempts: a call the harness refuses never ran and never spends the cap. Dispatch takes the smaller of this and the agent recipe's own budget, so the recipe normally binds. Whole number of at least 1 · default: 150.",
 	"guardrails.maxDispatchRuns":
-		"Runs leaving the ring also lose their event journal directory. Whole number of at least 1 · default: 1000. Env override CLIO_CODER_MAX_DISPATCH_RUNS beats this value.",
+		"Runs leaving the ring also lose their event journal directory. Whole number of at least 1 · default: 1000.",
 	"guardrails.readMaxBytes":
-		"Clamped up to a 1KB floor at use. Whole number of bytes, at least 1 · default: 51200 (50KB). Env override CLIO_CODER_READ_MAX_BYTES beats this value.",
+		"Clamped up to a 1KB floor at use. Whole number of bytes, at least 1 · default: 51200 (50KB).",
 	"guardrails.observationTurnBudgetBytes":
-		"One pool shared by every observation-producing tool in a turn, so a single verbose tool cannot starve the rest. Whole number of bytes, at least 1 · default: 196608 (192KB). Env override CLIO_CODER_OBSERVATION_TURN_BUDGET_BYTES beats this value.",
+		"One pool shared by every observation-producing tool in a turn, so a single verbose tool cannot starve the rest. Whole number of bytes, at least 1 · default: 196608 (192KB).",
 	"guardrails.internalDispatchTimeoutMs":
-		"Covers the wiki documenter and the bootstrap scout. Continuous output satisfies the heartbeat watchdog and a run mid-generation spends no tool calls, so this is the only guard that ends a degenerate generator. Healthy runs finish in minutes. Whole milliseconds of at least 1 · default: 900000 (15 minutes). Env override CLIO_CODER_INTERNAL_DISPATCH_TIMEOUT_MS beats this value.",
+		"Covers the wiki documenter and the bootstrap scout. Continuous output satisfies the heartbeat watchdog and a run mid-generation spends no tool calls, so this is the only guard that ends a degenerate generator. Healthy runs finish in minutes. Whole milliseconds of at least 1 · default: 900000 (15 minutes).",
 	"retry.streamStallMs":
 		"Measured from the last token received, not from the request, so a slow-but-alive stream is never aborted. The retry then follows the same enabled/maxRetries/delay settings above. Whole milliseconds · default: 180000 (three minutes).",
 	"library.catalog":
@@ -593,14 +599,11 @@ const SETTINGS_VALUE_HELP_BY_ID: Partial<Record<EditableSettingId, Record<string
 		true: "compact automatically before a turn crosses the threshold",
 		false: "context is only compacted when you run /context compact",
 	},
-	// `embedded` is a declared rung with no implementation behind it, and a row
-	// that offered it beside two working values read as a third working value.
-	// It stays selectable, because refusing it outright would break a settings
-	// file that names it, but nothing here lets an operator pick it believing
-	// they will get panes.
+	// `embedded` is a declared rung with no implementation behind it yet; it
+	// runs as `auto` until Clio can own a pane host, and the hint says so.
 	"panes.enabled": {
 		auto: "detect a herdr session and join it as a guest; no pane host, no panes",
-		embedded: "NOT IMPLEMENTED (ships in phase 5): this session gets no panes at all, guest mode included",
+		embedded: "not implemented yet; behaves as auto (guest mode inside herdr) until Clio can own a pane host",
 		off: "never detect or open a pane",
 	},
 	"retry.enabled": {
@@ -1838,6 +1841,9 @@ function buildSettingItems(settings: Readonly<ClioSettings>, options?: BuildSett
 		settingItem("defaults.maxTokens", String(settings.chat.maxOutputTokens), {
 			values: ["0", "4096", "8192", "16384", "32768", "65536", "131072"],
 		}),
+		settingItem("context.toolResultMaxBytes", String(settings.context.toolResultMaxBytes), {
+			values: ["4096", "8192", "16384", "32768", "65536", "131072"],
+		}),
 		settingItem("budget.concurrency", String(settings.fleet.concurrency), {
 			values: ["auto", "1", "2", "4", "8"],
 		}),
@@ -2707,6 +2713,11 @@ function applySettingChange(settings: ClioSettings, id: string, value: string):
 				else settings.fleet.limits.internalRunTimeoutMs = next;
 			});
 			return;
+		case "context.toolResultMaxBytes":
+			applyNonNegativeInteger(value, (next) => {
+				if (next >= 4096) settings.context.toolResultMaxBytes = next;
+			});
+			return;
 		case "context.workingSet.enabled":
 			if (value === "true" || value === "false") settings.context.workingSet.enabled = value === "true";
 			return;