clawconnect-agent 0.1.0

package/dist/platform/service-manager-linux.js

@@ -0,0 +1,229 @@
+import { commandExists, ensureLogDir, ERROR_LOG_PATH, getProgramArgs, LINUX_NOHUP_PID_PATH, LINUX_NOHUP_START_SCRIPT_PATH, LINUX_SERVICE_NAME, LINUX_SERVICE_PATH, LINUX_SYSTEMD_USER_DIR, LOG_DIR, LOG_PATH, run, shellEscape, } from "./service-manager-common.js";
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "fs";
+function canUseSystemdUser() {
+    if (!commandExists("systemctl"))
+        return false;
+    try {
+        run("systemctl --user show-environment", "pipe");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function isPidRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readNohupPid() {
+    if (!existsSync(LINUX_NOHUP_PID_PATH))
+        return null;
+    try {
+        const raw = readFileSync(LINUX_NOHUP_PID_PATH, "utf-8").trim();
+        const pid = Number(raw);
+        return Number.isInteger(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+function removeNohupPidFile() {
+    if (existsSync(LINUX_NOHUP_PID_PATH)) {
+        unlinkSync(LINUX_NOHUP_PID_PATH);
+    }
+}
+function getNohupStartCommand() {
+    return `bash ${shellEscape(LINUX_NOHUP_START_SCRIPT_PATH)}`;
+}
+function writeLinuxNohupStartScript() {
+    const args = getProgramArgs().map(shellEscape).join(" ");
+    const script = `#!/usr/bin/env bash
+set -euo pipefail
+
+mkdir -p ${shellEscape(LOG_DIR)}
+if [ -f ${shellEscape(LINUX_NOHUP_PID_PATH)} ]; then
+  pid="$(cat ${shellEscape(LINUX_NOHUP_PID_PATH)} 2>/dev/null || true)"
+  if [ -n "$pid" ] && kill -0 "$pid" 2>/dev/null; then
+    echo "clawconnect is already running (pid=$pid)"
+    exit 0
+  fi
+fi
+
+nohup ${args} >> ${shellEscape(LOG_PATH)} 2>> ${shellEscape(ERROR_LOG_PATH)} < /dev/null &
+echo $! > ${shellEscape(LINUX_NOHUP_PID_PATH)}
+echo "clawconnect started in nohup mode (pid=$(cat ${shellEscape(LINUX_NOHUP_PID_PATH)}))"
+`;
+    writeFileSync(LINUX_NOHUP_START_SCRIPT_PATH, script, { encoding: "utf-8", mode: 0o755 });
+}
+function installLinuxServiceSystemd() {
+    mkdirSync(LINUX_SYSTEMD_USER_DIR, { recursive: true });
+    ensureLogDir();
+    const args = getProgramArgs().map(shellEscape).join(" ");
+    const serviceContent = `[Unit]
+Description=ClawConnect host agent
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+ExecStart=${args}
+Restart=always
+RestartSec=5
+WorkingDirectory=${shellEscape(process.cwd())}
+StandardOutput=append:${LOG_PATH}
+StandardError=append:${ERROR_LOG_PATH}
+
+[Install]
+WantedBy=default.target
+`;
+    writeFileSync(LINUX_SERVICE_PATH, serviceContent, "utf-8");
+    run("systemctl --user daemon-reload", "inherit");
+    run(`systemctl --user enable --now ${LINUX_SERVICE_NAME}`, "inherit");
+    return true;
+}
+function installLinuxServiceNohup() {
+    ensureLogDir();
+    writeLinuxNohupStartScript();
+    run(`sh -lc ${shellEscape(getNohupStartCommand())}`, "inherit");
+    const pid = readNohupPid();
+    return pid != null && isPidRunning(pid);
+}
+export function installLinuxService() {
+    if (canUseSystemdUser()) {
+        try {
+            return installLinuxServiceSystemd();
+        }
+        catch {
+            // Fall back to nohup below.
+        }
+    }
+    try {
+        return installLinuxServiceNohup();
+    }
+    catch {
+        return false;
+    }
+}
+function uninstallLinuxArtifacts(removeFile) {
+    let changed = false;
+    if (canUseSystemdUser()) {
+        try {
+            run(`systemctl --user stop ${LINUX_SERVICE_NAME}`);
+            changed = true;
+        }
+        catch {
+            // ignore
+        }
+        try {
+            run(`systemctl --user disable ${LINUX_SERVICE_NAME}`);
+            changed = true;
+        }
+        catch {
+            // ignore
+        }
+        try {
+            run("systemctl --user daemon-reload");
+        }
+        catch {
+            // ignore
+        }
+    }
+    const nohupPid = readNohupPid();
+    if (nohupPid != null) {
+        try {
+            process.kill(nohupPid, "SIGTERM");
+            changed = true;
+        }
+        catch {
+            // ignore
+        }
+        removeNohupPidFile();
+        changed = true;
+    }
+    if (removeFile && existsSync(LINUX_SERVICE_PATH)) {
+        unlinkSync(LINUX_SERVICE_PATH);
+        changed = true;
+    }
+    if (removeFile && existsSync(LINUX_NOHUP_START_SCRIPT_PATH)) {
+        unlinkSync(LINUX_NOHUP_START_SCRIPT_PATH);
+        changed = true;
+    }
+    return changed;
+}
+export function stopLinuxService() {
+    return uninstallLinuxArtifacts(false);
+}
+export function uninstallLinuxService() {
+    return uninstallLinuxArtifacts(true);
+}
+export function restartLinuxService() {
+    if (canUseSystemdUser() && existsSync(LINUX_SERVICE_PATH)) {
+        try {
+            run("systemctl --user daemon-reload", "inherit");
+            run(`systemctl --user restart ${LINUX_SERVICE_NAME}`, "inherit");
+            return true;
+        }
+        catch {
+            // Fall back to nohup restart below.
+        }
+    }
+    uninstallLinuxArtifacts(false);
+    try {
+        return installLinuxServiceNohup();
+    }
+    catch {
+        return false;
+    }
+}
+export function getLinuxServiceStatus() {
+    const buildNohupStatus = (installed, running) => ({
+        platform: "linux",
+        installed,
+        running,
+        serviceName: "clawconnect (nohup)",
+        manager: "nohup",
+        servicePath: existsSync(LINUX_NOHUP_START_SCRIPT_PATH) ? LINUX_NOHUP_START_SCRIPT_PATH : undefined,
+        logPath: LOG_PATH,
+        startHint: getNohupStartCommand(),
+    });
+    const isSystemdActive = () => {
+        if (!canUseSystemdUser())
+            return false;
+        try {
+            run(`systemctl --user is-active --quiet ${LINUX_SERVICE_NAME}`);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    const pid = readNohupPid();
+    const hasNohupArtifacts = pid != null || existsSync(LINUX_NOHUP_START_SCRIPT_PATH);
+    const running = pid != null && isPidRunning(pid);
+    if (!running && pid != null) {
+        removeNohupPidFile();
+    }
+    if (running || (hasNohupArtifacts && !canUseSystemdUser())) {
+        return buildNohupStatus(hasNohupArtifacts, running);
+    }
+    const hasSystemdServiceFile = existsSync(LINUX_SERVICE_PATH);
+    if (hasSystemdServiceFile) {
+        return {
+            platform: "linux",
+            installed: true,
+            running: isSystemdActive(),
+            serviceName: LINUX_SERVICE_NAME,
+            manager: "systemd",
+            servicePath: LINUX_SERVICE_PATH,
+            logPath: LOG_PATH,
+            startHint: `systemctl --user start ${LINUX_SERVICE_NAME}`,
+        };
+    }
+    return buildNohupStatus(hasNohupArtifacts, running);
+}
+//# sourceMappingURL=service-manager-linux.js.map

package/dist/platform/service-manager-linux.js.map

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

package/dist/platform/service-manager.d.ts

@@ -0,0 +1,16 @@
+import type { ServicePlatform, ServiceStatus } from "./service-manager-common.js";
+export type { ServicePlatform, ServiceStatus } from "./service-manager-common.js";
+export declare function getServicePlatform(): ServicePlatform;
+export declare function installService(): boolean;
+export declare function restartService(): boolean;
+export declare function stopService(): boolean;
+export declare function uninstallService(): boolean;
+export declare function getServiceStatus(): ServiceStatus;
+export declare const servicePaths: {
+    logPath: string;
+    errorLogPath: string;
+    macPlistPath: string;
+    linuxServicePath: string;
+    linuxNohupPidPath: string;
+    linuxNohupStartScriptPath: string;
+};

package/dist/platform/service-manager.js

@@ -0,0 +1,165 @@
+import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+import { detectPlatform, ensureLogDir, ERROR_LOG_PATH, getProgramArgs, LINUX_NOHUP_PID_PATH, LINUX_NOHUP_START_SCRIPT_PATH, LINUX_SERVICE_PATH, LOG_PATH, run, } from "./service-manager-common.js";
+import { getLinuxServiceStatus, installLinuxService, restartLinuxService, stopLinuxService, uninstallLinuxService, } from "./service-manager-linux.js";
+const MAC_LABEL = "com.openclaw.clawconnect.agent";
+const MAC_LABEL_OLD = "com.rethinkingstudio.clawpilot";
+const MAC_PLIST_DIR = join(homedir(), "Library", "LaunchAgents");
+const MAC_PLIST_PATH = join(MAC_PLIST_DIR, `${MAC_LABEL}.plist`);
+const MAC_PLIST_PATH_OLD = join(MAC_PLIST_DIR, `${MAC_LABEL_OLD}.plist`);
+function installMacService() {
+    const argsXml = getProgramArgs().map((arg) => `    <string>${arg}</string>`).join("\n");
+    const plistContent = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${MAC_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${argsXml}
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${LOG_PATH}</string>
+  <key>StandardErrorPath</key>
+  <string>${ERROR_LOG_PATH}</string>
+</dict>
+</plist>`;
+    mkdirSync(MAC_PLIST_DIR, { recursive: true });
+    ensureLogDir();
+    try {
+        run(`launchctl unload -w "${MAC_PLIST_PATH}"`);
+    }
+    catch {
+        // Ignore if not loaded.
+    }
+    writeFileSync(MAC_PLIST_PATH, plistContent, "utf-8");
+    try {
+        run(`launchctl load -w "${MAC_PLIST_PATH}"`, "inherit");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function uninstallMacArtifacts() {
+    let changed = false;
+    try {
+        run(`launchctl unload -w "${MAC_PLIST_PATH}"`);
+        changed = true;
+    }
+    catch {
+        // ignore
+    }
+    if (existsSync(MAC_PLIST_PATH)) {
+        unlinkSync(MAC_PLIST_PATH);
+        changed = true;
+    }
+    try {
+        run(`launchctl unload -w "${MAC_PLIST_PATH_OLD}"`);
+        changed = true;
+    }
+    catch {
+        // ignore
+    }
+    if (existsSync(MAC_PLIST_PATH_OLD)) {
+        unlinkSync(MAC_PLIST_PATH_OLD);
+        changed = true;
+    }
+    return changed;
+}
+function restartMacService() {
+    return installMacService();
+}
+export function getServicePlatform() {
+    return detectPlatform();
+}
+export function installService() {
+    switch (detectPlatform()) {
+        case "macos":
+            return installMacService();
+        case "linux":
+            return installLinuxService();
+        default:
+            return false;
+    }
+}
+export function restartService() {
+    switch (detectPlatform()) {
+        case "macos":
+            return restartMacService();
+        case "linux":
+            return restartLinuxService();
+        default:
+            return false;
+    }
+}
+export function stopService() {
+    switch (detectPlatform()) {
+        case "macos":
+            return uninstallMacArtifacts();
+        case "linux":
+            return stopLinuxService();
+        default:
+            return false;
+    }
+}
+export function uninstallService() {
+    switch (detectPlatform()) {
+        case "macos":
+            return uninstallMacArtifacts();
+        case "linux":
+            return uninstallLinuxService();
+        default:
+            return false;
+    }
+}
+export function getServiceStatus() {
+    const platform = detectPlatform();
+    if (platform === "macos") {
+        let running = false;
+        try {
+            run(`launchctl list ${MAC_LABEL}`);
+            running = true;
+        }
+        catch {
+            running = false;
+        }
+        return {
+            platform,
+            installed: existsSync(MAC_PLIST_PATH),
+            running,
+            serviceName: MAC_LABEL,
+            manager: "launchd",
+            servicePath: MAC_PLIST_PATH,
+            logPath: LOG_PATH,
+            startHint: `launchctl start ${MAC_LABEL}`,
+        };
+    }
+    if (platform === "linux") {
+        return getLinuxServiceStatus();
+    }
+    return {
+        platform,
+        installed: false,
+        running: false,
+        serviceName: "",
+        manager: "unsupported",
+        logPath: LOG_PATH,
+    };
+}
+export const servicePaths = {
+    logPath: LOG_PATH,
+    errorLogPath: ERROR_LOG_PATH,
+    macPlistPath: MAC_PLIST_PATH,
+    linuxServicePath: LINUX_SERVICE_PATH,
+    linuxNohupPidPath: LINUX_NOHUP_PID_PATH,
+    linuxNohupStartScriptPath: LINUX_NOHUP_START_SCRIPT_PATH,
+};
+//# sourceMappingURL=service-manager.js.map

package/dist/platform/service-manager.js.map

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

package/dist/relay/attachment-staging.d.ts

@@ -0,0 +1,12 @@
+export interface RelayAttachmentLike {
+    fileName?: unknown;
+    name?: unknown;
+    filename?: unknown;
+    mimeType?: unknown;
+    contentType?: unknown;
+    type?: unknown;
+}
+export declare function resolveAttachmentMimeType(attachment: RelayAttachmentLike): string;
+export declare function resolveAttachmentFileName(attachment: RelayAttachmentLike): string;
+export declare function buildAttachmentStagingPath(attachment: RelayAttachmentLike, outboundDir: string, uniqueId?: string): string;
+export declare function extensionForMimeType(mimeType: string): string;

package/dist/relay/attachment-staging.js

@@ -0,0 +1,116 @@
+import { basename, extname, join } from "node:path";
+import { randomUUID } from "node:crypto";
+export function resolveAttachmentMimeType(attachment) {
+    const rawMimeType = firstString(attachment.mimeType, attachment.contentType, attachment.type);
+    return rawMimeType || "application/octet-stream";
+}
+export function resolveAttachmentFileName(attachment) {
+    const mimeType = resolveAttachmentMimeType(attachment).toLowerCase();
+    const originalName = sanitizeFileName(firstString(attachment.fileName, attachment.name, attachment.filename));
+    if (originalName) {
+        if (extname(originalName)) {
+            return originalName;
+        }
+        return `${originalName}${extensionForMimeType(mimeType)}`;
+    }
+    return `attachment${extensionForMimeType(mimeType)}`;
+}
+export function buildAttachmentStagingPath(attachment, outboundDir, uniqueId = randomUUID()) {
+    return join(outboundDir, uniqueId, resolveAttachmentFileName(attachment));
+}
+export function extensionForMimeType(mimeType) {
+    const normalized = mimeType.trim().toLowerCase();
+    if (!normalized) {
+        return ".bin";
+    }
+    if (normalized === "image/png")
+        return ".png";
+    if (normalized === "image/jpeg" || normalized === "image/jpg")
+        return ".jpg";
+    if (normalized === "image/gif")
+        return ".gif";
+    if (normalized === "image/webp")
+        return ".webp";
+    if (normalized === "image/heic")
+        return ".heic";
+    if (normalized === "image/heif")
+        return ".heif";
+    if (normalized === "image/bmp")
+        return ".bmp";
+    if (normalized === "image/avif")
+        return ".avif";
+    if (normalized === "image/svg+xml")
+        return ".svg";
+    if (normalized === "video/mp4")
+        return ".mp4";
+    if (normalized === "video/quicktime")
+        return ".mov";
+    if (normalized === "video/webm")
+        return ".webm";
+    if (normalized === "audio/mpeg")
+        return ".mp3";
+    if (normalized === "audio/mp4")
+        return ".m4a";
+    if (normalized === "audio/aac")
+        return ".aac";
+    if (normalized === "audio/wav" || normalized === "audio/x-wav")
+        return ".wav";
+    if (normalized === "application/pdf")
+        return ".pdf";
+    if (normalized === "application/msword")
+        return ".doc";
+    if (normalized === "application/vnd.openxmlformats-officedocument.wordprocessingml.document")
+        return ".docx";
+    if (normalized === "application/vnd.ms-powerpoint")
+        return ".ppt";
+    if (normalized === "application/vnd.openxmlformats-officedocument.presentationml.presentation")
+        return ".pptx";
+    if (normalized === "application/vnd.ms-excel")
+        return ".xls";
+    if (normalized === "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet")
+        return ".xlsx";
+    if (normalized === "application/zip")
+        return ".zip";
+    if (normalized === "application/gzip")
+        return ".gz";
+    if (normalized === "application/x-tar")
+        return ".tar";
+    if (normalized === "application/vnd.rar")
+        return ".rar";
+    if (normalized === "application/x-apple-diskimage")
+        return ".dmg";
+    if (normalized === "application/json")
+        return ".json";
+    if (normalized === "text/plain")
+        return ".txt";
+    if (normalized.startsWith("image/"))
+        return ".bin";
+    if (normalized.startsWith("video/"))
+        return ".bin";
+    if (normalized.startsWith("audio/"))
+        return ".bin";
+    return ".bin";
+}
+function sanitizeFileName(value) {
+    const trimmed = firstString(value)?.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    const normalizedSeparators = trimmed.replace(/\\/g, "/");
+    const leaf = basename(normalizedSeparators)
+        .replace(/[\u0000-\u001f\u007f]/g, "")
+        .trim();
+    return leaf || undefined;
+}
+function firstString(...values) {
+    for (const value of values) {
+        if (typeof value === "string") {
+            const trimmed = value.trim();
+            if (trimmed) {
+                return trimmed;
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=attachment-staging.js.map

package/dist/relay/attachment-staging.js.map

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

package/dist/relay/chat-history.d.ts

@@ -0,0 +1,29 @@
+export type HistoryMessage = {
+    role?: string;
+    content?: Array<{
+        type?: string;
+        text?: string;
+    }>;
+    timestamp?: number;
+    stopReason?: string;
+    errorMessage?: string;
+};
+export type HistoryResponse = {
+    sessionKey?: string;
+    sessionId?: string;
+    messages?: HistoryMessage[];
+};
+export type ChatHistoryOutcome = {
+    kind: "final";
+    text: string;
+} | {
+    kind: "error";
+    errorMessage: string;
+} | null;
+export type ChatRunContext = {
+    sessionKey: string;
+    requestedAtMs: number;
+    promptText?: string;
+};
+export declare function extractHistoryOutcome(history: HistoryResponse | undefined, context: ChatRunContext): ChatHistoryOutcome;
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, label: string): Promise<T>;

package/dist/relay/chat-history.js

@@ -0,0 +1,69 @@
+export function extractHistoryOutcome(history, context) {
+    const messages = history?.messages ?? [];
+    if (messages.length === 0) {
+        return null;
+    }
+    const userIndex = findHistoryUserIndex(messages, context);
+    if (userIndex === -1) {
+        return null;
+    }
+    let latestError = null;
+    for (let index = userIndex + 1; index < messages.length; index += 1) {
+        const message = messages[index];
+        if (message.role !== "assistant") {
+            continue;
+        }
+        const text = extractHistoryMessageText(message);
+        if (text.length > 0) {
+            return { kind: "final", text };
+        }
+        if (typeof message.errorMessage === "string" &&
+            message.errorMessage.trim().length > 0 &&
+            (message.stopReason === "error" || !message.stopReason)) {
+            latestError = message.errorMessage.trim();
+        }
+    }
+    return latestError ? { kind: "error", errorMessage: latestError } : null;
+}
+export async function withTimeout(promise, timeoutMs, label) {
+    return await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new Error(`${label} timeout after ${timeoutMs}ms`)), timeoutMs);
+        promise
+            .then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        })
+            .catch((error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+function extractHistoryMessageText(message) {
+    const content = Array.isArray(message?.content) ? message.content : [];
+    const parts = content
+        .filter((block) => block?.type === "text" && typeof block.text === "string")
+        .map((block) => block.text?.trim() ?? "")
+        .filter((text) => text.length > 0);
+    return parts.join("\n\n");
+}
+function findHistoryUserIndex(messages, context) {
+    const normalizedPrompt = context.promptText?.trim();
+    const notBeforeMs = context.requestedAtMs - 1_000;
+    for (let index = messages.length - 1; index >= 0; index -= 1) {
+        const message = messages[index];
+        if (message.role !== "user") {
+            continue;
+        }
+        const timestamp = typeof message.timestamp === "number" ? message.timestamp : Number.NaN;
+        if (Number.isFinite(timestamp) && timestamp < notBeforeMs) {
+            continue;
+        }
+        const text = extractHistoryMessageText(message);
+        if (!normalizedPrompt || text === normalizedPrompt) {
+            return index;
+        }
+    }
+    return -1;
+}
+//# sourceMappingURL=chat-history.js.map

package/dist/relay/chat-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-history.js","sourceRoot":"","sources":["../../src/relay/chat-history.ts"],"names":[],"mappings":"AAyBA,MAAM,UAAU,qBAAqB,CACnC,OAAoC,EACpC,OAAuB;IAEvB,MAAM,QAAQ,GAAG,OAAO,EAAE,QAAQ,IAAI,EAAE,CAAC;IACzC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,SAAS,GAAG,oBAAoB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1D,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,WAAW,GAAkB,IAAI,CAAC;IACtC,KAAK,IAAI,KAAK,GAAG,SAAS,GAAG,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpE,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC;QACD,IACE,OAAO,OAAO,CAAC,YAAY,KAAK,QAAQ;YACxC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YACtC,CAAC,OAAO,CAAC,UAAU,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EACvD,CAAC;YACD,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,OAAO,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3E,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,OAAmB,EAAE,SAAiB,EAAE,KAAa;IACxF,OAAO,MAAM,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9C,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,KAAK,kBAAkB,SAAS,IAAI,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACtG,OAAO;aACJ,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;YACd,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,yBAAyB,CAAC,OAAmC;IACpE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACvE,MAAM,KAAK,GAAG,OAAO;SAClB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,KAAK,MAAM,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC;SAC3E,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;SACxC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACrC,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,oBAAoB,CAAC,QAA0B,EAAE,OAAuB;IAC/E,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC;IACpD,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,GAAG,KAAK,CAAC;IAElD,KAAK,IAAI,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC7D,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACzF,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,GAAG,WAAW,EAAE,CAAC;YAC1D,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAChD,IAAI,CAAC,gBAAgB,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,OAAO,CAAC,CAAC,CAAC;AACZ,CAAC"}