@relayplane/proxy 1.1.0 → 1.1.2

package/dist/telemetry.js

@@ -0,0 +1,426 @@
+"use strict";
+/**
+ * RelayPlane Proxy Telemetry
+ *
+ * Anonymized telemetry collection for improving model routing.
+ *
+ * What we collect (exact schema):
+ * - device_id: anonymous random ID
+ * - task_type: inferred from token patterns, NOT prompt content
+ * - model: which model was used
+ * - tokens_in/out: token counts
+ * - latency_ms: response time
+ * - success: whether request succeeded
+ * - cost_usd: estimated cost
+ *
+ * What we NEVER collect:
+ * - Prompts or responses
+ * - File paths or contents
+ * - Anything that could identify you or your project
+ *
+ * @packageDocumentation
+ */
+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.inferTaskType = inferTaskType;
+exports.estimateCost = estimateCost;
+exports.setAuditMode = setAuditMode;
+exports.isAuditMode = isAuditMode;
+exports.setOfflineMode = setOfflineMode;
+exports.isOfflineMode = isOfflineMode;
+exports.getAuditBuffer = getAuditBuffer;
+exports.clearAuditBuffer = clearAuditBuffer;
+exports.recordTelemetry = recordTelemetry;
+exports.getLocalTelemetry = getLocalTelemetry;
+exports.getTelemetryStats = getTelemetryStats;
+exports.clearTelemetry = clearTelemetry;
+exports.getTelemetryPath = getTelemetryPath;
+exports.queueForUpload = queueForUpload;
+exports.flushTelemetryToCloud = flushTelemetryToCloud;
+exports.stopUploadTimer = stopUploadTimer;
+exports.getPendingUploadCount = getPendingUploadCount;
+exports.printTelemetryDisclosure = printTelemetryDisclosure;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const config_js_1 = require("./config.js");
+/**
+ * Local telemetry store using SQLite (via Ledger)
+ */
+const TELEMETRY_FILE = path.join((0, config_js_1.getConfigDir)(), 'telemetry.jsonl');
+// In-memory buffer for audit mode
+let auditBuffer = [];
+let auditMode = false;
+let offlineMode = false;
+/**
+ * Task type inference based on token patterns
+ * This infers task type from request characteristics, NOT from prompt content
+ */
+function inferTaskType(inputTokens, outputTokens, model, hasTools = false) {
+    // Simple heuristics based on token patterns
+    const ratio = outputTokens / Math.max(inputTokens, 1);
+    if (hasTools) {
+        return 'tool_use';
+    }
+    if (inputTokens > 10000) {
+        return 'long_context';
+    }
+    if (ratio > 5) {
+        return 'generation';
+    }
+    if (ratio < 0.3 && outputTokens < 100) {
+        return 'classification';
+    }
+    if (inputTokens < 500 && outputTokens < 500) {
+        return 'quick_task';
+    }
+    if (inputTokens > 2000 && outputTokens > 500) {
+        return 'code_review';
+    }
+    if (outputTokens > 1000) {
+        return 'content_generation';
+    }
+    return 'general';
+}
+/**
+ * Estimate cost based on model and token counts
+ * Pricing as of 2024 (USD per 1M tokens)
+ */
+const MODEL_PRICING = {
+    // Anthropic
+    'claude-opus-4-20250514': { input: 15.0, output: 75.0 },
+    'claude-sonnet-4-20250514': { input: 3.0, output: 15.0 },
+    'claude-3-5-sonnet-20241022': { input: 3.0, output: 15.0 },
+    'claude-3-5-sonnet-20240620': { input: 3.0, output: 15.0 },
+    'claude-3-5-haiku-20241022': { input: 0.8, output: 4.0 },
+    'claude-3-opus-20240229': { input: 15.0, output: 75.0 },
+    'claude-3-sonnet-20240229': { input: 3.0, output: 15.0 },
+    'claude-3-haiku-20240307': { input: 0.25, output: 1.25 },
+    // OpenAI
+    'gpt-4o': { input: 2.5, output: 10.0 },
+    'gpt-4o-mini': { input: 0.15, output: 0.60 },
+    'gpt-4-turbo': { input: 10.0, output: 30.0 },
+    'gpt-4': { input: 30.0, output: 60.0 },
+    'gpt-3.5-turbo': { input: 0.5, output: 1.5 },
+    // Default for unknown models
+    'default': { input: 1.0, output: 3.0 },
+};
+function estimateCost(model, inputTokens, outputTokens) {
+    const pricing = MODEL_PRICING[model] || MODEL_PRICING['default'];
+    const inputCost = (inputTokens / 1_000_000) * pricing.input;
+    const outputCost = (outputTokens / 1_000_000) * pricing.output;
+    return Math.round((inputCost + outputCost) * 10000) / 10000; // Round to 4 decimal places
+}
+/**
+ * Set audit mode - shows telemetry payload before sending
+ */
+function setAuditMode(enabled) {
+    auditMode = enabled;
+}
+/**
+ * Check if audit mode is enabled
+ */
+function isAuditMode() {
+    return auditMode;
+}
+/**
+ * Set offline mode - disables all network calls except LLM
+ */
+function setOfflineMode(enabled) {
+    offlineMode = enabled;
+}
+/**
+ * Check if offline mode is enabled
+ */
+function isOfflineMode() {
+    return offlineMode;
+}
+/**
+ * Get pending audit events
+ */
+function getAuditBuffer() {
+    return [...auditBuffer];
+}
+/**
+ * Clear audit buffer
+ */
+function clearAuditBuffer() {
+    auditBuffer = [];
+}
+/**
+ * Record a telemetry event
+ */
+function recordTelemetry(event) {
+    if (!(0, config_js_1.isTelemetryEnabled)() && !auditMode) {
+        return; // Telemetry disabled and not in audit mode
+    }
+    const fullEvent = {
+        ...event,
+        device_id: (0, config_js_1.getDeviceId)(),
+        timestamp: new Date().toISOString(),
+    };
+    if (auditMode) {
+        // In audit mode, buffer events and print them
+        auditBuffer.push(fullEvent);
+        console.log('\n📊 [TELEMETRY AUDIT] The following data would be collected:');
+        console.log(JSON.stringify(fullEvent, null, 2));
+        console.log('');
+        return;
+    }
+    if (!(0, config_js_1.isTelemetryEnabled)()) {
+        return;
+    }
+    // Store locally (append to JSONL file)
+    try {
+        const configDir = (0, config_js_1.getConfigDir)();
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+        fs.appendFileSync(TELEMETRY_FILE, JSON.stringify(fullEvent) + '\n');
+    }
+    catch (err) {
+        // Silently fail - telemetry should never break the proxy
+    }
+    // Queue for cloud upload (if not offline)
+    queueForUpload(fullEvent);
+}
+/**
+ * Get local telemetry data
+ */
+function getLocalTelemetry() {
+    try {
+        if (!fs.existsSync(TELEMETRY_FILE)) {
+            return [];
+        }
+        const data = fs.readFileSync(TELEMETRY_FILE, 'utf-8');
+        return data
+            .split('\n')
+            .filter(line => line.trim())
+            .map(line => JSON.parse(line));
+    }
+    catch (err) {
+        return [];
+    }
+}
+/**
+ * Get telemetry stats summary
+ */
+function getTelemetryStats() {
+    const events = getLocalTelemetry();
+    const byModel = {};
+    const byTaskType = {};
+    let totalCost = 0;
+    let successCount = 0;
+    for (const event of events) {
+        totalCost += event.cost_usd;
+        if (event.success)
+            successCount++;
+        if (!byModel[event.model]) {
+            byModel[event.model] = { count: 0, cost: 0 };
+        }
+        byModel[event.model].count++;
+        byModel[event.model].cost += event.cost_usd;
+        if (!byTaskType[event.task_type]) {
+            byTaskType[event.task_type] = { count: 0, cost: 0 };
+        }
+        byTaskType[event.task_type].count++;
+        byTaskType[event.task_type].cost += event.cost_usd;
+    }
+    return {
+        totalEvents: events.length,
+        totalCost: Math.round(totalCost * 100) / 100,
+        byModel,
+        byTaskType,
+        successRate: events.length > 0 ? successCount / events.length : 0,
+    };
+}
+/**
+ * Clear all local telemetry data
+ */
+function clearTelemetry() {
+    try {
+        if (fs.existsSync(TELEMETRY_FILE)) {
+            fs.unlinkSync(TELEMETRY_FILE);
+        }
+    }
+    catch (err) {
+        // Silently fail
+    }
+}
+/**
+ * Get telemetry file path
+ */
+function getTelemetryPath() {
+    return TELEMETRY_FILE;
+}
+// ============================================
+// CLOUD TELEMETRY UPLOAD
+// ============================================
+const BRAIN_API_URL = process.env.RELAYPLANE_API_URL || 'https://api.relayplane.com';
+const UPLOAD_BATCH_SIZE = 50;
+const UPLOAD_INTERVAL_MS = 60000; // 1 minute
+let uploadQueue = [];
+let uploadTimer = null;
+/**
+ * Queue an event for cloud upload
+ */
+function queueForUpload(event) {
+    if (offlineMode)
+        return;
+    uploadQueue.push(event);
+    // Flush if batch is full
+    if (uploadQueue.length >= UPLOAD_BATCH_SIZE) {
+        flushTelemetryToCloud().catch(err => {
+            console.error('[Telemetry] Failed to flush batch:', err);
+        });
+    }
+    // Start periodic flush timer if not running
+    if (!uploadTimer) {
+        uploadTimer = setInterval(() => {
+            flushTelemetryToCloud().catch(err => {
+                console.error('[Telemetry] Periodic flush failed:', err);
+            });
+        }, UPLOAD_INTERVAL_MS);
+    }
+}
+/**
+ * Flush queued telemetry to cloud
+ */
+async function flushTelemetryToCloud() {
+    if (offlineMode || uploadQueue.length === 0)
+        return;
+    const apiKey = getApiKey();
+    if (!apiKey) {
+        // No API key, can't upload
+        return;
+    }
+    const batch = uploadQueue.splice(0, UPLOAD_BATCH_SIZE);
+    try {
+        const response = await fetch(`${BRAIN_API_URL}/v1/telemetry`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify({
+                schemaVersion: '1.0',
+                events: batch,
+            }),
+        });
+        if (!response.ok) {
+            // Re-queue failed events
+            uploadQueue.unshift(...batch);
+            throw new Error(`Upload failed: ${response.status} ${response.statusText}`);
+        }
+        const result = await response.json();
+        if (result.success) {
+            // Successfully uploaded
+        }
+        else {
+            // Partial failure - log but continue
+            console.warn('[Telemetry] Partial upload failure:', result.errors);
+        }
+    }
+    catch (err) {
+        // Network error - re-queue events
+        uploadQueue.unshift(...batch);
+        throw err;
+    }
+}
+/**
+ * Get configured API key
+ */
+function getApiKey() {
+    try {
+        const configPath = path.join((0, config_js_1.getConfigDir)(), 'config.json');
+        if (fs.existsSync(configPath)) {
+            const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+            return config.apiKey || null;
+        }
+    }
+    catch (err) {
+        // Ignore config read errors
+    }
+    return process.env.RELAYPLANE_API_KEY || null;
+}
+/**
+ * Stop upload timer (for cleanup)
+ */
+function stopUploadTimer() {
+    if (uploadTimer) {
+        clearInterval(uploadTimer);
+        uploadTimer = null;
+    }
+}
+/**
+ * Get number of events pending upload
+ */
+function getPendingUploadCount() {
+    return uploadQueue.length;
+}
+/**
+ * Print telemetry disclosure message
+ */
+function printTelemetryDisclosure() {
+    console.log(`
+╭─────────────────────────────────────────────────────────────────────╮
+│                    📊 TELEMETRY DISCLOSURE                          │
+╰─────────────────────────────────────────────────────────────────────╯
+
+RelayPlane collects anonymous telemetry to improve model routing.
+
+What we collect:
+  • Anonymous device ID (random, not fingerprintable)
+  • Task type (inferred from token patterns, NOT your prompts)
+  • Model used, token counts, latency, success/failure
+  • Estimated cost
+
+What we NEVER collect:
+  • Your prompts or model responses
+  • File paths or contents
+  • Anything that could identify you or your project
+
+How to verify:
+  • Run with --audit to see exact payloads before they're sent
+  • Run with --offline to disable all telemetry transmission
+  • Full source code: https://github.com/RelayPlane/proxy
+
+To opt out completely:
+  $ relayplane-proxy telemetry off
+
+Learn more: https://relayplane.com/privacy
+
+`);
+}
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

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

