@ekzs/cli 0.2.0 → 0.3.3

package/dist/lib/providers/ui.js

@@ -0,0 +1,188 @@
+import readline from "readline";
+import { ok, warn } from "../output.js";
+import { c, muted } from "../theme.js";
+import { askWithPlaceholder, formatInputPrompt } from "../ui/prompt.js";
+import { PROVIDER_CATALOG, getProviderDefinition } from "./catalog.js";
+import { listProviderRows, resolveActiveCredentials, } from "./credentials.js";
+import { maskApiKey, providersFilePath, removeStoredProvider, setActiveProvider, setStoredProvider, } from "./store.js";
+function providersTitle(locale) {
+    if (locale === "pt")
+        return "Provedores (BYOK)";
+    if (locale === "zh")
+        return "供应商 (BYOK)";
+    return "Providers (BYOK)";
+}
+function t(locale, pt, en, zh) {
+    if (locale === "pt")
+        return pt;
+    if (locale === "zh")
+        return zh;
+    return en;
+}
+async function askLine(prompt, hidden = false) {
+    if (!hidden || !process.stdin.isTTY) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        return new Promise((resolve) => {
+            rl.question(prompt, (answer) => {
+                rl.close();
+                resolve(answer.trim());
+            });
+        });
+    }
+    process.stdout.write(prompt);
+    return new Promise((resolve) => {
+        const stdin = process.stdin;
+        const stdout = process.stdout;
+        readline.emitKeypressEvents(stdin);
+        stdin.setRawMode(true);
+        stdin.resume();
+        let value = "";
+        const cleanup = () => {
+            stdin.setRawMode(false);
+            stdin.removeListener("keypress", onKeypress);
+            stdout.write("\n");
+        };
+        const onKeypress = (_char, key) => {
+            if (!key)
+                return;
+            if (key.name === "return") {
+                cleanup();
+                resolve(value.trim());
+                return;
+            }
+            if (key.name === "c" && key.ctrl) {
+                cleanup();
+                process.exit(130);
+            }
+            if (key.name === "backspace") {
+                if (value.length > 0) {
+                    value = value.slice(0, -1);
+                    stdout.write("\b \b");
+                }
+                return;
+            }
+            const ch = key.sequence;
+            if (!ch || key.ctrl || key.meta)
+                return;
+            value += ch;
+            stdout.write("*");
+        };
+        stdin.on("keypress", onKeypress);
+    });
+}
+function printProviderList(rows, locale) {
+    console.log("");
+    console.log(`  ${c.bold}${providersTitle(locale)}${c.reset}`);
+    console.log(`  ${muted(providersFilePath())}`);
+    console.log("");
+    rows.forEach((row, index) => {
+        const n = index + 1;
+        const bullet = row.active ? `${c.green}●${c.reset}` : " ";
+        const keyCol = row.maskedKey ? muted(row.maskedKey) : muted("—");
+        const activeTag = row.active
+            ? muted(t(locale, " activo", " active", " 当前"))
+            : "";
+        console.log(`  ${bullet} ${c.bold}${String(n).padStart(2)}.${c.reset} ${row.definition.name.padEnd(14)} ${keyCol}  ${muted(row.model)}${activeTag}`);
+    });
+    console.log("");
+    console.log(`  ${muted(t(locale, "[número] configurar · u usar · r remover · q sair", "[number] configure · u use · r remove · q quit", "[数字] 配置 · u 使用 · r 删除 · q 退出"))}`);
+    console.log("");
+}
+async function configureProvider(id, locale) {
+    const def = getProviderDefinition(id);
+    if (!def)
+        return;
+    console.log("");
+    console.log(`  ${c.bold}${def.name}${c.reset} — ${muted(def.description)}`);
+    console.log(`  ${muted(def.docsUrl)}`);
+    console.log("");
+    const keyPrompt = t(locale, `Cola a API key (${def.keyHint}): `, `Paste API key (${def.keyHint}): `, `粘贴 API key (${def.keyHint}): `);
+    const apiKey = await askLine(keyPrompt, true);
+    if (!apiKey) {
+        warn(t(locale, "Chave vazia — cancelado.", "Empty key — cancelled.", "密钥为空，已取消。"));
+        return;
+    }
+    const modelDefault = def.defaultModel;
+    const modelPrompt = t(locale, `Modelo [${modelDefault}]: `, `Model [${modelDefault}]: `, `模型 [${modelDefault}]: `);
+    const modelInput = await askLine(modelPrompt);
+    const model = modelInput || modelDefault;
+    let baseUrl;
+    if (def.kind === "openai-compatible" || def.defaultBaseUrl) {
+        const urlPrompt = t(locale, `Base URL [${def.defaultBaseUrl ?? "(default)"}]: `, `Base URL [${def.defaultBaseUrl ?? "(default)"}]: `, `Base URL [${def.defaultBaseUrl ?? "(default)"}]: `);
+        const urlInput = await askLine(urlPrompt);
+        if (urlInput)
+            baseUrl = urlInput;
+    }
+    setStoredProvider(id, { apiKey, model, baseUrl });
+    ok(t(locale, `Guardado ${def.name} (${maskApiKey(apiKey)})`, `Saved ${def.name} (${maskApiKey(apiKey)})`, `已保存 ${def.name} (${maskApiKey(apiKey)})`));
+    const active = resolveActiveCredentials();
+    if (!active || active.id !== id) {
+        const useNow = await askLine(t(locale, "Usar como provider activo? [Y/n]: ", "Use as active provider? [Y/n]: ", "设为当前 provider? [Y/n]: "), false);
+        if (!useNow || useNow.toLowerCase() === "y" || useNow.toLowerCase() === "s" || useNow === "") {
+            setActiveProvider(id);
+            ok(t(locale, `${def.name} activo.`, `${def.name} is now active.`, `${def.name} 已激活。`));
+        }
+    }
+}
+function resolveRowTarget(rows, target) {
+    const trimmed = target.trim().toLowerCase();
+    const num = Number(trimmed);
+    if (Number.isInteger(num) && num >= 1 && num <= rows.length) {
+        return rows[num - 1];
+    }
+    return rows.find((r) => r.definition.id === trimmed);
+}
+export async function runProvidersInteractive(locale = "pt") {
+    while (true) {
+        const rows = listProviderRows();
+        printProviderList(rows, locale);
+        const choice = (await askWithPlaceholder({
+            prompt: formatInputPrompt(),
+            placeholder: t(locale, "número ou u/r/q", "number or u/r/q", "数字或 u/r/q"),
+        })).trim();
+        if (!choice || choice.toLowerCase() === "q" || choice === "sair" || choice === "退出")
+            break;
+        const num = Number(choice);
+        if (Number.isInteger(num) && num >= 1 && num <= rows.length) {
+            await configureProvider(rows[num - 1].definition.id, locale);
+            continue;
+        }
+        const parts = choice.split(/\s+/);
+        const cmd = parts[0]?.toLowerCase();
+        if (cmd === "u" || cmd === "use" || cmd === "usar" || cmd === "使用") {
+            const target = parts[1] ?? (await askLine(t(locale, "Número ou id: ", "Number or id: ", "编号或 id: ")));
+            const row = resolveRowTarget(rows, target);
+            if (!row?.stored?.apiKey) {
+                warn(t(locale, "Provider sem chave.", "Provider has no key.", "该 provider 未配置密钥。"));
+                continue;
+            }
+            setActiveProvider(row.definition.id);
+            ok(t(locale, `${row.definition.name} activo.`, `${row.definition.name} active.`, `${row.definition.name} 已激活。`));
+            continue;
+        }
+        if (cmd === "r" || cmd === "remove" || cmd === "remover" || cmd === "删除") {
+            const target = parts[1] ?? (await askLine(t(locale, "Número ou id: ", "Number or id: ", "编号或 id: ")));
+            const row = resolveRowTarget(rows, target);
+            if (!row) {
+                warn(t(locale, "Provider inválido.", "Invalid provider.", "无效的 provider。"));
+                continue;
+            }
+            removeStoredProvider(row.definition.id);
+            ok(t(locale, `${row.definition.name} removido.`, `${row.definition.name} removed.`, `${row.definition.name} 已删除。`));
+            continue;
+        }
+        const byId = PROVIDER_CATALOG.find((p) => p.id === choice.toLowerCase());
+        if (byId) {
+            await configureProvider(byId.id, locale);
+            continue;
+        }
+        warn(t(locale, "Opção inválida.", "Invalid option.", "无效选项。"));
+    }
+}
+export function formatActiveProviderLabel(locale) {
+    const creds = resolveActiveCredentials();
+    if (!creds) {
+        return t(locale, "sem provider", "no provider", "未配置");
+    }
+    return `${creds.definition.name} · ${creds.maskedKey}`;
+}

