@relayplane/proxy 1.9.18 → 1.9.21

package/dist/policy-analyzer.js

@@ -0,0 +1,268 @@
+"use strict";
+/**
+ * Policy Analyzer
+ *
+ * Reads routing-log.jsonl directly (not the in-memory buffer) and joins with
+ * agents.json to produce per-agent traffic summaries used by the suggestion engine
+ * and CLI display.
+ */
+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.MODEL_COST_PER_1M = void 0;
+exports.estimateDailyCost = estimateDailyCost;
+exports.inferAgentName = inferAgentName;
+exports.analyzeTraffic = analyzeTraffic;
+const fs = __importStar(require("node:fs"));
+const routing_log_js_1 = require("./routing-log.js");
+const agent_tracker_js_1 = require("./agent-tracker.js");
+// ─── Model cost table ─────────────────────────────────────────────────────────
+// Costs in USD per 1M tokens. Input/output separately.
+// Update when provider pricing changes.
+exports.MODEL_COST_PER_1M = {
+    'anthropic/claude-opus-4-5': { input: 15.00, output: 75.00 },
+    'anthropic/claude-opus-4': { input: 15.00, output: 75.00 },
+    'anthropic/claude-sonnet-4-5': { input: 3.00, output: 15.00 },
+    'anthropic/claude-sonnet-4': { input: 3.00, output: 15.00 },
+    'anthropic/claude-haiku-4-5': { input: 0.80, output: 4.00 },
+    'anthropic/claude-haiku-4': { input: 0.80, output: 4.00 },
+    'openai/gpt-4o': { input: 2.50, output: 10.00 },
+    'openai/gpt-4o-mini': { input: 0.15, output: 0.60 },
+    'google/gemini-2.0-flash': { input: 0.10, output: 0.40 },
+    'google/gemini-1.5-flash': { input: 0.075, output: 0.30 },
+    'groq/llama-3.3-70b': { input: 0.59, output: 0.79 },
+    'groq/llama-3.1-8b-instant': { input: 0.05, output: 0.08 },
+    'openrouter/auto': { input: 1.00, output: 5.00 }, // rough estimate
+};
+function estimateDailyCost(avgInputTokens, avgOutputTokens, requestsPerDay, model) {
+    const costs = exports.MODEL_COST_PER_1M[model];
+    if (!costs)
+        return 0;
+    const perRequest = (avgInputTokens / 1_000_000) * costs.input +
+        (avgOutputTokens / 1_000_000) * costs.output;
+    return perRequest * requestsPerDay;
+}
+// ─── Name inference ───────────────────────────────────────────────────────────
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/\s+/g, '-')
+        .replace(/[^a-z0-9-]/g, '')
+        .slice(0, 24);
+}
+/**
+ * Infer a human-readable agent name from its system prompt and task distribution.
+ */
+function inferAgentName(systemPromptPreview, taskDistribution) {
+    // Priority 1: "You are a/an [role]"
+    const youAreMatch = systemPromptPreview.match(/you are (?:a |an )?([A-Za-z][\w\s]{1,24})/i);
+    if (youAreMatch && youAreMatch[1]) {
+        return slugify(youAreMatch[1].trim());
+    }
+    // Priority 2: "Your job/role/task/purpose is to [verb]"
+    const jobMatch = systemPromptPreview.match(/your (?:job|role|task|purpose) is to (\w+)/i);
+    if (jobMatch && jobMatch[1]) {
+        return slugify(jobMatch[1].trim()) + '-agent';
+    }
+    // Priority 3: "As a/an [role] assistant/agent/bot"
+    const asAMatch = systemPromptPreview.match(/as (?:a |an )?(\w+(?:\s+\w+)?) (?:assistant|agent|bot)/i);
+    if (asAMatch && asAMatch[1]) {
+        return slugify(asAMatch[1].trim());
+    }
+    // Priority 4: fallback to dominant task
+    const dominant = Object.entries(taskDistribution).sort((a, b) => b[1] - a[1])[0];
+    if (dominant) {
+        return dominant[0] + '-agent';
+    }
+    return 'unknown-agent';
+}
+// ─── Main analysis function ───────────────────────────────────────────────────
+/**
+ * Read routing-log.jsonl and agents.json to produce per-agent traffic summaries.
+ * Default lookbackDays = 7.
+ */
+async function analyzeTraffic(opts) {
+    const lookbackDays = opts?.lookbackDays ?? 7;
+    const cutoff = Date.now() - lookbackDays * 86_400_000;
+    // 1. Read JSONL file
+    if (!fs.existsSync(routing_log_js_1.LOG_FILE)) {
+        return [];
+    }
+    let lines;
+    try {
+        const content = fs.readFileSync(routing_log_js_1.LOG_FILE, 'utf-8');
+        lines = content.split('\n').filter(l => l.trim().length > 0);
+    }
+    catch {
+        return [];
+    }
+    // Parse and filter entries within lookback window
+    const entries = [];
+    for (const line of lines) {
+        try {
+            const entry = JSON.parse(line);
+            const ts = Date.parse(entry.ts);
+            if (!isNaN(ts) && ts >= cutoff) {
+                entries.push(entry);
+            }
+        }
+        catch {
+            // Skip corrupt lines
+        }
+    }
+    if (entries.length === 0) {
+        return [];
+    }
+    // 2. Group by agentFingerprint (skip null fingerprints)
+    const groups = new Map();
+    for (const entry of entries) {
+        if (!entry.agentFingerprint)
+            continue;
+        const existing = groups.get(entry.agentFingerprint);
+        if (existing) {
+            existing.push(entry);
+        }
+        else {
+            groups.set(entry.agentFingerprint, [entry]);
+        }
+    }
+    if (groups.size === 0) {
+        return [];
+    }
+    // 3. Load agent registry
+    const registry = (0, agent_tracker_js_1.getAgentRegistry)();
+    // 4. Build analysis for each fingerprint group
+    const analyses = [];
+    for (const [fingerprint, groupEntries] of groups) {
+        const total = groupEntries.length;
+        // a. Task distribution
+        const taskCounts = {};
+        for (const e of groupEntries) {
+            taskCounts[e.taskType] = (taskCounts[e.taskType] ?? 0) + 1;
+        }
+        const taskDistribution = {};
+        for (const [task, count] of Object.entries(taskCounts)) {
+            taskDistribution[task] = count / total;
+        }
+        // b. Dominant task
+        const dominantTask = Object.entries(taskDistribution).sort((a, b) => b[1] - a[1])[0]?.[0] ?? 'unknown';
+        // c. Token averages
+        const entriesWithTokens = groupEntries.filter(e => e.inputTokens !== undefined || e.outputTokens !== undefined);
+        let avgInputTokens;
+        let avgOutputTokens;
+        let tokensAreEstimated;
+        if (entriesWithTokens.length > 0) {
+            avgInputTokens = entriesWithTokens.reduce((sum, e) => sum + (e.inputTokens ?? 0), 0) / entriesWithTokens.length;
+            avgOutputTokens = entriesWithTokens.reduce((sum, e) => sum + (e.outputTokens ?? 0), 0) / entriesWithTokens.length;
+            tokensAreEstimated = false;
+        }
+        else {
+            // Estimate from cost: assume 80/20 input/output split
+            // We'll estimate based on the model pricing
+            let totalEstimatedTokens = 0;
+            let validEntries = 0;
+            for (const e of groupEntries) {
+                const costs = exports.MODEL_COST_PER_1M[e.resolvedModel];
+                if (costs && costs.input > 0) {
+                    // Rough estimate: use a small baseline if cost not available
+                    const estimatedTokens = 2000; // baseline
+                    totalEstimatedTokens += estimatedTokens;
+                    validEntries++;
+                }
+            }
+            const avgTotal = validEntries > 0 ? totalEstimatedTokens / validEntries : 2000;
+            avgInputTokens = avgTotal * 0.8;
+            avgOutputTokens = avgTotal * 0.2;
+            tokensAreEstimated = true;
+        }
+        const avgTotalTokens = avgInputTokens + avgOutputTokens;
+        // d. Current model (most recent entry by ts)
+        const sortedByTs = [...groupEntries].sort((a, b) => Date.parse(b.ts) - Date.parse(a.ts));
+        const currentModel = sortedByTs[0]?.resolvedModel ?? 'unknown';
+        // e. Join with agents.json
+        const registryEntry = registry[fingerprint];
+        let daysObserved = 1;
+        let costPerDay = 0;
+        let requestsPerDay = total;
+        let systemPromptPreview = '';
+        let totalRequests = total;
+        let name;
+        let nameIsInferred;
+        if (registryEntry) {
+            const firstSeen = Date.parse(registryEntry.firstSeen);
+            const lastSeen = Date.parse(registryEntry.lastSeen);
+            daysObserved = Math.max(1, (lastSeen - firstSeen) / 86_400_000);
+            costPerDay = registryEntry.totalCost / daysObserved;
+            requestsPerDay = registryEntry.totalRequests / daysObserved;
+            systemPromptPreview = (registryEntry.systemPromptPreview ?? '').slice(0, 80);
+            totalRequests = registryEntry.totalRequests;
+            // Use registry name if user-renamed (not "Agent N" pattern)
+            const isDefaultName = /^Agent \d+$/.test(registryEntry.name);
+            if (!isDefaultName) {
+                name = registryEntry.name;
+                nameIsInferred = false;
+            }
+            else {
+                name = inferAgentName(systemPromptPreview, taskDistribution);
+                nameIsInferred = true;
+            }
+        }
+        else {
+            // Fingerprint in log but not in agents.json — use log data
+            name = inferAgentName(systemPromptPreview, taskDistribution);
+            nameIsInferred = true;
+        }
+        analyses.push({
+            fingerprint,
+            name,
+            nameIsInferred,
+            taskDistribution,
+            dominantTask,
+            avgInputTokens,
+            avgOutputTokens,
+            avgTotalTokens,
+            tokensAreEstimated,
+            requestsPerDay,
+            costPerDay,
+            currentModel,
+            daysObserved,
+            totalRequests,
+            systemPromptPreview,
+        });
+    }
+    // 5. Sort by costPerDay descending
+    analyses.sort((a, b) => b.costPerDay - a.costPerDay);
+    return analyses;
+}
+//# sourceMappingURL=policy-analyzer.js.map

