@elizaos/plugin-imessage 2.0.3-beta.2 → 2.0.3-beta.4

package/dist/accounts.d.ts

@@ -0,0 +1,135 @@
+import type { IAgentRuntime } from "@elizaos/core";
+/**
+ * Default account identifier used when no specific account is configured
+ */
+export declare const DEFAULT_ACCOUNT_ID = "default";
+/**
+ * Group-specific configuration
+ */
+export interface IMessageGroupConfig {
+    /** If false, ignore messages from this group */
+    enabled?: boolean;
+    /** Allowlist for users in this group */
+    allowFrom?: Array<string | number>;
+    /** Require bot mention to respond */
+    requireMention?: boolean;
+    /** Custom system prompt for this group */
+    systemPrompt?: string;
+    /** Skills enabled for this group */
+    skills?: string[];
+}
+/**
+ * Configuration for a single iMessage account
+ */
+export interface IMessageAccountConfig {
+    /** Optional display name for this account */
+    name?: string;
+    /** If false, do not start this iMessage account */
+    enabled?: boolean;
+    /** Path to the iMessage CLI tool */
+    cliPath?: string;
+    /** Path to the iMessage database */
+    dbPath?: string;
+    /** iMessage service type (iMessage or SMS) */
+    service?: "iMessage" | "SMS";
+    /** Phone number region code */
+    region?: string;
+    /** Allowlist for DM senders */
+    allowFrom?: Array<string | number>;
+    /** Allowlist for groups */
+    groupAllowFrom?: Array<string | number>;
+    /** DM access policy */
+    dmPolicy?: "open" | "allowlist" | "pairing" | "disabled";
+    /** Group message access policy */
+    groupPolicy?: "open" | "allowlist" | "disabled";
+    /** Whether to include attachments */
+    includeAttachments?: boolean;
+    /** Max media size in MB */
+    mediaMaxMb?: number;
+    /** Text chunk limit for messages */
+    textChunkLimit?: number;
+    /** Group-specific configurations */
+    groups?: Record<string, IMessageGroupConfig>;
+}
+/**
+ * Multi-account iMessage configuration structure
+ */
+export interface IMessageMultiAccountConfig {
+    /** Default/base configuration applied to all accounts */
+    enabled?: boolean;
+    cliPath?: string;
+    dbPath?: string;
+    service?: "iMessage" | "SMS";
+    region?: string;
+    dmPolicy?: "open" | "allowlist" | "pairing" | "disabled";
+    groupPolicy?: "open" | "allowlist" | "disabled";
+    includeAttachments?: boolean;
+    mediaMaxMb?: number;
+    textChunkLimit?: number;
+    /** Per-account configuration overrides */
+    accounts?: Record<string, IMessageAccountConfig>;
+    /** Group configurations at base level */
+    groups?: Record<string, IMessageGroupConfig>;
+}
+/**
+ * Resolved iMessage account with all configuration merged
+ */
+export interface ResolvedIMessageAccount {
+    accountId: string;
+    enabled: boolean;
+    name?: string;
+    cliPath: string;
+    dbPath?: string;
+    configured: boolean;
+    config: IMessageAccountConfig;
+}
+/**
+ * Normalizes an account ID, returning the default if not provided
+ */
+export declare function normalizeAccountId(accountId?: string | null): string;
+/**
+ * Gets the account inventory configuration from runtime settings
+ */
+export declare function getMultiAccountConfig(runtime: IAgentRuntime): IMessageMultiAccountConfig;
+/**
+ * Lists all configured account IDs
+ */
+export declare function listIMessageAccountIds(runtime: IAgentRuntime): string[];
+/**
+ * Resolves the default account ID to use
+ */
+export declare function resolveDefaultIMessageAccountId(runtime: IAgentRuntime): string;
+/**
+ * Resolves a complete iMessage account configuration
+ */
+export declare function resolveIMessageAccount(runtime: IAgentRuntime, accountId?: string | null): ResolvedIMessageAccount;
+/**
+ * Lists all enabled iMessage accounts
+ */
+export declare function listEnabledIMessageAccounts(runtime: IAgentRuntime): ResolvedIMessageAccount[];
+/**
+ * Checks whether more than one enabled account record is configured
+ */
+export declare function isMultiAccountEnabled(runtime: IAgentRuntime): boolean;
+/**
+ * Resolves group configuration for a specific group
+ */
+export declare function resolveIMessageGroupConfig(runtime: IAgentRuntime, accountId: string, groupId: string): IMessageGroupConfig | undefined;
+/**
+ * Checks if a user is allowed based on policy and allowlist
+ */
+export declare function isIMessageUserAllowed(params: {
+    identifier: string;
+    accountConfig: IMessageAccountConfig;
+    isGroup: boolean;
+    groupId?: string;
+    groupConfig?: IMessageGroupConfig;
+}): boolean;
+/**
+ * Checks if mention is required in a group
+ */
+export declare function isIMessageMentionRequired(params: {
+    accountConfig: IMessageAccountConfig;
+    groupConfig?: IMessageGroupConfig;
+}): boolean;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/accounts.d.ts.map

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

