@kryptosai/mcp-observatory 0.12.0 → 0.14.0

package/dist/src/integrations/smithery.js

@@ -0,0 +1,301 @@
+/**
+ * Smithery Registry Integration
+ *
+ * Generates health-score submissions for the Smithery MCP server registry
+ * and resolves Smithery server listings into Observatory target configs.
+ */
+import { generateBadgeSvg } from "../badge.js";
+import { computeHealthScore } from "../score.js";
+// ── Constants ───────────────────────────────────────────────────────────────
+const DEFAULT_BASE_URL = "https://registry.smithery.ai";
+const REQUEST_TIMEOUT_MS = 15_000;
+const RATE_LIMIT_DELAY_MS = 1_500;
+// ── Helpers ─────────────────────────────────────────────────────────────────
+function baseUrl(config) {
+    return config?.baseUrl?.replace(/\/+$/, "") ?? DEFAULT_BASE_URL;
+}
+function buildHeaders(config) {
+    const headers = {
+        Accept: "application/json",
+        "User-Agent": "mcp-observatory/smithery-integration",
+    };
+    if (config?.apiKey) {
+        headers["Authorization"] = `Bearer ${config.apiKey}`;
+    }
+    return headers;
+}
+async function fetchJson(url, config) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS);
+    try {
+        const response = await fetch(url, {
+            headers: buildHeaders(config),
+            signal: controller.signal,
+        });
+        if (response.status === 429) {
+            throw new SmitheryRateLimitError("Smithery API rate limit exceeded. Please wait before retrying.");
+        }
+        if (!response.ok) {
+            throw new SmitheryApiError(`Smithery API returned ${response.status}: ${response.statusText}`, response.status);
+        }
+        return (await response.json());
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/** Sleep helper for rate-limiting between batch requests. */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ── Errors ──────────────────────────────────────────────────────────────────
+export class SmitheryApiError extends Error {
+    statusCode;
+    constructor(message, statusCode) {
+        super(message);
+        this.statusCode = statusCode;
+        this.name = "SmitheryApiError";
+    }
+}
+export class SmitheryRateLimitError extends SmitheryApiError {
+    constructor(message) {
+        super(message, 429);
+        this.name = "SmitheryRateLimitError";
+    }
+}
+// ── Core Functions ──────────────────────────────────────────────────────────
+/**
+ * Generate a submission report for a server.
+ * Creates a structured JSON report that could be submitted to Smithery's API
+ * or included in a PR to their repository.
+ */
+export function generateSubmission(qualifiedName, artifact) {
+    const score = artifact.healthScore ?? computeHealthScore(artifact.checks, artifact.performanceMetrics);
+    const badgeSvg = generateBadgeSvg({
+        label: "MCP Health",
+        score: score.overall,
+        grade: score.grade,
+    });
+    return {
+        qualifiedName,
+        artifact,
+        score,
+        badgeSvg,
+        submittedAt: new Date().toISOString(),
+    };
+}
+/**
+ * Render a submission as markdown suitable for a Smithery integration PR.
+ */
+export function renderSubmissionMarkdown(submission) {
+    const { qualifiedName, artifact, score } = submission;
+    const lines = [];
+    lines.push(`# MCP Observatory Report: ${qualifiedName}`);
+    lines.push("");
+    lines.push(`> Scanned at ${artifact.createdAt} by MCP Observatory v${artifact.toolVersion}`);
+    lines.push("");
+    // Badge (data URI)
+    const encodedSvg = Buffer.from(submission.badgeSvg).toString("base64");
+    lines.push(`![MCP Health Score](data:image/svg+xml;base64,${encodedSvg})`);
+    lines.push("");
+    // Overall score
+    lines.push("## Health Score");
+    lines.push("");
+    lines.push(`| Metric | Value |`);
+    lines.push(`|--------|-------|`);
+    lines.push(`| **Overall Score** | ${score.overall}/100 |`);
+    lines.push(`| **Grade** | ${score.grade} |`);
+    lines.push(`| **Gate** | ${artifact.gate} |`);
+    lines.push("");
+    // Dimensions
+    lines.push("## Score Breakdown");
+    lines.push("");
+    lines.push("| Dimension | Weight | Score | Details |");
+    lines.push("|-----------|--------|-------|---------|");
+    for (const dim of score.dimensions) {
+        const details = dim.details.join("; ");
+        lines.push(`| ${dim.name} | ${Math.round(dim.weight * 100)}% | ${dim.score}/100 | ${details} |`);
+    }
+    lines.push("");
+    // Individual checks
+    lines.push("## Check Results");
+    lines.push("");
+    lines.push("| Check | Status | Duration | Message |");
+    lines.push("|-------|--------|----------|---------|");
+    for (const check of artifact.checks) {
+        const icon = check.status === "pass" ? "pass" : check.status === "fail" ? "FAIL" : check.status;
+        lines.push(`| ${check.id} | ${icon} | ${check.durationMs}ms | ${check.message} |`);
+    }
+    lines.push("");
+    // Performance metrics
+    if (artifact.performanceMetrics) {
+        const pm = artifact.performanceMetrics;
+        lines.push("## Performance");
+        lines.push("");
+        lines.push(`- **Connect:** ${Math.round(pm.connectMs)}ms`);
+        if (pm.toolsListMs !== undefined)
+            lines.push(`- **tools/list:** ${Math.round(pm.toolsListMs)}ms`);
+        if (pm.promptsListMs !== undefined)
+            lines.push(`- **prompts/list:** ${Math.round(pm.promptsListMs)}ms`);
+        if (pm.resourcesListMs !== undefined)
+            lines.push(`- **resources/list:** ${Math.round(pm.resourcesListMs)}ms`);
+        lines.push("");
+    }
+    // Server info
+    lines.push("## Server Information");
+    lines.push("");
+    lines.push(`| Field | Value |`);
+    lines.push(`|-------|-------|`);
+    lines.push(`| **Target ID** | ${artifact.target.targetId} |`);
+    lines.push(`| **Adapter** | ${artifact.target.adapter} |`);
+    if (artifact.target.serverName) {
+        lines.push(`| **Server Name** | ${artifact.target.serverName} |`);
+    }
+    if (artifact.target.serverVersion) {
+        lines.push(`| **Server Version** | ${artifact.target.serverVersion} |`);
+    }
+    lines.push(`| **Platform** | ${artifact.environment.platform} |`);
+    lines.push(`| **Node** | ${artifact.environment.nodeVersion} |`);
+    lines.push("");
+    // Fatal errors
+    if (artifact.fatalError) {
+        lines.push("## Fatal Error");
+        lines.push("");
+        lines.push("```");
+        lines.push(artifact.fatalError);
+        lines.push("```");
+        lines.push("");
+    }
+    lines.push("---");
+    lines.push("*Generated by [MCP Observatory](https://github.com/anthropics/mcp-observatory)*");
+    return lines.join("\n");
+}
+/**
+ * Resolve a Smithery server listing to an Observatory target config.
+ * Fetches server metadata from Smithery and converts to TargetConfig.
+ */
+export async function resolveSmitheryTarget(qualifiedName, config) {
+    const url = `${baseUrl(config)}/api/servers/${encodeURIComponent(qualifiedName)}`;
+    const entry = await fetchJson(url, config);
+    return serverEntryToTarget(entry);
+}
+/**
+ * Fetch a page of servers from the Smithery registry.
+ */
+export async function listSmitheryServers(config, options) {
+    const params = new URLSearchParams();
+    if (options?.page !== undefined)
+        params.set("page", String(options.page));
+    if (options?.pageSize !== undefined)
+        params.set("pageSize", String(options.pageSize));
+    const qs = params.toString();
+    const url = `${baseUrl(config)}/api/servers${qs ? `?${qs}` : ""}`;
+    return fetchJson(url, config);
+}
+/**
+ * Batch-scan top N servers from the Smithery registry.
+ * Returns an array of submission results (or errors for individual servers).
+ */
+export async function batchScanServers(runTargetFn, config, options) {
+    const top = options?.top ?? 10;
+    const listResponse = await listSmitheryServers(config, { pageSize: top });
+    const servers = listResponse.servers.slice(0, top);
+    const results = [];
+    for (const server of servers) {
+        try {
+            const target = serverEntryToTarget(server);
+            const artifact = await runTargetFn(target);
+            const submission = generateSubmission(server.qualifiedName, artifact);
+            results.push({ qualifiedName: server.qualifiedName, submission });
+        }
+        catch (err) {
+            results.push({
+                qualifiedName: server.qualifiedName,
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        // Rate-limit between scans
+        await sleep(RATE_LIMIT_DELAY_MS);
+    }
+    return results;
+}
+/**
+ * Render a batch scan report as markdown.
+ */
+export function renderBatchReportMarkdown(results) {
+    const lines = [];
+    lines.push("# MCP Observatory — Smithery Batch Scan Report");
+    lines.push("");
+    lines.push(`> Scanned ${results.length} servers at ${new Date().toISOString()}`);
+    lines.push("");
+    // Summary table
+    const successful = results.filter((r) => r.submission);
+    const failed = results.filter((r) => r.error);
+    lines.push("## Summary");
+    lines.push("");
+    lines.push(`- **Scanned:** ${results.length}`);
+    lines.push(`- **Successful:** ${successful.length}`);
+    lines.push(`- **Failed:** ${failed.length}`);
+    lines.push("");
+    if (successful.length > 0) {
+        // Leaderboard
+        const sorted = successful
+            .map((r) => ({
+            name: r.qualifiedName,
+            score: r.submission.score.overall,
+            grade: r.submission.score.grade,
+            gate: r.submission.artifact.gate,
+        }))
+            .sort((a, b) => b.score - a.score);
+        lines.push("## Leaderboard");
+        lines.push("");
+        lines.push("| Rank | Server | Score | Grade | Gate |");
+        lines.push("|------|--------|-------|-------|------|");
+        sorted.forEach((s, i) => {
+            lines.push(`| ${i + 1} | ${s.name} | ${s.score}/100 | ${s.grade} | ${s.gate} |`);
+        });
+        lines.push("");
+    }
+    if (failed.length > 0) {
+        lines.push("## Errors");
+        lines.push("");
+        for (const f of failed) {
+            lines.push(`- **${f.qualifiedName}:** ${f.error}`);
+        }
+        lines.push("");
+    }
+    lines.push("---");
+    lines.push("*Generated by [MCP Observatory](https://github.com/anthropics/mcp-observatory)*");
+    return lines.join("\n");
+}
+// ── Internal Helpers ────────────────────────────────────────────────────────
+function serverEntryToTarget(entry) {
+    // Check for HTTP/SSE connections first
+    const httpConn = entry.connections?.find((c) => c.type === "http" || c.type === "sse" || c.url);
+    if (httpConn?.url) {
+        return {
+            targetId: entry.qualifiedName,
+            adapter: "http",
+            url: httpConn.url,
+            timeoutMs: 15_000,
+            metadata: {
+                smitheryName: entry.qualifiedName,
+                ...(entry.displayName ? { displayName: entry.displayName } : {}),
+            },
+        };
+    }
+    // Fall back to npx-based local-process target using the qualified name.
+    // Smithery packages typically run via `npx @scope/package-name`.
+    return {
+        targetId: entry.qualifiedName,
+        adapter: "local-process",
+        command: "npx",
+        args: ["-y", entry.qualifiedName],
+        timeoutMs: 30_000,
+        metadata: {
+            smitheryName: entry.qualifiedName,
+            ...(entry.displayName ? { displayName: entry.displayName } : {}),
+        },
+    };
+}
+//# sourceMappingURL=smithery.js.map

package/dist/src/integrations/smithery.js.map

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

package/dist/src/runtime/index.d.ts

@@ -0,0 +1,2 @@
+export { ObservatoryMonitor, type MonitorOptions, type MonitoredServer, type ServerStatus, } from "./monitor.js";
+export { withObservatory, type WrapperOptions, } from "./wrapper.js";

package/dist/src/runtime/index.js

@@ -0,0 +1,3 @@
+export { ObservatoryMonitor, } from "./monitor.js";
+export { withObservatory, } from "./wrapper.js";
+//# sourceMappingURL=index.js.map

package/dist/src/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,GAInB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,eAAe,GAEhB,MAAM,cAAc,CAAC"}

package/dist/src/runtime/monitor.d.ts

@@ -0,0 +1,68 @@
+import { EventEmitter } from "node:events";
+import type { ScoreWeights } from "../score.js";
+import type { HealthGrade, HealthScore, TargetConfig } from "../types.js";
+/** Options for configuring the ObservatoryMonitor. */
+export interface MonitorOptions {
+    /** How often to check health (ms). Default: 60000 (1 min) */
+    intervalMs?: number;
+    /** Minimum score before triggering onDegraded. Default: 70 */
+    degradedThreshold?: number;
+    /** Minimum score before triggering onUnhealthy. Default: 40 */
+    unhealthyThreshold?: number;
+    /** Callback when score drops below degradedThreshold */
+    onDegraded?: (score: HealthScore, server: string) => void;
+    /** Callback when score drops below unhealthyThreshold */
+    onUnhealthy?: (score: HealthScore, server: string) => void;
+    /** Callback when score recovers above degradedThreshold */
+    onRecovered?: (score: HealthScore, server: string) => void;
+    /** Optional: report scores to a remote endpoint */
+    reportTo?: string;
+    /** Custom score weights */
+    weights?: Partial<ScoreWeights>;
+}
+export type ServerStatus = "healthy" | "degraded" | "unhealthy" | "unknown";
+/** Represents a server being monitored with its current state and history. */
+export interface MonitoredServer {
+    targetId: string;
+    lastScore?: HealthScore;
+    lastCheck?: Date;
+    status: ServerStatus;
+    history: Array<{
+        timestamp: Date;
+        score: number;
+        grade: HealthGrade;
+    }>;
+}
+/**
+ * Real-time monitor for MCP server health.
+ *
+ * Uses `runTarget()` and `computeHealthScore()` under the hood to periodically
+ * check servers and fire callbacks when health changes.
+ */
+export declare class ObservatoryMonitor extends EventEmitter {
+    private readonly servers;
+    private readonly options;
+    private timer;
+    private disposed;
+    constructor(options?: MonitorOptions);
+    /** Add a server to monitor. */
+    addServer(target: TargetConfig): void;
+    /** Remove a server from monitoring. */
+    removeServer(targetId: string): void;
+    /** Get current status of all monitored servers. */
+    getStatus(): MonitoredServer[];
+    /** Get status of a specific server. */
+    getServerStatus(targetId: string): MonitoredServer | undefined;
+    /** Run an immediate health check on all servers. */
+    checkNow(): Promise<Map<string, HealthScore>>;
+    /** Start periodic monitoring. */
+    start(): void;
+    /** Stop periodic monitoring. */
+    stop(): void;
+    /** Dispose and clean up. */
+    dispose(): void;
+    private checkServer;
+    private classifyScore;
+    private fireCallbacks;
+    private reportScore;
+}

package/dist/src/runtime/monitor.js

@@ -0,0 +1,162 @@
+import { EventEmitter } from "node:events";
+import { runTarget } from "../runner.js";
+import { computeHealthScore } from "../score.js";
+const MAX_HISTORY = 100;
+const DEFAULT_INTERVAL_MS = 60_000;
+const DEFAULT_DEGRADED_THRESHOLD = 70;
+const DEFAULT_UNHEALTHY_THRESHOLD = 40;
+/**
+ * Real-time monitor for MCP server health.
+ *
+ * Uses `runTarget()` and `computeHealthScore()` under the hood to periodically
+ * check servers and fire callbacks when health changes.
+ */
+export class ObservatoryMonitor extends EventEmitter {
+    servers = new Map();
+    options;
+    timer = null;
+    disposed = false;
+    constructor(options) {
+        super();
+        this.options = {
+            intervalMs: options?.intervalMs ?? DEFAULT_INTERVAL_MS,
+            degradedThreshold: options?.degradedThreshold ?? DEFAULT_DEGRADED_THRESHOLD,
+            unhealthyThreshold: options?.unhealthyThreshold ?? DEFAULT_UNHEALTHY_THRESHOLD,
+            ...options,
+        };
+    }
+    /** Add a server to monitor. */
+    addServer(target) {
+        if (this.disposed)
+            return;
+        if (this.servers.has(target.targetId))
+            return;
+        const state = {
+            targetId: target.targetId,
+            status: "unknown",
+            history: [],
+        };
+        this.servers.set(target.targetId, { target, state });
+        this.emit("serverAdded", target.targetId);
+    }
+    /** Remove a server from monitoring. */
+    removeServer(targetId) {
+        this.servers.delete(targetId);
+        this.emit("serverRemoved", targetId);
+    }
+    /** Get current status of all monitored servers. */
+    getStatus() {
+        return [...this.servers.values()].map((e) => ({ ...e.state }));
+    }
+    /** Get status of a specific server. */
+    getServerStatus(targetId) {
+        const entry = this.servers.get(targetId);
+        return entry ? { ...entry.state } : undefined;
+    }
+    /** Run an immediate health check on all servers. */
+    async checkNow() {
+        const results = new Map();
+        const entries = [...this.servers.values()];
+        await Promise.all(entries.map(async (entry) => {
+            const score = await this.checkServer(entry);
+            if (score) {
+                results.set(entry.target.targetId, score);
+            }
+        }));
+        return results;
+    }
+    /** Start periodic monitoring. */
+    start() {
+        if (this.disposed || this.timer !== null)
+            return;
+        this.timer = setInterval(() => {
+            void this.checkNow();
+        }, this.options.intervalMs);
+        this.emit("started");
+    }
+    /** Stop periodic monitoring. */
+    stop() {
+        if (this.timer !== null) {
+            clearInterval(this.timer);
+            this.timer = null;
+            this.emit("stopped");
+        }
+    }
+    /** Dispose and clean up. */
+    dispose() {
+        this.stop();
+        this.disposed = true;
+        this.servers.clear();
+        this.removeAllListeners();
+    }
+    // ---- internal ----
+    async checkServer(entry) {
+        const { target, state } = entry;
+        const previousStatus = state.status;
+        try {
+            const artifact = await runTarget(target);
+            const score = artifact.healthScore ??
+                computeHealthScore(artifact.checks, artifact.performanceMetrics, this.options.weights);
+            state.lastScore = score;
+            state.lastCheck = new Date();
+            // Append to history (capped at MAX_HISTORY)
+            state.history.push({
+                timestamp: state.lastCheck,
+                score: score.overall,
+                grade: score.grade,
+            });
+            if (state.history.length > MAX_HISTORY) {
+                state.history.splice(0, state.history.length - MAX_HISTORY);
+            }
+            // Determine new status
+            const newStatus = this.classifyScore(score.overall);
+            state.status = newStatus;
+            // Fire callbacks
+            this.fireCallbacks(previousStatus, newStatus, score, target.targetId);
+            // Report if configured
+            if (this.options.reportTo) {
+                void this.reportScore(score, target.targetId).catch(() => {
+                    /* best-effort */
+                });
+            }
+            this.emit("check", target.targetId, score);
+            return score;
+        }
+        catch {
+            state.status = "unhealthy";
+            state.lastCheck = new Date();
+            this.emit("checkError", target.targetId);
+            return undefined;
+        }
+    }
+    classifyScore(overall) {
+        if (overall >= this.options.degradedThreshold)
+            return "healthy";
+        if (overall >= this.options.unhealthyThreshold)
+            return "degraded";
+        return "unhealthy";
+    }
+    fireCallbacks(previousStatus, newStatus, score, targetId) {
+        if (newStatus === "degraded" && previousStatus !== "degraded") {
+            this.options.onDegraded?.(score, targetId);
+        }
+        if (newStatus === "unhealthy" && previousStatus !== "unhealthy") {
+            this.options.onUnhealthy?.(score, targetId);
+        }
+        if (newStatus === "healthy" &&
+            (previousStatus === "degraded" || previousStatus === "unhealthy")) {
+            this.options.onRecovered?.(score, targetId);
+        }
+    }
+    async reportScore(score, targetId) {
+        const url = this.options.reportTo;
+        if (!url)
+            return;
+        await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ targetId, score, timestamp: new Date().toISOString() }),
+        });
+    }
+}
+//# sourceMappingURL=monitor.js.map

