@tooluminati/diagnostics 0.1.0

package/dist/troubleshooting-guidance.js

@@ -0,0 +1,130 @@
+export const TROUBLESHOOTING_GUIDANCE = {
+    'document.modelContext': {
+        title: 'WebMCP host missing',
+        hint: 'No document.modelContext on this page. Enable WebMCP in Chrome or ' +
+            'attach the Model Context Inspector Extension. Tools cannot register ' +
+            'until this resolves.',
+        severity: 'error',
+    },
+    'navigator.modelContext': {
+        title: 'Deprecated fallback in use',
+        hint: 'Migrate from navigator.modelContext to document.modelContext. The ' +
+            'fallback is not a supported long-term surface.',
+        severity: 'warn',
+    },
+    'origin-isolation': {
+        title: 'Origin isolation review',
+        hint: 'Origin-Agent-Cluster may be ?0 when document.domain is set. Remove ' +
+            'document.domain writes or set Origin-Agent-Cluster: ?1.',
+        severity: 'warn',
+    },
+    'permissions-policy': {
+        title: 'Permissions-Policy review',
+        hint: 'Cross-origin iframes may block tools unless Permissions-Policy allows ' +
+            'the tools feature for this origin.',
+        severity: 'warn',
+    },
+    'tool-count': {
+        title: 'No tools registered',
+        hint: 'Verify WebMcpProvider or provideWebMcpRegistry is mounted and tools ' +
+            'are registered in the current route scope.',
+        severity: 'warn',
+    },
+    'output-budget': {
+        title: 'Tool output budget exceeded',
+        hint: 'A tool emitted more than the recommended ~1.5K chars. Trim fields or ' +
+            'enable redaction to stay within Chrome guidance.',
+        severity: 'warn',
+    },
+    fetch_failure: {
+        title: 'Fetch failure',
+        hint: 'Inspect get_troubleshooting_timeline and get_workflow_blockers for ' +
+            'structured HTTP failure context.',
+        severity: 'error',
+    },
+    client_error: {
+        title: 'Client error',
+        hint: 'See get_recent_client_errors and the timeline client_error entries ' +
+            'for redacted stack traces in dev.',
+        severity: 'error',
+    },
+    action_blocked: {
+        title: 'Action blocked',
+        hint: 'Call why_is_action_unavailable or get_workflow_blockers for reasons ' +
+            'beyond disabled=true in the DOM.',
+        severity: 'warn',
+    },
+    toolchange: {
+        title: 'Tool registry changed',
+        hint: 'Tools were added or removed. Check route mounts and scoped providers ' +
+            'if the count is unexpected.',
+        severity: 'info',
+    },
+    WebMcpUnavailable: {
+        title: 'WebMCP unavailable',
+        hint: 'Tooluminati could not find document.modelContext. Registration was ' +
+            'deferred until a host becomes available.',
+        severity: 'error',
+    },
+    TypeError: {
+        title: 'Runtime TypeError',
+        hint: 'Check component props and optional chaining. Errors are captured by ' +
+            'WebMcpErrorBoundary when enabled.',
+        severity: 'error',
+    },
+    NetworkError: {
+        title: 'Network failure',
+        hint: 'Verify API availability and CORS. Timeline fetch_failure entries ' +
+            'include status and timing.',
+        severity: 'error',
+    },
+};
+export function getGuidanceForEnvironmentCheck(check) {
+    if (check.hint) {
+        return {
+            title: check.label,
+            hint: check.hint,
+            severity: check.status === 'fail'
+                ? 'error'
+                : check.status === 'warn'
+                    ? 'warn'
+                    : 'info',
+        };
+    }
+    return TROUBLESHOOTING_GUIDANCE[check.id];
+}
+export function getGuidanceForTimelineEvent(event) {
+    const base = TROUBLESHOOTING_GUIDANCE[event.category];
+    if (base) {
+        return {
+            ...base,
+            hint: event.detail ? `${base.hint} ${event.detail}` : base.hint,
+        };
+    }
+    return undefined;
+}
+export function getGuidanceForClientError(error) {
+    for (const key of ['WebMcpUnavailable', 'TypeError', 'NetworkError']) {
+        if (error.message.includes(key)) {
+            return TROUBLESHOOTING_GUIDANCE[key];
+        }
+    }
+    return TROUBLESHOOTING_GUIDANCE.client_error;
+}
+export function timelineEventGroup(category) {
+    if (category === 'fetch_failure' || category === 'client_error') {
+        return 'failures';
+    }
+    if (category === 'action_blocked') {
+        return 'blocked';
+    }
+    if (category === 'tool_activated' ||
+        category === 'tool_cancelled' ||
+        category === 'toolchange') {
+        return 'tools';
+    }
+    if (category === 'route_change' || category === 'agent_form_submit') {
+        return 'nav';
+    }
+    return 'all';
+}

