@sayknow-cli/coding-agent 0.6.6 → 0.6.8

package/dist/types/tools/locate.d.ts

@@ -0,0 +1,44 @@
+import type { AgentTool, AgentToolResult } from "@sayknow-cli/agent-core";
+import * as z from "zod/v4";
+import type { ToolSession } from ".";
+import { type LocateResult } from "./locate-core";
+declare const locateSchema: z.ZodObject<{
+    query: z.ZodString;
+    path: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type LocateParams = z.infer<typeof locateSchema>;
+export interface LocateToolDetails {
+    result: Omit<LocateResult, "files" | "weakLeads"> & {
+        files: string[];
+    };
+}
+export declare class LocateTool implements AgentTool<typeof locateSchema, LocateToolDetails> {
+    private readonly session;
+    readonly name = "locate";
+    readonly label = "Locate";
+    readonly summary = "Find code by describing what it does (Jev relevance judgement)";
+    /**
+     * Essential when offered: its value is being picked instead of a grep, which a
+     * discoverable tool hidden behind search_tool_bm25 would rarely be. createIf already
+     * keeps it out unless a TypeSafe key is stored.
+     */
+    readonly loadMode = "essential";
+    readonly description: string;
+    readonly parameters: z.ZodObject<{
+        query: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        limit: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>;
+    readonly strict = true;
+    /**
+     * Offered only when it can work: a TypeSafe key is stored and `locate.enabled` is on.
+     * Without the hosted model every judgement would fall to an uncalibrated LLM, one
+     * request per folder batch, which costs more than the search saves.
+     */
+    static createIf(session: ToolSession): LocateTool | null;
+    constructor(session: ToolSession);
+    execute(_toolCallId: string, params: LocateParams, signal?: AbortSignal): Promise<AgentToolResult<LocateToolDetails>>;
+}
+export declare function formatLocateResult(query: string, root: string, cwd: string, result: LocateResult): string;
+export {};

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@sayknow-cli/coding-agent",
-	"version": "0.6.6",
+	"version": "0.6.8",
 	"description": "Sayknow-CLI CLI with read, bash, edit, write tools and session management",
 	"homepage": "https://sayknow-cli.com",
 	"author": "jaybeyond",
@@ -54,12 +54,12 @@
 		"@agentclientprotocol/sdk": "1.3.0",
 		"@babel/parser": "^7.29.3",
 		"@mozilla/readability": "^0.6.0",
-		"@sayknow-cli/stats": "0.6.6",
-		"@sayknow-cli/agent-core": "0.6.6",
-		"@sayknow-cli/ai": "0.6.6",
-		"@sayknow-cli/natives": "0.6.6",
-		"@sayknow-cli/tui": "0.6.6",
-		"@sayknow-cli/utils": "0.6.6",
+		"@sayknow-cli/stats": "0.6.8",
+		"@sayknow-cli/agent-core": "0.6.8",
+		"@sayknow-cli/ai": "0.6.8",
+		"@sayknow-cli/natives": "0.6.8",
+		"@sayknow-cli/tui": "0.6.8",
+		"@sayknow-cli/utils": "0.6.8",
 		"@puppeteer/browsers": "^2.13.0",
 		"@types/turndown": "5.0.6",
 		"@xterm/headless": "^6.0.0",

package/scripts/generate-sdk-operation-inventory.ts

@@ -38,6 +38,8 @@ const LOCKED_EXCLUSIONS: Readonly<Record<string, string>> = {
 		"local session-discovery metadata command; no SDK operation counterpart or runtime/retention authority",
 	"slash_command:unstar":
 		"local session-discovery metadata command; no SDK operation counterpart or runtime/retention authority",
+	"slash_command:fallback":
+		"local fallback-chain configuration (fallback.models / fallback.auto settings); no SDK operation counterpart, and SDK clients observe switches via model_fallback_switched",
 	"slash_command:import-session":
 		"local transcript-file import into a new session; ACP is explicitly disabled and no SDK operation reads caller-selected host paths",
 	"agent_session:constructor": "internal accessor/plumbing, not a user-facing control seam",
@@ -193,6 +195,8 @@ const LOCKED_EXCLUSIONS: Readonly<Record<string, string>> = {
 		"internal profile and fallback-chain state, not a user-facing SDK control seam",
 	"agent_session:setConfiguredModelChain":
 		"internal profile and fallback-chain state, not a user-facing SDK control seam",
+	"agent_session:getDefaultFallbackChain":
+		"internal profile and fallback-chain state, not a user-facing SDK control seam",
 	"agent_session:setDefaultFallbackRuntimeModel":
 		"internal fallback runtime bookkeeping, not a user-facing SDK control seam",
 	"agent_session:seedDefaultFallbackResolution":

package/src/cli/setup-cli.ts

@@ -33,8 +33,10 @@ import {
 import { buildHostPluginSetup, formatHostPluginSetup, type HostPluginKind } from "../setup/host-plugin-setup";
 import {
 	addApiCompatibleProvider,
+	formatProviderPresetChoices,
 	formatProviderPresetList,
 	formatProviderSetupResult,
+	PROVIDER_PRESETS,
 	parseProviderCompatibility,
 } from "../setup/provider-onboarding";
 
@@ -119,7 +121,7 @@ function rejectProviderFlagsOutsideProvider(component: SetupComponent, flags: Se
 	console.error(chalk.red("Provider setup flags require the explicit `provider` component."));
 	console.error(
 		chalk.dim(
-			`Run: ${APP_NAME} setup provider --preset <minimax|glm> or ${APP_NAME} setup provider --compat <openai|anthropic> --provider <id> --base-url <url> --api-key-env <ENV> --model <id>`,
+			`Run: ${APP_NAME} setup provider --preset <${formatProviderPresetChoices()}> or ${APP_NAME} setup provider --compat <openai|anthropic> --provider <id> --base-url <url> --api-key-env <ENV> --model <id>`,
 		),
 	);
 	process.exit(1);
@@ -761,8 +763,9 @@ ${chalk.bold("Components:")}
 
 
 ${chalk.bold("Provider example:")}
-  ${APP_NAME} setup provider --preset minimax
-  ${APP_NAME} setup provider --preset glm
+${PROVIDER_PRESETS.slice(0, 2)
+	.map(preset => `  ${APP_NAME} setup provider --preset ${preset.id}`)
+	.join("\n")}
   MY_PROVIDER_KEY=sk-... ${APP_NAME} setup provider --compat openai --provider my-oai --base-url https://api.example.com/v1 --api-key-env MY_PROVIDER_KEY --model gpt-example
 
 ${chalk.bold("Hermes example:")}
@@ -775,7 +778,7 @@ ${chalk.bold("Options:")}
   -c, --check       Check if dependencies are installed without installing
   -f, --force       Overwrite existing default workflow skill files
   --json            Output status as JSON
-  --preset          Provider preset: minimax, minimax-cn, or glm (aliases include minimax-code and zai)
+  --preset          Provider preset: ${PROVIDER_PRESETS.map(preset => preset.id).join(", ")} (aliases: ${PROVIDER_PRESETS.flatMap(preset => preset.aliases).join(", ")})
   --compat          Provider compatibility: openai or anthropic
   --provider        Provider id to add to models.yml
   --base-url        Provider API base URL

package/src/commands/sdk.ts

@@ -18,6 +18,7 @@ import {
 	writeSessionLifecycleFailure,
 	writeSessionLifecycleReady,
 } from "../sdk/broker/lifecycle";
+import { exitIfSourceGone, startSessionHostGuard } from "../sdk/broker/process-guard";
 import { processIncarnation } from "../sdk/broker/process-incarnation";
 import { type CreateLifecycleAgentSessionResult, createLifecycleAgentSession } from "../sdk/lifecycle-session";
 import { listManagedSessionCandidates, resolveManagedSessionScope } from "../sdk/session-directory";
@@ -505,6 +506,7 @@ export async function runSessionHost(
 	}
 	process.once("SIGTERM", stop);
 	process.once("SIGINT", stop);
+	startSessionHostGuard({ markerPath, pid: process.pid, effectMarker, incarnation, cwd, onLost: stop });
 	await new Promise<void>(() => {});
 }
 
@@ -559,6 +561,7 @@ export default class Sdk extends Command {
 				const policy = (await Settings.loadForScope({ cwd, agentDir })).get("session.directoryMigration");
 				return policy === "disabled" ? "disabled" : "copy-retain";
 			},
+			beforePublicationTick: () => exitIfSourceGone(),
 		});
 		await broker.start();
 		if (!broker.ownsDiscovery) return;

package/src/commands/setup.ts

@@ -4,6 +4,7 @@
 import { Args, Command, Flags } from "@sayknow-cli/utils/cli";
 import { runSetupCommand, type SetupCommandArgs, type SetupComponent } from "../cli/setup-cli";
 import { initTheme } from "../modes/theme/theme";
+import { PROVIDER_PRESETS } from "../setup/provider-onboarding";
 
 const COMPONENTS: SetupComponent[] = [
 	"claude",
@@ -52,7 +53,9 @@ export default class Setup extends Command {
 		"skc-command": Flags.string({ description: "Command used to start `skc mcp-serve coordinator`" }),
 		target: Flags.string({ description: "Hermes config file target for config-only install" }),
 		"profile-dir": Flags.string({ description: "Hermes profile directory for full setup install" }),
-		preset: Flags.string({ description: "Provider preset: minimax, minimax-cn, or glm" }),
+		preset: Flags.string({
+			description: `Provider preset: ${PROVIDER_PRESETS.map(preset => preset.id).join(", ")}`,
+		}),
 		compat: Flags.string({ description: "Provider compatibility: openai or anthropic" }),
 		provider: Flags.string({ description: "Provider id to add to models.yml" }),
 		"base-url": Flags.string({ description: "Provider API base URL" }),

package/src/config/settings-schema.ts

@@ -1223,8 +1223,39 @@ export const SETTINGS_SCHEMA = {
 		type: "number",
 		default: 3,
 		validate: (value: number) => Number.isInteger(value) && value > 0,
+		ui: {
+			tab: "model",
+			label: "Fallback Attempts per Model",
+			description:
+				"Tries on each model in the fallback chain (including the first) before moving to the next one. Missing credentials skip a model immediately.",
+			options: [
+				{ value: "1", label: "1 try" },
+				{ value: "2", label: "2 tries" },
+				{ value: "3", label: "3 tries" },
+				{ value: "5", label: "5 tries" },
+			],
+		},
+	},
+
+	/**
+	 * When the default model is blocked, keep going on another logged-in provider
+	 * after the configured chain and `fallback.models` run out. The extra entries
+	 * are computed per session and never written into the configured chain.
+	 */
+	"fallback.auto": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "model",
+			label: "Automatic Model Fallback",
+			description:
+				"When the default model is blocked (no login, quota, auth or server errors), continue on a model from another logged-in provider. /fallback shows the chain.",
+		},
 	},
 
+	/** Models to try, in order, after the default chain. Edited with `/fallback`. */
+	"fallback.models": { type: "array", default: EMPTY_STRING_ARRAY },
+
 	// Retries
 	"retry.enabled": { type: "boolean", default: true },
 
@@ -1443,6 +1474,16 @@ export const SETTINGS_SCHEMA = {
 			],
 		},
 	},
+	"startup.welcomeMouse": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "interaction",
+			label: "Clickable Launch Card",
+			description:
+				"Until the first prompt, capture the mouse so a recent session on the launch card opens with one click. Terminal text selection needs Shift held meanwhile. Off: open sessions with ↓ and Enter.",
+		},
+	},
 	"startup.skipLogoAnimation": {
 		type: "boolean",
 		default: false,
@@ -3107,6 +3148,22 @@ export const SETTINGS_SCHEMA = {
 		},
 	},
 
