@antcoder/birdxtwittercli 0.8.0

package/dist/lib/twitter-client-news.js

@@ -0,0 +1,283 @@
+import { TWITTER_API_BASE } from './twitter-client-constants.js';
+import { buildExploreFeatures } from './twitter-client-features.js';
+const POST_COUNT_REGEX = /[\d.]+[KMB]?\s*posts?/i;
+const POST_COUNT_MATCH_REGEX = /([\d.]+)([KMB]?)\s*posts?/i;
+// Timeline IDs for different Explore tabs
+const TIMELINE_IDS = {
+    forYou: 'VGltZWxpbmU6DAC2CwABAAAAB2Zvcl95b3UAAA==',
+    trending: 'VGltZWxpbmU6DAC2CwABAAAACHRyZW5kaW5nAAA=',
+    news: 'VGltZWxpbmU6DAC2CwABAAAABG5ld3MAAA==',
+    sports: 'VGltZWxpbmU6DAC2CwABAAAABnNwb3J0cwAA',
+    entertainment: 'VGltZWxpbmU6DAC2CwABAAAADWVudGVydGFpbm1lbnQAAA==',
+};
+export function withNews(Base) {
+    class TwitterClientNews extends Base {
+        // biome-ignore lint/complexity/noUselessConstructor lint/suspicious/noExplicitAny: TS mixin constructor requirement.
+        constructor(...args) {
+            super(...args);
+        }
+        /**
+         * Fetch news and trending topics from Twitter's Explore page tabs
+         */
+        async getNews(count = 10, options = {}) {
+            const { includeRaw = false, withTweets = false, tweetsPerItem = 5, aiOnly = false, tabs = ['forYou', 'news', 'sports', 'entertainment'], } = options;
+            const debug = process.env.BIRD_DEBUG === '1';
+            if (debug) {
+                console.error(`[getNews] Fetching from tabs: ${tabs.join(', ')}`);
+            }
+            const allItems = [];
+            const seenHeadlines = new Set();
+            // Fetch from each tab
+            for (const tab of tabs) {
+                const timelineId = TIMELINE_IDS[tab];
+                if (!timelineId) {
+                    continue;
+                }
+                try {
+                    const tabItems = await this.fetchTimelineTab(tab, timelineId, count, aiOnly, includeRaw);
+                    // Deduplicate across tabs
+                    for (const item of tabItems) {
+                        if (!seenHeadlines.has(item.headline)) {
+                            seenHeadlines.add(item.headline);
+                            allItems.push(item);
+                        }
+                    }
+                    if (debug) {
+                        console.error(`[getNews] Tab ${tab}: found ${tabItems.length} items, total unique: ${allItems.length}`);
+                    }
+                    // Stop early if we have enough
+                    if (allItems.length >= count) {
+                        break;
+                    }
+                }
+                catch (error) {
+                    if (debug) {
+                        console.error(`[getNews] Error fetching tab ${tab}:`, error);
+                    }
+                    // Continue with other tabs
+                }
+            }
+            if (allItems.length === 0) {
+                return { success: false, error: 'No news items found' };
+            }
+            // Limit to requested count
+            const items = allItems.slice(0, count);
+            if (withTweets) {
+                await this.enrichWithTweets(items, tweetsPerItem, includeRaw);
+            }
+            return { success: true, items };
+        }
+        /**
+         * Fetch a specific timeline tab using GenericTimelineById
+         */
+        async fetchTimelineTab(tabName, timelineId, maxCount, aiOnly, includeRaw) {
+            const queryId = await this.getQueryId('GenericTimelineById');
+            const features = buildExploreFeatures();
+            const variables = {
+                timelineId: timelineId,
+                count: maxCount * 2, // Fetch more to account for filtering
+                includePromotedContent: false,
+            };
+            const params = new URLSearchParams({
+                variables: JSON.stringify(variables),
+                features: JSON.stringify(features),
+            });
+            const url = `${TWITTER_API_BASE}/${queryId}/GenericTimelineById?${params.toString()}`;
+            const response = await this.fetchWithTimeout(url, {
+                method: 'GET',
+                headers: this.getHeaders(),
+            });
+            if (!response.ok) {
+                const text = await response.text();
+                throw new Error(`HTTP ${response.status}: ${text.slice(0, 200)}`);
+            }
+            const data = (await response.json());
+            // Debug: save response if BIRD_DEBUG_JSON is set
+            if (process.env.BIRD_DEBUG_JSON) {
+                const fs = await import('node:fs/promises');
+                const debugPath = process.env.BIRD_DEBUG_JSON.replace('.json', `-${tabName}.json`);
+                await fs.writeFile(debugPath, JSON.stringify(data, null, 2)).catch(() => { });
+            }
+            if (data.errors && data.errors.length > 0) {
+                throw new Error(data.errors.map((e) => e.message).join('; '));
+            }
+            // Parse timeline response
+            return this.parseTimelineTabItems(data, tabName, maxCount, aiOnly, includeRaw);
+        }
+        /**
+         * Parse items from a GenericTimelineById response
+         */
+        parseTimelineTabItems(
+        // biome-ignore lint/suspicious/noExplicitAny: API response structure is complex
+        data, source, maxCount, aiOnly, includeRaw) {
+            const items = [];
+            const seenHeadlines = new Set();
+            // Navigate to timeline instructions
+            const timeline = data?.data?.timeline?.timeline;
+            if (!timeline) {
+                return [];
+            }
+            const instructions = timeline.instructions || [];
+            for (const instruction of instructions) {
+                const entries = instruction.entries ?? (instruction.entry ? [instruction.entry] : []);
+                if (!entries || entries.length === 0) {
+                    continue;
+                }
+                for (const entry of entries) {
+                    if (items.length >= maxCount) {
+                        break;
+                    }
+                    const content = entry.content;
+                    if (!content) {
+                        continue;
+                    }
+                    // Handle TimelineTimelineItem (single trend item)
+                    if (content.itemContent) {
+                        const newsItem = this.parseNewsItemFromContent(content.itemContent, entry.entryId, source, seenHeadlines, aiOnly, includeRaw);
+                        if (newsItem) {
+                            items.push(newsItem);
+                        }
+                    }
+                    // Handle TimelineTimelineModule (multiple items)
+                    const itemsArray = content?.items || [];
+                    for (const data of itemsArray) {
+                        if (items.length >= maxCount) {
+                            break;
+                        }
+                        // Structure can be data.itemContent OR data.item.itemContent
+                        const itemContent = data?.itemContent || data?.item?.itemContent;
+                        if (!itemContent) {
+                            continue;
+                        }
+                        const newsItem = this.parseNewsItemFromContent(itemContent, entry.entryId, source, seenHeadlines, aiOnly, includeRaw);
+                        if (newsItem) {
+                            items.push(newsItem);
+                        }
+                    }
+                }
+            }
+            return items;
+        }
+        parseNewsItemFromContent(
+        // biome-ignore lint/suspicious/noExplicitAny: API response structure is complex
+        itemContent, entryId, source, seenHeadlines, aiOnly, includeRaw) {
+            const headline = itemContent.name || itemContent.title;
+            if (!headline) {
+                return null;
+            }
+            const trendMetadata = itemContent?.trend_metadata;
+            const trendUrl = itemContent.trend_url?.url || trendMetadata?.url?.url;
+            // Detect AI news by characteristics:
+            // 1. Full sentence headlines (contains spaces and is longer)
+            // 2. Has social_context with "News" category
+            // 3. Or explicitly marked as is_ai_trend
+            const socialContext = itemContent?.social_context?.text || '';
+            const hasNewsCategory = socialContext.includes('News') || socialContext.includes('hours ago');
+            const isFullSentence = headline.split(' ').length >= 5; // AI news are full sentences
+            const isExplicitlyAiTrend = itemContent.is_ai_trend === true;
+            const isAiNews = isExplicitlyAiTrend || (isFullSentence && hasNewsCategory);
+            // Filter AI trends if aiOnly is enabled
+            if (aiOnly && !isAiNews) {
+                return null;
+            }
+            if (seenHeadlines.has(headline)) {
+                return null;
+            }
+            seenHeadlines.add(headline);
+            let postCount;
+            let timeAgo;
+            let category = 'Trending';
+            // Parse social context for metadata
+            const socialCtx = itemContent?.social_context;
+            if (socialCtx?.text) {
+                const socialContextText = socialCtx.text;
+                const parts = socialContextText.split('·').map((s) => s.trim());
+                for (const part of parts) {
+                    if (part.includes('ago')) {
+                        timeAgo = part;
+                    }
+                    else if (part.match(POST_COUNT_REGEX)) {
+                        const match = part.match(POST_COUNT_MATCH_REGEX);
+                        if (match) {
+                            let num = Number.parseFloat(match[1]);
+                            const suffix = match[2]?.toUpperCase();
+                            if (suffix === 'K') {
+                                num *= 1000;
+                            }
+                            else if (suffix === 'M') {
+                                num *= 1_000_000;
+                            }
+                            else if (suffix === 'B') {
+                                num *= 1_000_000_000;
+                            }
+                            postCount = Math.round(num);
+                        }
+                    }
+                    else {
+                        category = part;
+                    }
+                }
+            }
+            // Parse trend metadata
+            if (trendMetadata?.meta_description) {
+                const metaDesc = trendMetadata.meta_description;
+                const postMatch = metaDesc.match(POST_COUNT_MATCH_REGEX);
+                if (postMatch) {
+                    let num = Number.parseFloat(postMatch[1]);
+                    const suffix = postMatch[2]?.toUpperCase();
+                    if (suffix === 'K') {
+                        num *= 1000;
+                    }
+                    else if (suffix === 'M') {
+                        num *= 1_000_000;
+                    }
+                    else if (suffix === 'B') {
+                        num *= 1_000_000_000;
+                    }
+                    postCount = Math.round(num);
+                }
+            }
+            if (trendMetadata?.domain_context && (category === 'Trending' || category === 'News')) {
+                category = trendMetadata.domain_context;
+            }
+            const item = {
+                id: trendUrl ?? (entryId ? `${entryId}-${headline}` : `${source}-${headline}`),
+                headline,
+                category: isAiNews ? `AI · ${category}` : category,
+                timeAgo,
+                postCount,
+                description: itemContent.description,
+                url: trendUrl,
+            };
+            if (includeRaw) {
+                item._raw = itemContent;
+            }
+            return item;
+        }
+        async enrichWithTweets(items, tweetsPerItem, includeRaw) {
+            const debug = process.env.BIRD_DEBUG === '1';
+            for (const item of items) {
+                try {
+                    const searchQuery = item.headline;
+                    if (!searchQuery) {
+                        continue;
+                    }
+                    // Use the search method if available (requires search mixin)
+                    if ('search' in this && typeof this.search === 'function') {
+                        const result = (await this.search(searchQuery, tweetsPerItem, { includeRaw }));
+                        if (result.success && result.tweets) {
+                            item.tweets = result.tweets;
+                        }
+                    }
+                }
+                catch {
+                    if (debug) {
+                        console.error('[getNews] Failed to enrich item with tweets:', item.headline);
+                    }
+                }
+            }
+        }
+    }
+    return TwitterClientNews;
+}
+//# sourceMappingURL=twitter-client-news.js.map

