@relayplane/proxy 0.1.9 → 0.2.0

package/dist/server.d.ts

@@ -0,0 +1,209 @@
+/**
+ * RelayPlane Agent Ops Proxy Server
+ *
+ * OpenAI-compatible proxy server with integrated observability via the Learning Ledger
+ * and auth enforcement via Auth Gate.
+ *
+ * Features:
+ * - 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';
+/**
+ * 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;
+    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 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;
+    /**
+     * 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;
+}
+/**
+ * Create a new proxy server
+ */
+export declare function createProxyServer(config?: ProxyServerConfig): ProxyServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

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