package/dist/utils/model-suggestions.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Model suggestion utilities for improved error messages
+ *
+ * Uses Levenshtein distance to suggest similar model names when a
+ * requested model doesn't exist.
+ */
+/**
+ * Suggest similar models based on Levenshtein distance
+ *
+ * @param requested - The model name that was requested but not found
+ * @param available - List of available/valid model names
+ * @param max - Maximum number of suggestions to return (default: 3)
+ * @returns Array of suggested model names, sorted by similarity
+ */
+export declare function suggestModels(requested: string, available: string[], max?: number): string[];
+/**
+ * Build an error response for model-not-found errors with suggestions
+ *
+ * @param requestedModel - The model name that was requested
+ * @param availableModels - List of available model names
+ * @returns Error response object with suggestions
+ */
+export declare function buildModelNotFoundError(requestedModel: string, availableModels: string[]): {
+    error: string;
+    suggestions?: string[];
+    hint?: string;
+};
+//# sourceMappingURL=model-suggestions.d.ts.map

package/dist/utils/model-suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-suggestions.d.ts","sourceRoot":"","sources":["../../src/utils/model-suggestions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EAAE,EACnB,GAAG,SAAI,GACN,MAAM,EAAE,CAYV;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,MAAM,EACtB,eAAe,EAAE,MAAM,EAAE,GACxB;IACD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAiBA"}

