@hieplp/pi-account-switcher 0.2.0 → 0.2.2

package/src/commands/models/shared/base.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountSwitcher } from "@/runtime";
 import type { AccountSwitcherContext, ProviderConfig } from "@/types";
 import { BaseCommand, type CommandMeta } from "../../base";

package/src/commands/models/shared/prompts.ts

@@ -1,4 +1,4 @@
-import type { ExtensionUIContext } from "@mariozechner/pi-coding-agent";
+import type { ExtensionUIContext } from "@earendil-works/pi-coding-agent";
 import type { ProviderModelConfig } from "@/types";
 import { uiUtil } from "@/utils";
 

package/src/commands/models/shared/select.ts

@@ -1,4 +1,4 @@
-import type { Api, Model } from "@mariozechner/pi-ai";
+import type { Api, Model } from "@earendil-works/pi-ai";
 import type { ProviderConfig } from "@/types";
 import { providerUtil } from "@/utils";
 

package/src/commands/providers/add.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountSwitcher } from "@/runtime";
 import { COMMANDS } from "@/constants";
 import type { AccountSwitcherContext } from "@/types";

package/src/commands/providers/edit.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountSwitcher } from "@/runtime";
 import { COMMANDS } from "@/constants";
 import type { AccountSwitcherContext } from "@/types";

package/src/commands/providers/index.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountSwitcher } from "@/runtime";
 import { useAddProviderCommand } from "./add";
 import { useEditProviderCommand } from "./edit";

package/src/commands/providers/list.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountSwitcher } from "@/runtime";
 import { COMMANDS } from "@/constants";
 import { ProviderCommand } from "./shared";
@@ -18,7 +18,10 @@ class ListProvidersCommand extends ProviderCommand {
     try {
       const providers = await this.loadProviders(ctx);
       if (!providers) return;
-      await ctx.ui.select("Providers", providers.map((p) => this.format(p)));
+      await ctx.ui.select(
+        "Providers",
+        providers.map((p) => this.format(p)),
+      );
     } catch (e) {
       ctx.ui.notify(`Failed to list providers: ${errorUtil.format(e)}`, "error");
     }

package/src/commands/providers/remove.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountSwitcher } from "@/runtime";
 import { COMMANDS } from "@/constants";
 import type { AccountSwitcherContext } from "@/types";

package/src/commands/providers/shared/base.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountSwitcher } from "@/runtime";
 import type { AccountSwitcherContext, ProviderConfig } from "@/types";
 import { BaseCommand, type CommandMeta } from "../../base";

package/src/commands/providers/shared/prompts.ts

@@ -1,4 +1,4 @@
-import type { ExtensionUIContext } from "@mariozechner/pi-coding-agent";
+import type { ExtensionUIContext } from "@earendil-works/pi-coding-agent";
 import type { ProviderApi, ProviderConfig } from "@/types";
 import { PROVIDER_API_TYPES } from "@/constants";
 import { providerUtil, uiUtil } from "@/utils";

package/src/commands/providers/shared/select.ts

