@oh-my-pi/pi-coding-agent 8.1.0 → 8.2.0

package/src/tools/ssh.ts

@@ -1,23 +1,23 @@
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
-import type { SSHHost } from "@oh-my-pi/pi-coding-agent/capability/ssh";
-import { sshCapability } from "@oh-my-pi/pi-coding-agent/capability/ssh";
-import { renderPromptTemplate } from "@oh-my-pi/pi-coding-agent/config/prompt-templates";
-import { loadCapability } from "@oh-my-pi/pi-coding-agent/discovery";
-import type { RenderResultOptions } from "@oh-my-pi/pi-coding-agent/extensibility/custom-tools/types";
-import type { Theme } from "@oh-my-pi/pi-coding-agent/modes/theme/theme";
-import sshDescriptionBase from "@oh-my-pi/pi-coding-agent/prompts/tools/ssh.md" with { type: "text" };
-import type { SSHHostInfo } from "@oh-my-pi/pi-coding-agent/ssh/connection-manager";
-import { ensureHostInfo, getHostInfoForHost } from "@oh-my-pi/pi-coding-agent/ssh/connection-manager";
-import { executeSSH } from "@oh-my-pi/pi-coding-agent/ssh/ssh-executor";
-import type { OutputMeta } from "@oh-my-pi/pi-coding-agent/tools/output-meta";
-import { ToolError } from "@oh-my-pi/pi-coding-agent/tools/tool-errors";
-import { renderOutputBlock, renderStatusLine } from "@oh-my-pi/pi-coding-agent/tui";
 import type { Component } from "@oh-my-pi/pi-tui";
 import { Text } from "@oh-my-pi/pi-tui";
 import { Type } from "@sinclair/typebox";
+import type { SSHHost } from "../capability/ssh";
+import { sshCapability } from "../capability/ssh";
+import { renderPromptTemplate } from "../config/prompt-templates";
+import { loadCapability } from "../discovery";
+import type { RenderResultOptions } from "../extensibility/custom-tools/types";
+import type { Theme } from "../modes/theme/theme";
+import sshDescriptionBase from "../prompts/tools/ssh.md" with { type: "text" };
+import type { SSHHostInfo } from "../ssh/connection-manager";
+import { ensureHostInfo, getHostInfoForHost } from "../ssh/connection-manager";
+import { executeSSH } from "../ssh/ssh-executor";
+import { renderOutputBlock, renderStatusLine } from "../tui";
 import type { ToolSession } from ".";
+import type { OutputMeta } from "./output-meta";
 import { allocateOutputArtifact, createTailBuffer } from "./output-utils";
 import { formatBytes, wrapBrackets } from "./render-utils";
+import { ToolError } from "./tool-errors";
 import { toolResult } from "./tool-result";
 import { DEFAULT_MAX_BYTES } from "./truncate";
 
@@ -32,8 +32,8 @@ export interface SSHToolDetails {
 	meta?: OutputMeta;
 }
 
