pi-model-profiles 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.3.3] - 2026-06-01
+
+### Changed
+- Lazy-loaded the model profiles command handler by extracting it into `src/command-handler.ts`, reducing startup work.
+- Widened Pi peer dependency compatibility to include Pi 0.77.x and 0.78.x.
+
 ## [0.3.2] - 2026-05-26
 
 ### Changed

package/package.json

@@ -1,66 +1,66 @@
-{
-  "name": "pi-model-profiles",
-  "version": "0.3.2",
-  "private": false,
-  "description": "Pi extension for saving, importing, and applying agent model frontmatter profiles.",
-  "type": "module",
-  "main": "./index.ts",
-  "exports": {
-    ".": "./index.ts"
-  },
-  "files": [
-    "index.ts",
-    "src",
-    "README.md",
-    "CHANGELOG.md",
-    "config/config.example.json",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "npx --yes -p typescript@5.9.2 tsc -p tsconfig.json",
-    "lint": "npm run build",
-    "test:clean": "node -e \"require('node:fs').rmSync('.test-dist', { recursive: true, force: true })\"",
-    "prepublishOnly": "npm run test",
-    "pretest": "npm run test:clean",
-    "test": "npx --yes -p typescript@5.9.2 tsc --strict --skipLibCheck --module nodenext --moduleResolution nodenext --target ES2022 --outDir .test-dist src/types-shims.d.ts src/errors.ts src/types.ts src/constants.ts src/atomic-write.ts src/profile-fields.ts src/frontmatter-parser.ts src/profile-store.ts src/agent-writer.ts src/import-service.ts src/config.ts src/debug-logger.ts test/frontmatter-parser.test.ts test/import-service.test.ts test/agent-writer.test.ts test/profile-store.test.ts test/debug-logger.test.ts && node --test .test-dist/test/frontmatter-parser.test.js .test-dist/test/import-service.test.js .test-dist/test/agent-writer.test.js .test-dist/test/profile-store.test.js .test-dist/test/debug-logger.test.js",
-    "posttest": "npm run test:clean",
-    "check": "npm run build && npm run test",
-    "package:dry-run": "npm pack --dry-run"
-  },
-  "keywords": [
-    "pi-package",
-    "pi",
-    "pi-extension",
-    "pi-coding-agent",
-    "coding-agent",
-    "model-profiles",
-    "frontmatter",
-    "agent-configuration",
-    "profiles"
-  ],
-  "author": "MasuRii",
-  "license": "MIT",
-  "homepage": "https://github.com/MasuRii/pi-model-profiles#readme",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MasuRii/pi-model-profiles.git"
-  },
-  "bugs": {
-    "url": "https://github.com/MasuRii/pi-model-profiles/issues"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "pi": {
-    "extensions": [
-      "./index.ts"
-    ]
-  },
-  "peerDependencies": {
-    "@earendil-works/pi-coding-agent": "^0.74.0 || ^0.75.0",
-    "@earendil-works/pi-tui": "^0.74.0 || ^0.75.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "pi-model-profiles",
+  "version": "0.3.3",
+  "private": false,
+  "description": "Pi extension for saving, importing, and applying agent model frontmatter profiles.",
+  "type": "module",
+  "main": "./index.ts",
+  "exports": {
+    ".": "./index.ts"
+  },
+  "files": [
+    "index.ts",
+    "src",
+    "README.md",
+    "CHANGELOG.md",
+    "config/config.example.json",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npx --yes -p typescript@5.9.2 tsc -p tsconfig.json",
+    "lint": "npm run build",
+    "test:clean": "node -e \"require('node:fs').rmSync('.test-dist', { recursive: true, force: true })\"",
+    "prepublishOnly": "npm run test",
+    "pretest": "npm run test:clean",
+    "test": "npx --yes -p typescript@5.9.2 tsc --strict --skipLibCheck --module nodenext --moduleResolution nodenext --target ES2022 --outDir .test-dist src/types-shims.d.ts src/errors.ts src/types.ts src/constants.ts src/atomic-write.ts src/profile-fields.ts src/frontmatter-parser.ts src/profile-store.ts src/agent-writer.ts src/import-service.ts src/config.ts src/debug-logger.ts test/frontmatter-parser.test.ts test/import-service.test.ts test/agent-writer.test.ts test/profile-store.test.ts test/debug-logger.test.ts && node --test .test-dist/test/frontmatter-parser.test.js .test-dist/test/import-service.test.js .test-dist/test/agent-writer.test.js .test-dist/test/profile-store.test.js .test-dist/test/debug-logger.test.js",
+    "posttest": "npm run test:clean",
+    "check": "npm run build && npm run test",
+    "package:dry-run": "npm pack --dry-run"
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-extension",
+    "pi-coding-agent",
+    "coding-agent",
+    "model-profiles",
+    "frontmatter",
+    "agent-configuration",
+    "profiles"
+  ],
+  "author": "MasuRii",
+  "license": "MIT",
+  "homepage": "https://github.com/MasuRii/pi-model-profiles#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MasuRii/pi-model-profiles.git"
+  },
+  "bugs": {
+    "url": "https://github.com/MasuRii/pi-model-profiles/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "pi": {
+    "extensions": [
+      "./index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.74.0 || ^0.75.0 || ^0.77.0 || ^0.78.0",
+    "@earendil-works/pi-tui": "^0.74.0 || ^0.75.0 || ^0.77.0 || ^0.78.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/command-handler.ts

@@ -0,0 +1,137 @@
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+
+import {
+	INITIAL_PROFILE_NAME,
+	PROFILE_NAME_SUFFIX,
+	PROFILE_STORE_PATH,
+} from "./constants.js";
+import { applySavedProfile, captureAgentSnapshots, detectActiveAgentName } from "./agent-writer.js";
+import { toErrorMessage } from "./errors.js";
+import { loadAndPrepareProfiles } from "./import-service.js";
+import { updateProfileAndReturn } from "./profile-update-service.js";
+import {
+	appendProfile,
+	createProfile,
+	findProfileById,
+	renameStoredProfile,
+	resolveUniqueProfileName,
+	saveProfilesFile,
+} from "./profile-store.js";
+import { removeProfileAndUpdate } from "./profile-removal-service.js";
+import { openProfilesModal, type ProfileModalResult } from "./profile-modal.js";
+import type { AppliedProfileOutcome, ProfilesFile } from "./types.js";
+
+function buildCurrentProfileName(activeAgentName: string | null, data: ProfilesFile): string {
+	const baseName = activeAgentName ? `${activeAgentName} ${PROFILE_NAME_SUFFIX}` : INITIAL_PROFILE_NAME;
+	return resolveUniqueProfileName(baseName, data.profiles);
+}
+
+function notifyWarnings(ctx: ExtensionCommandContext, warnings: readonly string[]): void {
+	if (warnings.length === 0) {
+		return;
+	}
+	ctx.ui.notify(warnings.join(" "), "warning");
+}
+
+function summarizeApplyOutcome(outcome: AppliedProfileOutcome): string {
+	const appliedCount = outcome.appliedAgents.length;
+	const missingCount = outcome.missingAgents.length;
+	const appliedLabel = `${appliedCount} agent file${appliedCount === 1 ? "" : "s"}`;
+	if (missingCount === 0) {
+		return appliedLabel;
+	}
+	return `${appliedLabel}; ${missingCount} missing`;
+}
+
+async function reloadAfterApply(ctx: ExtensionCommandContext, outcome: AppliedProfileOutcome): Promise<void> {
+	const summary = summarizeApplyOutcome(outcome);
+	ctx.ui.notify(`Profile '${outcome.profileName}' applied across ${summary}. Reloading…`, "info");
+
+	try {
+		await ctx.reload();
+	} catch (error) {
+		ctx.ui.notify(
+			`Profile '${outcome.profileName}' applied across ${summary}, but automatic reload failed: ${toErrorMessage(error)}. Run /reload.`,
+			"error",
+		);
+	}
+}
+
+export async function handleModelProfilesCommand(ctx: ExtensionCommandContext): Promise<void> {
+	const agentOptions = { cwd: ctx.cwd, scope: "both" as const };
+	const prepared = loadAndPrepareProfiles(PROFILE_STORE_PATH, agentOptions);
+	notifyWarnings(ctx, prepared.warnings);
+
+	let data = prepared.data;
+	const activeAgentName = detectActiveAgentName(ctx.sessionManager, ctx.getSystemPrompt());
+
+	const result: ProfileModalResult = await openProfilesModal(ctx, data, activeAgentName, {
+		renameProfile: async (profileId, nextName) => {
+			data = renameStoredProfile(data, profileId, nextName);
+			saveProfilesFile(data, PROFILE_STORE_PATH);
+			return {
+				data,
+				message: `Renamed saved snapshot to '${nextName.trim()}'.`,
+				selectedProfileId: profileId,
+			};
+		},
+		addCurrentProfile: async () => {
+			const snapshot = captureAgentSnapshots(agentOptions);
+			notifyWarnings(ctx, snapshot.warnings);
+			const profile = createProfile(buildCurrentProfileName(activeAgentName, data), snapshot.agents);
+			data = appendProfile(data, profile);
+			saveProfilesFile(data, PROFILE_STORE_PATH);
+			return {
+				data,
+				message: `Saved current agents snapshot (${snapshot.agents.length} agents).`,
+				selectedProfileId: profile.id,
+			};
+		},
+		applyProfile: async (profileId) => {
+			const profile = findProfileById(data, profileId);
+			if (!profile) {
+				throw new Error(`Saved profile '${profileId}' was not found.`);
+			}
+			const applied = applySavedProfile(profile, agentOptions);
+			notifyWarnings(ctx, applied.warnings);
+			return {
+				...applied,
+				profileName: profile.name,
+			};
+		},
+		removeProfile: async (profileId) => {
+			const profile = findProfileById(data, profileId);
+			if (!profile) {
+				throw new Error(`Saved profile '${profileId}' was not found.`);
+			}
+			const removal = removeProfileAndUpdate(data, profileId);
+			data = removal.data;
+			saveProfilesFile(data, PROFILE_STORE_PATH);
+			return {
+				data,
+				message: `Removed saved snapshot '${removal.result.removedProfileName}' (${removal.result.remainingCount} snapshots remaining).`,
+				selectedProfileId: data.profiles[0]?.id,
+			};
+		},
+		updateProfile: async (profileId) => {
+			const profile = findProfileById(data, profileId);
+			if (!profile) {
+				throw new Error(`Saved profile '${profileId}' was not found.`);
+			}
+			const update = updateProfileAndReturn(data, profileId, agentOptions);
+			notifyWarnings(ctx, update.result.warnings);
+			data = update.data;
+			saveProfilesFile(data, PROFILE_STORE_PATH);
+			return {
+				data,
+				message: `Updated '${profile.name}' with current agent state (${update.result.updatedAgents} agents).`,
+				selectedProfileId: profileId,
+			};
+		},
+	});
+
+	if (result.type === "applied") {
+		await reloadAfterApply(ctx, result.outcome);
+		return;
+	}
+}

package/src/errors.ts

@@ -1,3 +1,5 @@
+export const COMMAND_NAME = "model-profiles";
+
 export class ModelProfilesError extends Error {
 	readonly code: string;
 

package/src/import-service.ts

@@ -1,60 +1,60 @@
-import { AGENTS_DIR, INITIAL_PROFILE_NAME, PROFILE_STORE_PATH } from "./constants.js";
-import { captureAgentSnapshots, type AgentSelectionOptions } from "./agent-writer.js";
-import { appendProfile, createProfile, loadProfilesFile, resolveUniqueProfileName, saveProfilesFile } from "./profile-store.js";
-import { loadMultiProfilesConfig } from "./config.js";
-import { multiProfilesDebugLogger } from "./debug-logger.js";
-import type { ImportProfilesResult, ProfilesFile } from "./types.js";
-
-export function ensureProfilesImported(
-	data: ProfilesFile,
-	agentOptions: string | AgentSelectionOptions = AGENTS_DIR,
-): ImportProfilesResult {
-	if (data.importedAt) {
-		return {
-			data,
-			imported: false,
-			importedCount: 0,
-			warnings: [],
-		};
-	}
-
-	const snapshot = captureAgentSnapshots(agentOptions);
-	const timestamp = new Date().toISOString();
-	const profile = createProfile(resolveUniqueProfileName(INITIAL_PROFILE_NAME, data.profiles), snapshot.agents, { timestamp });
-
-	return {
-		data: {
-			...appendProfile(data, profile),
-			importedAt: timestamp,
-		},
-		imported: true,
-		importedCount: 1,
-		warnings: snapshot.warnings,
-	};
-}
-
-export function loadAndPrepareProfiles(
-	storePath = PROFILE_STORE_PATH,
-	agentOptions: string | AgentSelectionOptions = AGENTS_DIR,
-): ImportProfilesResult {
-	const configLoad = loadMultiProfilesConfig();
-
-	multiProfilesDebugLogger.log("extension.initialized", {
-		configCreated: configLoad.created,
-		timestamp: new Date().toISOString(),
-		profilesVersion: 2,
-	});
-
-	const loaded = loadProfilesFile(storePath, agentOptions);
-	const prepared = ensureProfilesImported(loaded.data, agentOptions);
-
-	if (loaded.needsSave || prepared.imported) {
-		saveProfilesFile(prepared.data, storePath);
-	}
-
-	const warnings = [configLoad.warning, loaded.warning, ...prepared.warnings].filter((message): message is string => Boolean(message));
-	return {
-		...prepared,
-		warnings,
-	};
-}
+import { AGENTS_DIR, INITIAL_PROFILE_NAME, PROFILE_STORE_PATH } from "./constants.js";
+import { captureAgentSnapshots, type AgentSelectionOptions } from "./agent-writer.js";
+import { appendProfile, createProfile, loadProfilesFile, resolveUniqueProfileName, saveProfilesFile } from "./profile-store.js";
+import { loadMultiProfilesConfig } from "./config.js";
+import { multiProfilesDebugLogger } from "./debug-logger.js";
+import type { ImportProfilesResult, ProfilesFile } from "./types.js";
+
+export function ensureProfilesImported(
+	data: ProfilesFile,
+	agentOptions: string | AgentSelectionOptions = AGENTS_DIR,
+): ImportProfilesResult {
+	if (data.importedAt) {
+		return {
+			data,
+			imported: false,
+			importedCount: 0,
+			warnings: [],
+		};
+	}
+
+	const snapshot = captureAgentSnapshots(agentOptions);
+	const timestamp = new Date().toISOString();
+	const profile = createProfile(resolveUniqueProfileName(INITIAL_PROFILE_NAME, data.profiles), snapshot.agents, { timestamp });
+
+	return {
+		data: {
+			...appendProfile(data, profile),
+			importedAt: timestamp,
+		},
+		imported: true,
+		importedCount: 1,
+		warnings: snapshot.warnings,
+	};
+}
+
+export function loadAndPrepareProfiles(
+	storePath = PROFILE_STORE_PATH,
+	agentOptions: string | AgentSelectionOptions = AGENTS_DIR,
+): ImportProfilesResult {
+	const configLoad = loadMultiProfilesConfig();
+
+	multiProfilesDebugLogger.log("extension.initialized", {
+		configCreated: configLoad.created,
+		timestamp: new Date().toISOString(),
+		profilesVersion: 2,
+	});
+
+	const loaded = loadProfilesFile(storePath, agentOptions);
+	const prepared = ensureProfilesImported(loaded.data, agentOptions);
+
+	if (loaded.needsSave || prepared.imported) {
+		saveProfilesFile(prepared.data, storePath);
+	}
+
+	const warnings = [configLoad.warning, loaded.warning, ...prepared.warnings].filter((message): message is string => Boolean(message));
+	return {
+		...prepared,
+		warnings,
+	};
+}

package/src/index.ts

@@ -1,158 +1,36 @@
-import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext } from "@earendil-works/pi-coding-agent";
-
-import { COMMAND_NAME, INITIAL_PROFILE_NAME, PROFILE_NAME_SUFFIX, PROFILE_STORE_PATH } from "./constants.js";
-import { applySavedProfile, captureAgentSnapshots, detectActiveAgentName } from "./agent-writer.js";
-import { toErrorMessage } from "./errors.js";
-import { loadAndPrepareProfiles } from "./import-service.js";
-import { updateProfileAndReturn } from "./profile-update-service.js";
-import { appendProfile, createProfile, findProfileById, renameStoredProfile, resolveUniqueProfileName, saveProfilesFile } from "./profile-store.js";
-import { removeProfileAndUpdate } from "./profile-removal-service.js";
-import { openProfilesModal, type ProfileModalResult } from "./profile-modal.js";
-import { onResourcesDiscover, refreshModelRegistry } from "./pi-api-utils.js";
-import type { AppliedProfileOutcome, ProfilesFile } from "./types.js";
-
-function buildCurrentProfileName(activeAgentName: string | null, data: ProfilesFile): string {
-	const baseName = activeAgentName ? `${activeAgentName} ${PROFILE_NAME_SUFFIX}` : INITIAL_PROFILE_NAME;
-	return resolveUniqueProfileName(baseName, data.profiles);
-}
-
-function notifyWarnings(ctx: ExtensionCommandContext, warnings: readonly string[]): void {
-	if (warnings.length === 0) {
-		return;
-	}
-	ctx.ui.notify(warnings.join(" "), "warning");
-}
-
-function summarizeApplyOutcome(outcome: AppliedProfileOutcome): string {
-	const appliedCount = outcome.appliedAgents.length;
-	const missingCount = outcome.missingAgents.length;
-	const appliedLabel = `${appliedCount} agent file${appliedCount === 1 ? "" : "s"}`;
-	if (missingCount === 0) {
-		return appliedLabel;
-	}
-	return `${appliedLabel}; ${missingCount} missing`;
-}
-
-async function reloadAfterApply(ctx: ExtensionCommandContext, outcome: AppliedProfileOutcome): Promise<void> {
-	const summary = summarizeApplyOutcome(outcome);
-	ctx.ui.notify(`Profile '${outcome.profileName}' applied across ${summary}. Reloading…`, "info");
-
-	try {
-		await ctx.reload();
-	} catch (error) {
-		ctx.ui.notify(
-			`Profile '${outcome.profileName}' applied across ${summary}, but automatic reload failed: ${toErrorMessage(error)}. Run /reload.`,
-			"error",
-		);
-	}
-}
-
-async function handleModelProfilesCommand(ctx: ExtensionCommandContext): Promise<void> {
-	const agentOptions = { cwd: ctx.cwd, scope: "both" as const };
-	const prepared = loadAndPrepareProfiles(PROFILE_STORE_PATH, agentOptions);
-	notifyWarnings(ctx, prepared.warnings);
-
-	let data = prepared.data;
-	const activeAgentName = detectActiveAgentName(ctx.sessionManager, ctx.getSystemPrompt());
-
-	const result: ProfileModalResult = await openProfilesModal(ctx, data, activeAgentName, {
-		renameProfile: async (profileId, nextName) => {
-			data = renameStoredProfile(data, profileId, nextName);
-			saveProfilesFile(data, PROFILE_STORE_PATH);
-			return {
-				data,
-				message: `Renamed saved snapshot to '${nextName.trim()}'.`,
-				selectedProfileId: profileId,
-			};
-		},
-		addCurrentProfile: async () => {
-			const snapshot = captureAgentSnapshots(agentOptions);
-			notifyWarnings(ctx, snapshot.warnings);
-			const profile = createProfile(buildCurrentProfileName(activeAgentName, data), snapshot.agents);
-			data = appendProfile(data, profile);
-			saveProfilesFile(data, PROFILE_STORE_PATH);
-			return {
-				data,
-				message: `Saved current agents snapshot (${snapshot.agents.length} agents).`,
-				selectedProfileId: profile.id,
-			};
-		},
-		applyProfile: async (profileId) => {
-			const profile = findProfileById(data, profileId);
-			if (!profile) {
-				throw new Error(`Saved profile '${profileId}' was not found.`);
-			}
-			const applied = applySavedProfile(profile, agentOptions);
-			notifyWarnings(ctx, applied.warnings);
-			return {
-				...applied,
-				profileName: profile.name,
-			};
-		},
-		removeProfile: async (profileId) => {
-			const profile = findProfileById(data, profileId);
-			if (!profile) {
-				throw new Error(`Saved profile '${profileId}' was not found.`);
-			}
-			const removal = removeProfileAndUpdate(data, profileId);
-			data = removal.data;
-			saveProfilesFile(data, PROFILE_STORE_PATH);
-			return {
-				data,
-				message: `Removed saved snapshot '${removal.result.removedProfileName}' (${removal.result.remainingCount} snapshots remaining).`,
-				selectedProfileId: data.profiles[0]?.id,
-			};
-		},
-		updateProfile: async (profileId) => {
-			const profile = findProfileById(data, profileId);
-			if (!profile) {
-				throw new Error(`Saved profile '${profileId}' was not found.`);
-			}
-			const update = updateProfileAndReturn(data, profileId, agentOptions);
-			notifyWarnings(ctx, update.result.warnings);
-			data = update.data;
-			saveProfilesFile(data, PROFILE_STORE_PATH);
-			return {
-				data,
-				message: `Updated '${profile.name}' with current agent state (${update.result.updatedAgents} agents).`,
-				selectedProfileId: profileId,
-			};
-		},
-	});
-
-	if (result.type === "applied") {
-		await reloadAfterApply(ctx, result.outcome);
-		return;
-	}
-}
-
-export default function modelProfilesExtension(pi: ExtensionAPI): void {
-	// Register handler to refresh model registry on /reload
-	// This works around the issue where AgentSession.reload() doesn't call ModelRegistry.refresh()
-	onResourcesDiscover(pi, (event, ctx): void => {
-		if (event.reason === "reload") {
-			refreshModelRegistry(ctx);
-		}
-	});
-
-	pi.registerCommand(COMMAND_NAME, {
-		description: "Open saved whole-agent model profile snapshots",
-		handler: async (args: string, ctx: ExtensionCommandContext): Promise<void> => {
-			if (args.trim()) {
-				ctx.ui.notify(`Usage: /${COMMAND_NAME}`, "warning");
-				return;
-			}
-
-			if (!ctx.hasUI) {
-				ctx.ui.notify(`/${COMMAND_NAME} requires interactive TUI mode.`, "warning");
-				return;
-			}
-
-			try {
-				await handleModelProfilesCommand(ctx);
-			} catch (error) {
-				ctx.ui.notify(`/${COMMAND_NAME} failed: ${toErrorMessage(error)}`, "error");
-			}
-		},
-	});
-}
+import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+
+import { COMMAND_NAME, toErrorMessage } from "./errors.js";
+import { onResourcesDiscover, refreshModelRegistry } from "./pi-api-utils.js";
+
+export default function modelProfilesExtension(pi: ExtensionAPI): void {
+	// Register handler to refresh model registry on /reload
+	// This works around the issue where AgentSession.reload() doesn't call ModelRegistry.refresh()
+	onResourcesDiscover(pi, (event, ctx): void => {
+		if (event.reason === "reload") {
+			refreshModelRegistry(ctx);
+		}
+	});
+
+	pi.registerCommand(COMMAND_NAME, {
+		description: "Open saved whole-agent model profile snapshots",
+		handler: async (args: string, ctx: ExtensionCommandContext): Promise<void> => {
+			if (args.trim()) {
+				ctx.ui.notify(`Usage: /${COMMAND_NAME}`, "warning");
+				return;
+			}
+
+			if (!ctx.hasUI) {
+				ctx.ui.notify(`/${COMMAND_NAME} requires interactive TUI mode.`, "warning");
+				return;
+			}
+
+			try {
+				const { handleModelProfilesCommand } = await import("./command-handler.js");
+				await handleModelProfilesCommand(ctx);
+			} catch (error) {
+				ctx.ui.notify(`/${COMMAND_NAME} failed: ${toErrorMessage(error)}`, "error");
+			}
+		},
+	});
+}

package/src/profile-removal-service.ts

@@ -1,106 +1,106 @@
-import { multiProfilesDebugLogger } from "./debug-logger.js";
-import { ModelProfilesError } from "./errors.js";
-import type { ProfilesFile, ProfileRemovalResult, SavedProfile } from "./types.js";
-
-/**
- * Error code for profile not found during removal.
- */
-export const PROFILE_NOT_FOUND_CODE = "PROFILE_NOT_FOUND";
-
-export interface ProfileRemovalUpdateResult {
-	data: ProfilesFile;
-	result: ProfileRemovalResult;
-}
-
-interface ProfileRemovalPlan {
-	profile: SavedProfile;
-	remainingProfiles: SavedProfile[];
-	result: ProfileRemovalResult;
-}
-
-function createProfileNotFoundError(profileId: string): ModelProfilesError {
-	return new ModelProfilesError(
-		`Profile '${profileId}' not found. It may have been removed already.`,
-		PROFILE_NOT_FOUND_CODE,
-	);
-}
-
-function buildRemovalPlan(data: ProfilesFile, profileId: string): ProfileRemovalPlan {
-	const profileIndex = data.profiles.findIndex((profile) => profile.id === profileId);
-	const profile = data.profiles[profileIndex];
-
-	if (profileIndex === -1 || !profile) {
-		multiProfilesDebugLogger.log("profile-removal", {
-			event: "removal_failed",
-			profileId,
-			reason: "profile_not_found",
-			profileCount: data.profiles.length,
-		});
-		throw createProfileNotFoundError(profileId);
-	}
-
-	const remainingProfiles = [
-		...data.profiles.slice(0, profileIndex),
-		...data.profiles.slice(profileIndex + 1),
-	];
-
-	return {
-		profile,
-		remainingProfiles,
-		result: {
-			removedProfileId: profile.id,
-			removedProfileName: profile.name,
-			remainingCount: remainingProfiles.length,
-		},
-	};
-}
-
-function logProfileRemoved(plan: ProfileRemovalPlan): void {
-	multiProfilesDebugLogger.log("profile-removal", {
-		event: "profile_removed",
-		profileId: plan.profile.id,
-		profileName: plan.profile.name,
-		agentCount: plan.profile.agents.length,
-		remainingCount: plan.result.remainingCount,
-	});
-}
-
-/**
- * Remove a profile from the profiles file.
- *
- * Validates that the profile exists before removal.
- * Preserves other profiles unchanged (immutable pattern).
- * Logs removal event via debug logger.
- *
- * @param data - The profiles file data
- * @param profileId - The ID of the profile to remove
- * @returns ProfileRemovalResult with removed profile info and remaining count
- * @throws ModelProfilesError with code PROFILE_NOT_FOUND if profile doesn't exist
- */
-export function removeProfile(data: ProfilesFile, profileId: string): ProfileRemovalResult {
-	const plan = buildRemovalPlan(data, profileId);
-	logProfileRemoved(plan);
-	return plan.result;
-}
-
-/**
- * Remove a profile and return the updated profiles file with removal metadata.
- *
- * @param data - The profiles file data
- * @param profileId - The ID of the profile to remove
- * @returns New ProfilesFile with the profile removed and removal metadata
- * @throws ModelProfilesError with code PROFILE_NOT_FOUND if profile doesn't exist
- */
-export function removeProfileAndUpdate(data: ProfilesFile, profileId: string): ProfileRemovalUpdateResult {
-	const plan = buildRemovalPlan(data, profileId);
-	logProfileRemoved(plan);
-
-	return {
-		data: {
-			version: data.version,
-			importedAt: data.importedAt,
-			profiles: plan.remainingProfiles,
-		},
-		result: plan.result,
-	};
-}
+import { multiProfilesDebugLogger } from "./debug-logger.js";
+import { ModelProfilesError } from "./errors.js";
+import type { ProfilesFile, ProfileRemovalResult, SavedProfile } from "./types.js";
+
+/**
+ * Error code for profile not found during removal.
+ */
+export const PROFILE_NOT_FOUND_CODE = "PROFILE_NOT_FOUND";
+
+export interface ProfileRemovalUpdateResult {
+	data: ProfilesFile;
+	result: ProfileRemovalResult;
+}
+
+interface ProfileRemovalPlan {
+	profile: SavedProfile;
+	remainingProfiles: SavedProfile[];
+	result: ProfileRemovalResult;
+}
+
+function createProfileNotFoundError(profileId: string): ModelProfilesError {
+	return new ModelProfilesError(
+		`Profile '${profileId}' not found. It may have been removed already.`,
+		PROFILE_NOT_FOUND_CODE,
+	);
+}
+
+function buildRemovalPlan(data: ProfilesFile, profileId: string): ProfileRemovalPlan {
+	const profileIndex = data.profiles.findIndex((profile) => profile.id === profileId);
+	const profile = data.profiles[profileIndex];
+
+	if (profileIndex === -1 || !profile) {
+		multiProfilesDebugLogger.log("profile-removal", {
+			event: "removal_failed",
+			profileId,
+			reason: "profile_not_found",
+			profileCount: data.profiles.length,
+		});
+		throw createProfileNotFoundError(profileId);
+	}
+
+	const remainingProfiles = [
+		...data.profiles.slice(0, profileIndex),
+		...data.profiles.slice(profileIndex + 1),
+	];
+
+	return {
+		profile,
+		remainingProfiles,
+		result: {
+			removedProfileId: profile.id,
+			removedProfileName: profile.name,
+			remainingCount: remainingProfiles.length,
+		},
+	};
+}
+
+function logProfileRemoved(plan: ProfileRemovalPlan): void {
+	multiProfilesDebugLogger.log("profile-removal", {
+		event: "profile_removed",
+		profileId: plan.profile.id,
+		profileName: plan.profile.name,
+		agentCount: plan.profile.agents.length,
+		remainingCount: plan.result.remainingCount,
+	});
+}
+
+/**
+ * Remove a profile from the profiles file.
+ *
+ * Validates that the profile exists before removal.
+ * Preserves other profiles unchanged (immutable pattern).
+ * Logs removal event via debug logger.
+ *
+ * @param data - The profiles file data
+ * @param profileId - The ID of the profile to remove
+ * @returns ProfileRemovalResult with removed profile info and remaining count
+ * @throws ModelProfilesError with code PROFILE_NOT_FOUND if profile doesn't exist
+ */
+export function removeProfile(data: ProfilesFile, profileId: string): ProfileRemovalResult {
+	const plan = buildRemovalPlan(data, profileId);
+	logProfileRemoved(plan);
+	return plan.result;
+}
+
+/**
+ * Remove a profile and return the updated profiles file with removal metadata.
+ *
+ * @param data - The profiles file data
+ * @param profileId - The ID of the profile to remove
+ * @returns New ProfilesFile with the profile removed and removal metadata
+ * @throws ModelProfilesError with code PROFILE_NOT_FOUND if profile doesn't exist
+ */
+export function removeProfileAndUpdate(data: ProfilesFile, profileId: string): ProfileRemovalUpdateResult {
+	const plan = buildRemovalPlan(data, profileId);
+	logProfileRemoved(plan);
+
+	return {
+		data: {
+			version: data.version,
+			importedAt: data.importedAt,
+			profiles: plan.remainingProfiles,
+		},
+		result: plan.result,
+	};
+}

package/src/profile-sort-service.ts

@@ -1,105 +1,105 @@
-import { multiProfilesDebugLogger } from "./debug-logger.js";
-import { loadMultiProfilesConfig, saveMultiProfilesConfig } from "./config.js";
-import type { ProfileSortResult, ProfilesFile, SavedProfile } from "./types.js";
-import type { ProfileSortOrder } from "./types.js";
-
-/**
- * Compare two profile names using locale-aware string comparison.
- */
-function compareByName(left: SavedProfile, right: SavedProfile): number {
-	return left.name.localeCompare(right.name);
-}
-
-/**
- * Compare two profiles by their createdAt timestamp.
- */
-function compareByDate(left: SavedProfile, right: SavedProfile): number {
-	const leftDate = new Date(left.createdAt).getTime();
-	const rightDate = new Date(right.createdAt).getTime();
-	return leftDate - rightDate;
-}
-
-/**
- * Sort profiles based on the specified order.
- * Returns a new array (immutable pattern), preserving the original data.profiles.
- * 
- * @param data - The profiles file containing the profiles array
- * @param order - The sort order to apply
- * @returns ProfileSortResult with sorted profiles and applied sort order
- */
-export function sortProfiles(data: ProfilesFile, order: ProfileSortOrder): ProfileSortResult {
-	const comparator = getSortComparator(order);
-	const sortedProfiles = [...data.profiles].sort(comparator);
-
-	return {
-		sortedProfiles,
-		sortOrder: order,
-	};
-}
-
-/**
- * Get the comparator function for a given sort order.
- */
-function getSortComparator(order: ProfileSortOrder): (left: SavedProfile, right: SavedProfile) => number {
-	switch (order) {
-		case "name-asc":
-			return compareByName;
-		case "name-desc":
-			return (left, right) => compareByName(right, left);
-		case "date-asc":
-			return compareByDate;
-		case "date-desc":
-			return (left, right) => compareByDate(right, left);
-	}
-}
-
-/**
- * Get the current sort order from config.
- */
-export function getCurrentSortOrder(): ProfileSortOrder {
-	const result = loadMultiProfilesConfig();
-	return result.config.sorting.defaultSort;
-}
-
-/**
- * Persist the sort order to config.
- */
-export function persistSortOrder(order: ProfileSortOrder): void {
-	const result = loadMultiProfilesConfig();
-	const config = result.config;
-	config.sorting.defaultSort = order;
-	saveMultiProfilesConfig(config);
-
-	multiProfilesDebugLogger.log("config", {
-		event: "sort_order_persisted",
-		order,
-	});
-}
-
-/**
- * Get display label for a sort order.
- */
-export function getSortOrderLabel(order: ProfileSortOrder): string {
-	switch (order) {
-		case "name-asc":
-			return "Name (A-Z)";
-		case "name-desc":
-			return "Name (Z-A)";
-		case "date-asc":
-			return "Date (Oldest)";
-		case "date-desc":
-			return "Date (Newest)";
-	}
-}
-
-/**
- * Get all available sort orders with their labels.
- */
-export function getAvailableSortOrders(): Array<{ order: ProfileSortOrder; label: string }> {
-	return [
-		{ order: "name-asc", label: "Name (A-Z)" },
-		{ order: "name-desc", label: "Name (Z-A)" },
-		{ order: "date-asc", label: "Date (Oldest)" },
-		{ order: "date-desc", label: "Date (Newest)" },
-	];
-}
+import { multiProfilesDebugLogger } from "./debug-logger.js";
+import { loadMultiProfilesConfig, saveMultiProfilesConfig } from "./config.js";
+import type { ProfileSortResult, ProfilesFile, SavedProfile } from "./types.js";
+import type { ProfileSortOrder } from "./types.js";
+
+/**
+ * Compare two profile names using locale-aware string comparison.
+ */
+function compareByName(left: SavedProfile, right: SavedProfile): number {
+	return left.name.localeCompare(right.name);
+}
+
+/**
+ * Compare two profiles by their createdAt timestamp.
+ */
+function compareByDate(left: SavedProfile, right: SavedProfile): number {
+	const leftDate = new Date(left.createdAt).getTime();
+	const rightDate = new Date(right.createdAt).getTime();
+	return leftDate - rightDate;
+}
+
+/**
+ * Sort profiles based on the specified order.
+ * Returns a new array (immutable pattern), preserving the original data.profiles.
+ * 
+ * @param data - The profiles file containing the profiles array
+ * @param order - The sort order to apply
+ * @returns ProfileSortResult with sorted profiles and applied sort order
+ */
+export function sortProfiles(data: ProfilesFile, order: ProfileSortOrder): ProfileSortResult {
+	const comparator = getSortComparator(order);
+	const sortedProfiles = [...data.profiles].sort(comparator);
+
+	return {
+		sortedProfiles,
+		sortOrder: order,
+	};
+}
+
+/**
+ * Get the comparator function for a given sort order.
+ */
+function getSortComparator(order: ProfileSortOrder): (left: SavedProfile, right: SavedProfile) => number {
+	switch (order) {
+		case "name-asc":
+			return compareByName;
+		case "name-desc":
+			return (left, right) => compareByName(right, left);
+		case "date-asc":
+			return compareByDate;
+		case "date-desc":
+			return (left, right) => compareByDate(right, left);
+	}
+}
+
+/**
+ * Get the current sort order from config.
+ */
+export function getCurrentSortOrder(): ProfileSortOrder {
+	const result = loadMultiProfilesConfig();
+	return result.config.sorting.defaultSort;
+}
+
+/**
+ * Persist the sort order to config.
+ */
+export function persistSortOrder(order: ProfileSortOrder): void {
+	const result = loadMultiProfilesConfig();
+	const config = result.config;
+	config.sorting.defaultSort = order;
+	saveMultiProfilesConfig(config);
+
+	multiProfilesDebugLogger.log("config", {
+		event: "sort_order_persisted",
+		order,
+	});
+}
+
+/**
+ * Get display label for a sort order.
+ */
+export function getSortOrderLabel(order: ProfileSortOrder): string {
+	switch (order) {
+		case "name-asc":
+			return "Name (A-Z)";
+		case "name-desc":
+			return "Name (Z-A)";
+		case "date-asc":
+			return "Date (Oldest)";
+		case "date-desc":
+			return "Date (Newest)";
+	}
+}
+
+/**
+ * Get all available sort orders with their labels.
+ */
+export function getAvailableSortOrders(): Array<{ order: ProfileSortOrder; label: string }> {
+	return [
+		{ order: "name-asc", label: "Name (A-Z)" },
+		{ order: "name-desc", label: "Name (Z-A)" },
+		{ order: "date-asc", label: "Date (Oldest)" },
+		{ order: "date-desc", label: "Date (Newest)" },
+	];
+}

package/src/profile-update-service.ts

@@ -1,134 +1,134 @@
-import { multiProfilesDebugLogger } from "./debug-logger.js";
-import { ModelProfilesError } from "./errors.js";
-import { captureAgentSnapshots, type AgentSelectionOptions } from "./agent-writer.js";
-import type { ProfilesFile, ProfileUpdateResult, SavedProfile } from "./types.js";
-
-/**
- * Error code for profile not found during update.
- */
-export const PROFILE_NOT_FOUND_CODE = "PROFILE_NOT_FOUND";
-
-export interface ProfileUpdateDataResult {
-	data: ProfilesFile;
-	result: ProfileUpdateResult;
-}
-
-interface ProfileUpdatePlan {
-	updatedData: ProfilesFile;
-	updatedProfile: SavedProfile;
-	previousProfile: SavedProfile;
-	result: ProfileUpdateResult;
-}
-
-function createProfileNotFoundError(profileId: string): ModelProfilesError {
-	return new ModelProfilesError(
-		`Profile '${profileId}' not found. It may have been removed already.`,
-		PROFILE_NOT_FOUND_CODE,
-	);
-}
-
-function buildUpdatePlan(
-	data: ProfilesFile,
-	profileId: string,
-	agentOptions: AgentSelectionOptions,
-): ProfileUpdatePlan {
-	const profileIndex = data.profiles.findIndex((profile) => profile.id === profileId);
-	const profile = data.profiles[profileIndex];
-
-	if (profileIndex === -1 || !profile) {
-		multiProfilesDebugLogger.log("profile-update", {
-			event: "update_failed",
-			profileId,
-			reason: "profile_not_found",
-			profileCount: data.profiles.length,
-		});
-		throw createProfileNotFoundError(profileId);
-	}
-
-	const snapshot = captureAgentSnapshots(agentOptions);
-	const updatedProfile: SavedProfile = {
-		id: profile.id,
-		name: profile.name,
-		agents: snapshot.agents,
-		createdAt: profile.createdAt,
-		updatedAt: new Date().toISOString(),
-	};
-	const updatedProfiles = [
-		...data.profiles.slice(0, profileIndex),
-		updatedProfile,
-		...data.profiles.slice(profileIndex + 1),
-	];
-
-	return {
-		updatedData: {
-			version: data.version,
-			importedAt: data.importedAt,
-			profiles: updatedProfiles,
-		},
-		updatedProfile,
-		previousProfile: profile,
-		result: {
-			updatedProfileId: profile.id,
-			updatedProfileName: profile.name,
-			updatedAgents: snapshot.agents.length,
-			warnings: snapshot.warnings,
-		},
-	};
-}
-
-function logProfileUpdated(plan: ProfileUpdatePlan): void {
-	multiProfilesDebugLogger.log("profile-update", {
-		event: "profile_updated",
-		profileId: plan.updatedProfile.id,
-		profileName: plan.updatedProfile.name,
-		beforeAgentCount: plan.previousProfile.agents.length,
-		afterAgentCount: plan.updatedProfile.agents.length,
-		warnings: plan.result.warnings,
-	});
-}
-
-/**
- * Update a profile with the current agent state.
- *
- * Captures the current agent snapshots and replaces the profile's agents array.
- * Preserves profile.id, profile.name, and profile.createdAt.
- * Updates profile.updatedAt timestamp to current time.
- * Logs update event with before/after agent counts via debug logger.
- *
- * @param data - The profiles file data
- * @param profileId - The ID of the profile to update
- * @param agentOptions - Options for capturing agent snapshots
- * @returns ProfileUpdateResult with updated profile info and agent counts
- * @throws ModelProfilesError with code PROFILE_NOT_FOUND if profile doesn't exist
- */
-export function updateProfile(
-	data: ProfilesFile,
-	profileId: string,
-	agentOptions: AgentSelectionOptions,
-): ProfileUpdateResult {
-	const plan = buildUpdatePlan(data, profileId, agentOptions);
-	logProfileUpdated(plan);
-	return plan.result;
-}
-
-/**
- * Update a profile and return the updated profiles file with update metadata.
- *
- * @param data - The profiles file data
- * @param profileId - The ID of the profile to update
- * @param agentOptions - Options for capturing agent snapshots
- * @returns New ProfilesFile with the profile updated and update metadata
- * @throws ModelProfilesError with code PROFILE_NOT_FOUND if profile doesn't exist
- */
-export function updateProfileAndReturn(
-	data: ProfilesFile,
-	profileId: string,
-	agentOptions: AgentSelectionOptions,
-): ProfileUpdateDataResult {
-	const plan = buildUpdatePlan(data, profileId, agentOptions);
-	logProfileUpdated(plan);
-	return {
-		data: plan.updatedData,
-		result: plan.result,
-	};
-}
+import { multiProfilesDebugLogger } from "./debug-logger.js";
+import { ModelProfilesError } from "./errors.js";
+import { captureAgentSnapshots, type AgentSelectionOptions } from "./agent-writer.js";
+import type { ProfilesFile, ProfileUpdateResult, SavedProfile } from "./types.js";
+
+/**
+ * Error code for profile not found during update.
+ */
+export const PROFILE_NOT_FOUND_CODE = "PROFILE_NOT_FOUND";
+
+export interface ProfileUpdateDataResult {
+	data: ProfilesFile;
+	result: ProfileUpdateResult;
+}
+
+interface ProfileUpdatePlan {
+	updatedData: ProfilesFile;
+	updatedProfile: SavedProfile;
+	previousProfile: SavedProfile;
+	result: ProfileUpdateResult;
+}
+
+function createProfileNotFoundError(profileId: string): ModelProfilesError {
+	return new ModelProfilesError(
+		`Profile '${profileId}' not found. It may have been removed already.`,
+		PROFILE_NOT_FOUND_CODE,
+	);
+}
+
+function buildUpdatePlan(
+	data: ProfilesFile,
+	profileId: string,
+	agentOptions: AgentSelectionOptions,
+): ProfileUpdatePlan {
+	const profileIndex = data.profiles.findIndex((profile) => profile.id === profileId);
+	const profile = data.profiles[profileIndex];
+
+	if (profileIndex === -1 || !profile) {
+		multiProfilesDebugLogger.log("profile-update", {
+			event: "update_failed",
+			profileId,
+			reason: "profile_not_found",
+			profileCount: data.profiles.length,
+		});
+		throw createProfileNotFoundError(profileId);
+	}
+
+	const snapshot = captureAgentSnapshots(agentOptions);
+	const updatedProfile: SavedProfile = {
+		id: profile.id,
+		name: profile.name,
+		agents: snapshot.agents,
+		createdAt: profile.createdAt,
+		updatedAt: new Date().toISOString(),
+	};
+	const updatedProfiles = [
+		...data.profiles.slice(0, profileIndex),
+		updatedProfile,
+		...data.profiles.slice(profileIndex + 1),
+	];
+
+	return {
+		updatedData: {
+			version: data.version,
+			importedAt: data.importedAt,
+			profiles: updatedProfiles,
+		},
+		updatedProfile,
+		previousProfile: profile,
+		result: {
+			updatedProfileId: profile.id,
+			updatedProfileName: profile.name,
+			updatedAgents: snapshot.agents.length,
+			warnings: snapshot.warnings,
+		},
+	};
+}
+
+function logProfileUpdated(plan: ProfileUpdatePlan): void {
+	multiProfilesDebugLogger.log("profile-update", {
+		event: "profile_updated",
+		profileId: plan.updatedProfile.id,
+		profileName: plan.updatedProfile.name,
+		beforeAgentCount: plan.previousProfile.agents.length,
+		afterAgentCount: plan.updatedProfile.agents.length,
+		warnings: plan.result.warnings,
+	});
+}
+
+/**
+ * Update a profile with the current agent state.
+ *
+ * Captures the current agent snapshots and replaces the profile's agents array.
+ * Preserves profile.id, profile.name, and profile.createdAt.
+ * Updates profile.updatedAt timestamp to current time.
+ * Logs update event with before/after agent counts via debug logger.
+ *
+ * @param data - The profiles file data
+ * @param profileId - The ID of the profile to update
+ * @param agentOptions - Options for capturing agent snapshots
+ * @returns ProfileUpdateResult with updated profile info and agent counts
+ * @throws ModelProfilesError with code PROFILE_NOT_FOUND if profile doesn't exist
+ */
+export function updateProfile(
+	data: ProfilesFile,
+	profileId: string,
+	agentOptions: AgentSelectionOptions,
+): ProfileUpdateResult {
+	const plan = buildUpdatePlan(data, profileId, agentOptions);
+	logProfileUpdated(plan);
+	return plan.result;
+}
+
+/**
+ * Update a profile and return the updated profiles file with update metadata.
+ *
+ * @param data - The profiles file data
+ * @param profileId - The ID of the profile to update
+ * @param agentOptions - Options for capturing agent snapshots
+ * @returns New ProfilesFile with the profile updated and update metadata
+ * @throws ModelProfilesError with code PROFILE_NOT_FOUND if profile doesn't exist
+ */
+export function updateProfileAndReturn(
+	data: ProfilesFile,
+	profileId: string,
+	agentOptions: AgentSelectionOptions,
+): ProfileUpdateDataResult {
+	const plan = buildUpdatePlan(data, profileId, agentOptions);
+	logProfileUpdated(plan);
+	return {
+		data: plan.updatedData,
+		result: plan.result,
+	};
+}