@oh-my-pi/pi-coding-agent 2.0.1337 → 2.2.1337

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 ## [Unreleased]
 
+## [2.2.1337] - 2026-01-03
+
+## [2.1.1337] - 2026-01-03
+
+### Added
+
+- Added `pi update` command to check for and install updates from GitHub releases or via bun
+
+### Changed
+
+- Changed HTML export to use compile-time bundled templates via Bun macros for improved performance
+- Changed `exportToHtml` and `exportFromFile` functions to be async
+- Simplified build process by embedding assets (themes, templates, agents, commands) directly into the binary at compile time
+- Removed separate asset copying steps from build scripts
+
 ## [2.0.1337] - 2026-01-03
 ### Added
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@oh-my-pi/pi-coding-agent",
-	"version": "2.0.1337",
+	"version": "2.2.1337",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {
@@ -31,17 +31,15 @@
 	"scripts": {
 		"check": "tsgo --noEmit",
 		"clean": "rm -rf dist",
-		"build": "tsgo -p tsconfig.build.json && chmod +x dist/cli.js && npm run copy-assets",
-		"build:binary": "npm run build && bun build --compile ./dist/cli.js --outfile dist/pi && npm run copy-binary-assets",
-		"copy-assets": "mkdir -p dist/modes/interactive/theme && cp src/modes/interactive/theme/*.json dist/modes/interactive/theme/ && mkdir -p dist/core/export-html && cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/core/export-html/ && mkdir -p dist/core/tools/task/bundled-agents && cp src/core/tools/task/bundled-agents/*.md dist/core/tools/task/bundled-agents/",
-		"copy-binary-assets": "cp package.json dist/ && cp README.md dist/ && cp CHANGELOG.md dist/ && mkdir -p dist/theme && cp src/modes/interactive/theme/*.json dist/theme/ && mkdir -p dist/export-html && cp src/core/export-html/template.html src/core/export-html/template.css src/core/export-html/template.js dist/export-html/ && cp -r docs dist/ && cp -r examples dist/",
-		"test": "vitest --run",
+		"build": "tsgo -p tsconfig.build.json && chmod +x dist/cli.js",
+		"build:binary": "bun build --compile ./src/cli.ts --outfile dist/pi",
+		"test": "bun test",
 		"prepublishOnly": "npm run clean && npm run build"
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-agent-core": "workspace:*",
-		"@oh-my-pi/pi-ai": "workspace:*",
-		"@oh-my-pi/pi-tui": "workspace:*",
+		"@oh-my-pi/pi-agent-core": "2.2.1337",
+		"@oh-my-pi/pi-ai": "2.2.1337",
+		"@oh-my-pi/pi-tui": "2.2.1337",
 		"@sinclair/typebox": "^0.34.46",
 		"ajv": "^8.17.1",
 		"chalk": "^5.5.0",

package/src/bun-imports.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Type declarations for Bun's import attributes.
+ * These allow importing non-JS files as text at build time.
+ */
+
+// Markdown files imported as text
+declare module "*.md" {
+	const content: string;
+	export default content;
+}
+
+// Text files imported as text
+declare module "*.txt" {
+	const content: string;
+	export default content;
+}

package/src/cli/update-cli.ts

@@ -0,0 +1,273 @@
+/**
+ * Update CLI command handler.
+ *
+ * Handles `pi update` to check for and install updates.
+ * Uses bun if available, otherwise downloads binary from GitHub releases.
+ */
+
+import { execSync, spawnSync } from "node:child_process";
+import { createWriteStream, existsSync, renameSync, unlinkSync } from "node:fs";
+import { dirname } from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import chalk from "chalk";
+import { VERSION } from "../config";
+
+/**
+ * Detect if we're running as a Bun compiled binary.
+ */
+const isBunBinary =
+	import.meta.url.includes("$bunfs") || import.meta.url.includes("~BUN") || import.meta.url.includes("%7EBUN");
+
+const REPO = "can1357/oh-my-pi";
+const PACKAGE = "@oh-my-pi/pi-coding-agent";
+
+interface ReleaseInfo {
+	tag: string;
+	version: string;
+	assets: Array<{ name: string; url: string }>;
+}
+
+/**
+ * Parse update subcommand arguments.
+ * Returns undefined if not an update command.
+ */
+export function parseUpdateArgs(args: string[]): { force: boolean; check: boolean } | undefined {
+	if (args.length === 0 || args[0] !== "update") {
+		return undefined;
+	}
+
+	return {
+		force: args.includes("--force") || args.includes("-f"),
+		check: args.includes("--check") || args.includes("-c"),
+	};
+}
+
+/**
+ * Check if bun is available in PATH.
+ */
+function hasBun(): boolean {
+	try {
+		const result = spawnSync("bun", ["--version"], { encoding: "utf-8", stdio: "pipe" });
+		return result.status === 0;
+	} catch {
+		return false;
+	}
+}
+
+/**
+ * Get the latest release info from GitHub.
+ */
+async function getLatestRelease(): Promise<ReleaseInfo> {
+	const response = await fetch(`https://api.github.com/repos/${REPO}/releases/latest`);
+	if (!response.ok) {
+		throw new Error(`Failed to fetch release info: ${response.statusText}`);
+	}
+
+	const data = (await response.json()) as {
+		tag_name: string;
+		assets: Array<{ name: string; browser_download_url: string }>;
+	};
+
+	return {
+		tag: data.tag_name,
+		version: data.tag_name.replace(/^v/, ""),
+		assets: data.assets.map((a) => ({ name: a.name, url: a.browser_download_url })),
+	};
+}
+
+/**
+ * Compare semver versions. Returns:
+ * - negative if a < b
+ * - 0 if a == b
+ * - positive if a > b
+ */
+function compareVersions(a: string, b: string): number {
+	const pa = a.split(".").map(Number);
+	const pb = b.split(".").map(Number);
+
+	for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
+		const na = pa[i] || 0;
+		const nb = pb[i] || 0;
+		if (na !== nb) return na - nb;
+	}
+	return 0;
+}
+
+/**
+ * Get the appropriate binary name for this platform.
+ */
+function getBinaryName(): string {
+	const platform = process.platform;
+	const arch = process.arch;
+
+	let os: string;
+	switch (platform) {
+		case "linux":
+			os = "linux";
+			break;
+		case "darwin":
+			os = "darwin";
+			break;
+		case "win32":
+			os = "windows";
+			break;
+		default:
+			throw new Error(`Unsupported platform: ${platform}`);
+	}
+
+	let archName: string;
+	switch (arch) {
+		case "x64":
+			archName = "x64";
+			break;
+		case "arm64":
+			archName = "arm64";
+			break;
+		default:
+			throw new Error(`Unsupported architecture: ${arch}`);
+	}
+
+	if (os === "windows") {
+		return `pi-${os}-${archName}.exe`;
+	}
+	return `pi-${os}-${archName}`;
+}
+
+/**
+ * Update via bun package manager.
+ */
+async function updateViaBun(): Promise<void> {
+	console.log(chalk.dim("Updating via bun..."));
+
+	try {
+		execSync(`bun update -g ${PACKAGE}`, { stdio: "inherit" });
+		console.log(chalk.green("\n✓ Update complete"));
+	} catch {
+		throw new Error("bun update failed");
+	}
+}
+
+/**
+ * Update by downloading binary from GitHub releases.
+ */
+async function updateViaBinary(release: ReleaseInfo): Promise<void> {
+	const binaryName = getBinaryName();
+	const asset = release.assets.find((a) => a.name === binaryName);
+
+	if (!asset) {
+		throw new Error(`No binary found for ${binaryName}`);
+	}
+
+	const execPath = process.execPath;
+	const _execDir = dirname(execPath);
+	const tempPath = `${execPath}.new`;
+	const backupPath = `${execPath}.bak`;
+
+	console.log(chalk.dim(`Downloading ${binaryName}...`));
+
+	// Download to temp file
+	const response = await fetch(asset.url, { redirect: "follow" });
+	if (!response.ok || !response.body) {
+		throw new Error(`Download failed: ${response.statusText}`);
+	}
+
+	const fileStream = createWriteStream(tempPath, { mode: 0o755 });
+	const nodeStream = Readable.fromWeb(response.body as import("stream/web").ReadableStream);
+	await pipeline(nodeStream, fileStream);
+
+	// Replace current binary
+	console.log(chalk.dim("Installing update..."));
+
+	try {
+		// Backup current binary
+		if (existsSync(backupPath)) {
+			unlinkSync(backupPath);
+		}
+		renameSync(execPath, backupPath);
+
+		// Move new binary into place
+		renameSync(tempPath, execPath);
+
+		// Clean up backup
+		unlinkSync(backupPath);
+
+		console.log(chalk.green(`\n✓ Updated to ${release.version}`));
+		console.log(chalk.dim("Restart pi to use the new version"));
+	} catch (err) {
+		// Restore from backup if possible
+		if (existsSync(backupPath) && !existsSync(execPath)) {
+			renameSync(backupPath, execPath);
+		}
+		if (existsSync(tempPath)) {
+			unlinkSync(tempPath);
+		}
+		throw err;
+	}
+}
+
+/**
+ * Run the update command.
+ */
+export async function runUpdateCommand(opts: { force: boolean; check: boolean }): Promise<void> {
+	console.log(chalk.dim(`Current version: ${VERSION}`));
+
+	// Check for updates
+	let release: ReleaseInfo;
+	try {
+		release = await getLatestRelease();
+	} catch (err) {
+		console.error(chalk.red(`Failed to check for updates: ${err}`));
+		process.exit(1);
+	}
+
+	const comparison = compareVersions(release.version, VERSION);
+
+	if (comparison <= 0 && !opts.force) {
+		console.log(chalk.green("✓ Already up to date"));
+		return;
+	}
+
+	if (comparison > 0) {
+		console.log(chalk.cyan(`New version available: ${release.version}`));
+	} else {
+		console.log(chalk.yellow(`Forcing reinstall of ${release.version}`));
+	}
+
+	if (opts.check) {
+		// Just check, don't install
+		return;
+	}
+
+	// Choose update method
+	try {
+		if (!isBunBinary && hasBun()) {
+			await updateViaBun();
+		} else {
+			await updateViaBinary(release);
+		}
+	} catch (err) {
+		console.error(chalk.red(`Update failed: ${err}`));
+		process.exit(1);
+	}
+}
+
+/**
+ * Print update command help.
+ */
+export function printUpdateHelp(): void {
+	console.log(`${chalk.bold("pi update")} - Check for and install updates
+
+${chalk.bold("Usage:")}
+  pi update [options]
+
+${chalk.bold("Options:")}
+  -c, --check   Check for updates without installing
+  -f, --force   Force reinstall even if up to date
+
+${chalk.bold("Examples:")}
+  pi update           Update to latest version
+  pi update --check   Check if updates are available
+  pi update --force   Force reinstall
+`);
+}

package/src/config.ts

@@ -1,34 +1,31 @@
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync } from "node:fs";
 import { homedir } from "node:os";
 import { dirname, join, resolve } from "node:path";
 
