dpth 0.3.0 → 0.4.0

package/dist/experimental/fallback.js

@@ -0,0 +1,359 @@
+/**
+ * dpth.io Centralized Inference Fallback
+ *
+ * When no agents are available to serve a model, routes to centralized
+ * API providers (OpenAI, Anthropic, etc.) as a fallback.
+ *
+ * Priority:
+ * 1. Distributed network (free, agent-served)
+ * 2. Centralized fallback (costs money, but always available)
+ *
+ * The fallback is transparent to clients — same API, same format.
+ */
+// ─── Provider Registry ───────────────────────────────
+const PROVIDERS = [
+    {
+        id: 'openai',
+        name: 'OpenAI',
+        baseUrl: 'https://api.openai.com/v1',
+        apiKeyEnv: 'OPENAI_API_KEY',
+        configured: false,
+        models: [
+            { pattern: 'gpt-4o', providerModel: 'gpt-4o', inputCostPer1M: 2.5, outputCostPer1M: 10 },
+            { pattern: 'gpt-4o-mini', providerModel: 'gpt-4o-mini', inputCostPer1M: 0.15, outputCostPer1M: 0.6 },
+            { pattern: 'gpt-4-turbo', providerModel: 'gpt-4-turbo', inputCostPer1M: 10, outputCostPer1M: 30 },
+            { pattern: 'o1', providerModel: 'o1', inputCostPer1M: 15, outputCostPer1M: 60 },
+            { pattern: 'o3-mini', providerModel: 'o3-mini', inputCostPer1M: 1.1, outputCostPer1M: 4.4 },
+        ],
+    },
+    {
+        id: 'anthropic',
+        name: 'Anthropic',
+        baseUrl: 'https://api.anthropic.com/v1',
+        apiKeyEnv: 'ANTHROPIC_API_KEY',
+        configured: false,
+        headers: { 'anthropic-version': '2023-06-01' },
+        models: [
+            { pattern: 'claude-.*sonnet', providerModel: 'claude-sonnet-4-20250514', inputCostPer1M: 3, outputCostPer1M: 15 },
+            { pattern: 'claude-.*haiku', providerModel: 'claude-3-5-haiku-20241022', inputCostPer1M: 0.8, outputCostPer1M: 4 },
+            { pattern: 'claude-.*opus', providerModel: 'claude-3-opus-20240229', inputCostPer1M: 15, outputCostPer1M: 75 },
+        ],
+    },
+    {
+        id: 'groq',
+        name: 'Groq',
+        baseUrl: 'https://api.groq.com/openai/v1',
+        apiKeyEnv: 'GROQ_API_KEY',
+        configured: false,
+        models: [
+            { pattern: 'llama-3\\.3-70b', providerModel: 'llama-3.3-70b-versatile', inputCostPer1M: 0.59, outputCostPer1M: 0.79 },
+            { pattern: 'llama-3\\.1-8b', providerModel: 'llama-3.1-8b-instant', inputCostPer1M: 0.05, outputCostPer1M: 0.08 },
+            { pattern: 'mixtral', providerModel: 'mixtral-8x7b-32768', inputCostPer1M: 0.24, outputCostPer1M: 0.24 },
+            { pattern: 'gemma-2-9b', providerModel: 'gemma2-9b-it', inputCostPer1M: 0.2, outputCostPer1M: 0.2 },
+        ],
+    },
+    {
+        id: 'together',
+        name: 'Together AI',
+        baseUrl: 'https://api.together.xyz/v1',
+        apiKeyEnv: 'TOGETHER_API_KEY',
+        configured: false,
+        models: [
+            { pattern: 'llama-3\\.3-70b', providerModel: 'meta-llama/Llama-3.3-70B-Instruct-Turbo', inputCostPer1M: 0.88, outputCostPer1M: 0.88 },
+            { pattern: 'qwen-2\\.5.*72b', providerModel: 'Qwen/Qwen2.5-72B-Instruct-Turbo', inputCostPer1M: 1.2, outputCostPer1M: 1.2 },
+            { pattern: 'deepseek-v3', providerModel: 'deepseek-ai/DeepSeek-V3', inputCostPer1M: 0.9, outputCostPer1M: 0.9 },
+            { pattern: 'qwen-2\\.5-coder-32b', providerModel: 'Qwen/Qwen2.5-Coder-32B-Instruct', inputCostPer1M: 0.8, outputCostPer1M: 0.8 },
+        ],
+    },
+];
+// ─── Core Functions ──────────────────────────────────
+/**
+ * Check which fallback providers are configured (have API keys)
+ */
+export function getConfiguredProviders() {
+    return PROVIDERS.map(p => ({
+        ...p,
+        configured: !!process.env[p.apiKeyEnv],
+    })).filter(p => p.configured);
+}
+/**
+ * Find the best fallback provider for a model
+ */
+export function findFallbackProvider(modelId) {
+    const configured = getConfiguredProviders();
+    for (const provider of configured) {
+        for (const mapping of provider.models) {
+            const regex = new RegExp(mapping.pattern, 'i');
+            if (regex.test(modelId)) {
+                return {
+                    provider,
+                    providerModel: mapping.providerModel,
+                    cost: {
+                        inputCostPer1M: mapping.inputCostPer1M || 0,
+                        outputCostPer1M: mapping.outputCostPer1M || 0,
+                    },
+                };
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Execute a fallback inference request (non-streaming)
+ */
+export async function fallbackInference(request) {
+    const match = findFallbackProvider(request.modelId);
+    if (!match) {
+        throw new Error(`No fallback provider available for model: ${request.modelId}`);
+    }
+    const { provider, providerModel, cost } = match;
+    const apiKey = process.env[provider.apiKeyEnv];
+    const startTime = Date.now();
+    // Build request based on provider
+    if (provider.id === 'anthropic') {
+        return executeAnthropicRequest(provider, apiKey, providerModel, request, cost, startTime);
+    }
+    // OpenAI-compatible providers (OpenAI, Groq, Together)
+    return executeOpenAIRequest(provider, apiKey, providerModel, request, cost, startTime);
+}
+/**
+ * Execute a streaming fallback inference request
+ * Returns an async generator of text chunks
+ */
+export async function* fallbackInferenceStream(request) {
+    const match = findFallbackProvider(request.modelId);
+    if (!match) {
+        throw new Error(`No fallback provider available for model: ${request.modelId}`);
+    }
+    const { provider, providerModel } = match;
+    const apiKey = process.env[provider.apiKeyEnv];
+    if (provider.id === 'anthropic') {
+        yield* streamAnthropicRequest(provider, apiKey, providerModel, request);
+    }
+    else {
+        yield* streamOpenAIRequest(provider, apiKey, providerModel, request);
+    }
+}
+// ─── Provider Implementations ────────────────────────
+async function executeOpenAIRequest(provider, apiKey, model, request, cost, startTime) {
+    const messages = request.messages || [
+        ...(request.system ? [{ role: 'system', content: request.system }] : []),
+        { role: 'user', content: request.prompt || '' },
+    ];
+    const response = await fetch(`${provider.baseUrl}/chat/completions`, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+            ...(provider.headers || {}),
+        },
+        body: JSON.stringify({
+            model,
+            messages,
+            max_tokens: request.maxTokens || 4096,
+            temperature: request.temperature ?? 0.7,
+            top_p: request.topP,
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`${provider.name} API error (${response.status}): ${error}`);
+    }
+    const data = await response.json();
+    const latencyMs = Date.now() - startTime;
+    const text = data.choices?.[0]?.message?.content || '';
+    const inputTokens = data.usage?.prompt_tokens || 0;
+    const outputTokens = data.usage?.completion_tokens || 0;
+    return {
+        text,
+        tokensGenerated: outputTokens,
+        tokensPerSecond: outputTokens / (latencyMs / 1000),
+        latencyMs,
+        provider: provider.id,
+        providerModel: model,
+        cost: {
+            inputTokens,
+            outputTokens,
+            totalUsd: (inputTokens * cost.inputCostPer1M + outputTokens * cost.outputCostPer1M) / 1_000_000,
+        },
+    };
+}
+async function executeAnthropicRequest(provider, apiKey, model, request, cost, startTime) {
+    const messages = request.messages?.filter(m => m.role !== 'system') || [
+        { role: 'user', content: request.prompt || '' },
+    ];
+    const system = request.system || request.messages?.find(m => m.role === 'system')?.content;
+    const response = await fetch(`${provider.baseUrl}/messages`, {
+        method: 'POST',
+        headers: {
+            'x-api-key': apiKey,
+            'Content-Type': 'application/json',
+            ...(provider.headers || {}),
+        },
+        body: JSON.stringify({
+            model,
+            messages,
+            system,
+            max_tokens: request.maxTokens || 4096,
+            temperature: request.temperature ?? 0.7,
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`${provider.name} API error (${response.status}): ${error}`);
+    }
+    const data = await response.json();
+    const latencyMs = Date.now() - startTime;
+    const text = data.content?.map((c) => c.text).join('') || '';
+    const inputTokens = data.usage?.input_tokens || 0;
+    const outputTokens = data.usage?.output_tokens || 0;
+    return {
+        text,
+        tokensGenerated: outputTokens,
+        tokensPerSecond: outputTokens / (latencyMs / 1000),
+        latencyMs,
+        provider: provider.id,
+        providerModel: model,
+        cost: {
+            inputTokens,
+            outputTokens,
+            totalUsd: (inputTokens * cost.inputCostPer1M + outputTokens * cost.outputCostPer1M) / 1_000_000,
+        },
+    };
+}
+async function* streamOpenAIRequest(provider, apiKey, model, request) {
+    const messages = request.messages || [
+        ...(request.system ? [{ role: 'system', content: request.system }] : []),
+        { role: 'user', content: request.prompt || '' },
+    ];
+    const response = await fetch(`${provider.baseUrl}/chat/completions`, {
+        method: 'POST',
+        headers: {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+            ...(provider.headers || {}),
+        },
+        body: JSON.stringify({
+            model,
+            messages,
+            max_tokens: request.maxTokens || 4096,
+            temperature: request.temperature ?? 0.7,
+            stream: true,
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`${provider.name} streaming error (${response.status}): ${error}`);
+    }
+    const reader = response.body?.getReader();
+    if (!reader)
+        throw new Error('No response body');
+    const decoder = new TextDecoder();
+    let buffer = '';
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || '';
+        for (const line of lines) {
+            if (!line.startsWith('data: '))
+                continue;
+            const data = line.slice(6).trim();
+            if (data === '[DONE]') {
+                yield { text: '', done: true };
+                return;
+            }
+            try {
+                const parsed = JSON.parse(data);
+                const text = parsed.choices?.[0]?.delta?.content || '';
+                if (text) {
+                    yield { text, done: false };
+                }
+            }
+            catch {
+                // Skip malformed chunks
+            }
+        }
+    }
+    yield { text: '', done: true };
+}
+async function* streamAnthropicRequest(provider, apiKey, model, request) {
+    const messages = request.messages?.filter(m => m.role !== 'system') || [
+        { role: 'user', content: request.prompt || '' },
+    ];
+    const system = request.system || request.messages?.find(m => m.role === 'system')?.content;
+    const response = await fetch(`${provider.baseUrl}/messages`, {
+        method: 'POST',
+        headers: {
+            'x-api-key': apiKey,
+            'Content-Type': 'application/json',
+            ...(provider.headers || {}),
+        },
+        body: JSON.stringify({
+            model,
+            messages,
+            system,
+            max_tokens: request.maxTokens || 4096,
+            temperature: request.temperature ?? 0.7,
+            stream: true,
+        }),
+    });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`${provider.name} streaming error (${response.status}): ${error}`);
+    }
+    const reader = response.body?.getReader();
+    if (!reader)
+        throw new Error('No response body');
+    const decoder = new TextDecoder();
+    let buffer = '';
+    while (true) {
+        const { done, value } = await reader.read();
+        if (done)
+            break;
+        buffer += decoder.decode(value, { stream: true });
+        const lines = buffer.split('\n');
+        buffer = lines.pop() || '';
+        for (const line of lines) {
+            if (!line.startsWith('data: '))
+                continue;
+            const data = line.slice(6).trim();
+            try {
+                const parsed = JSON.parse(data);
+                if (parsed.type === 'content_block_delta') {
+                    const text = parsed.delta?.text || '';
+                    if (text) {
+                        yield { text, done: false };
+                    }
+                }
+                if (parsed.type === 'message_stop') {
+                    yield { text: '', done: true };
+                    return;
+                }
+            }
+            catch {
+                // Skip malformed chunks
+            }
+        }
+    }
+    yield { text: '', done: true };
+}
+// ─── Status ──────────────────────────────────────────
+/**
+ * Get fallback status — which providers are available
+ */
+export function getFallbackStatus() {
+    const providers = PROVIDERS.map(p => ({
+        id: p.id,
+        name: p.name,
+        configured: !!process.env[p.apiKeyEnv],
+        modelCount: p.models.length,
+    }));
+    return {
+        available: providers.some(p => p.configured),
+        providers,
+    };
+}
+//# sourceMappingURL=fallback.js.map

package/dist/experimental/fallback.js.map

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

package/dist/experimental/federation.d.ts

@@ -0,0 +1,224 @@
+/**
+ * dpth.io Federated Learning Coordinator
+ *
+ * Network-trained models as public goods. Agents fine-tune locally,
+ * share only weight deltas (LoRA adapters), and the network aggregates
+ * them into models that couldn't exist outside dpth.io.
+ *
+ * How it works:
+ * 1. Coordinator publishes a training round with base model CID
+ * 2. Eligible agents (trusted tier+) claim the round
+ * 3. Each agent fine-tunes on local data, uploads weight delta
+ * 4. Coordinator aggregates deltas (federated averaging)
+ * 5. New model version published to network via CAS
+ * 6. Agents earn credits for training contributions
+ *
+ * Security:
+ * - Only trusted+ agents can participate (reputation gate)
+ * - Weight deltas are validated (norm clipping, anomaly detection)
+ * - Differential privacy noise added before aggregation
+ * - Byzantine-tolerant: median aggregation, not mean
+ */
+export type TrainingStatus = 'pending' | 'active' | 'aggregating' | 'complete' | 'failed';
+export type ParticipantStatus = 'claimed' | 'training' | 'uploaded' | 'validated' | 'rejected';
+export interface ModelVersion {
+    id: string;
+    modelFamily: string;
+    version: number;
+    /** CID of the base model weights */
+    baseModelCid: string;
+    /** CID of the aggregated LoRA adapter (null for base) */
+    adapterCid: string | null;
+    /** Training rounds that produced this version */
+    trainingRoundIds: string[];
+    /** Performance metrics */
+    metrics: ModelMetrics;
+    /** When this version was created */
+    createdAt: string;
+    /** Parent version (null for initial) */
+    parentVersionId: string | null;
+}
+export interface ModelMetrics {
+    /** Loss on validation set */
+    validationLoss?: number;
+    /** Task-specific accuracy */
+    taskAccuracy?: Record<string, number>;
+    /** Number of training examples across all participants */
+    totalTrainingExamples: number;
+    /** Number of participants who contributed */
+    participantCount: number;
+    /** Improvement over parent version (percentage) */
+    improvementOverParent?: number;
+}
+export interface TrainingRound {
+    id: string;
+    /** Which model family (e.g., 'dpth-entity-8b', 'dpth-anomaly-3b') */
+    modelFamily: string;
+    /** Current model version being improved */
+    baseVersionId: string;
+    /** CID of training config (hyperparameters, dataset spec) */
+    configCid: string;
+    status: TrainingStatus;
+    /** Training configuration */
+    config: TrainingConfig;
+    /** Participating agents */
+    participants: TrainingParticipant[];
+    /** Minimum participants needed to aggregate */
+    minParticipants: number;
+    /** Maximum participants (prevent over-contribution) */
+    maxParticipants: number;
+    /** Deadline for submissions */
+    deadline: string;
+    /** Resulting model version (after aggregation) */
+    resultVersionId?: string;
+    /** Aggregation stats */
+    aggregationStats?: AggregationStats;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TrainingConfig {
+    /** Learning rate */
+    learningRate: number;
+    /** Epochs per participant */
+    localEpochs: number;
+    /** Batch size */
+    batchSize: number;
+    /** LoRA rank */
+    loraRank: number;
+    /** LoRA alpha */
+    loraAlpha: number;
+    /** Target modules for LoRA */
+    targetModules: string[];
+    /** Max gradient norm for clipping */
+    maxGradNorm: number;
+    /** Differential privacy epsilon (lower = more private) */
+    dpEpsilon?: number;
+    /** Task types to train on */
+    taskTypes: string[];
+    /** Minimum local examples required to participate */
+    minLocalExamples: number;
+}
+export interface TrainingParticipant {
+    agentId: string;
+    status: ParticipantStatus;
+    claimedAt: string;
+    /** CID of uploaded weight delta */
+    deltaCid?: string;
+    uploadedAt?: string;
+    /** Local training stats */
+    localStats?: {
+        examples: number;
+        epochs: number;
+        finalLoss: number;
+        trainingTimeMs: number;
+        gpuModel?: string;
+        vramUsedMb?: number;
+    };
+    /** Validation result from coordinator */
+    validation?: {
+        valid: boolean;
+        deltaL2Norm: number;
+        anomalyScore: number;
+        reason?: string;
+    };
+}
+export interface AggregationStats {
+    method: 'fedavg' | 'fedmedian' | 'trimmed_mean';
+    participantsUsed: number;
+    participantsRejected: number;
+    /** Aggregate delta L2 norm */
+    aggregateDeltaNorm: number;
+    /** Total training examples across all participants */
+    totalExamples: number;
+    /** Time to aggregate */
+    aggregationTimeMs: number;
+    /** Differential privacy noise added */
+    dpNoiseScale?: number;
+}
+export interface WeightDelta {
+    /** CID of this delta */
+    cid: string;
+    /** Agent who produced it */
+    agentId: string;
+    /** Training round it belongs to */
+    roundId: string;
+    /** LoRA adapter format info */
+    format: {
+        rank: number;
+        alpha: number;
+        targetModules: string[];
+        dtype: 'float16' | 'float32' | 'bfloat16';
+    };
+    /** Size in bytes */
+    sizeBytes: number;
+    /** L2 norm of the delta (for anomaly detection) */
+    l2Norm: number;
+    /** Number of local examples used */
+    trainingExamples: number;
+}
+/**
+ * Register an initial base model version.
+ */
+export declare function registerBaseModel(modelFamily: string, baseModelCid: string, metrics?: Partial<ModelMetrics>): ModelVersion;
+/**
+ * Get the latest version of a model family.
+ */
+export declare function getLatestVersion(modelFamily: string): ModelVersion | undefined;
+/**
+ * Get full version history for a model family.
+ */
+export declare function getVersionHistory(modelFamily: string): ModelVersion[];
+/**
+ * Create a new training round for a model family.
+ */
+export declare function createTrainingRound(modelFamily: string, config: TrainingConfig, options?: {
+    minParticipants?: number;
+    maxParticipants?: number;
+    deadlineHours?: number;
+    configCid?: string;
+}): TrainingRound;
+/**
+ * Agent claims a training round.
+ */
+export declare function claimTrainingRound(roundId: string, agentId: string): TrainingParticipant;
+/**
+ * Agent uploads a weight delta for a training round.
+ */
+export declare function submitWeightDelta(roundId: string, agentId: string, delta: Omit<WeightDelta, 'roundId' | 'agentId'>): WeightDelta;
+/**
+ * Aggregate weight deltas from a training round into a new model version.
+ * Uses federated median (Byzantine-tolerant) by default.
+ */
+export declare function aggregateRound(roundId: string, method?: 'fedavg' | 'fedmedian' | 'trimmed_mean'): ModelVersion;
+export declare function getTrainingRound(roundId: string): TrainingRound | undefined;
+export declare function getModelVersion(versionId: string): ModelVersion | undefined;
+/**
+ * Get active training rounds an agent can join.
+ */
+export declare function getAvailableRounds(agentId?: string): TrainingRound[];
+/**
+ * Get all rounds an agent has participated in.
+ */
+export declare function getAgentTrainingHistory(agentId: string): TrainingRound[];
+/**
+ * Get network-wide training stats.
+ */
+export declare function getTrainingStats(): {
+    totalRounds: number;
+    completedRounds: number;
+    activeRounds: number;
+    totalParticipations: number;
+    totalExamplesProcessed: number;
+    modelFamilies: string[];
+};
+/**
+ * List all registered model families with their latest versions.
+ */
+export declare function listModelFamilies(): Array<{
+    family: string;
+    latestVersion: number;
+    latestVersionId: string;
+    totalRounds: number;
+}>;
+export declare function clearFederation(): void;
+//# sourceMappingURL=federation.d.ts.map

package/dist/experimental/federation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federation.d.ts","sourceRoot":"","sources":["../../src/experimental/federation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAMH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,UAAU,GAAG,QAAQ,CAAC;AAC1F,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;AAE/F,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,yDAAyD;IACzD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,iDAAiD;IACjD,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,0BAA0B;IAC1B,OAAO,EAAE,YAAY,CAAC;IACtB,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,YAAY;IAC3B,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6BAA6B;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,0DAA0D;IAC1D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,gBAAgB,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,qEAAqE;IACrE,WAAW,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,cAAc,CAAC;IACvB,6BAA6B;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,2BAA2B;IAC3B,YAAY,EAAE,mBAAmB,EAAE,CAAC;IACpC,+CAA+C;IAC/C,eAAe,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,eAAe,EAAE,MAAM,CAAC;IACxB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2BAA2B;IAC3B,UAAU,CAAC,EAAE;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,yCAAyC;IACzC,UAAU,CAAC,EAAE;QACX,KAAK,EAAE,OAAO,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,cAAc,CAAC;IAChD,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,8BAA8B;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,wBAAwB;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,wBAAwB;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,4BAA4B;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,EAAE,CAAC;QACxB,KAAK,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;KAC3C,CAAC;IACF,oBAAoB;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAwBD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAC9B,YAAY,CAoBd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAG9E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAIrE;AAID;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE;IACR,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,aAAa,CA0Bf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,mBAAmB,CAoCxF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,SAAS,CAAC,GAC9C,WAAW,CA2Cb;AAmDD;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,QAAQ,GAAG,WAAW,GAAG,cAA4B,GAC5D,YAAY,CAqGd;AAID,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE3E;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE3E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CASpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAKxE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB,CAcA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,KAAK,CAAC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC,CAUD;AAID,wBAAgB,eAAe,IAAI,IAAI,CAMtC"}