@ekzs/cli 0.3.5 → 0.3.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alberto Moises
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,6 @@
 # @ekzs/cli
 
-**Version:** 0.3.5
+**Version:** 0.3.8
 
 **Ekz** is a local coding agent for e-Kwanza Pagamento Integrado v2.4 — like Claude Code, but specialized for `@ekzs/connect`, GPO, EMIS ref, and Ticket integrations.
 
@@ -65,17 +65,17 @@ Setup required · Configuração necessária · 需要设置
 
 ### Supported providers
 
-| Provider | Example models |
-|----------|----------------|
-| **Cursor** | Requires `@cursor/sdk` (offered during setup) · `composer-2.5-fast`, `gpt-5.3-codex`, … |
-| **OpenAI** | `gpt-4o`, `gpt-4o-mini`, `o1`, `o3-mini`, … |
-| **Anthropic** | `claude-sonnet-4-20250514`, `claude-opus-4-20250514`, … |
-| **DeepSeek** | `deepseek-chat`, `deepseek-reasoner` |
-| **Kimi (Moonshot)** | `moonshot-v1-8k`, `moonshot-v1-32k`, … |
-| **Groq** | `llama-3.3-70b-versatile`, … |
-| **Mistral** | `mistral-large-latest`, `codestral-latest`, … |
-| **Google Gemini** | `gemini-2.0-flash`, `gemini-1.5-pro`, … |
-| **Ollama** | `llama3.2`, `qwen2.5`, … (local) |
+| Provider | Example models (May 2026) |
+|----------|---------------------------|
+| **Cursor** | `composer-2.5-fast`, `composer-2.5`, `claude-4.6-sonnet-thinking`, `gpt-5.5`, … |
+| **OpenAI** | `gpt-5.5`, `gpt-5.4-mini`, `gpt-4.1`, `o3`, `o4-mini`, … |
+| **Anthropic** | `claude-sonnet-4-6`, `claude-opus-4-7`, `claude-haiku-4-5-20251001`, … |
+| **DeepSeek** | `deepseek-v4-flash`, `deepseek-v4-pro` (legacy: `deepseek-chat` until Jul 2026) |
+| **Kimi (Moonshot)** | `kimi-k2.6`, `kimi-k2.5`, `moonshot-v1-8k`, … |
+| **Groq** | `llama-3.3-70b-versatile`, `openai/gpt-oss-120b`, `qwen/qwen3-32b`, … |
+| **Mistral** | `mistral-large-latest`, `codestral-latest`, `devstral-latest`, … |
+| **Google Gemini** | `gemini-3.5-flash`, `gemini-3.1-pro-preview`, `gemini-2.5-pro`, … |
+| **Ollama** | `llama3.3`, `qwen3:8b`, `deepseek-r1:8b`, … (local tags) |
 
 Manage keys anytime:
 

package/dist/commands/ask.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../src/commands/ask.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAA0B,MAAM,kBAAkB,CAAC;AAyC1E,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,mDAAmD;AACnD,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CA0B1E;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,iBAO9D;AAgDD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,iBAwEA;AAED,wBAAsB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM/E"}
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../../src/commands/ask.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,SAAS,EAA0B,MAAM,kBAAkB,CAAC;AA2C1E,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB,CAAC;AAEF,mDAAmD;AACnD,wBAAsB,cAAc,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAgC1E;AAED,wBAAsB,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,iBAO9D;AAgDD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,iBAwEA;AAED,wBAAsB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAM/E"}

package/dist/commands/ask.js

@@ -6,6 +6,8 @@ import { parseMode } from "../lib/mode.js";
 import { fail, heading, info, ok } from "../lib/output.js";
 import { loadPreferences, savePreferences } from "../lib/preferences.js";
 import { ensureAgentReady, offlineModelLabel } from "../lib/onboarding.js";
+import { localQuickAnswer } from "../lib/local-answer.js";
+import { formatTerminalAnswer } from "../lib/terminal-answer.js";
 import { executeByokAskTurn } from "../lib/providers/chat.js";
 import { executeCursorAskTurn } from "../lib/providers/cursor-runner.js";
 import { isCursorProvider, requireActiveCredentials, ProviderSetupError, } from "../lib/providers/credentials.js";