package/dist/accounts.js

@@ -0,0 +1,209 @@
+/**
+ * Default account identifier used when no specific account is configured
+ */
+export const DEFAULT_ACCOUNT_ID = "default";
+/**
+ * Normalizes an account ID, returning the default if not provided
+ */
+export function normalizeAccountId(accountId) {
+    if (!accountId || typeof accountId !== "string") {
+        return DEFAULT_ACCOUNT_ID;
+    }
+    const trimmed = accountId.trim().toLowerCase();
+    if (!trimmed || trimmed === "default") {
+        return DEFAULT_ACCOUNT_ID;
+    }
+    return trimmed;
+}
+/**
+ * Gets the account inventory configuration from runtime settings
+ */
+export function getMultiAccountConfig(runtime) {
+    const characterIMessage = runtime.character.settings?.imessage;
+    return {
+        enabled: characterIMessage?.enabled,
+        cliPath: characterIMessage?.cliPath,
+        dbPath: characterIMessage?.dbPath,
+        service: characterIMessage?.service,
+        region: characterIMessage?.region,
+        dmPolicy: characterIMessage?.dmPolicy,
+        groupPolicy: characterIMessage?.groupPolicy,
+        includeAttachments: characterIMessage?.includeAttachments,
+        mediaMaxMb: characterIMessage?.mediaMaxMb,
+        textChunkLimit: characterIMessage?.textChunkLimit,
+        accounts: characterIMessage?.accounts,
+        groups: characterIMessage?.groups,
+    };
+}
+/**
+ * Lists all configured account IDs
+ */
+export function listIMessageAccountIds(runtime) {
+    const config = getMultiAccountConfig(runtime);
+    const accounts = config.accounts;
+    if (!accounts || typeof accounts !== "object") {
+        return [DEFAULT_ACCOUNT_ID];
+    }
+    const ids = Object.keys(accounts).filter(Boolean);
+    if (ids.length === 0) {
+        return [DEFAULT_ACCOUNT_ID];
+    }
+    return ids.slice().sort((a, b) => a.localeCompare(b));
+}
+/**
+ * Resolves the default account ID to use
+ */
+export function resolveDefaultIMessageAccountId(runtime) {
+    const ids = listIMessageAccountIds(runtime);
+    if (ids.includes(DEFAULT_ACCOUNT_ID)) {
+        return DEFAULT_ACCOUNT_ID;
+    }
+    return ids[0] ?? DEFAULT_ACCOUNT_ID;
+}
+/**
+ * Gets the account-specific configuration
+ */
+function getAccountConfig(runtime, accountId) {
+    const config = getMultiAccountConfig(runtime);
+    const accounts = config.accounts;
+    if (!accounts || typeof accounts !== "object") {
+        return undefined;
+    }
+    return accounts[accountId];
+}
+/**
+ * Merges base configuration with account-specific overrides
+ */
+function mergeIMessageAccountConfig(runtime, accountId) {
+    const multiConfig = getMultiAccountConfig(runtime);
+    const { accounts: _ignored, ...baseConfig } = multiConfig;
+    const accountConfig = getAccountConfig(runtime, accountId) ?? {};
+    // Get environment/runtime settings for the base config
+    const envCliPath = runtime.getSetting("IMESSAGE_CLI_PATH");
+    const envDbPath = runtime.getSetting("IMESSAGE_DB_PATH");
+    const envDmPolicy = runtime.getSetting("IMESSAGE_DM_POLICY");
+    const envGroupPolicy = runtime.getSetting("IMESSAGE_GROUP_POLICY");
+    const envConfig = {
+        cliPath: envCliPath || undefined,
+        dbPath: envDbPath || undefined,
+        dmPolicy: envDmPolicy,
+        groupPolicy: envGroupPolicy,
+    };
+    // Merge order: env defaults < base config < account config
+    return {
+        ...envConfig,
+        ...baseConfig,
+        ...accountConfig,
+    };
+}
+/**
+ * Resolves a complete iMessage account configuration
+ */
+export function resolveIMessageAccount(runtime, accountId) {
+    const normalizedAccountId = normalizeAccountId(accountId);
+    const multiConfig = getMultiAccountConfig(runtime);
+    const baseEnabled = multiConfig.enabled !== false;
+    const merged = mergeIMessageAccountConfig(runtime, normalizedAccountId);
+    const accountEnabled = merged.enabled !== false;
+    const enabled = baseEnabled && accountEnabled;
+    const cliPath = merged.cliPath?.trim() || "imsg";
+    // Determine if this account is actually configured
+    const configured = Boolean(merged.cliPath?.trim() ||
+        merged.dbPath?.trim() ||
+        merged.service ||
+        merged.region?.trim() ||
+        (merged.allowFrom && merged.allowFrom.length > 0) ||
+        (merged.groupAllowFrom && merged.groupAllowFrom.length > 0) ||
+        merged.dmPolicy ||
+        merged.groupPolicy ||
+        typeof merged.includeAttachments === "boolean" ||
+        typeof merged.mediaMaxMb === "number" ||
+        typeof merged.textChunkLimit === "number" ||
+        (merged.groups && Object.keys(merged.groups).length > 0));
+    return {
+        accountId: normalizedAccountId,
+        enabled,
+        name: merged.name?.trim() || undefined,
+        cliPath,
+        dbPath: merged.dbPath?.trim() || undefined,
+        configured,
+        config: merged,
+    };
+}
+/**
+ * Lists all enabled iMessage accounts
+ */
+export function listEnabledIMessageAccounts(runtime) {
+    return listIMessageAccountIds(runtime)
+        .map((accountId) => resolveIMessageAccount(runtime, accountId))
+        .filter((account) => account.enabled);
+}
+/**
+ * Checks whether more than one enabled account record is configured
+ */
+export function isMultiAccountEnabled(runtime) {
+    const accounts = listEnabledIMessageAccounts(runtime);
+    return accounts.length > 1;
+}
+/**
+ * Resolves group configuration for a specific group
+ */
+export function resolveIMessageGroupConfig(runtime, accountId, groupId) {
+    const multiConfig = getMultiAccountConfig(runtime);
+    const accountConfig = getAccountConfig(runtime, accountId);
+    // Check account-level groups first
+    const accountGroup = accountConfig?.groups?.[groupId];
+    if (accountGroup) {
+        return accountGroup;
+    }
+    // Fall back to base-level groups
+    return multiConfig.groups?.[groupId];
+}
+/**
+ * Checks if a user is allowed based on policy and allowlist
+ */
+export function isIMessageUserAllowed(params) {
+    const { identifier, accountConfig, isGroup, groupConfig } = params;
+    if (isGroup) {
+        const policy = accountConfig.groupPolicy ?? "allowlist";
+        if (policy === "disabled") {
+            return false;
+        }
+        if (policy === "open") {
+            return true;
+        }
+        // Check group-specific allowlist first
+        if (groupConfig?.allowFrom?.length) {
+            return groupConfig.allowFrom.some((allowed) => String(allowed) === identifier);
+        }
+        // Check account-level group allowlist
+        if (accountConfig.groupAllowFrom?.length) {
+            return accountConfig.groupAllowFrom.some((allowed) => String(allowed) === identifier);
+        }
+        return policy !== "allowlist";
+    }
+    // DM handling
+    const policy = accountConfig.dmPolicy ?? "pairing";
+    if (policy === "disabled") {
+        return false;
+    }
+    if (policy === "open") {
+        return true;
+    }
+    if (policy === "pairing") {
+        return true;
+    }
+    // Allowlist policy
+    if (accountConfig.allowFrom?.length) {
+        return accountConfig.allowFrom.some((allowed) => String(allowed) === identifier);
+    }
+    return false;
+}
+/**
+ * Checks if mention is required in a group
+ */
+export function isIMessageMentionRequired(params) {
+    const { groupConfig } = params;
+    return groupConfig?.requireMention ?? false;
+}
+//# sourceMappingURL=accounts.js.map

