@pentoshi/clai 0.2.0

package/dist/llm/router.d.ts

@@ -0,0 +1,8 @@
+import type { CompletionRequest, CompletionResult, ProviderId } from "../types.js";
+import type { LlmProvider, ProviderAuth } from "./provider.js";
+export declare const providers: Record<ProviderId, LlmProvider>;
+export declare function getProvider(provider: ProviderId): LlmProvider;
+export declare function providerAuth(provider: ProviderId): Promise<ProviderAuth>;
+export declare function completeWithProvider(request: CompletionRequest): Promise<CompletionResult>;
+export declare function streamWithProvider(request: CompletionRequest, onToken: (token: string) => void): Promise<CompletionResult>;
+export declare function pingProvider(providerId: ProviderId, secretOverride?: string): Promise<void>;

package/dist/llm/router.js

@@ -0,0 +1,103 @@
+import { getConfig } from "../store/config.js";
+import { getProviderSecret } from "../store/keys.js";
+import { anthropicProvider } from "./anthropic.js";
+import { geminiProvider } from "./gemini.js";
+import { groqProvider } from "./groq.js";
+import { ollamaProvider } from "./ollama.js";
+import { openaiProvider } from "./openai.js";
+import { openrouterProvider } from "./openrouter.js";
+export const providers = {
+    groq: groqProvider,
+    gemini: geminiProvider,
+    openrouter: openrouterProvider,
+    openai: openaiProvider,
+    anthropic: anthropicProvider,
+    ollama: ollamaProvider,
+};
+const fallbackOrder = [
+    "groq",
+    "gemini",
+    "openrouter",
+    "openai",
+    "anthropic",
+    "ollama",
+];
+export function getProvider(provider) {
+    return providers[provider];
+}
+export async function providerAuth(provider) {
+    const secret = await getProviderSecret(provider);
+    if (provider === "ollama") {
+        return { baseUrl: secret.value };
+    }
+    return { apiKey: secret.value };
+}
+export async function completeWithProvider(request) {
+    const config = getConfig();
+    const requested = request.provider ?? config.defaultProvider;
+    const order = [
+        requested,
+        ...fallbackOrder.filter((provider) => provider !== requested),
+    ];
+    const failures = [];
+    for (const providerId of order) {
+        const provider = providers[providerId];
+        const auth = await providerAuth(providerId);
+        const hasAuth = providerId === "ollama" ? Boolean(auth.baseUrl) : Boolean(auth.apiKey);
+        if (!hasAuth) {
+            failures.push(`${providerId}: no API key configured`);
+            continue;
+        }
+        try {
+            const model = providerId === requested
+                ? (request.model ?? provider.defaultModel)
+                : provider.defaultModel;
+            return await provider.complete({ ...request, provider: providerId, model }, auth);
+        }
+        catch (error) {
+            failures.push(`${providerId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    throw new Error(`No provider could complete the request. ${failures.join(" | ")}`);
+}
+export async function streamWithProvider(request, onToken) {
+    const config = getConfig();
+    const requested = request.provider ?? config.defaultProvider;
+    const order = [
+        requested,
+        ...fallbackOrder.filter((provider) => provider !== requested),
+    ];
+    const failures = [];
+    for (const providerId of order) {
+        const provider = providers[providerId];
+        const auth = await providerAuth(providerId);
+        const hasAuth = providerId === "ollama" ? Boolean(auth.baseUrl) : Boolean(auth.apiKey);
+        if (!hasAuth) {
+            failures.push(`${providerId}: no API key configured`);
+            continue;
+        }
+        try {
+            const model = providerId === requested
+                ? (request.model ?? provider.defaultModel)
+                : provider.defaultModel;
+            if (provider.stream) {
+                return await provider.stream({ ...request, provider: providerId, model }, auth, onToken);
+            }
+            const result = await provider.complete({ ...request, provider: providerId, model }, auth);
+            onToken(result.text);
+            return result;
+        }
+        catch (error) {
+            failures.push(`${providerId}: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    throw new Error(`No provider could stream the request. ${failures.join(" | ")}`);
+}
+export async function pingProvider(providerId, secretOverride) {
+    const provider = providers[providerId];
+    const auth = providerId === "ollama"
+        ? { baseUrl: secretOverride ?? (await providerAuth(providerId)).baseUrl }
+        : { apiKey: secretOverride ?? (await providerAuth(providerId)).apiKey };
+    await provider.ping(auth);
+}
+//# sourceMappingURL=router.js.map

package/dist/llm/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/llm/router.ts"],"names":[],"mappings":"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"}

package/dist/modes/agent.d.ts

@@ -0,0 +1,17 @@
+import type { ChatMessage, ProviderId, ToolCall } from "../types.js";
+import { parseToolCall } from "../agent/runner.js";
+export interface AgentOptions {
+    provider?: ProviderId | undefined;
+    model?: string | undefined;
+    history?: ChatMessage[] | undefined;
+    autoConfirm?: boolean | undefined;
+    maxSteps?: number | undefined;
+    onToolStart?: ((call: ToolCall) => void) | undefined;
+    onToolResult?: ((call: ToolCall, result: {
+        ok: boolean;
+        output: string;
+        exitCode?: number | undefined;
+    }) => void) | undefined;
+}
+export { parseToolCall };
+export declare function runAgent(prompt: string, options?: AgentOptions): Promise<string>;

package/dist/modes/agent.js

@@ -0,0 +1,6 @@
+import { runAgentLoop, parseToolCall } from "../agent/runner.js";
+export { parseToolCall };
+export async function runAgent(prompt, options = {}) {
+    return runAgentLoop(prompt, options);
+}
+//# sourceMappingURL=agent.js.map

package/dist/modes/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/modes/agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAiBjE,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,MAAc,EACd,UAAwB,EAAE;IAE1B,OAAO,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC"}

package/dist/modes/ask.d.ts

@@ -0,0 +1,8 @@
+import type { ChatMessage, ProviderId } from "../types.js";
+export interface AskOptions {
+    provider?: ProviderId | undefined;
+    model?: string | undefined;
+    history?: ChatMessage[] | undefined;
+}
+export declare function runAsk(prompt: string, options?: AskOptions): Promise<string>;
+export declare function runAskStream(prompt: string, onToken: (token: string) => void, options?: AskOptions): Promise<string>;

package/dist/modes/ask.js

@@ -0,0 +1,46 @@
+import { completeWithProvider, streamWithProvider } from "../llm/router.js";
+import { renderAskSystemPrompt } from "../prompts/index.js";
+import { getConfig } from "../store/config.js";
+import { ensureProviderConfigured } from "../commands/providers.js";
+import { loadProjectContext } from "../store/project.js";
+async function buildAskMessages(prompt, options) {
+    const config = getConfig();
+    const provider = options.provider ?? config.defaultProvider;
+    await ensureProviderConfigured(provider);
+    const projectContext = await loadProjectContext();
+    const systemPrompt = projectContext
+        ? `${renderAskSystemPrompt()}\n\nProject context from .clai/context.md:\n${projectContext}`
+        : renderAskSystemPrompt();
+    return {
+        provider,
+        model: options.model ?? config.defaultModel,
+        messages: [
+            { role: "system", content: systemPrompt },
+            ...(options.history ?? []),
+            { role: "user", content: prompt },
+        ],
+    };
+}
+export async function runAsk(prompt, options = {}) {
+    const request = await buildAskMessages(prompt, options);
+    const result = await completeWithProvider({
+        provider: request.provider,
+        model: request.model,
+        messages: request.messages,
+        temperature: 0.2,
+        maxTokens: 1_500,
+    });
+    return result.text;
+}
+export async function runAskStream(prompt, onToken, options = {}) {
+    const request = await buildAskMessages(prompt, options);
+    const result = await streamWithProvider({
+        provider: request.provider,
+        model: request.model,
+        messages: request.messages,
+        temperature: 0.2,
+        maxTokens: 1_500,
+    }, onToken);
+    return result.text;
+}
+//# sourceMappingURL=ask.js.map

package/dist/modes/ask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.js","sourceRoot":"","sources":["../../src/modes/ask.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAQzD,KAAK,UAAU,gBAAgB,CAC7B,MAAc,EACd,OAAmB;IAEnB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,MAAM,CAAC,eAAe,CAAC;IAC5D,MAAM,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,cAAc,GAAG,MAAM,kBAAkB,EAAE,CAAC;IAClD,MAAM,YAAY,GAAG,cAAc;QACjC,CAAC,CAAC,GAAG,qBAAqB,EAAE,+CAA+C,cAAc,EAAE;QAC3F,CAAC,CAAC,qBAAqB,EAAE,CAAC;IAC5B,OAAO;QACL,QAAQ;QACR,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM,CAAC,YAAY;QAC3C,QAAQ,EAAE;YACR,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE;YACzC,GAAG,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC;YAC1B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;SAClC;KACF,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,MAAc,EACd,UAAsB,EAAE;IAExB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC;QACxC,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAc,EACd,OAAgC,EAChC,UAAsB,EAAE;IAExB,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,MAAM,kBAAkB,CACrC;QACE,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,GAAG;QAChB,SAAS,EAAE,KAAK;KACjB,EACD,OAAO,CACR,CAAC;IACF,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

package/dist/os/detect.d.ts

@@ -0,0 +1,10 @@
+export interface SystemInfo {
+    platform: NodeJS.Platform;
+    osName: string;
+    arch: string;
+    release: string;
+    shell: string;
+    cwd: string;
+}
+export declare function detectSystem(): SystemInfo;
+export declare function isWindows(): boolean;

package/dist/os/detect.js

@@ -0,0 +1,17 @@
+import { arch, platform, release, type } from 'node:os';
+export function detectSystem() {
+    const currentPlatform = platform();
+    const osName = currentPlatform === 'darwin' ? 'macOS' : currentPlatform === 'win32' ? 'Windows' : type();
+    return {
+        platform: currentPlatform,
+        osName,
+        arch: arch(),
+        release: release(),
+        shell: process.env.SHELL ?? process.env.ComSpec ?? 'unknown',
+        cwd: process.cwd(),
+    };
+}
+export function isWindows() {
+    return process.platform === 'win32';
+}
+//# sourceMappingURL=detect.js.map

package/dist/os/detect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect.js","sourceRoot":"","sources":["../../src/os/detect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAWxD,MAAM,UAAU,YAAY;IAC1B,MAAM,eAAe,GAAG,QAAQ,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACzG,OAAO;QACL,QAAQ,EAAE,eAAe;QACzB,MAAM;QACN,IAAI,EAAE,IAAI,EAAE;QACZ,OAAO,EAAE,OAAO,EAAE;QAClB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,SAAS;QAC5D,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AACtC,CAAC"}

package/dist/os/pkgmgr.d.ts

@@ -0,0 +1,6 @@
+export interface PackageManager {
+    id: 'brew' | 'apt' | 'dnf' | 'pacman' | 'winget' | 'choco' | 'unknown';
+    installCommand(tool: string): string;
+}
+export declare function detectPackageManager(): Promise<PackageManager>;
+export declare function commandAvailable(command: string): Promise<boolean>;

package/dist/os/pkgmgr.js

@@ -0,0 +1,32 @@
+import { execa } from 'execa';
+async function commandExists(command) {
+    try {
+        await execa(process.platform === 'win32' ? 'where' : 'which', [command]);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export async function detectPackageManager() {
+    if (process.platform === 'darwin' && (await commandExists('brew'))) {
+        return { id: 'brew', installCommand: (tool) => `brew install ${tool}` };
+    }
+    if (process.platform === 'win32') {
+        if (await commandExists('winget'))
+            return { id: 'winget', installCommand: (tool) => `winget install ${tool}` };
+        if (await commandExists('choco'))
+            return { id: 'choco', installCommand: (tool) => `choco install ${tool}` };
+    }
+    if (await commandExists('apt'))
+        return { id: 'apt', installCommand: (tool) => `sudo apt update && sudo apt install -y ${tool}` };
+    if (await commandExists('dnf'))
+        return { id: 'dnf', installCommand: (tool) => `sudo dnf install -y ${tool}` };
+    if (await commandExists('pacman'))
+        return { id: 'pacman', installCommand: (tool) => `sudo pacman -S --needed ${tool}` };
+    return { id: 'unknown', installCommand: (tool) => `Install ${tool} with your OS package manager` };
+}
+export async function commandAvailable(command) {
+    return commandExists(command);
+}
+//# sourceMappingURL=pkgmgr.js.map

package/dist/os/pkgmgr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkgmgr.js","sourceRoot":"","sources":["../../src/os/pkgmgr.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAO9B,KAAK,UAAU,aAAa,CAAC,OAAe;IAC1C,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,MAAM,aAAa,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,gBAAgB,IAAI,EAAE,EAAE,CAAC;IAC1E,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,MAAM,aAAa,CAAC,QAAQ,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,IAAI,EAAE,EAAE,CAAC;QAC/G,IAAI,MAAM,aAAa,CAAC,OAAO,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,iBAAiB,IAAI,EAAE,EAAE,CAAC;IAC9G,CAAC;IAED,IAAI,MAAM,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,0CAA0C,IAAI,EAAE,EAAE,CAAC;IACjI,IAAI,MAAM,aAAa,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,uBAAuB,IAAI,EAAE,EAAE,CAAC;IAC9G,IAAI,MAAM,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,2BAA2B,IAAI,EAAE,EAAE,CAAC;IAExH,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,IAAI,+BAA+B,EAAE,CAAC;AACrG,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAe;IACpD,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC"}

package/dist/prompts/index.d.ts

@@ -0,0 +1,2 @@
+export declare function renderAskSystemPrompt(): string;
+export declare function renderAgentSystemPrompt(toolList: string): string;

package/dist/prompts/index.js

@@ -0,0 +1,60 @@
+import { detectSystem } from '../os/detect.js';
+const askPrompt = 'You are clai in /ask mode. Do NOT execute anything. For every user request, respond with: (1) one-line summary, (2) exact commands for their OS ({{os}}, shell={{shell}}), (3) what each command does, (4) caveats / safer alternatives.';
+const agentPrompt = `You are clai, a terminal AI agent for cybersecurity, pentesting, and sysadmin.
+OS: {{os}} | Shell: {{shell}} | CWD: {{cwd}}
+
+TOOLS (use EXACT arg names — wrong names = failure):
+- shell.exec: {"command":"<cmd>"} — run any shell command. Use full paths. cd does NOT work.
+- fs.read: {"path":"<file>"} — read a file
+- fs.write: {"path":"<file>","content":"<data>"} — write a file
+- fs.list: {"path":"<dir>"} — list directory
+- fs.search: {"pattern":"<regex>","path":"<dir>"} — search file CONTENTS (NOT filenames)
+- pkg.install: {"tool":"<name>"} — install package (only if user asks or command not found)
+- net.scan: {"target":"<ip/host>","ports":"<optional>"} — nmap scan
+- http.fetch: {"url":"<url>","method":"<optional>","body":"<optional>"} — HTTP request
+- sysinfo: {} — OS info
+- pentest.recon: {"target":"<ip/host>"} — whois + dig + nmap
+
+FORMAT — one tool per response:
+\`\`\`tool
+{"name":"shell.exec","args":{"command":"curl -s ifconfig.me"}}
+\`\`\`
+
+RULES:
+1. STAY ON TASK. Do EXACTLY what the user asked. Do NOT add extra scans, installs, or exploration.
+2. One tool per response. 1-2 lines of thinking MAX before the tool block.
+3. To find files/dirs by name: shell.exec find /path -maxdepth 3 -name '*pattern*'
+4. CONTINUE until the original task is done. Resolve sub-problems then proceed.
+5. Use conversation history for follow-ups. "it", "that", "such" = context from previous messages.
+6. Suppress noise: curl -s, wget -q. Always use full absolute paths.
+7. Never run cd, pwd, or re-list directories you already listed.
+8. Only pentest systems the user owns or has permission to test.
+
+EXAMPLE — user asks "directory scan on example.com, seclists in /opt":
+Step 1: Find the wordlist → shell.exec find /opt -maxdepth 3 -type d -name 'Discovery'
+Step 2: List wordlists → fs.list /opt/wordlist/SecLists/Discovery/Web-Content
+Step 3: Run scan → shell.exec gobuster dir -u https://example.com -w /opt/wordlist/SecLists/Discovery/Web-Content/common.txt -q
+Step 4: Report findings. DONE.
+Do NOT: scan localhost, fetch random ports, search file contents, install tools, or do anything else.`;
+function render(template, values) {
+    return Object.entries(values).reduce((current, [key, value]) => current.replaceAll(`{{${key}}}`, value), template);
+}
+export function renderAskSystemPrompt() {
+    const system = detectSystem();
+    return render(askPrompt, {
+        os: `${system.osName} ${system.release} ${system.arch}`,
+        shell: system.shell,
+        cwd: system.cwd,
+        tool_list: 'none',
+    });
+}
+export function renderAgentSystemPrompt(toolList) {
+    const system = detectSystem();
+    return render(agentPrompt, {
+        os: `${system.osName} ${system.release} ${system.arch}`,
+        shell: system.shell,
+        cwd: system.cwd,
+        tool_list: toolList,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/prompts/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,SAAS,GAAG,0OAA0O,CAAC;AAE7P,MAAM,WAAW,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sGAmCkF,CAAC;AAGvG,SAAS,MAAM,CAAC,QAAgB,EAAE,MAA8B;IAC9D,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,CAAC;AACrH,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,MAAM,CAAC,SAAS,EAAE;QACvB,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE;QACvD,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,SAAS,EAAE,MAAM;KAClB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAC9B,OAAO,MAAM,CAAC,WAAW,EAAE;QACzB,EAAE,EAAE,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE;QACvD,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,GAAG,EAAE,MAAM,CAAC,GAAG;QACf,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;AACL,CAAC"}

package/dist/repl.d.ts

@@ -0,0 +1,7 @@
+import type { Mode, ProviderId } from "./types.js";
+export interface ReplOptions {
+    mode?: Mode | undefined;
+    provider?: ProviderId | undefined;
+    model?: string | undefined;
+}
+export declare function startRepl(options?: ReplOptions): Promise<void>;

package/dist/repl.js

@@ -0,0 +1,216 @@
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import chalk from "chalk";
+import { runAskStream } from "./modes/ask.js";
+import { runAgent } from "./modes/agent.js";
+import { providerSwitcher, printProviderKeys, setProviderKey, unsetProviderKey, } from "./commands/providers.js";
+import { getConfig, getProviderModel, setDefaultMode, setProviderModel, updateConfig, } from "./store/config.js";
+import { listSessions, saveSession } from "./store/history.js";
+import { assertProvider } from "./llm/provider.js";
+import { runUpdate, checkForUpdateSilent, getCurrentVersion } from "./commands/update.js";
+import { renderBanner, renderSessionInfo, renderSuggestions, renderModeSwitch, renderProviderSwitch, PROMPT, } from "./ui/banner.js";
+function splitCommand(line) {
+    return (line
+        .match(/(?:[^\s"]+|"[^"]*")+/g)
+        ?.map((part) => part.replace(/^"|"$/g, "")) ?? []);
+}
+function help() {
+    const cmds = [
+        ["/ask", "switch to ask mode"],
+        ["/agent", "switch to agent mode"],
+        ["/model <name>", "switch model"],
+        ["/provider [name]", "switch provider or open picker"],
+        ["/use <provider>", "alias for /provider <name>"],
+        ["/set <provider> [key]", "store API key"],
+        ["/unset <provider>", "remove key"],
+        ["/keys", "list configured providers"],
+        ["/clear", "clear context"],
+        ["/history", "show past sessions"],
+        ["/save <name>", "save session"],
+        ["/cwd <path>", "change working directory"],
+        ["/allow <tool>", "allow a tool for session"],
+        ["/update", "check for updates"],
+        ["/exit", "quit"],
+        ["/help", "list commands"],
+    ];
+    const maxCmd = Math.max(...cmds.map((c) => c[0].length));
+    return cmds
+        .map((c) => `  ${chalk.cyan(c[0].padEnd(maxCmd + 2))}${chalk.dim(c[1])}`)
+        .join("\n");
+}
+async function handleSlash(line, state) {
+    const [command, ...args] = splitCommand(line);
+    switch (command) {
+        case "/ask":
+            state.mode = "ask";
+            setDefaultMode("ask");
+            console.log(renderModeSwitch("ask"));
+            return true;
+        case "/agent":
+            state.mode = "agent";
+            setDefaultMode("agent");
+            console.log(renderModeSwitch("agent"));
+            return true;
+        case "/model": {
+            const model = args.join(" ");
+            if (!model)
+                console.log(chalk.dim("usage: /model <name>"));
+            else {
+                state.model = model;
+                setProviderModel(state.provider, model);
+                console.log(renderProviderSwitch(state.provider, model));
+            }
+            return true;
+        }
+        case "/provider":
+        case "/use": {
+            await providerSwitcher(args[0]);
+            const config = getConfig();
+            state.provider = config.defaultProvider;
+            state.model = getProviderModel(state.provider);
+            console.log(renderProviderSwitch(state.provider, state.model));
+            return true;
+        }
+        case "/set": {
+            if (!args[0])
+                console.log(chalk.dim("usage: /set <provider> [key]"));
+            else
+                await setProviderKey(args[0], args[1], {});
+            return true;
+        }
+        case "/unset": {
+            if (!args[0])
+                console.log(chalk.dim("usage: /unset <provider>"));
+            else
+                await unsetProviderKey(args[0]);
+            return true;
+        }
+        case "/keys":
+            await printProviderKeys();
+            return true;
+        case "/clear":
+            state.messages.length = 0;
+            console.log(chalk.dim("  context cleared"));
+            return true;
+        case "/history": {
+            const sessions = await listSessions();
+            if (sessions.length === 0)
+                console.log(chalk.dim("  no saved sessions"));
+            for (const session of sessions) {
+                console.log(chalk.dim("  ") +
+                    `${session.createdAt} ${session.name ?? session.id} ${chalk.dim(`(${session.messages.length} msgs)`)}`);
+            }
+            return true;
+        }
+        case "/save": {
+            const record = await saveSession(state.messages, args.join(" ") || undefined);
+            console.log(chalk.dim(`  saved session ${record.id}`));
+            return true;
+        }
+        case "/cwd": {
+            const dir = args.join(" ");
+            if (!dir)
+                console.log(chalk.dim(`  ${process.cwd()}`));
+            else {
+                process.chdir(dir);
+                const config = getConfig();
+                updateConfig({
+                    sandboxRoots: Array.from(new Set([...config.sandboxRoots, process.cwd()])),
+                });
+                console.log(chalk.dim(`  cwd → ${process.cwd()}`));
+            }
+            return true;
+        }
+        case "/allow": {
+            const tool = args[0];
+            if (!tool)
+                console.log(chalk.dim("usage: /allow <tool>"));
+            else {
+                const config = getConfig();
+                updateConfig({
+                    allowAlwaysTools: Array.from(new Set([...config.allowAlwaysTools, tool])),
+                });
+                console.log(chalk.dim(`  allowed ${tool} ✓`));
+            }
+            return true;
+        }
+        case "/exit":
+        case "/quit":
+            return false;
+        case "/update":
+            await runUpdate();
+            return true;
+        case "/help":
+            console.log(help());
+            return true;
+        default:
+            console.log(chalk.dim(`  unknown command: ${command}. Try /help`));
+            return true;
+    }
+}
+export async function startRepl(options = {}) {
+    const config = getConfig();
+    const state = {
+        mode: options.mode ?? config.defaultMode,
+        provider: options.provider ?? config.defaultProvider,
+        model: options.model ?? config.defaultModel,
+        messages: [],
+    };
+    if (options.provider) {
+        state.provider = assertProvider(options.provider);
+    }
+    const rl = readline.createInterface({ input, output });
+    // ── Startup banner ──────────────────────────────────────────────────────
+    console.log(renderBanner(getCurrentVersion()));
+    console.log(renderSessionInfo({
+        workdir: process.cwd(),
+        model: state.model,
+        provider: state.provider,
+        mode: state.mode,
+    }));
+    console.log(renderSuggestions());
+    console.log();
+    // Non-blocking update check
+    checkForUpdateSilent();
+    try {
+        while (true) {
+            const line = (await rl.question(PROMPT)).trim();
+            if (!line)
+                continue;
+            if (line.startsWith("/")) {
+                const shouldContinue = await handleSlash(line, state);
+                if (!shouldContinue)
+                    break;
+                continue;
+            }
+            try {
+                const answer = state.mode === "ask"
+                    ? await runAskStream(line, (token) => process.stdout.write(token), {
+                        provider: state.provider,
+                        model: state.model,
+                        history: state.messages,
+                    })
+                    : await runAgent(line, {
+                        provider: state.provider,
+                        model: state.model,
+                        history: state.messages,
+                    });
+                if (state.mode === "ask") {
+                    process.stdout.write("\n");
+                }
+                console.log(); // breathing room between exchanges
+                state.messages.push({ role: "user", content: line }, { role: "assistant", content: answer });
+            }
+            catch (error) {
+                console.error(chalk.red(error instanceof Error ? error.message : String(error)));
+            }
+        }
+    }
+    finally {
+        if (state.messages.length > 0) {
+            await saveSession(state.messages, `repl-${new Date().toISOString()}`);
+        }
+        rl.close();
+    }
+}
+//# sourceMappingURL=repl.js.map

package/dist/repl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.js","sourceRoot":"","sources":["../src/repl.ts"],"names":[],"mappings":"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"}

package/dist/safety/classifier.d.ts

@@ -0,0 +1,8 @@
+import type { RiskLevel, ToolCall } from "../types.js";
+export interface RiskDecision {
+    level: RiskLevel;
+    reason: string;
+}
+export declare function isPrivateIpv4(value: string): boolean;
+export declare function isPentestToolCall(call: ToolCall): boolean;
+export declare function classifyToolCall(call: ToolCall): RiskDecision;