+// Embed package.json at build time for config
+import packageJson from "../package.json" with { type: "json" };
+
 // =============================================================================
-// Package Detection
+// App Config (from embedded package.json)
 // =============================================================================
 
-/**
- * Detect if we're running as a Bun compiled binary.
- * Bun binaries have import.meta.url containing "$bunfs", "~BUN", or "%7EBUN" (Bun's virtual filesystem path)
- */
-export const isBunBinary =
-	import.meta.url.includes("$bunfs") || import.meta.url.includes("~BUN") || import.meta.url.includes("%7EBUN");
+export const APP_NAME: string = (packageJson as { piConfig?: { name?: string } }).piConfig?.name || "pi";
+export const CONFIG_DIR_NAME: string =
+	(packageJson as { piConfig?: { configDir?: string } }).piConfig?.configDir || ".pi";
+export const VERSION: string = (packageJson as { version: string }).version;
+
+// e.g., PI_CODING_AGENT_DIR or TAU_CODING_AGENT_DIR
+export const ENV_AGENT_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_DIR`;
 
 // =============================================================================
-// Package Asset Paths (shipped with executable)
+// Package Directory (for optional external docs/examples)
 // =============================================================================
 
 /**
- * Get the base directory for resolving package assets (themes, package.json, README.md, CHANGELOG.md).
- * - For Bun binary: returns the directory containing the executable
- * - For Node.js (dist/): returns __dirname (the dist/ directory)
- * - For tsx (src/): returns parent directory (the package root)
+ * Get the base directory for resolving optional package assets (docs, examples).
+ * Walk up from import.meta.dir until we find package.json, or fall back to cwd.
  */
 export function getPackageDir(): string {
-	if (isBunBinary) {
-		// Bun binary: process.execPath points to the compiled executable
-		return dirname(process.execPath);
-	}
-	// Node.js: walk up from import.meta.dir until we find package.json
 	let dir = import.meta.dir;
 	while (dir !== dirname(dir)) {
 		if (existsSync(join(dir, "package.json"))) {
@@ -36,79 +33,30 @@ export function getPackageDir(): string {
 		}
 		dir = dirname(dir);
 	}
-	// Fallback (shouldn't happen)
-	return import.meta.dir;
+	// Fallback to cwd (docs/examples won't be found, but that's fine)
+	return process.cwd();
 }
 
-/**
- * Get path to built-in themes directory (shipped with package)
- * - For Bun binary: theme/ next to executable
- * - For Node.js (dist/): dist/modes/interactive/theme/
- * - For tsx (src/): src/modes/interactive/theme/
- */
-export function getThemesDir(): string {
-	if (isBunBinary) {
-		return join(dirname(process.execPath), "theme");
-	}
-	// Theme is in modes/interactive/theme/ relative to src/ or dist/
-	const packageDir = getPackageDir();
-	const srcOrDist = existsSync(join(packageDir, "src")) ? "src" : "dist";
-	return join(packageDir, srcOrDist, "modes", "interactive", "theme");
-}
-
-/**
- * Get path to HTML export template directory (shipped with package)
- * - For Bun binary: export-html/ next to executable
- * - For Node.js (dist/): dist/core/export-html/
- * - For tsx (src/): src/core/export-html/
- */
-export function getExportTemplateDir(): string {
-	if (isBunBinary) {
-		return join(dirname(process.execPath), "export-html");
-	}
-	const packageDir = getPackageDir();
-	const srcOrDist = existsSync(join(packageDir, "src")) ? "src" : "dist";
-	return join(packageDir, srcOrDist, "core", "export-html");
-}
-
-/** Get path to package.json */
-export function getPackageJsonPath(): string {
-	return join(getPackageDir(), "package.json");
-}
-
-/** Get path to README.md */
+/** Get path to README.md (optional, may not exist in binary) */
 export function getReadmePath(): string {
 	return resolve(join(getPackageDir(), "README.md"));
 }
 
-/** Get path to docs directory */
+/** Get path to docs directory (optional, may not exist in binary) */
 export function getDocsPath(): string {
 	return resolve(join(getPackageDir(), "docs"));
 }
 
-/** Get path to examples directory */
+/** Get path to examples directory (optional, may not exist in binary) */
 export function getExamplesPath(): string {
 	return resolve(join(getPackageDir(), "examples"));
 }
 
-/** Get path to CHANGELOG.md */
+/** Get path to CHANGELOG.md (optional, may not exist in binary) */
 export function getChangelogPath(): string {
 	return resolve(join(getPackageDir(), "CHANGELOG.md"));
 }
 
-// =============================================================================
-// App Config (from package.json piConfig)
-// =============================================================================
-
-const pkg = JSON.parse(readFileSync(getPackageJsonPath(), "utf-8"));
-
-export const APP_NAME: string = pkg.piConfig?.name || "pi";
-export const CONFIG_DIR_NAME: string = pkg.piConfig?.configDir || ".pi";
-export const VERSION: string = pkg.version;
-
-// e.g., PI_CODING_AGENT_DIR or TAU_CODING_AGENT_DIR
-export const ENV_AGENT_DIR = `${APP_NAME.toUpperCase()}_CODING_AGENT_DIR`;
-
 // =============================================================================
 // User Config Paths (~/.pi/agent/*)
 // =============================================================================

package/src/core/agent-session.ts

@@ -1900,7 +1900,7 @@ export class AgentSession {
 	 * @param outputPath Optional output path (defaults to session directory)
 	 * @returns Path to exported file
 	 */
-	exportToHtml(outputPath?: string): string {
+	async exportToHtml(outputPath?: string): Promise<string> {
 		const themeName = this.settingsManager.getTheme();
 		return exportSessionToHtml(this.sessionManager, this.state, { outputPath, themeName });
 	}

package/src/core/auth-storage.ts

@@ -3,7 +3,7 @@
  * Handles loading, saving, and refreshing credentials from auth.json.
  */
 
-import { chmodSync, existsSync, mkdirSync } from "node:fs";
+import { chmodSync, existsSync, mkdirSync, readFileSync } from "node:fs";
 import { dirname } from "node:path";
 import {
 	getEnvApiKey,
@@ -73,8 +73,7 @@ export class AuthStorage {
 			return;
 		}
 		try {
-			const file = Bun.file(this.authPath);
-			this.data = JSON.parse(file.text() as unknown as string);
+			this.data = JSON.parse(readFileSync(this.authPath, "utf-8"));
 		} catch {
 			this.data = {};
 		}

package/src/core/export-html/index.ts

@@ -1,44 +1,19 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { basename, join } from "node:path";
+import { existsSync, writeFileSync } from "node:fs";
+import { basename } from "node:path";
 import type { AgentState } from "@oh-my-pi/pi-agent-core";
-import { APP_NAME, getExportTemplateDir } from "../../config";
+import { APP_NAME } from "../../config";
 import { getResolvedThemeColors, getThemeExportColors } from "../../modes/interactive/theme/theme";
 import { SessionManager } from "../session-manager";
 
-// Cached minified assets (populated on first use)
-let cachedTemplate: string | null = null;
-let cachedJs: string | null = null;
-
-/** Minify CSS by removing comments, unnecessary whitespace, and newlines. */
-function minifyCss(css: string): string {
-	return css
-		.replace(/\/\*[\s\S]*?\*\//g, "") // Remove comments
-		.replace(/\s+/g, " ") // Collapse whitespace
-		.replace(/\s*([{}:;,>+~])\s*/g, "$1") // Remove space around punctuation
-		.replace(/;}/g, "}") // Remove trailing semicolons
-		.trim();
-}
-
-/** Minify JS using Bun's transpiler. */
-function minifyJs(js: string): string {
-	const transpiler = new Bun.Transpiler({ loader: "js", minifyWhitespace: true });
-	return transpiler.transformSync(js);
-}
-
-/** Minify HTML by collapsing whitespace outside of tags. */
-function minifyHtml(html: string): string {
-	return html
-		.replace(/>\s+</g, "><") // Remove whitespace between tags
-		.replace(/\s{2,}/g, " ") // Collapse multiple spaces
-		.trim();
-}
+// Bun macro: bundles HTML+CSS+JS at compile time, evaluated at bundle time
+import { getTemplate } from "./template.macro" with { type: "macro" };
 
 export interface ExportOptions {
 	outputPath?: string;
 	themeName?: string;
 }
 
-/** Parse a color string to RGB values. Supports hex (#RRGGBB) and rgb(r,g,b) formats. */
+/** Parse a color string to RGB values. */
 function parseColor(color: string): { r: number; g: number; b: number } | undefined {
 	const hexMatch = color.match(/^#([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})$/);
 	if (hexMatch) {
@@ -68,7 +43,7 @@ function getLuminance(r: number, g: number, b: number): number {
 	return 0.2126 * toLinear(r) + 0.7152 * toLinear(g) + 0.0722 * toLinear(b);
 }
 
-/** Adjust color brightness. Factor > 1 lightens, < 1 darkens. */
+/** Adjust color brightness. */
 function adjustBrightness(color: string, factor: number): string {
 	const parsed = parseColor(color);
 	if (!parsed) return color;
@@ -76,21 +51,15 @@ function adjustBrightness(color: string, factor: number): string {
 	return `rgb(${adjust(parsed.r)}, ${adjust(parsed.g)}, ${adjust(parsed.b)})`;
 }
 
-/** Derive export background colors from a base color (e.g., userMessageBg). */
+/** Derive export background colors from a base color. */
 function deriveExportColors(baseColor: string): { pageBg: string; cardBg: string; infoBg: string } {
 	const parsed = parseColor(baseColor);
 	if (!parsed) {
-		return {
-			pageBg: "rgb(24, 24, 30)",
-			cardBg: "rgb(30, 30, 36)",
-			infoBg: "rgb(60, 55, 40)",
-		};
+		return { pageBg: "rgb(24, 24, 30)", cardBg: "rgb(30, 30, 36)", infoBg: "rgb(60, 55, 40)" };
 	}
 
 	const luminance = getLuminance(parsed.r, parsed.g, parsed.b);
-	const isLight = luminance > 0.5;
-
-	if (isLight) {
+	if (luminance > 0.5) {
 		return {
 			pageBg: adjustBrightness(baseColor, 0.96),
 			cardBg: baseColor,
@@ -104,9 +73,7 @@ function deriveExportColors(baseColor: string): { pageBg: string; cardBg: string
 	};
 }
 
-/**
- * Generate CSS custom property declarations from theme colors.
- */
+/** Generate CSS custom properties for theme. */
 function generateThemeVars(themeName?: string): string {
 	const colors = getResolvedThemeColors(themeName);
 	const lines: string[] = [];
@@ -114,16 +81,15 @@ function generateThemeVars(themeName?: string): string {
 		lines.push(`--${key}: ${value};`);
 	}
 
-	// Use explicit theme export colors if available, otherwise derive from userMessageBg
 	const themeExport = getThemeExportColors(themeName);
 	const userMessageBg = colors.userMessageBg || "#343541";
-	const derivedColors = deriveExportColors(userMessageBg);
+	const derived = deriveExportColors(userMessageBg);
 
-	lines.push(`--exportPageBg: ${themeExport.pageBg ?? derivedColors.pageBg};`);
-	lines.push(`--exportCardBg: ${themeExport.cardBg ?? derivedColors.cardBg};`);
-	lines.push(`--exportInfoBg: ${themeExport.infoBg ?? derivedColors.infoBg};`);
+	lines.push(`--body-bg: ${themeExport.pageBg ?? derived.pageBg};`);
+	lines.push(`--container-bg: ${themeExport.cardBg ?? derived.cardBg};`);
+	lines.push(`--info-bg: ${themeExport.infoBg ?? derived.infoBg};`);
 
-	return lines.join("\n      ");
+	return lines.join(" ");
 }
 
 interface SessionData {
@@ -134,61 +100,28 @@ interface SessionData {
 	tools?: { name: string; description: string }[];
 }
 
-/**
- * Core HTML generation logic shared by both export functions.
- */
-function generateHtml(sessionData: SessionData, themeName?: string): string {
-	const templateDir = getExportTemplateDir();
-
-	// Load and minify assets on first use
-	if (!cachedTemplate) {
-		cachedTemplate = minifyHtml(readFileSync(join(templateDir, "template.html"), "utf-8"));
-	}
-	if (!cachedJs) {
-		cachedJs = minifyJs(readFileSync(join(templateDir, "template.js"), "utf-8"));
-	}
-
-	const templateCss = readFileSync(join(templateDir, "template.css"), "utf-8");
-
+/** Generate HTML from bundled template with runtime substitutions. */
+async function generateHtml(sessionData: SessionData, themeName?: string): Promise<string> {
 	const themeVars = generateThemeVars(themeName);
-	const colors = getResolvedThemeColors(themeName);
-	const exportColors = deriveExportColors(colors.userMessageBg || "#343541");
-	const bodyBg = exportColors.pageBg;
-	const containerBg = exportColors.cardBg;
-	const infoBg = exportColors.infoBg;
-
-	// Base64 encode session data to avoid escaping issues
 	const sessionDataBase64 = Buffer.from(JSON.stringify(sessionData)).toString("base64");
+	const template = await getTemplate();
 
-	// Build and minify the CSS with theme variables injected
-	const css = minifyCss(
-		templateCss
-			.replace("{{THEME_VARS}}", themeVars)
-			.replace("{{BODY_BG}}", bodyBg)
-			.replace("{{CONTAINER_BG}}", containerBg)
-			.replace("{{INFO_BG}}", infoBg),
-	);
-
-	return cachedTemplate
-		.replace("{{CSS}}", css)
-		.replace("{{JS}}", cachedJs)
+	return template
+		.replace("<theme-vars/>", `<style>:root { ${themeVars} }</style>`)
 		.replace("{{SESSION_DATA}}", sessionDataBase64);
 }
 
-/**
- * Export session to HTML using SessionManager and AgentState.
- * Used by TUI's /export command.
- */
-export function exportSessionToHtml(sm: SessionManager, state?: AgentState, options?: ExportOptions | string): string {
+/** Export session to HTML using SessionManager and AgentState. */
+export async function exportSessionToHtml(
+	sm: SessionManager,
+	state?: AgentState,
+	options?: ExportOptions | string,
+): Promise<string> {
 	const opts: ExportOptions = typeof options === "string" ? { outputPath: options } : options || {};
 
 	const sessionFile = sm.getSessionFile();
-	if (!sessionFile) {
-		throw new Error("Cannot export in-memory session to HTML");
-	}
-	if (!existsSync(sessionFile)) {
-		throw new Error("Nothing to export yet - start a conversation first");
-	}
+	if (!sessionFile) throw new Error("Cannot export in-memory session to HTML");
+	if (!existsSync(sessionFile)) throw new Error("Nothing to export yet - start a conversation first");
 
 	const sessionData: SessionData = {
 		header: sm.getHeader(),
@@ -198,46 +131,28 @@ export function exportSessionToHtml(sm: SessionManager, state?: AgentState, opti
 		tools: state?.tools?.map((t) => ({ name: t.name, description: t.description })),
 	};
 
-	const html = generateHtml(sessionData, opts.themeName);
-
-	let outputPath = opts.outputPath;
-	if (!outputPath) {
-		const sessionBasename = basename(sessionFile, ".jsonl");
-		outputPath = `${APP_NAME}-session-${sessionBasename}.html`;
-	}
+	const html = await generateHtml(sessionData, opts.themeName);
+	const outputPath = opts.outputPath || `${APP_NAME}-session-${basename(sessionFile, ".jsonl")}.html`;
 
 	writeFileSync(outputPath, html, "utf8");
 	return outputPath;
 }
 
-/**
- * Export session file to HTML (standalone, without AgentState).
- * Used by CLI for exporting arbitrary session files.
- */
-export function exportFromFile(inputPath: string, options?: ExportOptions | string): string {
+/** Export session file to HTML (standalone). */
+export async function exportFromFile(inputPath: string, options?: ExportOptions | string): Promise<string> {
 	const opts: ExportOptions = typeof options === "string" ? { outputPath: options } : options || {};
 
-	if (!existsSync(inputPath)) {
-		throw new Error(`File not found: ${inputPath}`);
-	}
+	if (!existsSync(inputPath)) throw new Error(`File not found: ${inputPath}`);
 
 	const sm = SessionManager.open(inputPath);
-
 	const sessionData: SessionData = {
 		header: sm.getHeader(),
 		entries: sm.getEntries(),
 		leafId: sm.getLeafId(),
-		systemPrompt: undefined,
-		tools: undefined,
 	};
 
-	const html = generateHtml(sessionData, opts.themeName);
-
-	let outputPath = opts.outputPath;
-	if (!outputPath) {
-		const inputBasename = basename(inputPath, ".jsonl");
-		outputPath = `${APP_NAME}-session-${inputBasename}.html`;
-	}
+	const html = await generateHtml(sessionData, opts.themeName);
+	const outputPath = opts.outputPath || `${APP_NAME}-session-${basename(inputPath, ".jsonl")}.html`;
 
 	writeFileSync(outputPath, html, "utf8");
 	return outputPath;

package/src/core/export-html/template.css

@@ -1,10 +1,3 @@
-    :root {
-      {{THEME_VARS}}
-      --body-bg: {{BODY_BG}};
-      --container-bg: {{CONTAINER_BG}};
-      --info-bg: {{INFO_BG}};
-    }
-
     * { margin: 0; padding: 0; box-sizing: border-box; }
 
     :root {

package/src/core/export-html/template.html

@@ -4,9 +4,8 @@
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <title>Session Export</title>
-  <style>
-{{CSS}}
-  </style>
+  <template-css/>
+  <theme-vars/>
 </head>
 <body>
   <button id="hamburger" title="Open sidebar"><svg width="14" height="14" viewBox="0 0 24 24" fill="currentColor" stroke="none"><circle cx="6" cy="6" r="2.5"/><circle cx="6" cy="18" r="2.5"/><circle cx="18" cy="12" r="2.5"/><rect x="5" y="6" width="2" height="12"/><path d="M6 12h10c1 0 2 0 2-2V8"/></svg></button>
@@ -41,6 +40,6 @@
   <script id="session-data" type="application/json">{{SESSION_DATA}}</script>
   <script src="https://cdnjs.cloudflare.com/ajax/libs/marked/15.0.4/marked.min.js" integrity="sha512-VmLxPVdDGeR+F0DzUHVqzHwaR4ZSSh1g/7aYXwKT1PAGVxunOEcysta+4H5Utvmpr2xExEPybZ8q+iM9F1tGdw==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
   <script src="https://cdnjs.cloudflare.com/ajax/libs/highlight.js/11.9.0/highlight.min.js" integrity="sha512-D9gUyxqja7hBtkWpPWGt9wfbfaMGVt9gnyCvYa+jojwwPHLCzUm5i8rpk7vD7wNee9bA35eYIjobYPaQuKS1MQ==" crossorigin="anonymous" referrerpolicy="no-referrer"></script>
-  <script>{{JS}}</script>
+  <template-js/>
 </body>
 </html>

package/src/core/export-html/template.macro.ts

@@ -0,0 +1,24 @@
+/**
+ * Bun macro that inlines HTML template with CSS/JS at compile time.
+ * This runs during `bun build` and embeds the result as a string.
+ */
+export async function getTemplate(): Promise<string> {
+	const dir = new URL(".", import.meta.url).pathname;
+
+	// Read all files
+	const html = await Bun.file(`${dir}template.html`).text();
+	const css = await Bun.file(`${dir}template.css`).text();
+	const js = await Bun.file(`${dir}template.js`).text();
+
+	// Minify CSS
+	const minifiedCss = css
+		.replace(/\/\*[\s\S]*?\*\//g, "")
+		.replace(/\s+/g, " ")
+		.replace(/\s*([{}:;,])\s*/g, "$1")
+		.trim();
+
+	// Inline everything
+	return html
+		.replace("<template-css/>", `<style>${minifiedCss}</style>`)
+		.replace("<template-js/>", `<script>${js}</script>`);
+}

package/src/core/tools/task/agents.ts

@@ -1,17 +1,24 @@
 /**
  * Bundled agent definitions.
  *
- * Agents are loaded from .md files in the bundled-agents directory.
- * These serve as defaults when no user/project agents are discovered.
+ * Agents are embedded at build time via Bun's import with { type: "text" }.
  */
 
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { fileURLToPath } from "node:url";
+// Embed agent markdown files at build time
+import browserMd from "./bundled-agents/browser.md" with { type: "text" };
+import exploreMd from "./bundled-agents/explore.md" with { type: "text" };
+import planMd from "./bundled-agents/plan.md" with { type: "text" };
+import reviewerMd from "./bundled-agents/reviewer.md" with { type: "text" };
+import taskMd from "./bundled-agents/task.md" with { type: "text" };
 import type { AgentDefinition, AgentSource } from "./types";
 
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const BUNDLED_AGENTS_DIR = path.join(__dirname, "bundled-agents");
+const EMBEDDED_AGENTS: { name: string; content: string }[] = [
+	{ name: "browser.md", content: browserMd },
+	{ name: "explore.md", content: exploreMd },
+	{ name: "plan.md", content: planMd },
+	{ name: "reviewer.md", content: reviewerMd },
+	{ name: "task.md", content: taskMd },
+];
 
 /**
  * Parse YAML frontmatter from markdown content.
@@ -47,16 +54,9 @@ function parseFrontmatter(content: string): { frontmatter: Record<string, string
 }
 
 /**
- * Load a single agent from a markdown file.
+ * Parse an agent from embedded content.
  */
-function loadAgentFromFile(filePath: string, source: AgentSource): AgentDefinition | null {
-	let content: string;
-	try {
-		content = fs.readFileSync(filePath, "utf-8");
-	} catch {
-		return null;
-	}
-
+function parseAgent(fileName: string, content: string, source: AgentSource): AgentDefinition | null {
 	const { frontmatter, body } = parseFrontmatter(content);
 
 	if (!frontmatter.name || !frontmatter.description) {
@@ -79,7 +79,7 @@ function loadAgentFromFile(filePath: string, source: AgentSource): AgentDefiniti
 		recursive,
 		systemPrompt: body,
 		source,
-		filePath,
+		filePath: `embedded:${fileName}`,
 	};
 }
 
@@ -87,7 +87,7 @@ function loadAgentFromFile(filePath: string, source: AgentSource): AgentDefiniti
 let bundledAgentsCache: AgentDefinition[] | null = null;
 
 /**
- * Load all bundled agents from the bundled-agents directory.
+ * Load all bundled agents from embedded content.
  * Results are cached after first load.
  */
 export function loadBundledAgents(): AgentDefinition[] {
@@ -97,24 +97,8 @@ export function loadBundledAgents(): AgentDefinition[] {
 
 	const agents: AgentDefinition[] = [];
 
-	if (!fs.existsSync(BUNDLED_AGENTS_DIR)) {
-		bundledAgentsCache = agents;
-		return agents;
-	}
-
-	let entries: fs.Dirent[];
-	try {
-		entries = fs.readdirSync(BUNDLED_AGENTS_DIR, { withFileTypes: true });
-	} catch {
-		bundledAgentsCache = agents;
-		return agents;
-	}
-
-	for (const entry of entries) {
-		if (!entry.name.endsWith(".md")) continue;
-
-		const filePath = path.join(BUNDLED_AGENTS_DIR, entry.name);
-		const agent = loadAgentFromFile(filePath, "bundled");
+	for (const { name, content } of EMBEDDED_AGENTS) {
+		const agent = parseAgent(name, content, "bundled");
 		if (agent) {
 			agents.push(agent);
 		}

package/src/core/tools/task/commands.ts

@@ -1,17 +1,23 @@
 /**
  * Workflow commands for orchestrating multi-agent workflows.
  *
- * Commands are loaded from .md files with YAML frontmatter.
- * They define multi-step workflows that chain agent outputs.
+ * Commands are embedded at build time via Bun's import with { type: "text" }.
  */
 
 import * as fs from "node:fs";
 import * as os from "node:os";
 import * as path from "node:path";
-import { fileURLToPath } from "node:url";
 
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const BUNDLED_COMMANDS_DIR = path.join(__dirname, "bundled-commands");
+// Embed command markdown files at build time
+import architectPlanMd from "./bundled-commands/architect-plan.md" with { type: "text" };
+import implementMd from "./bundled-commands/implement.md" with { type: "text" };
+import implementWithCriticMd from "./bundled-commands/implement-with-critic.md" with { type: "text" };
+
+const EMBEDDED_COMMANDS: { name: string; content: string }[] = [
+	{ name: "architect-plan.md", content: architectPlanMd },
+	{ name: "implement-with-critic.md", content: implementWithCriticMd },
+	{ name: "implement.md", content: implementMd },
+];
 
 /** Workflow command definition */
 export interface WorkflowCommand {
@@ -56,9 +62,9 @@ function parseFrontmatter(content: string): { frontmatter: Record<string, string
 }
 
 /**
- * Load commands from a directory.
+ * Load commands from a directory (for user/project commands).
  */
-function loadCommandsFromDir(dir: string, source: "bundled" | "user" | "project"): WorkflowCommand[] {
+function loadCommandsFromDir(dir: string, source: "user" | "project"): WorkflowCommand[] {
 	const commands: WorkflowCommand[] = [];
 
 	if (!fs.existsSync(dir)) {
@@ -137,15 +143,30 @@ function findNearestDir(cwd: string, relPath: string): string | null {
 let bundledCommandsCache: WorkflowCommand[] | null = null;
 
 /**
- * Load all bundled commands.
+ * Load all bundled commands from embedded content.
  */
 export function loadBundledCommands(): WorkflowCommand[] {
 	if (bundledCommandsCache !== null) {
 		return bundledCommandsCache;
 	}
 
-	bundledCommandsCache = loadCommandsFromDir(BUNDLED_COMMANDS_DIR, "bundled");
-	return bundledCommandsCache;
+	const commands: WorkflowCommand[] = [];
+
+	for (const { name, content } of EMBEDDED_COMMANDS) {
+		const { frontmatter, body } = parseFrontmatter(content);
+		const cmdName = name.replace(/\.md$/, "");
+
+		commands.push({
+			name: cmdName,
+			description: frontmatter.description || "",
+			instructions: body,
+			source: "bundled",
+			filePath: `embedded:${name}`,
+		});
+	}
+
+	bundledCommandsCache = commands;
+	return commands;
 }
 
 /**

package/src/main.ts

@@ -14,6 +14,7 @@ import { processFileArguments } from "./cli/file-processor";
 import { listModels } from "./cli/list-models";
 import { parsePluginArgs, printPluginHelp, runPluginCommand } from "./cli/plugin-cli";
 import { selectSession } from "./cli/session-picker";
+import { parseUpdateArgs, printUpdateHelp, runUpdateCommand } from "./cli/update-cli";
 import { CONFIG_DIR_NAME, getAgentDir, getModelsPath, VERSION } from "./config";
 import type { AgentSession } from "./core/agent-session";
 import type { LoadedCustomTool } from "./core/custom-tools/index";
@@ -308,6 +309,17 @@ export async function main(args: string[]) {
 		return;
 	}
 
+	// Handle update subcommand
+	const updateCmd = parseUpdateArgs(args);
+	if (updateCmd) {
+		if (args.includes("--help") || args.includes("-h")) {
+			printUpdateHelp();
+			return;
+		}
+		await runUpdateCommand(updateCmd);
+		return;
+	}
+
 	// Run migrations
 	const { migratedAuthProviders: migratedProviders } = runMigrations();
 
@@ -338,7 +350,7 @@ export async function main(args: string[]) {
 	if (parsed.export) {
 		try {
 			const outputPath = parsed.messages.length > 0 ? parsed.messages[0] : undefined;
-			const result = exportFromFile(parsed.export, outputPath);
+			const result = await exportFromFile(parsed.export, outputPath);
 			console.log(`Exported to: ${result}`);
 			return;
 		} catch (error: unknown) {

package/src/modes/interactive/interactive-mode.ts

@@ -2130,7 +2130,7 @@ export class InteractiveMode {
 
 		// HTML file export
 		try {
-			const filePath = this.session.exportToHtml(arg);
+			const filePath = await this.session.exportToHtml(arg);
 			this.showStatus(`Session exported to: ${filePath}`);
 		} catch (error: unknown) {
 			this.showError(`Failed to export session: ${error instanceof Error ? error.message : "Unknown error"}`);
@@ -2153,7 +2153,7 @@ export class InteractiveMode {
 		// Export to a temp file
 		const tmpFile = path.join(os.tmpdir(), "session.html");
 		try {
-			this.session.exportToHtml(tmpFile);
+			await this.session.exportToHtml(tmpFile);
 		} catch (error: unknown) {
 			this.showError(`Failed to export session: ${error instanceof Error ? error.message : "Unknown error"}`);
 			return;

package/src/modes/interactive/theme/theme.ts

@@ -5,8 +5,11 @@ import { type Static, Type } from "@sinclair/typebox";
 import { TypeCompiler } from "@sinclair/typebox/compiler";
 import chalk from "chalk";
 import { highlight, supportsLanguage } from "cli-highlight";
-import { getCustomThemesDir, getThemesDir } from "../../../config";
+import { getCustomThemesDir } from "../../../config";
 import { logger } from "../../../core/logger";
+// Embed theme JSON files at build time
+import darkThemeJson from "./dark.json" with { type: "json" };
+import lightThemeJson from "./light.json" with { type: "json" };
 
 // ============================================================================
 // Types & Schema
@@ -450,18 +453,12 @@ export class Theme {
 // Theme Loading
 // ============================================================================
 
-let BUILTIN_THEMES: Record<string, ThemeJson> | undefined;
+const BUILTIN_THEMES: Record<string, ThemeJson> = {
+	dark: darkThemeJson as ThemeJson,
+	light: lightThemeJson as ThemeJson,
+};
 
 function getBuiltinThemes(): Record<string, ThemeJson> {
-	if (!BUILTIN_THEMES) {
-		const themesDir = getThemesDir();
-		const darkPath = path.join(themesDir, "dark.json");
-		const lightPath = path.join(themesDir, "light.json");
-		BUILTIN_THEMES = {
-			dark: JSON.parse(fs.readFileSync(darkPath, "utf-8")) as ThemeJson,
-			light: JSON.parse(fs.readFileSync(lightPath, "utf-8")) as ThemeJson,
-		};
-	}
 	return BUILTIN_THEMES;
 }
 

package/src/modes/rpc/rpc-mode.ts

@@ -401,7 +401,7 @@ export async function runRpcMode(session: AgentSession): Promise<never> {
 			}
 
 			case "export_html": {
-				const path = session.exportToHtml(command.outputPath);
+				const path = await session.exportToHtml(command.outputPath);
 				return success(id, "export_html", { path });
 			}