@relayplane/proxy 0.1.9 → 0.2.0

package/dist/index.d.mts

@@ -1,1141 +0,0 @@
-import * as http from 'node:http';
-import { z } from 'zod';
-
-/**
- * RelayPlane Core Types
- *
- * All TypeScript interfaces for the agent optimization layer.
- *
- * @packageDocumentation
- */
-
-/**
- * The 9 task types that RelayPlane can infer and route.
- */
-declare const TaskTypes: readonly ["code_generation", "code_review", "summarization", "analysis", "creative_writing", "data_extraction", "translation", "question_answering", "general"];
-type TaskType = (typeof TaskTypes)[number];
-/**
- * Zod schema for task types.
- */
-declare const TaskTypeSchema: z.ZodEnum<["code_generation", "code_review", "summarization", "analysis", "creative_writing", "data_extraction", "translation", "question_answering", "general"]>;
-/**
- * Supported AI providers.
- */
-declare const Providers: readonly ["openai", "anthropic", "google", "xai", "moonshot", "local"];
-type Provider = (typeof Providers)[number];
-/**
- * Zod schema for providers.
- */
-declare const ProviderSchema: z.ZodEnum<["openai", "anthropic", "google", "xai", "moonshot", "local"]>;
-/**
- * Provider-specific configuration.
- */
-interface ProviderConfig {
-    apiKey?: string;
-    baseUrl?: string;
-}
-/**
- * RelayPlane configuration.
- */
-interface RelayPlaneConfig {
-    /**
-     * Path to SQLite database file.
-     * @default "~/.relayplane/data.db"
-     */
-    dbPath?: string;
-    /**
-     * Provider configurations.
-     */
-    providers?: Partial<Record<Provider, ProviderConfig>>;
-    /**
-     * Default provider to use when routing cannot determine one.
-     * @default "local"
-     */
-    defaultProvider?: Provider;
-    /**
-     * Default model within the default provider.
-     * @default "llama3.2"
-     */
-    defaultModel?: string;
-}
-/**
- * Input for a RelayPlane run.
- */
-interface RunInput {
-    /**
-     * The prompt to send to the model.
-     */
-    prompt: string;
-    /**
-     * Optional system prompt.
-     */
-    systemPrompt?: string;
-    /**
-     * Override the inferred task type.
-     */
-    taskType?: TaskType;
-    /**
-     * Override the model selection (format: "provider:model").
-     */
-    model?: string;
-    /**
-     * Additional metadata to attach to the run.
-     */
-    metadata?: Record<string, unknown>;
-}
-/**
- * Result of a RelayPlane run.
- */
-interface RunResult {
-    /**
-     * Unique identifier for this run.
-     */
-    runId: string;
-    /**
-     * Whether the run completed successfully.
-     */
-    success: boolean;
-    /**
-     * The model's output (if successful).
-     */
-    output?: string;
-    /**
-     * Error message (if failed).
-     */
-    error?: string;
-    /**
-     * The inferred or specified task type.
-     */
-    taskType: TaskType;
-    /**
-     * The model used (format: "provider:model").
-     */
-    model: string;
-    /**
-     * Execution duration in milliseconds.
-     */
-    durationMs: number;
-    /**
-     * Input tokens used (if available).
-     */
-    tokensIn?: number;
-    /**
-     * Output tokens used (if available).
-     */
-    tokensOut?: number;
-    /**
-     * Timestamp of the run.
-     */
-    timestamp: string;
-}
-/**
- * Source of a routing rule.
- */
-declare const RuleSources: readonly ["default", "user", "learned"];
-type RuleSource = (typeof RuleSources)[number];
-/**
- * A routing rule that maps a task type to a preferred model.
- */
-interface RoutingRule {
-    /**
-     * Unique identifier for this rule.
-     */
-    id: string;
-    /**
-     * The task type this rule applies to.
-     */
-    taskType: TaskType;
-    /**
-     * The preferred model (format: "provider:model").
-     */
-    preferredModel: string;
-    /**
-     * How this rule was created.
-     */
-    source: RuleSource;
-    /**
-     * Confidence score (0-1) for learned rules.
-     */
-    confidence?: number;
-    /**
-     * Number of runs that informed this rule.
-     */
-    sampleCount?: number;
-    /**
-     * When the rule was created.
-     */
-    createdAt: string;
-    /**
-     * When the rule was last updated.
-     */
-    updatedAt: string;
-}
-/**
- * Outcome quality levels.
- */
-declare const OutcomeQualities: readonly ["excellent", "good", "acceptable", "poor", "failed"];
-type OutcomeQuality = (typeof OutcomeQualities)[number];
-/**
- * Input for recording an outcome.
- */
-interface OutcomeInput {
-    /**
-     * The run ID to record outcome for.
-     */
-    runId: string;
-    /**
-     * Whether the outcome was successful.
-     */
-    success: boolean;
-    /**
-     * Quality assessment.
-     */
-    quality?: OutcomeQuality;
-    /**
-     * Latency satisfaction (was the response fast enough?).
-     */
-    latencySatisfactory?: boolean;
-    /**
-     * Cost satisfaction (was the cost acceptable?).
-     */
-    costSatisfactory?: boolean;
-    /**
-     * Free-form feedback.
-     */
-    feedback?: string;
-}
-/**
- * A recorded outcome with full details.
- */
-interface Outcome extends OutcomeInput {
-    /**
-     * Unique identifier for this outcome.
-     */
-    id: string;
-    /**
-     * When the outcome was recorded.
-     */
-    recordedAt: string;
-}
-/**
- * Statistics for a specific task type.
- */
-interface TaskStats {
-    /**
-     * The task type.
-     */
-    taskType: TaskType;
-    /**
-     * Total number of runs.
-     */
-    totalRuns: number;
-    /**
-     * Number of successful runs.
-     */
-    successfulRuns: number;
-    /**
-     * Success rate (0-1).
-     */
-    successRate: number;
-    /**
-     * Average duration in milliseconds.
-     */
-    avgDurationMs: number;
-    /**
-     * Average input tokens.
-     */
-    avgTokensIn?: number;
-    /**
-     * Average output tokens.
-     */
-    avgTokensOut?: number;
-    /**
-     * Model breakdown.
-     */
-    byModel: Record<string, {
-        runs: number;
-        successRate: number;
-        avgDurationMs: number;
-    }>;
-}
-/**
- * Overall statistics.
- */
-interface Stats {
-    /**
-     * Total runs across all task types.
-     */
-    totalRuns: number;
-    /**
-     * Overall success rate.
-     */
-    overallSuccessRate: number;
-    /**
-     * Statistics by task type.
-     */
-    byTaskType: Record<TaskType, TaskStats>;
-    /**
-     * Time period covered.
-     */
-    period: {
-        from: string;
-        to: string;
-    };
-}
-/**
- * A suggestion for improving routing.
- */
-interface Suggestion {
-    /**
-     * Unique identifier for this suggestion.
-     */
-    id: string;
-    /**
-     * The task type this suggestion applies to.
-     */
-    taskType: TaskType;
-    /**
-     * Current model being used.
-     */
-    currentModel: string;
-    /**
-     * Suggested model to switch to.
-     */
-    suggestedModel: string;
-    /**
-     * Reason for the suggestion.
-     */
-    reason: string;
-    /**
-     * Confidence score (0-1).
-     */
-    confidence: number;
-    /**
-     * Expected improvement.
-     */
-    expectedImprovement: {
-        successRate?: number;
-        latency?: number;
-        cost?: number;
-    };
-    /**
-     * Number of data points this suggestion is based on.
-     */
-    sampleCount: number;
-    /**
-     * When the suggestion was generated.
-     */
-    createdAt: string;
-    /**
-     * Whether this suggestion has been accepted.
-     */
-    accepted?: boolean;
-    /**
-     * When the suggestion was accepted.
-     */
-    acceptedAt?: string;
-}
-/**
- * Run record as stored in the database.
- */
-interface RunRecord {
-    id: string;
-    prompt: string;
-    systemPrompt: string | null;
-    taskType: TaskType;
-    model: string;
-    success: boolean;
-    output: string | null;
-    error: string | null;
-    durationMs: number;
-    tokensIn: number | null;
-    tokensOut: number | null;
-    costUsd: number | null;
-    metadata: string | null;
-    createdAt: string;
-}
-/**
- * Outcome record as stored in the database.
- */
-interface OutcomeRecord {
-    id: string;
-    runId: string;
-    success: boolean;
-    quality: OutcomeQuality | null;
-    latencySatisfactory: boolean | null;
-    costSatisfactory: boolean | null;
-    feedback: string | null;
-    createdAt: string;
-}
-/**
- * Routing rule record as stored in the database.
- */
-interface RuleRecord {
-    id: string;
-    taskType: TaskType;
-    preferredModel: string;
-    source: RuleSource;
-    confidence: number | null;
-    sampleCount: number | null;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Suggestion record as stored in the database.
- */
-interface SuggestionRecord {
-    id: string;
-    taskType: TaskType;
-    currentModel: string;
-    suggestedModel: string;
-    reason: string;
-    confidence: number;
-    expectedImprovement: string;
-    sampleCount: number;
-    accepted: boolean | null;
-    createdAt: string;
-    acceptedAt: string | null;
-}
-
-/**
- * RelayPlane L2/L3 Proxy Server
- *
- * An OpenAI-compatible HTTP proxy that intelligently routes requests
- * to the optimal model using @relayplane/core.
- *
- * Supports:
- * - Streaming (SSE) for both OpenAI and Anthropic
- * - Non-streaming requests
- * - Automatic format conversion (Anthropic → OpenAI format)
- * - Tool/function calling (planned)
- *
- * @packageDocumentation
- */
-
-/**
- * Provider endpoint configuration
- */
-interface ProviderEndpoint {
-    baseUrl: string;
-    apiKeyEnv: string;
-}
-/**
- * Default provider endpoints
- */
-declare const DEFAULT_ENDPOINTS: Record<string, ProviderEndpoint>;
-/**
- * Model to provider/model mapping
- */
-declare const MODEL_MAPPING: Record<string, {
-    provider: Provider;
-    model: string;
-}>;
-/**
- * Proxy server configuration
- */
-interface ProxyConfig {
-    port?: number;
-    host?: string;
-    dbPath?: string;
-    verbose?: boolean;
-}
-/**
- * Start the RelayPlane proxy server
- */
-declare function startProxy(config?: ProxyConfig): Promise<http.Server>;
-
-/**
- * Task Type Inference
- *
- * Infers the task type from a prompt using pattern matching.
- * Designed for <5ms execution with no network calls.
- *
- * @packageDocumentation
- */
-
-/**
- * Infers the task type from a prompt.
- *
- * @param prompt - The user's prompt
- * @returns The inferred task type
- */
-declare function inferTaskType(prompt: string): TaskType;
-/**
- * Gets the confidence score for an inferred task type.
- *
- * @param prompt - The user's prompt
- * @param taskType - The task type to check confidence for
- * @returns Confidence score between 0 and 1
- */
-declare function getInferenceConfidence(prompt: string, taskType: TaskType): number;
-
-/**
- * SQLite Storage Implementation
- *
- * Provides persistent storage for runs, outcomes, routing rules, and suggestions.
- *
- * @packageDocumentation
- */
-
-/**
- * SQLite storage class for RelayPlane data.
- */
-declare class Store {
-    private db;
-    private readonly dbPath;
-    /**
-     * Creates a new Store instance.
-     *
-     * @param dbPath - Path to the SQLite database file. Defaults to ~/.relayplane/data.db
-     */
-    constructor(dbPath?: string);
-    /**
-     * Initializes the database schema.
-     */
-    private initializeSchema;
-    /**
-     * Closes the database connection.
-     */
-    close(): void;
-    /**
-     * Gets the database path.
-     */
-    getDbPath(): string;
-    /**
-     * Records a new run.
-     */
-    recordRun(run: Omit<RunRecord, 'id' | 'createdAt'>): string;
-    /**
-     * Gets a run by ID.
-     */
-    getRun(id: string): RunRecord | null;
-    /**
-     * Gets runs with optional filters.
-     */
-    getRuns(options?: {
-        taskType?: TaskType;
-        model?: string;
-        limit?: number;
-        offset?: number;
-        from?: string;
-        to?: string;
-    }): RunRecord[];
-    /**
-     * Counts runs with optional filters.
-     */
-    countRuns(options?: {
-        taskType?: TaskType;
-        model?: string;
-        from?: string;
-        to?: string;
-    }): number;
-    /**
-     * Records an outcome for a run.
-     */
-    recordOutcome(outcome: Omit<OutcomeRecord, 'id' | 'createdAt'>): string;
-    /**
-     * Gets an outcome for a run.
-     */
-    getOutcome(runId: string): OutcomeRecord | null;
-    /**
-     * Gets outcomes with optional filters.
-     */
-    getOutcomes(options?: {
-        taskType?: TaskType;
-        model?: string;
-        limit?: number;
-        from?: string;
-        to?: string;
-    }): Array<OutcomeRecord & {
-        taskType: TaskType;
-        model: string;
-    }>;
-    /**
-     * Gets a routing rule for a task type.
-     */
-    getRule(taskType: TaskType): RuleRecord | null;
-    /**
-     * Sets a routing rule for a task type.
-     */
-    setRule(taskType: TaskType, preferredModel: string, source: RuleSource, confidence?: number, sampleCount?: number): string;
-    /**
-     * Lists all routing rules.
-     */
-    listRules(): RuleRecord[];
-    /**
-     * Deletes a routing rule and resets to default.
-     */
-    deleteRule(taskType: TaskType): boolean;
-    /**
-     * Records a suggestion.
-     */
-    recordSuggestion(suggestion: Omit<SuggestionRecord, 'id' | 'createdAt' | 'acceptedAt'>): string;
-    /**
-     * Gets a suggestion by ID.
-     */
-    getSuggestion(id: string): SuggestionRecord | null;
-    /**
-     * Gets pending (unaccepted) suggestions.
-     */
-    getPendingSuggestions(): SuggestionRecord[];
-    /**
-     * Accepts a suggestion.
-     */
-    acceptSuggestion(id: string): boolean;
-    /**
-     * Rejects a suggestion.
-     */
-    rejectSuggestion(id: string): boolean;
-    /**
-     * Gets aggregated statistics.
-     */
-    getStats(options?: {
-        from?: string;
-        to?: string;
-    }): {
-        totalRuns: number;
-        successfulRuns: number;
-        avgDurationMs: number;
-        byTaskType: Record<string, {
-            runs: number;
-            successRate: number;
-            avgDurationMs: number;
-        }>;
-        byModel: Record<string, {
-            runs: number;
-            successRate: number;
-            avgDurationMs: number;
-        }>;
-    };
-    /**
-     * Gets statistics for learning (outcomes joined with runs).
-     */
-    getLearningStats(taskType: TaskType): Array<{
-        model: string;
-        runs: number;
-        successRate: number;
-        avgDurationMs: number;
-        outcomeSuccessRate: number;
-    }>;
-}
-
-/**
- * Routing Engine
- *
- * Manages routing rules and model selection for tasks.
- *
- * @packageDocumentation
- */
-
-/**
- * Routing engine for managing model selection.
- */
-declare class RoutingEngine {
-    private store;
-    /**
-     * Creates a new RoutingEngine.
-     *
-     * @param store - The storage instance to use
-     */
-    constructor(store: Store);
-    /**
-     * Infers the task type from a prompt.
-     *
-     * @param prompt - The prompt to analyze
-     * @returns The inferred task type
-     */
-    inferTaskType(prompt: string): TaskType;
-    /**
-     * Gets the inference confidence for a task type.
-     *
-     * @param prompt - The prompt to analyze
-     * @param taskType - The task type to check
-     * @returns Confidence score (0-1)
-     */
-    getInferenceConfidence(prompt: string, taskType: TaskType): number;
-    /**
-     * Gets the routing rule for a task type.
-     *
-     * @param taskType - The task type to get the rule for
-     * @returns The routing rule, or null if not found
-     */
-    get(taskType: TaskType): RoutingRule | null;
-    /**
-     * Sets a routing rule for a task type.
-     *
-     * @param taskType - The task type to set the rule for
-     * @param preferredModel - The preferred model (format: "provider:model")
-     * @param source - How the rule was created
-     * @param options - Optional confidence and sample count
-     * @returns The rule ID
-     */
-    set(taskType: TaskType, preferredModel: string, source?: RuleSource, options?: {
-        confidence?: number;
-        sampleCount?: number;
-    }): string;
-    /**
-     * Lists all routing rules.
-     *
-     * @returns Array of all routing rules
-     */
-    list(): RoutingRule[];
-    /**
-     * Deletes a routing rule and resets to default.
-     *
-     * @param taskType - The task type to reset
-     * @returns True if the rule was reset
-     */
-    delete(taskType: TaskType): boolean;
-    /**
-     * Gets the preferred model for a task type.
-     *
-     * @param taskType - The task type
-     * @returns The preferred model string, or a default
-     */
-    getPreferredModel(taskType: TaskType): string;
-    /**
-     * Parses a model string into provider and model name.
-     *
-     * @param modelString - The model string (format: "provider:model")
-     * @returns Object with provider and model
-     */
-    parseModel(modelString: string): {
-        provider: string;
-        model: string;
-    };
-    /**
-     * Resolves the model to use for a prompt.
-     *
-     * @param prompt - The prompt to analyze
-     * @param overrideTaskType - Optional task type override
-     * @param overrideModel - Optional model override
-     * @returns Object with resolved taskType, model, provider, and confidence
-     */
-    resolve(prompt: string, overrideTaskType?: TaskType, overrideModel?: string): {
-        taskType: TaskType;
-        model: string;
-        provider: string;
-        modelName: string;
-        confidence: number;
-    };
-}
-
-/**
- * Savings Calculator
- *
- * Calculates cost savings from intelligent model routing vs a baseline (all-Opus).
- *
- * @packageDocumentation
- */
-
-/**
- * Model pricing in USD per 1M tokens.
- */
-declare const MODEL_PRICING: Record<string, {
-    input: number;
-    output: number;
-}>;
-/**
- * Model cost breakdown.
- */
-interface ModelCostBreakdown {
-    runs: number;
-    tokensIn: number;
-    tokensOut: number;
-    cost: number;
-    successRate: number;
-    avgLatencyMs: number;
-}
-/**
- * Savings report structure.
- */
-interface SavingsReport {
-    /** Number of days included in the report */
-    periodDays: number;
-    /** Date range */
-    period: {
-        from: string;
-        to: string;
-    };
-    /** Total number of runs */
-    totalRuns: number;
-    /** Total tokens used */
-    totalTokensIn: number;
-    totalTokensOut: number;
-    /** Actual cost incurred */
-    actualCost: number;
-    /** Cost if all calls went to baseline model (Opus) */
-    baselineCost: number;
-    /** Total savings */
-    savings: number;
-    /** Savings as percentage */
-    savingsPercent: number;
-    /** Cost breakdown by model */
-    byModel: Record<string, ModelCostBreakdown>;
-    /** Cost breakdown by task type */
-    byTaskType: Record<string, {
-        runs: number;
-        cost: number;
-        avgCostPerRun: number;
-    }>;
-}
-/**
- * Calculate cost for a specific model and token counts.
- */
-declare function calculateCost(model: string, tokensIn: number, tokensOut: number): number;
-/**
- * Get pricing for a model.
- */
-declare function getModelPricing(model: string): {
-    input: number;
-    output: number;
-} | null;
-/**
- * Calculate savings report from stored runs.
- */
-declare function calculateSavings(store: Store, days?: number): SavingsReport;
-
-/**
- * RelayPlane Main Class
- *
- * The main entry point for the agent optimization layer.
- *
- * @packageDocumentation
- */
-
-/**
- * RelayPlane - Agent Optimization Layer
- *
- * Provides intelligent routing, outcome tracking, and learning for AI model selection.
- *
- * @example Basic usage
- * ```typescript
- * import { RelayPlane } from '@relayplane/core';
- *
- * const relay = new RelayPlane();
- *
- * // Run a task - automatically infers type and routes to best model
- * const result = await relay.run({
- *   prompt: 'Review this code for bugs...',
- * });
- *
- * // Record the outcome for learning
- * await relay.recordOutcome(result.runId, { success: true, quality: 'good' });
- *
- * // Get suggestions for routing improvements
- * const suggestions = await relay.getSuggestions();
- * ```
- */
-declare class RelayPlane {
-    private store;
-    private _routing;
-    private outcomeRecorder;
-    private patternDetector;
-    private config;
-    private adapterRegistry;
-    /**
-     * Creates a new RelayPlane instance.
-     *
-     * @param config - Configuration options
-     */
-    constructor(config?: RelayPlaneConfig);
-    /**
-     * Gets the routing engine for direct access.
-     */
-    get routing(): RoutingEngine;
-    /**
-     * Runs a prompt through the appropriate model.
-     *
-     * @param input - The run input
-     * @returns The run result
-     */
-    run(input: RunInput): Promise<RunResult>;
-    /**
-     * Gets an adapter for a provider.
-     * Note: In the standalone proxy package, adapters are not used.
-     * The proxy handles provider calls directly via HTTP.
-     */
-    private getAdapter;
-    /**
-     * Gets an API key from environment variables.
-     */
-    private getEnvApiKey;
-    /**
-     * Records an outcome for a run.
-     *
-     * @param runId - The run ID
-     * @param outcome - The outcome details
-     * @returns The recorded outcome
-     */
-    recordOutcome(runId: string, outcome: Omit<OutcomeInput, 'runId'>): Outcome;
-    /**
-     * Gets an outcome for a run.
-     *
-     * @param runId - The run ID
-     * @returns The outcome, or null if not found
-     */
-    getOutcome(runId: string): Outcome | null;
-    /**
-     * Gets statistics for runs.
-     *
-     * @param options - Optional filters
-     * @returns Statistics object
-     */
-    stats(options?: {
-        from?: string;
-        to?: string;
-    }): Stats;
-    /**
-     * Gets a savings report.
-     *
-     * @param days - Number of days to include (default: 30)
-     * @returns Savings report
-     */
-    savingsReport(days?: number): SavingsReport;
-    /**
-     * Gets routing improvement suggestions.
-     *
-     * @returns Array of suggestions
-     */
-    getSuggestions(): Suggestion[];
-    /**
-     * Generates new suggestions based on current data.
-     *
-     * @returns Array of newly generated suggestions
-     */
-    generateSuggestions(): Suggestion[];
-    /**
-     * Accepts a suggestion and updates routing.
-     *
-     * @param suggestionId - The suggestion ID to accept
-     * @returns True if successful
-     */
-    acceptSuggestion(suggestionId: string): boolean;
-    /**
-     * Rejects a suggestion.
-     *
-     * @param suggestionId - The suggestion ID to reject
-     * @returns True if successful
-     */
-    rejectSuggestion(suggestionId: string): boolean;
-    /**
-     * Closes the RelayPlane instance and releases resources.
-     */
-    close(): void;
-}
-
-/**
- * Pattern Detection
- *
- * Analyzes run history to detect patterns and generate suggestions.
- *
- * @packageDocumentation
- */
-
-/**
- * Pattern detection engine for learning from outcomes.
- */
-declare class PatternDetector {
-    private store;
-    /**
-     * Creates a new PatternDetector.
-     *
-     * @param store - The storage instance to use
-     */
-    constructor(store: Store);
-    /**
-     * Analyzes a task type and generates suggestions if appropriate.
-     *
-     * @param taskType - The task type to analyze
-     * @returns Array of suggestions
-     */
-    analyzeTaskType(taskType: TaskType): Suggestion[];
-    /**
-     * Analyzes all task types and generates suggestions.
-     *
-     * @returns Array of all suggestions across task types
-     */
-    analyzeAll(): Suggestion[];
-    /**
-     * Stores suggestions in the database.
-     *
-     * @param suggestions - The suggestions to store
-     * @returns Array of suggestion IDs
-     */
-    storeSuggestions(suggestions: Suggestion[]): string[];
-    /**
-     * Generates and stores new suggestions, returning only new ones.
-     *
-     * @returns Array of new suggestions
-     */
-    generateSuggestions(): Suggestion[];
-}
-
-/**
- * Outcome Recording
- *
- * Handles recording and processing of run outcomes.
- *
- * @packageDocumentation
- */
-
-/**
- * Outcome recorder for processing user feedback.
- */
-declare class OutcomeRecorder {
-    private store;
-    /**
-     * Creates a new OutcomeRecorder.
-     *
-     * @param store - The storage instance to use
-     */
-    constructor(store: Store);
-    /**
-     * Records an outcome for a run.
-     *
-     * @param input - The outcome input
-     * @returns The recorded outcome
-     * @throws If the run ID is not found
-     */
-    record(input: OutcomeInput): Outcome;
-    /**
-     * Gets an outcome for a run.
-     *
-     * @param runId - The run ID
-     * @returns The outcome, or null if not found
-     */
-    get(runId: string): Outcome | null;
-    /**
-     * Gets outcome statistics for a task type.
-     *
-     * @param taskType - The task type to get stats for
-     * @returns Outcome statistics
-     */
-    getTaskStats(taskType: string): {
-        totalOutcomes: number;
-        successRate: number;
-        qualityDistribution: Record<string, number>;
-        latencySatisfactionRate: number;
-        costSatisfactionRate: number;
-    };
-}
-
-/**
- * Configuration Management
- *
- * Handles loading, validation, and hot-reload of the config file.
- *
- * @packageDocumentation
- */
-
-/**
- * Strategy configuration for a task type
- */
-declare const StrategySchema: z.ZodObject<{
-    model: z.ZodString;
-    minConfidence: z.ZodOptional<z.ZodNumber>;
-    fallback: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    model: string;
-    minConfidence?: number | undefined;
-    fallback?: string | undefined;
-}, {
-    model: string;
-    minConfidence?: number | undefined;
-    fallback?: string | undefined;
-}>;
-/**
- * Full config schema
- */
-declare const ConfigSchema: z.ZodObject<{
-    strategies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
-        model: z.ZodString;
-        minConfidence: z.ZodOptional<z.ZodNumber>;
-        fallback: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        model: string;
-        minConfidence?: number | undefined;
-        fallback?: string | undefined;
-    }, {
-        model: string;
-        minConfidence?: number | undefined;
-        fallback?: string | undefined;
-    }>>>;
-    defaults: z.ZodOptional<z.ZodObject<{
-        qualityModel: z.ZodOptional<z.ZodString>;
-        costModel: z.ZodOptional<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        qualityModel?: string | undefined;
-        costModel?: string | undefined;
-    }, {
-        qualityModel?: string | undefined;
-        costModel?: string | undefined;
-    }>>;
-    auth: z.ZodOptional<z.ZodObject<{
-        anthropicApiKey: z.ZodOptional<z.ZodString>;
-        anthropicMaxToken: z.ZodOptional<z.ZodString>;
-        useMaxForModels: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    }, "strip", z.ZodTypeAny, {
-        anthropicApiKey?: string | undefined;
-        anthropicMaxToken?: string | undefined;
-        useMaxForModels?: string[] | undefined;
-    }, {
-        anthropicApiKey?: string | undefined;
-        anthropicMaxToken?: string | undefined;
-        useMaxForModels?: string[] | undefined;
-    }>>;
-}, "strip", z.ZodTypeAny, {
-    strategies?: Record<string, {
-        model: string;
-        minConfidence?: number | undefined;
-        fallback?: string | undefined;
-    }> | undefined;
-    defaults?: {
-        qualityModel?: string | undefined;
-        costModel?: string | undefined;
-    } | undefined;
-    auth?: {
-        anthropicApiKey?: string | undefined;
-        anthropicMaxToken?: string | undefined;
-        useMaxForModels?: string[] | undefined;
-    } | undefined;
-}, {
-    strategies?: Record<string, {
-        model: string;
-        minConfidence?: number | undefined;
-        fallback?: string | undefined;
-    }> | undefined;
-    defaults?: {
-        qualityModel?: string | undefined;
-        costModel?: string | undefined;
-    } | undefined;
-    auth?: {
-        anthropicApiKey?: string | undefined;
-        anthropicMaxToken?: string | undefined;
-        useMaxForModels?: string[] | undefined;
-    } | undefined;
-}>;
-type StrategyConfig = z.infer<typeof StrategySchema>;
-type Config = z.infer<typeof ConfigSchema>;
-/**
- * Default configuration
- */
-declare const DEFAULT_CONFIG: Config;
-/**
- * Get config file path
- */
-declare function getConfigPath(): string;
-/**
- * Load and validate config
- */
-declare function loadConfig(): Config;
-/**
- * Get strategy for a task type from config
- */
-declare function getStrategy(config: Config, taskType: TaskType): StrategyConfig | null;
-/**
- * Watch config file for changes
- */
-declare function watchConfig(onChange: (config: Config) => void): void;
-
-export { type Config, DEFAULT_CONFIG, DEFAULT_ENDPOINTS, MODEL_MAPPING, MODEL_PRICING, type ModelCostBreakdown, type Outcome, type OutcomeQuality, OutcomeRecorder, PatternDetector, type Provider, type ProviderEndpoint, ProviderSchema, Providers, type ProxyConfig, RelayPlane, type RelayPlaneConfig, RoutingEngine, type RoutingRule, type RuleSource, type RunRecord, type SavingsReport, Store, type StrategyConfig, type Suggestion, type TaskType, TaskTypeSchema, TaskTypes, calculateCost, calculateSavings, getConfigPath, getInferenceConfidence, getModelPricing, getStrategy, inferTaskType, loadConfig, startProxy, watchConfig };