anypick 1.0.0

package/dist/cli/launch-client.js

@@ -0,0 +1,117 @@
+import { ExitCode } from "../utils/errors.js";
+//#region src/cli/launch-client.ts
+function clientBinary(app, clientId) {
+	if (!app.clients.has(clientId)) return clientId;
+	const client = app.clients.get(clientId);
+	if (client.binaryEnvVar) {
+		const fromEnv = process.env[client.binaryEnvVar];
+		if (fromEnv && fromEnv.length > 0) return fromEnv;
+	}
+	return client.binaryName ?? clientId;
+}
+function publicTransport(transport) {
+	const { managedProxy, ...rest } = transport;
+	return {
+		...rest,
+		...managedProxy ? { managedProxy: {
+			provider: managedProxy.provider,
+			...managedProxy.account ? { account: managedProxy.account } : {},
+			port: managedProxy.port
+		} } : {}
+	};
+}
+/**
+* Prepare ephemeral runtime and spawn the client binary.
+* Returns the process exit code (does not call process.exit).
+*/
+async function launchClient(app, client, opts = {}) {
+	const result = await app.bindingService.runPrepare(client, {
+		with: opts.with,
+		model: opts.model,
+		dryRun: Boolean(opts.dryRun || opts.json),
+		verbose: opts.verbose,
+		childArgs: opts.childArgs
+	});
+	if (opts.json || opts.dryRun) {
+		if (opts.json) console.log(JSON.stringify({
+			client,
+			source: result.plan.resolvedSource.display,
+			transport: publicTransport(result.plan.transport),
+			dryRun: result.dryRun,
+			steps: result.plan.steps.map((s) => s.kind),
+			proxyEndpoint: result.proxyEndpoint
+		}));
+		else {
+			console.log("Dry run — ephemeral plan:");
+			for (const step of result.plan.steps) console.log(`  · ${step.kind}${step.detail ? ` — ${step.detail}` : ""}`);
+		}
+		return 0;
+	}
+	const bin = clientBinary(app, client);
+	const childArgs = [...result.isolated?.args ?? [], ...opts.childArgs ?? []];
+	const { spawn } = await import("node:child_process");
+	const env = {
+		...result.isolated ? Object.fromEntries(Object.entries(process.env).filter(([key]) => !/(?:API[_-]?KEY|ACCESS[_-]?TOKEN|REFRESH[_-]?TOKEN|SECRET|PASSWORD|CREDENTIAL|AWS_|GOOGLE_|AZURE_)/i.test(key))) : process.env,
+		...result.isolated?.environment
+	};
+	if (!result.isolated && result.proxyEndpoint) {
+		if (result.plan.transport.protocol === "anthropic") {
+			env.ANTHROPIC_BASE_URL = result.proxyEndpoint;
+			env.ANTHROPIC_AUTH_TOKEN = env.ANTHROPIC_AUTH_TOKEN ?? "anypick";
+		}
+	}
+	const cleanup = async () => {
+		if (result.cleanup) {
+			try {
+				await result.cleanup();
+			} catch {}
+			return;
+		}
+		if (result.isolated) try {
+			await result.isolated.cleanup();
+		} catch {}
+	};
+	let child;
+	try {
+		child = spawn(bin, childArgs, {
+			stdio: "inherit",
+			env,
+			shell: false
+		});
+	} catch {
+		await cleanup();
+		return ExitCode.MISSING_DEPENDENCY;
+	}
+	let childExited = false;
+	let forwardedSignals = 0;
+	const forward = (sig) => {
+		if (childExited) return;
+		forwardedSignals += 1;
+		child.kill(forwardedSignals > 1 ? "SIGKILL" : sig);
+	};
+	const onSigInt = () => forward("SIGINT");
+	const onSigTerm = () => forward("SIGTERM");
+	process.on("SIGINT", onSigInt);
+	process.on("SIGTERM", onSigTerm);
+	try {
+		return await new Promise((resolve) => {
+			child.once("exit", (c, signal) => {
+				childExited = true;
+				if (signal) resolve(128 + (signal === "SIGINT" ? 2 : 15));
+				else resolve(c ?? 1);
+			});
+			child.once("error", () => {
+				childExited = true;
+				resolve(ExitCode.MISSING_DEPENDENCY);
+			});
+		});
+	} finally {
+		process.off("SIGINT", onSigInt);
+		process.off("SIGTERM", onSigTerm);
+		await cleanup();
+	}
+}
+//#endregion
+export { launchClient };
+
+//# sourceMappingURL=launch-client.js.map

