@blockrun/clawrouter 0.12.95 → 0.12.97

package/dist/stats.js

@@ -0,0 +1,295 @@
+/**
+ * Usage Statistics Aggregator
+ *
+ * Reads usage log files and aggregates statistics for terminal display.
+ * Supports filtering by date range and provides multiple aggregation views.
+ */
+import { readdir, unlink } from "node:fs/promises";
+import { readTextFile } from "./fs-read.js";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { VERSION } from "./version.js";
+const LOG_DIR = join(homedir(), ".openclaw", "blockrun", "logs");
+/**
+ * Parse a JSONL log file into usage entries.
+ * Handles both old format (without tier/baselineCost) and new format.
+ */
+async function parseLogFile(filePath) {
+    try {
+        const content = await readTextFile(filePath);
+        const lines = content.trim().split("\n").filter(Boolean);
+        const entries = [];
+        for (const line of lines) {
+            try {
+                const entry = JSON.parse(line);
+                entries.push({
+                    timestamp: entry.timestamp || new Date().toISOString(),
+                    model: entry.model || "unknown",
+                    tier: entry.tier || "UNKNOWN",
+                    cost: entry.cost || 0,
+                    baselineCost: entry.baselineCost || entry.cost || 0,
+                    savings: entry.savings || 0,
+                    latencyMs: entry.latencyMs || 0,
+                });
+            }
+            catch {
+                // Skip malformed lines, keep valid ones
+            }
+        }
+        return entries;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get list of available log files sorted by date (newest first).
+ */
+async function getLogFiles() {
+    try {
+        const files = await readdir(LOG_DIR);
+        return files
+            .filter((f) => f.startsWith("usage-") && f.endsWith(".jsonl"))
+            .sort()
+            .reverse();
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Aggregate stats for a single day.
+ */
+function aggregateDay(date, entries) {
+    const byTier = {};
+    const byModel = {};
+    let totalLatency = 0;
+    for (const entry of entries) {
+        // By tier
+        if (!byTier[entry.tier])
+            byTier[entry.tier] = { count: 0, cost: 0 };
+        byTier[entry.tier].count++;
+        byTier[entry.tier].cost += entry.cost;
+        // By model
+        if (!byModel[entry.model])
+            byModel[entry.model] = { count: 0, cost: 0 };
+        byModel[entry.model].count++;
+        byModel[entry.model].cost += entry.cost;
+        totalLatency += entry.latencyMs;
+    }
+    const totalCost = entries.reduce((sum, e) => sum + e.cost, 0);
+    const totalBaselineCost = entries.reduce((sum, e) => sum + e.baselineCost, 0);
+    return {
+        date,
+        totalRequests: entries.length,
+        totalCost,
+        totalBaselineCost,
+        totalSavings: totalBaselineCost - totalCost,
+        avgLatencyMs: entries.length > 0 ? totalLatency / entries.length : 0,
+        byTier,
+        byModel,
+    };
+}
+/**
+ * Get aggregated statistics for the last N days.
+ */
+export async function getStats(days = 7) {
+    const logFiles = await getLogFiles();
+    const filesToRead = logFiles.slice(0, days);
+    const dailyBreakdown = [];
+    const allByTier = {};
+    const allByModel = {};
+    let totalRequests = 0;
+    let totalCost = 0;
+    let totalBaselineCost = 0;
+    let totalLatency = 0;
+    for (const file of filesToRead) {
+        const date = file.replace("usage-", "").replace(".jsonl", "");
+        const filePath = join(LOG_DIR, file);
+        const entries = await parseLogFile(filePath);
+        if (entries.length === 0)
+            continue;
+        const dayStats = aggregateDay(date, entries);
+        dailyBreakdown.push(dayStats);
+        totalRequests += dayStats.totalRequests;
+        totalCost += dayStats.totalCost;
+        totalBaselineCost += dayStats.totalBaselineCost;
+        totalLatency += dayStats.avgLatencyMs * dayStats.totalRequests;
+        // Merge tier stats
+        for (const [tier, stats] of Object.entries(dayStats.byTier)) {
+            if (!allByTier[tier])
+                allByTier[tier] = { count: 0, cost: 0 };
+            allByTier[tier].count += stats.count;
+            allByTier[tier].cost += stats.cost;
+        }
+        // Merge model stats
+        for (const [model, stats] of Object.entries(dayStats.byModel)) {
+            if (!allByModel[model])
+                allByModel[model] = { count: 0, cost: 0 };
+            allByModel[model].count += stats.count;
+            allByModel[model].cost += stats.cost;
+        }
+    }
+    // Calculate percentages
+    const byTierWithPercentage = {};
+    for (const [tier, stats] of Object.entries(allByTier)) {
+        byTierWithPercentage[tier] = {
+            ...stats,
+            percentage: totalRequests > 0 ? (stats.count / totalRequests) * 100 : 0,
+        };
+    }
+    const byModelWithPercentage = {};
+    for (const [model, stats] of Object.entries(allByModel)) {
+        byModelWithPercentage[model] = {
+            ...stats,
+            percentage: totalRequests > 0 ? (stats.count / totalRequests) * 100 : 0,
+        };
+    }
+    const totalSavings = totalBaselineCost - totalCost;
+    const savingsPercentage = totalBaselineCost > 0 ? (totalSavings / totalBaselineCost) * 100 : 0;
+    // Count entries with valid baseline tracking (baseline != cost means tracking was active)
+    let entriesWithBaseline = 0;
+    for (const day of dailyBreakdown) {
+        if (day.totalBaselineCost !== day.totalCost) {
+            entriesWithBaseline += day.totalRequests;
+        }
+    }
+    return {
+        period: days === 1 ? "today" : `last ${days} days`,
+        totalRequests,
+        totalCost,
+        totalBaselineCost,
+        totalSavings,
+        savingsPercentage,
+        avgLatencyMs: totalRequests > 0 ? totalLatency / totalRequests : 0,
+        avgCostPerRequest: totalRequests > 0 ? totalCost / totalRequests : 0,
+        byTier: byTierWithPercentage,
+        byModel: byModelWithPercentage,
+        dailyBreakdown: dailyBreakdown.reverse(), // Oldest first for charts
+        entriesWithBaseline, // How many entries have valid baseline tracking
+    };
+}
+/**
+ * Format stats as ASCII table for terminal display.
+ */
+export function formatStatsAscii(stats) {
+    const lines = [];
+    // Header
+    lines.push("╔════════════════════════════════════════════════════════════╗");
+    lines.push(`║          ClawRouter by BlockRun v${VERSION}`.padEnd(61) + "║");
+    lines.push("║                Usage Statistics                            ║");
+    lines.push("╠════════════════════════════════════════════════════════════╣");
+    // Summary
+    lines.push(`║  Period: ${stats.period.padEnd(49)}║`);
+    lines.push(`║  Total Requests: ${stats.totalRequests.toString().padEnd(41)}║`);
+    lines.push(`║  Total Cost: $${stats.totalCost.toFixed(4).padEnd(43)}║`);
+    lines.push(`║  Baseline Cost (Opus 4.5): $${stats.totalBaselineCost.toFixed(4).padEnd(30)}║`);
+    // Show savings with note if some entries lack baseline tracking
+    const savingsLine = `║  💰 Total Saved: $${stats.totalSavings.toFixed(4)} (${stats.savingsPercentage.toFixed(1)}%)`;
+    if (stats.entriesWithBaseline < stats.totalRequests && stats.entriesWithBaseline > 0) {
+        lines.push(savingsLine.padEnd(61) + "║");
+        const note = `║     (based on ${stats.entriesWithBaseline}/${stats.totalRequests} tracked requests)`;
+        lines.push(note.padEnd(61) + "║");
+    }
+    else {
+        lines.push(savingsLine.padEnd(61) + "║");
+    }
+    lines.push(`║  Avg Latency: ${stats.avgLatencyMs.toFixed(0)}ms`.padEnd(61) + "║");
+    // Tier breakdown
+    lines.push("╠════════════════════════════════════════════════════════════╣");
+    lines.push("║  Routing by Tier:                                          ║");
+    // Show all tiers found in data, ordered by known tiers first then others
+    const knownTiers = ["SIMPLE", "MEDIUM", "COMPLEX", "REASONING", "DIRECT"];
+    const allTiers = Object.keys(stats.byTier);
+    const otherTiers = allTiers.filter((t) => !knownTiers.includes(t));
+    const tierOrder = [...knownTiers.filter((t) => stats.byTier[t]), ...otherTiers];
+    for (const tier of tierOrder) {
+        const data = stats.byTier[tier];
+        if (data) {
+            const bar = "█".repeat(Math.min(20, Math.round(data.percentage / 5)));
+            const displayTier = tier === "UNKNOWN" ? "OTHER" : tier;
+            const line = `║    ${displayTier.padEnd(10)} ${bar.padEnd(20)} ${data.percentage.toFixed(1).padStart(5)}% (${data.count})`;
+            lines.push(line.padEnd(61) + "║");
+        }
+    }
+    // Top models
+    lines.push("╠════════════════════════════════════════════════════════════╣");
+    lines.push("║  Top Models:                                               ║");
+    const sortedModels = Object.entries(stats.byModel)
+        .sort((a, b) => b[1].count - a[1].count)
+        .slice(0, 5);
+    for (const [model, data] of sortedModels) {
+        const shortModel = model.length > 25 ? model.slice(0, 22) + "..." : model;
+        const line = `║    ${shortModel.padEnd(25)} ${data.count.toString().padStart(5)} reqs  $${data.cost.toFixed(4)}`;
+        lines.push(line.padEnd(61) + "║");
+    }
+    // Daily breakdown (last 7 days)
+    if (stats.dailyBreakdown.length > 0) {
+        lines.push("╠════════════════════════════════════════════════════════════╣");
+        lines.push("║  Daily Breakdown:                                          ║");
+        lines.push("║    Date        Requests    Cost      Saved                 ║");
+        for (const day of stats.dailyBreakdown.slice(-7)) {
+            const saved = day.totalBaselineCost - day.totalCost;
+            const line = `║    ${day.date}   ${day.totalRequests.toString().padStart(6)}    $${day.totalCost.toFixed(4).padStart(8)}  $${saved.toFixed(4)}`;
+            lines.push(line.padEnd(61) + "║");
+        }
+    }
+    lines.push("╚════════════════════════════════════════════════════════════╝");
+    return lines.join("\n");
+}
+/**
+ * Format per-request log entries as an ASCII table for terminal display.
+ * Reads the last N days of log files and shows each request individually.
+ */
+export async function formatRecentLogs(days = 1) {
+    const logFiles = await getLogFiles();
+    const filesToRead = logFiles.slice(0, days);
+    const allEntries = [];
+    for (const file of filesToRead) {
+        const entries = await parseLogFile(join(LOG_DIR, file));
+        allEntries.push(...entries);
+    }
+    // Sort chronologically (oldest first)
+    allEntries.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    const lines = [];
+    lines.push("╔════════════════════════════════════════════════════════════════════════╗");
+    lines.push(`║  ClawRouter Request Log — last ${days === 1 ? "24h" : `${days} days`}`.padEnd(72) + "║");
+    lines.push("╠══════════════════╦══════════════════════════╦═════════╦══════╦════════╣");
+    lines.push("║  Time            ║  Model                   ║  Cost   ║  ms  ║ Status ║");
+    lines.push("╠══════════════════╬══════════════════════════╬═════════╬══════╬════════╣");
+    if (allEntries.length === 0) {
+        lines.push("║  No requests found".padEnd(72) + "║");
+    }
+    let totalCost = 0;
+    for (const e of allEntries) {
+        const time = e.timestamp.slice(11, 19); // HH:MM:SS
+        const date = e.timestamp.slice(5, 10); // MM-DD
+        const displayTime = `${date} ${time}`;
+        const model = e.model.length > 24 ? e.model.slice(0, 21) + "..." : e.model;
+        const cost = `$${e.cost.toFixed(4)}`;
+        const ms = e.latencyMs > 9999 ? `${(e.latencyMs / 1000).toFixed(1)}s` : `${e.latencyMs}ms`;
+        const status = e.status === "error" ? " ERROR  " : " OK     ";
+        totalCost += e.cost;
+        lines.push(`║  ${displayTime.padEnd(16)}║  ${model.padEnd(24)}║  ${cost.padStart(7)}║  ${ms.padStart(4)}║${status}║`);
+    }
+    lines.push("╠══════════════════╩══════════════════════════╩═════════╩══════╩════════╣");
+    lines.push(`║  ${allEntries.length} request${allEntries.length !== 1 ? "s" : ""}  Total spent: $${totalCost.toFixed(4)}`.padEnd(72) + "║");
+    lines.push("║  Logs: ~/.openclaw/blockrun/logs/  (JSONL — one entry per request)".padEnd(72) + "║");
+    lines.push("╚════════════════════════════════════════════════════════════════════════╝");
+    return lines.join("\n");
+}
+/**
+ * Delete all usage log files, resetting stats to zero.
+ */
+export async function clearStats() {
+    try {
+        const files = await readdir(LOG_DIR);
+        const logFiles = files.filter((f) => f.startsWith("usage-") && f.endsWith(".jsonl"));
+        await Promise.all(logFiles.map((f) => unlink(join(LOG_DIR, f))));
+        return { deletedFiles: logFiles.length };
+    }
+    catch {
+        return { deletedFiles: 0 };
+    }
+}
+//# sourceMappingURL=stats.js.map

package/dist/stats.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,150 @@
+/**
+ * OpenClaw Plugin Types (locally defined)
+ *
+ * OpenClaw's plugin SDK uses duck typing — these match the shapes
+ * expected by registerProvider() and the plugin system.
+ * Defined locally to avoid depending on internal OpenClaw paths.
+ */
+export type ModelApi = "openai-completions" | "openai-responses" | "anthropic-messages" | "google-generative-ai" | "github-copilot" | "bedrock-converse-stream";
+export type ModelDefinitionConfig = {
+    id: string;
+    name: string;
+    api?: ModelApi;
+    reasoning: boolean;
+    input: Array<"text" | "image">;
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    contextWindow: number;
+    maxTokens: number;
+    headers?: Record<string, string>;
+};
+export type ModelProviderConfig = {
+    baseUrl: string;
+    apiKey?: string;
+    api?: ModelApi;
+    headers?: Record<string, string>;
+    authHeader?: boolean;
+    models: ModelDefinitionConfig[];
+};
+export type AuthProfileCredential = {
+    apiKey?: string;
+    type?: string;
+    [key: string]: unknown;
+};
+export type ProviderAuthResult = {
+    profiles: Array<{
+        profileId: string;
+        credential: AuthProfileCredential;
+    }>;
+    configPatch?: Record<string, unknown>;
+    defaultModel?: string;
+    notes?: string[];
+};
+export type WizardPrompter = {
+    text: (opts: {
+        message: string;
+        validate?: (value: string) => string | undefined;
+    }) => Promise<string | symbol>;
+    note: (message: string) => void;
+    progress: (message: string) => {
+        stop: (message?: string) => void;
+    };
+};
+export type ProviderAuthContext = {
+    config: Record<string, unknown>;
+    agentDir?: string;
+    workspaceDir?: string;
+    prompter: WizardPrompter;
+    runtime: {
+        log: (message: string) => void;
+    };
+    isRemote: boolean;
+    openUrl: (url: string) => Promise<void>;
+};
+export type ProviderAuthMethod = {
+    id: string;
+    label: string;
+    hint?: string;
+    kind: "oauth" | "api_key" | "token" | "device_code" | "custom";
+    run: (ctx: ProviderAuthContext) => Promise<ProviderAuthResult>;
+};
+export type ProviderPlugin = {
+    id: string;
+    label: string;
+    docsPath?: string;
+    aliases?: string[];
+    envVars?: string[];
+    models?: ModelProviderConfig;
+    auth: ProviderAuthMethod[];
+    formatApiKey?: (cred: AuthProfileCredential) => string;
+};
+export type PluginLogger = {
+    debug?: (message: string) => void;
+    info: (message: string) => void;
+    warn: (message: string) => void;
+    error: (message: string) => void;
+};
+export type OpenClawPluginService = {
+    id: string;
+    start: () => void | Promise<void>;
+    stop?: () => void | Promise<void>;
+};
+export type OpenClawPluginApi = {
+    id: string;
+    name: string;
+    version?: string;
+    description?: string;
+    source: string;
+    config: Record<string, unknown> & {
+        models?: {
+            providers?: Record<string, ModelProviderConfig>;
+        };
+        agents?: Record<string, unknown>;
+    };
+    pluginConfig?: Record<string, unknown>;
+    logger: PluginLogger;
+    registerProvider: (provider: ProviderPlugin) => void;
+    registerTool: (tool: unknown, opts?: unknown) => void;
+    registerHook: (events: string | string[], handler: unknown, opts?: unknown) => void;
+    registerHttpRoute: (params: {
+        path: string;
+        handler: unknown;
+    }) => void;
+    registerService: (service: OpenClawPluginService) => void;
+    registerCommand: (command: unknown) => void;
+    resolvePath: (input: string) => string;
+    on: (hookName: string, handler: unknown, opts?: unknown) => void;
+};
+export type OpenClawPluginDefinition = {
+    id?: string;
+    name?: string;
+    description?: string;
+    version?: string;
+    register?: (api: OpenClawPluginApi) => void | Promise<void>;
+    activate?: (api: OpenClawPluginApi) => void | Promise<void>;
+};
+export type PluginCommandContext = {
+    senderId?: string;
+    channel: string;
+    isAuthorizedSender: boolean;
+    args?: string;
+    commandBody: string;
+    config: Record<string, unknown>;
+};
+export type PluginCommandResult = {
+    text?: string;
+    isError?: boolean;
+};
+export type PluginCommandHandler = (ctx: PluginCommandContext) => PluginCommandResult | Promise<PluginCommandResult>;
+export type OpenClawPluginCommandDefinition = {
+    name: string;
+    description: string;
+    acceptsArgs?: boolean;
+    requireAuth?: boolean;
+    handler: PluginCommandHandler;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,QAAQ,GAChB,oBAAoB,GACpB,kBAAkB,GAClB,oBAAoB,GACpB,sBAAsB,GACtB,gBAAgB,GAChB,yBAAyB,CAAC;AAE9B,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,CAAC;IAC/B,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,QAAQ,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,qBAAqB,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,KAAK,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,qBAAqB,CAAA;KAAE,CAAC,CAAC;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,CAAC,IAAI,EAAE;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;KAClD,KAAK,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK;QAAE,IAAI,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;CACrE,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE;QAAE,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,QAAQ,CAAC;IAC/D,GAAG,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAChE,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,IAAI,EAAE,kBAAkB,EAAE,CAAC;IAC3B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,MAAM,CAAC;CACxD,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAChC,MAAM,CAAC,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;SAAE,CAAC;QAC7D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClC,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,MAAM,EAAE,YAAY,CAAC;IACrB,gBAAgB,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IACrD,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACtD,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACpF,iBAAiB,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACxE,eAAe,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,IAAI,CAAC;IAC1D,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;IAC5C,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IACvC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;CAClE,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,CAAC;AAGF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CACjC,GAAG,EAAE,oBAAoB,KACtB,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAExD,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,oBAAoB,CAAC;CAC/B,CAAC"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * OpenClaw Plugin Types (locally defined)
+ *
+ * OpenClaw's plugin SDK uses duck typing — these match the shapes
+ * expected by registerProvider() and the plugin system.
+ * Defined locally to avoid depending on internal OpenClaw paths.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/update-hint.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Tests for server-side update hint parsing from 429 response bodies.
+ *
+ * When BlockRun's API detects a stale ClawRouter user-agent, it includes
+ * { update_available, update_url } in 429 responses. The proxy parses
+ * these and logs a prominent update message.
+ */
+export {};
+//# sourceMappingURL=update-hint.test.d.ts.map

package/dist/update-hint.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-hint.test.d.ts","sourceRoot":"","sources":["../src/update-hint.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/update-hint.test.js

@@ -0,0 +1,156 @@
+/**
+ * Tests for server-side update hint parsing from 429 response bodies.
+ *
+ * When BlockRun's API detects a stale ClawRouter user-agent, it includes
+ * { update_available, update_url } in 429 responses. The proxy parses
+ * these and logs a prominent update message.
+ */
+import { describe, expect, it, vi, afterEach } from "vitest";
+/** Mirrors the parsing logic in proxy.ts's 429 handler */
+function parseUpdateHint(errorBody) {
+    try {
+        const parsed = JSON.parse(errorBody || "{}");
+        if (parsed.update_available) {
+            return { update_available: parsed.update_available, update_url: parsed.update_url };
+        }
+    }
+    catch {
+        // ignore parse errors
+    }
+    return null;
+}
+/** Mirrors getUpdateHint() on the blockrun server side */
+function getUpdateHint(userAgent, currentVersion) {
+    if (!userAgent)
+        return null;
+    const match = userAgent.match(/^clawrouter\/(\d+\.\d+\.\d+)/);
+    if (!match)
+        return null;
+    const clientVersion = match[1];
+    const [cMaj, cMin, cPatch] = clientVersion.split(".").map(Number);
+    const [sMaj, sMin, sPatch] = currentVersion.split(".").map(Number);
+    if (cMaj < sMaj ||
+        (cMaj === sMaj && cMin < sMin) ||
+        (cMaj === sMaj && cMin === sMin && cPatch < sPatch)) {
+        return {
+            update_available: currentVersion,
+            update_url: "https://blockrun.ai/ClawRouter-update",
+        };
+    }
+    return null;
+}
+describe("update hint — server-side generation (getUpdateHint)", () => {
+    const CURRENT = "0.12.12";
+    it("returns hint when client is older (patch)", () => {
+        expect(getUpdateHint("clawrouter/0.12.11", CURRENT)).toEqual({
+            update_available: "0.12.12",
+            update_url: "https://blockrun.ai/ClawRouter-update",
+        });
+    });
+    it("returns hint when client is older (minor)", () => {
+        expect(getUpdateHint("clawrouter/0.10.22", CURRENT)).toEqual({
+            update_available: "0.12.12",
+            update_url: "https://blockrun.ai/ClawRouter-update",
+        });
+    });
+    it("returns hint when client is older (major)", () => {
+        expect(getUpdateHint("clawrouter/0.9.0", "1.0.0")).toEqual({
+            update_available: "1.0.0",
+            update_url: "https://blockrun.ai/ClawRouter-update",
+        });
+    });
+    it("returns null when client is current", () => {
+        expect(getUpdateHint("clawrouter/0.12.12", CURRENT)).toBeNull();
+    });
+    it("returns null when client is newer", () => {
+        expect(getUpdateHint("clawrouter/0.13.0", CURRENT)).toBeNull();
+    });
+    it("returns null for non-clawrouter user agents", () => {
+        expect(getUpdateHint("curl/7.88.0", CURRENT)).toBeNull();
+        expect(getUpdateHint("Mozilla/5.0", CURRENT)).toBeNull();
+    });
+    it("returns null for undefined user agent", () => {
+        expect(getUpdateHint(undefined, CURRENT)).toBeNull();
+    });
+});
+describe("update hint — client-side parsing (parseUpdateHint)", () => {
+    it("parses update_available from 429 body", () => {
+        const body = JSON.stringify({
+            error: "Rate limited",
+            message: "Free tier: max 60 requests/hour.",
+            update_available: "0.12.12",
+            update_url: "https://blockrun.ai/ClawRouter-update",
+        });
+        expect(parseUpdateHint(body)).toEqual({
+            update_available: "0.12.12",
+            update_url: "https://blockrun.ai/ClawRouter-update",
+        });
+    });
+    it("returns null when no update_available in body", () => {
+        const body = JSON.stringify({
+            error: "Rate limited",
+            message: "Free tier: max 60 requests/hour.",
+        });
+        expect(parseUpdateHint(body)).toBeNull();
+    });
+    it("returns null for malformed JSON", () => {
+        expect(parseUpdateHint("not json")).toBeNull();
+    });
+    it("returns null for undefined body", () => {
+        expect(parseUpdateHint(undefined)).toBeNull();
+    });
+    it("returns null for empty body", () => {
+        expect(parseUpdateHint("")).toBeNull();
+    });
+});
+describe("update hint — console output", () => {
+    afterEach(() => {
+        vi.restoreAllMocks();
+    });
+    it("logs prominent update message when hint is present in 429", () => {
+        const logSpy = vi.spyOn(console, "log").mockImplementation(() => { });
+        const VERSION = "0.12.11";
+        // Simulate what proxy.ts does on 429 with update hint
+        const errorBody = JSON.stringify({
+            error: "Rate limited",
+            update_available: "0.12.12",
+            update_url: "https://blockrun.ai/ClawRouter-update",
+        });
+        try {
+            const parsed = JSON.parse(errorBody || "{}");
+            if (parsed.update_available) {
+                console.log("");
+                console.log(`\x1b[33m⬆️  ClawRouter ${parsed.update_available} available (you have ${VERSION})\x1b[0m`);
+                console.log(`   Run: \x1b[36mcurl -fsSL ${parsed.update_url || "https://blockrun.ai/ClawRouter-update"} | bash\x1b[0m`);
+                console.log("");
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        // Should have logged 4 calls (empty, version, run command, empty)
+        expect(logSpy).toHaveBeenCalledTimes(4);
+        const allCalls = logSpy.mock.calls.map((c) => c.join(" "));
+        expect(allCalls.some((c) => c.includes("0.12.12 available"))).toBe(true);
+        expect(allCalls.some((c) => c.includes("you have 0.12.11"))).toBe(true);
+        expect(allCalls.some((c) => c.includes("curl -fsSL"))).toBe(true);
+    });
+    it("does not log when no update hint in 429", () => {
+        const logSpy = vi.spyOn(console, "log").mockImplementation(() => { });
+        const errorBody = JSON.stringify({
+            error: "Rate limited",
+            message: "Provider rate limited",
+        });
+        try {
+            const parsed = JSON.parse(errorBody || "{}");
+            if (parsed.update_available) {
+                console.log("should not reach here");
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        expect(logSpy).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=update-hint.test.js.map