package/dist/lib/twitter-client-news.js.map

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

package/dist/lib/twitter-client-posting.d.ts

@@ -0,0 +1,8 @@
+import type { AbstractConstructor, Mixin, TwitterClientBase } from './twitter-client-base.js';
+import type { TweetResult } from './twitter-client-types.js';
+export interface TwitterClientPostingMethods {
+    tweet(text: string, mediaIds?: string[]): Promise<TweetResult>;
+    reply(text: string, replyToTweetId: string, mediaIds?: string[]): Promise<TweetResult>;
+}
+export declare function withPosting<TBase extends AbstractConstructor<TwitterClientBase>>(Base: TBase): Mixin<TBase, TwitterClientPostingMethods>;
+//# sourceMappingURL=twitter-client-posting.d.ts.map

package/dist/lib/twitter-client-posting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitter-client-posting.d.ts","sourceRoot":"","sources":["../../src/lib/twitter-client-posting.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG9F,OAAO,KAAK,EAAuB,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAElF,MAAM,WAAW,2BAA2B;IAC1C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACxF;AAED,wBAAgB,WAAW,CAAC,KAAK,SAAS,mBAAmB,CAAC,iBAAiB,CAAC,EAC9E,IAAI,EAAE,KAAK,GACV,KAAK,CAAC,KAAK,EAAE,2BAA2B,CAAC,CAkR3C"}