package/dist/troubleshooting-guidance.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=troubleshooting-guidance.test.d.ts.map

package/dist/troubleshooting-guidance.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshooting-guidance.test.d.ts","sourceRoot":"","sources":["../src/troubleshooting-guidance.test.ts"],"names":[],"mappings":""}

package/dist/troubleshooting-guidance.test.js

@@ -0,0 +1,27 @@
+import { describe, expect, it } from 'vitest';
+import { TROUBLESHOOTING_GUIDANCE, getGuidanceForClientError, getGuidanceForEnvironmentCheck, timelineEventGroup, } from './troubleshooting-guidance';
+describe('troubleshooting guidance', () => {
+    it('returns environment check guidance by id', () => {
+        const guidance = getGuidanceForEnvironmentCheck({
+            id: 'document.modelContext',
+            label: 'document.modelContext',
+            value: 'missing',
+            status: 'fail',
+        });
+        expect(guidance?.severity).toBe('error');
+        expect(TROUBLESHOOTING_GUIDANCE['document.modelContext']).toBeDefined();
+    });
+    it('matches client error patterns', () => {
+        const guidance = getGuidanceForClientError({
+            message: 'NetworkError: failed to fetch',
+            source: 'api.ts',
+            timestamp: new Date().toISOString(),
+        });
+        expect(guidance?.title).toBe('Network failure');
+    });
+    it('groups timeline categories', () => {
+        expect(timelineEventGroup('fetch_failure')).toBe('failures');
+        expect(timelineEventGroup('tool_activated')).toBe('tools');
+        expect(timelineEventGroup('route_change')).toBe('nav');
+    });
+});

package/dist/troubleshooting-panel.d.ts