package/dist/policy-analyzer.js.map

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

package/dist/policy-suggestions.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Policy Suggestions
+ *
+ * Takes AgentAnalysis[] and available providers to produce PolicySuggestion[]
+ * with model recommendations and savings estimates.
+ */
+import type { AgentAnalysis } from './policy-analyzer.js';
+export interface PolicySuggestion {
+    fingerprint: string;
+    agentName: string;
+    currentModel: string;
+    suggestedModel: string;
+    escalateTo?: string;
+    escalateOn?: Array<'complexity_high' | 'rate_limit' | 'error'>;
+    neverDowngrade: boolean;
+    reason: string;
+    estimatedDailySavings: number;
+    estimatedMonthlySavings: number;
+    noSuggestion?: boolean;
+    noSuggestionReason?: string;
+}
+/**
+ * Returns list of provider names (lowercase) where a key is available.
+ * Checks both env vars and config file. Deduplicates.
+ */
+export declare function detectAvailableProviders(): string[];
+/**
+ * Produce suggestions for all agents.
+ */
+export declare function suggestPolicies(analyses: AgentAnalysis[], availableProviders: string[]): PolicySuggestion[];
+//# sourceMappingURL=policy-suggestions.d.ts.map

package/dist/policy-suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-suggestions.d.ts","sourceRoot":"","sources":["../src/policy-suggestions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC,iBAAiB,GAAG,YAAY,GAAG,OAAO,CAAC,CAAC;IAC/D,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,MAAM,CAAC;IAC9B,uBAAuB,EAAE,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAID;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAwBnD;AAuID;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,kBAAkB,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAE3G"}