@@ -1,4 +1,4 @@
-import type { ExtensionUIContext } from "@mariozechner/pi-coding-agent";
+import type { ExtensionUIContext } from "@earendil-works/pi-coding-agent";
 import type { ProviderConfig } from "@/types";
 
 export async function selectProvider(

package/src/commands/system/export.ts

@@ -0,0 +1,51 @@
+import { readFile } from "node:fs/promises";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { AccountSwitcher } from "@/runtime";
+import { COMMANDS, DEFAULT_EXPORT_PATH, STATE_PATH } from "@/constants";
+import type { AccountSwitcherContext } from "@/types";
+import { BaseCommand } from "../base";
+import { errorUtil, fileUtil } from "@/utils";
+
+export const useExportCommand = (pi: ExtensionAPI, runtime: AccountSwitcher) => {
+  new ExportCommand(pi, runtime).register();
+};
+
+class ExportCommand extends BaseCommand {
+  constructor(pi: ExtensionAPI, runtime: AccountSwitcher) {
+    super(pi, runtime, COMMANDS.system.export);
+  }
+
+  async handler(ctx: AccountSwitcherContext, args?: string): Promise<void> {
+    try {
+      const target = args?.trim() || (await ctx.ui.input("Export file (blank for default)", DEFAULT_EXPORT_PATH));
+      if (target === undefined) {
+        ctx.ui.notify("Export cancelled.", "info");
+        return;
+      }
+
+      const state = await loadState();
+      const exportData = {
+        version: 1,
+        exportedAt: new Date().toISOString(),
+        accounts: this.runtime.getAccounts(),
+        providers: this.runtime.getProviders(),
+        state,
+      };
+
+      const path = fileUtil.expandHome(target.trim() || DEFAULT_EXPORT_PATH);
+      await fileUtil.writePrivateJson(path, exportData);
+      ctx.ui.notify(`Exported account switcher data to ${path}.`, "info");
+    } catch (e) {
+      ctx.ui.notify(`Failed to export: ${errorUtil.format(e)}`, "error");
+    }
+  }
+}
+
+async function loadState(): Promise<unknown> {
+  try {
+    return JSON.parse(await readFile(STATE_PATH, "utf8"));
+  } catch (error) {
+    if (fileUtil.isMissingFileError(error)) return {};
+    throw error;
+  }
+}

package/src/commands/system/import.ts

@@ -0,0 +1,102 @@
+import { readFile } from "node:fs/promises";
+import z from "zod";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import type { AccountSwitcher } from "@/runtime";
+import { ACCOUNTS_PATH, COMMANDS, DEFAULT_EXPORT_PATH, PROVIDERS_PATH, STATE_PATH } from "@/constants";
+import { accountSchema, providerSchema } from "@/schemas";
+import type { AccountConfig, AccountSwitcherContext, ProviderConfig } from "@/types";
+import { BaseCommand } from "../base";
+import { errorUtil, fileUtil, uiUtil } from "@/utils";
+
+const importStateSchema = z
+  .object({
+    activeAccountId: z.string().optional(),
+    activeModelId: z.string().optional(),
+    activeModelProvider: z.string().optional(),
+  })
+  .default({});
+
+const exportBundleSchema = z.object({
+  version: z.number().optional(),
+  accounts: z.array(accountSchema).default([]),
+  providers: z.array(providerSchema.extend({ id: z.string().min(1) })).default([]),
+  state: importStateSchema,
+});
+
+type ImportBundle = {
+  accounts: AccountConfig[];
+  providers: ProviderConfig[];
+  state: z.infer<typeof importStateSchema>;
+};
+
+export const useImportCommand = (pi: ExtensionAPI, runtime: AccountSwitcher) => {
+  new ImportCommand(pi, runtime).register();
+};
+
+class ImportCommand extends BaseCommand {
+  constructor(pi: ExtensionAPI, runtime: AccountSwitcher) {
+    super(pi, runtime, COMMANDS.system.import);
+  }
+
+  async handler(ctx: AccountSwitcherContext, args?: string): Promise<void> {
+    try {
+      const source = args?.trim() || (await ctx.ui.input("Import file (blank for default)", DEFAULT_EXPORT_PATH));
+      if (source === undefined) {
+        ctx.ui.notify("Import cancelled.", "info");
+        return;
+      }
+
+      const path = fileUtil.expandHome(source.trim() || DEFAULT_EXPORT_PATH);
+      const bundle = parseImportBundle(JSON.parse(await readFile(path, "utf8")));
+
+      const confirmed = await ctx.ui.confirm(
+        "Import account switcher data?",
+        `This will replace all existing accounts, providers, and state with data from ${path}.`,
+      );
+      if (!confirmed) {
+        ctx.ui.notify("Import cancelled.", "info");
+        return;
+      }
+
+      await fileUtil.writePrivateJson(ACCOUNTS_PATH, { accounts: bundle.accounts });
+      await fileUtil.writePrivateJson(PROVIDERS_PATH, { providers: bundle.providers });
+      await fileUtil.writePrivateJson(STATE_PATH, bundle.state);
+
+      await this.runtime.load();
+      await this.runtime.init(ctx);
+      uiUtil.setAccountStatus(ctx.ui, this.runtime.getActiveAccount()?.label);
+
+      ctx.ui.notify(
+        `Imported ${bundle.accounts.length} accounts and ${bundle.providers.length} providers from ${path}.`,
+        "info",
+      );
+    } catch (e) {
+      ctx.ui.notify(`Failed to import: ${errorUtil.format(e)}`, "error");
+    }
+  }
+}
+
+function parseImportBundle(raw: unknown): ImportBundle {
+  const parsed = exportBundleSchema.parse(raw);
+  assertNoDuplicateIds(
+    "account",
+    parsed.accounts.map((account) => account.id),
+  );
+  assertNoDuplicateIds(
+    "provider",
+    parsed.providers.map((provider) => provider.id),
+  );
+  return parsed;
+}
+
+function assertNoDuplicateIds(kind: string, ids: string[]): void {
+  const seen = new Set<string>();
+  const duplicates = new Set<string>();
+  for (const id of ids) {
+    if (seen.has(id)) duplicates.add(id);
+    else seen.add(id);
+  }
+  if (duplicates.size > 0) {
+    throw new Error(`Duplicate ${kind} ids: ${Array.from(duplicates).sort().join(", ")}`);
+  }
+}

package/src/commands/system/index.ts

@@ -1,7 +1,11 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountSwitcher } from "@/runtime";
+import { useExportCommand } from "./export";
+import { useImportCommand } from "./import";
 import { useResetCommand } from "./reset";
 
 export default function useSystemCommands(pi: ExtensionAPI, runtime: AccountSwitcher) {
   useResetCommand(pi, runtime);
+  useExportCommand(pi, runtime);
+  useImportCommand(pi, runtime);
 }

