@blockrun/clawrouter 0.12.95 → 0.12.97

package/dist/doctor.js

@@ -0,0 +1,375 @@
+/**
+ * BlockRun Doctor - AI-Powered Diagnostics
+ *
+ * Collects system diagnostics and sends to Claude Opus 4.6 for analysis.
+ * Works independently of OpenClaw - direct x402 payment to BlockRun API.
+ */
+import { platform, arch, freemem, totalmem } from "node:os";
+import { createPublicClient, http } from "viem";
+import { base } from "viem/chains";
+import { privateKeyToAccount } from "viem/accounts";
+import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
+import { registerExactEvmScheme } from "@x402/evm/exact/client";
+import { toClientEvmSigner } from "@x402/evm";
+import { resolveOrGenerateWalletKey, resolvePaymentChain, WALLET_FILE } from "./auth.js";
+import { BalanceMonitor } from "./balance.js";
+import { getSolanaAddress } from "./wallet.js";
+import { getStats } from "./stats.js";
+import { getProxyPort } from "./proxy.js";
+import { VERSION } from "./version.js";
+// Helpers
+function formatBytes(bytes) {
+    const gb = bytes / (1024 * 1024 * 1024);
+    return `${gb.toFixed(1)}GB`;
+}
+function green(text) {
+    return `\x1b[32m✓\x1b[0m ${text}`;
+}
+function red(text) {
+    return `\x1b[31m✗\x1b[0m ${text}`;
+}
+function yellow(text) {
+    return `\x1b[33m⚠\x1b[0m ${text}`;
+}
+// Collect system info
+function collectSystemInfo() {
+    return {
+        os: `${platform()} ${arch()}`,
+        arch: arch(),
+        nodeVersion: process.version,
+        memoryFree: formatBytes(freemem()),
+        memoryTotal: formatBytes(totalmem()),
+    };
+}
+// Collect wallet info
+async function collectWalletInfo() {
+    try {
+        const { key, address, source, solanaPrivateKeyBytes } = await resolveOrGenerateWalletKey();
+        if (!key || !address) {
+            return {
+                exists: false,
+                valid: false,
+                address: null,
+                solanaAddress: null,
+                balance: null,
+                isLow: false,
+                isEmpty: true,
+                source: null,
+                paymentChain: "base",
+            };
+        }
+        // Derive Solana address if mnemonic-based wallet
+        let solanaAddress = null;
+        if (solanaPrivateKeyBytes) {
+            try {
+                solanaAddress = await getSolanaAddress(solanaPrivateKeyBytes);
+            }
+            catch {
+                // Non-fatal
+            }
+        }
+        // Check balance on the active payment chain
+        const paymentChain = await resolvePaymentChain();
+        try {
+            let balanceInfo;
+            if (paymentChain === "solana" && solanaAddress) {
+                const { SolanaBalanceMonitor } = await import("./solana-balance.js");
+                const monitor = new SolanaBalanceMonitor(solanaAddress);
+                balanceInfo = await monitor.checkBalance();
+            }
+            else {
+                const monitor = new BalanceMonitor(address);
+                balanceInfo = await monitor.checkBalance();
+            }
+            return {
+                exists: true,
+                valid: true,
+                address,
+                solanaAddress,
+                balance: balanceInfo.balanceUSD,
+                isLow: balanceInfo.isLow,
+                isEmpty: balanceInfo.isEmpty,
+                source,
+                paymentChain,
+            };
+        }
+        catch {
+            return {
+                exists: true,
+                valid: true,
+                address,
+                solanaAddress,
+                balance: null,
+                isLow: false,
+                isEmpty: false,
+                source,
+                paymentChain,
+            };
+        }
+    }
+    catch {
+        return {
+            exists: false,
+            valid: false,
+            address: null,
+            solanaAddress: null,
+            balance: null,
+            isLow: false,
+            isEmpty: true,
+            source: null,
+            paymentChain: "base",
+        };
+    }
+}
+// Collect network info
+async function collectNetworkInfo() {
+    const port = getProxyPort();
+    // Check BlockRun API
+    let blockrunReachable = false;
+    let blockrunLatency = null;
+    try {
+        const start = Date.now();
+        const response = await fetch("https://blockrun.ai/api/v1/models", {
+            method: "GET",
+            signal: AbortSignal.timeout(10000),
+        });
+        blockrunLatency = Date.now() - start;
+        blockrunReachable = response.ok || response.status === 402;
+    }
+    catch {
+        // blockrunReachable already false
+    }
+    // Check local proxy
+    let proxyRunning = false;
+    try {
+        const response = await fetch(`http://127.0.0.1:${port}/health`, {
+            method: "GET",
+            signal: AbortSignal.timeout(3000),
+        });
+        proxyRunning = response.ok;
+    }
+    catch {
+        // proxyRunning already false
+    }
+    return {
+        blockrunApi: { reachable: blockrunReachable, latencyMs: blockrunLatency },
+        localProxy: { running: proxyRunning, port },
+    };
+}
+// Collect log info
+async function collectLogInfo() {
+    try {
+        const stats = await getStats(1); // Last 1 day
+        return {
+            requestsLast24h: stats.totalRequests,
+            costLast24h: `$${stats.totalCost.toFixed(4)}`,
+            errorsFound: 0, // TODO: parse error logs
+        };
+    }
+    catch {
+        return {
+            requestsLast24h: 0,
+            costLast24h: "$0.00",
+            errorsFound: 0,
+        };
+    }
+}
+// Identify issues
+function identifyIssues(result) {
+    const issues = [];
+    if (!result.wallet.exists) {
+        issues.push("No wallet found");
+    }
+    if (result.wallet.isEmpty) {
+        const chain = result.wallet.paymentChain === "solana" ? "Solana" : "Base";
+        issues.push(`Wallet is empty - need to fund with USDC on ${chain}`);
+        if (result.wallet.paymentChain === "base" && result.wallet.solanaAddress) {
+            issues.push("Tip: if you funded Solana, run /wallet solana to switch chains");
+        }
+    }
+    else if (result.wallet.isLow) {
+        issues.push("Wallet balance is low (< $1.00)");
+    }
+    if (!result.network.blockrunApi.reachable) {
+        issues.push("Cannot reach BlockRun API - check internet connection");
+    }
+    if (!result.network.localProxy.running) {
+        issues.push(`Local proxy not running on port ${result.network.localProxy.port}`);
+    }
+    return issues;
+}
+// Print diagnostics to terminal
+function printDiagnostics(result) {
+    console.log("\n🔍 Collecting diagnostics...\n");
+    // System
+    console.log("System");
+    console.log(`  ${green(`OS: ${result.system.os}`)}`);
+    console.log(`  ${green(`Node: ${result.system.nodeVersion}`)}`);
+    console.log(`  ${green(`Memory: ${result.system.memoryFree} free / ${result.system.memoryTotal}`)}`);
+    // Wallet
+    console.log("\nWallet");
+    if (result.wallet.exists && result.wallet.valid) {
+        console.log(`  ${green(`Key: ${WALLET_FILE} (${result.wallet.source})`)}`);
+        console.log(`  ${green(`EVM Address:    ${result.wallet.address}`)}`);
+        if (result.wallet.solanaAddress) {
+            console.log(`  ${green(`Solana Address: ${result.wallet.solanaAddress}`)}`);
+        }
+        const chainLabel = result.wallet.paymentChain === "solana" ? "Solana" : "Base";
+        console.log(`  ${green(`Chain: ${chainLabel}`)}`);
+        if (result.wallet.isEmpty) {
+            console.log(`  ${red(`Balance: $0.00 - NEED TO FUND WITH USDC ON ${chainLabel.toUpperCase()}!`)}`);
+            if (result.wallet.paymentChain === "base" && result.wallet.solanaAddress) {
+                console.log(`  ${yellow(`Tip: funded Solana instead? Run /wallet solana to switch`)}`);
+            }
+        }
+        else if (result.wallet.isLow) {
+            console.log(`  ${yellow(`Balance: ${result.wallet.balance} (low)`)}`);
+        }
+        else if (result.wallet.balance) {
+            console.log(`  ${green(`Balance: ${result.wallet.balance}`)}`);
+        }
+        else {
+            console.log(`  ${yellow(`Balance: checking...`)}`);
+        }
+    }
+    else {
+        console.log(`  ${red("No wallet found")}`);
+    }
+    // Network
+    console.log("\nNetwork");
+    if (result.network.blockrunApi.reachable) {
+        console.log(`  ${green(`BlockRun API: reachable (${result.network.blockrunApi.latencyMs}ms)`)}`);
+    }
+    else {
+        console.log(`  ${red("BlockRun API: unreachable")}`);
+    }
+    if (result.network.localProxy.running) {
+        console.log(`  ${green(`Local proxy: running on :${result.network.localProxy.port}`)}`);
+    }
+    else {
+        console.log(`  ${red(`Local proxy: not running on :${result.network.localProxy.port}`)}`);
+    }
+    // Logs
+    console.log("\nLogs");
+    console.log(`  ${green(`Last 24h: ${result.logs.requestsLast24h} requests, ${result.logs.costLast24h} spent`)}`);
+    if (result.logs.errorsFound > 0) {
+        console.log(`  ${yellow(`${result.logs.errorsFound} errors found in logs`)}`);
+    }
+    // Issues summary
+    if (result.issues.length > 0) {
+        console.log("\n⚠️  Issues Found:");
+        for (const issue of result.issues) {
+            console.log(`  • ${issue}`);
+        }
+    }
+}
+const DOCTOR_MODELS = {
+    sonnet: {
+        id: "anthropic/claude-sonnet-4.6",
+        name: "Claude Sonnet 4.6",
+        cost: "~$0.003",
+    },
+    opus: {
+        id: "anthropic/claude-opus-4.6",
+        name: "Claude Opus 4.6",
+        cost: "~$0.01",
+    },
+};
+// Send to AI for analysis
+async function analyzeWithAI(diagnostics, userQuestion, model = "sonnet") {
+    // Check if wallet has funds
+    if (diagnostics.wallet.isEmpty) {
+        console.log("\n💳 Wallet is empty - cannot call AI for analysis.");
+        console.log(`   Fund your EVM wallet with USDC on Base: ${diagnostics.wallet.address}`);
+        if (diagnostics.wallet.solanaAddress) {
+            console.log(`   Fund your Solana wallet with USDC: ${diagnostics.wallet.solanaAddress}`);
+        }
+        console.log("   Get USDC: https://www.coinbase.com/price/usd-coin");
+        console.log("   Bridge to Base: https://bridge.base.org\n");
+        return;
+    }
+    const modelConfig = DOCTOR_MODELS[model];
+    console.log(`\n📤 Sending to ${modelConfig.name} (${modelConfig.cost})...\n`);
+    try {
+        const { key } = await resolveOrGenerateWalletKey();
+        const account = privateKeyToAccount(key);
+        const publicClient = createPublicClient({ chain: base, transport: http() });
+        const evmSigner = toClientEvmSigner(account, publicClient);
+        const x402 = new x402Client();
+        registerExactEvmScheme(x402, { signer: evmSigner });
+        const paymentFetch = wrapFetchWithPayment(fetch, x402);
+        const response = await paymentFetch("https://blockrun.ai/api/v1/chat/completions", {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                model: modelConfig.id,
+                stream: false,
+                messages: [
+                    {
+                        role: "system",
+                        content: `You are a technical support expert for BlockRun and ClawRouter.
+Analyze the diagnostics and:
+1. Identify the root cause of any issues
+2. Provide specific, actionable fix commands (bash)
+3. Explain why the issue occurred briefly
+4. Be concise but thorough
+5. Format commands in code blocks`,
+                    },
+                    {
+                        role: "user",
+                        content: userQuestion
+                            ? `Here are my system diagnostics:\n\n${JSON.stringify(diagnostics, null, 2)}\n\nUser's question: ${userQuestion}`
+                            : `Here are my system diagnostics:\n\n${JSON.stringify(diagnostics, null, 2)}\n\nPlease analyze and help me fix any issues.`,
+                    },
+                ],
+                max_tokens: 1000,
+            }),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            console.log(`Error: ${response.status} - ${text}`);
+            return;
+        }
+        const data = await response.json();
+        const content = data.choices?.[0]?.message?.content;
+        if (content) {
+            console.log("🤖 AI Analysis:\n");
+            console.log(content);
+            console.log();
+        }
+        else {
+            console.log("Error: No response from AI");
+        }
+    }
+    catch (err) {
+        console.log(`\nError calling AI: ${err instanceof Error ? err.message : String(err)}`);
+        console.log("Try again or check your wallet balance.\n");
+    }
+}
+// Main entry point
+export async function runDoctor(userQuestion, model = "sonnet") {
+    console.log(`\n🩺 BlockRun Doctor v${VERSION}\n`);
+    // Collect all diagnostics
+    const [system, wallet, network, logs] = await Promise.all([
+        collectSystemInfo(),
+        collectWalletInfo(),
+        collectNetworkInfo(),
+        collectLogInfo(),
+    ]);
+    const result = {
+        version: VERSION,
+        timestamp: new Date().toISOString(),
+        system,
+        wallet,
+        network,
+        logs,
+        issues: [],
+    };
+    // Identify issues
+    result.issues = identifyIssues(result);
+    // Print to terminal
+    printDiagnostics(result);
+    // Send to AI for analysis
+    await analyzeWithAI(result, userQuestion, model);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/error-classification.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=error-classification.test.d.ts.map

package/dist/error-classification.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification.test.d.ts","sourceRoot":"","sources":["../src/error-classification.test.ts"],"names":[],"mappings":""}

package/dist/error-classification.test.js

@@ -0,0 +1,59 @@
+import { describe, it, expect } from "bun:test";
+import { categorizeError } from "./proxy.js";
+describe("categorizeError", () => {
+    it("classifies 401 as auth_failure", () => {
+        expect(categorizeError(401, "Unauthorized")).toBe("auth_failure");
+        expect(categorizeError(401, "api key invalid")).toBe("auth_failure");
+        expect(categorizeError(401, "")).toBe("auth_failure");
+    });
+    it("classifies 403 with quota body as quota_exceeded", () => {
+        expect(categorizeError(403, "plan limit reached")).toBe("quota_exceeded");
+        expect(categorizeError(403, "quota exceeded for this month")).toBe("quota_exceeded");
+        expect(categorizeError(403, "subscription required")).toBe("quota_exceeded");
+    });
+    it("classifies 403 without quota body as auth_failure", () => {
+        expect(categorizeError(403, "Forbidden")).toBe("auth_failure");
+        expect(categorizeError(403, "")).toBe("auth_failure");
+    });
+    it("classifies 402 as payment_error", () => {
+        expect(categorizeError(402, "payment required")).toBe("payment_error");
+        expect(categorizeError(402, "")).toBe("payment_error");
+    });
+    it("classifies 429 as rate_limited", () => {
+        expect(categorizeError(429, "rate limit exceeded")).toBe("rate_limited");
+        expect(categorizeError(429, "")).toBe("rate_limited");
+    });
+    it("classifies 529 as overloaded", () => {
+        expect(categorizeError(529, "")).toBe("overloaded");
+        expect(categorizeError(529, "overloaded")).toBe("overloaded");
+    });
+    it("classifies 503 with overload body as overloaded", () => {
+        expect(categorizeError(503, "service overloaded, try again")).toBe("overloaded");
+        expect(categorizeError(503, "over capacity")).toBe("overloaded");
+        expect(categorizeError(503, "too many requests")).toBe("overloaded");
+    });
+    it("classifies 503 without overload body as server_error", () => {
+        expect(categorizeError(503, "service unavailable")).toBe("server_error");
+        expect(categorizeError(503, "")).toBe("server_error");
+    });
+    it("classifies 5xx as server_error", () => {
+        expect(categorizeError(500, "internal server error")).toBe("server_error");
+        expect(categorizeError(502, "bad gateway")).toBe("server_error");
+        expect(categorizeError(504, "gateway timeout")).toBe("server_error");
+    });
+    it("classifies 413 with size body as config_error", () => {
+        expect(categorizeError(413, "request too large")).toBe("config_error");
+        expect(categorizeError(413, "payload too large")).toBe("config_error");
+    });
+    it("classifies 200 as null (not a provider error)", () => {
+        expect(categorizeError(200, "ok")).toBeNull();
+    });
+    it("classifies bare 400 with no pattern match as null", () => {
+        expect(categorizeError(400, "bad request")).toBeNull();
+    });
+    it("classifies 400 with billing body as config_error", () => {
+        expect(categorizeError(400, "billing issue with account")).toBe("config_error");
+        expect(categorizeError(400, "insufficient balance")).toBe("config_error");
+    });
+});
+//# sourceMappingURL=error-classification.test.js.map

package/dist/error-classification.test.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Typed Error Classes for ClawRouter
+ *
+ * Provides structured errors for balance-related failures with
+ * all necessary information for user-friendly error messages.
+ */
+/**
+ * Thrown when wallet has insufficient USDC balance for a request.
+ */
+export declare class InsufficientFundsError extends Error {
+    readonly code: "INSUFFICIENT_FUNDS";
+    readonly currentBalanceUSD: string;
+    readonly requiredUSD: string;
+    readonly walletAddress: string;
+    constructor(opts: {
+        currentBalanceUSD: string;
+        requiredUSD: string;
+        walletAddress: string;
+    });
+}
+/**
+ * Thrown when wallet has no USDC balance (or effectively zero).
+ */
+export declare class EmptyWalletError extends Error {
+    readonly code: "EMPTY_WALLET";
+    readonly walletAddress: string;
+    constructor(walletAddress: string);
+}
+/**
+ * Type guard to check if an error is InsufficientFundsError.
+ */
+export declare function isInsufficientFundsError(error: unknown): error is InsufficientFundsError;
+/**
+ * Type guard to check if an error is EmptyWalletError.
+ */
+export declare function isEmptyWalletError(error: unknown): error is EmptyWalletError;
+/**
+ * Type guard to check if an error is a balance-related error.
+ */
+export declare function isBalanceError(error: unknown): error is InsufficientFundsError | EmptyWalletError;
+/**
+ * Thrown when RPC call fails (network error, node down, etc).
+ * Distinguishes infrastructure failures from actual empty wallets.
+ */
+export declare class RpcError extends Error {
+    readonly code: "RPC_ERROR";
+    readonly originalError: unknown;
+    constructor(message: string, originalError?: unknown);
+}
+/**
+ * Type guard to check if an error is RpcError.
+ */
+export declare function isRpcError(error: unknown): error is RpcError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,IAAI,EAAG,oBAAoB,CAAU;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEnB,IAAI,EAAE;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE;CAa5F;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAG,cAAc,CAAU;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;gBAEnB,aAAa,EAAE,MAAM;CAYlC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,CAExF;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,gBAAgB,CAE5E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,sBAAsB,GAAG,gBAAgB,CAEjG;AAED;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAG,WAAW,CAAU;IACrC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;gBAEpB,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,OAAO;CAKrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D"}

package/dist/errors.js

@@ -0,0 +1,85 @@
+/**
+ * Typed Error Classes for ClawRouter
+ *
+ * Provides structured errors for balance-related failures with
+ * all necessary information for user-friendly error messages.
+ */
+/**
+ * Thrown when wallet has insufficient USDC balance for a request.
+ */
+export class InsufficientFundsError extends Error {
+    code = "INSUFFICIENT_FUNDS";
+    currentBalanceUSD;
+    requiredUSD;
+    walletAddress;
+    constructor(opts) {
+        const msg = [
+            `Insufficient balance. Current: ${opts.currentBalanceUSD}, Required: ${opts.requiredUSD}`,
+            `Options:`,
+            `  1. Fund wallet: ${opts.walletAddress}`,
+            `  2. Use free model: /model free`,
+        ].join("\n");
+        super(msg);
+        this.name = "InsufficientFundsError";
+        this.currentBalanceUSD = opts.currentBalanceUSD;
+        this.requiredUSD = opts.requiredUSD;
+        this.walletAddress = opts.walletAddress;
+    }
+}
+/**
+ * Thrown when wallet has no USDC balance (or effectively zero).
+ */
+export class EmptyWalletError extends Error {
+    code = "EMPTY_WALLET";
+    walletAddress;
+    constructor(walletAddress) {
+        const msg = [
+            `No USDC balance.`,
+            `Options:`,
+            `  1. Fund wallet: ${walletAddress}`,
+            `  2. Use free model: /model free`,
+            `  3. Uninstall: bash ~/.openclaw/extensions/clawrouter/scripts/uninstall.sh`,
+        ].join("\n");
+        super(msg);
+        this.name = "EmptyWalletError";
+        this.walletAddress = walletAddress;
+    }
+}
+/**
+ * Type guard to check if an error is InsufficientFundsError.
+ */
+export function isInsufficientFundsError(error) {
+    return error instanceof Error && error.code === "INSUFFICIENT_FUNDS";
+}
+/**
+ * Type guard to check if an error is EmptyWalletError.
+ */
+export function isEmptyWalletError(error) {
+    return error instanceof Error && error.code === "EMPTY_WALLET";
+}
+/**
+ * Type guard to check if an error is a balance-related error.
+ */
+export function isBalanceError(error) {
+    return isInsufficientFundsError(error) || isEmptyWalletError(error);
+}
+/**
+ * Thrown when RPC call fails (network error, node down, etc).
+ * Distinguishes infrastructure failures from actual empty wallets.
+ */
+export class RpcError extends Error {
+    code = "RPC_ERROR";
+    originalError;
+    constructor(message, originalError) {
+        super(`RPC error: ${message}. Check network connectivity.`);
+        this.name = "RpcError";
+        this.originalError = originalError;
+    }
+}
+/**
+ * Type guard to check if an error is RpcError.
+ */
+export function isRpcError(error) {
+    return error instanceof Error && error.code === "RPC_ERROR";
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACtC,IAAI,GAAG,oBAA6B,CAAC;IACrC,iBAAiB,CAAS;IAC1B,WAAW,CAAS;IACpB,aAAa,CAAS;IAE/B,YAAY,IAA+E;QACzF,MAAM,GAAG,GAAG;YACV,kCAAkC,IAAI,CAAC,iBAAiB,eAAe,IAAI,CAAC,WAAW,EAAE;YACzF,UAAU;YACV,qBAAqB,IAAI,CAAC,aAAa,EAAE;YACzC,kCAAkC;SACnC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC;QAChD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC;IAC1C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,GAAG,cAAuB,CAAC;IAC/B,aAAa,CAAS;IAE/B,YAAY,aAAqB;QAC/B,MAAM,GAAG,GAAG;YACV,kBAAkB;YAClB,UAAU;YACV,qBAAqB,aAAa,EAAE;YACpC,kCAAkC;YAClC,6EAA6E;SAC9E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,KAAK,CAAC,GAAG,CAAC,CAAC;QACX,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,KAAK,YAAY,KAAK,IAAK,KAAgC,CAAC,IAAI,KAAK,oBAAoB,CAAC;AACnG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,KAAK,IAAK,KAA0B,CAAC,IAAI,KAAK,cAAc,CAAC;AACvF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,wBAAwB,CAAC,KAAK,CAAC,IAAI,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,GAAG,WAAoB,CAAC;IAC5B,aAAa,CAAU;IAEhC,YAAY,OAAe,EAAE,aAAuB;QAClD,KAAK,CAAC,cAAc,OAAO,+BAA+B,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,OAAO,KAAK,YAAY,KAAK,IAAK,KAAkB,CAAC,IAAI,KAAK,WAAW,CAAC;AAC5E,CAAC"}

package/dist/exclude-models.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Exclude-models persistence module.
+ *
+ * Manages a user-configurable list of model IDs that the smart router
+ * should never select. Stored as a sorted JSON array on disk.
+ */
+/**
+ * Load the exclude list from disk.
+ * Returns an empty set if the file does not exist.
+ */
+export declare function loadExcludeList(filePath?: string): Set<string>;
+/**
+ * Add a model to the exclude list.
+ * Resolves aliases before persisting.
+ * @returns The resolved model ID.
+ */
+export declare function addExclusion(model: string, filePath?: string): string;
+/**
+ * Remove a model from the exclude list.
+ * Resolves aliases before removing.
+ * @returns true if the model was present and removed, false otherwise.
+ */
+export declare function removeExclusion(model: string, filePath?: string): boolean;
+/**
+ * Clear the entire exclude list.
+ */
+export declare function clearExclusions(filePath?: string): void;
+//# sourceMappingURL=exclude-models.d.ts.map

package/dist/exclude-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclude-models.d.ts","sourceRoot":"","sources":["../src/exclude-models.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAA0B,GAAG,GAAG,CAAC,MAAM,CAAC,CAWjF;AAYD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA0B,GAAG,MAAM,CAMxF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,GAAE,MAA0B,GAAG,OAAO,CAQ5F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,GAAE,MAA0B,GAAG,IAAI,CAE1E"}

package/dist/exclude-models.integration.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=exclude-models.integration.test.d.ts.map

package/dist/exclude-models.integration.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclude-models.integration.test.d.ts","sourceRoot":"","sources":["../src/exclude-models.integration.test.ts"],"names":[],"mappings":""}