package/dist/src/runtime/monitor.js.map

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

package/dist/src/runtime/wrapper.d.ts

@@ -0,0 +1,28 @@
+import type { TargetConfig } from "../types.js";
+import { ObservatoryMonitor } from "./monitor.js";
+import type { MonitorOptions } from "./monitor.js";
+/** Options for the Observatory wrapper, extending monitor options with fallback support. */
+export interface WrapperOptions extends MonitorOptions {
+    /** Automatically switch to fallback server if primary degrades */
+    fallbackTargets?: TargetConfig[];
+}
+/**
+ * Wrap a target with observatory monitoring.
+ *
+ * Returns an `ObservatoryMonitor` instance pre-configured with the target and
+ * optional fallback targets. The monitor is NOT started automatically; call
+ * `.monitor.start()` when ready.
+ *
+ * @example
+ * ```ts
+ * const { monitor, target } = withObservatory(
+ *   { targetId: "my-server", adapter: "http", url: "http://localhost:3000" },
+ *   { intervalMs: 30_000, onDegraded: (score) => console.warn("degraded", score) }
+ * );
+ * monitor.start();
+ * ```
+ */
+export declare function withObservatory(target: TargetConfig, options?: WrapperOptions): {
+    monitor: ObservatoryMonitor;
+    target: TargetConfig;
+};