package/src/commands/system/reset.ts

@@ -1,5 +1,5 @@
 import { rm } from "node:fs/promises";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountSwitcher } from "@/runtime";
 import { ACCOUNTS_PATH, COMMANDS, PROVIDERS_PATH, STATE_PATH } from "@/constants";
 import type { AccountSwitcherContext } from "@/types";

package/src/constants/commands.ts

@@ -24,6 +24,11 @@ export const COMMANDS = {
       name: "accounts:oauth",
       description: "Import Pi /login OAuth credentials as a switchable account",
     },
+    verify: {
+      name: "accounts:verify",
+      description:
+        "Verify secrets for one or all accounts without activating them (pass 'all'; add 'ping' to send a test request)",
+    },
   },
   providers: {
     add: {
@@ -62,5 +67,13 @@ export const COMMANDS = {
       name: "system:reset",
       description: "Reset all extension data (accounts, providers, state) to factory defaults",
     },
+    export: {
+      name: "system:export",
+      description: "Export all extension data (accounts, providers, state) to a JSON file",
+    },
+    import: {
+      name: "system:import",
+      description: "Import extension data (accounts, providers, state) from a JSON file",
+    },
   },
 } as const;

package/src/constants/env.ts

@@ -0,0 +1 @@
+export const COMMAND_PREFIX_ENV = "PI_ACCOUNT_SWITCHER_COMMAND_PREFIX";

package/src/constants/index.ts

@@ -1,4 +1,5 @@
 export * from "./commands";
 export * from "./config";
+export * from "./env";
 export * from "./paths";
 export * from "./providers";

package/src/constants/paths.ts

@@ -5,4 +5,5 @@ export const APP_DIR = join(homedir(), ".pi", "account-switcher");
 export const ACCOUNTS_PATH = join(APP_DIR, "accounts.json");
 export const PROVIDERS_PATH = join(APP_DIR, "providers.json");
 export const STATE_PATH = join(APP_DIR, "state.json");
-export const PI_AUTH_PATH = join(homedir(), ".pi", "agent", "auth.json");
+export const PI_AUTH_PATH = join(homedir(), ".pi", "agent", "auth.json");
+export const DEFAULT_EXPORT_PATH = "~/pi-account-switcher-export.json";

package/src/extension.ts

@@ -1,5 +1,5 @@
 import { createJiti } from "@mariozechner/jiti";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 
@@ -11,9 +11,7 @@ export default async function accountSwitcherBootstrap(pi: ExtensionAPI) {
     },
   });
 