@@ -0,0 +1,77 @@
+import type { WebMcpRegistry } from '@tooluminati/core';
+import type { ClientErrorBuffer } from './errors';
+import { type TimelineFilterGroup } from './troubleshooting-guidance';
+import type { TroubleshootingEvent, TroubleshootingTimelineBuffer } from './timeline';
+import { type WebMcpEnvironmentCheck, type WebMcpEnvironmentSummary } from './webmcp-environment';
+export type TroubleshootingPanelState = 'ok' | 'attention' | 'unsupported' | 'empty';
+export interface TroubleshootingPanelSources {
+    timeline: TroubleshootingTimelineBuffer;
+    environment: () => WebMcpEnvironmentSummary;
+    errors: ClientErrorBuffer;
+    registry?: WebMcpRegistry | undefined;
+}
+export interface TroubleshootingPanelEventView {
+    id: string;
+    category: TroubleshootingEvent['category'];
+    group: TimelineFilterGroup;
+    title: string;
+    time: string;
+    detail?: string | undefined;
+    metadata?: Record<string, string> | undefined;
+    guidance?: string | undefined;
+}
+export interface TroubleshootingPanelErrorView {
+    id: string;
+    message: string;
+    source: string;
+    time: string;
+    count: number;
+    stack?: string | undefined;
+    guidance?: string | undefined;
+}
+export interface TroubleshootingPanelCheckView extends WebMcpEnvironmentCheck {
+    guidance?: string | undefined;
+}
+export interface TroubleshootingPanelSnapshot {
+    supported: boolean;
+    toolCount: number;
+    origin: string;
+    panelState: TroubleshootingPanelState;
+    issueCount: number;
+    checks: TroubleshootingPanelCheckView[];
+    events: TroubleshootingPanelEventView[];
+    errors: TroubleshootingPanelErrorView[];
+    warnings: string[];
+    updatedAt: string;
+}
+export interface TroubleshootingPanelViewModelOptions {
+    eventLimit?: number;
+    pollMs?: number | null;
+    registry?: WebMcpRegistry | undefined;
+}
+export interface TroubleshootingPanelViewModel {
+    refresh(): TroubleshootingPanelSnapshot;
+    subscribe(listener: () => void): () => void;
+    dispose(): void;
+}
+export interface TroubleshootingPanelVisibilityController {
+    visible: boolean;
+    collapsed: boolean;
+    show(): void;
+    hide(): void;
+    toggle(): void;
+    setCollapsed(collapsed: boolean): void;
+    subscribe(listener: () => void): () => void;
+}
+export declare function computeTroubleshootingPanelState(snapshot: Pick<TroubleshootingPanelSnapshot, 'supported' | 'toolCount' | 'issueCount' | 'events' | 'errors' | 'warnings'>): TroubleshootingPanelState;
+export declare function serializeTroubleshootingDiagnostics(snapshot: TroubleshootingPanelSnapshot): string;
+export declare function buildTroubleshootingPanelSnapshot(sources: TroubleshootingPanelSources, options?: TroubleshootingPanelViewModelOptions): TroubleshootingPanelSnapshot;
+export declare function createTroubleshootingPanelViewModel(sources: TroubleshootingPanelSources, options?: TroubleshootingPanelViewModelOptions): TroubleshootingPanelViewModel;
+export declare function createTroubleshootingPanelVisibilityController(options?: {
+    startCollapsed?: boolean;
+    storageKey?: string;
+}): TroubleshootingPanelVisibilityController;
+export declare function isPanelEnabledByDefault(enabled: boolean | 'auto' | undefined): boolean;
+export declare function isPanelUrlOverrideEnabled(allowUrlOverride: boolean | undefined): boolean;
+export declare function filterPanelEvents(events: TroubleshootingPanelEventView[], filter: TimelineFilterGroup): TroubleshootingPanelEventView[];
+//# sourceMappingURL=troubleshooting-panel.d.ts.map

package/dist/troubleshooting-panel.d.ts.map

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

package/dist/troubleshooting-panel.js