package/dist/utils/model-suggestions.js

@@ -0,0 +1,50 @@
+"use strict";
+/**
+ * Model suggestion utilities for improved error messages
+ *
+ * Uses Levenshtein distance to suggest similar model names when a
+ * requested model doesn't exist.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suggestModels = suggestModels;
+exports.buildModelNotFoundError = buildModelNotFoundError;
+const fastest_levenshtein_1 = require("fastest-levenshtein");
+/**
+ * Suggest similar models based on Levenshtein distance
+ *
+ * @param requested - The model name that was requested but not found
+ * @param available - List of available/valid model names
+ * @param max - Maximum number of suggestions to return (default: 3)
+ * @returns Array of suggested model names, sorted by similarity
+ */
+function suggestModels(requested, available, max = 3) {
+    const requestedLower = requested.toLowerCase();
+    return available
+        .map((model) => ({
+        model,
+        dist: (0, fastest_levenshtein_1.distance)(requestedLower, model.toLowerCase()),
+    }))
+        .filter(({ dist }) => dist <= 4) // Within 4 edits
+        .sort((a, b) => a.dist - b.dist)
+        .slice(0, max)
+        .map(({ model }) => model);
+}
+/**
+ * Build an error response for model-not-found errors with suggestions
+ *
+ * @param requestedModel - The model name that was requested
+ * @param availableModels - List of available model names
+ * @returns Error response object with suggestions
+ */
+function buildModelNotFoundError(requestedModel, availableModels) {
+    const suggestions = suggestModels(requestedModel, availableModels);
+    const response = {
+        error: `Model '${requestedModel}' does not exist`,
+    };
+    if (suggestions.length > 0) {
+        response.suggestions = suggestions;
+        response.hint = `Did you mean '${suggestions[0]}'?`;
+    }
+    return response;
+}
+//# sourceMappingURL=model-suggestions.js.map