package/dist/cli/launch-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launch-client.js","names":[],"sources":["../../src/cli/launch-client.ts"],"sourcesContent":["/**\n * Shared client launch path used by `anypick run` and the root launcher.\n */\n\nimport type { AnyPickApp } from '../core/app';\nimport type { ResolvedTransport } from '../types';\nimport { ExitCode } from '../utils/errors';\n\nexport interface LaunchClientOpts {\n  with?: string;\n  model?: string;\n  dryRun?: boolean;\n  verbose?: boolean;\n  json?: boolean;\n  childArgs?: string[];\n}\n\nfunction clientBinary(app: AnyPickApp, clientId: string): string {\n  if (!app.clients.has(clientId)) {\n    return clientId;\n  }\n  const client = app.clients.get(clientId);\n  if (client.binaryEnvVar) {\n    const fromEnv = process.env[client.binaryEnvVar];\n    if (fromEnv && fromEnv.length > 0) {\n      return fromEnv;\n    }\n  }\n  return client.binaryName ?? clientId;\n}\n\nfunction publicTransport(transport: ResolvedTransport): Record<string, unknown> {\n  const { managedProxy, ...rest } = transport;\n  return {\n    ...rest,\n    ...(managedProxy\n      ? {\n          managedProxy: {\n            provider: managedProxy.provider,\n            ...(managedProxy.account ? { account: managedProxy.account } : {}),\n            port: managedProxy.port,\n          },\n        }\n      : {}),\n  };\n}\n\n/**\n * Prepare ephemeral runtime and spawn the client binary.\n * Returns the process exit code (does not call process.exit).\n */\nexport async function launchClient(\n  app: AnyPickApp,\n  client: string,\n  opts: LaunchClientOpts = {},\n): Promise<number> {\n  const result = await app.bindingService.runPrepare(client, {\n    with: opts.with,\n    model: opts.model,\n    // JSON is a machine-readable plan contract. Never perform activation,\n    // spawn a proxy, or create a secret-bearing temporary home merely because\n    // a caller asked for serialized output.\n    dryRun: Boolean(opts.dryRun || opts.json),\n    verbose: opts.verbose,\n    childArgs: opts.childArgs,\n  });\n\n  if (opts.json || opts.dryRun) {\n    if (opts.json) {\n      console.log(\n        JSON.stringify({\n          client,\n          source: result.plan.resolvedSource.display,\n          transport: publicTransport(result.plan.transport),\n          dryRun: result.dryRun,\n          steps: result.plan.steps.map((s) => s.kind),\n          proxyEndpoint: result.proxyEndpoint,\n        }),\n      );\n    } else {\n      console.log('Dry run — ephemeral plan:');\n      for (const step of result.plan.steps) {\n        console.log(`  · ${step.kind}${step.detail ? ` — ${step.detail}` : ''}`);\n      }\n    }\n    return 0;\n  }\n\n  const bin = clientBinary(app, client);\n  const childArgs = [...(result.isolated?.args ?? []), ...(opts.childArgs ?? [])];\n  const { spawn } = await import('node:child_process');\n  const inherited = result.isolated\n    ? Object.fromEntries(\n        Object.entries(process.env).filter(\n          ([key]) =>\n            !/(?:API[_-]?KEY|ACCESS[_-]?TOKEN|REFRESH[_-]?TOKEN|SECRET|PASSWORD|CREDENTIAL|AWS_|GOOGLE_|AZURE_)/i.test(\n              key,\n            ),\n        ),\n      )\n    : process.env;\n  const env: NodeJS.ProcessEnv = {\n    ...inherited,\n    ...result.isolated?.environment,\n  };\n  // When the ephemeral plan did not materialize an isolated home, still point\n  // Anthropic-protocol clients at the managed proxy endpoint via env.\n  if (!result.isolated && result.proxyEndpoint) {\n    const protocol = result.plan.transport.protocol;\n    if (protocol === 'anthropic') {\n      env.ANTHROPIC_BASE_URL = result.proxyEndpoint;\n      env.ANTHROPIC_AUTH_TOKEN = env.ANTHROPIC_AUTH_TOKEN ?? 'anypick';\n    }\n  }\n\n  const cleanup = async () => {\n    if (result.cleanup) {\n      try {\n        await result.cleanup();\n      } catch {\n        // best-effort\n      }\n      return;\n    }\n    if (result.isolated) {\n      try {\n        await result.isolated.cleanup();\n      } catch {\n        // best-effort\n      }\n    }\n  };\n\n  let child: import('node:child_process').ChildProcess;\n  try {\n    child = spawn(bin, childArgs, {\n      stdio: 'inherit',\n      env,\n      shell: false,\n    });\n  } catch {\n    await cleanup();\n    return ExitCode.MISSING_DEPENDENCY;\n  }\n\n  let childExited = false;\n  let forwardedSignals = 0;\n  const forward = (sig: NodeJS.Signals) => {\n    if (childExited) {\n      return;\n    }\n    forwardedSignals += 1;\n    // A second interrupt is an explicit escalation request. `child.killed`\n    // only means a signal was sent, not that the process has exited.\n    child.kill(forwardedSignals > 1 ? 'SIGKILL' : sig);\n  };\n  const onSigInt = () => forward('SIGINT');\n  const onSigTerm = () => forward('SIGTERM');\n  process.on('SIGINT', onSigInt);\n  process.on('SIGTERM', onSigTerm);\n\n  try {\n    const code: number = await new Promise((resolve) => {\n      child.once('exit', (c, signal) => {\n        childExited = true;\n        if (signal) {\n          resolve(128 + (signal === 'SIGINT' ? 2 : 15));\n        } else {\n          resolve(c ?? 1);\n        }\n      });\n      child.once('error', () => {\n        childExited = true;\n        resolve(ExitCode.MISSING_DEPENDENCY);\n      });\n    });\n    return code;\n  } finally {\n    process.off('SIGINT', onSigInt);\n    process.off('SIGTERM', onSigTerm);\n    await cleanup();\n  }\n}\n"],"mappings":"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"}

package/dist/cli/launcher-model.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Root launcher action model (spec §7 rev 2.5).
+ * Pure data — no I/O chrome. First paint uses local state only.
+ */
+import type { AnyPickApp } from '../core/app.js';
+import { shortClientName } from '../presentation/client-name.js';
+export { shortClientName };
+export type LauncherSection = 'attention' | 'run' | 'configure' | 'more' | 'get-started' | 'other';
+export type LauncherActionKind = 'run' | 'fix-attention' | 'change-default' | 'add-connection' | 'link' | 'view-details' | 'doctor' | 'connect-client' | 'add-account' | 'add-gateway';
+export interface LauncherAction {
+    /** Stable semantic id for selection restore across refresh. */
+    id: string;
+    kind: LauncherActionKind;
+    section: LauncherSection;
+    /** Primary label (e.g. "Claude"). */
+    label: string;
+    /** Middle column (source display). */
+    detail?: string;
+    /** Right column status (ready / token expired / …). */
+    status?: string;
+    /** Client id when applicable. */
+    clientId?: string;
+    /** Severity for attention items. */
+    severity?: 'error' | 'warn';
+    /** Footer hint when this row is focused. */
+    preview?: string;
+}
+export interface LauncherModel {
+    cwd: string;
+    cwdShort: string;
+    mode: 'ready' | 'empty' | 'degraded';
+    title: string;
+    subtitle: string;
+    actions: LauncherAction[];
+}
+export interface ClientRow {
+    clientId: string;
+    clientName: string;
+    shortName: string;
+    /** Effective source display, if any. */
+    source?: string;
+    /** Effective primary model when the binding pins one. */
+    model?: string;
+    /** Binding scope reported by the resolver (normally global on the launcher). */
+    scope?: string | null;
+    status: 'ready' | 'attention' | 'native' | 'unbound';
+    /** Identity reported by the matching native provider when no AnyPick route exists. */
+    nativeIdentity?: string;
+    attention?: string;
+}
+export declare function buildClientRows(app: AnyPickApp): Promise<ClientRow[]>;
+/**
+ * Matching account/client ids identify native auth without a client-specific
+ * branch. Native means "usable outside AnyPick", not "AnyPick route exists".
+ */
+export declare function nativeConnectionFor(app: AnyPickApp, clientId: string): Promise<{
+    identity?: string;
+} | null>;
+export declare function buildLauncherModel(app: AnyPickApp, opts?: {
+    cwd?: string;
+}): Promise<LauncherModel>;
+export declare const SECTION_LABELS: Record<LauncherSection, string>;
+export declare const SECTION_ORDER: LauncherSection[];
+//# sourceMappingURL=launcher-model.d.ts.map

package/dist/cli/launcher-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher-model.d.ts","sourceRoot":"","sources":["../../src/cli/launcher-model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC;AAEnG,MAAM,MAAM,kBAAkB,GAC1B,KAAK,GACL,eAAe,GACf,gBAAgB,GAChB,gBAAgB,GAChB,MAAM,GACN,cAAc,GACd,QAAQ,GACR,gBAAgB,GAChB,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,kBAAkB,CAAC;IACzB,OAAO,EAAE,eAAe,CAAC;IACzB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,UAAU,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,cAAc,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IACrD,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqBD,wBAAsB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAkE3E;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,UAAU,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAUvC;AAED,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,UAAU,EACf,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GAC1B,OAAO,CAAC,aAAa,CAAC,CAgIxB;AAED,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAO1D,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,eAAe,EAO1C,CAAC"}

package/dist/cli/launcher-model.js

@@ -0,0 +1,200 @@
+import { localAttentionFor } from "./local-health.js";
+import { shortCwd } from "./render-util.js";
+import { shortClientName } from "../presentation/client-name.js";
+//#region src/cli/launcher-model.ts
+function sourceDisplay(source) {
+	if (source.kind === "account" && source.provider && source.name) return `${source.provider}/${source.name}`;
+	if (source.kind === "gateway" && source.name) return source.name;
+	if (source.kind === "preset" && source.name) return `@${source.name}`;
+	if (source.kind === "account-pool" && source.provider) return `pool:${source.provider}`;
+	if (source.kind === "proxy-hub" && source.name) return `hub:${source.name}`;
+	return "?";
+}
+async function buildClientRows(app) {
+	const clients = app.clients.list();
+	return Promise.all(clients.map(async (c) => {
+		const shortName = shortClientName(c.id, c.name, c.shortName);
+		let effective;
+		try {
+			effective = app.bindingService.current(c.id)[0];
+		} catch {
+			effective = void 0;
+		}
+		const binding = effective?.binding;
+		if (!binding) {
+			const native = await nativeConnectionFor(app, c.id);
+			if (native) return {
+				clientId: c.id,
+				clientName: c.name,
+				shortName,
+				source: "native login",
+				status: "native",
+				nativeIdentity: native.identity
+			};
+			return {
+				clientId: c.id,
+				clientName: c.name,
+				shortName,
+				status: "unbound"
+			};
+		}
+		const src = binding.spec.source;
+		const display = sourceDisplay(src);
+		const model = binding.spec.model.mode === "explicit" ? binding.spec.model.id : typeof binding.spec.clientOptions.modelRoles === "object" && binding.spec.clientOptions.modelRoles && "default" in binding.spec.clientOptions.modelRoles && typeof binding.spec.clientOptions.modelRoles.default === "string" ? binding.spec.clientOptions.modelRoles.default : void 0;
+		const attention = await localAttentionFor(app, c.id, src);
+		if (attention) return {
+			clientId: c.id,
+			clientName: c.name,
+			shortName,
+			source: display,
+			model,
+			scope: effective?.scope,
+			status: "attention",
+			attention
+		};
+		return {
+			clientId: c.id,
+			clientName: c.name,
+			shortName,
+			source: display,
+			model,
+			scope: effective?.scope,
+			status: "ready"
+		};
+	}));
+}
+/**
+* Matching account/client ids identify native auth without a client-specific
+* branch. Native means "usable outside AnyPick", not "AnyPick route exists".
+*/
+async function nativeConnectionFor(app, clientId) {
+	if (!app.accountRegistry.has(clientId)) return null;
+	try {
+		const current = await app.accounts.current(clientId);
+		return current.live.present ? { identity: current.live.identity } : null;
+	} catch {
+		return null;
+	}
+}
+async function buildLauncherModel(app, opts = {}) {
+	const cwd = opts.cwd ?? process.cwd();
+	const clientRows = await buildClientRows(app);
+	const ready = clientRows.filter((r) => r.status === "ready");
+	const attention = clientRows.filter((r) => r.status === "attention");
+	const native = clientRows.filter((r) => r.status === "native");
+	const unbound = clientRows.filter((r) => r.status === "unbound" || r.status === "native");
+	const actions = [];
+	if (ready.length === 0 && attention.length === 0) {
+		for (const r of unbound) actions.push({
+			id: `connect:${r.clientId}`,
+			kind: "connect-client",
+			section: "get-started",
+			label: r.status === "native" ? `Connect ${r.shortName} to AnyPick` : `Connect ${r.shortName}`,
+			detail: r.status === "native" ? r.nativeIdentity ?? "native login active" : void 0,
+			clientId: r.clientId,
+			preview: `set ${r.clientId} source`
+		});
+		actions.push({
+			id: "other:add-account",
+			kind: "add-account",
+			section: "other",
+			label: "Add account",
+			preview: "save a native login"
+		}, {
+			id: "other:add-gateway",
+			kind: "add-gateway",
+			section: "other",
+			label: "Add gateway",
+			preview: "API endpoint + key"
+		});
+		return {
+			cwd,
+			cwdShort: shortCwd(cwd),
+			mode: "empty",
+			title: "anypick",
+			subtitle: native.length ? "Native clients found · no AnyPick routes yet" : "No clients connected yet",
+			actions
+		};
+	}
+	for (const r of attention) actions.push({
+		id: `attention:${r.clientId}`,
+		kind: "fix-attention",
+		section: "attention",
+		label: `Fix ${r.shortName}`,
+		detail: r.attention,
+		clientId: r.clientId,
+		severity: "error",
+		preview: `repair ${r.clientId}`
+	});
+	for (const r of ready) actions.push({
+		id: `run:${r.clientId}`,
+		kind: "run",
+		section: "run",
+		label: r.shortName,
+		detail: r.source,
+		status: "ready",
+		clientId: r.clientId,
+		preview: `anypick run ${r.clientId}`
+	});
+	actions.push({
+		id: "configure:change-default",
+		kind: "change-default",
+		section: "configure",
+		label: "Change a default",
+		preview: "anypick use <client> --with …"
+	}, {
+		id: "configure:add-connection",
+		kind: "add-connection",
+		section: "configure",
+		label: "Add connection",
+		preview: "account or gateway"
+	}, {
+		id: "configure:link",
+		kind: "link",
+		section: "configure",
+		label: "Link this project",
+		preview: "project-local binding"
+	});
+	actions.push({
+		id: "more:details",
+		kind: "view-details",
+		section: "more",
+		label: "View details",
+		preview: "anypick current"
+	}, {
+		id: "more:doctor",
+		kind: "doctor",
+		section: "more",
+		label: "Diagnose",
+		preview: "anypick doctor"
+	});
+	const mode = attention.length > 0 ? "degraded" : "ready";
+	return {
+		cwd,
+		cwdShort: shortCwd(cwd),
+		mode,
+		title: "anypick",
+		subtitle: mode === "degraded" ? "Needs attention" : "AI CLI connections",
+		actions
+	};
+}
+var SECTION_LABELS = {
+	attention: "Attention",
+	run: "Run",
+	configure: "Configure",
+	more: "More",
+	"get-started": "Get started",
+	other: "Other"
+};
+var SECTION_ORDER = [
+	"attention",
+	"run",
+	"get-started",
+	"configure",
+	"other",
+	"more"
+];
+//#endregion
+export { SECTION_LABELS, SECTION_ORDER, buildClientRows, buildLauncherModel, nativeConnectionFor, shortClientName };
+
+//# sourceMappingURL=launcher-model.js.map

package/dist/cli/launcher-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher-model.js","names":[],"sources":["../../src/cli/launcher-model.ts"],"sourcesContent":["/**\n * Root launcher action model (spec §7 rev 2.5).\n * Pure data — no I/O chrome. First paint uses local state only.\n */\n\nimport type { AnyPickApp } from '../core/app';\nimport { localAttentionFor } from './local-health';\nimport { shortCwd } from './render-util';\nimport { shortClientName } from '../presentation/client-name';\n\nexport { shortClientName };\n\nexport type LauncherSection = 'attention' | 'run' | 'configure' | 'more' | 'get-started' | 'other';\n\nexport type LauncherActionKind =\n  | 'run'\n  | 'fix-attention'\n  | 'change-default'\n  | 'add-connection'\n  | 'link'\n  | 'view-details'\n  | 'doctor'\n  | 'connect-client'\n  | 'add-account'\n  | 'add-gateway';\n\nexport interface LauncherAction {\n  /** Stable semantic id for selection restore across refresh. */\n  id: string;\n  kind: LauncherActionKind;\n  section: LauncherSection;\n  /** Primary label (e.g. \"Claude\"). */\n  label: string;\n  /** Middle column (source display). */\n  detail?: string;\n  /** Right column status (ready / token expired / …). */\n  status?: string;\n  /** Client id when applicable. */\n  clientId?: string;\n  /** Severity for attention items. */\n  severity?: 'error' | 'warn';\n  /** Footer hint when this row is focused. */\n  preview?: string;\n}\n\nexport interface LauncherModel {\n  cwd: string;\n  cwdShort: string;\n  mode: 'ready' | 'empty' | 'degraded';\n  title: string;\n  subtitle: string;\n  actions: LauncherAction[];\n}\n\nexport interface ClientRow {\n  clientId: string;\n  clientName: string;\n  shortName: string;\n  /** Effective source display, if any. */\n  source?: string;\n  /** Effective primary model when the binding pins one. */\n  model?: string;\n  /** Binding scope reported by the resolver (normally global on the launcher). */\n  scope?: string | null;\n  status: 'ready' | 'attention' | 'native' | 'unbound';\n  /** Identity reported by the matching native provider when no AnyPick route exists. */\n  nativeIdentity?: string;\n  attention?: string;\n}\n\nfunction sourceDisplay(source: { kind: string; provider?: string; name?: string }): string {\n  if (source.kind === 'account' && source.provider && source.name) {\n    return `${source.provider}/${source.name}`;\n  }\n  if (source.kind === 'gateway' && source.name) {\n    return source.name;\n  }\n  if (source.kind === 'preset' && source.name) {\n    return `@${source.name}`;\n  }\n  if (source.kind === 'account-pool' && source.provider) {\n    return `pool:${source.provider}`;\n  }\n  if (source.kind === 'proxy-hub' && source.name) {\n    return `hub:${source.name}`;\n  }\n  return '?';\n}\n\nexport async function buildClientRows(app: AnyPickApp): Promise<ClientRow[]> {\n  const clients = app.clients.list();\n  return Promise.all(\n    clients.map(async (c) => {\n      const shortName = shortClientName(c.id, c.name, c.shortName);\n      let effective;\n      try {\n        effective = app.bindingService.current(c.id)[0];\n      } catch {\n        effective = undefined;\n      }\n      const binding = effective?.binding;\n      if (!binding) {\n        const native = await nativeConnectionFor(app, c.id);\n        if (native) {\n          return {\n            clientId: c.id,\n            clientName: c.name,\n            shortName,\n            source: 'native login',\n            status: 'native' as const,\n            nativeIdentity: native.identity,\n          };\n        }\n        return {\n          clientId: c.id,\n          clientName: c.name,\n          shortName,\n          status: 'unbound' as const,\n        };\n      }\n      const src = binding.spec.source;\n      const display = sourceDisplay(src);\n      const model =\n        binding.spec.model.mode === 'explicit'\n          ? binding.spec.model.id\n          : typeof binding.spec.clientOptions.modelRoles === 'object' &&\n              binding.spec.clientOptions.modelRoles &&\n              'default' in binding.spec.clientOptions.modelRoles &&\n              typeof binding.spec.clientOptions.modelRoles.default === 'string'\n            ? binding.spec.clientOptions.modelRoles.default\n            : undefined;\n      const attention = await localAttentionFor(app, c.id, src);\n      if (attention) {\n        return {\n          clientId: c.id,\n          clientName: c.name,\n          shortName,\n          source: display,\n          model,\n          scope: effective?.scope,\n          status: 'attention' as const,\n          attention,\n        };\n      }\n      return {\n        clientId: c.id,\n        clientName: c.name,\n        shortName,\n        source: display,\n        model,\n        scope: effective?.scope,\n        status: 'ready' as const,\n      };\n    }),\n  );\n}\n\n/**\n * Matching account/client ids identify native auth without a client-specific\n * branch. Native means \"usable outside AnyPick\", not \"AnyPick route exists\".\n */\nexport async function nativeConnectionFor(\n  app: AnyPickApp,\n  clientId: string,\n): Promise<{ identity?: string } | null> {\n  if (!app.accountRegistry.has(clientId)) {\n    return null;\n  }\n  try {\n    const current = await app.accounts.current(clientId);\n    return current.live.present ? { identity: current.live.identity } : null;\n  } catch {\n    return null;\n  }\n}\n\nexport async function buildLauncherModel(\n  app: AnyPickApp,\n  opts: { cwd?: string } = {},\n): Promise<LauncherModel> {\n  const cwd = opts.cwd ?? process.cwd();\n  const clientRows = await buildClientRows(app);\n  const ready = clientRows.filter((r) => r.status === 'ready');\n  const attention = clientRows.filter((r) => r.status === 'attention');\n  const native = clientRows.filter((r) => r.status === 'native');\n  const unbound = clientRows.filter((r) => r.status === 'unbound' || r.status === 'native');\n\n  const actions: LauncherAction[] = [];\n\n  // Empty: no bindings at all\n  if (ready.length === 0 && attention.length === 0) {\n    for (const r of unbound) {\n      actions.push({\n        id: `connect:${r.clientId}`,\n        kind: 'connect-client',\n        section: 'get-started',\n        label:\n          r.status === 'native' ? `Connect ${r.shortName} to AnyPick` : `Connect ${r.shortName}`,\n        detail: r.status === 'native' ? (r.nativeIdentity ?? 'native login active') : undefined,\n        clientId: r.clientId,\n        preview: `set ${r.clientId} source`,\n      });\n    }\n    actions.push(\n      {\n        id: 'other:add-account',\n        kind: 'add-account',\n        section: 'other',\n        label: 'Add account',\n        preview: 'save a native login',\n      },\n      {\n        id: 'other:add-gateway',\n        kind: 'add-gateway',\n        section: 'other',\n        label: 'Add gateway',\n        preview: 'API endpoint + key',\n      },\n    );\n    return {\n      cwd,\n      cwdShort: shortCwd(cwd),\n      mode: 'empty',\n      title: 'anypick',\n      subtitle: native.length\n        ? 'Native clients found · no AnyPick routes yet'\n        : 'No clients connected yet',\n      actions,\n    };\n  }\n\n  for (const r of attention) {\n    actions.push({\n      id: `attention:${r.clientId}`,\n      kind: 'fix-attention',\n      section: 'attention',\n      label: `Fix ${r.shortName}`,\n      detail: r.attention,\n      clientId: r.clientId,\n      severity: 'error',\n      preview: `repair ${r.clientId}`,\n    });\n  }\n\n  for (const r of ready) {\n    actions.push({\n      id: `run:${r.clientId}`,\n      kind: 'run',\n      section: 'run',\n      label: r.shortName,\n      detail: r.source,\n      status: 'ready',\n      clientId: r.clientId,\n      preview: `anypick run ${r.clientId}`,\n    });\n  }\n\n  actions.push(\n    {\n      id: 'configure:change-default',\n      kind: 'change-default',\n      section: 'configure',\n      label: 'Change a default',\n      preview: 'anypick use <client> --with …',\n    },\n    {\n      id: 'configure:add-connection',\n      kind: 'add-connection',\n      section: 'configure',\n      label: 'Add connection',\n      preview: 'account or gateway',\n    },\n    {\n      id: 'configure:link',\n      kind: 'link',\n      section: 'configure',\n      label: 'Link this project',\n      preview: 'project-local binding',\n    },\n  );\n\n  actions.push(\n    {\n      id: 'more:details',\n      kind: 'view-details',\n      section: 'more',\n      label: 'View details',\n      preview: 'anypick current',\n    },\n    {\n      id: 'more:doctor',\n      kind: 'doctor',\n      section: 'more',\n      label: 'Diagnose',\n      preview: 'anypick doctor',\n    },\n  );\n\n  const mode: LauncherModel['mode'] = attention.length > 0 ? 'degraded' : 'ready';\n  return {\n    cwd,\n    cwdShort: shortCwd(cwd),\n    mode,\n    title: 'anypick',\n    subtitle: mode === 'degraded' ? 'Needs attention' : 'AI CLI connections',\n    actions,\n  };\n}\n\nexport const SECTION_LABELS: Record<LauncherSection, string> = {\n  attention: 'Attention',\n  run: 'Run',\n  configure: 'Configure',\n  more: 'More',\n  'get-started': 'Get started',\n  other: 'Other',\n};\n\nexport const SECTION_ORDER: LauncherSection[] = [\n  'attention',\n  'run',\n  'get-started',\n  'configure',\n  'other',\n  'more',\n];\n"],"mappings":"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"}

package/dist/cli/launcher-render.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Pure renderer for the root command-center launcher (spec §7 rev 2.5).
+ * Compact, scannable, no Clack rails.
+ */
+import { type LauncherAction, type LauncherModel } from './launcher-model.js';
+export type { LayoutWidth } from './render-util.js';
+export { layoutForColumns } from './render-util.js';
+export interface RenderFrameOpts {
+    cursor: number;
+    columns?: number;
+    color?: boolean;
+    /** When set, show a settled/submit frame instead of interactive chrome. */
+    settled?: 'submit' | 'cancel';
+}
+/**
+ * Render a full launcher frame. `cursor` is the index into ordered actions.
+ */
+export declare function renderLauncherFrame(model: LauncherModel, opts: RenderFrameOpts): string;
+/** Flat list of action ids in render order (must match cursor indices). */
+export declare function orderedActions(model: LauncherModel): LauncherAction[];
+export declare function cursorForActionId(model: LauncherModel, id: string | undefined): number;
+//# sourceMappingURL=launcher-render.d.ts.map

package/dist/cli/launcher-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher-render.d.ts","sourceRoot":"","sources":["../../src/cli/launcher-render.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAa1B,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAcjD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,eAAe,GAAG,MAAM,CAuDvF;AA8FD,2EAA2E;AAC3E,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,cAAc,EAAE,CAUrE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAOtF"}

package/dist/cli/launcher-render.js

@@ -0,0 +1,113 @@
+import { MARK } from "./ux.js";
+import { layoutForColumns } from "../presentation/layout.js";
+import { noColor, padEndVisible, paint, truncate, visibleLen } from "./render-util.js";
+import { SECTION_LABELS, SECTION_ORDER } from "./launcher-model.js";
+//#region src/cli/launcher-render.ts
+/**
+* Pure renderer for the root command-center launcher (spec §7 rev 2.5).
+* Compact, scannable, no Clack rails.
+*/
+var identity = (s) => s;
+function groupBySection(actions) {
+	const map = /* @__PURE__ */ new Map();
+	for (const a of actions) {
+		const list = map.get(a.section) ?? [];
+		list.push(a);
+		map.set(a.section, list);
+	}
+	return map;
+}
+/**
+* Render a full launcher frame. `cursor` is the index into ordered actions.
+*/
+function renderLauncherFrame(model, opts) {
+	const cols = Math.max(40, opts.columns ?? process.stdout.columns ?? 80);
+	const layout = layoutForColumns(cols);
+	const c = paint(opts.color ?? !noColor());
+	const focused = orderedActions(model)[opts.cursor];
+	const lines = [];
+	lines.push(renderHeader(model, cols, layout, c));
+	if (model.mode === "degraded") lines.push(` ${c.yellow(model.subtitle)}`);
+	else if (model.mode === "empty") lines.push(` ${c.dim(model.subtitle)}`);
+	else lines.push(` ${c.dim(model.subtitle)}`);
+	lines.push("");
+	const bySection = groupBySection(model.actions);
+	let actionIndex = 0;
+	let sectionCount = 0;
+	for (const section of SECTION_ORDER) {
+		const items = bySection.get(section);
+		if (!items?.length) continue;
+		if (sectionCount > 0) lines.push("");
+		sectionCount++;
+		lines.push(` ${c.dim(SECTION_LABELS[section].toUpperCase())}`);
+		for (const action of items) {
+			const selected = actionIndex === opts.cursor && !opts.settled;
+			const hotkey = actionIndex < 9 ? String(actionIndex + 1) : " ";
+			lines.push(formatActionRow(action, {
+				selected,
+				layout,
+				cols,
+				c,
+				hotkey
+			}));
+			actionIndex++;
+		}
+	}
+	lines.push("");
+	if (opts.settled === "cancel") lines.push(` ${c.dim("quit")}`);
+	else if (opts.settled === "submit" && focused) lines.push(` ${c.cyan("→")} ${c.dim(focused.preview ?? focused.label)}`);
+	else lines.push(renderFooter(focused, c, layout));
+	return lines.join("\n");
+}
+function renderHeader(model, cols, layout, c) {
+	const brand = c.bold(" anypick");
+	if (layout === "narrow") return brand;
+	const right = c.dim(model.cwdShort);
+	const gap = Math.max(2, cols - visibleLen(` anypick`) - visibleLen(model.cwdShort) - 1);
+	return brand + " ".repeat(gap) + right;
+}
+function renderFooter(focused, c, layout) {
+	if (layout === "narrow") {
+		if (focused?.preview) return ` ${c.cyan("↵")} ${c.dim(truncate(focused.preview, 26))}  ${c.dim("esc · 1-9")}`;
+		return ` ${c.dim("↑↓  ↵  esc  1-9")}`;
+	}
+	const nav = c.dim("↑↓") + "  " + c.dim("esc") + "  " + c.dim("1-9");
+	if (!focused?.preview) return ` ${nav}`;
+	return ` ${c.cyan("↵")} ${c.dim(focused.preview)}          ${nav}`;
+}
+function formatActionRow(action, opts) {
+	const { selected, layout, c, hotkey } = opts;
+	const marker = selected ? c.cyan(MARK.focus) : " ";
+	const num = c.dim(hotkey);
+	if (layout === "narrow") return ` ${marker} ${num} ${selected ? c.bold(action.label) : action.label}${action.section === "run" ? ` ${statusBadge(action, c, true)}` : action.detail ? c.dim(` ${truncate(action.detail, 16)}`) : ""}`;
+	const labelW = layout === "wide" ? 14 : 12;
+	const detailW = layout === "wide" ? 22 : 18;
+	if (action.section === "attention") return ` ${marker} ${num} ${padEndVisible((selected ? c.bold : identity)(truncate(action.label, labelW + 6)), labelW + 6)}  ${c.red(truncate(action.detail ?? "", detailW + 8))}`;
+	if (action.section === "run") return ` ${marker} ${num} ${padEndVisible((selected ? c.bold : c.white)(truncate(action.label, labelW)), labelW)}  ${padEndVisible(c.dim(truncate(action.detail ?? "", detailW)), detailW)}  ${statusBadge(action, c, false)}`;
+	return ` ${marker} ${num} ${selected ? c.bold(action.label) : action.label}`;
+}
+function statusBadge(action, c, compact) {
+	if (action.status === "ready") return compact ? c.green(MARK.live) : c.green(MARK.live) + c.dim(" ready");
+	if (action.severity === "error") return compact ? c.red("!") : c.red(MARK.live) + c.dim(" " + (action.detail ?? "error"));
+	if (action.status) return c.dim(action.status);
+	return "";
+}
+/** Flat list of action ids in render order (must match cursor indices). */
+function orderedActions(model) {
+	const bySection = groupBySection(model.actions);
+	const out = [];
+	for (const section of SECTION_ORDER) {
+		const items = bySection.get(section);
+		if (items) out.push(...items);
+	}
+	return out;
+}
+function cursorForActionId(model, id) {
+	if (!id) return 0;
+	const idx = orderedActions(model).findIndex((a) => a.id === id);
+	return idx >= 0 ? idx : 0;
+}
+//#endregion
+export { cursorForActionId, orderedActions, renderLauncherFrame };
+
+//# sourceMappingURL=launcher-render.js.map

package/dist/cli/launcher-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher-render.js","names":[],"sources":["../../src/cli/launcher-render.ts"],"sourcesContent":["/**\n * Pure renderer for the root command-center launcher (spec §7 rev 2.5).\n * Compact, scannable, no Clack rails.\n */\n\nimport {\n  SECTION_LABELS,\n  SECTION_ORDER,\n  type LauncherAction,\n  type LauncherModel,\n  type LauncherSection,\n} from './launcher-model';\nimport {\n  layoutForColumns,\n  noColor,\n  paint,\n  padEndVisible,\n  truncate,\n  visibleLen,\n  type LayoutWidth,\n  type Paint,\n} from './render-util';\nimport { MARK } from './ux';\n\nexport type { LayoutWidth } from './render-util';\nexport { layoutForColumns } from './render-util';\n\nconst identity = (s: string) => s;\n\nfunction groupBySection(actions: LauncherAction[]): Map<LauncherSection, LauncherAction[]> {\n  const map = new Map<LauncherSection, LauncherAction[]>();\n  for (const a of actions) {\n    const list = map.get(a.section) ?? [];\n    list.push(a);\n    map.set(a.section, list);\n  }\n  return map;\n}\n\nexport interface RenderFrameOpts {\n  cursor: number;\n  columns?: number;\n  color?: boolean;\n  /** When set, show a settled/submit frame instead of interactive chrome. */\n  settled?: 'submit' | 'cancel';\n}\n\n/**\n * Render a full launcher frame. `cursor` is the index into ordered actions.\n */\nexport function renderLauncherFrame(model: LauncherModel, opts: RenderFrameOpts): string {\n  const cols = Math.max(40, opts.columns ?? process.stdout.columns ?? 80);\n  const layout = layoutForColumns(cols);\n  const c = paint(opts.color ?? !noColor());\n  const ordered = orderedActions(model);\n  const focused = ordered[opts.cursor];\n  const lines: string[] = [];\n\n  // ── Header ────────────────────────────────────────────────────\n  lines.push(renderHeader(model, cols, layout, c));\n  if (model.mode === 'degraded') {\n    lines.push(` ${c.yellow(model.subtitle)}`);\n  } else if (model.mode === 'empty') {\n    lines.push(` ${c.dim(model.subtitle)}`);\n  } else {\n    lines.push(` ${c.dim(model.subtitle)}`);\n  }\n  lines.push('');\n\n  // ── Body ──────────────────────────────────────────────────────\n  const bySection = groupBySection(model.actions);\n  let actionIndex = 0;\n  let sectionCount = 0;\n\n  for (const section of SECTION_ORDER) {\n    const items = bySection.get(section);\n    if (!items?.length) {\n      continue;\n    }\n    if (sectionCount > 0) {\n      lines.push('');\n    }\n    sectionCount++;\n    lines.push(` ${c.dim(SECTION_LABELS[section].toUpperCase())}`);\n\n    for (const action of items) {\n      const selected = actionIndex === opts.cursor && !opts.settled;\n      const hotkey = actionIndex < 9 ? String(actionIndex + 1) : ' ';\n      lines.push(formatActionRow(action, { selected, layout, cols, c, hotkey }));\n      actionIndex++;\n    }\n  }\n\n  lines.push('');\n\n  // ── Footer (contextual) ───────────────────────────────────────\n  if (opts.settled === 'cancel') {\n    lines.push(` ${c.dim('quit')}`);\n  } else if (opts.settled === 'submit' && focused) {\n    lines.push(` ${c.cyan('→')} ${c.dim(focused.preview ?? focused.label)}`);\n  } else {\n    lines.push(renderFooter(focused, c, layout));\n  }\n\n  return lines.join('\\n');\n}\n\nfunction renderHeader(model: LauncherModel, cols: number, layout: LayoutWidth, c: Paint): string {\n  const brand = c.bold(' anypick');\n  if (layout === 'narrow') {\n    return brand;\n  }\n  const right = c.dim(model.cwdShort);\n  const gap = Math.max(2, cols - visibleLen(` anypick`) - visibleLen(model.cwdShort) - 1);\n  return brand + ' '.repeat(gap) + right;\n}\n\nfunction renderFooter(focused: LauncherAction | undefined, c: Paint, layout: LayoutWidth): string {\n  if (layout === 'narrow') {\n    if (focused?.preview) {\n      return ` ${c.cyan('↵')} ${c.dim(truncate(focused.preview, 26))}  ${c.dim('esc · 1-9')}`;\n    }\n    return ` ${c.dim('↑↓  ↵  esc  1-9')}`;\n  }\n\n  const nav = c.dim('↑↓') + '  ' + c.dim('esc') + '  ' + c.dim('1-9');\n  if (!focused?.preview) {\n    return ` ${nav}`;\n  }\n  // Contextual action on the left — the \"what enter does\" signal\n  return ` ${c.cyan('↵')} ${c.dim(focused.preview)}          ${nav}`;\n}\n\nfunction formatActionRow(\n  action: LauncherAction,\n  opts: {\n    selected: boolean;\n    layout: LayoutWidth;\n    cols: number;\n    c: Paint;\n    hotkey: string;\n  },\n): string {\n  const { selected, layout, c, hotkey } = opts;\n  // Fixed-width marker so rows don't jump\n  const marker = selected ? c.cyan(MARK.focus) : ' ';\n  const num = c.dim(hotkey);\n\n  if (layout === 'narrow') {\n    const label = selected ? c.bold(action.label) : action.label;\n    const tail =\n      action.section === 'run'\n        ? ` ${statusBadge(action, c, true)}`\n        : action.detail\n          ? c.dim(` ${truncate(action.detail, 16)}`)\n          : '';\n    return ` ${marker} ${num} ${label}${tail}`;\n  }\n\n  const labelW = layout === 'wide' ? 14 : 12;\n  const detailW = layout === 'wide' ? 22 : 18;\n\n  if (action.section === 'attention') {\n    const lab = padEndVisible(\n      (selected ? c.bold : identity)(truncate(action.label, labelW + 6)),\n      labelW + 6,\n    );\n    const reason = c.red(truncate(action.detail ?? '', detailW + 8));\n    return ` ${marker} ${num} ${lab}  ${reason}`;\n  }\n\n  if (action.section === 'run') {\n    const lab = padEndVisible(\n      (selected ? c.bold : c.white)(truncate(action.label, labelW)),\n      labelW,\n    );\n    const det = padEndVisible(c.dim(truncate(action.detail ?? '', detailW)), detailW);\n    const badge = statusBadge(action, c, false);\n    return ` ${marker} ${num} ${lab}  ${det}  ${badge}`;\n  }\n\n  // configure / more / get-started / other\n  const body = selected ? c.bold(action.label) : action.label;\n  return ` ${marker} ${num} ${body}`;\n}\n\nfunction statusBadge(action: LauncherAction, c: Paint, compact: boolean): string {\n  if (action.status === 'ready') {\n    return compact ? c.green(MARK.live) : c.green(MARK.live) + c.dim(' ready');\n  }\n  if (action.severity === 'error') {\n    return compact ? c.red('!') : c.red(MARK.live) + c.dim(' ' + (action.detail ?? 'error'));\n  }\n  if (action.status) {\n    return c.dim(action.status);\n  }\n  return '';\n}\n\n/** Flat list of action ids in render order (must match cursor indices). */\nexport function orderedActions(model: LauncherModel): LauncherAction[] {\n  const bySection = groupBySection(model.actions);\n  const out: LauncherAction[] = [];\n  for (const section of SECTION_ORDER) {\n    const items = bySection.get(section);\n    if (items) {\n      out.push(...items);\n    }\n  }\n  return out;\n}\n\nexport function cursorForActionId(model: LauncherModel, id: string | undefined): number {\n  if (!id) {\n    return 0;\n  }\n  const list = orderedActions(model);\n  const idx = list.findIndex((a) => a.id === id);\n  return idx >= 0 ? idx : 0;\n}\n"],"mappings":"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"}

package/dist/cli/launcher.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Root command-center launcher using @clack/core SelectPrompt + custom render.
+ * Does NOT use @clack/prompts intro/note/select/outro chrome.
+ */
+import { type LauncherAction, type LauncherModel } from './launcher-model.js';
+import type { AnyPickApp } from '../core/app.js';
+export type LauncherResult = {
+    kind: 'action';
+    action: LauncherAction;
+    model: LauncherModel;
+} | {
+    kind: 'quit';
+    exitCode: number;
+};
+export interface OpenLauncherOpts {
+    /** Restore selection by semantic action id. */
+    previousActionId?: string;
+    cwd?: string;
+}
+/**
+ * Show the root launcher once. Resolves with the chosen action, or quit.
+ * Esc / q → exitCode 0; Ctrl-C → exitCode 130; 1-9 select that row.
+ */
+export declare function openRootLauncher(app: AnyPickApp, opts?: OpenLauncherOpts): Promise<LauncherResult>;
+/** Listen for SIGINT during launcher so Ctrl-C maps to 130 if process gets it. */
+export declare function installLauncherSigint(): () => void;
+//# sourceMappingURL=launcher.d.ts.map

package/dist/cli/launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launcher.d.ts","sourceRoot":"","sources":["../../src/cli/launcher.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAsB,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE/F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAG9C,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAMD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,UAAU,EACf,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,cAAc,CAAC,CAkFzB;AAED,kFAAkF;AAClF,wBAAgB,qBAAqB,IAAI,MAAM,IAAI,CAGlD"}