@@ -0,0 +1,243 @@
+import { getGuidanceForClientError, getGuidanceForEnvironmentCheck, getGuidanceForTimelineEvent, timelineEventGroup, } from './troubleshooting-guidance';
+import { createWebMcpEnvironmentSummary, } from './webmcp-environment';
+const STORAGE_KEY = 'tooluminati.troubleshootingPanel.collapsed';
+function relativeTime(iso) {
+    const delta = Date.now() - Date.parse(iso);
+    if (Number.isNaN(delta) || delta < 0) {
+        return 'now';
+    }
+    const seconds = Math.round(delta / 1000);
+    if (seconds < 60) {
+        return `${seconds}s`;
+    }
+    const minutes = Math.round(seconds / 60);
+    return `${minutes}m`;
+}
+function dedupeErrors(errors) {
+    const counts = new Map();
+    for (const error of errors) {
+        counts.set(error.message, (counts.get(error.message) ?? 0) + 1);
+    }
+    const seen = new Set();
+    const views = [];
+    for (const error of errors) {
+        if (seen.has(error.message)) {
+            continue;
+        }
+        seen.add(error.message);
+        const guidance = getGuidanceForClientError(error)?.hint;
+        views.push({
+            id: error.message,
+            message: error.message,
+            source: error.source,
+            time: relativeTime(error.timestamp),
+            count: counts.get(error.message) ?? 1,
+            ...(error.stack ? { stack: error.stack } : {}),
+            ...(guidance ? { guidance } : {}),
+        });
+    }
+    return views;
+}
+export function computeTroubleshootingPanelState(snapshot) {
+    if (!snapshot.supported) {
+        return 'unsupported';
+    }
+    const hasIncidents = snapshot.issueCount > 0 ||
+        snapshot.errors.length > 0 ||
+        snapshot.events.some((event) => event.group === 'failures' ||
+            event.group === 'blocked' ||
+            event.category === 'toolchange');
+    if (!hasIncidents &&
+        snapshot.events.length === 0 &&
+        snapshot.errors.length === 0) {
+        return snapshot.toolCount === 0 ? 'empty' : 'ok';
+    }
+    if (hasIncidents) {
+        return 'attention';
+    }
+    return 'ok';
+}
+export function serializeTroubleshootingDiagnostics(snapshot) {
+    return JSON.stringify({
+        webmcp: {
+            supported: snapshot.supported,
+            toolCount: snapshot.toolCount,
+            origin: snapshot.origin,
+            panelState: snapshot.panelState,
+        },
+        checks: snapshot.checks.map((c) => ({
+            label: c.label,
+            value: c.value,
+            status: c.status,
+            ...(c.guidance ? { guidance: c.guidance } : {}),
+        })),
+        timeline: snapshot.events.map((e) => ({
+            category: e.category,
+            title: e.title,
+            t: e.time,
+            ...(e.guidance ? { guidance: e.guidance } : {}),
+            ...(e.metadata ? { metadata: e.metadata } : {}),
+        })),
+        clientErrors: snapshot.errors.map((e) => ({
+            message: e.message,
+            count: e.count,
+            ...(e.guidance ? { guidance: e.guidance } : {}),
+        })),
+        warnings: snapshot.warnings,
+    }, null, 2);
+}
+export function buildTroubleshootingPanelSnapshot(sources, options = {}) {
+    const env = sources.environment() ??
+        createWebMcpEnvironmentSummary({
+            ...(sources.registry ? { registry: sources.registry } : {}),
+            ...(options.registry ? { registry: options.registry } : {}),
+        });
+    const eventLimit = options.eventLimit ?? 20;
+    const rawEvents = sources.timeline.list({ limit: eventLimit });
+    const events = rawEvents.map((event) => {
+        const guidance = getGuidanceForTimelineEvent(event)?.hint;
+        return {
+            id: event.id,
+            category: event.category,
+            group: timelineEventGroup(event.category),
+            title: event.title,
+            time: relativeTime(event.timestamp),
+            ...(event.detail ? { detail: event.detail } : {}),
+            ...(event.metadata ? { metadata: event.metadata } : {}),
+            ...(guidance ? { guidance } : {}),
+        };
+    });
+    const checks = env.checks.map((check) => {
+        const guidance = getGuidanceForEnvironmentCheck(check)?.hint;
+        return {
+            ...check,
+            ...(guidance ? { guidance } : {}),
+        };
+    });
+    const errors = dedupeErrors(sources.errors.list());
+    const warnCount = checks.filter((c) => c.status === 'warn' || c.status === 'fail').length;
+    const incidentEvents = events.filter((event) => event.group === 'failures' || event.group === 'blocked').length;
+    const issueCount = warnCount + errors.length + incidentEvents;
+    const snapshot = {
+        supported: env.supported,
+        toolCount: env.toolCount,
+        origin: env.origin,
+        issueCount,
+        checks,
+        events,
+        errors,
+        warnings: env.warnings,
+        updatedAt: new Date().toISOString(),
+        panelState: 'ok',
+    };
+    snapshot.panelState = computeTroubleshootingPanelState(snapshot);
+    return snapshot;
+}
+export function createTroubleshootingPanelViewModel(sources, options = {}) {
+    const listeners = new Set();
+    let timer;
+    const notify = () => {
+        for (const listener of listeners) {
+            listener();
+        }
+    };
+    if (options.pollMs && options.pollMs > 0) {
+        timer = setInterval(notify, options.pollMs);
+    }
+    return {
+        refresh() {
+            return buildTroubleshootingPanelSnapshot(sources, options);
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+        dispose() {
+            listeners.clear();
+            if (timer) {
+                clearInterval(timer);
+            }
+        },
+    };
+}
+export function createTroubleshootingPanelVisibilityController(options) {
+    const storageKey = options?.storageKey ?? STORAGE_KEY;
+    const listeners = new Set();
+    let visible = true;
+    let collapsed = options?.startCollapsed ?? readCollapsed(storageKey);
+    const notify = () => {
+        for (const listener of listeners) {
+            listener();
+        }
+    };
+    return {
+        get visible() {
+            return visible;
+        },
+        get collapsed() {
+            return collapsed;
+        },
+        show() {
+            visible = true;
+            notify();
+        },
+        hide() {
+            visible = false;
+            notify();
+        },
+        toggle() {
+            visible = !visible;
+            notify();
+        },
+        setCollapsed(next) {
+            collapsed = next;
+            writeCollapsed(storageKey, next);
+            notify();
+        },
+        subscribe(listener) {
+            listeners.add(listener);
+            return () => {
+                listeners.delete(listener);
+            };
+        },
+    };
+}
+export function isPanelEnabledByDefault(enabled) {
+    if (enabled === true) {
+        return true;
+    }
+    if (enabled === false) {
+        return false;
+    }
+    const nodeEnv = typeof process !== 'undefined' ? process.env?.NODE_ENV : undefined;
+    if (!nodeEnv || nodeEnv === 'development' || nodeEnv === 'test') {
+        return true;
+    }
+    return nodeEnv !== 'production';
+}
+export function isPanelUrlOverrideEnabled(allowUrlOverride) {
+    if (!allowUrlOverride || typeof window === 'undefined') {
+        return false;
+    }
+    return new URLSearchParams(window.location.search).has('tooluminati-panel');
+}
+function readCollapsed(storageKey) {
+    if (typeof sessionStorage === 'undefined') {
+        return false;
+    }
+    return sessionStorage.getItem(storageKey) === '1';
+}
+function writeCollapsed(storageKey, collapsed) {
+    if (typeof sessionStorage === 'undefined') {
+        return;
+    }
+    sessionStorage.setItem(storageKey, collapsed ? '1' : '0');
+}
+export function filterPanelEvents(events, filter) {
+    if (filter === 'all') {
+        return events;
+    }
+    return events.filter((event) => event.group === filter);
+}

package/dist/troubleshooting-panel.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=troubleshooting-panel.test.d.ts.map

package/dist/troubleshooting-panel.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"troubleshooting-panel.test.d.ts","sourceRoot":"","sources":["../src/troubleshooting-panel.test.ts"],"names":[],"mappings":""}