package/dist/lib/twitter-client-posting.js

@@ -0,0 +1,218 @@
+import { TWITTER_API_BASE, TWITTER_GRAPHQL_POST_URL, TWITTER_STATUS_UPDATE_URL } from './twitter-client-constants.js';
+import { buildTweetCreateFeatures } from './twitter-client-features.js';
+export function withPosting(Base) {
+    class TwitterClientPosting extends Base {
+        // biome-ignore lint/complexity/noUselessConstructor lint/suspicious/noExplicitAny: TS mixin constructor requirement.
+        constructor(...args) {
+            super(...args);
+        }
+        /**
+         * Post a new tweet
+         */
+        async tweet(text, mediaIds) {
+            const variables = {
+                tweet_text: text,
+                dark_request: false,
+                media: {
+                    media_entities: (mediaIds ?? []).map((id) => ({ media_id: id, tagged_users: [] })),
+                    possibly_sensitive: false,
+                },
+                semantic_annotation_ids: [],
+            };
+            const features = buildTweetCreateFeatures();
+            return this.createTweet(variables, features);
+        }
+        /**
+         * Reply to an existing tweet
+         */
+        async reply(text, replyToTweetId, mediaIds) {
+            const variables = {
+                tweet_text: text,
+                reply: {
+                    in_reply_to_tweet_id: replyToTweetId,
+                    exclude_reply_user_ids: [],
+                },
+                dark_request: false,
+                media: {
+                    media_entities: (mediaIds ?? []).map((id) => ({ media_id: id, tagged_users: [] })),
+                    possibly_sensitive: false,
+                },
+                semantic_annotation_ids: [],
+            };
+            const features = buildTweetCreateFeatures();
+            return this.createTweet(variables, features);
+        }
+        async createTweet(variables, features) {
+            await this.ensureClientUserId();
+            let queryId = await this.getQueryId('CreateTweet');
+            let urlWithOperation = `${TWITTER_API_BASE}/${queryId}/CreateTweet`;
+            const buildBody = () => JSON.stringify({ variables, features, queryId });
+            let body = buildBody();
+            try {
+                const headers = { ...this.getHeaders(), referer: 'https://x.com/compose/post' };
+                let response = await this.fetchWithTimeout(urlWithOperation, {
+                    method: 'POST',
+                    headers,
+                    body,
+                });
+                // Twitter increasingly prefers POST to /i/api/graphql with queryId in the payload.
+                // If the operation URL 404s, retry the generic endpoint.
+                if (response.status === 404) {
+                    await this.refreshQueryIds();
+                    queryId = await this.getQueryId('CreateTweet');
+                    urlWithOperation = `${TWITTER_API_BASE}/${queryId}/CreateTweet`;
+                    body = buildBody();
+                    response = await this.fetchWithTimeout(urlWithOperation, {
+                        method: 'POST',
+                        headers: { ...this.getHeaders(), referer: 'https://x.com/compose/post' },
+                        body,
+                    });
+                    if (response.status === 404) {
+                        const retry = await this.fetchWithTimeout(TWITTER_GRAPHQL_POST_URL, {
+                            method: 'POST',
+                            headers: { ...this.getHeaders(), referer: 'https://x.com/compose/post' },
+                            body,
+                        });
+                        if (!retry.ok) {
+                            const text = await retry.text();
+                            return { success: false, error: `HTTP ${retry.status}: ${text.slice(0, 200)}` };
+                        }
+                        const data = (await retry.json());
+                        if (data.errors && data.errors.length > 0) {
+                            const fallback = await this.tryStatusUpdateFallback(data.errors, variables);
+                            if (fallback) {
+                                return fallback;
+                            }
+                            return { success: false, error: this.formatErrors(data.errors) };
+                        }
+                        const tweetId = data.data?.create_tweet?.tweet_results?.result?.rest_id;
+                        if (tweetId) {
+                            return { success: true, tweetId };
+                        }
+                        return { success: false, error: 'Tweet created but no ID returned' };
+                    }
+                }
+                if (!response.ok) {
+                    const text = await response.text();
+                    return {
+                        success: false,
+                        error: `HTTP ${response.status}: ${text.slice(0, 200)}`,
+                    };
+                }
+                const data = (await response.json());
+                if (data.errors && data.errors.length > 0) {
+                    const fallback = await this.tryStatusUpdateFallback(data.errors, variables);
+                    if (fallback) {
+                        return fallback;
+                    }
+                    return {
+                        success: false,
+                        error: this.formatErrors(data.errors),
+                    };
+                }
+                const tweetId = data.data?.create_tweet?.tweet_results?.result?.rest_id;
+                if (tweetId) {
+                    return {
+                        success: true,
+                        tweetId,
+                    };
+                }
+                return {
+                    success: false,
+                    error: 'Tweet created but no ID returned',
+                };
+            }
+            catch (error) {
+                return {
+                    success: false,
+                    error: error instanceof Error ? error.message : String(error),
+                };
+            }
+        }
+        formatErrors(errors) {
+            return errors
+                .map((error) => (typeof error.code === 'number' ? `${error.message} (${error.code})` : error.message))
+                .join(', ');
+        }
+        statusUpdateInputFromCreateTweetVariables(variables) {
+            const text = typeof variables.tweet_text === 'string' ? variables.tweet_text : null;
+            if (!text) {
+                return null;
+            }
+            const reply = variables.reply;
+            const inReplyToTweetId = reply &&
+                typeof reply === 'object' &&
+                typeof reply.in_reply_to_tweet_id === 'string'
+                ? reply.in_reply_to_tweet_id
+                : undefined;
+            const media = variables.media;
+            const mediaEntities = media && typeof media === 'object' ? media.media_entities : undefined;
+            const mediaIds = Array.isArray(mediaEntities)
+                ? mediaEntities
+                    .map((entity) => entity && typeof entity === 'object' && 'media_id' in entity
+                    ? entity.media_id
+                    : undefined)
+                    .filter((value) => typeof value === 'string' || typeof value === 'number')
+                    .map((value) => String(value))
+                : undefined;
+            return { text, inReplyToTweetId, mediaIds: mediaIds && mediaIds.length > 0 ? mediaIds : undefined };
+        }
+        async postStatusUpdate(input) {
+            const params = new URLSearchParams();
+            params.set('status', input.text);
+            if (input.inReplyToTweetId) {
+                params.set('in_reply_to_status_id', input.inReplyToTweetId);
+                params.set('auto_populate_reply_metadata', 'true');
+            }
+            if (input.mediaIds && input.mediaIds.length > 0) {
+                params.set('media_ids', input.mediaIds.join(','));
+            }
+            try {
+                const response = await this.fetchWithTimeout(TWITTER_STATUS_UPDATE_URL, {
+                    method: 'POST',
+                    headers: {
+                        ...this.getBaseHeaders(),
+                        'content-type': 'application/x-www-form-urlencoded',
+                        referer: 'https://x.com/compose/post',
+                    },
+                    body: params.toString(),
+                });
+                if (!response.ok) {
+                    const text = await response.text();
+                    return { success: false, error: `HTTP ${response.status}: ${text.slice(0, 200)}` };
+                }
+                const data = (await response.json());
+                if (data.errors && data.errors.length > 0) {
+                    return { success: false, error: this.formatErrors(data.errors) };
+                }
+                const tweetId = typeof data.id_str === 'string' ? data.id_str : data.id !== undefined ? String(data.id) : undefined;
+                if (tweetId) {
+                    return { success: true, tweetId };
+                }
+                return { success: false, error: 'Tweet created but no ID returned' };
+            }
+            catch (error) {
+                return { success: false, error: error instanceof Error ? error.message : String(error) };
+            }
+        }
+        async tryStatusUpdateFallback(errors, variables) {
+            if (!errors.some((error) => error.code === 226)) {
+                return null;
+            }
+            const input = this.statusUpdateInputFromCreateTweetVariables(variables);
+            if (!input) {
+                return null;
+            }
+            const fallback = await this.postStatusUpdate(input);
+            if (fallback.success) {
+                return fallback;
+            }
+            return {
+                success: false,
+                error: `${this.formatErrors(errors)} | fallback: ${fallback.error ?? 'Unknown error'}`,
+            };
+        }
+    }
+    return TwitterClientPosting;
+}
+//# sourceMappingURL=twitter-client-posting.js.map