package/dist/accounts.js.map

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

package/dist/api/bluebubbles-routes.d.ts

@@ -0,0 +1,10 @@
+import type http from "node:http";
+import type { RouteHelpers } from "@elizaos/core";
+export interface BlueBubblesRouteState {
+    runtime?: {
+        getService(type: string): unknown;
+    };
+}
+export declare function resolveBlueBubblesWebhookPath(state: BlueBubblesRouteState): string;
+export declare function handleBlueBubblesRoute(req: http.IncomingMessage, res: http.ServerResponse, pathname: string, method: string, state: BlueBubblesRouteState, helpers: RouteHelpers): Promise<boolean>;
+//# sourceMappingURL=bluebubbles-routes.d.ts.map

package/dist/api/bluebubbles-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bluebubbles-routes.d.ts","sourceRoot":"","sources":["../../src/api/bluebubbles-routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AA0BlD,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;KACnC,CAAC;CACH;AAUD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,qBAAqB,GAAG,MAAM,CAOlF;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,qBAAqB,EAC5B,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,OAAO,CAAC,CAkJlB"}

package/dist/api/bluebubbles-routes.js

@@ -0,0 +1,132 @@
+const BLUEBUBBLES_SERVICE_NAME = "bluebubbles";
+const DEFAULT_WEBHOOK_PATH = "/webhooks/bluebubbles";
+const MAX_BODY_BYTES = 1_048_576;
+function resolveService(state) {
+    if (!state.runtime) {
+        return null;
+    }
+    const raw = state.runtime.getService(BLUEBUBBLES_SERVICE_NAME);
+    return raw ?? null;
+}
+export function resolveBlueBubblesWebhookPath(state) {
+    const service = resolveService(state);
+    const configuredPath = service?.getWebhookPath();
+    if (typeof configuredPath === "string" && configuredPath.trim().length > 0) {
+        return configuredPath.trim();
+    }
+    return DEFAULT_WEBHOOK_PATH;
+}
+export async function handleBlueBubblesRoute(req, res, pathname, method, state, helpers) {
+    const webhookPath = resolveBlueBubblesWebhookPath(state);
+    const isWebhookPath = pathname === webhookPath;
+    const isApiPath = pathname.startsWith("/api/bluebubbles");
+    if (!isWebhookPath && !isApiPath) {
+        return false;
+    }
+    if (method === "GET" && pathname === "/api/bluebubbles/status") {
+        const service = resolveService(state);
+        if (!service) {
+            helpers.json(res, {
+                available: false,
+                connected: false,
+                webhookPath,
+                reason: "bluebubbles service not registered",
+            });
+            return true;
+        }
+        helpers.json(res, {
+            available: true,
+            connected: service.isConnected(),
+            webhookPath,
+        });
+        return true;
+    }
+    if (method === "GET" && pathname === "/api/bluebubbles/chats") {
+        const service = resolveService(state);
+        if (!service) {
+            helpers.error(res, "bluebubbles service not registered", 503);
+            return true;
+        }
+        const client = service.getClient();
+        if (!client) {
+            helpers.error(res, "bluebubbles client not available", 503);
+            return true;
+        }
+        const url = new URL(req.url ?? pathname, "http://localhost");
+        const limit = Math.min(Math.max(1, Number.parseInt(url.searchParams.get("limit") ?? "100", 10) || 100), 500);
+        const offset = Math.max(0, Number.parseInt(url.searchParams.get("offset") ?? "0", 10) || 0);
+        try {
+            const chats = await client.listChats(limit, offset);
+            helpers.json(res, { chats, count: chats.length, limit, offset });
+        }
+        catch (error) {
+            helpers.error(res, `failed to read bluebubbles chats: ${error instanceof Error ? error.message : String(error)}`, 500);
+        }
+        return true;
+    }
+    if (method === "GET" && pathname === "/api/bluebubbles/messages") {
+        const service = resolveService(state);
+        if (!service) {
+            helpers.error(res, "bluebubbles service not registered", 503);
+            return true;
+        }
+        const client = service.getClient();
+        if (!client) {
+            helpers.error(res, "bluebubbles client not available", 503);
+            return true;
+        }
+        const url = new URL(req.url ?? pathname, "http://localhost");
+        const chatGuid = (url.searchParams.get("chatGuid") ?? "").trim();
+        if (!chatGuid) {
+            helpers.error(res, "chatGuid query parameter is required", 400);
+            return true;
+        }
+        const limit = Math.min(Math.max(1, Number.parseInt(url.searchParams.get("limit") ?? "50", 10) || 50), 500);
+        const offset = Math.max(0, Number.parseInt(url.searchParams.get("offset") ?? "0", 10) || 0);
+        try {
+            const messages = await client.getMessages(chatGuid, limit, offset);
+            helpers.json(res, {
+                chatGuid,
+                messages,
+                count: messages.length,
+                limit,
+                offset,
+            });
+        }
+        catch (error) {
+            helpers.error(res, `failed to read bluebubbles messages: ${error instanceof Error ? error.message : String(error)}`, 500);
+        }
+        return true;
+    }
+    if (method === "POST" && isWebhookPath) {
+        const service = resolveService(state);
+        if (!service) {
+            helpers.error(res, "bluebubbles service not registered", 503);
+            return true;
+        }
+        const payload = await helpers.readJsonBody(req, res, {
+            maxBytes: MAX_BODY_BYTES,
+        });
+        if (!payload) {
+            return true;
+        }
+        if (typeof payload.type !== "string" ||
+            !payload.type.trim() ||
+            typeof payload.data !== "object" ||
+            payload.data === null ||
+            Array.isArray(payload.data)) {
+            helpers.error(res, "invalid BlueBubbles webhook payload", 400);
+            return true;
+        }
+        try {
+            await service.handleWebhook(payload);
+            helpers.json(res, { ok: true });
+        }
+        catch (error) {
+            helpers.error(res, `failed to handle bluebubbles webhook: ${error instanceof Error ? error.message : String(error)}`, 500);
+        }
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=bluebubbles-routes.js.map

package/dist/api/bluebubbles-routes.js.map

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

package/dist/api/imessage-routes.d.ts

@@ -0,0 +1,68 @@
+/**
+ * iMessage connector HTTP routes.
+ *
+ * Exposes the @elizaos/plugin-imessage service state through Eliza's
+ * HTTP API so downstream UI layers (the dashboard, a future CLI, third-
+ * party integrations) can read and write against the macOS Messages.app
+ * world without each client having to go straight to chat.db or native
+ * macOS bridges.
+ *
+ * Routes served (all under `/api/imessage`):
+ *
+ *   GET    /api/imessage/status         service health + cursor + counts
+ *   GET    /api/imessage/messages       recent messages from chat.db
+ *   GET    /api/imessage/chats          list of chats (DMs + groups)
+ *   GET    /api/imessage/contacts       every contact with full detail
+ *   POST   /api/imessage/contacts       create a new contact
+ *   PATCH  /api/imessage/contacts/:id   update an existing contact
+ *   DELETE /api/imessage/contacts/:id   delete a contact
+ *
+ * Each handler pulls the IMessageService instance off the runtime via
+ * `runtime.getService("imessage")` and calls the public methods added
+ * in the plugin's patched branch. If the service isn't registered (the
+ * plugin isn't enabled, Eliza booted before it was loaded, etc.) we
+ * return 503 with a structured reason so the UI can render an
+ * informative empty state.
+ *
+ * Write endpoints (POST/PATCH/DELETE on contacts) touch the real macOS
+ * Contacts store through CNContactStore and require the Contacts privacy
+ * grant. Once granted, the permission is persistent across restarts.
+ */
+import type http from "node:http";
+import type { RouteHelpers } from "@elizaos/core";
+/**
+ * Route helper options accepted by the host. This plugin depends on core, not
+ * the agent package, so the route file stays usable without importing agent
+ * internals.
+ */
+export interface ReadJsonBodyOptions {
+    maxBytes?: number;
+    requireObject?: boolean;
+    readErrorStatus?: number;
+    nonObjectStatus?: number;
+    parseErrorStatus?: number;
+    readErrorMessage?: string;
+    nonObjectMessage?: string;
+    parseErrorMessage?: string;
+}
+export interface IMessageRouteState {
+    /**
+     * The running AgentRuntime (or a test runtime). Typed loosely as
+     * `unknown` so this route file doesn't re-declare core's stricter
+     * generic getService signature — we narrow the result inside
+     * resolveService via an unknown cast. Optional so route files
+     * tolerate the boot window where the runtime hasn't finished
+     * registering services yet.
+     */
+    runtime?: {
+        getService(type: string): unknown;
+    };
+}
+/**
+ * Route handler entry point. Returns `true` when a route matched and
+ * the response has been written; returns `false` so the caller can
+ * continue to other route handlers (mirrors the handleWhatsAppRoute /
+ * handleWalletRoute pattern used elsewhere in this codebase).
+ */
+export declare function handleIMessageRoute(req: http.IncomingMessage, res: http.ServerResponse, pathname: string, method: string, state: IMessageRouteState, helpers: RouteHelpers): Promise<boolean>;
+//# sourceMappingURL=imessage-routes.d.ts.map

package/dist/api/imessage-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imessage-routes.d.ts","sourceRoot":"","sources":["../../src/api/imessage-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,eAAe,CAAC;AAEpE;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AA2ED,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;KACnC,CAAC;CACH;AAyBD;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,OAAO,CAAC,CA0NlB"}