@iowarp/clio-coder 0.4.0 → 0.4.1

package/src/interactive/chat-loop.ts

@@ -215,7 +215,7 @@ export interface ChatSubmitOptions {
  * the turn runtime's own local fallback, so a `/btw` round against a local
  * server authenticates exactly the way a turn against it does.
  */
-const LOCAL_SIDE_QUESTION_API_KEY = "clio-local-target";
+const LOCAL_SIDE_QUESTION_API_KEY = "clio-coder-local-target";
 
 /** Closing notice an operator interrupt leaves in the transcript and the ledger. */
 const INTERRUPT_CANCEL_REASON = "[Clio Coder] run interrupted by operator; delivering the new message now.";
@@ -372,7 +372,7 @@ export interface CreateChatLoopDeps {
 	/**
 	 * Whitelist of target ids that the chat-loop is allowed to drive. The
 	 * orchestrator composes this from `providers.list()` so an unknown
-	 * `settings.orchestrator.target` surfaces a configuration error before
+	 * `settings.chat.target` surfaces a configuration error before
 	 * the agent is constructed.
 	 */
 	knownTargets: () => ReadonlySet<string>;
@@ -527,7 +527,7 @@ export interface CreateChatLoopDeps {
 	registerPrewarmEndpointSlot?: (runtime: AgentRuntime) => (() => void) | null;
 }
 
-export function reloadProtectedArtifactsForSession(
+function reloadProtectedArtifactsForSession(
 	protectedArtifacts: NonNullable<CreateChatLoopDeps["protectedArtifacts"]>,
 	readSessionEntries: (() => ReadonlyArray<SessionEntry>) | undefined,
 ): void {
@@ -547,7 +547,7 @@ export function createChatLoop(deps: CreateChatLoopDeps): ChatLoop {
 	const sideQuestionRound = deps.runSideQuestion ?? runSideQuestion;
 	const handoffRound = deps.runHandoffRound ?? runHandoffRound;
 	const middlewareToolChoice = deps.middlewareToolChoice ?? createMiddlewareToolChoiceControl();
-	const state = createTurnState(deps.getSettings().orchestrator.thinkingLevel ?? "off");
+	const state = createTurnState(deps.getSettings().chat.thinkingLevel ?? "off");
 	const toolStartTimes = new Map<string, number>();
 
 	const preparationListeners = new Set<(phase: TurnPreparationPhase) => void>();
@@ -639,13 +639,13 @@ export function createChatLoop(deps: CreateChatLoopDeps): ChatLoop {
 	 * collapsing them sent a client with a configured target to the wrong fix.
 	 */
 	const nullRuntimeAdmissionReason = (): string => {
-		const orchestrator = deps.getSettings().orchestrator;
+		const orchestrator = deps.getSettings().chat;
 		const target = orchestrator.target?.trim() ?? "";
 		const model = orchestrator.model?.trim() ?? "";
 		return target.length > 0 && model.length === 0 ? "model-not-configured" : "orchestrator-not-configured";
 	};
 
-	const retrySettings = (): RetrySettings => normalizeRetrySettings(deps.getSettings().retry);
+	const retrySettings = (): RetrySettings => normalizeRetrySettings(deps.getSettings().chat.retry);
 
 	const currentToolInvokeOptions = (): Partial<ToolInvokeOptions> => {
 		const options: Partial<ToolInvokeOptions> = {};
@@ -1088,7 +1088,7 @@ export function createChatLoop(deps: CreateChatLoopDeps): ChatLoop {
 			// 4. Preflight overflow check, before the user turn is committed.
 			// A blocked request must not leave a dangling user entry that the
 			// next replay would treat as an unanswered turn.
-			const compactionThreshold = deps.getSettings().compaction?.threshold ?? null;
+			const compactionThreshold = deps.getSettings().context.compaction?.threshold ?? null;
 			const captureTurnSnapshot = (turnId: string): ContextSnapshot =>
 				context.captureRuntimeContextSnapshot(agentRuntime, turnId, compactionThreshold, {
 					promptSegments: compiledPrompt
@@ -1179,7 +1179,7 @@ export function createChatLoop(deps: CreateChatLoopDeps): ChatLoop {
 				runtimeId: agentRuntime.runtimeId,
 				runtimeKind: agentRuntime.runtimeResolution.runtimeKind,
 				wireModelId: agentRuntime.wireModelId,
-				autonomy: deps.getSettings().autonomy,
+				autonomy: deps.getSettings().safety.autonomy,
 				compiledPromptHash: promptHash,
 				staticCompositionHash: promptHash,
 				promptSignature: promptHash,

package/src/interactive/chat-panel.ts

@@ -384,7 +384,7 @@ export interface ChatPanel extends Component {
 
 export interface ChatPanelOptions {
 	/**
-	 * Resolves the user-visible key string for the `clio.tool.expand`
+	 * Resolves the user-visible key string for the `clio-coder.tool.expand`
 	 * action, which folds and unfolds the newest tool call or worker block.
 	 * Returning a non-empty string surfaces a dim ` (<key>)` hint on the one
 	 * surface the key would act on: the latest finished collapsed tool subline,

package/src/interactive/clio-editor.ts

@@ -1,4 +1,12 @@
-import { Editor, stripTerminalSequences, type TUI, truncateToWidth, visibleWidth } from "../engine/tui.js";
+import {
+	Editor,
+	getKeybindings,
+	stripTerminalSequences,
+	type TUI,
+	truncateToWidth,
+	visibleWidth,
+} from "../engine/tui.js";
+import { guardPastedEditorOperator } from "./editor-bash.js";
 import { fitHintEntries } from "./overlay-frame.js";
 import { type PermissionInspectionHint, permissionHintEntries } from "./permission-hint.js";
 import type { ClioTheme } from "./theme/index.js";
@@ -154,7 +162,50 @@ function findBottomRail(lines: readonly string[], width: number): number {
 	return -1;
 }
 
+function cursorEndsDirectoryPath(editor: Editor): boolean {
+	const cursor = editor.getCursor();
+	const line = editor.getLines()[cursor.line] ?? "";
+	return line.slice(0, cursor.col).endsWith("/");
+}
+
+function remapPastedBangOffsets(
+	before: string,
+	after: string,
+	offsets: ReadonlySet<number>,
+	markInsertedAsPasted: boolean,
+): Set<number> {
+	let prefix = 0;
+	while (prefix < before.length && prefix < after.length && before[prefix] === after[prefix]) prefix += 1;
+	let beforeEnd = before.length;
+	let afterEnd = after.length;
+	while (beforeEnd > prefix && afterEnd > prefix && before[beforeEnd - 1] === after[afterEnd - 1]) {
+		beforeEnd -= 1;
+		afterEnd -= 1;
+	}
+
+	const next = new Set<number>();
+	const shift = afterEnd - prefix - (beforeEnd - prefix);
+	for (const offset of offsets) {
+		if (offset < prefix) next.add(offset);
+		else if (offset >= beforeEnd) next.add(offset + shift);
+	}
+	if (markInsertedAsPasted) {
+		for (let offset = prefix; offset < afterEnd; offset += 1) {
+			if (after[offset] === "!") next.add(offset);
+		}
+	}
+	return next;
+}
+
+function startsWithPastedOperator(text: string, pastedBangOffsets: ReadonlySet<number>): boolean {
+	const first = text.search(/\S/u);
+	return first >= 0 && text[first] === "!" && pastedBangOffsets.has(first);
+}
+
 export class ClioEditor extends Editor {
+	private pastedBangOffsets = new Set<number>();
+	private bracketedPasteActive = false;
+
 	constructor(
 		tui: TUI,
 		private readonly chrome: EditorChrome,
@@ -213,6 +264,15 @@ export class ClioEditor extends Editor {
 		return lines;
 	}
 
+	/**
+	 * Preserve paste provenance for every immediate-send binding, including the
+	 * alternate paths that invoke the submit controller without an Editor Enter.
+	 */
+	getTextForSubmit(): string {
+		const text = this.getExpandedText();
+		return startsWithPastedOperator(this.getText(), this.pastedBangOffsets) ? guardPastedEditorOperator(text) : text;
+	}
+
 	/**
 	 * pi-tui's bracketed-paste handling inserts pasted text (including a
 	 * trailing newline the paste carried) without submitting: a pasted
@@ -222,8 +282,46 @@ export class ClioEditor extends Editor {
 	 * through the same handler the typed-Enter path uses.
 	 */
 	override handleInput(data: string): void {
+		const openedPaste = data.includes("\x1b[200~");
 		const closedPaste = data.includes("\x1b[201~");
+		const pasteMutation = this.bracketedPasteActive || openedPaste;
+		const textBeforeInput = this.getText();
+		const keybindings = getKeybindings();
+		// Pi expands and trims the buffer immediately before onSubmit. Envelope a
+		// pasted bang draft for that synchronous handoff so the Bash parser can
+		// distinguish it from a typed operator; the submit controller unwraps it
+		// before sending the literal prompt onward.
+		if (
+			startsWithPastedOperator(textBeforeInput, this.pastedBangOffsets) &&
+			keybindings.matches(data, "tui.input.submit")
+		) {
+			const pastedText = this.getTextForSubmit();
+			this.pastedBangOffsets.clear();
+			this.bracketedPasteActive = false;
+			super.setText(pastedText);
+			super.handleInput(data);
+			return;
+		}
+		const completingDirectory =
+			this.isShowingAutocomplete() &&
+			(keybindings.matches(data, "tui.input.tab") || keybindings.matches(data, "tui.select.confirm"));
+		const textBeforeCompletion = completingDirectory ? this.getText() : "";
 		super.handleInput(data);
+		if (completingDirectory && this.getText() !== textBeforeCompletion && cursorEndsDirectoryPath(this)) {
+			// Directory rows are submenus on the same provider. Re-open immediately
+			// after acceptance so ↑/↓ continues in the child tree without requiring
+			// a second Tab. Pi's provider request remains the only completion path.
+			super.handleInput("\t");
+		}
+		const textAfterInput = this.getText();
+		this.pastedBangOffsets = remapPastedBangOffsets(
+			textBeforeInput,
+			textAfterInput,
+			this.pastedBangOffsets,
+			pasteMutation,
+		);
+		if (openedPaste) this.bracketedPasteActive = true;
+		if (closedPaste) this.bracketedPasteActive = false;
 		if (!closedPaste) return;
 		const text = this.getText();
 		if (!text.endsWith("\n")) return;
@@ -232,4 +330,10 @@ export class ClioEditor extends Editor {
 		this.setText("");
 		this.onSubmit?.(command);
 	}
+
+	override setText(text: string): void {
+		this.pastedBangOffsets.clear();
+		this.bracketedPasteActive = false;
+		super.setText(text);
+	}
 }

package/src/interactive/context-activity.ts

@@ -6,6 +6,7 @@ import {
 	type ContextActivityStatus,
 } from "../core/bus-events.js";
 import type { SafeEventBus } from "../core/event-bus.js";
+import { wrapTextWithAnsi } from "../engine/tui.js";
 import { type ClioTheme, clioTheme, formatCompactMs, frame, GLYPH, padAnsi, spinnerFrame } from "./theme/index.js";
 
 export interface ContextActivitySnapshot {
@@ -152,17 +153,18 @@ export function formatContextActivityIslandLines(
 	const percent = `${Math.round(activityProgress(activity) * 100)}%`.padStart(4);
 	const progressLine = `${progressBar(theme, activity, barWidth)} ${theme.fg("dim", percent)}`;
 	const message = theme.fg(activity.status === "failed" ? "error" : "muted", activity.message);
-	// Every row here can outrun a narrow island: at 40 columns the trail stopped
-	// at "sta" and the message at "refreshed pr", each reading as the whole
-	// value. padAnsi's default marker is empty, so the marker is passed
-	// explicitly. The progress bar is sized to fit and never cuts.
+	// The trail is compact navigation chrome and marks its cut. The message and
+	// detail are the only explanation of this operation, so they wrap in full.
+	// The progress bar is sized to fit and never cuts.
 	const body = [
 		padAnsi(topLine, bodyWidth, GLYPH.ellipsis),
 		padAnsi(progressLine, bodyWidth),
 		phaseTrail(theme, activity, bodyWidth),
-		padAnsi(message, bodyWidth, GLYPH.ellipsis),
+		...wrapTextWithAnsi(message, bodyWidth).map((line) => padAnsi(line, bodyWidth)),
 	];
-	if (activity.detail) body.push(padAnsi(theme.fg("dim", activity.detail), bodyWidth, GLYPH.ellipsis));
+	if (activity.detail) {
+		body.push(...wrapTextWithAnsi(theme.fg("dim", activity.detail), bodyWidth).map((line) => padAnsi(line, bodyWidth)));
+	}
 	return frame(theme, "Context", body, width);
 }
 

package/src/interactive/context-meter.ts

@@ -23,7 +23,7 @@ export const CONTEXT_CATEGORY_TOKEN: Readonly<Record<ContextLedgerCategory, Clio
 	streaming: "accent",
 };
 
-export function contextCategoryGlyph(category: ContextLedgerCategory): string {
+function contextCategoryGlyph(category: ContextLedgerCategory): string {
 	const filled = visibleSingle(GLYPH.contextFull) ? GLYPH.contextFull : GLYPH.barFull;
 	const free = visibleSingle(GLYPH.contextFree) ? GLYPH.contextFree : GLYPH.barEmpty;
 	// The autocompact reserve is held-back headroom, not consumed context; it
@@ -187,7 +187,7 @@ export type WorkerContextSeverity = "healthy" | "warn" | "critical";
 export const WORKER_CONTEXT_WARN_PCT = 80;
 export const WORKER_CONTEXT_CRITICAL_PCT = 95;
 
-export function workerContextSeverity(pct: number): WorkerContextSeverity {
+function workerContextSeverity(pct: number): WorkerContextSeverity {
 	if (pct >= WORKER_CONTEXT_CRITICAL_PCT) return "critical";
 	if (pct >= WORKER_CONTEXT_WARN_PCT) return "warn";
 	return "healthy";
@@ -211,10 +211,7 @@ export interface WorkerContextView {
  * usage has been observed yet. The percentage is capped at 100: a provider
  * report past the window is a full window, not a >100% claim.
  */
-export function workerContextView(
-	usedTokens: number,
-	contextWindow: number | undefined | null,
-): WorkerContextView | null {
+function workerContextView(usedTokens: number, contextWindow: number | undefined | null): WorkerContextView | null {
 	if (contextWindow === undefined || contextWindow === null || contextWindow <= 0) return null;
 	if (!Number.isFinite(usedTokens) || usedTokens <= 0) return null;
 	const pct = Math.min(100, Math.round((usedTokens / contextWindow) * 100));

package/src/interactive/context-overlay.ts

@@ -166,7 +166,7 @@ function renderWorkingSetLines(view: WorkingSetView, config: WorkingSetConfigVie
 	];
 }
 
-export function renderContextLedgerLines(
+function renderContextLedgerLines(
 	ledger: ContextLedger,
 	contentWidth: number,
 	workingSet?: WorkingSetView | null,

package/src/interactive/cost-overlay.ts

@@ -271,7 +271,7 @@ function modelBlock(row: CostRow): string[] {
 	]);
 }
 
-export function formatCostOverlayBodyLines(
+function formatCostOverlayBodyLines(
 	totalCost: CostAggregate,
 	totalTokens: number,
 	rows: ReadonlyArray<CostRow>,

package/src/interactive/council-grid.ts

@@ -78,7 +78,7 @@ export type CouncilLayout = { mode: "grid"; columnWidth: number } | { mode: "sta
  * moment one column would fall under {@link COUNCIL_COLUMN_MIN_WIDTH}: a grid
  * where only some columns are readable is worse than no grid at all.
  */
-export function councilGridLayout(memberCount: number, contentWidth: number): CouncilLayout {
+function councilGridLayout(memberCount: number, contentWidth: number): CouncilLayout {
 	const count = Math.max(1, memberCount);
 	const usable = contentWidth - COUNCIL_COLUMN_GUTTER * (count - 1);
 	const columnWidth = Math.floor(usable / count);
@@ -124,7 +124,7 @@ function answerRows(theme: ClioTheme, member: CouncilMemberView, width: number,
  * answer. Every line is clipped to the column so a long model id or a long
  * answer line can never push a neighbouring column out of position.
  */
-export function councilMemberLines(
+function councilMemberLines(
 	theme: ClioTheme,
 	member: CouncilMemberView,
 	width: number,

package/src/interactive/dispatch-board.ts

@@ -182,10 +182,7 @@ export interface DispatchBoardPhase {
  * the column lines up across rows; a long step id is clipped with a marker
  * rather than pushing the row's other facts out of position.
  */
-export function formatDispatchPhaseCell(
-	phase: DispatchBoardPhase | undefined,
-	width = PHASE_COLUMN_WIDTH,
-): string | null {
+function formatDispatchPhaseCell(phase: DispatchBoardPhase | undefined, width = PHASE_COLUMN_WIDTH): string | null {
 	if (phase === undefined) return null;
 	return truncateToWidth(`w${phase.wave} ${phase.stepId}`, Math.max(1, width), "…", false);
 }
@@ -294,9 +291,7 @@ export interface AgentAudiencePresentation {
  * machinery. Returns null for base/custom agents, which the operator asked for
  * directly and which therefore render like any other row.
  */
-export function agentAudiencePresentation(
-	row: Pick<DispatchBoardRow, "agentAudience">,
-): AgentAudiencePresentation | null {
+function agentAudiencePresentation(row: Pick<DispatchBoardRow, "agentAudience">): AgentAudiencePresentation | null {
 	if (row.agentAudience === "shadow") return { glyph: GLYPH.subProcess, token: "muted" };
 	if (row.agentAudience === "internal") return { glyph: GLYPH.subProcess, token: "dim" };
 	return null;
@@ -439,10 +434,7 @@ function latestEvidenceFailureReason(notices: readonly ObservabilityNotice[], ru
  * summary with an evidence bundle is ready; the latest error-level evidence
  * notice for the run marks it failed.
  */
-export function deriveRunEvidenceState(
-	snapshot: ObservabilitySnapshot | undefined,
-	runId: string,
-): RunEvidencePresentation {
+function deriveRunEvidenceState(snapshot: ObservabilitySnapshot | undefined, runId: string): RunEvidencePresentation {
 	if (!snapshot || runId.length === 0) return { state: "none", viewFilter: `dispatch:${runId}` };
 	if (snapshot.pendingEvidenceBuildRunIds.includes(runId)) {
 		return { state: "pending", viewFilter: `evidence:${runId}` };
@@ -497,6 +489,16 @@ function cardUnitsLine(theme: ClioTheme, key: string, units: ReadonlyArray<strin
 	return visibleWidth(full) <= contentWidth ? full : fitUnits(theme, prefix, units, contentWidth);
 }
 
+/** A prose card value, wrapped inside the columns left by its one-time key. */
+function cardWrappedValueLines(theme: ClioTheme, key: string, value: string, contentWidth: number): string[] {
+	const prefix = cardKvKey(theme, key);
+	const prefixWidth = visibleWidth(prefix);
+	const valueWidth = Math.max(1, contentWidth - prefixWidth);
+	return wrapTextWithAnsi(value, valueWidth).map(
+		(line, index) => `${index === 0 ? prefix : " ".repeat(prefixWidth)}${line}`,
+	);
+}
+
 // The `proof` row: the colored state marker, an optional failure reason, then
 // the dim `/view` filter an operator would type.
 function evidenceCardLine(theme: ClioTheme, evidence: RunEvidencePresentation, contentWidth: number): string | null {
@@ -509,7 +511,7 @@ function evidenceCardLine(theme: ClioTheme, evidence: RunEvidencePresentation, c
 }
 
 /** Sanitize lifecycle task text at the terminal boundary and collapse it to one bounded line. */
-export function sanitizeDispatchTaskSummary(value: unknown): string | undefined {
+function sanitizeDispatchTaskSummary(value: unknown): string | undefined {
 	if (typeof value !== "string") return undefined;
 	const sanitized = sanitizeCallTargetText(value);
 	if (sanitized.length === 0) return undefined;
@@ -622,7 +624,7 @@ function trustCardLines(theme: ClioTheme, row: DispatchBoardRow, contentWidth: n
 	);
 }
 
-export function renderDispatchCard(
+function renderDispatchCard(
 	row: DispatchBoardRow,
 	width: number,
 	evidence?: RunEvidencePresentation,
@@ -715,24 +717,22 @@ export function renderDispatchCard(
 			contentWidth,
 		),
 		targetLine,
-		...(row.taskSummary
-			? [truncateToWidth(`${cardKvKey(theme, "task")}${theme.fg("muted", row.taskSummary)}`, contentWidth, "…", false)]
-			: []),
+		...(row.taskSummary ? cardWrappedValueLines(theme, "task", theme.fg("muted", row.taskSummary), contentWidth) : []),
 		cardUnitsLine(theme, "status", statusUnits, contentWidth),
 		...trustCardLines(theme, row, contentWidth),
 		...(row.budget !== undefined
 			? [
-					truncateToWidth(
-						`${cardKvKey(theme, "policy")}${theme.fg("muted", `${formatBudgetPolicy(row.budget)}; requested ${formatBudgetRequest(row.budget)}`)}`,
+					...cardWrappedValueLines(
+						theme,
+						"policy",
+						theme.fg("muted", `${formatBudgetPolicy(row.budget)}; requested ${formatBudgetRequest(row.budget)}`),
 						contentWidth,
-						"…",
-						false,
 					),
-					truncateToWidth(
-						`${cardKvKey(theme, "budget")}${theme.fg("muted", `${formatEffectiveBudget(row.budget)}; reason ${formatBudgetReasons(row.budget)}`)}`,
+					...cardWrappedValueLines(
+						theme,
+						"budget",
+						theme.fg("muted", `${formatEffectiveBudget(row.budget)}; reason ${formatBudgetReasons(row.budget)}`),
 						contentWidth,
-						"…",
-						false,
 					),
 				]
 			: []),
@@ -797,7 +797,7 @@ export function renderDispatchCard(
 		const proofLine = evidenceCardLine(theme, evidence, contentWidth);
 		if (proofLine !== null) bodyLines.push(proofLine);
 	}
-	if (detail !== null) bodyLines.push(`${cardKvKey(theme, "detail")}${theme.fg("dim", detail)}`);
+	if (detail !== null) bodyLines.push(...cardWrappedValueLines(theme, "detail", theme.fg("dim", detail), contentWidth));
 
 	return frame(theme, cardTitle, bodyLines, width, { rightMeta: elapsed });
 }
@@ -956,10 +956,7 @@ export type DispatchBoardItem = { kind: "run"; row: DispatchBoardRow } | { kind:
  * its first row and its remaining rows are consumed, so the board never shows a
  * member both inside its group and beside it.
  */
-export function dispatchBoardItems(
-	rows: ReadonlyArray<DispatchBoardRow>,
-	selectedRunId?: string | null,
-): DispatchBoardItem[] {
+function dispatchBoardItems(rows: ReadonlyArray<DispatchBoardRow>, selectedRunId?: string | null): DispatchBoardItem[] {
 	const byGroup = new Map<string, DispatchBoardRow[]>();
 	for (const row of rows) {
 		const group = row.council?.group;
@@ -984,14 +981,14 @@ export function dispatchBoardItems(
 }
 
 /** The framed council card: the member grid or stack, with the synthesis run full width under it. */
-export function renderCouncilCard(group: CouncilGroupView, width: number): string[] {
+function renderCouncilCard(group: CouncilGroupView, width: number): string[] {
 	const theme = clioTheme();
 	const contentWidth = Math.max(0, width - 4);
 	const title = `${theme.fg("info", "council")} ${theme.paint(group.group, { bold: true })}`;
 	return frame(theme, title, councilGroupBody(theme, group, contentWidth), width, { rightMeta: group.elapsed });
 }
 
-export function formatDispatchBoardLines(
+function formatDispatchBoardLines(
 	rows: ReadonlyArray<DispatchBoardRow>,
 	width = 76,
 	observability?: ObservabilitySnapshot,
@@ -1722,7 +1719,7 @@ export function createDispatchBoardStore(
 					entry.ttftMs = Math.round(performance.now() - entry.startedAtClockMs);
 				}
 			}
-			if (type === "clio_write_record_downgraded") {
+			if (type === "clio_coder_write_record_downgraded") {
 				const rawPayload = (workerEvent as { payload?: unknown }).payload;
 				const payload =
 					typeof rawPayload === "object" && rawPayload !== null ? (rawPayload as Record<string, unknown>) : null;
@@ -1740,7 +1737,7 @@ export function createDispatchBoardStore(
 			// board says about what a worker is saying or touching comes from here,
 			// so the board and the transcript block cannot tell two stories.
 			entry.progress.observe(payload.event);
-			if (type === "clio_steer_received") {
+			if (type === "clio_coder_steer_received") {
 				const steerPayload = (workerEvent as { payload?: { chars?: unknown } }).payload;
 				entry.steerAcknowledgement = {
 					receivedAtMs: Date.now(),

package/src/interactive/editor-bash.ts

@@ -6,7 +6,28 @@ export interface EditorBashCommand {
 	excludeFromContext: boolean;
 }
 
+/**
+ * Invisible one-shot envelope used only between ClioEditor and its submit
+ * callback. Pi trims submitted text before invoking that callback, so a
+ * whitespace guard would disappear and re-arm a pasted `!` command. The
+ * controller removes this envelope before routing the text as an ordinary
+ * prompt; it is never persisted or sent to a model.
+ */
+export const PASTED_EDITOR_OPERATOR_GUARD = "\u2063";
+
+export function guardPastedEditorOperator(text: string): string {
+	return `${PASTED_EDITOR_OPERATOR_GUARD}${text}`;
+}
+
+export function unguardPastedEditorOperator(text: string): string {
+	return text.startsWith(PASTED_EDITOR_OPERATOR_GUARD) ? text.slice(PASTED_EDITOR_OPERATOR_GUARD.length) : text;
+}
+
 export function parseEditorBashCommand(text: string): EditorBashCommand | null {
+	// Commands are an editor-line operator, not a shell-script paste surface.
+	// The paste guard also makes a bracketed-pasted one-liner literal until it
+	// has crossed the editor submit boundary and been routed as a normal prompt.
+	if (text.startsWith(PASTED_EDITOR_OPERATOR_GUARD) || text.includes("\n") || text.includes("\r")) return null;
 	if (!text.startsWith("!")) return null;
 	const excludeFromContext = text.startsWith("!!");
 	const command = (excludeFromContext ? text.slice(2) : text.slice(1)).trim();

package/src/interactive/editor-steer.ts

@@ -4,8 +4,8 @@
  * `!` intercept in the editor submit path.
  *
  * The target token is deliberately a bare word (letters, digits, underscore,
- * hyphen). Inline file references (`@package.json`, `@src/x.ts`) contain dots
- * or slashes and never match, so prompt file expansion keeps working.
+ * hyphen). File completion consults the same predicate and quotes an otherwise
+ * ambiguous root-level extensionless reference before it reaches this parser.
  */
 
 export interface EditorSteerMention {
@@ -23,11 +23,16 @@ export type SteerTargetResolution =
 	| { kind: "ambiguous"; candidates: RunningDispatchRef[] }
 	| { kind: "none" };
 
-const STEER_MENTION = /^@([A-Za-z0-9][A-Za-z0-9_-]*)\s+(\S[\s\S]*)$/;
+const STEER_TARGET_TOKEN = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
+const STEER_MENTION = /^@(\S+)\s+(\S[\s\S]*)$/;
+
+export function isEditorSteerTargetToken(value: string): boolean {
+	return STEER_TARGET_TOKEN.test(value);
+}
 
 export function parseEditorSteerMention(text: string): EditorSteerMention | null {
 	const match = STEER_MENTION.exec(text.trim());
-	if (!match?.[1] || !match[2]) return null;
+	if (!match?.[1] || !match[2] || !isEditorSteerTargetToken(match[1])) return null;
 	return { target: match[1], text: match[2].trim() };
 }