package/dist/policy-suggestions.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * Policy Suggestions
+ *
+ * Takes AgentAnalysis[] and available providers to produce PolicySuggestion[]
+ * with model recommendations and savings estimates.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectAvailableProviders = detectAvailableProviders;
+exports.suggestPolicies = suggestPolicies;
+const config_js_1 = require("./config.js");
+const policy_analyzer_js_1 = require("./policy-analyzer.js");
+// ─── Provider detection ────────────────────────────────────────────────────────
+/**
+ * Returns list of provider names (lowercase) where a key is available.
+ * Checks both env vars and config file. Deduplicates.
+ */
+function detectAvailableProviders() {
+    const providers = new Set();
+    // Check environment variables
+    if (process.env['ANTHROPIC_API_KEY'])
+        providers.add('anthropic');
+    if (process.env['OPENAI_API_KEY'])
+        providers.add('openai');
+    if (process.env['GOOGLE_API_KEY'])
+        providers.add('google');
+    if (process.env['GEMINI_API_KEY'])
+        providers.add('google'); // alias
+    if (process.env['GROQ_API_KEY'])
+        providers.add('groq');
+    if (process.env['OPENROUTER_API_KEY'])
+        providers.add('openrouter');
+    // Check config file
+    try {
+        const providerConfigs = (0, config_js_1.getProviderConfigs)();
+        for (const [providerName, config] of Object.entries(providerConfigs)) {
+            if (config.accounts && config.accounts.length > 0 && config.accounts[0]?.apiKey) {
+                providers.add(providerName.toLowerCase());
+            }
+        }
+    }
+    catch {
+        // Config may not exist — that's fine
+    }
+    return [...providers].sort();
+}
+// ─── Suggestion engine ────────────────────────────────────────────────────────
+/**
+ * Returns first candidate model whose provider prefix is in availableProviders.
+ * Returns null if none are available.
+ */
+function bestAvailable(candidates, providers) {
+    for (const candidate of candidates) {
+        const prefix = candidate.split('/')[0] ?? '';
+        if (providers.includes(prefix)) {
+            return candidate;
+        }
+    }
+    return null;
+}
+/**
+ * Produce a policy suggestion for a single agent.
+ */
+function suggestForAgent(analysis, availableProviders) {
+    const { fingerprint, name: agentName, currentModel, taskDistribution, avgTotalTokens, costPerDay, requestsPerDay, avgInputTokens, avgOutputTokens } = analysis;
+    let suggestedModel = null;
+    let escalateTo;
+    let escalateOn;
+    let neverDowngrade = false;
+    let reason = '';
+    // RULE 1 — Long-context: avgTotalTokens > 50_000
+    if (avgTotalTokens > 50_000) {
+        suggestedModel = bestAvailable([
+            'anthropic/claude-opus-4-5', 'anthropic/claude-opus-4',
+            'openai/gpt-4o',
+        ], availableProviders);
+        neverDowngrade = true;
+        reason = `Long-context patterns (avg ${Math.round(avgTotalTokens / 1000)}K tokens) — keep on full-context model`;
+    }
+    // RULE 2 — Security/review: review + security >= 0.8
+    else if ((taskDistribution['review'] ?? 0) + (taskDistribution['security'] ?? 0) >= 0.8) {
+        const pct = Math.round(((taskDistribution['review'] ?? 0) + (taskDistribution['security'] ?? 0)) * 100);
+        suggestedModel = bestAvailable([
+            'anthropic/claude-opus-4-5', 'anthropic/claude-opus-4',
+        ], availableProviders) ?? currentModel;
+        neverDowngrade = true;
+        reason = `High review/security share (${pct}%) — never downgrade for accuracy`;
+    }
+    // RULE 3 — Code-heavy: code >= 0.8
+    else if ((taskDistribution['code'] ?? 0) >= 0.8) {
+        const pct = Math.round((taskDistribution['code'] ?? 0) * 100);
+        suggestedModel = bestAvailable([
+            'anthropic/claude-sonnet-4-5', 'anthropic/claude-sonnet-4', 'openai/gpt-4o',
+        ], availableProviders);
+        escalateTo = bestAvailable([
+            'anthropic/claude-opus-4-5', 'anthropic/claude-opus-4',
+        ], availableProviders) ?? undefined;
+        escalateOn = ['complexity_high'];
+        neverDowngrade = false;
+        reason = `Code-heavy (${pct}%) — sonnet for speed, escalate to opus on complexity`;
+    }
+    // RULE 4 — Summarization: summarization >= 0.8
+    else if ((taskDistribution['summarization'] ?? 0) >= 0.8) {
+        const pct = Math.round((taskDistribution['summarization'] ?? 0) * 100);
+        suggestedModel = bestAvailable([
+            'google/gemini-2.0-flash', 'google/gemini-1.5-flash',
+            'anthropic/claude-haiku-4-5', 'openai/gpt-4o-mini',
+        ], availableProviders);
+        neverDowngrade = false;
+        reason = `Summarization-heavy (${pct}%) — fast/cheap model`;
+    }
+    // RULE 5 — Simple/utility: (simple + utility) >= 0.8 AND avgTotalTokens < 5_000
+    else if (((taskDistribution['simple'] ?? 0) + (taskDistribution['utility'] ?? 0)) >= 0.8 &&
+        avgTotalTokens < 5_000) {
+        const pct = Math.round(((taskDistribution['simple'] ?? 0) + (taskDistribution['utility'] ?? 0)) * 100);
+        suggestedModel = bestAvailable([
+            'groq/llama-3.1-8b-instant', 'groq/llama-3.3-70b',
+            'google/gemini-2.0-flash', 'anthropic/claude-haiku-4-5', 'openai/gpt-4o-mini',
+        ], availableProviders);
+        neverDowngrade = false;
+        reason = `Simple tasks with low token volume (avg ${Math.round(avgTotalTokens)} tokens) — cheapest capable model`;
+    }
+    // DEFAULT — no dominant pattern
+    else {
+        suggestedModel = bestAvailable([
+            'anthropic/claude-sonnet-4-5', 'openai/gpt-4o', 'google/gemini-2.0-flash',
+        ], availableProviders);
+        neverDowngrade = false;
+        reason = 'Mixed patterns — balanced capability model';
+    }
+    // Post-rule: handle null or same model
+    let noSuggestion;
+    let noSuggestionReason;
+    if (suggestedModel === null) {
+        noSuggestion = true;
+        noSuggestionReason = "No available provider for this agent's task profile";
+        suggestedModel = currentModel;
+    }
+    else if (suggestedModel === currentModel) {
+        noSuggestion = true;
+        noSuggestionReason = 'Already on the recommended model';
+    }
+    // Compute savings
+    const projectedDailyCost = (0, policy_analyzer_js_1.estimateDailyCost)(avgInputTokens, avgOutputTokens, requestsPerDay, suggestedModel);
+    const estimatedDailySavings = Math.max(0, costPerDay - projectedDailyCost);
+    const estimatedMonthlySavings = estimatedDailySavings * 30;
+    const result = {
+        fingerprint,
+        agentName,
+        currentModel,
+        suggestedModel,
+        neverDowngrade,
+        reason,
+        estimatedDailySavings,
+        estimatedMonthlySavings,
+    };
+    if (escalateTo)
+        result.escalateTo = escalateTo;
+    if (escalateOn)
+        result.escalateOn = escalateOn;
+    if (noSuggestion !== undefined)
+        result.noSuggestion = noSuggestion;
+    if (noSuggestionReason !== undefined)
+        result.noSuggestionReason = noSuggestionReason;
+    return result;
+}
+/**
+ * Produce suggestions for all agents.
+ */
+function suggestPolicies(analyses, availableProviders) {
+    return analyses.map(a => suggestForAgent(a, availableProviders));
+}
+//# sourceMappingURL=policy-suggestions.js.map

