@agentplugged/claw 0.1.0

package/dist/observability/queries.js

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTodayStats = getTodayStats;
+exports.getWeeklyStats = getWeeklyStats;
+exports.getMonthlyStats = getMonthlyStats;
+exports.getActiveSessions = getActiveSessions;
+exports.getRecentSessions = getRecentSessions;
+exports.getSessionEvents = getSessionEvents;
+exports.getTopSkillsByCost = getTopSkillsByCost;
+exports.getModelDistribution = getModelDistribution;
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function emptyDayStats(date) {
+    return {
+        date,
+        messages: 0,
+        tokens_in: 0,
+        tokens_out: 0,
+        cost: 0,
+        tool_calls: 0,
+        sessions: 0,
+        errors: 0,
+    };
+}
+/**
+ * Converts flat daily_stats rows into typed DayStats objects.
+ */
+function rowsToDayStats(rows) {
+    const byDate = new Map();
+    const NUMERIC_METRICS = new Set([
+        "messages",
+        "tokens_in",
+        "tokens_out",
+        "cost",
+        "tool_calls",
+        "sessions",
+        "errors",
+    ]);
+    for (const row of rows) {
+        if (!byDate.has(row.date)) {
+            byDate.set(row.date, emptyDayStats(row.date));
+        }
+        const entry = byDate.get(row.date);
+        if (NUMERIC_METRICS.has(row.metric)) {
+            const metric = row.metric;
+            entry[metric] += row.value;
+        }
+    }
+    return byDate;
+}
+function todayString() {
+    return new Date().toISOString().slice(0, 10);
+}
+// ─── Queries ──────────────────────────────────────────────────────────────────
+/**
+ * Returns aggregated stats for today.
+ */
+function getTodayStats(db) {
+    const today = todayString();
+    const rows = db
+        .prepare("SELECT date, metric, value FROM daily_stats WHERE date = ?")
+        .all(today);
+    const map = rowsToDayStats(rows);
+    return map.get(today) ?? emptyDayStats(today);
+}
+/**
+ * Returns aggregated stats for each of the last 7 days.
+ */
+function getWeeklyStats(db) {
+    const rows = db
+        .prepare(`SELECT date, metric, value FROM daily_stats
+       WHERE date >= date('now', '-6 days')
+       ORDER BY date ASC`)
+        .all();
+    const map = rowsToDayStats(rows);
+    // Ensure all 7 days are present (fill gaps with zeros)
+    const result = [];
+    for (let i = 6; i >= 0; i--) {
+        const d = new Date();
+        d.setDate(d.getDate() - i);
+        const dateStr = d.toISOString().slice(0, 10);
+        result.push(map.get(dateStr) ?? emptyDayStats(dateStr));
+    }
+    return result;
+}
+/**
+ * Returns aggregated stats for each of the last 30 days.
+ */
+function getMonthlyStats(db) {
+    const rows = db
+        .prepare(`SELECT date, metric, value FROM daily_stats
+       WHERE date >= date('now', '-29 days')
+       ORDER BY date ASC`)
+        .all();
+    const map = rowsToDayStats(rows);
+    const result = [];
+    for (let i = 29; i >= 0; i--) {
+        const d = new Date();
+        d.setDate(d.getDate() - i);
+        const dateStr = d.toISOString().slice(0, 10);
+        result.push(map.get(dateStr) ?? emptyDayStats(dateStr));
+    }
+    return result;
+}
+/**
+ * Returns sessions currently in 'active' status.
+ */
+function getActiveSessions(db) {
+    return db
+        .prepare(`SELECT * FROM sessions WHERE status = 'active' ORDER BY started_at DESC`)
+        .all();
+}
+/**
+ * Returns the most recent sessions (default: 20).
+ */
+function getRecentSessions(db, limit = 20) {
+    return db
+        .prepare(`SELECT * FROM sessions ORDER BY started_at DESC LIMIT ?`)
+        .all(limit);
+}
+/**
+ * Returns all events for a given session, ordered chronologically.
+ */
+function getSessionEvents(db, sessionId) {
+    return db
+        .prepare(`SELECT * FROM events WHERE session_id = ? ORDER BY timestamp ASC`)
+        .all(sessionId);
+}
+/**
+ * Returns the top skills ranked by cost over the last N days.
+ * Skill name is extracted from the tool_call event's data.tool field.
+ */
+function getTopSkillsByCost(db, days = 30) {
+    // We join events (tool_calls) with their parent session cost.
+    // For simplicity in V1 we use the tool name from events and
+    // the session total_cost proportionally — a direct approach is cleaner:
+    // extract cost from llm_call events that follow tool_call events.
+    // Here we aggregate llm_call events grouped by tool calls within same session.
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - days);
+    const cutoffStr = cutoff.toISOString().slice(0, 19);
+    const rows = db
+        .prepare(`SELECT
+         json_extract(data, '$.tool') AS tool_name,
+         COUNT(*) AS calls
+       FROM events
+       WHERE type = 'tool_call'
+         AND timestamp >= ?
+         AND json_extract(data, '$.tool') IS NOT NULL
+       GROUP BY tool_name
+       ORDER BY calls DESC
+       LIMIT 20`)
+        .all(cutoffStr);
+    // For V1 cost is estimated as 0 since we don't track per-skill cost precisely.
+    // This will be improved in V2 with skill attribution.
+    return rows.map((r) => ({
+        skill: r.tool_name,
+        cost: 0,
+        calls: r.calls,
+    }));
+}
+/**
+ * Returns model distribution (call count and total cost) over the last N days.
+ */
+function getModelDistribution(db, days = 30) {
+    const cutoff = new Date();
+    cutoff.setDate(cutoff.getDate() - days);
+    const cutoffStr = cutoff.toISOString().slice(0, 19);
+    return db
+        .prepare(`SELECT
+         json_extract(data, '$.model') AS model,
+         COUNT(*) AS count,
+         SUM(CAST(json_extract(data, '$.cost') AS REAL)) AS cost
+       FROM events
+       WHERE type = 'llm_call'
+         AND timestamp >= ?
+         AND json_extract(data, '$.model') IS NOT NULL
+       GROUP BY model
+       ORDER BY count DESC`)
+        .all(cutoffStr);
+}
+//# sourceMappingURL=queries.js.map