package/dist/src/runtime/wrapper.js

@@ -0,0 +1,30 @@
+import { ObservatoryMonitor } from "./monitor.js";
+/**
+ * Wrap a target with observatory monitoring.
+ *
+ * Returns an `ObservatoryMonitor` instance pre-configured with the target and
+ * optional fallback targets. The monitor is NOT started automatically; call
+ * `.monitor.start()` when ready.
+ *
+ * @example
+ * ```ts
+ * const { monitor, target } = withObservatory(
+ *   { targetId: "my-server", adapter: "http", url: "http://localhost:3000" },
+ *   { intervalMs: 30_000, onDegraded: (score) => console.warn("degraded", score) }
+ * );
+ * monitor.start();
+ * ```
+ */
+export function withObservatory(target, options) {
+    const monitor = new ObservatoryMonitor(options);
+    // Add the primary target
+    monitor.addServer(target);
+    // Add any fallback targets
+    if (options?.fallbackTargets) {
+        for (const fallback of options.fallbackTargets) {
+            monitor.addServer(fallback);
+        }
+    }
+    return { monitor, target };
+}
+//# sourceMappingURL=wrapper.js.map

package/dist/src/runtime/wrapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.js","sourceRoot":"","sources":["../../../src/runtime/wrapper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AASlD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAoB,EACpB,OAAwB;IAExB,MAAM,OAAO,GAAG,IAAI,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAEhD,yBAAyB;IACzB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAE1B,2BAA2B;IAC3B,IAAI,OAAO,EAAE,eAAe,EAAE,CAAC;QAC7B,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;YAC/C,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC"}