@ekzs/cli 0.2.0 → 0.3.0

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,26 @@
+import { type ProviderDefinition, type ProviderId } from "./catalog.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;
+//# 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,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"}

package/dist/lib/providers/credentials.js

@@ -0,0 +1,54 @@
+import { PROVIDER_CATALOG } from "./catalog.js";
+import { providersSetupHint } from "../commands-i18n.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(providersSetupHint(locale));
+}
+export function isCursorProvider(creds) {
+    return creds.definition.kind === "cursor";
+}

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

@@ -0,0 +1,13 @@
+import { type SDKAgent } from "@cursor/sdk";
+import { type EkzLocale } from "../locale.js";
+import { type ResolvedCredentials } from "./credentials.js";
+declare function disposeAgent(agent: SDKAgent): Promise<void>;
+declare function streamRun(agent: SDKAgent, prompt: string): 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":"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"}

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

@@ -0,0 +1,87 @@
+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 { agentScopeBlock } from "../scope.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) {
+    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 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);
+        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/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;AAEtE,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,QAKtE;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,81 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { getProviderDefinition } from "./catalog.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);
+}
+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"}