package/dist/troubleshooting-panel.test.js

@@ -0,0 +1,105 @@
+import { describe, expect, it } from 'vitest';
+import { ClientErrorBuffer } from './errors';
+import { buildTroubleshootingPanelSnapshot, computeTroubleshootingPanelState, createTroubleshootingPanelVisibilityController, filterPanelEvents, serializeTroubleshootingDiagnostics, } from './troubleshooting-panel';
+import { TroubleshootingTimelineBuffer } from './timeline';
+import { createWebMcpEnvironmentSummary } from './webmcp-environment';
+const globalObject = {
+    window: {},
+    document: { modelContext: {} },
+    location: { origin: 'https://app.test' },
+};
+describe('troubleshooting panel snapshot', () => {
+    it('computes attention when warnings and errors exist', () => {
+        const timeline = new TroubleshootingTimelineBuffer();
+        const errors = new ClientErrorBuffer();
+        errors.push({
+            message: 'TypeError: boom',
+            source: 'app.tsx',
+            timestamp: new Date().toISOString(),
+        });
+        const snapshot = buildTroubleshootingPanelSnapshot({
+            timeline,
+            errors,
+            environment: () => createWebMcpEnvironmentSummary({
+                globalObject: {
+                    window: {},
+                    document: { modelContext: {}, domain: 'x.com' },
+                    location: { origin: 'https://app.test' },
+                },
+            }),
+        });
+        expect(snapshot.panelState).toBe('attention');
+        expect(snapshot.errors[0]?.count).toBe(1);
+    });
+    it('serializes diagnostics JSON for copy', () => {
+        const snapshot = buildTroubleshootingPanelSnapshot({
+            timeline: new TroubleshootingTimelineBuffer(),
+            errors: new ClientErrorBuffer(),
+            environment: () => createWebMcpEnvironmentSummary({ globalObject }),
+        });
+        const json = serializeTroubleshootingDiagnostics(snapshot);
+        const parsed = JSON.parse(json);
+        expect(parsed).toHaveProperty('webmcp');
+        expect(parsed).toHaveProperty('timeline');
+    });
+    it('filters timeline events by group', () => {
+        const timeline = new TroubleshootingTimelineBuffer();
+        timeline.push({
+            category: 'fetch_failure',
+            title: 'fail',
+            method: 'GET',
+            url: '/api',
+        });
+        timeline.push({
+            category: 'route_change',
+            title: 'nav',
+            to: '/x',
+        });
+        const snapshot = buildTroubleshootingPanelSnapshot({
+            timeline,
+            errors: new ClientErrorBuffer(),
+            environment: () => createWebMcpEnvironmentSummary({ globalObject }),
+        });
+        const failures = filterPanelEvents(snapshot.events, 'failures');
+        expect(failures).toHaveLength(1);
+    });
+});
+describe('computeTroubleshootingPanelState', () => {
+    it('returns unsupported when WebMCP is missing', () => {
+        expect(computeTroubleshootingPanelState({
+            supported: false,
+            toolCount: 0,
+            issueCount: 0,
+            events: [],
+            errors: [],
+            warnings: [],
+        })).toBe('unsupported');
+    });
+    it('returns attention when only timeline failures exist', () => {
+        const timeline = new TroubleshootingTimelineBuffer();
+        timeline.push({
+            category: 'fetch_failure',
+            title: 'GET /api — 403',
+            method: 'GET',
+            url: '/api',
+            status: 403,
+        });
+        const snapshot = buildTroubleshootingPanelSnapshot({
+            timeline,
+            errors: new ClientErrorBuffer(),
+            environment: () => createWebMcpEnvironmentSummary({ globalObject }),
+        });
+        expect(snapshot.panelState).toBe('attention');
+    });
+});
+describe('visibility controller', () => {
+    it('toggles collapsed state', () => {
+        const controller = createTroubleshootingPanelVisibilityController({
+            startCollapsed: true,
+            storageKey: 'test.collapsed',
+        });
+        expect(controller.collapsed).toBe(true);
+        controller.setCollapsed(false);
+        expect(controller.collapsed).toBe(false);
+    });
+});