-function formatHostEntry(host: SSHHost): string {
-	const info = getHostInfoForHost(host);
+async function formatHostEntry(host: SSHHost): Promise<string> {
+	const info = await getHostInfoForHost(host);
 
 	let shell: string;
 	if (!info) {
@@ -58,12 +58,12 @@ function formatHostEntry(host: SSHHost): string {
 	return `- ${host.name} (${host.host}) | ${shell}`;
 }
 
-function formatDescription(hosts: SSHHost[]): string {
+async function formatDescription(hosts: SSHHost[]): Promise<string> {
 	const baseDescription = renderPromptTemplate(sshDescriptionBase);
 	if (hosts.length === 0) {
 		return baseDescription;
 	}
-	const hostList = hosts.map(formatHostEntry).join("\n");
+	const hostList = (await Promise.all(hosts.map(formatHostEntry))).join("\n");
 	return `${baseDescription}\n\nAvailable hosts:\n${hostList}`;
 }
 
@@ -135,17 +135,12 @@ export class SshTool implements AgentTool<typeof sshSchema, SSHToolDetails> {
 	private readonly hostsByName: Map<string, SSHHost>;
 	private readonly hostNames: string[];
 
-	constructor(session: ToolSession, hostNames: string[], hostsByName: Map<string, SSHHost>) {
+	constructor(session: ToolSession, hostNames: string[], hostsByName: Map<string, SSHHost>, description: string) {
 		this.session = session;
 		this.hostNames = hostNames;
 		this.hostsByName = hostsByName;
 		this.allowedHosts = new Set(hostNames);
-
-		const descriptionHosts = hostNames
-			.map((name) => hostsByName.get(name))
-			.filter((host): host is SSHHost => host !== undefined);
-
-		this.description = formatDescription(descriptionHosts);
+		this.description = description;
 	}
 
 	public async execute(
@@ -182,7 +177,7 @@ export class SshTool implements AgentTool<typeof sshSchema, SSHToolDetails> {
 			compatEnabled: hostInfo.compatEnabled,
 			artifactPath,
 			artifactId,
-			onChunk: (chunk) => {
+			onChunk: chunk => {
 				tailBuffer.append(chunk);
 				if (onUpdate) {
 					onUpdate({
@@ -214,7 +209,13 @@ export async function loadSshTool(session: ToolSession): Promise<SshTool | null>
 	if (hostNames.length === 0) {
 		return null;
 	}
-	return new SshTool(session, hostNames, hostsByName);
+
+	const descriptionHosts = hostNames
+		.map(name => hostsByName.get(name))
+		.filter((host): host is SSHHost => host !== undefined);
+	const description = await formatDescription(descriptionHosts);
+
+	return new SshTool(session, hostNames, hostsByName, description);
 }
 
 // =============================================================================
@@ -263,12 +264,12 @@ export const sshToolRenderer = {
 		);
 		const outputLines: string[] = [];
 
-		const textContent = result.content?.find((c) => c.type === "text")?.text ?? "";
+		const textContent = result.content?.find(c => c.type === "text")?.text ?? "";
 		const output = textContent.trimEnd();
 
 		if (output) {
 			if (expanded) {
-				outputLines.push(...output.split("\n").map((line) => uiTheme.fg("toolOutput", line)));
+				outputLines.push(...output.split("\n").map(line => uiTheme.fg("toolOutput", line)));
 			} else if (renderContext?.visualLines) {
 				const { visualLines, skippedCount = 0, totalVisualLines = visualLines.length } = renderContext;
 				if (skippedCount > 0) {
@@ -279,7 +280,7 @@ export const sshToolRenderer = {
 						),
 					);
 				}
-				const styledVisual = visualLines.map((line) =>
+				const styledVisual = visualLines.map(line =>
 					line.includes("\x1b[") ? line : uiTheme.fg("toolOutput", line),
 				);
 				outputLines.push(...styledVisual);
@@ -288,7 +289,7 @@ export const sshToolRenderer = {
 				const maxLines = 5;
 				const displayLines = outputLinesRaw.slice(0, maxLines);
 				const remaining = outputLinesRaw.length - maxLines;
-				outputLines.push(...displayLines.map((line) => uiTheme.fg("toolOutput", line)));
+				outputLines.push(...displayLines.map(line => uiTheme.fg("toolOutput", line)));
 				if (remaining > 0) {
 					outputLines.push(
 						uiTheme.fg("dim", `${uiTheme.format.ellipsis} (${remaining} more lines) (ctrl+o to expand)`),

package/src/tools/todo-write.ts

@@ -2,17 +2,17 @@ import { randomUUID } from "node:crypto";
 import path from "node:path";
 import type { AgentTool, AgentToolContext, AgentToolResult, AgentToolUpdateCallback } from "@oh-my-pi/pi-agent-core";
 import { StringEnum } from "@oh-my-pi/pi-ai";
-import { renderPromptTemplate } from "@oh-my-pi/pi-coding-agent/config/prompt-templates";
-import type { RenderResultOptions } from "@oh-my-pi/pi-coding-agent/extensibility/custom-tools/types";
-import type { Theme } from "@oh-my-pi/pi-coding-agent/modes/theme/theme";
-import todoWriteDescription from "@oh-my-pi/pi-coding-agent/prompts/tools/todo-write.md" with { type: "text" };
-import type { ToolSession } from "@oh-my-pi/pi-coding-agent/sdk";
-import { renderStatusLine, renderTreeList } from "@oh-my-pi/pi-coding-agent/tui";
 import type { Component } from "@oh-my-pi/pi-tui";
 import { Text } from "@oh-my-pi/pi-tui";
 import { logger } from "@oh-my-pi/pi-utils";
 import { Type } from "@sinclair/typebox";
 import chalk from "chalk";
+import { renderPromptTemplate } from "../config/prompt-templates";
+import type { RenderResultOptions } from "../extensibility/custom-tools/types";
+import type { Theme } from "../modes/theme/theme";
+import todoWriteDescription from "../prompts/tools/todo-write.md" with { type: "text" };
+import type { ToolSession } from "../sdk";
+import { renderStatusLine, renderTreeList } from "../tui";
 import { PREVIEW_LIMITS } from "./render-utils";
 
 const todoWriteSchema = Type.Object({
@@ -63,7 +63,7 @@ function normalizeTodoStatus(status?: string): TodoStatus {
 }
 
 function normalizeTodos(items: Array<{ id?: string; content?: string; status?: string }>): TodoItem[] {
-	return items.map((item) => {
+	return items.map(item => {
 		if (!item.content) {
 			throw new Error("Todo content is required.");
 		}
@@ -82,7 +82,7 @@ function normalizeTodos(items: Array<{ id?: string; content?: string; status?: s
 function validateSequentialTodos(todos: TodoItem[]): { valid: boolean; error?: string } {
 	if (todos.length === 0) return { valid: true };
 
-	const firstIncompleteIndex = todos.findIndex((todo) => todo.status !== "completed");
+	const firstIncompleteIndex = todos.findIndex(todo => todo.status !== "completed");
 	if (firstIncompleteIndex >= 0) {
 		for (let i = firstIncompleteIndex + 1; i < todos.length; i++) {
 			if (todos[i].status === "completed") {
@@ -128,9 +128,9 @@ async function loadTodoFile(filePath: string): Promise<TodoFile | null> {
 
 function formatTodoSummary(todos: TodoItem[]): string {
 	if (todos.length === 0) return "Todo list cleared.";
-	const completed = todos.filter((t) => t.status === "completed").length;
-	const inProgress = todos.filter((t) => t.status === "in_progress").length;
-	const pending = todos.filter((t) => t.status === "pending").length;
+	const completed = todos.filter(t => t.status === "completed").length;
+	const inProgress = todos.filter(t => t.status === "in_progress").length;
+	const pending = todos.filter(t => t.status === "pending").length;
 	return `Saved ${todos.length} todos (${pending} pending, ${inProgress} in progress, ${completed} completed).`;
 }
 
@@ -237,7 +237,7 @@ export const todoWriteToolRenderer = {
 			uiTheme,
 		);
 		if (todos.length === 0) {
-			const fallback = result.content?.find((c) => c.type === "text")?.text ?? "No todos";
+			const fallback = result.content?.find(c => c.type === "text")?.text ?? "No todos";
 			return new Text([header, uiTheme.fg("dim", fallback)].join("\n"), 0, 0);
 		}
 		const lines = renderTreeList(
@@ -246,7 +246,7 @@ export const todoWriteToolRenderer = {
 				expanded,
 				maxCollapsed: PREVIEW_LIMITS.COLLAPSED_ITEMS,
 				itemType: "todo",
-				renderItem: (todo) => formatTodoLine(todo, uiTheme, ""),
+				renderItem: todo => formatTodoLine(todo, uiTheme, ""),
 			},
 			uiTheme,
 		);

package/src/tools/tool-errors.ts

@@ -39,7 +39,7 @@ export class MultiError extends ToolError {
 	readonly errors: ErrorEntry[];
 
 	constructor(errors: ErrorEntry[]) {
-		super(errors.map((e) => e.message).join("; "));
+		super(errors.map(e => e.message).join("; "));
 		this.name = "MultiError";
 		this.errors = errors;
 	}
@@ -49,11 +49,11 @@ export class MultiError extends ToolError {
 			const e = this.errors[0];
 			return e.context ? `${e.context}: ${e.message}` : e.message;
 		}
-		return this.errors.map((e) => (e.context ? `${e.context}: ${e.message}` : e.message)).join("\n");
+		return this.errors.map(e => (e.context ? `${e.context}: ${e.message}` : e.message)).join("\n");
 	}
 
 	static from(errors: Array<string | ErrorEntry>): MultiError {
-		return new MultiError(errors.map((e) => (typeof e === "string" ? { message: e } : e)));
+		return new MultiError(errors.map(e => (typeof e === "string" ? { message: e } : e)));
 	}
 }
 

package/src/tools/tool-result.ts

@@ -1,13 +1,8 @@
 import type { AgentToolResult } from "@oh-my-pi/pi-agent-core";
 import type { ImageContent, TextContent } from "@oh-my-pi/pi-ai";
-import type { OutputSummary } from "@oh-my-pi/pi-coding-agent/session/streaming-output";
-import type {
-	OutputMeta,
-	TruncationOptions,
-	TruncationSummaryOptions,
-	TruncationTextOptions,
-} from "@oh-my-pi/pi-coding-agent/tools/output-meta";
-import { outputMeta } from "@oh-my-pi/pi-coding-agent/tools/output-meta";
+import type { OutputSummary } from "../session/streaming-output";
+import type { OutputMeta, TruncationOptions, TruncationSummaryOptions, TruncationTextOptions } from "./output-meta";
+import { outputMeta } from "./output-meta";
 import type { TruncationResult } from "./truncate";
 
 type ToolContent = Array<TextContent | ImageContent>;

package/src/tools/write.ts

@@ -5,23 +5,18 @@ import type {
 	AgentToolUpdateCallback,
 	ToolCallContext,
 } from "@oh-my-pi/pi-agent-core";
-import { renderPromptTemplate } from "@oh-my-pi/pi-coding-agent/config/prompt-templates";
-import type { RenderResultOptions } from "@oh-my-pi/pi-coding-agent/extensibility/custom-tools/types";
-import {
-	createLspWritethrough,
-	type FileDiagnosticsResult,
-	type WritethroughCallback,
-	writethroughNoop,
-} from "@oh-my-pi/pi-coding-agent/lsp";
-import { getLanguageFromPath, type Theme } from "@oh-my-pi/pi-coding-agent/modes/theme/theme";
-import writeDescription from "@oh-my-pi/pi-coding-agent/prompts/tools/write.md" with { type: "text" };
-import type { ToolSession } from "@oh-my-pi/pi-coding-agent/sdk";
-import { type OutputMeta, outputMeta } from "@oh-my-pi/pi-coding-agent/tools/output-meta";
-import { renderCodeCell, renderStatusLine } from "@oh-my-pi/pi-coding-agent/tui";
 import type { Component } from "@oh-my-pi/pi-tui";
 import { Text } from "@oh-my-pi/pi-tui";
 import { untilAborted } from "@oh-my-pi/pi-utils";
 import { Type } from "@sinclair/typebox";
+import { renderPromptTemplate } from "../config/prompt-templates";
+import type { RenderResultOptions } from "../extensibility/custom-tools/types";
+import { createLspWritethrough, type FileDiagnosticsResult, type WritethroughCallback, writethroughNoop } from "../lsp";
+import { getLanguageFromPath, type Theme } from "../modes/theme/theme";
+import writeDescription from "../prompts/tools/write.md" with { type: "text" };
+import type { ToolSession } from "../sdk";
+import { renderCodeCell, renderStatusLine } from "../tui";
+import { type OutputMeta, outputMeta } from "./output-meta";
 import { resolveToCwd } from "./path-utils";
 import { formatDiagnostics, shortenPath } from "./render-utils";
 import type { RenderCallOptions } from "./renderers";
@@ -49,7 +44,7 @@ function getLspBatchRequest(toolCall: ToolCallContext | undefined): { id: string
 	if (!hasOtherWrites) {
 		return undefined;
 	}
-	const hasLaterWrites = toolCall.toolCalls.slice(toolCall.index + 1).some((call) => LSP_BATCH_TOOLS.has(call.name));
+	const hasLaterWrites = toolCall.toolCalls.slice(toolCall.index + 1).some(call => LSP_BATCH_TOOLS.has(call.name));
 	return { id: toolCall.batchId, flush: !hasLaterWrites };
 }
 
@@ -231,12 +226,12 @@ export const writeToolRenderer = {
 		}
 
 		if (result.details?.diagnostics) {
-			const diagText = formatDiagnostics(result.details.diagnostics, expanded, uiTheme, (fp) =>
+			const diagText = formatDiagnostics(result.details.diagnostics, expanded, uiTheme, fp =>
 				uiTheme.getLangIcon(getLanguageFromPath(fp)),
 			);
 			if (diagText.trim()) {
 				const diagLines = diagText.split("\n");
-				const firstNonEmpty = diagLines.findIndex((line) => line.trim());
+				const firstNonEmpty = diagLines.findIndex(line => line.trim());
 				outputLines.push(...(firstNonEmpty >= 0 ? diagLines.slice(firstNonEmpty) : []));
 			}
 		}

package/src/tui/code-cell.ts

@@ -1,14 +1,8 @@
 /**
  * Render a code cell with optional output section.
  */
-
-import { highlightCode, type Theme } from "@oh-my-pi/pi-coding-agent/modes/theme/theme";
-import {
-	formatDuration,
-	formatExpandHint,
-	formatMoreItems,
-	replaceTabs,
-} from "@oh-my-pi/pi-coding-agent/tools/render-utils";
+import { highlightCode, type Theme } from "../modes/theme/theme";
+import { formatDuration, formatExpandHint, formatMoreItems, replaceTabs } from "../tools/render-utils";
 import { renderOutputBlock } from "./output-block";
 import type { State } from "./types";
 import { getStateIcon } from "./utils";
@@ -96,7 +90,7 @@ export function renderCodeCell(options: CodeCellOptions, theme: Theme): string[]
 		const maxLines = expanded ? rawLines.length : Math.min(rawLines.length, outputMaxLines);
 		const displayLines = rawLines
 			.slice(0, maxLines)
-			.map((line) => (line.includes("\x1b[") ? line : theme.fg("toolOutput", line)));
+			.map(line => (line.includes("\x1b[") ? line : theme.fg("toolOutput", line)));
 		outputLines.push(...displayLines);
 		const remaining = rawLines.length - maxLines;
 		if (remaining > 0) {

package/src/tui/file-list.ts

@@ -1,9 +1,8 @@
 /**
  * Render file listings with optional icons and metadata.
  */
-
-import type { Theme } from "@oh-my-pi/pi-coding-agent/modes/theme/theme";
-import { getLanguageFromPath } from "@oh-my-pi/pi-coding-agent/modes/theme/theme";
+import type { Theme } from "../modes/theme/theme";
+import { getLanguageFromPath } from "../modes/theme/theme";
 import { renderTreeList } from "./tree-list";
 
 export interface FileEntry {
@@ -28,7 +27,7 @@ export function renderFileList(options: FileListOptions, theme: Theme): string[]
 			expanded,
 			maxCollapsed,
 			itemType: "file",
-			renderItem: (entry) => {
+			renderItem: entry => {
 				const isDirectory = entry.isDirectory ?? entry.path.endsWith("/");
 				const displayPath = isDirectory && entry.path.endsWith("/") ? entry.path : entry.path;
 				const lang = isDirectory ? undefined : getLanguageFromPath(displayPath);

package/src/tui/output-block.ts

@@ -1,9 +1,8 @@
 /**
  * Bordered output container with optional header and sections.
  */
-
-import type { Theme } from "@oh-my-pi/pi-coding-agent/modes/theme/theme";
 import { visibleWidth } from "@oh-my-pi/pi-tui";
+import type { Theme } from "../modes/theme/theme";
 import type { State } from "./types";
 import { getStateBgColor, padToWidth, truncateToWidth } from "./utils";
 

package/src/tui/status-line.ts

@@ -1,8 +1,7 @@
 /**
  * Standardized status header rendering for tool output.
  */
-
-import type { Theme, ThemeColor } from "@oh-my-pi/pi-coding-agent/modes/theme/theme";
+import type { Theme, ThemeColor } from "../modes/theme/theme";
 import type { IconType } from "./types";
 import { getStateIcon } from "./utils";
 
@@ -31,7 +30,7 @@ export function renderStatusLine(options: StatusLineOptions, theme: Theme): stri
 		line += ` ${theme.fg(color, `${theme.format.bracketLeft}${label}${theme.format.bracketRight}`)}`;
 	}
 
-	const meta = options.meta?.filter((value) => value.trim().length > 0) ?? [];
+	const meta = options.meta?.filter(value => value.trim().length > 0) ?? [];
 	if (meta.length > 0) {
 		line += ` ${theme.fg("dim", meta.join(theme.sep.dot))}`;
 	}

package/src/tui/tree-list.ts

@@ -1,9 +1,8 @@
 /**
  * Hierarchical tree list rendering helper.
  */
-
-import type { Theme } from "@oh-my-pi/pi-coding-agent/modes/theme/theme";
-import { formatMoreItems } from "@oh-my-pi/pi-coding-agent/tools/render-utils";
+import type { Theme } from "../modes/theme/theme";
+import { formatMoreItems } from "../tools/render-utils";
 import type { TreeContext } from "./types";
 import { getTreeBranch, getTreeContinuePrefix } from "./utils";
 

package/src/tui/types.ts

@@ -1,8 +1,7 @@
 /**
  * Shared types for TUI rendering components.
  */
-
-import type { Theme } from "@oh-my-pi/pi-coding-agent/modes/theme/theme";
+import type { Theme } from "../modes/theme/theme";
 
 export type State = "pending" | "running" | "success" | "error" | "warning";
 export type IconType = "success" | "error" | "running" | "pending" | "warning" | "info";

package/src/tui/utils.ts

@@ -1,13 +1,12 @@
 /**
  * Shared helpers for tool-rendered UI components.
  */
-
-import type { Theme, ThemeBg } from "@oh-my-pi/pi-coding-agent/modes/theme/theme";
 import { truncateToWidth as truncateToWidthBase, visibleWidth } from "@oh-my-pi/pi-tui";
+import type { Theme, ThemeBg } from "../modes/theme/theme";
 import type { IconType, State } from "./types";
 
 export function buildTreePrefix(ancestors: boolean[], theme: Theme): string {
-	return ancestors.map((hasNext) => (hasNext ? `${theme.tree.vertical}  ` : "   ")).join("");
+	return ancestors.map(hasNext => (hasNext ? `${theme.tree.vertical}  ` : "   ")).join("");
 }
 
 export function getTreeBranch(isLast: boolean, theme: Theme): string {

package/src/utils/changelog.ts

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync } from "node:fs";
+import { isEnoent, logger } from "@oh-my-pi/pi-utils";
 
 export interface ChangelogEntry {
 	major: number;
@@ -11,13 +11,9 @@ export interface ChangelogEntry {
  * Parse changelog entries from CHANGELOG.md
  * Scans for ## lines and collects content until next ## or EOF
  */
-export function parseChangelog(changelogPath: string): ChangelogEntry[] {
-	if (!existsSync(changelogPath)) {
-		return [];
-	}
-
+export async function parseChangelog(changelogPath: string): Promise<ChangelogEntry[]> {
 	try {
-		const content = readFileSync(changelogPath, "utf-8");
+		const content = await Bun.file(changelogPath).text();
 		const lines = content.split("\n");
 		const entries: ChangelogEntry[] = [];
 
@@ -65,7 +61,10 @@ export function parseChangelog(changelogPath: string): ChangelogEntry[] {
 
 		return entries;
 	} catch (error) {
-		console.error(`Warning: Could not parse changelog: ${error}`);
+		if (isEnoent(error)) {
+			return [];
+		}
+		logger.error(`Warning: Could not parse changelog: ${error}`);
 		return [];
 	}
 }
@@ -92,8 +91,8 @@ export function getNewEntries(entries: ChangelogEntry[], lastVersion: string): C
 		content: "",
 	};
 
-	return entries.filter((entry) => compareVersions(entry, last) > 0);
+	return entries.filter(entry => compareVersions(entry, last) > 0);
 }
 
 // Re-export getChangelogPath from paths.ts for convenience
-export { getChangelogPath } from "@oh-my-pi/pi-coding-agent/config";
+export { getChangelogPath } from "../config";

package/src/utils/clipboard.ts

@@ -1,5 +1,5 @@
-import { unlink } from "node:fs/promises";
-import { platform } from "node:os";
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
 import { $ } from "bun";
 import { nanoid } from "nanoid";
 
@@ -16,23 +16,23 @@ function baseMimeType(mimeType: string): string {
 
 function selectPreferredImageMimeType(mimeTypes: string[]): string | null {
 	const normalized = mimeTypes
-		.map((t) => t.trim())
+		.map(t => t.trim())
 		.filter(Boolean)
-		.map((t) => ({ raw: t, base: baseMimeType(t) }));
+		.map(t => ({ raw: t, base: baseMimeType(t) }));
 
 	for (const preferred of PREFERRED_IMAGE_MIME_TYPES) {
-		const match = normalized.find((t) => t.base === preferred);
+		const match = normalized.find(t => t.base === preferred);
 		if (match) {
 			return match.raw;
 		}
 	}
 
-	const anyImage = normalized.find((t) => t.base.startsWith("image/"));
+	const anyImage = normalized.find(t => t.base.startsWith("image/"));
 	return anyImage?.raw ?? null;
 }
 
 export async function copyToClipboard(text: string): Promise<void> {
-	const p = platform();
+	const p = os.platform();
 	const timeout = 5000;
 
 	try {
@@ -83,7 +83,7 @@ export interface ClipboardImage {
  * - Windows: uses PowerShell
  */
 export async function readImageFromClipboard(): Promise<ClipboardImage | null> {
-	const p = platform();
+	const p = os.platform();
 	const timeout = 3000;
 	let promise: Promise<ClipboardImage | null>;
 	switch (p) {
@@ -125,7 +125,7 @@ async function readImageWayland(): Promise<ClipboardReadResult> {
 
 	const typeList = types
 		.split(/\r?\n/)
-		.map((t) => t.trim())
+		.map(t => t.trim())
 		.filter(Boolean);
 
 	const selectedType = selectPreferredImageMimeType(typeList);
@@ -149,7 +149,7 @@ async function readImageX11(): Promise<ClipboardReadResult> {
 
 	const candidateTypes = targets
 		.split(/\r?\n/)
-		.map((t) => t.trim())
+		.map(t => t.trim())
 		.filter(Boolean);
 
 	const selectedType = selectPreferredImageMimeType(candidateTypes);
@@ -207,7 +207,7 @@ async function readImageMacOS(): Promise<ClipboardImage | null> {
 		const file = Bun.file(tempFile);
 		if (await file.exists()) {
 			const buffer = await file.bytes();
-			await unlink(tempFile).catch(() => {});
+			await fs.unlink(tempFile).catch(() => {});
 
 			if (buffer.length > 0) {
 				return {

package/src/utils/file-mentions.ts

@@ -5,18 +5,12 @@
  * we automatically inject the file contents as a FileMentionMessage
  * so the agent doesn't need to read them manually.
  */
-
 import path from "node:path";
 import type { AgentMessage } from "@oh-my-pi/pi-agent-core";
-import type { FileMentionMessage } from "@oh-my-pi/pi-coding-agent/session/messages";
-import { resolveReadPath } from "@oh-my-pi/pi-coding-agent/tools/path-utils";
-import { formatAge } from "@oh-my-pi/pi-coding-agent/tools/render-utils";
-import {
-	DEFAULT_MAX_BYTES,
-	formatSize,
-	truncateHead,
-	truncateStringToBytesFromStart,
-} from "@oh-my-pi/pi-coding-agent/tools/truncate";
+import type { FileMentionMessage } from "../session/messages";
+import { resolveReadPath } from "../tools/path-utils";
+import { formatAge } from "../tools/render-utils";
+import { DEFAULT_MAX_BYTES, formatSize, truncateHead, truncateStringToBytesFromStart } from "../tools/truncate";
 
 /** Regex to match @filepath patterns in text */
 const FILE_MENTION_REGEX = /@([^\s@]+)/g;

package/src/utils/frontmatter.ts

@@ -38,7 +38,9 @@ export class FrontmatterError extends Error {
 }
 
 export interface FrontmatterOptions {
-	/** Source of the content */
+	/** Source of the content (alias: source) */
+	location?: unknown;
+	/** Source of the content (alias for location) */
 	source?: unknown;
 	/** Fallback frontmatter values */
 	fallback?: Record<string, unknown>;
@@ -56,7 +58,8 @@ export function parseFrontmatter(
 	content: string,
 	options?: FrontmatterOptions,
 ): { frontmatter: Record<string, unknown>; body: string } {
-	const { source, fallback, normalize = true, level = "warn" } = options ?? {};
+	const { location, source, fallback, normalize = true, level = "warn" } = options ?? {};
+	const loc = location ?? source;
 	const frontmatter: Record<string, unknown> = Object.assign({}, fallback);
 
 	const normalized = normalize ? stripHtmlComments(content.replace(/\r\n/g, "\n").replace(/\r/g, "\n")) : content;
@@ -77,7 +80,7 @@ export function parseFrontmatter(
 		const loaded = YAML.parse(metadata.replaceAll("\t", "  ")) as Record<string, unknown> | null;
 		return { frontmatter: Object.assign(frontmatter, loaded), body: body };
 	} catch (error) {
-		const err = new FrontmatterError(toError(error), source ?? `Inline '${truncate(content, 64)}'`);
+		const err = new FrontmatterError(toError(error), loc ?? `Inline '${truncate(content, 64)}'`);
 		if (level === "warn" || level === "fatal") {
 			logger.warn("Failed to parse YAML frontmatter", { err: err.toString() });
 		}

package/src/utils/fuzzy.ts

@@ -71,7 +71,7 @@ export function fuzzyFilter<T>(items: T[], query: string, getText: (item: T) =>
 	const tokens = query
 		.trim()
 		.split(/\s+/)
-		.filter((t) => t.length > 0);
+		.filter(t => t.length > 0);
 
 	if (tokens.length === 0) {
 		return items;
@@ -104,5 +104,5 @@ export function fuzzyFilter<T>(items: T[], query: string, getText: (item: T) =>
 	// Sort by score (asc, lower is better)
 	results.sort((a, b) => a.totalScore - b.totalScore);
 
-	return results.map((r) => r.item);
+	return results.map(r => r.item);
 }

package/src/utils/image-convert.ts

@@ -1,4 +1,4 @@
-import * as photon from "@oh-my-pi/pi-coding-agent/vendor/photon";
+import * as photon from "../vendor/photon";
 
 /**
  * Convert image to PNG format for terminal display.

package/src/utils/image-resize.ts

@@ -1,5 +1,5 @@
 import type { ImageContent } from "@oh-my-pi/pi-ai";
-import * as photon from "@oh-my-pi/pi-coding-agent/vendor/photon";
+import * as photon from "../vendor/photon";
 
 export interface ImageResizeOptions {
 	maxWidth?: number; // Default: 2000

package/src/utils/mime.ts

@@ -1,4 +1,4 @@
-import { open } from "node:fs/promises";
+import * as fs from "node:fs/promises";
 import { fileTypeFromBuffer } from "file-type";
 
 const IMAGE_MIME_TYPES = new Set(["image/jpeg", "image/png", "image/gif", "image/webp"]);
@@ -6,7 +6,7 @@ const IMAGE_MIME_TYPES = new Set(["image/jpeg", "image/png", "image/gif", "image
 const FILE_TYPE_SNIFF_BYTES = 4100;
 
 export async function detectSupportedImageMimeTypeFromFile(filePath: string): Promise<string | null> {
-	const fileHandle = await open(filePath, "r");
+	const fileHandle = await fs.open(filePath, "r");
 	try {
 		const buffer = Buffer.alloc(FILE_TYPE_SNIFF_BYTES);
 		const { bytesRead } = await fileHandle.read(buffer, 0, FILE_TYPE_SNIFF_BYTES, 0);