package/dist/observability/queries.js.map

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

package/dist/router/classifier.d.ts

@@ -0,0 +1,8 @@
+import { ChatMessage } from "./types";
+export type Complexity = "low" | "medium" | "high";
+/**
+ * Classifies request complexity in <5ms using pure heuristics.
+ * No LLM call is made — this runs synchronously.
+ */
+export declare function classifyComplexity(messages: ChatMessage[]): Complexity;
+//# sourceMappingURL=classifier.d.ts.map

package/dist/router/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/router/classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAoDnD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,UAAU,CA0CtE"}

package/dist/router/classifier.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyComplexity = classifyComplexity;
+const HIGH_COMPLEXITY_KEYWORDS = [
+    "analyze",
+    "analyse",
+    "compare",
+    "summarize long",
+    "summarise long",
+    "write essay",
+    "detailed report",
+    "comprehensive",
+    "in-depth",
+    "thorough",
+    "critique",
+    "evaluate",
+];
+const MEDIUM_COMPLEXITY_KEYWORDS = [
+    "explain",
+    "describe",
+    "summarize",
+    "summarise",
+    "list",
+    "outline",
+    "translate",
+];
+function totalContentLength(messages) {
+    return messages.reduce((sum, msg) => sum + (msg.content?.length ?? 0), 0);
+}
+function hasToolCalls(messages) {
+    return messages.some((msg) => msg.tool_calls && msg.tool_calls.length > 0);
+}
+function systemPromptLength(messages) {
+    const sys = messages.find((m) => m.role === "system");
+    return sys?.content?.length ?? 0;
+}
+function matchesKeywords(text, keywords) {
+    const lower = text.toLowerCase();
+    return keywords.some((kw) => lower.includes(kw));
+}
+function lastUserMessage(messages) {
+    const userMessages = messages.filter((m) => m.role === "user");
+    return userMessages[userMessages.length - 1]?.content ?? "";
+}
+/**
+ * Classifies request complexity in <5ms using pure heuristics.
+ * No LLM call is made — this runs synchronously.
+ */
+function classifyComplexity(messages) {
+    let score = 0;
+    const total = totalContentLength(messages);
+    const conversationLength = messages.length;
+    const sysLen = systemPromptLength(messages);
+    const lastUser = lastUserMessage(messages);
+    // Content length scoring
+    if (total > 1000) {
+        score += 2;
+    }
+    else if (total > 200) {
+        score += 1;
+    }
+    // Tool calls bump complexity
+    if (hasToolCalls(messages)) {
+        score += 1;
+    }
+    // System prompt length factor
+    if (sysLen > 500) {
+        score += 1;
+    }
+    // Conversation depth factor
+    if (conversationLength > 10) {
+        score += 1;
+    }
+    else if (conversationLength > 5) {
+        score += 0;
+    }
+    // High complexity keywords in last user message
+    if (matchesKeywords(lastUser, HIGH_COMPLEXITY_KEYWORDS)) {
+        score += 2;
+    }
+    else if (matchesKeywords(lastUser, MEDIUM_COMPLEXITY_KEYWORDS)) {
+        score += 1;
+    }
+    if (score >= 3)
+        return "high";
+    if (score >= 1)
+        return "medium";
+    return "low";
+}
+//# sourceMappingURL=classifier.js.map