package/dist/lib/setup-messages.d.ts

@@ -0,0 +1,4 @@
+/** Shown when agent needs provider but setup was not run (all locales). */
+export declare function formatSetupRequiredMessage(): string;
+export declare function providersSetupHint(_locale?: string): string;
+//# sourceMappingURL=setup-messages.d.ts.map

package/dist/lib/setup-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-messages.d.ts","sourceRoot":"","sources":["../../src/lib/setup-messages.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,wBAAgB,0BAA0B,IAAI,MAAM,CAQnD;AAED,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/lib/setup-messages.js

@@ -0,0 +1,13 @@
+/** Shown when agent needs provider but setup was not run (all locales). */
+export function formatSetupRequiredMessage() {
+    return [
+        "Setup required · Configuração necessária · 需要设置",
+        "",
+        "  pt: Corre `ekz setup` ou `ekz --offline`",
+        "  en: Run `ekz setup` or `ekz --offline`",
+        "  zh: 运行 `ekz setup` 或 `ekz --offline`",
+    ].join("\n");
+}
+export function providersSetupHint(_locale) {
+    return formatSetupRequiredMessage();
+}

package/dist/lib/ui/splash.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"splash.d.ts","sourceRoot":"","sources":["../../../src/lib/ui/splash.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,cAAc,CAAC;AACzD,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAMvD,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA2GF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAQtD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAG1D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,SAAI,GAAG,MAAM,CAIrE"}
+{"version":3,"file":"splash.d.ts","sourceRoot":"","sources":["../../../src/lib/ui/splash.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,cAAc,CAAC;AACzD,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAMvD,MAAM,MAAM,aAAa,GAAG;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AA6GF,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAQtD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAG1D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,SAAI,GAAG,MAAM,CAIrE"}

package/dist/lib/ui/splash.js

@@ -4,6 +4,7 @@ import { readFileSync } from "fs";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 import { formatSplashTool, splashHelpHint, splashSectionTitle, SPLASH_TOOLS, splashSessionLines, welcomeMessage, } from "../commands-i18n.js";
+import { getGlobalUserName } from "../global-config.js";
 import { uiStrings } from "../locale.js";
 import { MODE_LABELS } from "../mode.js";
 import { detectShellEnvironment, shellLabel } from "../shell.js";
@@ -24,6 +25,9 @@ function packageVersion() {
     }
 }
 function displayName() {
+    const fromConfig = getGlobalUserName();
+    if (fromConfig)
+        return fromConfig.split(/\s+/)[0] ?? fromConfig;
     const fromEnv = process.env.EKZ_USER_NAME?.trim();
     if (fromEnv)
         return fromEnv.split(/\s+/)[0] ?? fromEnv;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ekzs/cli",
-  "version": "0.2.0",
+  "version": "0.3.3",
   "description": "CLI agent for e-Kwanza v2.4 — health checks, code scan, webhook tests, AI assistance",
   "type": "module",
   "bin": {
@@ -17,12 +17,20 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@cursor/sdk": "^1.0.13",
     "@ekzs/connect": "^0.1.0",
     "commander": "^12.1.0",
     "dotenv": "^16.4.7"
   },
+  "peerDependencies": {
+    "@cursor/sdk": "^1.0.13"
+  },
+  "peerDependenciesMeta": {
+    "@cursor/sdk": {
+      "optional": true
+    }
+  },
   "devDependencies": {
+    "@cursor/sdk": "^1.0.13",
     "@types/node": "^20",
     "typescript": "^5"
   },

package/skills/ekz-sdk-cli/SKILL.md

@@ -35,15 +35,17 @@ Model env: `EKZ_AGENT_MODEL=composer-2.5-fast` → `composer-2.5` + `fast: true`
 | `ekz doctor` | Validate `.env`, live OAuth (free) |
 | `ekz scan` | Common integration mistakes (free) |
 | `ekz webhook <url>` | POST sample payload (free) |
-| `ekz agent` | Local coding agent, edits repo (CURSOR_API_KEY) |
+| `ekz health` | OAuth + rail health (free) |
+| `ekz providers` | Configure LLM API keys — BYOK (`ekz provedores` / `ekz 供应商`) |
+| `ekz agent` | Local coding agent (BYOK — configure via `ekz providers`) |
 | `ekz fix` | Auto-audit + fix integration |
-| `ekz ask` | Remote Q&A only (EKZ_AGENT_API_KEY) |
+| `ekz ask` | BYOK Q&A only (no file edits) |
 
 Modes: `--mode agent` (default) | `--mode plan` | `--mode ask`. Shorthand: `--plan` = plan mode.
-In the REPL: `/help`, `/mode agent|plan|ask`, `/doctor`, `/scan`, `/lang`, `/save`, `/resume`.
+In the REPL: `/help`, `/providers` (`/provedores`, `/供应商`), `/mode agent|plan|ask`, `/doctor`, `/scan`, `/lang`, `/save`, `/resume`.
 
 ```bash
-export CURSOR_API_KEY=crsr_...
+ekz providers           # BYOK keys → ~/.ekz/providers.json
 ekz                    # interactive REPL (agent mode)
 ekz --mode plan        # plan before edits
 ekz --mode ask         # remote Q&A, no edits