@ekzs/cli 0.2.0 → 0.3.3

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

@@ -0,0 +1,13 @@
+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, locale: EkzLocale): Promise<void>;
+export declare function executeCursorAskTurn(options: {
+    cwd: string;
+    question: string;
+    creds: ResolvedCredentials;
+    locale: EkzLocale;
+}): Promise<boolean>;
+export { disposeAgent, streamRun };
+//# sourceMappingURL=cursor-runner.d.ts.map

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

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

@@ -0,0 +1,89 @@
+import { resolve } from "path";
+import { buildBootstrapContext } from "../context.js";
+import { resolveComposerModel } from "../composer-model.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")
+        await disposer.call(agent);
+    else
+        agent.close();
+}
+async function streamRun(agent, prompt, locale) {
+    const { AgentBusyError, CursorAgentError } = await loadCursorSdk(locale);
+    const sendOptions = {
+        onDelta: ({ update }) => {
+            if (update.type === "text-delta" && update.text)
+                process.stdout.write(update.text);
+        },
+    };
+    let run;
+    try {
+        run = await agent.send(prompt, sendOptions);
+    }
+    catch (err) {
+        if (err instanceof AgentBusyError) {
+            run = await agent.send(prompt, { ...sendOptions, local: { force: true } });
+        }
+        else {
+            throw err;
+        }
+    }
+    for await (const event of run.stream()) {
+        if (event.type === "tool_call" && event.status === "running") {
+            process.stdout.write(toolRunning(event.name));
+        }
+        if (event.type === "tool_call" && event.status === "completed") {
+            process.stdout.write(toolDone(event.name));
+        }
+        if (event.type === "tool_call" && event.status === "error") {
+            process.stdout.write(toolError(event.name));
+        }
+    }
+    const result = await run.wait();
+    if (result.status === "error") {
+        throw new CursorAgentError(`Agent failed (${result.id})`);
+    }
+}
+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)}
+
+You are in **ask mode** — answer only. Do not edit files or run tools unless the user explicitly asks for a command example.
+
+## Project context
+${JSON.stringify({ issues: ctx.doctor.issues, scan: ctx.scan.slice(0, 12), env: ctx.env }, null, 2)}
+
+## Question
+${options.question}`;
+    let agent = null;
+    try {
+        agent = await Agent.create({
+            apiKey: options.creds.apiKey,
+            name: "Ekz Connect — ask",
+            model: { id: model.id, params: model.params },
+            local: { cwd, settingSources: ["project"] },
+        });
+        await streamRun(agent, prompt, options.locale);
+        console.log("");
+        return true;
+    }
+    catch (err) {
+        fail(err instanceof Error ? err.message : String(err));
+        return false;
+    }
+    finally {
+        if (agent)
+            await disposeAgent(agent);
+    }
+}
+export { disposeAgent, streamRun };

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"}

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

@@ -0,0 +1,25 @@
+import { providersCommandLabels } from "../commands-i18n.js";
+export class CursorSdkMissingError extends Error {
+    constructor(locale = "en") {
+        const p = providersCommandLabels(locale);
+        const msg = locale === "pt"
+            ? `Provider Cursor requer @cursor/sdk. Instala: npm install -g @cursor/sdk\nOu usa outro provider em ${p.repl}.`
+            : locale === "zh"
+                ? `Cursor provider 需要 @cursor/sdk。安装: npm install -g @cursor/sdk\n或在 ${p.repl} 选择其他 provider。`
+                : `Cursor provider requires @cursor/sdk. Run: npm install -g @cursor/sdk\nOr pick another provider via ${p.repl}.`;
+        super(msg);
+        this.name = "CursorSdkMissingError";
+    }
+}
+let cached = null;
+export async function loadCursorSdk(locale = "en") {
+    if (cached)
+        return cached;
+    try {
+        cached = await import("@cursor/sdk");
+        return cached;
+    }
+    catch {
+        throw new CursorSdkMissingError(locale);
+    }
+}

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

@@ -0,0 +1,21 @@
+import { type ProviderId } from "./catalog.js";
+export type StoredProvider = {
+    apiKey: string;
+    model?: string;
+    baseUrl?: string;
+};
+export type ProvidersFile = {
+    active?: ProviderId;
+    providers: Partial<Record<ProviderId, StoredProvider>>;
+};
+export declare function providersFilePath(): string;
+export declare function loadProvidersFile(): ProvidersFile;
+export declare function saveProvidersFile(data: ProvidersFile): void;
+export declare function maskApiKey(key: string): string;
+export declare function getStoredProvider(id: ProviderId): StoredProvider | undefined;
+export declare function setStoredProvider(id: ProviderId, entry: StoredProvider): void;
+export declare function removeStoredProvider(id: ProviderId): void;
+export declare function setActiveProvider(id: ProviderId): void;
+export declare function resolveModel(id: ProviderId, stored?: StoredProvider): string;
+export declare function resolveBaseUrl(id: ProviderId, stored?: StoredProvider): string | undefined;
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/store.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,UAAU,EAAyB,MAAM,cAAc,CAAC;AAGtE,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;CACxD,CAAC;AAWF,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAgB,iBAAiB,IAAI,aAAa,CAcjD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,QAQpD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS,CAE5E;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,cAAc,QAOtE;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,UAAU,QAOlD;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,UAAU,QAO/C;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,CAG5E;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAG1F"}

package/dist/lib/providers/store.js

@@ -0,0 +1,84 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { getProviderDefinition } from "./catalog.js";
+import { clearGlobalOffline, markSetupComplete } from "../global-config.js";
+const EKZ_HOME = join(homedir(), ".ekz");
+const PROVIDERS_PATH = join(EKZ_HOME, "providers.json");
+function ensureEkzHome() {
+    if (!existsSync(EKZ_HOME)) {
+        mkdirSync(EKZ_HOME, { recursive: true, mode: 0o700 });
+    }
+}
+export function providersFilePath() {
+    return PROVIDERS_PATH;
+}
+export function loadProvidersFile() {
+    ensureEkzHome();
+    if (!existsSync(PROVIDERS_PATH)) {
+        return { providers: {} };
+    }
+    try {
+        const data = JSON.parse(readFileSync(PROVIDERS_PATH, "utf8"));
+        return {
+            active: data.active,
+            providers: data.providers ?? {},
+        };
+    }
+    catch {
+        return { providers: {} };
+    }
+}
+export function saveProvidersFile(data) {
+    ensureEkzHome();
+    writeFileSync(PROVIDERS_PATH, JSON.stringify(data, null, 2) + "\n", { mode: 0o600 });
+    try {
+        chmodSync(PROVIDERS_PATH, 0o600);
+    }
+    catch {
+        /* windows */
+    }
+}
+export function maskApiKey(key) {
+    const trimmed = key.trim();
+    if (trimmed.length <= 8)
+        return "••••••••";
+    return `${trimmed.slice(0, 4)}…${trimmed.slice(-4)}`;
+}
+export function getStoredProvider(id) {
+    return loadProvidersFile().providers[id];
+}
+export function setStoredProvider(id, entry) {
+    const file = loadProvidersFile();
+    file.providers[id] = entry;
+    if (!file.active)
+        file.active = id;
+    saveProvidersFile(file);
+    clearGlobalOffline();
+    markSetupComplete();
+}
+export function removeStoredProvider(id) {
+    const file = loadProvidersFile();
+    delete file.providers[id];
+    if (file.active === id) {
+        file.active = Object.keys(file.providers)[0];
+    }
+    saveProvidersFile(file);
+}
+export function setActiveProvider(id) {
+    const file = loadProvidersFile();
+    if (!file.providers[id]?.apiKey) {
+        throw new Error(`Provider "${id}" has no API key. Add one first.`);
+    }
+    file.active = id;
+    saveProvidersFile(file);
+}
+export function resolveModel(id, stored) {
+    const def = getProviderDefinition(id);
+    return stored?.model?.trim() || def?.defaultModel || "gpt-4o";
+}
+export function resolveBaseUrl(id, stored) {
+    if (stored?.baseUrl?.trim())
+        return stored.baseUrl.trim();
+    return getProviderDefinition(id)?.defaultBaseUrl;
+}

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

@@ -0,0 +1,80 @@
+export declare function toolReadFile(cwd: string, path: string): Promise<string>;
+export declare function toolWriteFile(cwd: string, path: string, content: string): Promise<string>;
+export declare function toolListFiles(cwd: string, path?: string): Promise<string>;
+export declare function toolRunCommand(cwd: string, command: string): Promise<string>;
+export declare const AGENT_TOOL_DEFINITIONS: ({
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                path: {
+                    type: string;
+                    description: string;
+                };
+                content?: undefined;
+                command?: undefined;
+            };
+            required: string[];
+        };
+    };
+} | {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                path: {
+                    type: string;
+                    description?: undefined;
+                };
+                content: {
+                    type: string;
+                };
+                command?: undefined;
+            };
+            required: string[];
+        };
+    };
+} | {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                path: {
+                    type: string;
+                    description: string;
+                };
+                content?: undefined;
+                command?: undefined;
+            };
+            required?: undefined;
+        };
+    };
+} | {
+    type: "function";
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                command: {
+                    type: string;
+                };
+                path?: undefined;
+                content?: undefined;
+            };
+            required: string[];
+        };
+    };
+})[];
+export declare function executeAgentTool(cwd: string, name: string, args: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/tools.ts"],"names":[],"mappings":"AAqBA,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS7E;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAK/F;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,SAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAU5E;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkClF;AAED,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAmDlC,CAAC;AAEF,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/lib/providers/tools.js

@@ -0,0 +1,145 @@
+import { execFile } from "child_process";
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "fs";
+import { dirname, join, relative, resolve } from "path";
+import { promisify } from "util";
+import { detectShellEnvironment } from "../shell.js";
+const execFileAsync = promisify(execFile);
+const MAX_FILE_BYTES = 120_000;
+const MAX_CMD_OUTPUT = 24_000;
+function safePath(cwd, input) {
+    const root = resolve(cwd);
+    const abs = resolve(root, input.trim());
+    const rel = relative(root, abs);
+    if (rel.startsWith("..") || rel.includes("..")) {
+        throw new Error(`Path escapes project root: ${input}`);
+    }
+    return abs;
+}
+export async function toolReadFile(cwd, path) {
+    const abs = safePath(cwd, path);
+    if (!existsSync(abs))
+        return `Error: file not found: ${path}`;
+    const stat = statSync(abs);
+    if (!stat.isFile())
+        return `Error: not a file: ${path}`;
+    if (stat.size > MAX_FILE_BYTES) {
+        return readFileSync(abs, "utf8").slice(0, MAX_FILE_BYTES) + "\n…[truncated]";
+    }
+    return readFileSync(abs, "utf8");
+}
+export async function toolWriteFile(cwd, path, content) {
+    const abs = safePath(cwd, path);
+    mkdirSync(dirname(abs), { recursive: true });
+    writeFileSync(abs, content, "utf8");
+    return `Wrote ${relative(resolve(cwd), abs)} (${content.length} bytes)`;
+}
+export async function toolListFiles(cwd, path = ".") {
+    const abs = safePath(cwd, path);
+    if (!existsSync(abs))
+        return `Error: path not found: ${path}`;
+    const stat = statSync(abs);
+    if (!stat.isDirectory())
+        return `Error: not a directory: ${path}`;
+    const entries = readdirSync(abs, { withFileTypes: true })
+        .slice(0, 200)
+        .map((e) => `${e.isDirectory() ? "d" : "f"} ${join(path, e.name).replace(/\\/g, "/")}`);
+    return entries.join("\n") || "(empty)";
+}
+export async function toolRunCommand(cwd, command) {
+    const shell = detectShellEnvironment();
+    const trimmed = command.trim();
+    if (!trimmed)
+        return "Error: empty command";
+    try {
+        if (shell.agentShell === "powershell") {
+            const { stdout, stderr } = await execFileAsync("powershell.exe", ["-NoProfile", "-NonInteractive", "-Command", trimmed], { cwd: resolve(cwd), timeout: 90_000, maxBuffer: MAX_CMD_OUTPUT });
+            return [stdout, stderr].filter(Boolean).join("\n").slice(0, MAX_CMD_OUTPUT) || "(no output)";
+        }
+        if (shell.agentShell === "cmd") {
+            const { stdout, stderr } = await execFileAsync("cmd.exe", ["/c", trimmed], {
+                cwd: resolve(cwd),
+                timeout: 90_000,
+                maxBuffer: MAX_CMD_OUTPUT,
+            });
+            return [stdout, stderr].filter(Boolean).join("\n").slice(0, MAX_CMD_OUTPUT) || "(no output)";
+        }
+        const { stdout, stderr } = await execFileAsync(trimmed, {
+            cwd: resolve(cwd),
+            timeout: 90_000,
+            maxBuffer: MAX_CMD_OUTPUT,
+            shell: true,
+        });
+        return [stdout, stderr].filter(Boolean).join("\n").slice(0, MAX_CMD_OUTPUT) || "(no output)";
+    }
+    catch (err) {
+        const e = err;
+        const out = [e.stdout, e.stderr, e.message].filter(Boolean).join("\n");
+        return `Command failed:\n${out.slice(0, MAX_CMD_OUTPUT)}`;
+    }
+}
+export const AGENT_TOOL_DEFINITIONS = [
+    {
+        type: "function",
+        function: {
+            name: "read_file",
+            description: "Read a UTF-8 text file relative to the project root.",
+            parameters: {
+                type: "object",
+                properties: { path: { type: "string", description: "Relative file path" } },
+                required: ["path"],
+            },
+        },
+    },
+    {
+        type: "function",
+        function: {
+            name: "write_file",
+            description: "Write or overwrite a UTF-8 text file relative to the project root.",
+            parameters: {
+                type: "object",
+                properties: {
+                    path: { type: "string" },
+                    content: { type: "string" },
+                },
+                required: ["path", "content"],
+            },
+        },
+    },
+    {
+        type: "function",
+        function: {
+            name: "list_files",
+            description: "List files and directories in a project-relative folder.",
+            parameters: {
+                type: "object",
+                properties: { path: { type: "string", description: "Directory path (default .)" } },
+            },
+        },
+    },
+    {
+        type: "function",
+        function: {
+            name: "run_command",
+            description: "Run a shell command in the project directory. Prefer ekz doctor/scan when possible.",
+            parameters: {
+                type: "object",
+                properties: { command: { type: "string" } },
+                required: ["command"],
+            },
+        },
+    },
+];
+export async function executeAgentTool(cwd, name, args) {
+    switch (name) {
+        case "read_file":
+            return toolReadFile(cwd, String(args.path ?? ""));
+        case "write_file":
+            return toolWriteFile(cwd, String(args.path ?? ""), String(args.content ?? ""));
+        case "list_files":
+            return toolListFiles(cwd, args.path ? String(args.path) : ".");
+        case "run_command":
+            return toolRunCommand(cwd, String(args.command ?? ""));
+        default:
+            return `Unknown tool: ${name}`;
+    }
+}

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

@@ -0,0 +1,4 @@
+import { type EkzLocale } from "../locale.js";
+export declare function runProvidersInteractive(locale?: EkzLocale): Promise<void>;
+export declare function formatActiveProviderLabel(locale: EkzLocale): string;
+//# sourceMappingURL=ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../../src/lib/providers/ui.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AA+L9C,wBAAsB,uBAAuB,CAAC,MAAM,GAAE,SAAgB,iBAuDrE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAMnE"}