-  const extension = await jiti.import<
-    (pi: ExtensionAPI) => void | Promise<void>
-  >("./index", {
+  const extension = await jiti.import<(pi: ExtensionAPI) => void | Promise<void>>("./index", {
     default: true,
   });
 

package/src/index.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountSwitcherContext } from "@/types";
 import { useAccountSwitcher, type AccountSwitcher } from "./runtime";
 import { registerAllCommands } from "./commands";

package/src/runtime/account-switcher-runtime.ts

@@ -1,7 +1,7 @@
 import AccountSwitcher from "./account-switcher";
 import { ACCOUNTS_PATH, PROVIDERS_PATH, STATE_PATH } from "@/constants";
-import type { Api, Model } from "@mariozechner/pi-ai";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountConfig, AccountSwitcherContext, PiAuthEntry, ProviderConfig } from "@/types";
 import type { AccountService, ModelService, PiAuthService, ProviderService } from "@/services";
 import { useAccountService, useModelService, usePiAuthService, useProviderService } from "@/services";
@@ -174,6 +174,10 @@ export default class AccountSwitcherRuntime implements AccountSwitcher {
     return this.providerService.getProviders();
   }
 
+  registerProvider(provider: ProviderConfig): void {
+    this.providerService.registerProvider(provider);
+  }
+
   async addProvider(provider: ProviderConfig): Promise<void> {
     return this.providerService.addProvider(provider);
   }

package/src/runtime/account-switcher.ts

@@ -1,4 +1,4 @@
-import type { Api, Model } from "@mariozechner/pi-ai";
+import type { Api, Model } from "@earendil-works/pi-ai";
 import type { AccountConfig, AccountSwitcherContext, PiAuthEntry, ProviderConfig } from "@/types";
 
 export default interface AccountSwitcher {
@@ -26,6 +26,7 @@ export default interface AccountSwitcher {
 
   // Provider
   getProviders(): ProviderConfig[];
+  registerProvider(provider: ProviderConfig): void;
   addProvider(config: ProviderConfig): Promise<void>;
   editProvider(original: ProviderConfig, updated: ProviderConfig): Promise<void>;
   removeProvider(provider: ProviderConfig): Promise<void>;

package/src/runtime/index.ts

@@ -1,10 +1,8 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type AccountSwitcher from "./account-switcher";
 import AccountSwitcherRuntime from "./account-switcher-runtime";
 
-function useAccountSwitcher(
-  pi: Pick<ExtensionAPI, "registerProvider" | "setModel">,
-): AccountSwitcher {
+function useAccountSwitcher(pi: Pick<ExtensionAPI, "registerProvider" | "setModel">): AccountSwitcher {
   return new AccountSwitcherRuntime(pi);
 }
 

package/src/schemas/accounts.ts

@@ -44,7 +44,6 @@ export const accountSchema = z
       account.usesProviderApiKey ||
       account.piAuth,
     {
-      message:
-        "Account must define env credentials, providerApiKey, provider apiKey, or piAuth credentials",
+      message: "Account must define env credentials, providerApiKey, provider apiKey, or piAuth credentials",
     },
   );

package/src/schemas/providers.ts

@@ -20,9 +20,7 @@ export const providerModelSchema = z
       })
       .optional(),
     compat: jsonRecordSchema.optional(),
-    thinkingLevelMap: z
-      .record(z.string(), z.union([z.string(), z.null()]))
-      .optional(),
+    thinkingLevelMap: z.record(z.string(), z.union([z.string(), z.null()])).optional(),
     headers: z.record(z.string(), z.string()).optional(),
   })
   .passthrough();
@@ -42,9 +40,7 @@ export const providerSchema = z
     authHeader: z.boolean().optional(),
     compat: jsonRecordSchema.optional(),
     models: z.array(providerModelSchema).optional(),
-    modelOverrides: z
-      .record(z.string(), providerModelSchema.partial())
-      .optional(),
+    modelOverrides: z.record(z.string(), providerModelSchema.partial()).optional(),
   })
   .passthrough();
 

package/src/services/models.ts

@@ -1,5 +1,5 @@
-import type { Api, Model } from "@mariozechner/pi-ai";
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { Api, Model } from "@earendil-works/pi-ai";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import type { AccountSwitcherContext } from "@/types";
 
 type ProviderModel = Model<Api>;

package/src/services/providers.ts

@@ -1,4 +1,4 @@
-import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { type ProviderStore, useProviderStore } from "@/storage";
 import type { ProviderConfig, ProviderModelConfig } from "@/types";
 import { commonUtil } from "@/utils";