+	/**
+	 * The `locate` tool: find code by describing what it does, judged by Jev. Offered only
+	 * when a TypeSafe key is stored. Sends folder paths, file names and declaration lines
+	 * (never bodies or comments) to TypeSafe.
+	 */
+	"locate.enabled": {
+		type: "boolean",
+		default: true,
+		ui: {
+			tab: "tools",
+			label: "Locate (Jev code search)",
+			description:
+				"Offer the locate tool when a TypeSafe key is stored. It sends folder paths, file names and declaration lines (no function bodies or comments) to TypeSafe to judge relevance.",
+		},
+	},
+
 	"tools.essentialOverride": {
 		type: "array",
 		default: [] as string[],
@@ -3492,6 +3549,31 @@ export const SETTINGS_SCHEMA = {
 	// Providers
 	// ────────────────────────────────────────────────────────────────────────
 
+	// Multi-account order. `SKC_CREDENTIAL_RANKING_MODE` overrides it per machine.
+	"auth.credentialRankingMode": {
+		type: "enum",
+		values: ["balanced", "earliest-reset"] as const,
+		default: "balanced",
+		ui: {
+			tab: "providers",
+			label: "Multi-Account Order",
+			description:
+				"Which logged-in account of a provider a new session uses. A blocked or exhausted account is always skipped for the next one.",
+			options: [
+				{
+					value: "balanced",
+					label: "Balanced",
+					description: "Least-used account first; spreads load and keeps headroom on every account",
+				},
+				{
+					value: "earliest-reset",
+					label: "Earliest reset",
+					description: "Account whose usage window resets soonest first, so quota is not lost at reset",
+				},
+			],
+		},
+	},
+
 	// Secret handling
 	"secrets.enabled": {
 		type: "boolean",

package/src/decisions/typesafe-backend.ts

@@ -119,7 +119,7 @@ export function createTypeSafeDecisionBackend(deps: TypeSafeBackendDeps): Decisi
 		name: "typesafe",
 		async decide(request: DecisionRequest): Promise<DecisionResult | null> {
 			validateQuestions(request.questions);
-			const apiKey = await deps.registry.getApiKeyForProvider(TYPESAFE_PROVIDER, deps.sessionId);
+			let apiKey = await deps.registry.getApiKeyForProvider(TYPESAFE_PROVIDER, deps.sessionId);
 			// No key means the user never added TypeSafe. That is not an error — the next
 			// backend (their logged-in model) handles it.
 			if (!apiKey) return null;
@@ -132,13 +132,26 @@ export function createTypeSafeDecisionBackend(deps: TypeSafeBackendDeps): Decisi
 			request.signal?.addEventListener("abort", abortOnCaller, { once: true });
 			const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
 			const started = Date.now();
-			try {
-				const response = await doFetch(`${baseUrl}/v1/systemone`, {
+			const send = (key: string) =>
+				doFetch(`${baseUrl}/v1/systemone`, {
 					method: "POST",
-					headers: { Authorization: `Bearer ${apiKey}`, "Content-Type": "application/json" },
+					headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
 					body: JSON.stringify({ state: request.state, model, questions: toWireQuestions(request.questions) }),
 					signal: controller.signal,
 				});
+			try {
+				let response = await send(apiKey);
+				if (response.status === 401 || response.status === 403) {
+					// A session reads the credential store once, at startup. A key replaced from
+					// another session (or `skc setup typesafe`) stays invisible here, so every
+					// request kept sending the revoked key. Reload once; retry only if it changed.
+					const refreshed = await reloadedKey(deps, apiKey);
+					if (refreshed && !controller.signal.aborted) {
+						await response.body?.cancel().catch(() => {});
+						apiKey = refreshed;
+						response = await send(apiKey);
+					}
+				}
 				if (!response.ok) {
 					logger.debug("decisions/typesafe: request failed", {
 						status: response.status,
@@ -169,3 +182,24 @@ export function createTypeSafeDecisionBackend(deps: TypeSafeBackendDeps): Decisi
 		},
 	};
 }
+
+/**
+ * Re-read stored credentials and return the TypeSafe key if it differs from the one
+ * that was just rejected. Undefined when nothing changed (the key really is bad) or the
+ * store cannot be reloaded, so a genuinely revoked key costs one extra read, not a retry.
+ */
+async function reloadedKey(deps: TypeSafeBackendDeps, rejected: string): Promise<string | undefined> {
+	const storage = (deps.registry as { authStorage?: { reload?: () => Promise<void> } }).authStorage;
+	if (typeof storage?.reload !== "function") return undefined;
+	try {
+		await storage.reload();
+		const current = await deps.registry.getApiKeyForProvider(TYPESAFE_PROVIDER, deps.sessionId);
+		if (current && current !== rejected) {
+			logger.debug("decisions/typesafe: picked up a key replaced since this session started");
+			return current;
+		}
+	} catch (error) {
+		logger.debug("decisions/typesafe: credential reload failed", { error: String(error) });
+	}
+	return undefined;
+}

package/src/i18n/messages/de.settings.ts

@@ -235,6 +235,31 @@ export const deSettings: Record<string, string> = {
 	"set:task.serviceTier:o:claude-only:l": "Priorität (nur Claude)",
 	"set:task.serviceTier:o:claude-only:d":
 		"Anthropic-Schnellmodus bei direkten Claude-Anfragen; sonst ignoriert (inkl. Bedrock/Vertex)",
+	"set:fallback.maxAttempts:l": "Fallback-Versuche pro Modell",
+	"set:fallback.maxAttempts:d":
+		"Versuche je Modell der Fallback-Kette (einschließlich des ersten), bevor das nächste drankommt. Modelle ohne Anmeldedaten werden sofort übersprungen.",
+	"set:fallback.maxAttempts:o:1:l": "1 Versuch",
+	"set:fallback.maxAttempts:o:2:l": "2 Versuche",
+	"set:fallback.maxAttempts:o:3:l": "3 Versuche",
+	"set:fallback.maxAttempts:o:5:l": "5 Versuche",
+	"set:fallback.auto:l": "Automatischer Modell-Fallback",
+	"set:fallback.auto:d":
+		"Ist das Standardmodell blockiert (keine Anmeldung, Kontingent, Auth- oder Serverfehler), mit einem Modell eines anderen angemeldeten Anbieters weitermachen. /fallback zeigt die Kette.",
+	"set:auth.credentialRankingMode:l": "Reihenfolge mehrerer Konten",
+	"set:auth.credentialRankingMode:d":
+		"Welches angemeldete Konto eines Anbieters eine neue Sitzung verwendet. Ein blockiertes oder erschöpftes Konto übergibt immer an das nächste.",
+	"set:auth.credentialRankingMode:o:balanced:l": "Ausgewogen",
+	"set:auth.credentialRankingMode:o:balanced:d":
+		"Am wenigsten genutztes Konto zuerst; verteilt die Last und lässt jedem Konto Reserve",
+	"set:auth.credentialRankingMode:o:earliest-reset:l": "Früheste Zurücksetzung",
+	"set:auth.credentialRankingMode:o:earliest-reset:d":
+		"Konto, dessen Nutzungsfenster zuerst zurückgesetzt wird, zuerst, damit kein Kontingent verfällt",
+	"set:locate.enabled:l": "Locate (Jev-Codesuche)",
+	"set:locate.enabled:d":
+		"Bietet das locate-Werkzeug an, wenn ein TypeSafe-Schlüssel gespeichert ist. Zur Relevanzbewertung werden Ordnerpfade, Dateinamen und Deklarationszeilen (ohne Funktionsrümpfe und Kommentare) an TypeSafe gesendet.",
+	"set:startup.welcomeMouse:l": "Klickbare Startkarte",
+	"set:startup.welcomeMouse:d":
+		"Bis zum ersten Prompt die Maus übernehmen, damit eine letzte Sitzung auf der Startkarte mit einem Klick öffnet. Terminaltext währenddessen mit gedrückter Umschalttaste markieren. Aus: mit ↓ und Enter öffnen.",
 	"set:retry.maxRetries:l": "Wiederholungsversuche",
 	"set:retry.maxRetries:d": "Maximale Wiederholungsversuche bei API-Fehlern",
 	"set:retry.maxRetries:o:1:l": "1 Wiederholung",
@@ -773,6 +798,7 @@ export const deSettings: Record<string, string> = {
 	"set:searxng.endpoint:l": "SearXNG-Endpunkt",
 	"set:searxng.endpoint:d": "Basis-URL für selbst gehostete Suche",
 	"cmd:model:d": "Modell auswählen (öffnet Auswahloberfläche)",
+	"cmd:fallback:d": "Modelle anzeigen oder bearbeiten, die bei blockiertem Standardmodell versucht werden",
 	"cmd:fast:d": "Prioritäts-Service-Tier umschalten (OpenAI service_tier=priority, Anthropic speed=fast)",
 	"cmd:export:d": "Sitzung in HTML-Datei exportieren",
 	"cmd:dump:d": "Sitzungstranskript in die Zwischenablage kopieren",

package/src/i18n/messages/de.ts

@@ -15,6 +15,8 @@ export const de: Partial<Record<MsgKey, string>> = {
 	"welcome.noSessions": "Keine gespeicherten Verläufe",
 	"welcome.allSessions": "{key} alle Sitzungen",
 	"welcome.continue": "{key} fortsetzen",
+	"welcome.pick": "{key} wählen",
+	"welcome.pickActive": "↑↓ bewegen · ⏎ öffnen · esc zurück",
 	"welcome.sessions": "Sitzungen",
 	"welcome.chooseModel": "Modell auswählen",
 	"welcome.modelHint": "ctrl+l zum Auswählen · / für Befehle",

package/src/i18n/messages/en.ts

@@ -20,6 +20,8 @@ export const en = {
 	"welcome.noSessions": "No saved sessions",
 	"welcome.allSessions": "{key} all sessions",
 	"welcome.continue": "{key} continue",
+	"welcome.pick": "{key} pick",
+	"welcome.pickActive": "↑↓ move · ⏎ open · esc back",
 	"welcome.sessions": "sessions",
 	"welcome.chooseModel": "choose a model",
 	"welcome.modelHint": "ctrl+l to pick · / for commands",

package/src/i18n/messages/es.settings.ts

@@ -216,6 +216,31 @@ export const esSettings: Record<string, string> = {
 	"set:task.serviceTier:o:claude-only:l": "Prioridad (solo Claude)",
 	"set:task.serviceTier:o:claude-only:d":
 		"Modo rápido de Anthropic en solicitudes directas de Claude; se ignora en el resto (incl. Bedrock/Vertex)",
+	"set:fallback.maxAttempts:l": "Intentos de reserva por modelo",
+	"set:fallback.maxAttempts:d":
+		"Intentos por cada modelo de la cadena de reserva (incluido el primero) antes de pasar al siguiente. Los modelos sin credenciales se omiten de inmediato.",
+	"set:fallback.maxAttempts:o:1:l": "1 intento",
+	"set:fallback.maxAttempts:o:2:l": "2 intentos",
+	"set:fallback.maxAttempts:o:3:l": "3 intentos",
+	"set:fallback.maxAttempts:o:5:l": "5 intentos",
+	"set:fallback.auto:l": "Reserva automática de modelo",
+	"set:fallback.auto:d":
+		"Si el modelo predeterminado está bloqueado (sin sesión, cuota, errores de autenticación o servidor), continúa con un modelo de otro proveedor con sesión iniciada. /fallback muestra la cadena.",
+	"set:auth.credentialRankingMode:l": "Orden de varias cuentas",
+	"set:auth.credentialRankingMode:d":
+		"Qué cuenta con sesión iniciada de un proveedor usa una sesión nueva. Una cuenta bloqueada o agotada siempre cede el paso a la siguiente.",
+	"set:auth.credentialRankingMode:o:balanced:l": "Equilibrado",
+	"set:auth.credentialRankingMode:o:balanced:d":
+		"Primero la cuenta menos usada; reparte la carga y deja margen en cada cuenta",
+	"set:auth.credentialRankingMode:o:earliest-reset:l": "Reinicio más próximo",
+	"set:auth.credentialRankingMode:o:earliest-reset:d":
+		"Primero la cuenta cuya ventana de uso se reinicia antes, para no perder cuota al reiniciarse",
+	"set:locate.enabled:l": "Locate (búsqueda de código con Jev)",
+	"set:locate.enabled:d":
+		"Ofrece la herramienta locate cuando hay una clave de TypeSafe guardada. Para juzgar la relevancia envía a TypeSafe rutas de carpetas, nombres de archivo y líneas de declaración (sin cuerpos de función ni comentarios).",
+	"set:startup.welcomeMouse:l": "Tarjeta de inicio clicable",
+	"set:startup.welcomeMouse:d":
+		"Hasta el primer prompt, captura el ratón para abrir una sesión reciente de la tarjeta de inicio con un clic. Mientras tanto, selecciona texto del terminal con Mayús pulsada. Desactivado: abre con ↓ y Enter.",
 	"set:retry.maxRetries:l": "Intentos de reintento",
 	"set:retry.maxRetries:d": "Número máximo de reintentos ante errores de la API",
 	"set:retry.maxRetries:o:1:l": "1 reintento",
@@ -766,6 +791,7 @@ export const esSettings: Record<string, string> = {
 	"set:searxng.endpoint:l": "Endpoint de SearXNG",
 	"set:searxng.endpoint:d": "URL base de búsqueda autohospedada",
 	"cmd:model:d": "Seleccionar modelo (abre la interfaz de selección)",
+	"cmd:fallback:d": "Ver o editar los modelos que se prueban cuando el modelo predeterminado está bloqueado",
 	"cmd:fast:d": "Alternar el nivel de servicio prioritario (OpenAI service_tier=priority, Anthropic speed=fast)",
 	"cmd:export:d": "Exportar sesión a archivo HTML",
 	"cmd:dump:d": "Copiar la transcripción de la sesión al portapapeles",

package/src/i18n/messages/es.ts

@@ -15,6 +15,8 @@ export const es: Partial<Record<MsgKey, string>> = {
 	"welcome.noSessions": "Sin historiales guardados",
 	"welcome.allSessions": "{key} todas las sesiones",
 	"welcome.continue": "{key} continuar",
+	"welcome.pick": "{key} elegir",
+	"welcome.pickActive": "↑↓ mover · ⏎ abrir · esc volver",
 	"welcome.sessions": "sesiones",
 	"welcome.chooseModel": "elige un modelo",
 	"welcome.modelHint": "ctrl+l para elegir · / para comandos",

package/src/i18n/messages/fr.settings.ts

@@ -216,6 +216,31 @@ export const frSettings: Record<string, string> = {
 	"set:task.serviceTier:o:claude-only:l": "Priorité (Claude uniquement)",
 	"set:task.serviceTier:o:claude-only:d":
 		"Mode rapide d'Anthropic sur les requêtes Claude directes ; ignoré ailleurs (y compris Bedrock/Vertex)",
+	"set:fallback.maxAttempts:l": "Tentatives de repli par modèle",
+	"set:fallback.maxAttempts:d":
+		"Nombre d'essais de chaque modèle de la chaîne de repli (y compris le premier) avant de passer au suivant. Un modèle sans identifiants est ignoré aussitôt.",
+	"set:fallback.maxAttempts:o:1:l": "1 essai",
+	"set:fallback.maxAttempts:o:2:l": "2 essais",
+	"set:fallback.maxAttempts:o:3:l": "3 essais",
+	"set:fallback.maxAttempts:o:5:l": "5 essais",
+	"set:fallback.auto:l": "Repli automatique de modèle",
+	"set:fallback.auto:d":
+		"Si le modèle par défaut est bloqué (pas de connexion, quota, erreurs d'authentification ou serveur), continuer avec un modèle d'un autre fournisseur connecté. /fallback affiche la chaîne.",
+	"set:auth.credentialRankingMode:l": "Ordre des comptes multiples",
+	"set:auth.credentialRankingMode:d":
+		"Quel compte connecté d'un fournisseur une nouvelle session utilise. Un compte bloqué ou épuisé passe toujours la main au suivant.",
+	"set:auth.credentialRankingMode:o:balanced:l": "Équilibré",
+	"set:auth.credentialRankingMode:o:balanced:d":
+		"Le compte le moins utilisé d'abord ; répartit la charge et garde de la marge sur chaque compte",
+	"set:auth.credentialRankingMode:o:earliest-reset:l": "Réinitialisation la plus proche",
+	"set:auth.credentialRankingMode:o:earliest-reset:d":
+		"Le compte dont la fenêtre d'utilisation se réinitialise le plus tôt d'abord, pour ne pas perdre de quota",
+	"set:locate.enabled:l": "Locate (recherche de code Jev)",
+	"set:locate.enabled:d":
+		"Propose l'outil locate quand une clé TypeSafe est enregistrée. Pour juger la pertinence, il envoie à TypeSafe les chemins de dossiers, les noms de fichiers et les lignes de déclaration (sans corps de fonctions ni commentaires).",
+	"set:startup.welcomeMouse:l": "Carte de démarrage cliquable",
+	"set:startup.welcomeMouse:d":
+		"Jusqu'au premier prompt, capturer la souris pour ouvrir une session récente de la carte de démarrage d'un clic. Sélectionnez le texte du terminal avec Maj enfoncée en attendant. Désactivé : ouvrir avec ↓ et Entrée.",
 	"set:retry.maxRetries:l": "Tentatives de nouvel essai",
 	"set:retry.maxRetries:d": "Nombre maximal de nouvelles tentatives en cas d'erreurs API",
 	"set:retry.maxRetries:o:1:l": "1 nouvel essai",
@@ -738,6 +763,7 @@ export const frSettings: Record<string, string> = {
 	"set:searxng.endpoint:l": "Point de terminaison SearXNG",
 	"set:searxng.endpoint:d": "URL de base de recherche auto-hébergée",
 	"cmd:model:d": "Sélectionner le modèle (ouvre l'interface de sélection)",
+	"cmd:fallback:d": "Afficher ou modifier les modèles essayés quand le modèle par défaut est bloqué",
 	"cmd:fast:d":
 		"Activer/désactiver le niveau de service prioritaire (OpenAI service_tier=priority, Anthropic speed=fast)",
 	"cmd:export:d": "Exporter la session vers un fichier HTML",

package/src/i18n/messages/fr.ts

@@ -15,6 +15,8 @@ export const fr: Partial<Record<MsgKey, string>> = {
 	"welcome.noSessions": "Aucun historique enregistré",
 	"welcome.allSessions": "{key} toutes les sessions",
 	"welcome.continue": "{key} reprendre",
+	"welcome.pick": "{key} choisir",
+	"welcome.pickActive": "↑↓ déplacer · ⏎ ouvrir · esc retour",
 	"welcome.sessions": "sessions",
 	"welcome.chooseModel": "choisir un modèle",
 	"welcome.modelHint": "ctrl+l pour choisir · / pour les commandes",

package/src/i18n/messages/ja.settings.ts

@@ -247,6 +247,31 @@ export const jaSettings: Record<string, string> = {
 	"set:task.serviceTier:o:claude-only:l": "優先度 (Claude のみ)",
 	"set:task.serviceTier:o:claude-only:d":
 		"直接の Claude リクエストに Anthropic 高速モードを適用。それ以外では無視されます (Bedrock/Vertex を含む)",
+	"set:fallback.maxAttempts:l": "モデルごとのフォールバック試行回数",
+	"set:fallback.maxAttempts:d":
+		"フォールバックチェーンの各モデル (最初のモデルを含む) を何回試してから次へ進むか。認証情報のないモデルはすぐにスキップします。",
+	"set:fallback.maxAttempts:o:1:l": "1 回",
+	"set:fallback.maxAttempts:o:2:l": "2 回",
+	"set:fallback.maxAttempts:o:3:l": "3 回",
+	"set:fallback.maxAttempts:o:5:l": "5 回",
+	"set:fallback.auto:l": "自動モデルフォールバック",
+	"set:fallback.auto:d":
+		"既定モデルが使えないとき (未ログイン、上限、認証・サーバーエラー)、ログイン済みの別プロバイダーのモデルで続行します。/fallback でチェーンを確認できます。",
+	"set:auth.credentialRankingMode:l": "複数アカウントの順序",
+	"set:auth.credentialRankingMode:d":
+		"プロバイダーにログイン済みのアカウントのうち、新しいセッションがどれを使うか。ブロック・上限到達のアカウントは常に次へ回ります。",
+	"set:auth.credentialRankingMode:o:balanced:l": "バランス",
+	"set:auth.credentialRankingMode:o:balanced:d":
+		"使用量が最も少ないアカウントから。負荷を分散し、すべてのアカウントに余裕を残します",
+	"set:auth.credentialRankingMode:o:earliest-reset:l": "リセットが早い順",
+	"set:auth.credentialRankingMode:o:earliest-reset:d":
+		"使用量ウィンドウが最も早くリセットされるアカウントから。リセットで失われる枠を先に使います",
+	"set:locate.enabled:l": "Locate (Jev コード検索)",
+	"set:locate.enabled:d":
+		"TypeSafe キーがあるとき locate ツールを提供します。関連性の判定のため、フォルダパス、ファイル名、宣言行 (関数本体・コメントは除く) を TypeSafe に送ります。",
+	"set:startup.welcomeMouse:l": "クリックできる起動カード",
+	"set:startup.welcomeMouse:d":
+		"最初のプロンプトまでマウスを受け取り、起動カードの最近のセッションをワンクリックで開きます。その間の端末テキスト選択は Shift を押しながら行います。オフでは ↓ と Enter で開きます。",
 	"set:retry.maxRetries:l": "リトライ回数",
 	"set:retry.maxRetries:d": "API エラー時の最大リトライ回数",
 	"set:retry.maxRetries:o:1:l": "1 回リトライ",
@@ -779,6 +804,7 @@ export const jaSettings: Record<string, string> = {
 	"cmd:theme:d": "テーマセレクターを開く",
 	"cmd:goal:d": "ゴールモードを切り替え（このセッションの永続的な自律目標）",
 	"cmd:model:d": "モデルを選択（セレクター UI を開く）",
+	"cmd:fallback:d": "既定モデルが使えないときに試すモデルを表示・編集",
 	"cmd:fast:d": "優先サービスティアを切り替え（OpenAI service_tier=priority、Anthropic speed=fast）",
 	"cmd:export:d": "セッションを HTML ファイルにエクスポート",
 	"cmd:dump:d": "セッションのトランスクリプトをクリップボードにコピー",

package/src/i18n/messages/ja.ts

@@ -12,6 +12,8 @@ export const ja: Partial<Record<MsgKey, string>> = {
 	"welcome.noSessions": "保存されたセッションなし",
 	"welcome.allSessions": "{key} すべて表示",
 	"welcome.continue": "{key} 続ける",
+	"welcome.pick": "{key} 選択",
+	"welcome.pickActive": "↑↓ 移動 · ⏎ 開く · esc 戻る",
 	"welcome.sessions": "セッション",
 	"welcome.chooseModel": "モデルを選択",
 	"welcome.modelHint": "ctrl+l で選択 · / でコマンド",

package/src/i18n/messages/ko.settings.ts

@@ -248,6 +248,30 @@ export const koSettings: Record<string, string> = {
 	"set:task.serviceTier:o:claude-only:l": "우선순위 (Claude 전용)",
 	"set:task.serviceTier:o:claude-only:d":
 		"직접 Claude 요청에 Anthropic 고속 모드 적용. 그 외에는 무시됨 (Bedrock/Vertex 포함)",
+	"set:fallback.maxAttempts:l": "모델별 폴백 시도 횟수",
+	"set:fallback.maxAttempts:d":
+		"폴백 체인의 각 모델(첫 모델 포함)을 몇 번 시도한 뒤 다음 모델로 넘어갈지. 자격 증명이 없는 모델은 바로 건너뜁니다.",
+	"set:fallback.maxAttempts:o:1:l": "1회",
+	"set:fallback.maxAttempts:o:2:l": "2회",
+	"set:fallback.maxAttempts:o:3:l": "3회",
+	"set:fallback.maxAttempts:o:5:l": "5회",
+	"set:fallback.auto:l": "자동 모델 폴백",
+	"set:fallback.auto:d":
+		"기본 모델이 막히면(로그인 없음, 한도, 인증·서버 오류) 로그인된 다른 공급자의 모델로 이어서 진행합니다. /fallback 에서 체인을 볼 수 있습니다.",
+	"set:auth.credentialRankingMode:l": "다중 계정 순서",
+	"set:auth.credentialRankingMode:d":
+		"한 공급자에 로그인된 계정 중 새 세션이 어떤 계정을 쓸지. 막히거나 한도가 찬 계정은 항상 다음 계정으로 넘어갑니다.",
+	"set:auth.credentialRankingMode:o:balanced:l": "균형",
+	"set:auth.credentialRankingMode:o:balanced:d": "가장 덜 쓴 계정부터. 부하를 나누고 모든 계정에 여유를 남깁니다",
+	"set:auth.credentialRankingMode:o:earliest-reset:l": "빨리 초기화되는 순",
+	"set:auth.credentialRankingMode:o:earliest-reset:d":
+		"사용량 구간이 가장 먼저 초기화되는 계정부터. 초기화 때 사라질 한도를 먼저 씁니다",
+	"set:locate.enabled:l": "Locate (Jev 코드 검색)",
+	"set:locate.enabled:d":
+		"TypeSafe 키가 있으면 locate 도구를 제공합니다. 관련성 판단을 위해 폴더 경로, 파일 이름, 선언 줄(함수 본문·주석 제외)을 TypeSafe로 보냅니다.",
+	"set:startup.welcomeMouse:l": "클릭 가능한 시작 카드",
+	"set:startup.welcomeMouse:d":
+		"첫 프롬프트 전까지 마우스를 받아 시작 카드의 최근 세션을 한 번 클릭으로 엽니다. 그동안 터미널 텍스트 선택은 Shift를 누른 채로 하세요. 끄면 ↓와 Enter로 엽니다.",
 	"set:retry.maxRetries:l": "재시도 횟수",
 	"set:retry.maxRetries:d": "API 오류 시 최대 재시도 횟수",
 	"set:retry.maxRetries:o:1:l": "1회 재시도",
@@ -768,6 +792,7 @@ export const koSettings: Record<string, string> = {
 	"cmd:theme:d": "테마 선택기 열기",
 	"cmd:goal:d": "목표 모드 토글 (이 세션의 지속적 자율 목표)",
 	"cmd:model:d": "모델 선택 (선택기 UI 열기)",
+	"cmd:fallback:d": "기본 모델이 막혔을 때 시도할 모델 보기·편집",
 	"cmd:fast:d": "우선순위 서비스 티어 토글 (OpenAI service_tier=priority, Anthropic speed=fast)",
 	"cmd:export:d": "세션을 HTML 파일로 내보내기",
 	"cmd:dump:d": "세션 기록을 클립보드에 복사",

package/src/i18n/messages/ko.ts

@@ -12,6 +12,8 @@ export const ko: Partial<Record<MsgKey, string>> = {
 	"welcome.noSessions": "저장된 세션 없음",
 	"welcome.allSessions": "{key} 전체 보기",
 	"welcome.continue": "{key} 이어하기",
+	"welcome.pick": "{key} 선택",
+	"welcome.pickActive": "↑↓ 이동 · ⏎ 열기 · esc 닫기",
 	"welcome.sessions": "세션",
 	"welcome.chooseModel": "모델 선택",
 	"welcome.modelHint": "ctrl+l 선택 · / 명령",