package/dist/router/classifier.js.map

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

package/dist/router/fallback.d.ts

@@ -0,0 +1,18 @@
+import { ModelConfig, ProviderConfig } from "../config";
+import { ChatCompletionRequest, ChatCompletionResponse } from "./types";
+interface ProviderAndModel {
+    provider: ProviderConfig;
+    model: ModelConfig;
+}
+/**
+ * Forwards a request to the primary provider/model with automatic fallback
+ * to equivalent-tier models on other providers if the primary fails.
+ *
+ * Returns the response and a flag indicating whether a fallback was used.
+ */
+export declare function forwardWithFallback(request: ChatCompletionRequest, primary: ProviderAndModel, providers: ProviderConfig[]): Promise<{
+    response: ChatCompletionResponse;
+    usedFallback: boolean;
+}>;
+export {};
+//# sourceMappingURL=fallback.d.ts.map

package/dist/router/fallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../src/router/fallback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGxD,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAKxE,UAAU,gBAAgB;IACxB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,WAAW,CAAC;CACpB;AA+ED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,qBAAqB,EAC9B,OAAO,EAAE,gBAAgB,EACzB,SAAS,EAAE,cAAc,EAAE,GAC1B,OAAO,CAAC;IAAE,QAAQ,EAAE,sBAAsB,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC,CA8CtE"}

package/dist/router/fallback.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.forwardWithFallback = forwardWithFallback;
+const models_1 = require("./models");
+const providers_1 = require("./providers");
+const RETRYABLE_STATUS_CODES = new Set([429, 500, 502, 503, 504]);
+const REQUEST_TIMEOUT_MS = 30_000;
+/**
+ * Determines if the error message suggests a retryable condition
+ * (rate limit, timeout, 5xx server error).
+ */
+function isRetryableError(err) {
+    if (!(err instanceof Error))
+        return false;
+    const msg = err.message.toLowerCase();
+    // Check for status code patterns embedded in error messages
+    for (const code of RETRYABLE_STATUS_CODES) {
+        if (msg.includes(`${code}`))
+            return true;
+    }
+    return (msg.includes("timeout") ||
+        msg.includes("rate limit") ||
+        msg.includes("overloaded") ||
+        msg.includes("econnreset") ||
+        msg.includes("econnrefused") ||
+        msg.includes("network"));
+}
+/**
+ * Wraps a fetch call with a timeout.
+ */
+async function withTimeout(promise, ms) {
+    let timeoutId;
+    const timeout = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new Error(`Request timed out after ${ms}ms`));
+        }, ms);
+    });
+    try {
+        const result = await Promise.race([promise, timeout]);
+        clearTimeout(timeoutId);
+        return result;
+    }
+    catch (err) {
+        clearTimeout(timeoutId);
+        throw err;
+    }
+}
+/**
+ * Builds a list of fallback candidates with the same tier as the primary model,
+ * excluding the primary provider itself.
+ */
+function buildFallbackCandidates(primary, providers) {
+    const candidates = [];
+    const targetTier = primary.model.tier;
+    for (const provider of providers) {
+        if (!provider.enabled)
+            continue;
+        if (provider.name === primary.provider.name)
+            continue;
+        const registryModels = models_1.MODELS_BY_PROVIDER.get(provider.name) ?? [];
+        const availableIds = new Set(provider.models.map((m) => m.id));
+        const eligible = registryModels.filter((m) => availableIds.has(m.id) && m.tier === targetTier);
+        if (eligible.length > 0) {
+            candidates.push({ provider, model: eligible[0] });
+        }
+    }
+    return candidates;
+}
+/**
+ * Forwards a request to the primary provider/model with automatic fallback
+ * to equivalent-tier models on other providers if the primary fails.
+ *
+ * Returns the response and a flag indicating whether a fallback was used.
+ */
+async function forwardWithFallback(request, primary, providers) {
+    // Attempt primary
+    try {
+        const response = await withTimeout((0, providers_1.forwardToProvider)(primary.provider, primary.model, request), REQUEST_TIMEOUT_MS);
+        return { response, usedFallback: false };
+    }
+    catch (primaryErr) {
+        if (!isRetryableError(primaryErr)) {
+            // Non-retryable error — surface immediately
+            throw primaryErr;
+        }
+        console.warn(`[router/fallback] Primary provider "${primary.provider.name}/${primary.model.id}" failed: ${primaryErr.message}. Attempting fallbacks.`);
+    }
+    // Attempt fallbacks in order
+    const fallbacks = buildFallbackCandidates(primary, providers);
+    for (const candidate of fallbacks) {
+        try {
+            console.info(`[router/fallback] Trying ${candidate.provider.name}/${candidate.model.id}`);
+            const response = await withTimeout((0, providers_1.forwardToProvider)(candidate.provider, candidate.model, request), REQUEST_TIMEOUT_MS);
+            return { response, usedFallback: true };
+        }
+        catch (fallbackErr) {
+            console.warn(`[router/fallback] Fallback "${candidate.provider.name}/${candidate.model.id}" also failed: ${fallbackErr.message}`);
+        }
+    }
+    throw new Error(`All providers failed for tier "${primary.model.tier}". No fallback succeeded.`);
+}
+//# sourceMappingURL=fallback.js.map