@@ -72,10 +72,7 @@ class ProviderServiceImpl implements ProviderService {
   registerProvider(provider: ProviderConfig): void {
     const config = this.toPiProvider(provider);
     if (!config) return;
-    this.pi.registerProvider(
-      provider.id,
-      config as Parameters<ExtensionAPI["registerProvider"]>[1],
-    );
+    this.pi.registerProvider(provider.id, config as Parameters<ExtensionAPI["registerProvider"]>[1]);
   }
 
   private toPiProvider(provider: ProviderConfig): Record<string, unknown> | undefined {
@@ -104,10 +101,7 @@ class ProviderServiceImpl implements ProviderService {
     });
   }
 
-  private toPiModel(
-    provider: ProviderConfig,
-    model: ProviderModelConfig,
-  ): Record<string, unknown> | undefined {
+  private toPiModel(provider: ProviderConfig, model: ProviderModelConfig): Record<string, unknown> | undefined {
     return commonUtil.omitUndefined({
       ...model,
       api: model.api ?? provider.api,

package/src/types/context.ts

@@ -1,3 +1,3 @@
-import type { ExtensionCommandContext } from "@mariozechner/pi-coding-agent";
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
 
 export type AccountSwitcherContext = ExtensionCommandContext;

package/src/types/index.ts

@@ -1,4 +1,4 @@
 export * from "./config";
 export * from "./accounts";
 export * from "./providers";
-export * from "./context";
+export * from "./context";

package/src/utils/accounts.ts

@@ -1,6 +1,6 @@
-import * as piAi from "@mariozechner/pi-ai";
+import * as piAi from "@earendil-works/pi-ai";
 import { readFile } from "node:fs/promises";
-import type { ModelRegistry } from "@mariozechner/pi-coding-agent";
+import type { ModelRegistry } from "@earendil-works/pi-coding-agent";
 import type { AccountConfig, SecretSource } from "@/types";
 import { commonUtil } from "./common";
 import { fileUtil } from "./files";

package/src/utils/commands.ts

@@ -0,0 +1,10 @@
+import { COMMAND_PREFIX_ENV } from "@/constants";
+
+export const commandUtil = {
+  name: (name: string): string => {
+    const prefix = process.env[COMMAND_PREFIX_ENV]?.trim();
+    if (!prefix) return name;
+
+    return `${prefix.endsWith(":") ? prefix : `${prefix}:`}${name}`;
+  },
+};

package/src/utils/common.ts

@@ -71,4 +71,19 @@ export const commonUtil = {
     });
     return stdout.trim();
   },
+
+  runWithConcurrency: async <T, R>(items: T[], concurrency: number, worker: (item: T) => Promise<R>): Promise<R[]> => {
+    const results = new Array<R>(items.length);
+    let nextIndex = 0;
+
+    const runNext = async (): Promise<void> => {
+      const index = nextIndex++;
+      if (index >= items.length) return;
+      results[index] = await worker(items[index]);
+      await runNext();
+    };
+
+    await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, runNext));
+    return results;
+  },
 };

package/src/utils/errors.ts