@@ -14,24 +16,29 @@ import { redactText } from "../lib/redact.js";
 import { askWithPlaceholder, formatInputPrompt } from "../lib/ui/prompt.js";
 import { inputPlaceholder } from "../lib/ui/splash.js";
 function deterministicAnswer(question, ctx, locale) {
-    const lines = ["## Ekz assistant (offline)", "", question, ""];
+    const lines = ["Ekz assistant (offline):", "", question, ""];
     if (ctx.doctor.issues.length) {
-        lines.push("### Issues", ...ctx.doctor.issues.map((i) => `- ${i}`), "");
+        lines.push("Issues:", ...ctx.doctor.issues.map((i) => `- ${i}`), "");
     }
     if (ctx.scan.length) {
-        lines.push("### Scan", ...ctx.scan.slice(0, 8).map((f) => `- \`${f.file}:${f.line}\` · ${f.message}`), "");
+        lines.push("Scan:", ...ctx.scan.slice(0, 8).map((f) => `- \`${f.file}:${f.line}\` · ${f.message}`), "");
     }
-    lines.push("### Next steps", "- Run `ekz setup` to configure language, name, and provider", "- Or `ekz --offline` for doctor/scan only");
+    lines.push("Next steps:", "- Run `ekz setup` to configure language, name, and provider", "- Or `ekz --offline` for doctor/scan only");
     return lines.join("\n");
 }
 /** Q&A via BYOK provider (no local file edits). */
 export async function executeAskTurn(options) {
     const { cwd, question, offline, quiet, locale = "pt" } = options;
+    const quick = localQuickAnswer(question, locale);
+    if (quick) {
+        console.log("\n" + quick);
+        return true;
+    }
     if (offline) {
         const ctx = await buildBootstrapContext(cwd);
         if (!quiet)
             info("Ask mode (offline) · no file edits.\n");
-        console.log("\n" + deterministicAnswer(question, ctx, locale));
+        console.log("\n" + formatTerminalAnswer(deterministicAnswer(question, ctx, locale)));
         return true;
     }
     let creds;

package/dist/commands/local-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-agent.d.ts","sourceRoot":"","sources":["../../src/commands/local-agent.ts"],"names":[],"mappings":"AAWA,OAAO,EAAsC,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAsBlF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AA2PF,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,iBA0I1D;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,aAAa,CAAC,iBAmG9F"}
+{"version":3,"file":"local-agent.d.ts","sourceRoot":"","sources":["../../src/commands/local-agent.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAsC,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAsBlF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAiQF,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,iBA0I1D;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,aAAa,CAAC,iBAmG9F"}

package/dist/commands/local-agent.js

@@ -6,9 +6,10 @@ import { inputPlaceholder, printHelp, printLangSwitch, printModeSwitch, printWel
 import { loadProjectEnv } from "../lib/env.js";
 import { ensureAgentReady, offlineAgentHint, offlineModelLabel } from "../lib/onboarding.js";
 import { resolveReplMetaCommand, isProvidersMetaCommand } from "../lib/commands-i18n.js";
-import { buildAgentPrompt, buildBootstrapContext } from "../lib/context.js";
+import { buildAgentPrompt, buildBootstrapContext, invalidateBootstrapContext, isLiteTurn, wantsLocalScan, } from "../lib/context.js";
 import { resolveComposerModel } from "../lib/composer-model.js";
 import { parseLocale, uiStrings } from "../lib/locale.js";
+import { localQuickAnswer } from "../lib/local-answer.js";
 import { modeRequiresCursorAgent, parseMode } from "../lib/mode.js";
 import { loadPreferences, savePreferences } from "../lib/preferences.js";
 import { runByokAgentTurn, usesCursorSdk } from "../lib/providers/agent-runner.js";
@@ -47,13 +48,14 @@ function providerModelLabel(creds) {
     return `${creds.definition.name} · ${creds.model}`;
 }
 async function runAgentTurn(options) {
+    const lite = options.lite ?? isLiteTurn(options.task);
     if (usesCursorSdk(options.creds)) {
         if (!options.cursorAgent) {
             fail(options.locale === "pt" ? "Sem agente Cursor activo." : "No active Cursor agent.");
             return { cursorAgent: null, ok: false };
         }
-        const ctx = await buildBootstrapContext(options.cwd);
-        const prompt = buildAgentPrompt(options.task, ctx, options.locale);
+        const ctx = await buildBootstrapContext(options.cwd, { includeScan: !lite });
+        const prompt = buildAgentPrompt(options.task, ctx, options.locale, { lite });
         try {
             await streamRun(options.cursorAgent, prompt, options.locale);
             console.log("\n");
@@ -73,6 +75,7 @@ async function runAgentTurn(options) {
         creds: options.creds,
         locale: options.locale,
         mode: options.mode,
+        lite,
     });
     return { cursorAgent: options.cursorAgent, ok: okResult };
 }
@@ -161,10 +164,12 @@ function handleMetaCommand(line, locale, cwd, currentMode) {
         return { kind: "mode", mode: next };
     }
     if (cmd === "doctor") {
+        invalidateBootstrapContext(cwd);
         void runDoctor(cwd).then(() => console.log(""));
         return { kind: "handled" };
     }
     if (cmd === "scan") {
+        invalidateBootstrapContext(cwd);
         void runScan(cwd).then(() => console.log(""));
         return { kind: "handled" };
     }
@@ -489,6 +494,21 @@ async function runRepl(opts) {
             if (live) {
                 currentOffline = false;
                 currentCreds = live;
+                if (currentMode !== "ask" && usesCursorSdk(live)) {
+                    currentAgent = await recreateAgentForMode(opts.cwd, currentAgent, currentMode, opts.apiKey, currentLocale);
+                }
+                else if (currentAgent) {
+                    await disposeAgent(currentAgent);
+                    currentAgent = null;
+                }
+            }
+            else {
+                currentOffline = true;
+                currentCreds = null;
+                if (currentAgent) {
+                    await disposeAgent(currentAgent);
+                    currentAgent = null;
+                }
             }
             continue;
         }
@@ -569,7 +589,24 @@ async function runRepl(opts) {
         }
         console.log("");
         process.stdout.write(turnDivider());
+        const quick = localQuickAnswer(line, currentLocale);
+        if (quick) {
+            console.log(quick + "\n");
+            turn++;
+            continue;
+        }
+        if (wantsLocalScan(line)) {
+            invalidateBootstrapContext(opts.cwd);
+            info(currentLocale === "pt" ? "Scan local (sem LLM)..." : "Local scan (no LLM)...");
+            await runScan(opts.cwd);
+            console.log("\n");
+            turn++;
+            continue;
+        }
         if (currentMode === "ask") {
+            if (!currentOffline && resolveCreds()) {
+                info(`${currentCreds.definition.name} · ${currentCreds.model}…`);
+            }
             await executeAskTurn({
                 cwd: opts.cwd,
                 question: line,
@@ -591,8 +628,14 @@ async function runRepl(opts) {
             fail(currentLocale === "pt" ? "Sem agente Cursor activo." : "No active Cursor agent.");
             continue;
         }
+        info(currentLocale === "pt"
+            ? `${creds.definition.name} · ${creds.model}…`
+            : currentLocale === "zh"
+                ? `${creds.definition.name} · ${creds.model}…`
+                : `${creds.definition.name} · ${creds.model}…`);
         if (currentAgent)
             await persistAgent(opts.cwd, currentAgent, creds);
+        const lite = isLiteTurn(line);
         const outcome = await runAgentTurn({
             cwd: opts.cwd,
             task: line,
@@ -600,6 +643,7 @@ async function runRepl(opts) {
             locale: currentLocale,
             mode: currentMode,
             cursorAgent: currentAgent,
+            lite,
         });
         if (outcome.cursorAgent)
             currentAgent = outcome.cursorAgent;

package/dist/lib/context.d.ts

@@ -6,7 +6,17 @@ export type BootstrapContext = {
     scan: Awaited<ReturnType<typeof collectScanFindings>>;
     env: Record<string, string>;
 };
-export declare function buildBootstrapContext(cwd: string): Promise<BootstrapContext>;
-export declare function buildAgentPrompt(task: string, ctx: BootstrapContext, locale?: EkzLocale): string;
+export declare function invalidateBootstrapContext(cwd?: string): void;
+/** Integration-heavy tasks need repo scan + full skill bundle. */
+export declare function needsIntegrationContext(task: string): boolean;
+export declare function isLiteTurn(task: string): boolean;
+export declare function wantsLocalScan(line: string): boolean;
+export declare function buildBootstrapContext(cwd: string, options?: {
+    refresh?: boolean;
+    includeScan?: boolean;
+}): Promise<BootstrapContext>;
+export declare function buildAgentPrompt(task: string, ctx: BootstrapContext, locale?: EkzLocale, options?: {
+    lite?: boolean;
+}): string;
 export declare const FIX_DEFAULT_TASK = "Audit this project's e-Kwanza v2.4 integration end-to-end.\nFix env wiring, payment rails (gpo / emis_ref / ticket), checkout flows, and webhook handlers.\nUse @ekzs/connect. Follow the loaded Ekz skills. Stay within e-Kwanza payment scope only \u2014 read unrelated code for context, do not edit it.\nAfter edits, suggest running `ekz doctor`.";
 //# sourceMappingURL=context.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/lib/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAItD,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,aAAa,CAAC;AAIlE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC;IACxD,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC;IACtD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAalF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,EAAE,MAAM,GAAE,SAAgB,GAAG,MAAM,CAoCtG;AAED,eAAO,MAAM,gBAAgB,6VAGgB,CAAC"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/lib/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAItD,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,aAAa,CAAC;AAMlE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC;IACxD,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC;IACtD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,CAAC;AASF,wBAAgB,0BAA0B,CAAC,GAAG,CAAC,EAAE,MAAM,QAGtD;AAED,kEAAkE;AAClE,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAS7D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,GACrD,OAAO,CAAC,gBAAgB,CAAC,CA6B3B;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,gBAAgB,EACrB,MAAM,GAAE,SAAgB,EACxB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,MAAM,CA4CR;AAED,eAAO,MAAM,gBAAgB,6VAGgB,CAAC"}

package/dist/lib/context.js

@@ -1,3 +1,4 @@
+import { resolve } from "path";
 import { collectDoctorResult } from "./doctor-quiet.js";
 import { collectScanFindings } from "./scan-quiet.js";
 import { loadProjectEnv } from "./env.js";
@@ -6,23 +7,81 @@ import { formatSkillsForPrompt, selectSkillsForTask } from "./skills.js";
 import { languageInstruction } from "./locale.js";
 import { agentScopeBlock } from "./scope.js";
 import { detectShellEnvironment, shellGuidanceBlock } from "./shell.js";
-export async function buildBootstrapContext(cwd) {
-    const doctor = await collectDoctorResult(cwd);
-    const scan = await collectScanFindings(cwd);
-    const { env } = loadProjectEnv(cwd);
+import { isLocalQuickTurn } from "./local-answer.js";
+import { terminalStyleInstruction } from "./terminal-answer.js";
+const bootstrapCache = new Map();
+export function invalidateBootstrapContext(cwd) {
+    if (cwd)
+        bootstrapCache.delete(resolve(cwd));
+    else
+        bootstrapCache.clear();
+}
+/** Integration-heavy tasks need repo scan + full skill bundle. */
+export function needsIntegrationContext(task) {
+    const t = task.trim();
+    if (t.length < 4)
+        return false;
+    if (isLocalQuickTurn(t)) {
+        return false;
+    }
+    return /ekwanza|webhook|gpo|emis|ticket|checkout|integr|doctor|scan|payment|cobran|multicaixa|fix|\.env|rail|sdk|connect|audit|implement|starter|projeto|project|merchant|cobrança|referência|multicaixa|appypay|oauth|env var/i.test(t);
+}
+export function isLiteTurn(task) {
+    return !needsIntegrationContext(task);
+}
+export function wantsLocalScan(line) {
+    return /\b(scan|analis[aá]r?)\b/i.test(line) && /\b(run|corre|execut|faz|do|faça)\b/i.test(line);
+}
+export async function buildBootstrapContext(cwd, options) {
+    const root = resolve(cwd);
+    const includeScan = options?.includeScan !== false;
+    if (!options?.refresh && bootstrapCache.has(root)) {
+        const cached = bootstrapCache.get(root);
+        if (!includeScan || cached.scanComplete)
+            return cached.ctx;
+    }
+    const doctor = await collectDoctorResult(root, { live: false });
+    const scan = includeScan
+        ? await collectScanFindings(root)
+        : bootstrapCache.get(root)?.ctx.scan ?? [];
+    const { env } = loadProjectEnv(root);
     const envSnapshot = {};
     for (const key of Object.keys(env)) {
         if (key.startsWith("EKWANZA_") || key.startsWith("EKZ_")) {
             envSnapshot[key] = env[key];
         }
     }
-    return { doctor, scan, env: redactEnv(envSnapshot) };
+    const ctx = {
+        doctor,
+        scan,
+        env: redactEnv(envSnapshot),
+    };
+    bootstrapCache.set(root, { ctx, scanComplete: includeScan });
+    return ctx;
 }
-export function buildAgentPrompt(task, ctx, locale = "pt") {
-    const scanHints = ctx.scan.map((f) => `${f.rule}: ${f.message}`);
-    const skills = selectSkillsForTask(task, scanHints);
-    const skillBlock = formatSkillsForPrompt(skills);
+export function buildAgentPrompt(task, ctx, locale = "pt", options) {
+    const lite = options?.lite ?? isLiteTurn(task);
+    const scanHints = lite ? [] : ctx.scan.map((f) => `${f.rule}: ${f.message}`);
+    const skills = selectSkillsForTask(task, scanHints, { lite });
+    const skillBlock = lite
+        ? `# Skill: ekz-connect\n\nScoped e-Kwanza v2.4 assistant. Use /analisar or /diagnóstico for free local checks.`
+        : formatSkillsForPrompt(skills);
     const shell = detectShellEnvironment();
+    const diagnostics = lite
+        ? {
+            issues: ctx.doctor.issues.slice(0, 6),
+            rails: ctx.doctor.rails,
+            envKeys: Object.keys(ctx.env),
+        }
+        : {
+            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,
+            shell,
+        };
     return `${skillBlock}
 
 ---
@@ -32,20 +91,13 @@ Never commit secrets.
 
 ${agentScopeBlock(locale)}
 
-${shellGuidanceBlock(locale)}
-
-${languageInstruction(locale)}
-
-## Pre-flight diagnostics (ekz 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,
-        shell,
-    }, null, 2)}
+${lite ? "" : `${shellGuidanceBlock(locale)}\n\n`}
+${languageInstruction(locale)}
+
+${terminalStyleInstruction(locale)}
+
+## Pre-flight diagnostics (ekz doctor + scan)
+${JSON.stringify(diagnostics, null, 2)}
 
 ## Task
 ${task}`;

package/dist/lib/doctor-quiet.d.ts

@@ -7,5 +7,7 @@ export type DoctorResult = {
     warnings: string[];
     health: Awaited<ReturnType<EkzConnect["healthCheck"]>> | null;
 };
-export declare function collectDoctorResult(cwd: string): Promise<DoctorResult>;
+export declare function collectDoctorResult(cwd: string, options?: {
+    live?: boolean;
+}): Promise<DoctorResult>;
 //# sourceMappingURL=doctor-quiet.d.ts.map

package/dist/lib/doctor-quiet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor-quiet.d.ts","sourceRoot":"","sources":["../../src/lib/doctor-quiet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,eAAe,CAAC;AAE1D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CAC/D,CAAC;AAEF,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAmC5E"}
+{"version":3,"file":"doctor-quiet.d.ts","sourceRoot":"","sources":["../../src/lib/doctor-quiet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAiB,MAAM,eAAe,CAAC;AAE1D,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CAC/D,CAAC;AAEF,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,GAC3B,OAAO,CAAC,YAAY,CAAC,CAkDvB"}

package/dist/lib/doctor-quiet.js

@@ -1,6 +1,7 @@
 import { EkzConnect, configFromEnv } from "@ekzs/connect";
 import { auditEnv, loadProjectEnv } from "./env.js";
-export async function collectDoctorResult(cwd) {
+export async function collectDoctorResult(cwd, options) {
+    const live = options?.live !== false;
     const { envFiles, env } = loadProjectEnv(cwd);
     const audit = auditEnv(env);
     const issues = [];
@@ -18,13 +19,26 @@ export async function collectDoctorResult(cwd) {
     }
     let health = null;
     const cfg = configFromEnv(env);
-    if (cfg) {
+    if (cfg && live) {
         health = await new EkzConnect(cfg).healthCheck();
         if (!health.oauth)
             issues.push("OAuth authentication failed");
         if (!health.configured)
             warnings.push("healthCheck.configured is false");
     }
+    else if (cfg && !live) {
+        health = {
+            oauth: false,
+            gpo: Boolean(cfg.paymentMethodIdGpo),
+            emisRef: Boolean(cfg.paymentMethodIdEmisRef),
+            ticket: Boolean(cfg.notificationToken && cfg.apiKey && cfg.partnerRegistrationNumber),
+            configured: Boolean(cfg.clientId &&
+                cfg.clientSecret &&
+                cfg.merchantIdentifier &&
+                cfg.apiKey),
+            env: cfg.env ?? "sandbox",
+        };
+    }
     else {
         issues.push("Core EKWANZA_* vars missing");
     }

package/dist/lib/local-answer.d.ts

@@ -0,0 +1,4 @@
+import type { EkzLocale } from "./locale.js";
+export declare function isLocalQuickTurn(input: string): boolean;
+export declare function localQuickAnswer(input: string, locale: EkzLocale): string | null;
+//# sourceMappingURL=local-answer.d.ts.map

package/dist/lib/local-answer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-answer.d.ts","sourceRoot":"","sources":["../../src/lib/local-answer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAO7C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAoBhF"}

package/dist/lib/local-answer.js

@@ -0,0 +1,26 @@
+const GREETING_RE = /^(olá|ola|oi|hello|hi|hey|bom dia|boa tarde|boa noite|你好|您好)[!.?\s]*$/i;
+const THANKS_RE = /^(obrigado|obrigada|thanks|thank you|valeu|谢谢|多谢)[!.?\s]*$/i;
+export function isLocalQuickTurn(input) {
+    const text = input.trim();
+    return GREETING_RE.test(text) || THANKS_RE.test(text);
+}
+export function localQuickAnswer(input, locale) {
+    const text = input.trim();
+    if (GREETING_RE.test(text)) {
+        if (locale === "zh") {
+            return "你好。我可以帮你处理 e-Kwanza 支付集成、checkout、webhook、订阅、票务和用量计费。告诉我你要接入什么，或运行 /scan 做本地诊断。";
+        }
+        if (locale === "en") {
+            return "Hello. I can help with e-Kwanza payments, checkout, webhooks, subscriptions, tickets, and overage billing. Tell me what you want to integrate, or run /scan for a local diagnostic.";
+        }
+        return "Olá. Posso ajudar com pagamentos e-Kwanza, checkout, webhooks, subscrições, tickets e cobrança de excedentes. Diz-me o que queres integrar, ou corre /scan para um diagnóstico local.";
+    }
+    if (THANKS_RE.test(text)) {
+        if (locale === "zh")
+            return "不客气。需要时我可以继续检查支付集成。";
+        if (locale === "en")
+            return "You are welcome. I can keep checking the payment integration whenever you are ready.";
+        return "De nada. Quando quiseres, posso continuar a verificar a integração de pagamentos.";
+    }
+    return null;
+}

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

@@ -7,6 +7,7 @@ export declare function runByokAgentTurn(options: {
     creds: ResolvedCredentials;
     locale: EkzLocale;
     mode: EkzMode;
+    lite?: boolean;
 }): Promise<boolean>;
 export declare function usesCursorSdk(creds: ResolvedCredentials): boolean;
 //# sourceMappingURL=agent-runner.d.ts.map

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

@@ -1 +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"}
+{"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;AAE9C,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AAI1C,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAsM5D,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;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,OAAO,CAAC,CA0DnB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAEjE"}

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

@@ -1,34 +1,40 @@
 import { resolve } from "path";
-import { buildAgentPrompt, buildBootstrapContext } from "../context.js";
-import { fail } from "../output.js";
+import { buildAgentPrompt, buildBootstrapContext, isLiteTurn, needsIntegrationContext } from "../context.js";
+import { localQuickAnswer } from "../local-answer.js";
+import { fail, warn } from "../output.js";
+import { formatTerminalAnswer } from "../terminal-answer.js";
 import { toolDone, toolError, toolRunning } from "../theme.js";
+import { deepseekRequestBody, fetchWithTimeout, resolveChatCompletionsUrl } from "./http.js";
 import { AGENT_TOOL_DEFINITIONS, executeAgentTool } from "./tools.js";
-const MAX_TOOL_ROUNDS = 24;
+const MAX_TOOL_ROUNDS = 12;
 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.";
+        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 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.";
+    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`;
+async function openAiAgentLoop(creds, cwd, messages, enableTools, thinking = true, timeoutMs) {
+    const url = resolveChatCompletionsUrl(creds.baseUrl);
     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 = {
+        const payload = {
             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) });
+            payload.tools = AGENT_TOOL_DEFINITIONS;
+        const res = await fetchWithTimeout(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(deepseekRequestBody(creds.model, payload, { thinking })),
+        }, timeoutMs);
         const data = (await res.json().catch(() => ({})));
         if (!res.ok)
             throw new Error(data.error?.message ?? `Provider error (${res.status})`);
@@ -73,7 +79,7 @@ async function openAiAgentLoop(creds, cwd, messages, enableTools) {
     }
     throw new Error("Tool loop exceeded maximum rounds.");
 }
-async function anthropicAgentLoop(creds, cwd, system, messages, enableTools) {
+async function anthropicAgentLoop(creds, cwd, system, messages, enableTools, timeoutMs) {
     const tools = enableTools
         ? AGENT_TOOL_DEFINITIONS.map((t) => ({
             name: t.function.name,
@@ -82,7 +88,7 @@ async function anthropicAgentLoop(creds, cwd, system, messages, enableTools) {
         }))
         : undefined;
     for (let round = 0; round < MAX_TOOL_ROUNDS; round++) {
-        const res = await fetch("https://api.anthropic.com/v1/messages", {
+        const res = await fetchWithTimeout("https://api.anthropic.com/v1/messages", {
             method: "POST",
             headers: {
                 "Content-Type": "application/json",
@@ -96,7 +102,7 @@ async function anthropicAgentLoop(creds, cwd, system, messages, enableTools) {
                 messages,
                 ...(tools ? { tools } : {}),
             }),
-        });
+        }, timeoutMs);
         const data = (await res.json().catch(() => ({})));
         if (!res.ok)
             throw new Error(data.error?.message ?? `Anthropic error (${res.status})`);
@@ -138,23 +144,43 @@ async function anthropicAgentLoop(creds, cwd, system, messages, enableTools) {
 }
 export async function runByokAgentTurn(options) {
     const cwd = resolve(options.cwd);
-    const ctx = await buildBootstrapContext(cwd);
-    const prompt = buildAgentPrompt(options.task, ctx, options.locale);
+    const quick = localQuickAnswer(options.task, options.locale);
+    if (quick) {
+        console.log("\n" + quick);
+        return true;
+    }
+    const lite = options.lite ?? isLiteTurn(options.task);
+    const ctx = await buildBootstrapContext(cwd, { includeScan: !lite });
+    const prompt = buildAgentPrompt(options.task, ctx, options.locale, { lite });
     const system = `${planInstruction(options.mode)}\n\n${prompt.split("## Task")[0] ?? prompt}`;
     const userTask = `## Task\n${options.task}`;
-    const enableTools = options.mode !== "ask";
+    const wantsTools = options.mode !== "ask" && !lite;
+    const enableTools = wantsTools && options.creds.definition.capabilities.supportsTools;
+    const thinking = !lite &&
+        options.creds.definition.capabilities.supportsReasoning &&
+        needsIntegrationContext(options.task);
+    const timeoutMs = lite
+        ? options.creds.definition.capabilities.liteTimeoutMs
+        : options.creds.definition.capabilities.agentTimeoutMs;
+    if (wantsTools && !enableTools) {
+        warn(options.locale === "pt"
+            ? `${options.creds.definition.name} não anuncia ferramentas de edição; vou responder sem alterar ficheiros.`
+            : options.locale === "zh"
+                ? `${options.creds.definition.name} 未声明编辑工具支持；我将只回答，不修改文件。`
+                : `${options.creds.definition.name} does not advertise edit tools; answering without changing files.`);
+    }
     try {
         if (options.creds.definition.kind === "anthropic") {
-            const text = await anthropicAgentLoop(options.creds, cwd, system, [{ role: "user", content: userTask }], enableTools);
-            console.log("\n" + text);
+            const text = await anthropicAgentLoop(options.creds, cwd, system, [{ role: "user", content: userTask }], enableTools, timeoutMs);
+            console.log("\n" + formatTerminalAnswer(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);
+        const text = await openAiAgentLoop(options.creds, cwd, messages, enableTools, thinking, timeoutMs);
+        console.log("\n" + formatTerminalAnswer(text));
         return true;
     }
     catch (err) {