@framers/agentos 0.1.26 → 0.1.28

package/dist/channels/adapters/RedditChannelAdapter.js

@@ -0,0 +1,516 @@
+/**
+ * @fileoverview Reddit Channel Adapter for AgentOS.
+ *
+ * Wraps the Reddit API (via `snoowrap`) to allow agents to submit
+ * posts, comments, and interact with subreddits. Uses dynamic import
+ * so that `snoowrap` is only loaded at connection time.
+ *
+ * Reddit's API has strict rate limits (60 requests per minute for
+ * OAuth apps). The adapter tracks and respects these limits with a
+ * request queue.
+ *
+ * **Dependencies**: Requires `snoowrap` to be installed.
+ *
+ * @example
+ * ```typescript
+ * const reddit = new RedditChannelAdapter();
+ * await reddit.initialize({
+ *   platform: 'reddit',
+ *   credential: '<client_id>',
+ *   params: {
+ *     clientSecret: 'your-client-secret',
+ *     username: 'bot_username',
+ *     password: 'bot_password',
+ *     userAgent: 'agentos:v1.0 (by /u/your_username)',
+ *   },
+ * });
+ * ```
+ *
+ * @module @framers/agentos/channels/adapters/RedditChannelAdapter
+ */
+import { BaseChannelAdapter } from './BaseChannelAdapter.js';
+// ============================================================================
+// RedditChannelAdapter
+// ============================================================================
+/**
+ * Channel adapter for Reddit.
+ *
+ * Uses the `snoowrap` package via dynamic import so the dependency
+ * is optional. Falls back to raw `fetch` against the Reddit OAuth2
+ * API if snoowrap is unavailable.
+ *
+ * Capabilities: `text`, `rich_text`, `images`, `video`, `reactions`,
+ * `threads`, `group_chat`, `hashtags`, `polls`.
+ *
+ * Conversation ID mapping:
+ * - Subreddit post: `r/<subreddit>` or `post:<thing_id>`
+ * - Comment reply: `comment:<thing_id>`
+ * - Direct message: `dm:<username>`
+ */
+export class RedditChannelAdapter extends BaseChannelAdapter {
+    constructor() {
+        super(...arguments);
+        this.platform = 'reddit';
+        this.displayName = 'Reddit';
+        this.capabilities = [
+            'text',
+            'rich_text',
+            'images',
+            'video',
+            'reactions',
+            'threads',
+            'group_chat',
+            'hashtags',
+            'polls',
+        ];
+        /** Whether we're using snoowrap or raw fetch. */
+        this.usingSnoowrap = false;
+        this.tokenExpiresAt = 0;
+        /** Rate-limit: requests remaining in the current window. */
+        this.rateLimitRemaining = 60;
+        this.rateLimitResetAt = 0;
+        this.lastInboxTimestamp = 0;
+    }
+    // ── Abstract hook implementations ──
+    async doConnect(auth) {
+        const params = auth.params ?? {};
+        this.storedAuth = auth;
+        if (!auth.credential) {
+            throw new Error('Reddit auth credential (clientId) is required.');
+        }
+        if (!params.clientSecret) {
+            throw new Error('Reddit auth params must include "clientSecret".');
+        }
+        if (!params.username || !params.password) {
+            throw new Error('Reddit auth params must include "username" and "password".');
+        }
+        if (!params.userAgent) {
+            throw new Error('Reddit auth params must include "userAgent".');
+        }
+        // Attempt snoowrap first, fall back to raw fetch
+        try {
+            const snoowrap = await import('snoowrap');
+            const Snoowrap = snoowrap.default ?? snoowrap;
+            this.client = new Snoowrap({
+                userAgent: params.userAgent,
+                clientId: auth.credential,
+                clientSecret: params.clientSecret,
+                username: params.username,
+                password: params.password,
+            });
+            // Configure snoowrap rate limiting
+            this.client.config({
+                requestDelay: 1000, // 1 request per second baseline
+                continueAfterRatelimitError: true,
+                retryErrorCodes: [502, 503, 504, 522],
+                maxRetryAttempts: 3,
+            });
+            this.usingSnoowrap = true;
+            // Verify by fetching the authenticated user
+            const me = await this.client.getMe();
+            this.authenticatedUser = {
+                name: me.name,
+                id: me.id,
+            };
+        }
+        catch (importErr) {
+            // snoowrap not available — use raw Reddit API
+            console.warn('[Reddit] snoowrap not installed, using raw Reddit API. ' +
+                'Install snoowrap for a richer experience: npm install snoowrap');
+            this.usingSnoowrap = false;
+            await this.authenticateRaw(auth.credential, params);
+        }
+        this.platformInfo = {
+            username: this.authenticatedUser?.name,
+            userId: this.authenticatedUser?.id,
+            usingSnoowrap: this.usingSnoowrap,
+        };
+        // Start polling for incoming messages
+        this.startPolling();
+    }
+    async doSendMessage(conversationId, content) {
+        // Determine what kind of interaction this is
+        if (conversationId.startsWith('r/')) {
+            return this.submitPost(conversationId.slice(2), content);
+        }
+        if (conversationId.startsWith('comment:')) {
+            return this.replyToComment(conversationId.slice(8), content);
+        }
+        if (conversationId.startsWith('post:')) {
+            return this.replyToPost(conversationId.slice(5), content);
+        }
+        if (conversationId.startsWith('dm:')) {
+            return this.sendPrivateMessage(conversationId.slice(3), content);
+        }
+        // Default: treat as subreddit name
+        return this.submitPost(conversationId, content);
+    }
+    async doShutdown() {
+        this.stopPolling();
+        this.client = undefined;
+        this.accessToken = undefined;
+        this.authenticatedUser = undefined;
+        this.storedAuth = undefined;
+        this.lastInboxTimestamp = 0;
+    }
+    // ── Reddit-specific public methods ──
+    /**
+     * Submit a new post to a subreddit.
+     */
+    async submitPost(subreddit, content) {
+        const text = this.extractText(content.blocks);
+        const title = this.extractTitle(text);
+        const body = this.extractBody(text);
+        const imageBlock = content.blocks.find((b) => b.type === 'image');
+        const pollBlock = content.blocks.find((b) => b.type === 'poll');
+        if (this.usingSnoowrap && this.client) {
+            return this.submitPostSnoowrap(subreddit, title, body, imageBlock, pollBlock);
+        }
+        return this.submitPostRaw(subreddit, title, body, imageBlock);
+    }
+    /**
+     * Upvote a post or comment.
+     */
+    async upvote(thingId) {
+        if (this.usingSnoowrap && this.client) {
+            await this.client.getSubmission(thingId).upvote();
+        }
+        else {
+            await this.redditApiRequest('POST', '/api/vote', {
+                id: thingId,
+                dir: 1,
+            });
+        }
+    }
+    /**
+     * Downvote a post or comment.
+     */
+    async downvote(thingId) {
+        if (this.usingSnoowrap && this.client) {
+            await this.client.getSubmission(thingId).downvote();
+        }
+        else {
+            await this.redditApiRequest('POST', '/api/vote', {
+                id: thingId,
+                dir: -1,
+            });
+        }
+    }
+    /**
+     * Get information about the authenticated user.
+     */
+    getAuthenticatedUser() {
+        return this.authenticatedUser ? { ...this.authenticatedUser } : undefined;
+    }
+    // ── Private: snoowrap methods ──
+    async submitPostSnoowrap(subreddit, title, body, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    imageBlock, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    pollBlock) {
+        let submission; // eslint-disable-line @typescript-eslint/no-explicit-any
+        if (imageBlock && imageBlock.type === 'image') {
+            // Link post with image URL
+            submission = await this.client
+                .getSubreddit(subreddit)
+                .submitLink({
+                title,
+                url: imageBlock.url,
+            });
+        }
+        else if (pollBlock && pollBlock.type === 'poll') {
+            // Polls require raw API call even with snoowrap
+            const result = await this.redditApiRequest('POST', '/api/submit_poll_post', {
+                sr: subreddit,
+                title,
+                selftext: body,
+                options: pollBlock.options,
+                duration: (pollBlock.durationHours ?? 24) * 60, // minutes
+            });
+            return {
+                messageId: result?.json?.data?.id ?? `reddit-${Date.now()}`,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        else {
+            // Self (text) post
+            submission = await this.client
+                .getSubreddit(subreddit)
+                .submitSelfpost({
+                title,
+                text: body,
+            });
+        }
+        return {
+            messageId: submission?.name ?? submission?.id ?? `reddit-${Date.now()}`,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async replyToComment(commentId, content) {
+        const text = this.extractText(content.blocks);
+        if (!text) {
+            throw new Error('[Reddit] Cannot post empty comment.');
+        }
+        if (this.usingSnoowrap && this.client) {
+            const reply = await this.client.getComment(commentId).reply(text);
+            return {
+                messageId: reply?.name ?? reply?.id ?? `reddit-${Date.now()}`,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        const result = await this.redditApiRequest('POST', '/api/comment', {
+            parent: commentId.startsWith('t1_') ? commentId : `t1_${commentId}`,
+            text,
+        });
+        return {
+            messageId: result?.json?.data?.things?.[0]?.data?.name ?? `reddit-${Date.now()}`,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async replyToPost(postId, content) {
+        const text = this.extractText(content.blocks);
+        if (!text) {
+            throw new Error('[Reddit] Cannot post empty comment.');
+        }
+        if (this.usingSnoowrap && this.client) {
+            const reply = await this.client.getSubmission(postId).reply(text);
+            return {
+                messageId: reply?.name ?? reply?.id ?? `reddit-${Date.now()}`,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        const result = await this.redditApiRequest('POST', '/api/comment', {
+            parent: postId.startsWith('t3_') ? postId : `t3_${postId}`,
+            text,
+        });
+        return {
+            messageId: result?.json?.data?.things?.[0]?.data?.name ?? `reddit-${Date.now()}`,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    async sendPrivateMessage(username, content) {
+        const text = this.extractText(content.blocks);
+        const title = this.extractTitle(text);
+        const body = this.extractBody(text);
+        if (this.usingSnoowrap && this.client) {
+            await this.client.composeMessage({
+                to: username,
+                subject: title || 'Message from AgentOS',
+                text: body || text,
+            });
+        }
+        else {
+            await this.redditApiRequest('POST', '/api/compose', {
+                to: username,
+                subject: title || 'Message from AgentOS',
+                text: body || text,
+            });
+        }
+        return {
+            messageId: `dm-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // ── Private: raw Reddit API (fetch-based fallback) ──
+    async authenticateRaw(clientId, params) {
+        const basicAuth = Buffer.from(`${clientId}:${params.clientSecret}`).toString('base64');
+        const response = await fetch('https://www.reddit.com/api/v1/access_token', {
+            method: 'POST',
+            headers: {
+                'Authorization': `Basic ${basicAuth}`,
+                'Content-Type': 'application/x-www-form-urlencoded',
+                'User-Agent': params.userAgent,
+            },
+            body: new URLSearchParams({
+                grant_type: 'password',
+                username: params.username,
+                password: params.password,
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Reddit OAuth2 authentication failed: ${response.status} ${response.statusText}`);
+        }
+        const data = await response.json();
+        if (data.error) {
+            throw new Error(`Reddit OAuth2 error: ${data.error}`);
+        }
+        this.accessToken = data.access_token;
+        this.tokenExpiresAt = Date.now() + (data.expires_in ?? 3600) * 1000;
+        // Fetch authenticated user info
+        const meResponse = await this.redditApiRequest('GET', '/api/v1/me');
+        this.authenticatedUser = {
+            name: meResponse.name,
+            id: meResponse.id,
+        };
+    }
+    async ensureAccessToken() {
+        if (this.accessToken && Date.now() < this.tokenExpiresAt - 60000) {
+            return; // Token still valid (with 60s buffer)
+        }
+        if (!this.storedAuth) {
+            throw new Error('[Reddit] Cannot refresh token — no stored auth.');
+        }
+        const params = this.storedAuth.params ?? {};
+        await this.authenticateRaw(this.storedAuth.credential, params);
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async redditApiRequest(method, path, body) {
+        if (!this.usingSnoowrap) {
+            await this.ensureAccessToken();
+        }
+        // Respect rate limits
+        const now = Date.now() / 1000;
+        if (this.rateLimitRemaining <= 1 && now < this.rateLimitResetAt) {
+            const waitMs = (this.rateLimitResetAt - now) * 1000 + 500;
+            console.warn(`[Reddit] Rate limit near exhaustion. Waiting ${Math.round(waitMs / 1000)}s.`);
+            await new Promise((resolve) => setTimeout(resolve, waitMs));
+        }
+        const url = `https://oauth.reddit.com${path}`;
+        const userAgent = this.storedAuth?.params?.userAgent ?? 'AgentOS Reddit Adapter';
+        const options = {
+            method,
+            headers: {
+                'Authorization': `Bearer ${this.accessToken}`,
+                'User-Agent': userAgent,
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+        };
+        if (body && method !== 'GET') {
+            options.body = new URLSearchParams(Object.entries(body).reduce((acc, [k, v]) => {
+                acc[k] = typeof v === 'string' ? v : JSON.stringify(v);
+                return acc;
+            }, {}));
+        }
+        const response = await fetch(url, options);
+        // Update rate limit tracking from headers
+        const remaining = response.headers.get('x-ratelimit-remaining');
+        const reset = response.headers.get('x-ratelimit-reset');
+        if (remaining !== null) {
+            this.rateLimitRemaining = parseFloat(remaining);
+        }
+        if (reset !== null) {
+            this.rateLimitResetAt = Date.now() / 1000 + parseFloat(reset);
+        }
+        if (!response.ok) {
+            const text = await response.text().catch(() => '');
+            throw new Error(`Reddit API error: ${response.status} ${response.statusText} — ${text}`);
+        }
+        return response.json();
+    }
+    // ── Private: submit post via raw API ──
+    async submitPostRaw(subreddit, title, body, 
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    imageBlock) {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const payload = {
+            sr: subreddit,
+            title,
+            kind: imageBlock ? 'link' : 'self',
+            resubmit: 'true',
+        };
+        if (imageBlock && imageBlock.type === 'image') {
+            payload.url = imageBlock.url;
+        }
+        else {
+            payload.text = body;
+        }
+        const result = await this.redditApiRequest('POST', '/api/submit', payload);
+        return {
+            messageId: result?.json?.data?.name ?? result?.json?.data?.id ?? `reddit-${Date.now()}`,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // ── Polling for inbox messages ──
+    startPolling() {
+        // Poll inbox every 90 seconds (conservative for Reddit rate limits)
+        this.pollTimer = setInterval(() => {
+            this.pollInbox().catch((err) => {
+                console.warn('[Reddit] Inbox poll error:', err);
+            });
+        }, 90000);
+    }
+    stopPolling() {
+        if (this.pollTimer) {
+            clearInterval(this.pollTimer);
+            this.pollTimer = undefined;
+        }
+    }
+    async pollInbox() {
+        try {
+            let messages; // eslint-disable-line @typescript-eslint/no-explicit-any
+            if (this.usingSnoowrap && this.client) {
+                const inbox = await this.client.getUnreadMessages();
+                messages = Array.isArray(inbox) ? inbox : [];
+            }
+            else {
+                const result = await this.redditApiRequest('GET', '/message/unread?limit=25');
+                messages = result?.data?.children?.map((c) => c.data) ?? []; // eslint-disable-line @typescript-eslint/no-explicit-any
+            }
+            for (const msg of messages) {
+                const createdAt = (msg.created_utc ?? msg.created ?? 0) * 1000;
+                if (createdAt <= this.lastInboxTimestamp)
+                    continue;
+                const isComment = msg.was_comment === true;
+                const conversationId = isComment
+                    ? `comment:${msg.name ?? msg.id}`
+                    : `dm:${msg.author ?? msg.dest ?? 'unknown'}`;
+                const channelMessage = {
+                    messageId: msg.name ?? msg.id ?? `reddit-${Date.now()}`,
+                    platform: 'reddit',
+                    conversationId,
+                    conversationType: isComment ? 'thread' : 'direct',
+                    sender: {
+                        id: msg.author ?? 'unknown',
+                        username: msg.author,
+                        displayName: msg.author,
+                    },
+                    content: [{ type: 'text', text: msg.body ?? '' }],
+                    text: msg.body ?? '',
+                    timestamp: new Date(createdAt).toISOString(),
+                    rawEvent: msg,
+                };
+                this.emit({
+                    type: 'message',
+                    platform: 'reddit',
+                    conversationId,
+                    timestamp: channelMessage.timestamp,
+                    data: channelMessage,
+                });
+                if (createdAt > this.lastInboxTimestamp) {
+                    this.lastInboxTimestamp = createdAt;
+                }
+            }
+        }
+        catch {
+            // Non-fatal — will retry on next poll
+        }
+    }
+    // ── Text helpers ──
+    extractText(blocks) {
+        return blocks
+            .filter((b) => b.type === 'text')
+            .map((b) => b.text)
+            .join('\n');
+    }
+    /**
+     * Extract the first line as a title. Reddit requires titles for posts.
+     */
+    extractTitle(text) {
+        const firstLine = text.split('\n')[0]?.trim();
+        if (firstLine && firstLine.length <= 300)
+            return firstLine;
+        if (firstLine)
+            return firstLine.slice(0, 297) + '...';
+        return 'Post from AgentOS';
+    }
+    /**
+     * Extract everything after the first line as the body.
+     */
+    extractBody(text) {
+        const lines = text.split('\n');
+        if (lines.length <= 1)
+            return '';
+        return lines.slice(1).join('\n').trim();
+    }
+}
+//# sourceMappingURL=RedditChannelAdapter.js.map

package/dist/channels/adapters/RedditChannelAdapter.js.map

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

package/dist/channels/adapters/SignalChannelAdapter.d.ts

@@ -0,0 +1,120 @@
+/**
+ * @fileoverview Signal Channel Adapter for AgentOS.
+ *
+ * Integrates with the Signal messaging protocol via `signal-cli`, a
+ * command-line tool for Signal. The adapter invokes signal-cli as a
+ * subprocess for sending/receiving messages, providing end-to-end
+ * encrypted communication for agents.
+ *
+ * **Dependencies**: Requires `signal-cli` to be installed and
+ * configured on the system (either registered or linked to an
+ * existing device). See https://github.com/AsamK/signal-cli
+ *
+ * The adapter supports two operation modes:
+ * 1. **Subprocess mode** (default): Invokes signal-cli per command.
+ * 2. **JSON-RPC daemon mode**: Connects to a running signal-cli
+ *    daemon for lower latency. Enabled when `daemonSocket` param
+ *    is provided.
+ *
+ * @example
+ * ```typescript
+ * const signal = new SignalChannelAdapter();
+ * await signal.initialize({
+ *   platform: 'signal',
+ *   credential: '+1234567890',       // registered phone number
+ *   params: {
+ *     signalCliPath: '/usr/local/bin/signal-cli',
+ *     configDir: '/home/agent/.local/share/signal-cli',
+ *   },
+ * });
+ * ```
+ *
+ * @module @framers/agentos/channels/adapters/SignalChannelAdapter
+ */
+import type { ChannelAuthConfig, ChannelCapability, ChannelPlatform, ChannelSendResult, MessageContent } from '../types.js';
+import { BaseChannelAdapter } from './BaseChannelAdapter.js';
+/** Platform-specific authentication parameters for Signal. */
+export interface SignalAuthParams extends Record<string, string | undefined> {
+    /** Path to the signal-cli binary. Default: 'signal-cli'. */
+    signalCliPath?: string;
+    /** Path to signal-cli config/data directory. */
+    configDir?: string;
+    /** Unix socket or TCP address of signal-cli JSON-RPC daemon. */
+    daemonSocket?: string;
+    /** Trust mode for new identities: 'always', 'on-first-use', 'never'. Default: 'on-first-use'. */
+    trustMode?: string;
+}
+/**
+ * Channel adapter for the Signal messaging protocol via signal-cli.
+ *
+ * Capabilities: `text`, `images`, `audio`, `voice_notes`,
+ * `documents`, `reactions`, `group_chat`.
+ *
+ * Conversation ID mapping:
+ * - Direct message: phone number (e.g., '+1234567890')
+ * - Group: group ID in base64 format, prefixed with 'group:'
+ */
+export declare class SignalChannelAdapter extends BaseChannelAdapter<SignalAuthParams> {
+    readonly platform: ChannelPlatform;
+    readonly displayName = "Signal";
+    readonly capabilities: readonly ChannelCapability[];
+    /** Path to signal-cli binary. */
+    private signalCliPath;
+    /** Registered phone number (account identifier). */
+    private phoneNumber;
+    /** Config directory for signal-cli. */
+    private configDir;
+    /** Trust mode for unknown identities. */
+    private trustMode;
+    /** JSON-RPC daemon connection (if using daemon mode). */
+    private daemonSocket;
+    private daemonConnection;
+    /** Polling process for receiving messages. */
+    private receiveProcess;
+    private pollTimer;
+    protected doConnect(auth: ChannelAuthConfig & {
+        params?: SignalAuthParams;
+    }): Promise<void>;
+    protected doSendMessage(conversationId: string, content: MessageContent): Promise<ChannelSendResult>;
+    protected doShutdown(): Promise<void>;
+    /**
+     * Send a reaction to a message.
+     *
+     * @param conversationId - Target conversation (phone number or group:id).
+     * @param targetAuthor - Phone number of the message author being reacted to.
+     * @param targetTimestamp - Timestamp of the target message (Signal's message ID).
+     * @param emoji - The reaction emoji.
+     */
+    sendReaction(conversationId: string, targetAuthor: string, targetTimestamp: string, emoji: string): Promise<void>;
+    /**
+     * List groups the account is a member of.
+     */
+    listGroups(): Promise<Array<{
+        id: string;
+        name: string;
+        members: string[];
+    }>>;
+    /**
+     * Mark messages as read (send read receipt).
+     */
+    markAsRead(senderNumber: string, timestamps: string[]): Promise<void>;
+    private verifySignalCli;
+    private verifyAccount;
+    /**
+     * Execute a signal-cli command and return stdout.
+     */
+    private execSignalCli;
+    private connectDaemon;
+    private handleDaemonData;
+    private startReceivePolling;
+    private receiveMessages;
+    private processSignalEvent;
+    private extractText;
+    /**
+     * Extract file paths from attachment blocks. For Signal, URLs
+     * must be local file paths (signal-cli does not support remote URLs
+     * directly — the caller must download first).
+     */
+    private extractAttachmentPaths;
+}
+//# sourceMappingURL=SignalChannelAdapter.d.ts.map

package/dist/channels/adapters/SignalChannelAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalChannelAdapter.d.ts","sourceRoot":"","sources":["../../../src/channels/adapters/SignalChannelAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,iBAAiB,EAEjB,eAAe,EACf,iBAAiB,EACjB,cAAc,EAEf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAM7D,8DAA8D;AAC9D,MAAM,WAAW,gBAAiB,SAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1E,4DAA4D;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iGAAiG;IACjG,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;;;;;GASG;AACH,qBAAa,oBAAqB,SAAQ,kBAAkB,CAAC,gBAAgB,CAAC;IAC5E,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAY;IAC9C,QAAQ,CAAC,WAAW,YAAY;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAQxC;IAEX,iCAAiC;IACjC,OAAO,CAAC,aAAa,CAAgB;IAErC,oDAAoD;IACpD,OAAO,CAAC,WAAW,CAAqB;IAExC,uCAAuC;IACvC,OAAO,CAAC,SAAS,CAAqB;IAEtC,yCAAyC;IACzC,OAAO,CAAC,SAAS,CAAuD;IAExE,yDAAyD;IACzD,OAAO,CAAC,YAAY,CAAqB;IAEzC,OAAO,CAAC,gBAAgB,CAAkB;IAE1C,8CAA8C;IAE9C,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,SAAS,CAA6C;cAI9C,SAAS,CACvB,IAAI,EAAE,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,gBAAgB,CAAA;KAAE,GACtD,OAAO,CAAC,IAAI,CAAC;cAyCA,aAAa,CAC3B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,iBAAiB,CAAC;cA+Cb,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkC3C;;;;;;;OAOG;IACG,YAAY,CAChB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC;IAoBhB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAkBnF;;OAEG;IACG,UAAU,CACd,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,IAAI,CAAC;YAWF,eAAe;YAaf,aAAa;IAkB3B;;OAEG;YACW,aAAa;YA+Cb,aAAa;IAuC3B,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,mBAAmB;YAYb,eAAe;IAoC7B,OAAO,CAAC,kBAAkB;IAkH1B,OAAO,CAAC,WAAW;IAOnB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;CAyB/B"}