@@ -3,9 +3,7 @@ import z from "zod";
 export const errorUtil = {
   format: (error: unknown): string => {
     if (error instanceof z.ZodError) {
-      return error.issues
-        .map((issue) => `${errorUtil.formatPath(issue.path)}: ${issue.message}`)
-        .join("; ");
+      return error.issues.map((issue) => `${errorUtil.formatPath(issue.path)}: ${issue.message}`).join("; ");
     }
     return error instanceof Error ? error.message : String(error);
   },

package/src/utils/filterable-selector.ts

@@ -1,9 +1,114 @@
-import { DynamicBorder } from "@mariozechner/pi-coding-agent";
-import { Container, fuzzyFilter, getKeybindings, Input, Spacer, Text, type Focusable } from "@mariozechner/pi-tui";
-import type { ThemeColor } from "@mariozechner/pi-coding-agent";
+import { DynamicBorder } from "@earendil-works/pi-coding-agent";
+import { Container, fuzzyFilter, getKeybindings, Input, Spacer, Text, type Focusable } from "@earendil-works/pi-tui";
+import type { ThemeColor } from "@earendil-works/pi-coding-agent";
 
 type Theme = { fg: (color: ThemeColor, text: string) => string; bold: (text: string) => string };
 
+export class FilterableMultiSelectComponent extends Container implements Focusable {
+  private readonly listContainer: Container;
+  private readonly theme: Theme;
+  private selectedIndex = 0;
+  private checked: boolean[];
+
+  _focused = false;
+  get focused() {
+    return this._focused;
+  }
+  set focused(value: boolean) {
+    this._focused = value;
+  }
+
+  constructor(
+    title: string,
+    private readonly options: string[],
+    initialChecked: boolean[],
+    private readonly onDone: (selected: string[] | undefined) => void,
+    theme: Theme,
+    private readonly disabled: boolean[] = [],
+  ) {
+    super();
+    this.theme = theme;
+    this.checked = options.map((_, i) => !this.disabled[i] && (initialChecked[i] ?? false));
+    this.selectedIndex = Math.max(
+      0,
+      this.disabled.findIndex((value) => !value),
+    );
+
+    const borderColor = (str: string) => theme.fg("border", str);
+    this.addChild(new DynamicBorder(borderColor));
+    this.addChild(new Spacer(1));
+    this.addChild(new Text(theme.fg("accent", theme.bold(title)), 1, 0));
+    this.addChild(new Spacer(1));
+
+    this.listContainer = new Container();
+    this.addChild(this.listContainer);
+    this.addChild(new Spacer(1));
+
+    const hint = (key: string, desc: string) => theme.fg("dim", key) + theme.fg("muted", ` ${desc}`);
+    this.addChild(
+      new Text(
+        hint("↑↓", "navigate") +
+          "  " +
+          hint("Space", "toggle") +
+          "  " +
+          hint("Enter", "run") +
+          "  " +
+          hint("Esc", "cancel"),
+        1,
+        0,
+      ),
+    );
+    this.addChild(new Spacer(1));
+    this.addChild(new DynamicBorder(borderColor));
+
+    this.updateList();
+  }
+
+  handleInput(keyData: string) {
+    const kb = getKeybindings();
+    if (kb.matches(keyData, "tui.select.up")) {
+      this.moveSelection(-1);
+    } else if (kb.matches(keyData, "tui.select.down")) {
+      this.moveSelection(1);
+    } else if (keyData === " ") {
+      this.toggleSelected();
+    } else if (kb.matches(keyData, "tui.select.confirm")) {
+      this.onDone(this.options.filter((_, i) => this.checked[i] && !this.disabled[i]));
+    } else if (kb.matches(keyData, "tui.select.cancel")) {
+      this.onDone(undefined);
+    }
+  }
+
+  private moveSelection(delta: number) {
+    if (this.options.length === 0) return;
+    for (let step = 0; step < this.options.length; step++) {
+      this.selectedIndex = (this.selectedIndex + delta + this.options.length) % this.options.length;
+      if (!this.disabled[this.selectedIndex]) break;
+    }
+    this.updateList();
+  }
+
+  private toggleSelected() {
+    if (this.disabled[this.selectedIndex]) return;
+    this.checked[this.selectedIndex] = !this.checked[this.selectedIndex];
+    this.updateList();
+  }
+
+  private updateList() {
+    this.listContainer.clear();
+    for (let i = 0; i < this.options.length; i++) {
+      const isSelected = i === this.selectedIndex;
+      if (this.disabled[i]) {
+        this.listContainer.addChild(new Text(this.theme.fg("muted", `  ${this.options[i]}`), 0, 0));
+        continue;
+      }
+      const marker = this.checked[i] ? "[x]" : "[ ]";
+      const line = `${isSelected ? "›" : " "} ${marker} ${this.options[i]}`;
+      this.listContainer.addChild(new Text(isSelected ? this.theme.fg("accent", line) : line, 0, 0));
+    }
+  }
+}
+
 export class FilterableExtensionSelectorComponent extends Container implements Focusable {
   private readonly searchInput: Input;
   private readonly listContainer: Container;

package/src/utils/index.ts

@@ -1,6 +1,7 @@
 export * from "./files";
 export * from "./errors";
 export * from "./common";
+export * from "./commands";
 export * from "./models";
 export * from "./providers";
 export * from "./ui";