package/dist/router/fallback.js.map

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

package/dist/router/index.d.ts

@@ -0,0 +1,5 @@
+import * as http from "http";
+import Database from "better-sqlite3";
+import { ClawConfig } from "../config";
+export declare function createRouterServer(config: ClawConfig, db: Database.Database): http.Server;
+//# sourceMappingURL=index.d.ts.map

package/dist/router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAc,UAAU,EAAE,MAAM,WAAW,CAAC;AAwKnD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,UAAU,EAClB,EAAE,EAAE,QAAQ,CAAC,QAAQ,GACpB,IAAI,CAAC,MAAM,CA6Bb"}

package/dist/router/index.js

@@ -0,0 +1,214 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createRouterServer = createRouterServer;
+const http = __importStar(require("http"));
+const config_1 = require("../config");
+const classifier_1 = require("./classifier");
+const strategy_1 = require("./strategy");
+const fallback_1 = require("./fallback");
+const logger_1 = require("./logger");
+const leak_detector_1 = require("./leak-detector");
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(chunk));
+        req.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+        req.on("error", reject);
+    });
+}
+function sendJson(res, status, body) {
+    const json = JSON.stringify(body);
+    res.writeHead(status, {
+        "Content-Type": "application/json",
+        "Content-Length": Buffer.byteLength(json),
+    });
+    res.end(json);
+}
+function sendError(res, status, message) {
+    sendJson(res, status, {
+        error: { message, type: "router_error", code: status },
+    });
+}
+// ---------------------------------------------------------------------------
+// Request handler
+// ---------------------------------------------------------------------------
+async function handleChatCompletions(req, res, config, db) {
+    const startMs = Date.now();
+    let body;
+    try {
+        body = await readBody(req);
+    }
+    catch {
+        return sendError(res, 400, "Failed to read request body");
+    }
+    let request;
+    try {
+        request = JSON.parse(body);
+    }
+    catch {
+        return sendError(res, 400, "Invalid JSON body");
+    }
+    if (!request.messages || !Array.isArray(request.messages)) {
+        return sendError(res, 400, "Missing or invalid 'messages' field");
+    }
+    // Classify complexity (synchronous, <5ms)
+    const complexity = (0, classifier_1.classifyComplexity)(request.messages);
+    // Select the best model for this request
+    let selected;
+    try {
+        selected = (0, strategy_1.selectModel)(complexity, config.strategy, config.providers);
+    }
+    catch (err) {
+        console.error("[router] Model selection failed:", err);
+        return sendError(res, 503, err.message);
+    }
+    // Forward with fallback
+    let chatResponse;
+    try {
+        chatResponse = await (0, fallback_1.forwardWithFallback)(request, selected, config.providers);
+    }
+    catch (err) {
+        const latencyMs = Date.now() - startMs;
+        (0, logger_1.logRouterRequest)(db, {
+            timestamp: new Date().toISOString(),
+            model: selected.model.id,
+            provider: selected.provider.name,
+            inputTokens: 0,
+            outputTokens: 0,
+            cost: 0,
+            latencyMs,
+            complexity,
+            strategy: config.strategy,
+            fallback: false,
+            success: false,
+            error: err.message,
+        });
+        console.error("[router] All providers failed:", err);
+        return sendError(res, 502, err.message);
+    }
+    const latencyMs = Date.now() - startMs;
+    const { response, usedFallback } = chatResponse;
+    const inputTokens = response.usage?.prompt_tokens ?? 0;
+    const outputTokens = response.usage?.completion_tokens ?? 0;
+    const cost = (0, logger_1.calculateCost)(inputTokens, outputTokens, selected.model.inputPrice, selected.model.outputPrice);
+    // Leak detection — scan response content before sending to client
+    let leakDetected = false;
+    if (response.choices) {
+        for (const choice of response.choices) {
+            const content = choice.message?.content;
+            if (typeof content === "string") {
+                const result = (0, leak_detector_1.detectLeaks)(content);
+                if (result.leaked) {
+                    leakDetected = true;
+                    console.warn(`[router] Leak detected in response (model=${selected.model.id}): ${result.findings.length} finding(s)`, result.findings.map((f) => `${f.type}: ${f.match}`));
+                    choice.message.content = (0, leak_detector_1.sanitizeResponse)(content);
+                }
+            }
+        }
+    }
+    // Persist log (synchronous — non-blocking on the happy path since it's fast)
+    (0, logger_1.logRouterRequest)(db, {
+        timestamp: new Date().toISOString(),
+        model: selected.model.id,
+        provider: selected.provider.name,
+        inputTokens,
+        outputTokens,
+        cost,
+        latencyMs,
+        complexity,
+        strategy: config.strategy,
+        fallback: usedFallback,
+        success: true,
+        leakDetected,
+    });
+    sendJson(res, 200, response);
+}
+// ---------------------------------------------------------------------------
+// Server factory
+// ---------------------------------------------------------------------------
+function createRouterServer(config, db) {
+    const server = http.createServer(async (req, res) => {
+        const method = req.method?.toUpperCase();
+        const url = req.url ?? "/";
+        // Health check
+        if (method === "GET" && url === "/health") {
+            return sendJson(res, 200, {
+                status: "ok",
+                version: "0.1.0",
+                strategy: config.strategy,
+                providers: config.providers
+                    .filter((p) => p.enabled)
+                    .map((p) => p.name),
+            });
+        }
+        // Chat completions — OpenAI-compatible endpoint
+        if (method === "POST" && url === "/v1/chat/completions") {
+            return handleChatCompletions(req, res, config, db);
+        }
+        // 404 for everything else
+        return sendError(res, 404, `Route not found: ${method} ${url}`);
+    });
+    return server;
+}
+// ---------------------------------------------------------------------------
+// Entry point (when run directly)
+// ---------------------------------------------------------------------------
+if (require.main === module) {
+    const config = (0, config_1.loadConfig)();
+    const db = (0, logger_1.openDatabase)(config.dataDir);
+    const server = createRouterServer(config, db);
+    server.listen(config.routerPort, () => {
+        console.log(`[router] Claw Router Proxy listening on port ${config.routerPort}`);
+        console.log(`[router] Strategy: ${config.strategy} | Providers: ${config.providers
+            .filter((p) => p.enabled)
+            .map((p) => p.name)
+            .join(", ") || "none"}`);
+    });
+    process.on("SIGTERM", () => {
+        console.log("[router] Shutting down...");
+        db.close();
+        server.close(() => process.exit(0));
+    });
+    process.on("SIGINT", () => {
+        console.log("[router] Interrupted, shutting down...");
+        db.close();
+        server.close(() => process.exit(0));
+    });
+}
+//# sourceMappingURL=index.js.map