package/dist/webmcp-environment.d.ts

@@ -0,0 +1,23 @@
+import { type WebMcpRegistry, type WebMcpToolDescriptor } from '@tooluminati/core';
+export interface WebMcpEnvironmentCheck {
+    id: string;
+    label: string;
+    value: string;
+    status: 'ok' | 'warn' | 'fail' | 'muted';
+    hint?: string | undefined;
+}
+export interface WebMcpEnvironmentSummary {
+    supported: boolean;
+    toolCount: number;
+    origin: string;
+    usingNavigatorFallback: boolean;
+    checks: WebMcpEnvironmentCheck[];
+    warnings: string[];
+}
+export interface WebMcpEnvironmentSummaryOptions {
+    registry?: WebMcpRegistry | undefined;
+    globalObject?: typeof globalThis;
+}
+export declare function createWebMcpEnvironmentSummary(options?: WebMcpEnvironmentSummaryOptions): WebMcpEnvironmentSummary;
+export declare function createWebMcpEnvironmentTool(getSummary: () => WebMcpEnvironmentSummary, name?: string): WebMcpToolDescriptor<Record<string, never>, WebMcpEnvironmentSummary>;
+//# sourceMappingURL=webmcp-environment.d.ts.map

package/dist/webmcp-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webmcp-environment.d.ts","sourceRoot":"","sources":["../src/webmcp-environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,sBAAsB;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACzC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,OAAO,CAAC;IAChC,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACtC,YAAY,CAAC,EAAE,OAAO,UAAU,CAAC;CAClC;AAED,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,wBAAwB,CAoG1B;AA8ED,wBAAgB,2BAA2B,CACzC,UAAU,EAAE,MAAM,wBAAwB,EAC1C,IAAI,SAA2B,GAC9B,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,wBAAwB,CAAC,CAavE"}