package/dist/policy-suggestions.js.map

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

package/dist/routing-log.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Routing Log
+ *
+ * In-memory ring buffer (1000 entries) with JSONL persistence at
+ * ~/.relayplane/routing-log.jsonl. Tracks all routing decisions for
+ * observability and debugging.
+ */
+import type { ResolvedBy } from './agent-policy.js';
+export interface RoutingLogEntry {
+    ts: string;
+    requestId: string;
+    agentFingerprint: string | null;
+    agentName: string | null;
+    taskType: string;
+    complexity: string;
+    resolvedModel: string;
+    resolvedBy: ResolvedBy;
+    candidateModel: string | null;
+    reason: string;
+    inputTokens?: number;
+    outputTokens?: number;
+}
+export declare const LOG_FILE: string;
+/** Reset for testing */
+export declare function _resetRoutingLog(): void;
+/**
+ * Initialize routing log by loading the last 1000 lines from file.
+ * Called once on proxy startup.
+ */
+export declare function initRoutingLog(): void;
+/**
+ * Append a routing decision to the in-memory buffer and JSONL file.
+ */
+export declare function appendRoutingLog(entry: RoutingLogEntry): void;
+/**
+ * Get routing log entries from the in-memory buffer with optional filters.
+ */
+export declare function getRoutingLog(opts?: {
+    limit?: number;
+    agentFingerprint?: string;
+    taskType?: string;
+}): RoutingLogEntry[];
+/**
+ * No-op flush — writes are synchronous. Called for symmetry on shutdown.
+ */
+export declare function flushRoutingLog(): void;
+//# sourceMappingURL=routing-log.d.ts.map

package/dist/routing-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-log.d.ts","sourceRoot":"","sources":["../src/routing-log.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAKD,eAAO,MAAM,QAAQ,QAA0C,CAAC;AAShE,wBAAwB;AACxB,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAID;;;GAGG;AACH,wBAAgB,cAAc,IAAI,IAAI,CAkBrC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAyB7D;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,CAAC,EAAE;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,eAAe,EAAE,CAcpB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}