@relayplane/proxy 1.1.0 → 1.1.2

package/dist/index.js

@@ -0,0 +1,60 @@
+"use strict";
+/**
+ * @relayplane/proxy
+ *
+ * RelayPlane Agent Ops Proxy Server
+ *
+ * Intelligent AI model routing with integrated observability.
+ * This is a standalone proxy that routes requests to optimal models
+ * based on task type and cost optimization.
+ *
+ * @example
+ * ```typescript
+ * import { startProxy } from '@relayplane/proxy';
+ *
+ * // Start the proxy server
+ * await startProxy({ port: 3001 });
+ * ```
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printTelemetryDisclosure = exports.getTelemetryPath = exports.clearTelemetry = exports.getTelemetryStats = exports.getLocalTelemetry = exports.clearAuditBuffer = exports.getAuditBuffer = exports.isOfflineMode = exports.setOfflineMode = exports.isAuditMode = exports.setAuditMode = exports.estimateCost = exports.inferTaskType = exports.recordTelemetry = exports.getConfigPath = exports.getConfigDir = exports.getApiKey = exports.setApiKey = exports.getDeviceId = exports.disableTelemetry = exports.enableTelemetry = exports.isTelemetryEnabled = exports.markFirstRunComplete = exports.isFirstRun = exports.updateConfig = exports.saveConfig = exports.loadConfig = exports.startProxy = void 0;
+// Standalone proxy (requires only @relayplane/core)
+var standalone_proxy_js_1 = require("./standalone-proxy.js");
+Object.defineProperty(exports, "startProxy", { enumerable: true, get: function () { return standalone_proxy_js_1.startProxy; } });
+// Configuration
+var config_js_1 = require("./config.js");
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_js_1.loadConfig; } });
+Object.defineProperty(exports, "saveConfig", { enumerable: true, get: function () { return config_js_1.saveConfig; } });
+Object.defineProperty(exports, "updateConfig", { enumerable: true, get: function () { return config_js_1.updateConfig; } });
+Object.defineProperty(exports, "isFirstRun", { enumerable: true, get: function () { return config_js_1.isFirstRun; } });
+Object.defineProperty(exports, "markFirstRunComplete", { enumerable: true, get: function () { return config_js_1.markFirstRunComplete; } });
+Object.defineProperty(exports, "isTelemetryEnabled", { enumerable: true, get: function () { return config_js_1.isTelemetryEnabled; } });
+Object.defineProperty(exports, "enableTelemetry", { enumerable: true, get: function () { return config_js_1.enableTelemetry; } });
+Object.defineProperty(exports, "disableTelemetry", { enumerable: true, get: function () { return config_js_1.disableTelemetry; } });
+Object.defineProperty(exports, "getDeviceId", { enumerable: true, get: function () { return config_js_1.getDeviceId; } });
+Object.defineProperty(exports, "setApiKey", { enumerable: true, get: function () { return config_js_1.setApiKey; } });
+Object.defineProperty(exports, "getApiKey", { enumerable: true, get: function () { return config_js_1.getApiKey; } });
+Object.defineProperty(exports, "getConfigDir", { enumerable: true, get: function () { return config_js_1.getConfigDir; } });
+Object.defineProperty(exports, "getConfigPath", { enumerable: true, get: function () { return config_js_1.getConfigPath; } });
+// Telemetry
+var telemetry_js_1 = require("./telemetry.js");
+Object.defineProperty(exports, "recordTelemetry", { enumerable: true, get: function () { return telemetry_js_1.recordTelemetry; } });
+Object.defineProperty(exports, "inferTaskType", { enumerable: true, get: function () { return telemetry_js_1.inferTaskType; } });
+Object.defineProperty(exports, "estimateCost", { enumerable: true, get: function () { return telemetry_js_1.estimateCost; } });
+Object.defineProperty(exports, "setAuditMode", { enumerable: true, get: function () { return telemetry_js_1.setAuditMode; } });
+Object.defineProperty(exports, "isAuditMode", { enumerable: true, get: function () { return telemetry_js_1.isAuditMode; } });
+Object.defineProperty(exports, "setOfflineMode", { enumerable: true, get: function () { return telemetry_js_1.setOfflineMode; } });
+Object.defineProperty(exports, "isOfflineMode", { enumerable: true, get: function () { return telemetry_js_1.isOfflineMode; } });
+Object.defineProperty(exports, "getAuditBuffer", { enumerable: true, get: function () { return telemetry_js_1.getAuditBuffer; } });
+Object.defineProperty(exports, "clearAuditBuffer", { enumerable: true, get: function () { return telemetry_js_1.clearAuditBuffer; } });
+Object.defineProperty(exports, "getLocalTelemetry", { enumerable: true, get: function () { return telemetry_js_1.getLocalTelemetry; } });
+Object.defineProperty(exports, "getTelemetryStats", { enumerable: true, get: function () { return telemetry_js_1.getTelemetryStats; } });
+Object.defineProperty(exports, "clearTelemetry", { enumerable: true, get: function () { return telemetry_js_1.clearTelemetry; } });
+Object.defineProperty(exports, "getTelemetryPath", { enumerable: true, get: function () { return telemetry_js_1.getTelemetryPath; } });
+Object.defineProperty(exports, "printTelemetryDisclosure", { enumerable: true, get: function () { return telemetry_js_1.printTelemetryDisclosure; } });
+// Note: Advanced features (ProxyServer, streaming, etc.) require additional
+// dependencies. Install @relayplane/ledger, @relayplane/auth-gate, etc.
+// for full functionality. See documentation for details.
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;GAkBG;;;AAEH,oDAAoD;AACpD,6DAAmD;AAA1C,iHAAA,UAAU,OAAA;AAGnB,gBAAgB;AAChB,yCAcqB;AAbnB,uGAAA,UAAU,OAAA;AACV,uGAAA,UAAU,OAAA;AACV,yGAAA,YAAY,OAAA;AACZ,uGAAA,UAAU,OAAA;AACV,iHAAA,oBAAoB,OAAA;AACpB,+GAAA,kBAAkB,OAAA;AAClB,4GAAA,eAAe,OAAA;AACf,6GAAA,gBAAgB,OAAA;AAChB,wGAAA,WAAW,OAAA;AACX,sGAAA,SAAS,OAAA;AACT,sGAAA,SAAS,OAAA;AACT,yGAAA,YAAY,OAAA;AACZ,0GAAA,aAAa,OAAA;AAIf,YAAY;AACZ,+CAewB;AAdtB,+GAAA,eAAe,OAAA;AACf,6GAAA,aAAa,OAAA;AACb,4GAAA,YAAY,OAAA;AACZ,4GAAA,YAAY,OAAA;AACZ,2GAAA,WAAW,OAAA;AACX,8GAAA,cAAc,OAAA;AACd,6GAAA,aAAa,OAAA;AACb,8GAAA,cAAc,OAAA;AACd,gHAAA,gBAAgB,OAAA;AAChB,iHAAA,iBAAiB,OAAA;AACjB,iHAAA,iBAAiB,OAAA;AACjB,8GAAA,cAAc,OAAA;AACd,gHAAA,gBAAgB,OAAA;AAChB,wHAAA,wBAAwB,OAAA;AAO1B,4EAA4E;AAC5E,wEAAwE;AACxE,yDAAyD"}

package/dist/standalone-proxy.d.ts

@@ -0,0 +1,101 @@
+/**
+ * RelayPlane L2/L3 Proxy Server
+ *
+ * An LLM Gateway proxy that intelligently routes requests
+ * to the optimal model using @relayplane/core.
+ *
+ * Supports:
+ * - OpenAI-compatible API (/v1/chat/completions)
+ * - Native Anthropic API (/v1/messages) for Claude Code integration
+ * - Streaming (SSE) for both OpenAI and Anthropic formats
+ * - Auth passthrough for Claude Code (OAuth/subscription billing)
+ * - Cross-provider routing (Anthropic, OpenAI, Google, xAI)
+ * - Tool/function calling with format conversion
+ *
+ * Authentication:
+ * - Anthropic: Passthrough incoming Authorization header OR ANTHROPIC_API_KEY env
+ * - Other providers: Require provider-specific API key env vars
+ *
+ * @packageDocumentation
+ */
+import * as http from 'node:http';
+import type { Provider } from '@relayplane/core';
+/**
+ * Provider endpoint configuration
+ */
+export interface ProviderEndpoint {
+    baseUrl: string;
+    apiKeyEnv: string;
+}
+/**
+ * Default provider endpoints
+ */
+export declare const DEFAULT_ENDPOINTS: Record<string, ProviderEndpoint>;
+/**
+ * Model to provider/model mapping
+ */
+export declare const MODEL_MAPPING: Record<string, {
+    provider: Provider;
+    model: string;
+}>;
+/**
+ * RelayPlane model aliases - resolve before routing
+ * These are user-friendly aliases that map to internal routing modes
+ */
+export declare const RELAYPLANE_ALIASES: Record<string, string>;
+/**
+ * Smart routing aliases - map to specific provider/model combinations
+ * These provide semantic shortcuts for common use cases
+ */
+export declare const SMART_ALIASES: Record<string, {
+    provider: Provider;
+    model: string;
+}>;
+/**
+ * Get all available model names for error suggestions
+ */
+export declare function getAvailableModelNames(): string[];
+/**
+ * Resolve model aliases before routing
+ * Returns the resolved model name (may be same as input if no alias found)
+ */
+export declare function resolveModelAlias(model: string): string;
+type RoutingSuffix = 'cost' | 'fast' | 'quality';
+interface ParsedModel {
+    baseModel: string;
+    suffix: RoutingSuffix | null;
+}
+interface CascadeConfig {
+    enabled: boolean;
+    models: string[];
+    escalateOn: 'uncertainty' | 'refusal' | 'error';
+    maxEscalations: number;
+}
+type Complexity = 'simple' | 'moderate' | 'complex';
+/**
+ * Proxy server configuration
+ */
+export interface ProxyConfig {
+    port?: number;
+    host?: string;
+    dbPath?: string;
+    verbose?: boolean;
+    /**
+     * Auth passthrough mode for Anthropic requests.
+     * - 'passthrough': Forward incoming Authorization header to Anthropic (for Claude Code OAuth)
+     * - 'env': Always use ANTHROPIC_API_KEY env var
+     * - 'auto' (default): Use incoming auth if present, fallback to env var
+     */
+    anthropicAuth?: 'passthrough' | 'env' | 'auto';
+}
+export declare function parseModelSuffix(model: string): ParsedModel;
+export declare function classifyComplexity(messages: Array<{
+    content?: unknown;
+}>): Complexity;
+export declare function shouldEscalate(responseText: string, trigger: CascadeConfig['escalateOn']): boolean;
+/**
+ * Start the RelayPlane proxy server
+ */
+export declare function startProxy(config?: ProxyConfig): Promise<http.Server>;
+export {};
+//# sourceMappingURL=standalone-proxy.d.ts.map

package/dist/standalone-proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"standalone-proxy.d.ts","sourceRoot":"","sources":["../src/standalone-proxy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAKlC,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,kBAAkB,CAAC;AAG3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAqB9D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAa/E,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGrD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,QAAQ,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAQ/E,CAAC;AAEF;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,EAAE,CAWjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMvD;AAkBD,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEjD,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CAC9B;AAcD,UAAU,aAAa;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD,cAAc,EAAE,MAAM,CAAC;CACxB;AAmBD,KAAK,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;AA6EpD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,aAAa,GAAG,KAAK,GAAG,MAAM,CAAC;CAChD;AAqOD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAe3D;AAsDD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAAG,UAAU,CAiBrF;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,GAAG,OAAO,CAIlG;AA+zCD;;GAEG;AACH,wBAAsB,UAAU,CAAC,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CA04B/E"}