package/dist/lib/twitter-client-posting.js.map

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

package/dist/lib/twitter-client-search.d.ts

@@ -0,0 +1,19 @@
+import type { AbstractConstructor, Mixin, TwitterClientBase } from './twitter-client-base.js';
+import type { SearchResult } from './twitter-client-types.js';
+/** Options for search methods */
+export interface SearchFetchOptions {
+    /** Include raw GraphQL response in `_raw` field */
+    includeRaw?: boolean;
+}
+/** Options for paged search methods */
+export interface SearchPaginationOptions extends SearchFetchOptions {
+    maxPages?: number;
+    /** Starting cursor for pagination (resume from previous fetch) */
+    cursor?: string;
+}
+export interface TwitterClientSearchMethods {
+    search(query: string, count?: number, options?: SearchFetchOptions): Promise<SearchResult>;
+    getAllSearchResults(query: string, options?: SearchPaginationOptions): Promise<SearchResult>;
+}
+export declare function withSearch<TBase extends AbstractConstructor<TwitterClientBase>>(Base: TBase): Mixin<TBase, TwitterClientSearchMethods>;
+//# sourceMappingURL=twitter-client-search.d.ts.map

package/dist/lib/twitter-client-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"twitter-client-search.d.ts","sourceRoot":"","sources":["../../src/lib/twitter-client-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG9F,OAAO,KAAK,EAAE,YAAY,EAAa,MAAM,2BAA2B,CAAC;AAKzE,iCAAiC;AACjC,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,uCAAuC;AACvC,MAAM,WAAW,uBAAwB,SAAQ,kBAAkB;IACjE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAC3F,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC9F;AAuBD,wBAAgB,UAAU,CAAC,KAAK,SAAS,mBAAmB,CAAC,iBAAiB,CAAC,EAC7E,IAAI,EAAE,KAAK,GACV,KAAK,CAAC,KAAK,EAAE,0BAA0B,CAAC,CA0M1C"}