@ekzs/cli 0.2.0 → 0.3.3

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 { runProvidersInteractive } 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 === "供应商") {
+        await runProvidersInteractive(locale);
+        if (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/agent-runner.d.ts

@@ -0,0 +1,12 @@
+import { type EkzLocale } from "../locale.js";
+import { type EkzMode } from "../mode.js";
+import { type ResolvedCredentials } from "./credentials.js";
+export declare function runByokAgentTurn(options: {
+    cwd: string;
+    task: string;
+    creds: ResolvedCredentials;
+    locale: EkzLocale;
+    mode: EkzMode;
+}): Promise<boolean>;
+export declare function usesCursorSdk(creds: ResolvedCredentials): boolean;
+//# sourceMappingURL=agent-runner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/agent-runner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AA+L5D,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,mBAAmB,CAAC;IAC3B,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,EAAE,OAAO,CAAC;CACf,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCnB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAEjE"}

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

@@ -0,0 +1,167 @@
+import { resolve } from "path";
+import { buildAgentPrompt, buildBootstrapContext } from "../context.js";
+import { fail } from "../output.js";
+import { toolDone, toolError, toolRunning } from "../theme.js";
+import { AGENT_TOOL_DEFINITIONS, executeAgentTool } from "./tools.js";
+const MAX_TOOL_ROUNDS = 24;
+function planInstruction(mode) {
+    if (mode === "plan") {
+        return "You are in **plan mode**: output a clear numbered plan first. Only call write_file after the plan is clear.";
+    }
+    if (mode === "ask") {
+        return "You are in **ask mode**: answer only. Do not call write_file or run_command.";
+    }
+    return "You are in **agent mode**: use tools to inspect and fix the e-Kwanza integration.";
+}
+async function openAiAgentLoop(creds, cwd, messages, enableTools) {
+    const base = (creds.baseUrl ?? "https://api.openai.com/v1").replace(/\/$/, "");
+    const url = base.endsWith("/chat/completions") ? base : `${base}/chat/completions`;
+    for (let round = 0; round < MAX_TOOL_ROUNDS; round++) {
+        const headers = { "Content-Type": "application/json" };
+        if (creds.apiKey && creds.apiKey !== "ollama") {
+            headers.Authorization = `Bearer ${creds.apiKey}`;
+        }
+        const body = {
+            model: creds.model,
+            messages,
+            temperature: 0.2,
+        };
+        if (enableTools)
+            body.tools = AGENT_TOOL_DEFINITIONS;
+        const res = await fetch(url, { method: "POST", headers, body: JSON.stringify(body) });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok)
+            throw new Error(data.error?.message ?? `Provider error (${res.status})`);
+        const message = data.choices?.[0]?.message;
+        if (!message)
+            throw new Error("Empty response from provider.");
+        const toolCalls = message.tool_calls ?? [];
+        if (!toolCalls.length) {
+            const text = message.content?.trim();
+            if (!text)
+                throw new Error("Empty response from provider.");
+            return text;
+        }
+        messages.push({
+            role: "assistant",
+            content: message.content ?? null,
+            tool_calls: toolCalls,
+        });
+        for (const call of toolCalls) {
+            process.stdout.write(toolRunning(call.function.name));
+            let args = {};
+            try {
+                args = JSON.parse(call.function.arguments || "{}");
+            }
+            catch {
+                args = {};
+            }
+            try {
+                const result = await executeAgentTool(cwd, call.function.name, args);
+                process.stdout.write(toolDone(call.function.name));
+                messages.push({ role: "tool", tool_call_id: call.id, content: result });
+            }
+            catch (err) {
+                process.stdout.write(toolError(call.function.name));
+                messages.push({
+                    role: "tool",
+                    tool_call_id: call.id,
+                    content: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+    }
+    throw new Error("Tool loop exceeded maximum rounds.");
+}
+async function anthropicAgentLoop(creds, cwd, system, messages, enableTools) {
+    const tools = enableTools
+        ? AGENT_TOOL_DEFINITIONS.map((t) => ({
+            name: t.function.name,
+            description: t.function.description,
+            input_schema: t.function.parameters,
+        }))
+        : undefined;
+    for (let round = 0; round < MAX_TOOL_ROUNDS; round++) {
+        const res = await fetch("https://api.anthropic.com/v1/messages", {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "x-api-key": creds.apiKey,
+                "anthropic-version": "2023-06-01",
+            },
+            body: JSON.stringify({
+                model: creds.model,
+                max_tokens: 8192,
+                system,
+                messages,
+                ...(tools ? { tools } : {}),
+            }),
+        });
+        const data = (await res.json().catch(() => ({})));
+        if (!res.ok)
+            throw new Error(data.error?.message ?? `Anthropic error (${res.status})`);
+        const blocks = data.content ?? [];
+        const textParts = blocks.filter((b) => b.type === "text").map((b) => b.text ?? "");
+        const toolUses = blocks.filter((b) => b.type === "tool_use");
+        messages.push({ role: "assistant", content: blocks });
+        if (!toolUses.length || data.stop_reason === "end_turn") {
+            const text = textParts.join("").trim();
+            if (!text && !toolUses.length)
+                throw new Error("Empty response from Anthropic.");
+            if (text)
+                return text;
+        }
+        if (!toolUses.length) {
+            return textParts.join("").trim() || "(done)";
+        }
+        const toolResults = [];
+        for (const tool of toolUses) {
+            const name = tool.name ?? "unknown";
+            process.stdout.write(toolRunning(name));
+            try {
+                const result = await executeAgentTool(cwd, name, tool.input ?? {});
+                process.stdout.write(toolDone(name));
+                toolResults.push({ type: "tool_result", tool_use_id: tool.id ?? name, content: result });
+            }
+            catch (err) {
+                process.stdout.write(toolError(name));
+                toolResults.push({
+                    type: "tool_result",
+                    tool_use_id: tool.id ?? name,
+                    content: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        messages.push({ role: "user", content: toolResults });
+    }
+    throw new Error("Tool loop exceeded maximum rounds.");
+}
+export async function runByokAgentTurn(options) {
+    const cwd = resolve(options.cwd);
+    const ctx = await buildBootstrapContext(cwd);
+    const prompt = buildAgentPrompt(options.task, ctx, options.locale);
+    const system = `${planInstruction(options.mode)}\n\n${prompt.split("## Task")[0] ?? prompt}`;
+    const userTask = `## Task\n${options.task}`;
+    const enableTools = options.mode !== "ask";
+    try {
+        if (options.creds.definition.kind === "anthropic") {
+            const text = await anthropicAgentLoop(options.creds, cwd, system, [{ role: "user", content: userTask }], enableTools);
+            console.log("\n" + text);
+            return true;
+        }
+        const messages = [
+            { role: "system", content: system },
+            { role: "user", content: userTask },
+        ];
+        const text = await openAiAgentLoop(options.creds, cwd, messages, enableTools);
+        console.log("\n" + text);
+        return true;
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+        return false;
+    }
+}
+export function usesCursorSdk(creds) {
+    return creds.definition.kind === "cursor";
+}

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

@@ -0,0 +1,15 @@
+export type ProviderKind = "cursor" | "openai-compatible" | "anthropic";
+export type ProviderId = "cursor" | "openai" | "anthropic" | "deepseek" | "kimi" | "groq" | "mistral" | "google" | "ollama";
+export type ProviderDefinition = {
+    id: ProviderId;
+    name: string;
+    kind: ProviderKind;
+    description: string;
+    defaultModel: string;
+    defaultBaseUrl?: string;
+    keyHint: string;
+    docsUrl: string;
+};
+export declare const PROVIDER_CATALOG: ProviderDefinition[];
+export declare function getProviderDefinition(id: string): ProviderDefinition | undefined;
+//# sourceMappingURL=catalog.d.ts.map

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

@@ -0,0 +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"}

package/dist/lib/providers/catalog.js

@@ -0,0 +1,93 @@
+export const PROVIDER_CATALOG = [
+    {
+        id: "cursor",
+        name: "Cursor",
+        kind: "cursor",
+        description: "Composer local agent (@cursor/sdk)",
+        defaultModel: "composer-2.5-fast",
+        keyHint: "crsr_…",
+        docsUrl: "https://cursor.com/dashboard/integrations",
+    },
+    {
+        id: "openai",
+        name: "OpenAI",
+        kind: "openai-compatible",
+        description: "GPT-4o, o-series",
+        defaultModel: "gpt-4o",
+        defaultBaseUrl: "https://api.openai.com/v1",
+        keyHint: "sk-…",
+        docsUrl: "https://platform.openai.com/api-keys",
+    },
+    {
+        id: "anthropic",
+        name: "Anthropic",
+        kind: "anthropic",
+        description: "Claude Sonnet / Opus",
+        defaultModel: "claude-sonnet-4-20250514",
+        keyHint: "sk-ant-…",
+        docsUrl: "https://console.anthropic.com/settings/keys",
+    },
+    {
+        id: "deepseek",
+        name: "DeepSeek",
+        kind: "openai-compatible",
+        description: "DeepSeek Chat / Reasoner",
+        defaultModel: "deepseek-chat",
+        defaultBaseUrl: "https://api.deepseek.com",
+        keyHint: "sk-…",
+        docsUrl: "https://platform.deepseek.com/api_keys",
+    },
+    {
+        id: "kimi",
+        name: "Kimi (Moonshot)",
+        kind: "openai-compatible",
+        description: "Moonshot AI",
+        defaultModel: "moonshot-v1-8k",
+        defaultBaseUrl: "https://api.moonshot.cn/v1",
+        keyHint: "sk-…",
+        docsUrl: "https://platform.moonshot.cn/console/api-keys",
+    },
+    {
+        id: "groq",
+        name: "Groq",
+        kind: "openai-compatible",
+        description: "Fast inference",
+        defaultModel: "llama-3.3-70b-versatile",
+        defaultBaseUrl: "https://api.groq.com/openai/v1",
+        keyHint: "gsk_…",
+        docsUrl: "https://console.groq.com/keys",
+    },
+    {
+        id: "mistral",
+        name: "Mistral",
+        kind: "openai-compatible",
+        description: "Mistral Large",
+        defaultModel: "mistral-large-latest",
+        defaultBaseUrl: "https://api.mistral.ai/v1",
+        keyHint: "…",
+        docsUrl: "https://console.mistral.ai/api-keys",
+    },
+    {
+        id: "google",
+        name: "Google Gemini",
+        kind: "openai-compatible",
+        description: "Gemini via OpenAI-compatible endpoint",
+        defaultModel: "gemini-2.0-flash",
+        defaultBaseUrl: "https://generativelanguage.googleapis.com/v1beta/openai",
+        keyHint: "AI…",
+        docsUrl: "https://aistudio.google.com/apikey",
+    },
+    {
+        id: "ollama",
+        name: "Ollama",
+        kind: "openai-compatible",
+        description: "Local models",
+        defaultModel: "llama3.2",
+        defaultBaseUrl: "http://127.0.0.1:11434/v1",
+        keyHint: "ollama (optional)",
+        docsUrl: "https://ollama.com",
+    },
+];
+export function getProviderDefinition(id) {
+    return PROVIDER_CATALOG.find((p) => p.id === id);
+}

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

@@ -0,0 +1,10 @@
+import { type EkzLocale } from "../locale.js";
+import { type ResolvedCredentials } from "./credentials.js";
+export declare function executeByokAskTurn(options: {
+    cwd: string;
+    question: string;
+    locale?: EkzLocale;
+    creds?: ResolvedCredentials | null;
+    quiet?: boolean;
+}): Promise<boolean>;
+//# sourceMappingURL=chat.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/chat.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAGnE,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,kBAAkB,CAAC;AAuG1B,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,OAAO,CAAC,CAgDnB"}

package/dist/lib/providers/chat.js

@@ -0,0 +1,121 @@
+import { buildBootstrapContext } from "../context.js";
+import { languageInstruction } from "../locale.js";
+import { agentScopeBlock } from "../scope.js";
+import { fail, info, ok } from "../output.js";
+import { ProviderSetupError, requireActiveCredentials, } from "./credentials.js";
+function buildAskSystemPrompt(ctx, locale) {
+    return `You are **Ekz Connect** — an e-Kwanza v2.4 integration assistant.
+Answer in clear, actionable steps. You are in **ask mode**: explain and guide only; do not claim you edited files.
+
+${agentScopeBlock(locale)}
+
+${languageInstruction(locale)}
+
+## Project context (doctor + scan)
+${JSON.stringify({
+        issues: ctx.doctor.issues,
+        warnings: ctx.doctor.warnings,
+        rails: ctx.doctor.rails,
+        health: ctx.doctor.health,
+        scan: ctx.scan.slice(0, 12),
+        env: ctx.env,
+    }, null, 2)}`;
+}
+async function chatOpenAiCompatible(creds, messages) {
+    const base = (creds.baseUrl ?? "https://api.openai.com/v1").replace(/\/$/, "");
+    const url = base.endsWith("/chat/completions") ? base : `${base}/chat/completions`;
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (creds.apiKey && creds.apiKey !== "ollama") {
+        headers.Authorization = `Bearer ${creds.apiKey}`;
+    }
+    const res = await fetch(url, {
+        method: "POST",
+        headers,
+        body: JSON.stringify({
+            model: creds.model,
+            messages,
+            temperature: 0.2,
+        }),
+    });
+    const data = (await res.json().catch(() => ({})));
+    if (!res.ok) {
+        throw new Error(data.error?.message ?? `Provider error (${res.status})`);
+    }
+    const text = data.choices?.[0]?.message?.content?.trim();
+    if (!text)
+        throw new Error("Empty response from provider.");
+    return text;
+}
+async function chatAnthropic(creds, system, question) {
+    const res = await fetch("https://api.anthropic.com/v1/messages", {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": creds.apiKey,
+            "anthropic-version": "2023-06-01",
+        },
+        body: JSON.stringify({
+            model: creds.model,
+            max_tokens: 4096,
+            system,
+            messages: [{ role: "user", content: question }],
+        }),
+    });
+    const data = (await res.json().catch(() => ({})));
+    if (!res.ok) {
+        throw new Error(data.error?.message ?? `Anthropic error (${res.status})`);
+    }
+    const text = data.content
+        ?.filter((b) => b.type === "text")
+        .map((b) => b.text ?? "")
+        .join("")
+        .trim();
+    if (!text)
+        throw new Error("Empty response from Anthropic.");
+    return text;
+}
+export async function executeByokAskTurn(options) {
+    const locale = options.locale ?? "pt";
+    const ctx = await buildBootstrapContext(options.cwd);
+    let creds;
+    try {
+        creds = options.creds ?? requireActiveCredentials(locale);
+    }
+    catch (err) {
+        if (err instanceof ProviderSetupError) {
+            fail(err.message);
+            return false;
+        }
+        throw err;
+    }
+    if (creds.definition.kind === "cursor") {
+        fail(locale === "pt"
+            ? "Cursor em modo ask usa o agente Cursor (BYOK). Usa `/mode agent` ou escolhe OpenAI/Anthropic em `/provedores`."
+            : locale === "zh"
+                ? "Cursor 问答模式请使用 Cursor 代理，或在 `/供应商` 选择 OpenAI/Anthropic。"
+                : "Cursor ask uses the Cursor agent path — switch provider or use agent mode.");
+        return false;
+    }
+    const system = buildAskSystemPrompt(ctx, locale);
+    if (!options.quiet) {
+        info(`${creds.definition.name} · ${creds.model}`);
+    }
+    try {
+        const answer = creds.definition.kind === "anthropic"
+            ? await chatAnthropic(creds, system, options.question)
+            : await chatOpenAiCompatible(creds, [
+                { role: "system", content: system },
+                { role: "user", content: options.question },
+            ]);
+        if (!options.quiet)
+            ok(creds.definition.name);
+        console.log("\n" + answer);
+        return true;
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+        return false;
+    }
+}

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

@@ -0,0 +1,28 @@
+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;
+    definition: ProviderDefinition;
+    apiKey: string;
+    model: string;
+    baseUrl?: string;
+    maskedKey: string;
+};
+export declare class ProviderSetupError extends Error {
+    constructor(message: string);
+}
+export type ProviderRow = {
+    definition: ProviderDefinition;
+    stored?: StoredProvider;
+    active: boolean;
+    maskedKey: string | null;
+    model: string;
+};
+export declare function listProviderRows(): ProviderRow[];
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,70 @@
+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) {
+        super(message);
+        this.name = "ProviderSetupError";
+    }
+}
+export function listProviderRows() {
+    const file = loadProvidersFile();
+    return PROVIDER_CATALOG.map((definition) => {
+        const stored = file.providers[definition.id];
+        return {
+            definition,
+            stored,
+            active: file.active === definition.id,
+            maskedKey: stored?.apiKey ? maskApiKey(stored.apiKey) : null,
+            model: resolveModel(definition.id, stored),
+        };
+    });
+}
+export function getActiveProviderId() {
+    return loadProvidersFile().active;
+}
+export function resolveActiveCredentials() {
+    const file = loadProvidersFile();
+    const id = file.active;
+    if (!id)
+        return null;
+    const stored = file.providers[id];
+    if (!stored?.apiKey?.trim())
+        return null;
+    const definition = PROVIDER_CATALOG.find((p) => p.id === id);
+    if (!definition)
+        return null;
+    return {
+        id,
+        definition,
+        apiKey: stored.apiKey.trim(),
+        model: resolveModel(id, stored),
+        baseUrl: resolveBaseUrl(id, stored),
+        maskedKey: maskApiKey(stored.apiKey),
+    };
+}
+export function requireActiveCredentials(locale = "en") {
+    const creds = resolveActiveCredentials();
+    if (creds)
+        return creds;
+    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);
+}