@kernel.chat/kbot 2.13.1 → 2.14.1

package/dist/error-correction.js

@@ -0,0 +1,174 @@
+// Error-Correcting Code patterns — inspired by James Gates' discovery of
+// error-correcting codes in string theory. Classifies errors by type and
+// applies targeted corrections instead of blind retry.
+import { loadConfig } from './auth.js';
+export var ErrorType;
+(function (ErrorType) {
+    ErrorType["hallucination"] = "hallucination";
+    ErrorType["wrong_tool"] = "wrong_tool";
+    ErrorType["stale_context"] = "stale_context";
+    ErrorType["incomplete"] = "incomplete";
+    ErrorType["off_topic"] = "off_topic";
+    ErrorType["syntax_error"] = "syntax_error";
+    ErrorType["logic_error"] = "logic_error";
+})(ErrorType || (ErrorType = {}));
+export const CORRECTION_STRATEGIES = {
+    [ErrorType.hallucination]: {
+        errorType: ErrorType.hallucination,
+        description: 'Response contains unsupported claims',
+        correctionPrompt: 'Your previous response contained claims not supported by the provided context. Stick strictly to what\'s in the conversation and tool results. Do not invent facts, file paths, function names, or behaviors.',
+        severity: 4,
+    },
+    [ErrorType.wrong_tool]: {
+        errorType: ErrorType.wrong_tool,
+        description: 'Incorrect tool selection',
+        correctionPrompt: 'You used an incorrect tool for this task. Reconsider which tool best fits the user\'s request. Re-read the available tools and their descriptions before choosing.',
+        severity: 3,
+    },
+    [ErrorType.stale_context]: {
+        errorType: ErrorType.stale_context,
+        description: 'Referenced outdated information',
+        correctionPrompt: 'Your response referenced outdated information. Focus on the most recent context and tool results. Earlier conversation turns may contain stale state — prioritize the latest data.',
+        severity: 3,
+    },
+    [ErrorType.incomplete]: {
+        errorType: ErrorType.incomplete,
+        description: 'Response did not address all parts',
+        correctionPrompt: 'Your response was incomplete. Address all parts of the user\'s request. Re-read the original message and ensure every question or requirement is covered.',
+        severity: 2,
+    },
+    [ErrorType.off_topic]: {
+        errorType: ErrorType.off_topic,
+        description: 'Response diverged from the question',
+        correctionPrompt: 'Your response diverged from the user\'s question. Re-read the original request and answer directly. Do not add tangential information.',
+        severity: 2,
+    },
+    [ErrorType.syntax_error]: {
+        errorType: ErrorType.syntax_error,
+        description: 'Code output has syntax errors',
+        correctionPrompt: 'Your code output contained syntax errors. Fix the syntax and verify it compiles. Check for missing brackets, semicolons, type annotations, and import statements.',
+        severity: 5,
+    },
+    [ErrorType.logic_error]: {
+        errorType: ErrorType.logic_error,
+        description: 'Code has logical flaws',
+        correctionPrompt: 'Your code has a logical error. Trace through the logic step by step. Check edge cases, off-by-one errors, null handling, and conditional branches.',
+        severity: 4,
+    },
+};
+const CLASSIFY_PROMPT = `You are an error classifier for an AI agent's output. Analyze the response and classify any errors found.
+
+USER QUERY:
+{query}
+
+AGENT RESPONSE:
+{response}
+
+{context_section}
+
+Classify the primary error (if any). Respond in JSON:
+{"errorType": "hallucination|wrong_tool|stale_context|incomplete|off_topic|syntax_error|logic_error|none", "confidence": 0.0-1.0, "evidence": "brief explanation"}
+
+If no error found, use errorType "none" with confidence 1.0.
+Respond ONLY with the JSON object.`;
+export async function classifyError(query, response, context) {
+    const config = loadConfig();
+    if (!config)
+        return null;
+    const contextSection = context
+        ? `CONTEXT PROVIDED:\n${context.slice(0, 2000)}`
+        : '';
+    const prompt = CLASSIFY_PROMPT
+        .replace('{query}', query)
+        .replace('{response}', response.slice(0, 3000))
+        .replace('{context_section}', contextSection);
+    try {
+        const text = await callFastModel(config, prompt);
+        const match = text.match(/\{[\s\S]*\}/);
+        if (!match)
+            return null;
+        const parsed = JSON.parse(match[0]);
+        if (parsed.errorType === 'none')
+            return null;
+        const errorType = parsed.errorType;
+        if (!Object.values(ErrorType).includes(errorType))
+            return null;
+        return {
+            errorType,
+            confidence: Math.max(0, Math.min(1, parsed.confidence || 0)),
+            evidence: parsed.evidence || '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+export function applyCorrection(query, response, errorType, evidence) {
+    const strategy = CORRECTION_STRATEGIES[errorType];
+    return [
+        `[ERROR CORRECTION — ${strategy.description}]`,
+        strategy.correctionPrompt,
+        `Evidence of error: ${evidence}`,
+        `Original query: ${query}`,
+        'Please provide a corrected response.',
+    ].join('\n');
+}
+export async function withErrorCorrection(generateFn, query, context, maxRetries = 2) {
+    const corrections = [];
+    let response = await generateFn();
+    let retries = 0;
+    for (let attempt = 0; attempt < maxRetries; attempt++) {
+        const classification = await classifyError(query, response, context);
+        if (!classification || classification.confidence < 0.7)
+            break;
+        const correctionPrompt = applyCorrection(query, response, classification.errorType, classification.evidence);
+        corrections.push({
+            errorType: classification.errorType,
+            confidence: classification.confidence,
+            evidence: classification.evidence,
+            correctionApplied: CORRECTION_STRATEGIES[classification.errorType].description,
+            attempt: attempt + 1,
+        });
+        response = await generateFn(correctionPrompt);
+        retries++;
+    }
+    return { response, corrections, retries };
+}
+// ── Multi-provider fast model call ──────────────────────────────────
+async function callFastModel(config, prompt) {
+    const provider = config.provider || 'anthropic';
+    const key = config.apiKey || config.key;
+    if (provider === 'anthropic' || provider === 'claude') {
+        const res = await fetch('https://api.anthropic.com/v1/messages', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': key,
+                'anthropic-version': '2023-06-01',
+            },
+            body: JSON.stringify({
+                model: 'claude-haiku-4-5-20251001',
+                max_tokens: 256,
+                messages: [{ role: 'user', content: prompt }],
+            }),
+        });
+        const data = await res.json();
+        return data?.content?.[0]?.text || '';
+    }
+    if (provider === 'openai') {
+        const res = await fetch('https://api.openai.com/v1/chat/completions', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${key}` },
+            body: JSON.stringify({
+                model: 'gpt-4o-mini',
+                max_tokens: 256,
+                messages: [{ role: 'user', content: prompt }],
+            }),
+        });
+        const data = await res.json();
+        return data?.choices?.[0]?.message?.content || '';
+    }
+    // Fallback: skip classification for unsupported providers
+    return '';
+}
+//# sourceMappingURL=error-correction.js.map

package/dist/error-correction.js.map

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

package/dist/godel-limits.d.ts

@@ -0,0 +1,46 @@
+export declare enum LoopPattern {
+    tool_repetition = "tool_repetition",
+    output_oscillation = "output_oscillation",
+    cost_spiral = "cost_spiral",
+    context_exhaustion = "context_exhaustion",
+    semantic_stagnation = "semantic_stagnation",
+    circular_reasoning = "circular_reasoning"
+}
+export interface DecidabilityScore {
+    decidable: boolean;
+    confidence: number;
+    pattern?: LoopPattern;
+    evidence: string;
+    recommendation: 'continue' | 'simplify' | 'handoff' | 'decompose';
+    tokensBurned: number;
+    costBurned: number;
+}
+interface Options {
+    maxToolRepeats: number;
+    maxCostUsd: number;
+    maxTokens: number;
+    similarityThreshold: number;
+}
+export declare function jaccardSimilarity(a: string, b: string): number;
+export declare function detectOscillation(outputs: string[]): boolean;
+export declare class LoopDetector {
+    private toolHistory;
+    private outputs;
+    private totalCost;
+    private costHistory;
+    private totalTokens;
+    private opts;
+    constructor(options?: Partial<Options>);
+    recordToolCall(toolName: string, args: string, result: string): void;
+    recordOutput(output: string): void;
+    recordCost(costUsd: number): void;
+    recordTokens(tokens: number): void;
+    check(): DecidabilityScore;
+    reset(): void;
+    private checkToolRepetition;
+    private checkCostSpiral;
+    private checkSemanticStagnation;
+    private checkCircularReasoning;
+}
+export {};
+//# sourceMappingURL=godel-limits.d.ts.map

package/dist/godel-limits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"godel-limits.d.ts","sourceRoot":"","sources":["../src/godel-limits.ts"],"names":[],"mappings":"AAIA,oBAAY,WAAW;IACrB,eAAe,oBAAoB;IACnC,kBAAkB,uBAAuB;IACzC,WAAW,gBAAgB;IAC3B,kBAAkB,uBAAuB;IACzC,mBAAmB,wBAAwB;IAC3C,kBAAkB,uBAAuB;CAC1C;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAA;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,CAAA;IACjE,YAAY,EAAE,MAAM,CAAA;IACpB,UAAU,EAAE,MAAM,CAAA;CACnB;AASD,UAAU,OAAO;IACf,cAAc,EAAE,MAAM,CAAA;IACtB,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,mBAAmB,EAAE,MAAM,CAAA;CAC5B;AAoBD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAU9D;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAiB5D;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,SAAS,CAAI;IACrB,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,WAAW,CAAI;IACvB,OAAO,CAAC,IAAI,CAAS;gBAET,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC;IAStC,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKjC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIlC,KAAK,IAAI,iBAAiB;IAgF1B,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,mBAAmB;IAqC3B,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,uBAAuB;IAU/B,OAAO,CAAC,sBAAsB;CAsB/B"}

package/dist/godel-limits.js

@@ -0,0 +1,251 @@
+// Computational decidability detection — inspired by Gödel's incompleteness
+// theorem and the UBC Okanagan research proving some problems can't be solved
+// algorithmically. Detects when the agent is stuck and should hand off.
+export var LoopPattern;
+(function (LoopPattern) {
+    LoopPattern["tool_repetition"] = "tool_repetition";
+    LoopPattern["output_oscillation"] = "output_oscillation";
+    LoopPattern["cost_spiral"] = "cost_spiral";
+    LoopPattern["context_exhaustion"] = "context_exhaustion";
+    LoopPattern["semantic_stagnation"] = "semantic_stagnation";
+    LoopPattern["circular_reasoning"] = "circular_reasoning";
+})(LoopPattern || (LoopPattern = {}));
+const RECOMMENDATIONS = {
+    [LoopPattern.tool_repetition]: 'simplify',
+    [LoopPattern.output_oscillation]: 'handoff',
+    [LoopPattern.cost_spiral]: 'handoff',
+    [LoopPattern.context_exhaustion]: 'decompose',
+    [LoopPattern.semantic_stagnation]: 'simplify',
+    [LoopPattern.circular_reasoning]: 'handoff',
+};
+const EVIDENCE_MESSAGES = {
+    [LoopPattern.tool_repetition]: 'Same tool called repeatedly with similar arguments — try a different approach.',
+    [LoopPattern.output_oscillation]: 'Output alternating between two states — going back and forth without progress.',
+    [LoopPattern.cost_spiral]: 'Cost is accelerating without convergence — getting expensive without results.',
+    [LoopPattern.context_exhaustion]: 'Context window nearly full — too much information for one pass.',
+    [LoopPattern.semantic_stagnation]: 'Last several outputs are nearly identical — not making progress.',
+    [LoopPattern.circular_reasoning]: 'Tool results being fed back as inputs — reasoning in circles.',
+};
+export function jaccardSimilarity(a, b) {
+    const setA = new Set(a.toLowerCase().split(/\s+/).filter(w => w.length > 2));
+    const setB = new Set(b.toLowerCase().split(/\s+/).filter(w => w.length > 2));
+    if (setA.size === 0 && setB.size === 0)
+        return 1;
+    if (setA.size === 0 || setB.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const w of setA) {
+        if (setB.has(w))
+            intersection++;
+    }
+    const union = new Set([...setA, ...setB]).size;
+    return union === 0 ? 0 : intersection / union;
+}
+export function detectOscillation(outputs) {
+    if (outputs.length < 4)
+        return false;
+    const recent = outputs.slice(-6);
+    if (recent.length < 4)
+        return false;
+    // Check A-B-A-B pattern: compare [0] with [2] and [1] with [3]
+    for (let i = 0; i <= recent.length - 4; i++) {
+        const simAC = jaccardSimilarity(recent[i], recent[i + 2]);
+        const simBD = jaccardSimilarity(recent[i + 1], recent[i + 3]);
+        const simAB = jaccardSimilarity(recent[i], recent[i + 1]);
+        // A≈C and B≈D but A≠B → oscillation
+        if (simAC > 0.8 && simBD > 0.8 && simAB < 0.5)
+            return true;
+    }
+    return false;
+}
+export class LoopDetector {
+    toolHistory = [];
+    outputs = [];
+    totalCost = 0;
+    costHistory = [];
+    totalTokens = 0;
+    opts;
+    constructor(options) {
+        this.opts = {
+            maxToolRepeats: options?.maxToolRepeats ?? 5,
+            maxCostUsd: options?.maxCostUsd ?? 1.0,
+            maxTokens: options?.maxTokens ?? 50000,
+            similarityThreshold: options?.similarityThreshold ?? 0.85,
+        };
+    }
+    recordToolCall(toolName, args, result) {
+        this.toolHistory.push({ name: toolName, args, result, timestamp: Date.now() });
+    }
+    recordOutput(output) {
+        this.outputs.push(output);
+    }
+    recordCost(costUsd) {
+        this.totalCost += costUsd;
+        this.costHistory.push(this.totalCost);
+    }
+    recordTokens(tokens) {
+        this.totalTokens += tokens;
+    }
+    check() {
+        const base = {
+            tokensBurned: this.totalTokens,
+            costBurned: this.totalCost,
+        };
+        // 1. Tool repetition
+        const repetition = this.checkToolRepetition();
+        if (repetition)
+            return { ...base, ...repetition };
+        // 2. Output oscillation
+        if (detectOscillation(this.outputs)) {
+            return {
+                ...base,
+                decidable: false,
+                confidence: 0.85,
+                pattern: LoopPattern.output_oscillation,
+                evidence: EVIDENCE_MESSAGES[LoopPattern.output_oscillation],
+                recommendation: RECOMMENDATIONS[LoopPattern.output_oscillation],
+            };
+        }
+        // 3. Cost spiral
+        if (this.checkCostSpiral()) {
+            return {
+                ...base,
+                decidable: false,
+                confidence: 0.9,
+                pattern: LoopPattern.cost_spiral,
+                evidence: `${EVIDENCE_MESSAGES[LoopPattern.cost_spiral]} ($${this.totalCost.toFixed(2)} spent)`,
+                recommendation: RECOMMENDATIONS[LoopPattern.cost_spiral],
+            };
+        }
+        // 4. Context exhaustion
+        if (this.totalTokens > this.opts.maxTokens) {
+            return {
+                ...base,
+                decidable: false,
+                confidence: 0.95,
+                pattern: LoopPattern.context_exhaustion,
+                evidence: `${EVIDENCE_MESSAGES[LoopPattern.context_exhaustion]} (${this.totalTokens} tokens used)`,
+                recommendation: RECOMMENDATIONS[LoopPattern.context_exhaustion],
+            };
+        }
+        // 5. Semantic stagnation
+        if (this.checkSemanticStagnation()) {
+            return {
+                ...base,
+                decidable: false,
+                confidence: 0.8,
+                pattern: LoopPattern.semantic_stagnation,
+                evidence: EVIDENCE_MESSAGES[LoopPattern.semantic_stagnation],
+                recommendation: RECOMMENDATIONS[LoopPattern.semantic_stagnation],
+            };
+        }
+        // 6. Circular reasoning
+        if (this.checkCircularReasoning()) {
+            return {
+                ...base,
+                decidable: false,
+                confidence: 0.75,
+                pattern: LoopPattern.circular_reasoning,
+                evidence: EVIDENCE_MESSAGES[LoopPattern.circular_reasoning],
+                recommendation: RECOMMENDATIONS[LoopPattern.circular_reasoning],
+            };
+        }
+        // All clear
+        return {
+            ...base,
+            decidable: true,
+            confidence: 1.0,
+            evidence: 'No loop patterns detected.',
+            recommendation: 'continue',
+        };
+    }
+    reset() {
+        this.toolHistory = [];
+        this.outputs = [];
+        this.totalCost = 0;
+        this.costHistory = [];
+        this.totalTokens = 0;
+    }
+    checkToolRepetition() {
+        if (this.toolHistory.length < this.opts.maxToolRepeats)
+            return null;
+        // Group recent calls by tool name
+        const recent = this.toolHistory.slice(-10);
+        const groups = new Map();
+        for (const record of recent) {
+            if (!groups.has(record.name))
+                groups.set(record.name, []);
+            groups.get(record.name).push(record);
+        }
+        for (const [name, calls] of groups) {
+            if (calls.length < this.opts.maxToolRepeats)
+                continue;
+            // Check if args are similar
+            let similarCount = 0;
+            for (let i = 1; i < calls.length; i++) {
+                if (jaccardSimilarity(calls[i].args, calls[0].args) > this.opts.similarityThreshold) {
+                    similarCount++;
+                }
+            }
+            if (similarCount >= this.opts.maxToolRepeats - 1) {
+                return {
+                    decidable: false,
+                    confidence: 0.9,
+                    pattern: LoopPattern.tool_repetition,
+                    evidence: `${EVIDENCE_MESSAGES[LoopPattern.tool_repetition]} (${name} called ${calls.length}x)`,
+                    recommendation: RECOMMENDATIONS[LoopPattern.tool_repetition],
+                };
+            }
+        }
+        return null;
+    }
+    checkCostSpiral() {
+        if (this.totalCost < this.opts.maxCostUsd)
+            return false;
+        if (this.costHistory.length < 4)
+            return true; // Over budget with few steps = spiral
+        // Check if cost rate is accelerating
+        const recent = this.costHistory.slice(-4);
+        const deltas = [];
+        for (let i = 1; i < recent.length; i++) {
+            deltas.push(recent[i] - recent[i - 1]);
+        }
+        // Accelerating if each delta is larger than the previous
+        return deltas.length >= 2 && deltas[deltas.length - 1] > deltas[0];
+    }
+    checkSemanticStagnation() {
+        if (this.outputs.length < 3)
+            return false;
+        const recent = this.outputs.slice(-3);
+        for (let i = 1; i < recent.length; i++) {
+            if (jaccardSimilarity(recent[i], recent[0]) < 0.9)
+                return false;
+        }
+        return true;
+    }
+    checkCircularReasoning() {
+        if (this.toolHistory.length < 3)
+            return false;
+        const recent = this.toolHistory.slice(-5);
+        for (let i = 1; i < recent.length; i++) {
+            const prevResult = recent[i - 1].result;
+            const currArgs = recent[i].args;
+            // If >40% of words in current args appeared in previous result
+            if (prevResult.length > 20 && currArgs.length > 20) {
+                const resultWords = new Set(prevResult.toLowerCase().split(/\s+/).filter(w => w.length > 3));
+                const argWords = currArgs.toLowerCase().split(/\s+/).filter(w => w.length > 3);
+                if (argWords.length === 0)
+                    continue;
+                let overlap = 0;
+                for (const w of argWords) {
+                    if (resultWords.has(w))
+                        overlap++;
+                }
+                if (overlap / argWords.length > 0.4)
+                    return true;
+            }
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=godel-limits.js.map

package/dist/godel-limits.js.map

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

package/dist/simulation.d.ts

@@ -0,0 +1,50 @@
+export interface SimulationScenario {
+    description: string;
+    targetFiles: string[];
+    changeType: 'refactor' | 'add_feature' | 'delete' | 'migrate' | 'upgrade';
+    constraints?: string[];
+}
+export interface BreakingChange {
+    file: string;
+    line?: number;
+    description: string;
+    severity: 'warning' | 'error';
+    suggestedFix?: string;
+}
+export interface SimulationResult {
+    scenario: SimulationScenario;
+    predictedOutcome: string;
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    breakingChanges: BreakingChange[];
+    estimatedEffort: string;
+    confidence: number;
+    recommendations: string[];
+}
+export interface ComparisonResult {
+    scenarios: SimulationResult[];
+    recommended: number;
+    reasoning: string;
+}
+export interface FileNode {
+    path: string;
+    exports: string[];
+    imports: string[];
+    size: number;
+}
+export interface DependencyGraph {
+    nodes: Map<string, FileNode>;
+    edges: Map<string, string[]>;
+}
+export declare function buildDependencyGraph(rootDir: string): Promise<DependencyGraph>;
+export declare function findImpactedFiles(graph: DependencyGraph, changedFiles: string[]): string[];
+export declare function simulateChange(scenario: SimulationScenario, graph?: DependencyGraph): Promise<SimulationResult>;
+export declare class Simulator {
+    private rootDir;
+    private graph;
+    constructor(rootDir?: string);
+    init(): Promise<void>;
+    simulate(scenario: SimulationScenario): Promise<SimulationResult>;
+    compareScenarios(scenarios: SimulationScenario[]): Promise<ComparisonResult>;
+    getGraph(): DependencyGraph | null;
+}
+//# sourceMappingURL=simulation.d.ts.map

package/dist/simulation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"simulation.d.ts","sourceRoot":"","sources":["../src/simulation.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,MAAM,EAAE,CAAA;IACrB,UAAU,EAAE,UAAU,GAAG,aAAa,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAA;IACzE,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,SAAS,GAAG,OAAO,CAAA;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,kBAAkB,CAAA;IAC5B,gBAAgB,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAA;IACjD,eAAe,EAAE,cAAc,EAAE,CAAA;IACjC,eAAe,EAAE,MAAM,CAAA;IACvB,UAAU,EAAE,MAAM,CAAA;IAClB,eAAe,EAAE,MAAM,EAAE,CAAA;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,gBAAgB,EAAE,CAAA;IAC7B,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC5B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAC7B;AAsCD,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA8CpF;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,MAAM,EAAE,GACrB,MAAM,EAAE,CAiBV;AAED,wBAAsB,cAAc,CAClC,QAAQ,EAAE,kBAAkB,EAC5B,KAAK,CAAC,EAAE,eAAe,GACtB,OAAO,CAAC,gBAAgB,CAAC,CA8D3B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,KAAK,CAA+B;gBAEhC,OAAO,CAAC,EAAE,MAAM;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAKjE,gBAAgB,CAAC,SAAS,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA8BlF,QAAQ,IAAI,eAAe,GAAG,IAAI;CAGnC"}