@relayplane/proxy 1.3.2 → 1.5.0

package/dist/server.d.ts

@@ -1,13 +1,249 @@
-#!/usr/bin/env node
 /**
- * RelayPlane Local LLM Proxy Server
+ * RelayPlane Agent Ops Proxy Server
+ *
+ * OpenAI-compatible proxy server with integrated observability via the Learning Ledger
+ * and auth enforcement via Auth Gate.
  *
- * Routes OpenAI-compatible requests to multiple providers.
  * Features:
- * - /health endpoint for monitoring
- * - Usage tracking with spending warnings
- * - Model aliases (rp:fast, rp:cheap, rp:best)
- * - Dry-run mode for testing
+ * - OpenAI-compatible `/v1/chat/completions` endpoint
+ * - Auth Gate integration for consumer vs API auth detection
+ * - Learning Ledger integration for run tracking
+ * - Timing capture (latency_ms, ttft_ms)
+ * - Structured error handling
+ *
+ * @packageDocumentation
+ */
+import { Ledger } from '@relayplane/ledger';
+import { AuthGate, type AuthProfileStorage } from '@relayplane/auth-gate';
+import { PolicyEngine, type PolicyStorage } from '@relayplane/policy-engine';
+import { RoutingEngine, type CapabilityRegistry, type ProviderManager } from '@relayplane/routing-engine';
+import { ExplanationEngine, RunComparator, Simulator } from '@relayplane/explainability';
+import type { AuthEnforcementMode } from '@relayplane/ledger';
+import { LearningEngine, type LearningEngineConfig } from '@relayplane/learning-engine';
+import { RelayPlaneMiddleware } from './middleware.js';
+import { type RelayPlaneConfig, type MeshConfig } from './relay-config.js';
+import { type MeshHandle } from './mesh.js';
+/**
+ * Proxy server configuration
+ */
+export interface ProxyServerConfig {
+    port?: number;
+    host?: string;
+    ledger?: Ledger;
+    authStorage?: AuthProfileStorage;
+    policyStorage?: PolicyStorage;
+    policyEngine?: PolicyEngine;
+    verbose?: boolean;
+    defaultWorkspaceId?: string;
+    defaultAgentId?: string;
+    defaultAuthEnforcementMode?: AuthEnforcementMode;
+    enforcePolicies?: boolean;
+    routingEngine?: RoutingEngine;
+    capabilityRegistry?: CapabilityRegistry;
+    providerManager?: ProviderManager;
+    /** Enable capability-based routing (Phase 3) */
+    enableRouting?: boolean;
+    learningEngine?: LearningEngine;
+    /** Enable learning engine analytics and suggestions (default: false) */
+    enableLearning?: boolean;
+    learningConfig?: LearningEngineConfig;
+    /** Mesh config overrides */
+    meshConfig?: Partial<MeshConfig>;
+    /** Enable mesh learning layer (default: true) */
+    enableMesh?: boolean;
+    providers?: {
+        anthropic?: {
+            apiKey: string;
+            baseUrl?: string;
+        };
+        openai?: {
+            apiKey: string;
+            baseUrl?: string;
+        };
+        openrouter?: {
+            apiKey: string;
+            baseUrl?: string;
+        };
+        google?: {
+            apiKey: string;
+            baseUrl?: string;
+        };
+        together?: {
+            apiKey: string;
+            baseUrl?: string;
+        };
+        deepseek?: {
+            apiKey: string;
+            baseUrl?: string;
+        };
+    };
+}
+/**
+ * RelayPlane Agent Ops Proxy Server
+ */
+export declare class ProxyServer {
+    private server;
+    private ledger;
+    private authGate;
+    private policyEngine;
+    private routingEngine;
+    private capabilityRegistry;
+    private providerManager;
+    private explainer;
+    private comparator;
+    private simulator;
+    private learningEngine;
+    private meshHandle;
+    private meshConfig;
+    private config;
+    constructor(config?: ProxyServerConfig);
+    /**
+     * Build provider overrides from config
+     */
+    private buildProviderOverrides;
+    /**
+     * Configure provider API keys from config
+     */
+    private configureProviderApiKeys;
+    /**
+     * Start the proxy server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the proxy server
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle incoming request
+     */
+    private handleRequest;
+    private handleListPolicies;
+    private handleCreatePolicy;
+    private handleGetPolicy;
+    private handleUpdatePolicy;
+    private handleDeletePolicy;
+    private handlePolicyTest;
+    private handleGetBudget;
+    /**
+     * Handle GET /v1/runs/{id}/explain - Full decision chain explanation
+     */
+    private handleExplainRun;
+    /**
+     * Handle GET /v1/runs/{id}/timeline - Timeline view only
+     */
+    private handleRunTimeline;
+    /**
+     * Handle GET /v1/runs/{id}/decisions - Raw decision chain
+     */
+    private handleRunDecisions;
+    /**
+     * Handle GET /v1/runs/{id} - Run inspector (all details)
+     */
+    private handleRunInspector;
+    /**
+     * Handle GET /v1/runs/compare?ids=run1,run2 - Run comparison
+     */
+    private handleCompareRuns;
+    /**
+     * Handle POST /v1/simulate/policy - Policy simulation
+     */
+    private handleSimulatePolicy;
+    /**
+     * Handle POST /v1/simulate/routing - Routing simulation
+     */
+    private handleSimulateRouting;
+    /**
+     * Handle /v1/chat/completions
+     */
+    private handleChatCompletions;
+    /**
+     * Forward request to provider
+     */
+    private forwardToProvider;
+    /**
+     * Detect auth type from Authorization header
+     */
+    private detectAuthType;
+    /**
+     * Estimate cost based on provider and usage
+     */
+    private estimateCost;
+    /**
+     * Read request body
+     */
+    private readBody;
+    /**
+     * Send error response
+     */
+    private sendError;
+    private handleAnalyticsSummary;
+    private handleRunAnalysis;
+    private handleListSuggestions;
+    private handleApproveSuggestion;
+    private handleRejectSuggestion;
+    private handleListRules;
+    private handleRuleEffectiveness;
+    /**
+     * Log message
+     */
+    private log;
+    /**
+     * Get the ledger instance (useful for testing)
+     */
+    getLedger(): Ledger;
+    /**
+     * Get the auth gate instance (useful for testing)
+     */
+    getAuthGate(): AuthGate;
+    /**
+     * Get the policy engine instance (useful for testing and policy management)
+     */
+    getPolicyEngine(): PolicyEngine;
+    /**
+     * Get the routing engine instance (Phase 3)
+     */
+    getRoutingEngine(): RoutingEngine;
+    /**
+     * Get the capability registry instance (Phase 3)
+     */
+    getCapabilityRegistry(): CapabilityRegistry;
+    /**
+     * Get the provider manager instance (Phase 3)
+     */
+    getProviderManager(): ProviderManager;
+    /**
+     * Get the explanation engine instance (Phase 4)
+     */
+    getExplainer(): ExplanationEngine;
+    /**
+     * Get the run comparator instance (Phase 4)
+     */
+    getComparator(): RunComparator;
+    /**
+     * Get the simulator instance (Phase 4)
+     */
+    getSimulator(): Simulator;
+    /**
+     * Get the learning engine instance (Phase 5)
+     */
+    getLearningEngine(): LearningEngine | null;
+    /**
+     * Get the mesh handle instance (Phase 6)
+     */
+    getMeshHandle(): MeshHandle | null;
+}
+/**
+ * Create a new proxy server
+ */
+export declare function createProxyServer(config?: ProxyServerConfig): ProxyServer;
+/**
+ * Create a proxy server with optional circuit breaker middleware wrapping.
+ * This gives the advanced proxy the same circuit breaker protection as standalone.
  */
-export {};
+export declare function createSandboxedProxyServer(config?: ProxyServerConfig & {
+    relayplane?: Partial<RelayPlaneConfig>;
+}): {
+    server: ProxyServer;
+    middleware?: RelayPlaneMiddleware;
+};
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;;;;GASG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}