package/dist/utils/model-suggestions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-suggestions.js","sourceRoot":"","sources":["../../src/utils/model-suggestions.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAYH,sCAgBC;AASD,0DAwBC;AA3DD,6DAA+C;AAE/C;;;;;;;GAOG;AACH,SAAgB,aAAa,CAC3B,SAAiB,EACjB,SAAmB,EACnB,GAAG,GAAG,CAAC;IAEP,MAAM,cAAc,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAE/C,OAAO,SAAS;SACb,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACf,KAAK;QACL,IAAI,EAAE,IAAA,8BAAQ,EAAC,cAAc,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC;KACpD,CAAC,CAAC;SACF,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,iBAAiB;SACjD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC;SAC/B,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;SACb,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,uBAAuB,CACrC,cAAsB,EACtB,eAAyB;IAMzB,MAAM,WAAW,GAAG,aAAa,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAEnE,MAAM,QAAQ,GAIV;QACF,KAAK,EAAE,UAAU,cAAc,kBAAkB;KAClD,CAAC;IAEF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;QACnC,QAAQ,CAAC,IAAI,GAAG,iBAAiB,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;IACtD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -1,52 +1,58 @@
 {
   "name": "@relayplane/proxy",
-  "version": "1.1.0",
-  "description": "RelayPlane Local LLM Proxy - Route requests through multiple providers",
-  "type": "module",
-  "main": "dist/server.js",
-  "types": "dist/server.d.ts",
+  "version": "1.1.2",
+  "description": "RelayPlane proxy server - intelligent AI model routing with observability",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
   "bin": {
-    "relayplane-proxy": "dist/server.js"
+    "relayplane-proxy": "dist/cli.js"
   },
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "start": "node dist/server.js",
+    "start": "node dist/cli.js",
     "test": "vitest run",
     "test:watch": "vitest",
-    "type-check": "tsc --noEmit",
-    "clean": "rm -rf dist"
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
-    "proxy",
+    "relayplane",
+    "ai",
     "llm",
-    "openai",
+    "proxy",
+    "routing",
     "anthropic",
-    "ai",
-    "relayplane"
+    "openai",
+    "gemini",
+    "openclaw",
+    "observability",
+    "agent-ops"
   ],
   "author": "RelayPlane",
   "license": "MIT",
-  "homepage": "https://relayplane.com",
+  "dependencies": {
+    "@relayplane/core": "^0.1.1",
+    "fastest-levenshtein": "^1.0.16"
+  },
+  "optionalDependencies": {
+    "@relayplane/auth-gate": "^0.1.0",
+    "@relayplane/explainability": "^0.1.0",
+    "@relayplane/ledger": "^0.1.0",
+    "@relayplane/policy-engine": "^0.1.0",
+    "@relayplane/routing-engine": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3",
+    "vitest": "^1.1.0"
+  },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=18"
   },
   "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
+    "access": "public"
   },
   "files": [
     "dist",
-    "README.md",
-    "LICENSE"
-  ],
-  "dependencies": {
-    "node-fetch": "^2.7.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.10.0",
-    "@types/node-fetch": "^2.6.11",
-    "typescript": "^5.3.3",
-    "vitest": "^1.1.0"
-  }
+    "README.md"
+  ]
 }