@ekzs/cli 0.3.0 → 0.3.4

package/dist/lib/commands-i18n.js

@@ -1,3 +1,4 @@
+import { formatSetupRequiredMessage } from "./setup-messages.js";
 export function providersCommandLabels(locale) {
     if (locale === "pt") {
         return {
@@ -22,15 +23,8 @@ export function providersCommandLabels(locale) {
         replAliases: ["/provider"],
     };
 }
-export function providersSetupHint(locale) {
-    const labels = providersCommandLabels(locale);
-    if (locale === "pt") {
-        return `Nenhum provider activo. Corre \`${labels.cli}\` ou \`${labels.repl}\` e cola a tua API key.`;
-    }
-    if (locale === "zh") {
-        return `未配置 provider。运行 \`${labels.cli}\` 或 \`${labels.repl}\` 并粘贴 API key。`;
-    }
-    return `No active provider. Run \`${labels.cli}\` or \`${labels.repl}\` and paste your API key.`;
+export function providersSetupHint(_locale) {
+    return formatSetupRequiredMessage();
 }
 export function isProvidersMetaCommand(token) {
     return resolveReplMetaCommand(token) === "providers";
@@ -44,6 +38,7 @@ const EN_SUBCOMMANDS = new Set([
     "fix",
     "ask",
     "providers",
+    "setup",
 ]);
 /** Map localized CLI tokens (and English) to canonical subcommand ids. */
 const CLI_ALIASES = {
@@ -76,6 +71,12 @@ const CLI_ALIASES = {
     供应商: "providers",
     提供商: "providers",
     模型: "providers",
+    setup: "setup",
+    configurar: "setup",
+    configuracao: "setup",
+    "configuração": "setup",
+    设置: "setup",
+    配置: "setup",
     诊断: "doctor",
     凭证: "health",
     扫描: "scan",
@@ -104,6 +105,7 @@ export const SPLASH_TOOLS = {
         { label: "agente", hint: "agent" },
         { label: "perguntar", hint: "ask" },
         { label: "provedores", hint: "BYOK" },
+        { label: "setup", hint: "configurar" },
     ],
     en: [
         { label: "doctor" },
@@ -114,6 +116,7 @@ export const SPLASH_TOOLS = {
         { label: "agent" },
         { label: "ask" },
         { label: "providers", hint: "BYOK" },
+        { label: "setup" },
     ],
     zh: [
         { label: "诊断", hint: "doctor" },
@@ -124,6 +127,7 @@ export const SPLASH_TOOLS = {
         { label: "代理", hint: "agent" },
         { label: "问答", hint: "ask" },
         { label: "供应商", hint: "BYOK" },
+        { label: "设置", hint: "setup" },
     ],
 };
 export function formatSplashTool(locale, tool) {
@@ -137,14 +141,19 @@ export function formatCliToolsSummary(locale) {
 }
 export function splashSessionLines(locale) {
     const p = providersCommandLabels(locale);
+    const setupLine = locale === "pt"
+        ? "ekz setup · ekz configurar"
+        : locale === "zh"
+            ? "ekz setup · ekz 设置"
+            : "ekz setup";
     const providersLine = `${p.repl} · ${p.cli}`;
     if (locale === "pt") {
-        return [providersLine, "/guardar <nome>", "/retomar · /retomar 2", "ekz --resume", "ekz --fresh"];
+        return [setupLine, providersLine, "/guardar <nome>", "/retomar · /retomar 2", "ekz --resume", "ekz --fresh"];
     }
     if (locale === "zh") {
-        return [providersLine, "/保存 <名称>", "/恢复 · /恢复 2", "ekz --resume", "ekz --fresh"];
+        return [setupLine, providersLine, "/保存 <名称>", "/恢复 · /恢复 2", "ekz --resume", "ekz --fresh"];
     }
-    return [providersLine, "/save <name>", "/resume · /resume 2", "ekz --resume", "ekz --fresh"];
+    return [setupLine, providersLine, "/save <name>", "/resume · /resume 2", "ekz --resume", "ekz --fresh"];
 }
 export function splashHelpHint(locale) {
     if (locale === "pt")

package/dist/lib/global-config.d.ts

@@ -0,0 +1,19 @@
+import type { EkzLocale } from "./locale.js";
+export type EkzGlobalConfig = {
+    locale?: EkzLocale;
+    userName?: string;
+    /** User chose offline mode (no LLM provider). */
+    offline?: boolean;
+    setupComplete?: boolean;
+};
+export declare function globalConfigPath(): string;
+export declare function loadGlobalConfig(): EkzGlobalConfig;
+export declare function saveGlobalConfig(patch: Partial<EkzGlobalConfig>): void;
+export declare function getGlobalLocale(): EkzLocale | undefined;
+export declare function getGlobalUserName(): string | undefined;
+export declare function isGlobalOffline(): boolean;
+export declare function setGlobalOffline(offline: boolean): void;
+export declare function clearGlobalOffline(): void;
+export declare function isSetupComplete(): boolean;
+export declare function markSetupComplete(): void;
+//# sourceMappingURL=global-config.d.ts.map

package/dist/lib/global-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-config.d.ts","sourceRoot":"","sources":["../../src/lib/global-config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7C,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAMF,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,wBAAgB,gBAAgB,IAAI,eAAe,CAQlD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,eAAe,CAAC,QAI/D;AAED,wBAAgB,eAAe,IAAI,SAAS,GAAG,SAAS,CAGvD;AAED,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,SAAS,CAEtD;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,QAEhD;AAED,wBAAgB,kBAAkB,SAGjC;AAED,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,wBAAgB,iBAAiB,SAEhC"}

package/dist/lib/global-config.js

@@ -0,0 +1,52 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+const EKZ_HOME = join(homedir(), ".ekz");
+const CONFIG_PATH = join(EKZ_HOME, "config.json");
+function ensureEkzHome() {
+    if (!existsSync(EKZ_HOME))
+        mkdirSync(EKZ_HOME, { recursive: true, mode: 0o700 });
+}
+export function globalConfigPath() {
+    return CONFIG_PATH;
+}
+export function loadGlobalConfig() {
+    ensureEkzHome();
+    if (!existsSync(CONFIG_PATH))
+        return {};
+    try {
+        return JSON.parse(readFileSync(CONFIG_PATH, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+export function saveGlobalConfig(patch) {
+    ensureEkzHome();
+    const next = { ...loadGlobalConfig(), ...patch };
+    writeFileSync(CONFIG_PATH, JSON.stringify(next, null, 2) + "\n", { mode: 0o600 });
+}
+export function getGlobalLocale() {
+    const l = loadGlobalConfig().locale;
+    return l === "pt" || l === "en" || l === "zh" ? l : undefined;
+}
+export function getGlobalUserName() {
+    return loadGlobalConfig().userName?.trim() || undefined;
+}
+export function isGlobalOffline() {
+    return loadGlobalConfig().offline === true;
+}
+export function setGlobalOffline(offline) {
+    saveGlobalConfig({ offline, setupComplete: true });
+}
+export function clearGlobalOffline() {
+    const cfg = loadGlobalConfig();
+    if (cfg.offline)
+        saveGlobalConfig({ offline: false });
+}
+export function isSetupComplete() {
+    return loadGlobalConfig().setupComplete === true;
+}
+export function markSetupComplete() {
+    saveGlobalConfig({ setupComplete: true });
+}

package/dist/lib/help.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/lib/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAGtD,KAAK,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAatD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,CA4HzF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,OAAO,QAezE"}
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/lib/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAGtD,KAAK,WAAW,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAatD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,WAAW,EAAE,CA+HzF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,EAAE,OAAO,QAezE"}

package/dist/lib/help.js

@@ -44,6 +44,7 @@ export function buildHelpSections(locale, currentMode) {
         ? [
             "Escreve perguntas ou tarefas em linguagem natural.",
             `${p.repl} · ${p.cli} (BYOK)`,
+            "ekz setup · ekz configurar",
             "/ajuda · /help",
             "/modo agente|plan|ask · /mode agent|plan|ask",
             "/idioma pt · /lang pt|en|zh",
@@ -55,6 +56,7 @@ export function buildHelpSections(locale, currentMode) {
             ? [
                 "用自然语言提问或描述任务。",
                 `${p.repl} · ${p.cli} (BYOK)`,
+                "ekz setup · ekz 设置",
                 "/帮助 · /help · /ajuda",
                 "/模式 代理|plan|ask · /mode agent|plan|ask",
                 "/语言 pt · /lang pt|en|zh",
@@ -65,6 +67,7 @@ export function buildHelpSections(locale, currentMode) {
             : [
                 "Type questions or tasks in natural language.",
                 `${p.repl} · ${p.cli} (BYOK)`,
+                "ekz setup",
                 "/help · /ajuda · /帮助",
                 "/mode agent|plan|ask",
                 "/lang pt · /lang en · /lang zh",

package/dist/lib/locale.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/lib/locale.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAInD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAIlD,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAOnE;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAE3F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAgB7D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS;;;;;;;;;;;;;;;;;;;sBAqBnB,MAAM;;;;;;;;;;EA4H7B"}
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../src/lib/locale.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE3C,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAInD,CAAC;AAEF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAIlD,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAOnE;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAE3F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAgB7D;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS;;;;;;;;;;;;;;;;;;;sBAqBnB,MAAM;;;;;;;;;;EA4H7B"}

package/dist/lib/locale.js

@@ -1,3 +1,4 @@
+import { getGlobalLocale } from "./global-config.js";
 export const LOCALE_LABELS = {
     pt: "Português (Angola)",
     en: "English",
@@ -22,7 +23,7 @@ export function parseLocale(input) {
 }
 /** Default: Portuguese (Angola). Override with EKZ_LANG or --lang. */
 export function resolveLocale(explicit, saved) {
-    return parseLocale(explicit) ?? parseLocale(process.env.EKZ_LANG) ?? saved ?? "pt";
+    return parseLocale(explicit) ?? parseLocale(process.env.EKZ_LANG) ?? saved ?? getGlobalLocale() ?? "pt";
 }
 export function languageInstruction(locale) {
     if (locale === "pt") {

package/dist/lib/onboarding.d.ts

@@ -0,0 +1,20 @@
+import { type EkzLocale } from "./locale.js";
+import { type ResolvedCredentials } from "./providers/credentials.js";
+export type AgentReadyState = {
+    offline: boolean;
+    creds: ResolvedCredentials | null;
+};
+export declare function offlineModelLabel(locale: EkzLocale): string;
+/** Full first-run wizard: language → name → provider/offline. */
+export declare function runSetupWizard(opts?: {
+    locale?: string;
+    force?: boolean;
+}): Promise<void>;
+/** Ensures the agent can start — provider, offline, or throws setup hint. */
+export declare function ensureAgentReady(options: {
+    locale: EkzLocale;
+    offlineFlag?: boolean;
+    apiKey?: string;
+}): Promise<AgentReadyState>;
+export declare function offlineAgentHint(locale: EkzLocale): string;
+//# sourceMappingURL=onboarding.d.ts.map

package/dist/lib/onboarding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding.d.ts","sourceRoot":"","sources":["../../src/lib/onboarding.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,KAAK,SAAS,EAAe,MAAM,aAAa,CAAC;AAG1D,OAAO,EAIL,KAAK,mBAAmB,EACzB,MAAM,4BAA4B,CAAC;AAyBpC,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAI3D;AAoFD,iEAAiE;AACjE,wBAAsB,cAAc,CAAC,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,iBA6B/E;AAED,6EAA6E;AAC7E,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,MAAM,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,eAAe,CAAC,CAgB3B;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAQ1D"}

package/dist/lib/onboarding.js

@@ -0,0 +1,129 @@
+import readline from "readline";
+import { providersCommandLabels } from "./commands-i18n.js";
+import { markSetupComplete, saveGlobalConfig, setGlobalOffline, clearGlobalOffline, isGlobalOffline, } from "./global-config.js";
+import { parseLocale } from "./locale.js";
+import { formatSetupRequiredMessage } from "./setup-messages.js";
+import { info, ok } from "./output.js";
+import { ProviderSetupError, resolveActiveCredentials, resolveCredentialsWithOverride, } from "./providers/credentials.js";
+import { runSetupProviderWizard } from "./providers/ui.js";
+import { c, muted } from "./theme.js";
+function t(locale, pt, en, zh) {
+    if (locale === "pt")
+        return pt;
+    if (locale === "zh")
+        return zh;
+    return en;
+}
+async function askLine(prompt) {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim());
+        });
+    });
+}
+function hasProvider(apiKey) {
+    if (apiKey?.trim())
+        return true;
+    return Boolean(resolveActiveCredentials());
+}
+export function offlineModelLabel(locale) {
+    if (locale === "pt")
+        return "offline · doctor/scan";
+    if (locale === "zh")
+        return "离线 · 诊断/扫描";
+    return "offline · doctor/scan";
+}
+async function pickLanguage() {
+    console.log("");
+    console.log(`  ${c.bold}Ekz Connect — Setup${c.reset}`);
+    console.log("");
+    console.log(`  ${muted("Choose language · Escolhe idioma · 选择语言")}`);
+    console.log("");
+    console.log(`  ${c.bold}1.${c.reset} Português`);
+    console.log(`  ${c.bold}2.${c.reset} English`);
+    console.log(`  ${c.bold}3.${c.reset} 中文`);
+    console.log("");
+    const choice = (await askLine("  [1/2/3]: ")).toLowerCase();
+    if (choice === "2" || choice === "en" || choice === "english")
+        return "en";
+    if (choice === "3" || choice === "zh" || choice === "中文")
+        return "zh";
+    return "pt";
+}
+async function askUserName(locale) {
+    console.log("");
+    const prompt = t(locale, "Como devo te chamar? ", "What should we call you? (first name): ", "怎么称呼您？(名字): ");
+    const name = await askLine(`  ${prompt}`);
+    if (!name)
+        return t(locale, "Developer", "Developer", "开发者");
+    return name.split(/\s+/)[0] ?? name;
+}
+async function providerStep(locale) {
+    const p = providersCommandLabels(locale);
+    console.log("");
+    console.log(`  ${muted(t(locale, "LLM (BYOK) — opcional agora", "LLM (BYOK) — optional for now", "LLM (BYOK) — 可选"))}`);
+    console.log("");
+    console.log(`  ${c.bold}1.${c.reset} ${t(locale, "Configurar provedor", "Configure provider", "配置 provider")}`);
+    console.log(`     ${muted(t(locale, p.cli, p.cli, p.cli))}`);
+    console.log("");
+    console.log(`  ${c.bold}2.${c.reset} ${t(locale, "Continuar offline", "Continue offline", "离线模式")}`);
+    console.log(`     ${muted(t(locale, "doctor · scan · sem AI", "doctor · scan · no AI", "诊断 · 扫描 · 无 AI"))}`);
+    console.log("");
+    console.log(`  ${muted("Enter · skip")}`);
+    console.log("");
+    const choice = (await askLine(t(locale, "  Escolha [1/2/Enter]: ", "  Choice [1/2/Enter]: ", "  选择 [1/2/Enter]: "))).toLowerCase();
+    if (choice === "2" || choice === "offline" || choice === "离线") {
+        setGlobalOffline(true);
+        ok(t(locale, "Modo offline activo.", "Offline mode enabled.", "已启用离线模式。"));
+        return "offline";
+    }
+    if (choice === "1" || choice === "p" || choice === "providers" || choice === "provedores" || choice === "供应商") {
+        const configured = await runSetupProviderWizard(locale);
+        if (configured && resolveActiveCredentials()) {
+            clearGlobalOffline();
+            ok(t(locale, "Provedor configurado.", "Provider configured.", "Provider 已配置。"));
+            return "configured";
+        }
+        info(t(locale, "Provedor não configurado.", "No provider configured.", "未配置 provider。"));
+        return "skip";
+    }
+    return "skip";
+}
+/** Full first-run wizard: language → name → provider/offline. */
+export async function runSetupWizard(opts) {
+    if (!process.stdin.isTTY) {
+        console.error(formatSetupRequiredMessage());
+        process.exitCode = 1;
+        return;
+    }
+    let locale = parseLocale(opts?.locale) ?? (await pickLanguage());
+    saveGlobalConfig({ locale });
+    const userName = await askUserName(locale);
+    saveGlobalConfig({ userName });
+    ok(t(locale, `Olá ${userName}!`, `Hello ${userName}!`, `你好 ${userName}!`));
+    await providerStep(locale);
+    markSetupComplete();
+    console.log("");
+    ok(t(locale, "Setup concluído. Corre `ekz` para começar.", "Setup complete. Run `ekz` to start.", "设置完成。运行 `ekz` 开始。"));
+}
+/** Ensures the agent can start — provider, offline, or throws setup hint. */
+export async function ensureAgentReady(options) {
+    const { locale, offlineFlag, apiKey } = options;
+    if (offlineFlag || isGlobalOffline()) {
+        return { offline: true, creds: null };
+    }
+    if (hasProvider(apiKey)) {
+        clearGlobalOffline();
+        if (apiKey?.trim()) {
+            return { offline: false, creds: resolveCredentialsWithOverride(apiKey, locale) };
+        }
+        return { offline: false, creds: resolveActiveCredentials() };
+    }
+    throw new ProviderSetupError(formatSetupRequiredMessage());
+}
+export function offlineAgentHint(locale) {
+    const p = providersCommandLabels(locale);
+    return t(locale, `Modo offline — sem AI. Usa \`ekz setup\`, ${p.repl}, /diagnóstico ou /analisar.`, `Offline mode — no AI. Use \`ekz setup\`, ${p.repl}, /doctor, or /scan.`, `离线模式 — 无 AI。使用 \`ekz setup\`、${p.repl}、/诊断 或 /扫描。`);
+}

package/dist/lib/providers/catalog.d.ts

@@ -5,11 +5,16 @@ export type ProviderDefinition = {
     name: string;
     kind: ProviderKind;
     description: string;
+    /** Default model when user presses Enter */
     defaultModel: string;
+    /** Predefined API base — never shown in UI */
     defaultBaseUrl?: string;
+    /** Selectable models in setup / providers menu */
+    models: string[];
     keyHint: string;
     docsUrl: string;
 };
 export declare const PROVIDER_CATALOG: ProviderDefinition[];
 export declare function getProviderDefinition(id: string): ProviderDefinition | undefined;
+export declare function resolveProviderModel(def: ProviderDefinition, storedModel?: string): string;
 //# sourceMappingURL=catalog.d.ts.map

package/dist/lib/providers/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,mBAAmB,GAAG,WAAW,CAAC;AAExE,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,UAAU,GACV,MAAM,GACN,MAAM,GACN,SAAS,GACT,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EAyFhD,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEhF"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,mBAAmB,GAAG,WAAW,CAAC;AAExE,MAAM,MAAM,UAAU,GAClB,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,UAAU,GACV,MAAM,GACN,MAAM,GACN,SAAS,GACT,QAAQ,GACR,QAAQ,CAAC;AAEb,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kDAAkD;IAClD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,eAAO,MAAM,gBAAgB,EAAE,kBAAkB,EAkHhD,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAEhF;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,kBAAkB,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAK1F"}

package/dist/lib/providers/catalog.js

@@ -5,6 +5,19 @@ export const PROVIDER_CATALOG = [
         kind: "cursor",
         description: "Composer local agent (@cursor/sdk)",
         defaultModel: "composer-2.5-fast",
+        models: [
+            "composer-2.5-fast",
+            "composer-2-fast",
+            "composer-2.5",
+            "composer-2",
+            "claude-4.6-sonnet-medium-thinking",
+            "claude-opus-4-7-thinking-xhigh",
+            "gemini-3-flash",
+            "gemini-3.1-pro",
+            "gpt-5.3-codex",
+            "gpt-5.5-medium",
+            "kimi-k2.5",
+        ],
         keyHint: "crsr_…",
         docsUrl: "https://cursor.com/dashboard/integrations",
     },
@@ -15,6 +28,7 @@ export const PROVIDER_CATALOG = [
         description: "GPT-4o, o-series",
         defaultModel: "gpt-4o",
         defaultBaseUrl: "https://api.openai.com/v1",
+        models: ["gpt-4o", "gpt-4o-mini", "gpt-4.1", "gpt-4.1-mini", "o1", "o1-mini", "o3-mini"],
         keyHint: "sk-…",
         docsUrl: "https://platform.openai.com/api-keys",
     },
@@ -24,6 +38,11 @@ export const PROVIDER_CATALOG = [
         kind: "anthropic",
         description: "Claude Sonnet / Opus",
         defaultModel: "claude-sonnet-4-20250514",
+        models: [
+            "claude-sonnet-4-20250514",
+            "claude-opus-4-20250514",
+            "claude-3-5-haiku-20241022",
+        ],
         keyHint: "sk-ant-…",
         docsUrl: "https://console.anthropic.com/settings/keys",
     },
@@ -34,6 +53,7 @@ export const PROVIDER_CATALOG = [
         description: "DeepSeek Chat / Reasoner",
         defaultModel: "deepseek-chat",
         defaultBaseUrl: "https://api.deepseek.com",
+        models: ["deepseek-chat", "deepseek-reasoner"],
         keyHint: "sk-…",
         docsUrl: "https://platform.deepseek.com/api_keys",
     },
@@ -44,6 +64,7 @@ export const PROVIDER_CATALOG = [
         description: "Moonshot AI",
         defaultModel: "moonshot-v1-8k",
         defaultBaseUrl: "https://api.moonshot.cn/v1",
+        models: ["moonshot-v1-8k", "moonshot-v1-32k", "moonshot-v1-128k"],
         keyHint: "sk-…",
         docsUrl: "https://platform.moonshot.cn/console/api-keys",
     },
@@ -54,6 +75,7 @@ export const PROVIDER_CATALOG = [
         description: "Fast inference",
         defaultModel: "llama-3.3-70b-versatile",
         defaultBaseUrl: "https://api.groq.com/openai/v1",
+        models: ["llama-3.3-70b-versatile", "llama-3.1-8b-instant", "mixtral-8x7b-32768"],
         keyHint: "gsk_…",
         docsUrl: "https://console.groq.com/keys",
     },
@@ -64,6 +86,7 @@ export const PROVIDER_CATALOG = [
         description: "Mistral Large",
         defaultModel: "mistral-large-latest",
         defaultBaseUrl: "https://api.mistral.ai/v1",
+        models: ["mistral-large-latest", "mistral-small-latest", "codestral-latest"],
         keyHint: "…",
         docsUrl: "https://console.mistral.ai/api-keys",
     },
@@ -71,9 +94,10 @@ export const PROVIDER_CATALOG = [
         id: "google",
         name: "Google Gemini",
         kind: "openai-compatible",
-        description: "Gemini via OpenAI-compatible endpoint",
+        description: "Gemini models",
         defaultModel: "gemini-2.0-flash",
         defaultBaseUrl: "https://generativelanguage.googleapis.com/v1beta/openai",
+        models: ["gemini-2.0-flash", "gemini-2.0-flash-lite", "gemini-1.5-pro", "gemini-1.5-flash"],
         keyHint: "AI…",
         docsUrl: "https://aistudio.google.com/apikey",
     },
@@ -84,6 +108,7 @@ export const PROVIDER_CATALOG = [
         description: "Local models",
         defaultModel: "llama3.2",
         defaultBaseUrl: "http://127.0.0.1:11434/v1",
+        models: ["llama3.2", "llama3.1", "qwen2.5", "mistral", "deepseek-r1"],
         keyHint: "ollama (optional)",
         docsUrl: "https://ollama.com",
     },
@@ -91,3 +116,11 @@ export const PROVIDER_CATALOG = [
 export function getProviderDefinition(id) {
     return PROVIDER_CATALOG.find((p) => p.id === id);
 }
+export function resolveProviderModel(def, storedModel) {
+    const trimmed = storedModel?.trim();
+    if (trimmed && def.models.includes(trimmed))
+        return trimmed;
+    if (trimmed && !def.models.includes(trimmed))
+        return trimmed;
+    return def.defaultModel;
+}

package/dist/lib/providers/credentials.d.ts

@@ -1,4 +1,5 @@
 import { type ProviderDefinition, type ProviderId } from "./catalog.js";
+import type { EkzLocale } from "../locale.js";
 import { type StoredProvider } from "./store.js";
 export type ResolvedCredentials = {
     id: ProviderId;
@@ -23,4 +24,5 @@ export declare function getActiveProviderId(): ProviderId | undefined;
 export declare function resolveActiveCredentials(): ResolvedCredentials | null;
 export declare function requireActiveCredentials(locale?: "pt" | "en" | "zh"): ResolvedCredentials;
 export declare function isCursorProvider(creds: ResolvedCredentials): boolean;
+export declare function resolveCredentialsWithOverride(override?: string, locale?: EkzLocale): ResolvedCredentials;
 //# sourceMappingURL=credentials.d.ts.map

package/dist/lib/providers/credentials.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1F,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,UAAU,CAAC;IACf,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAYhD;AAED,wBAAgB,mBAAmB,IAAI,UAAU,GAAG,SAAS,CAE5D;AAED,wBAAgB,wBAAwB,IAAI,mBAAmB,GAAG,IAAI,CAgBrE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,GAAE,IAAI,GAAG,IAAI,GAAG,IAAW,GAAG,mBAAmB,CAI/F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAEpE"}
+{"version":3,"file":"credentials.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,KAAK,kBAAkB,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAGjH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAKL,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,mBAAmB,GAAG;IAChC,EAAE,EAAE,UAAU,CAAC;IACf,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,wBAAgB,gBAAgB,IAAI,WAAW,EAAE,CAYhD;AAED,wBAAgB,mBAAmB,IAAI,UAAU,GAAG,SAAS,CAE5D;AAED,wBAAgB,wBAAwB,IAAI,mBAAmB,GAAG,IAAI,CAgBrE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,GAAE,IAAI,GAAG,IAAI,GAAG,IAAW,GAAG,mBAAmB,CAI/F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAEpE;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,GAAE,SAAgB,GACvB,mBAAmB,CAarB"}

package/dist/lib/providers/credentials.js

@@ -1,5 +1,6 @@
-import { PROVIDER_CATALOG } from "./catalog.js";
-import { providersSetupHint } from "../commands-i18n.js";
+import { PROVIDER_CATALOG, getProviderDefinition } from "./catalog.js";
+import { formatSetupRequiredMessage } from "../setup-messages.js";
+import { resolveComposerModel } from "../composer-model.js";
 import { loadProvidersFile, maskApiKey, resolveBaseUrl, resolveModel, } from "./store.js";
 export class ProviderSetupError extends Error {
     constructor(message) {
@@ -47,8 +48,23 @@ export function requireActiveCredentials(locale = "en") {
     const creds = resolveActiveCredentials();
     if (creds)
         return creds;
-    throw new ProviderSetupError(providersSetupHint(locale));
+    throw new ProviderSetupError(formatSetupRequiredMessage());
 }
 export function isCursorProvider(creds) {
     return creds.definition.kind === "cursor";
 }
+export function resolveCredentialsWithOverride(override, locale = "en") {
+    if (override?.trim()) {
+        const def = getProviderDefinition("cursor");
+        if (!def)
+            throw new Error("Cursor provider missing from catalog.");
+        return {
+            id: "cursor",
+            definition: def,
+            apiKey: override.trim(),
+            model: resolveComposerModel().id,
+            maskedKey: maskApiKey(override.trim()),
+        };
+    }
+    return requireActiveCredentials(locale);
+}

package/dist/lib/providers/cursor-runner.d.ts

@@ -1,8 +1,8 @@
-import { type SDKAgent } from "@cursor/sdk";
 import { type EkzLocale } from "../locale.js";
+import { type SDKAgent } from "./cursor-sdk.js";
 import { type ResolvedCredentials } from "./credentials.js";
 declare function disposeAgent(agent: SDKAgent): Promise<void>;
-declare function streamRun(agent: SDKAgent, prompt: string): Promise<void>;
+declare function streamRun(agent: SDKAgent, prompt: string, locale: EkzLocale): Promise<void>;
 export declare function executeCursorAskTurn(options: {
     cwd: string;
     question: string;

package/dist/lib/providers/cursor-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/cursor-runner.ts"],"names":[],"mappings":"AACA,OAAO,EAA2C,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAIrF,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,iBAAe,YAAY,CAAC,KAAK,EAAE,QAAQ,iBAI1C;AAED,iBAAe,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkCvE;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAkCnB;AAED,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC"}
+{"version":3,"file":"cursor-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/cursor-runner.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,cAAc,CAAC;AAInE,OAAO,EAAiB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,iBAAe,YAAY,CAAC,KAAK,EAAE,QAAQ,iBAI1C;AAED,iBAAe,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAmC1F;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAmCnB;AAED,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC"}

package/dist/lib/providers/cursor-runner.js

@@ -1,11 +1,11 @@
 import { resolve } from "path";
-import { Agent, AgentBusyError, CursorAgentError } from "@cursor/sdk";
 import { buildBootstrapContext } from "../context.js";
 import { resolveComposerModel } from "../composer-model.js";
-import { fail } from "../output.js";
-import { toolDone, toolError, toolRunning } from "../theme.js";
 import { languageInstruction } from "../locale.js";
+import { fail } from "../output.js";
 import { agentScopeBlock } from "../scope.js";
+import { toolDone, toolError, toolRunning } from "../theme.js";
+import { loadCursorSdk } from "./cursor-sdk.js";
 async function disposeAgent(agent) {
     const disposer = agent[Symbol.asyncDispose];
     if (typeof disposer === "function")
@@ -13,7 +13,8 @@ async function disposeAgent(agent) {
     else
         agent.close();
 }
-async function streamRun(agent, prompt) {
+async function streamRun(agent, prompt, locale) {
+    const { AgentBusyError, CursorAgentError } = await loadCursorSdk(locale);
     const sendOptions = {
         onDelta: ({ update }) => {
             if (update.type === "text-delta" && update.text)
@@ -52,6 +53,7 @@ export async function executeCursorAskTurn(options) {
     const cwd = resolve(options.cwd);
     const ctx = await buildBootstrapContext(cwd);
     const model = resolveComposerModel(process.env, options.creds.model);
+    const { Agent } = await loadCursorSdk(options.locale);
     const prompt = `${agentScopeBlock(options.locale)}
 
 ${languageInstruction(options.locale)}
@@ -71,7 +73,7 @@ ${options.question}`;
             model: { id: model.id, params: model.params },
             local: { cwd, settingSources: ["project"] },
         });
-        await streamRun(agent, prompt);
+        await streamRun(agent, prompt, options.locale);
         console.log("");
         return true;
     }

package/dist/lib/providers/cursor-sdk.d.ts

@@ -0,0 +1,8 @@
+import type { EkzLocale } from "../locale.js";
+export declare class CursorSdkMissingError extends Error {
+    constructor(locale?: EkzLocale);
+}
+type CursorSdkModule = typeof import("@cursor/sdk");
+export declare function loadCursorSdk(locale?: EkzLocale): Promise<CursorSdkModule>;
+export type { SDKAgent } from "@cursor/sdk";
+//# sourceMappingURL=cursor-sdk.d.ts.map

package/dist/lib/providers/cursor-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-sdk.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/cursor-sdk.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,MAAM,GAAE,SAAgB;CAWrC;AAED,KAAK,eAAe,GAAG,cAAc,aAAa,CAAC,CAAC;AAIpD,wBAAsB,aAAa,CAAC,MAAM,GAAE,SAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAQtF;AAED,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}