@aight-cool/aight-utils 0.1.20 → 0.1.22

package/dist/src/items.js

@@ -0,0 +1,208 @@
+/**
+ * Items Store — aight.items.list, aight.items.upsert, aight.items.delete + aight_item tool
+ */
+import { Type } from "@sinclair/typebox";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+// ── Types ──
+export const ItemType = Type.Union([
+    Type.Literal("trigger"),
+    Type.Literal("item"),
+    Type.Literal("process"),
+]);
+export const ItemStatus = Type.Union([
+    Type.Literal("active"),
+    Type.Literal("done"),
+    Type.Literal("fired"),
+    Type.Literal("cancelled"),
+    Type.Literal("deleted"),
+]);
+export const ItemSchema = Type.Object({
+    id: Type.String({ description: "Unique item ID" }),
+    type: ItemType,
+    title: Type.String({ description: "Display title" }),
+    status: Type.Optional(ItemStatus),
+    labels: Type.Optional(Type.Array(Type.String())),
+    scheduledFor: Type.Optional(Type.String({ description: "ISO 8601 datetime for triggers" })),
+    description: Type.Optional(Type.String()),
+    url: Type.Optional(Type.String({ description: "Related URL (PR, issue, etc.)" })),
+    metadata: Type.Optional(Type.Record(Type.String(), Type.Unknown())),
+    createdAt: Type.Optional(Type.String()),
+    updatedAt: Type.Optional(Type.String()),
+});
+// ── Store ──
+const STORE_DIR = path.join(os.homedir(), ".openclaw", "aight");
+const STORE_FILE = path.join(STORE_DIR, "items.json");
+export function loadItems() {
+    try {
+        if (!fs.existsSync(STORE_FILE))
+            return [];
+        const raw = fs.readFileSync(STORE_FILE, "utf-8");
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+export function saveItems(items) {
+    fs.mkdirSync(STORE_DIR, { recursive: true });
+    fs.writeFileSync(STORE_FILE, JSON.stringify(items, null, 2), { encoding: "utf-8", mode: 0o600 });
+}
+const MAX_TITLE_LEN = 500;
+const MAX_DESC_LEN = 5000;
+const MAX_ITEMS = 10000;
+export function upsertItem(item) {
+    if (item.title && item.title.length > MAX_TITLE_LEN) {
+        throw new Error(`title exceeds max length of ${MAX_TITLE_LEN}`);
+    }
+    if (item.description && item.description.length > MAX_DESC_LEN) {
+        throw new Error(`description exceeds max length of ${MAX_DESC_LEN}`);
+    }
+    const items = loadItems();
+    const now = new Date().toISOString();
+    const idx = items.findIndex((i) => i.id === item.id);
+    if (idx < 0 && items.length >= MAX_ITEMS) {
+        throw new Error(`item store full (max ${MAX_ITEMS})`);
+    }
+    const merged = {
+        ...item,
+        status: item.status ?? "active",
+        updatedAt: now,
+        createdAt: idx >= 0 ? items[idx].createdAt : now,
+    };
+    if (idx >= 0) {
+        items[idx] = merged;
+    }
+    else {
+        items.push(merged);
+    }
+    saveItems(items);
+    return merged;
+}
+export function deleteItem(id) {
+    const items = loadItems();
+    const idx = items.findIndex((i) => i.id === id);
+    if (idx < 0)
+        return false;
+    items[idx] = { ...items[idx], status: "deleted", updatedAt: new Date().toISOString() };
+    saveItems(items);
+    return true;
+}
+export function listItems(filters = {}) {
+    let items = loadItems().filter((i) => i.status !== "deleted");
+    if (filters.type) {
+        items = items.filter((i) => i.type === filters.type);
+    }
+    if (filters.status) {
+        items = items.filter((i) => i.status === filters.status);
+    }
+    if (filters.labels && filters.labels.length > 0) {
+        items = items.filter((i) => filters.labels.some((l) => i.labels?.includes(l)));
+    }
+    if (filters.from) {
+        const fromTs = new Date(filters.from).getTime();
+        items = items.filter((i) => {
+            if (!i.scheduledFor)
+                return true;
+            return new Date(i.scheduledFor).getTime() >= fromTs;
+        });
+    }
+    if (filters.to) {
+        const toTs = new Date(filters.to).getTime();
+        items = items.filter((i) => {
+            if (!i.scheduledFor)
+                return true;
+            return new Date(i.scheduledFor).getTime() <= toTs;
+        });
+    }
+    return items;
+}
+// ── Tool schema ──
+export const AightItemToolParams = Type.Object({
+    action: Type.Union([Type.Literal("create"), Type.Literal("update"), Type.Literal("delete")]),
+    item: Type.Optional(ItemSchema),
+    id: Type.Optional(Type.String({ description: "Item ID (for delete)" })),
+});
+// ── Registration ──
+/** Strip heavy fields for list responses — detail is fetched via aight.items.get */
+function toLightItem(item) {
+    const { description: _d, metadata: _m, url: _u, ...light } = item;
+    return light;
+}
+export function registerItems(api) {
+    api.registerGatewayMethod("aight.items.list", ({ params, respond }) => {
+        const filters = params && typeof params === "object" ? params : {};
+        respond(true, { items: listItems(filters).map(toLightItem) });
+    });
+    api.registerGatewayMethod("aight.items.get", ({ params, respond }) => {
+        const id = typeof params?.id === "string" ? params.id : "";
+        if (!id) {
+            respond(false, { error: "id required" });
+            return;
+        }
+        const all = loadItems();
+        const item = all.find((i) => i.id === id);
+        if (!item || item.status === "deleted") {
+            respond(false, { error: "item not found" });
+            return;
+        }
+        respond(true, { item });
+    });
+    api.registerGatewayMethod("aight.items.upsert", ({ params, respond }) => {
+        if (!params ||
+            typeof params !== "object" ||
+            !("id" in params) ||
+            !("type" in params) ||
+            !("title" in params)) {
+            respond(false, { error: "item must have id, type, and title" });
+            return;
+        }
+        const item = upsertItem(params);
+        respond(true, { item });
+    });
+    api.registerGatewayMethod("aight.items.delete", ({ params, respond }) => {
+        const id = typeof params?.id === "string" ? params.id : "";
+        if (!id) {
+            respond(false, { error: "id required" });
+            return;
+        }
+        const ok = deleteItem(id);
+        respond(true, { ok, id });
+    });
+    api.registerTool({
+        name: "aight_item",
+        label: "Aight Item",
+        description: "Create, update, or delete a structured item in the Aight Today view. " +
+            "Use for reminders, tasks, events, deadlines, and process tracking. " +
+            "Parse natural language dates/times before calling (e.g. 'tomorrow at 3pm' → ISO 8601).",
+        parameters: AightItemToolParams,
+        async execute(_toolCallId, params) {
+            const json = (payload) => ({
+                content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+                details: payload,
+            });
+            try {
+                if (params.action === "delete") {
+                    const id = params.id ?? params.item?.id;
+                    if (!id)
+                        throw new Error("id required for delete");
+                    const ok = deleteItem(id);
+                    return json({ ok, id });
+                }
+                if (!params.item)
+                    throw new Error("item required for create/update");
+                if (!params.item.id || !params.item.type || !params.item.title) {
+                    throw new Error("item must have id, type, and title");
+                }
+                const item = upsertItem(params.item);
+                return json({ action: params.action, item });
+            }
+            catch (err) {
+                return json({ error: err instanceof Error ? err.message : String(err) });
+            }
+        },
+    });
+}
+//# sourceMappingURL=items.js.map

package/dist/src/items.js.map

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

package/dist/src/notif-prefs.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Notification Preferences — gateway-side storage for push suppression.
+ *
+ * The app syncs notification preferences here via RPC. The push hook
+ * checks these prefs before sending to the relay — if a category is
+ * muted, the push never leaves the user's machine.
+ *
+ * RPC methods:
+ *   aight.notif.setPrefs  — update preferences
+ *   aight.notif.getPrefs  — read current preferences
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export interface NotifPrefs {
+    globalMute: boolean;
+    muteUntil: string | null;
+    agentReplies: boolean;
+    groupChat: boolean;
+    cron: boolean;
+}
+export declare function loadNotifPrefs(): NotifPrefs;
+export declare function classifySessionKey(sessionKey: string): "agentReplies" | "groupChat" | "cron";
+/**
+ * Check if a push for this sessionKey should be sent.
+ */
+export declare function shouldSendPush(sessionKey: string): boolean;
+export declare function registerNotifPrefsRPC(api: OpenClawPluginApi): void;

package/dist/src/notif-prefs.js

@@ -0,0 +1,93 @@
+/**
+ * Notification Preferences — gateway-side storage for push suppression.
+ *
+ * The app syncs notification preferences here via RPC. The push hook
+ * checks these prefs before sending to the relay — if a category is
+ * muted, the push never leaves the user's machine.
+ *
+ * RPC methods:
+ *   aight.notif.setPrefs  — update preferences
+ *   aight.notif.getPrefs  — read current preferences
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+const DEFAULTS = {
+    globalMute: false,
+    muteUntil: null,
+    agentReplies: true,
+    groupChat: true,
+    cron: false,
+};
+// ── Storage ──
+const PREFS_DIR = path.join(os.homedir(), ".openclaw", "aight");
+const PREFS_FILE = path.join(PREFS_DIR, "notif-prefs.json");
+export function loadNotifPrefs() {
+    try {
+        if (!fs.existsSync(PREFS_FILE))
+            return { ...DEFAULTS };
+        const raw = fs.readFileSync(PREFS_FILE, "utf-8");
+        const parsed = JSON.parse(raw);
+        const prefs = { ...DEFAULTS, ...parsed };
+        // Normalize expired timed mute in memory so getPrefs returns coherent
+        // state to the app. No write — disk is reconciled on the next setPrefs.
+        if (prefs.globalMute && prefs.muteUntil && Date.now() >= new Date(prefs.muteUntil).getTime()) {
+            prefs.globalMute = false;
+            prefs.muteUntil = null;
+        }
+        return prefs;
+    }
+    catch {
+        return { ...DEFAULTS };
+    }
+}
+function saveNotifPrefs(prefs) {
+    fs.mkdirSync(PREFS_DIR, { recursive: true, mode: 0o700 });
+    fs.writeFileSync(PREFS_FILE, JSON.stringify(prefs, null, 2), "utf-8");
+}
+// ── Classification (matches app-side logic) ──
+export function classifySessionKey(sessionKey) {
+    if (sessionKey.includes(":cron:"))
+        return "cron";
+    if (sessionKey.includes(":group-chat:"))
+        return "groupChat";
+    return "agentReplies";
+}
+/**
+ * Check if a push for this sessionKey should be sent.
+ */
+export function shouldSendPush(sessionKey) {
+    if (!sessionKey)
+        return true; // fail open
+    const prefs = loadNotifPrefs();
+    // Global mute (loadNotifPrefs already normalizes expired timed mutes)
+    if (prefs.globalMute)
+        return false;
+    // Category check
+    const category = classifySessionKey(sessionKey);
+    return prefs[category];
+}
+// ── RPC Registration ──
+export function registerNotifPrefsRPC(api) {
+    api.registerGatewayMethod("aight.notif.getPrefs", ({ respond }) => {
+        respond(true, loadNotifPrefs());
+    });
+    api.registerGatewayMethod("aight.notif.setPrefs", ({ params, respond }) => {
+        const update = (params ?? {});
+        const current = loadNotifPrefs();
+        if (typeof update.globalMute === "boolean")
+            current.globalMute = update.globalMute;
+        if (typeof update.agentReplies === "boolean")
+            current.agentReplies = update.agentReplies;
+        if (typeof update.groupChat === "boolean")
+            current.groupChat = update.groupChat;
+        if (typeof update.cron === "boolean")
+            current.cron = update.cron;
+        if (update.muteUntil !== undefined)
+            current.muteUntil = update.muteUntil;
+        saveNotifPrefs(current);
+        api.logger.info(`[aight-utils] Notification prefs updated: ${JSON.stringify(current)}`);
+        respond(true, current);
+    });
+}
+//# sourceMappingURL=notif-prefs.js.map

package/dist/src/notif-prefs.js.map

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

package/dist/src/push-hook.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Push notification hook — sends push on agent_end.
+ */
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+export declare function registerPushHook(api: OpenClawPluginApi): void;

package/dist/src/push-hook.js

@@ -0,0 +1,117 @@
+/**
+ * Push notification hook — sends push on agent_end.
+ */
+import { getPluginConfig } from "./config.js";
+import { loadTokens, unregisterToken } from "./push-store.js";
+import { sendPush } from "./push-net.js";
+import { loadGroupName } from "./groups.js";
+import { shouldSendPush } from "./notif-prefs.js";
+const HIDDEN_SUFFIXES = [
+    ":aight-config",
+    ":aight-pentest",
+    ":speak",
+    ":structured_content",
+    ":main",
+    "security-fix",
+    "skill-scan",
+];
+const HIDDEN_SUBSTRINGS = ["subagent", "security-audit", "_skill-audit-", "_ensure-skill-defender"];
+const META_RESPONSES = ["NO_REPLY", "REPLY_SKIP", "ANNOUNCE_SKIP", "HEARTBEAT_OK"];
+const STALE_TOKEN_ERRORS = ["baddevicetoken", "unregistered", "devicetokennotfortopic", "expired"];
+export function registerPushHook(api) {
+    try {
+        api.on("agent_end", async (event, ctx) => {
+            const sessionKey = ctx.sessionKey ?? "";
+            api.logger.info(`[aight-utils] agent_end fired session=${sessionKey} agent=${ctx.agentId}`);
+            const tokens = loadTokens();
+            if (tokens.length === 0)
+                return;
+            // Skip hidden/internal sessions — no push notifications for config,
+            // security, voice, sub-agent, or other background sessions.
+            if (HIDDEN_SUFFIXES.some((s) => sessionKey.endsWith(s)) ||
+                HIDDEN_SUBSTRINGS.some((s) => sessionKey.includes(s))) {
+                api.logger.info(`[aight-utils] Skipping hidden session push: ${sessionKey}`);
+                return;
+            }
+            // Notification preference gate — bail before expensive preview extraction
+            if (!shouldSendPush(sessionKey)) {
+                api.logger.info(`[aight-utils] Push suppressed by notification prefs: ${sessionKey}`);
+                return;
+            }
+            const msgs = event.messages ?? [];
+            // Extract last assistant message - try string and array content formats
+            let preview = "";
+            for (let i = msgs.length - 1; i >= 0; i--) {
+                const m = msgs[i];
+                if (m.role === "assistant") {
+                    if (typeof m.content === "string" && m.content.trim()) {
+                        preview = m.content.slice(0, 200);
+                        break;
+                    }
+                    if (Array.isArray(m.content)) {
+                        const textBlock = m.content.find((b) => b.type === "text" && typeof b.text === "string");
+                        if (textBlock) {
+                            preview = textBlock.text.slice(0, 200);
+                            break;
+                        }
+                    }
+                }
+            }
+            if (!preview) {
+                api.logger.info(`[aight-utils] No preview found, skipping push`);
+                return;
+            }
+            if (META_RESPONSES.includes(preview.trim())) {
+                api.logger.info(`[aight-utils] Skipping meta response: ${preview.trim()}`);
+                return;
+            }
+            const freshConfig = getPluginConfig(api);
+            // Resolve display name from gateway config agent list
+            const agentId = ctx.agentId ?? "agent";
+            const agents = api.config?.agents?.list ?? [];
+            const agent = agents.find((a) => a.id === agentId);
+            const displayName = agent?.name ?? agent?.identity?.name ?? agentId;
+            // Resolve group chat name for push subtitle (WhatsApp-style layout)
+            let pushSubtitle;
+            if (sessionKey.includes(":group-chat:")) {
+                const groupId = sessionKey.split(":group-chat:")[1];
+                if (groupId) {
+                    const groupName = loadGroupName(api, groupId);
+                    if (groupName) {
+                        pushSubtitle = groupName;
+                    }
+                }
+            }
+            const cleanBody = preview.trim().replace(/\n+/g, " ").trim();
+            const pushPayload = {
+                title: displayName.trim(),
+                subtitle: pushSubtitle,
+                body: cleanBody,
+                data: { sessionKey, agentId },
+            };
+            for (const device of tokens) {
+                if (!device.sendKey)
+                    continue;
+                try {
+                    const pushResult = await sendPush(device, pushPayload, freshConfig);
+                    api.logger.info(`[aight-utils] Push sent: session=${sessionKey} device=${device.deviceId} ok=${pushResult.ok}${pushResult.error ? ` error=${pushResult.error}` : ""}`);
+                    // Auto-prune stale tokens — if the relay rejects the token, remove it
+                    if (!pushResult.ok && pushResult.error) {
+                        const errLower = pushResult.error.toLowerCase();
+                        if (STALE_TOKEN_ERRORS.some((e) => errLower.includes(e))) {
+                            api.logger.info(`[aight-utils] Pruning stale device token: ${device.deviceId}`);
+                            unregisterToken(device.deviceId);
+                        }
+                    }
+                }
+                catch (err) {
+                    api.logger.warn(`[aight-utils] Push failed: ${err instanceof Error ? err.message : String(err)}`);
+                }
+            }
+        });
+    }
+    catch (err) {
+        api.logger.error(`[aight-utils] Failed to register push hook: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+//# sourceMappingURL=push-hook.js.map

package/dist/src/push-hook.js.map

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

package/dist/src/push-net.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Push relay network calls — fetch only, no filesystem access.
+ */
+import type { DeviceToken } from "./push-store.js";
+import type { AightConfig } from "./config.js";
+export declare function obtainSendKey(relayUrl: string, pushToken: string): Promise<string>;
+export interface PushPayload {
+    title?: string;
+    subtitle?: string;
+    body?: string;
+    data?: Record<string, unknown>;
+    silent?: boolean;
+}
+export declare function sendPush(device: DeviceToken, payload: PushPayload, config: AightConfig): Promise<{
+    ok: boolean;
+    error?: string;
+}>;

package/dist/src/push-net.js

@@ -0,0 +1,61 @@
+/**
+ * Push relay network calls — fetch only, no filesystem access.
+ */
+import { DEFAULT_RELAY_URL, DEFAULT_PUSH_MODE } from "./defaults.js";
+// ── Relay Registration (get sendKey) ──
+export async function obtainSendKey(relayUrl, pushToken) {
+    const res = await fetch(`${relayUrl}/register`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ token: pushToken }),
+    });
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Relay /register returned ${res.status}: ${text}`);
+    }
+    const data = (await res.json());
+    if (!data.sendKey)
+        throw new Error("Relay did not return a sendKey");
+    return data.sendKey;
+}
+export async function sendPush(device, payload, config) {
+    if (!device.sendKey) {
+        return {
+            ok: false,
+            error: `No sendKey for device ${device.deviceId} — re-register to obtain one`,
+        };
+    }
+    const relayUrl = config.push?.relayUrl ?? DEFAULT_RELAY_URL;
+    const mode = config.push?.mode ?? DEFAULT_PUSH_MODE;
+    const pushBody = {
+        token: device.pushToken,
+        sendKey: device.sendKey,
+        platform: device.platform,
+        sandbox: device.sandbox ?? false,
+    };
+    if (mode === "rich" && !payload.silent) {
+        pushBody.title = payload.title;
+        if (payload.subtitle)
+            pushBody.subtitle = payload.subtitle;
+        pushBody.body = payload.body;
+    }
+    if (payload.data) {
+        pushBody.data = payload.data;
+    }
+    try {
+        const res = await fetch(`${relayUrl}/send`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(pushBody),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            return { ok: false, error: `Relay returned ${res.status}: ${text}` };
+        }
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=push-net.js.map

package/dist/src/push-net.js.map

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

package/dist/src/push-store.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Push device token persistence — file-based storage only, no network.
+ */
+export interface DeviceToken {
+    deviceId: string;
+    pushToken: string;
+    platform: "ios" | "android";
+    sandbox?: boolean;
+    sendKey?: string;
+    registeredAt: string;
+}
+export declare function loadTokens(): DeviceToken[];
+export declare function saveTokens(tokens: DeviceToken[]): void;
+export declare function registerToken(token: DeviceToken): void;
+export declare function unregisterToken(deviceId: string): boolean;

package/dist/src/push-store.js

@@ -0,0 +1,45 @@
+/**
+ * Push device token persistence — file-based storage only, no network.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as os from "node:os";
+// ── Store ──
+const TOKEN_DIR = path.join(os.homedir(), ".openclaw", "aight");
+const TOKEN_FILE = path.join(TOKEN_DIR, "devices.json");
+export function loadTokens() {
+    try {
+        if (!fs.existsSync(TOKEN_FILE))
+            return [];
+        const raw = fs.readFileSync(TOKEN_FILE, "utf-8");
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+export function saveTokens(tokens) {
+    fs.mkdirSync(TOKEN_DIR, { recursive: true, mode: 0o700 });
+    fs.writeFileSync(TOKEN_FILE, JSON.stringify(tokens, null, 2), { encoding: "utf-8", mode: 0o600 });
+}
+export function registerToken(token) {
+    const tokens = loadTokens();
+    const idx = tokens.findIndex((t) => t.deviceId === token.deviceId);
+    if (idx >= 0) {
+        tokens[idx] = token;
+    }
+    else {
+        tokens.push(token);
+    }
+    saveTokens(tokens);
+}
+export function unregisterToken(deviceId) {
+    const tokens = loadTokens();
+    const filtered = tokens.filter((t) => t.deviceId !== deviceId);
+    if (filtered.length === tokens.length)
+        return false;
+    saveTokens(filtered);
+    return true;
+}
+//# sourceMappingURL=push-store.js.map

package/dist/src/push-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-store.js","sourceRoot":"","sources":["../../src/push-store.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAa9B,cAAc;AAEd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAChE,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AAExD,MAAM,UAAU,UAAU;IACxB,IAAI,CAAC;QACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,CAAC;QAC1C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAkB;IAC9C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,KAAK,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QACb,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,UAAU,CAAC,MAAM,CAAC,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IAC/D,IAAI,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IACpD,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC"}