@zenalexa/unicli 0.219.0 → 0.220.1

package/dist/adapters/tvmaze/shows.js

@@ -0,0 +1,240 @@
+/**
+ * @owner   src/adapters/tvmaze/shows.ts
+ * @does    Register agent-facing TVmaze show search and detail commands.
+ * @needs   TVmaze public API, bounded search limits, positive show ids.
+ * @feeds   surface coverage ledger, TV show reference rows, cross-reference ids.
+ * @breaks  TVmaze API drift, weak id validation, or silent empty rows hide show lookup failures.
+ */
+import { cli, Strategy } from "../../registry.js";
+const API_BASE = "https://api.tvmaze.com";
+function requireNonEmpty(value, label) {
+    const text = String(value ?? "").trim();
+    if (!text)
+        throw new Error(`tvmaze ${label} cannot be empty.`);
+    return text;
+}
+export function requireTvmazeLimit(value) {
+    const raw = value === undefined || value === null || value === "" ? 20 : value;
+    const limit = Number(raw);
+    if (!Number.isInteger(limit) || limit < 1 || limit > 50) {
+        throw new Error("tvmaze limit must be an integer in [1, 50].");
+    }
+    return limit;
+}
+export function requireTvmazeShowId(value) {
+    const id = Number(String(value ?? "").trim());
+    if (!Number.isInteger(id) || id < 1) {
+        throw new Error("tvmaze show id must be a positive integer.");
+    }
+    return id;
+}
+function objectField(value) {
+    return value && typeof value === "object"
+        ? value
+        : {};
+}
+function stringField(value) {
+    return typeof value === "string" ? value.trim() : "";
+}
+function numberField(value) {
+    const n = typeof value === "number"
+        ? value
+        : typeof value === "string" && value.trim()
+            ? Number(value)
+            : NaN;
+    return Number.isFinite(n) ? n : null;
+}
+function joinList(value) {
+    return Array.isArray(value)
+        ? value.filter((item) => typeof item === "string" && item.trim()).join(", ")
+        : "";
+}
+const HTML_ENTITY_MAP = {
+    amp: "&",
+    apos: "'",
+    gt: ">",
+    lt: "<",
+    nbsp: " ",
+    quot: '"',
+};
+export function stripTvmazeHtml(value) {
+    return String(value ?? "")
+        .replace(/<[^>]+>/g, "")
+        .replace(/&#x([0-9a-fA-F]+);/g, (_match, hex) => {
+        const code = Number.parseInt(hex, 16);
+        return Number.isFinite(code) ? String.fromCodePoint(code) : "";
+    })
+        .replace(/&#(\d+);/g, (_match, dec) => {
+        const code = Number.parseInt(dec, 10);
+        return Number.isFinite(code) ? String.fromCodePoint(code) : "";
+    })
+        .replace(/&([a-zA-Z]+);/g, (match, name) => HTML_ENTITY_MAP[name] ?? match)
+        .replace(/\s+/g, " ")
+        .trim();
+}
+function networkName(show) {
+    const network = objectField(show.network);
+    const webChannel = objectField(show.webChannel);
+    return stringField(network.name) || stringField(webChannel.name);
+}
+function countryName(show) {
+    const networkCountry = objectField(objectField(show.network).country);
+    const webCountry = objectField(objectField(show.webChannel).country);
+    return stringField(networkCountry.name) || stringField(webCountry.name);
+}
+function ratingAverage(show) {
+    return numberField(objectField(show.rating).average);
+}
+export function mapTvmazeSearchRows(entries, limit) {
+    return entries.slice(0, limit).map((entry, index) => {
+        const show = objectField(entry.show);
+        return {
+            rank: index + 1,
+            id: numberField(show.id),
+            name: stringField(show.name),
+            type: stringField(show.type),
+            language: stringField(show.language),
+            genres: joinList(show.genres),
+            status: stringField(show.status),
+            premiered: stringField(show.premiered),
+            ended: stringField(show.ended),
+            network: networkName(show),
+            rating: ratingAverage(show),
+            matchScore: numberField(entry.score),
+            summary: stripTvmazeHtml(show.summary),
+            url: stringField(show.url),
+        };
+    });
+}
+export function mapTvmazeShowRow(show) {
+    const schedule = objectField(show.schedule);
+    const days = joinList(schedule.days);
+    const time = stringField(schedule.time);
+    const externals = objectField(show.externals);
+    return {
+        id: numberField(show.id),
+        name: stringField(show.name),
+        type: stringField(show.type),
+        language: stringField(show.language),
+        genres: joinList(show.genres),
+        status: stringField(show.status),
+        premiered: stringField(show.premiered),
+        ended: stringField(show.ended),
+        runtime: numberField(show.runtime),
+        averageRuntime: numberField(show.averageRuntime),
+        network: networkName(show),
+        country: countryName(show),
+        schedule: days || time ? `${days}${days && time ? " " : ""}${time}`.trim() : "",
+        rating: ratingAverage(show),
+        imdb: stringField(externals.imdb),
+        thetvdb: numberField(externals.thetvdb),
+        officialSite: stringField(show.officialSite),
+        summary: stripTvmazeHtml(show.summary),
+        url: stringField(show.url),
+    };
+}
+async function fetchJson(url, label) {
+    const response = await fetch(url, {
+        headers: {
+            accept: "application/json",
+            "user-agent": "unicli-tvmaze (https://github.com/olo-dot-io/Uni-CLI)",
+        },
+    });
+    if (response.status === 404)
+        throw new Error(`${label} returned no result.`);
+    if (response.status === 429)
+        throw new Error(`${label} returned HTTP 429.`);
+    if (!response.ok)
+        throw new Error(`${label} returned HTTP ${response.status}.`);
+    return response.json();
+}
+cli({
+    site: "tvmaze",
+    name: "search",
+    description: "Search TVmaze shows by title",
+    domain: "tvmaze.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "query",
+            type: "str",
+            required: true,
+            positional: true,
+            description: "TV show title or fragment",
+        },
+        { name: "limit", type: "int", default: 20, description: "Max rows" },
+    ],
+    columns: [
+        "rank",
+        "id",
+        "name",
+        "type",
+        "language",
+        "genres",
+        "status",
+        "premiered",
+        "ended",
+        "network",
+        "rating",
+        "matchScore",
+        "summary",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const query = requireNonEmpty(kwargs.query, "query");
+        const limit = requireTvmazeLimit(kwargs.limit);
+        const url = new URL(`${API_BASE}/search/shows`);
+        url.searchParams.set("q", query);
+        const body = await fetchJson(url, "tvmaze search");
+        const rows = mapTvmazeSearchRows(Array.isArray(body) ? body : [], limit);
+        if (rows.length === 0) {
+            throw new Error(`tvmaze search returned no rows for "${query}".`);
+        }
+        return rows;
+    },
+});
+cli({
+    site: "tvmaze",
+    name: "show",
+    description: "Fetch TVmaze show detail by id",
+    domain: "tvmaze.com",
+    strategy: Strategy.PUBLIC,
+    args: [
+        {
+            name: "id",
+            type: "int",
+            required: true,
+            positional: true,
+            description: "TVmaze show id",
+        },
+    ],
+    columns: [
+        "id",
+        "name",
+        "type",
+        "language",
+        "genres",
+        "status",
+        "premiered",
+        "ended",
+        "runtime",
+        "averageRuntime",
+        "network",
+        "country",
+        "schedule",
+        "rating",
+        "imdb",
+        "thetvdb",
+        "officialSite",
+        "summary",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const id = requireTvmazeShowId(kwargs.id);
+        const body = objectField(await fetchJson(`${API_BASE}/shows/${id}`, "tvmaze show"));
+        if (body.id == null)
+            throw new Error(`tvmaze show returned no row for id ${id}.`);
+        return [mapTvmazeShowRow(body)];
+    },
+});
+//# sourceMappingURL=shows.js.map

package/dist/adapters/tvmaze/shows.js.map

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

package/dist/adapters/twitter/bookmark-folders.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @owner   src/adapters/twitter/bookmark-folders.ts
+ * @does    Register agent-facing Twitter/X bookmark folder listing and folder timeline commands.
+ * @needs   Twitter cookie auth with ct0/auth_token available to the shared GraphQL client.
+ * @feeds   surface coverage ledger and bookmark folder analysis workflows.
+ * @breaks  X GraphQL query ID rotation, bookmark collection response shape drift, or Premium folder access changes.
+ */
+interface TwitterBookmarkFolderRow {
+    id: string;
+    name: string;
+    items: number;
+    created_at: string;
+}
+interface TwitterBookmarkFolderTweetRow {
+    id: string;
+    author: string;
+    text: string;
+    likes: number;
+    retweets: number;
+    bookmarks: number;
+    created_at: string;
+    url: string;
+}
+export declare function requireTwitterBookmarkFolderId(value: unknown): string;
+export declare function requireTwitterBookmarkLimit(value: unknown, fallback?: number): number;
+export declare function parseTwitterBookmarkFolders(data: unknown): TwitterBookmarkFolderRow[];
+export declare function parseTwitterBookmarkFolderTimeline(data: unknown): {
+    tweets: TwitterBookmarkFolderTweetRow[];
+    nextCursor: string | null;
+};
+export declare function applyTwitterTopByEngagement(rows: TwitterBookmarkFolderTweetRow[], value: unknown): TwitterBookmarkFolderTweetRow[];
+export {};
+//# sourceMappingURL=bookmark-folders.d.ts.map

package/dist/adapters/twitter/bookmark-folders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookmark-folders.d.ts","sourceRoot":"","sources":["../../../src/adapters/twitter/bookmark-folders.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiDH,UAAU,wBAAwB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,UAAU,6BAA6B;IACrC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQrE;AAED,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,QAAQ,SAAK,GACZ,MAAM,CAQR;AAuBD,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,OAAO,GACZ,wBAAwB,EAAE,CAkD5B;AAsCD,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,OAAO,GAAG;IACjE,MAAM,EAAE,6BAA6B,EAAE,CAAC;IACxC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAkEA;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,6BAA6B,EAAE,EACrC,KAAK,EAAE,OAAO,GACb,6BAA6B,EAAE,CAUjC"}

package/dist/adapters/twitter/bookmark-folders.js

@@ -0,0 +1,290 @@
+/**
+ * @owner   src/adapters/twitter/bookmark-folders.ts
+ * @does    Register agent-facing Twitter/X bookmark folder listing and folder timeline commands.
+ * @needs   Twitter cookie auth with ct0/auth_token available to the shared GraphQL client.
+ * @feeds   surface coverage ledger and bookmark folder analysis workflows.
+ * @breaks  X GraphQL query ID rotation, bookmark collection response shape drift, or Premium folder access changes.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { twitterFetch } from "./client.js";
+const FOLDERS_ENDPOINT = "bookmarkFoldersSlice";
+const FOLDERS_QUERY_ID = "i78YDd0Tza-dWKw5H2Y7WA";
+const FOLDER_TIMELINE_ENDPOINT = "BookmarkFolderTimeline";
+const FOLDER_TIMELINE_QUERY_ID = "13H7EUATwethsj_jZ6QQAQ";
+const FOLDER_ID_RE = /^[A-Za-z0-9_-]+$/;
+const FOLDERS_FEATURES = {
+    rweb_tipjar_consumption_enabled: false,
+    responsive_web_graphql_exclude_directive_enabled: true,
+    verified_phone_label_enabled: false,
+    creator_subscriptions_tweet_preview_api_enabled: true,
+    responsive_web_graphql_timeline_navigation_enabled: true,
+    responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+};
+const FOLDER_TIMELINE_FEATURES = {
+    rweb_video_screen_enabled: false,
+    profile_label_improvements_pcf_label_in_post_enabled: true,
+    responsive_web_profile_redirect_enabled: false,
+    rweb_tipjar_consumption_enabled: false,
+    verified_phone_label_enabled: false,
+    creator_subscriptions_tweet_preview_api_enabled: true,
+    responsive_web_graphql_timeline_navigation_enabled: true,
+    responsive_web_graphql_skip_user_profile_image_extensions_enabled: false,
+    premium_content_api_read_enabled: false,
+    communities_web_enable_tweet_community_results_fetch: true,
+    c9s_tweet_anatomy_moderator_badge_enabled: true,
+    articles_preview_enabled: true,
+    responsive_web_edit_tweet_api_enabled: true,
+    graphql_is_translatable_rweb_tweet_is_translatable_enabled: true,
+    view_counts_everywhere_api_enabled: true,
+    longform_notetweets_consumption_enabled: true,
+    responsive_web_twitter_article_tweet_consumption_enabled: true,
+    tweet_awards_web_tipping_enabled: false,
+    content_disclosure_indicator_enabled: true,
+    content_disclosure_ai_generated_indicator_enabled: true,
+    freedom_of_speech_not_reach_fetch_enabled: true,
+    standardized_nudges_misinfo: true,
+    tweet_with_visibility_results_prefer_gql_limited_actions_policy_enabled: true,
+    longform_notetweets_rich_text_read_enabled: true,
+    longform_notetweets_inline_media_enabled: false,
+    responsive_web_enhance_cards_enabled: false,
+};
+export function requireTwitterBookmarkFolderId(value) {
+    const folderId = String(value ?? "").trim();
+    if (!folderId || !FOLDER_ID_RE.test(folderId)) {
+        throw new Error(`Twitter bookmark folder-id must be a safe folder ID from twitter/bookmark-folders.`);
+    }
+    return folderId;
+}
+export function requireTwitterBookmarkLimit(value, fallback = 20) {
+    const limit = Number(value ?? fallback);
+    if (!Number.isInteger(limit) || limit < 1) {
+        throw new Error("Twitter bookmark-folder limit must be a positive integer.");
+    }
+    return Math.min(limit, 250);
+}
+function asRecord(value) {
+    return value && typeof value === "object"
+        ? value
+        : null;
+}
+function readPath(value, path) {
+    let current = value;
+    for (const key of path) {
+        const record = asRecord(current);
+        if (!record)
+            return undefined;
+        current = record[key];
+    }
+    return current;
+}
+function numberValue(value) {
+    const n = Number(value);
+    return Number.isFinite(n) ? n : 0;
+}
+export function parseTwitterBookmarkFolders(data) {
+    const seen = new Set();
+    const rows = [];
+    const slice = readPath(data, ["data", "viewer", "bookmark_collections_slice"]) ??
+        readPath(data, [
+            "data",
+            "viewer_v2",
+            "user_results",
+            "result",
+            "bookmark_collections_slice",
+        ]) ??
+        readPath(data, ["data", "bookmark_collections_slice"]);
+    const sliceRecord = asRecord(slice);
+    const directItems = Array.isArray(sliceRecord?.items)
+        ? sliceRecord.items
+        : [];
+    const instructions = readPath(sliceRecord, [
+        "timeline",
+        "timeline",
+        "instructions",
+    ]);
+    const timelineItems = Array.isArray(instructions)
+        ? instructions.flatMap((instruction) => {
+            const entries = asRecord(instruction)?.entries;
+            return Array.isArray(entries) ? entries : [];
+        })
+        : [];
+    for (const item of [...directItems, ...timelineItems]) {
+        const itemRecord = asRecord(item);
+        const content = asRecord(itemRecord?.content);
+        const itemContent = asRecord(content?.itemContent);
+        const folder = asRecord(itemRecord?.bookmarkCollection) ??
+            asRecord(content?.bookmarkCollection) ??
+            asRecord(itemContent?.bookmark_collection) ??
+            itemRecord;
+        const id = String(folder?.id_str ?? folder?.id ?? folder?.rest_id ?? "");
+        if (!id || seen.has(id))
+            continue;
+        seen.add(id);
+        rows.push({
+            id,
+            name: String(folder?.name ?? folder?.collection_name ?? ""),
+            items: numberValue(folder?.bookmarks_count ?? folder?.items_count ?? folder?.count),
+            created_at: String(folder?.created_at ?? folder?.timestamp_ms ?? ""),
+        });
+    }
+    return rows;
+}
+function extractFolderTweet(value, seen) {
+    const result = asRecord(value);
+    const tweet = asRecord(result?.tweet) ?? result;
+    if (!tweet)
+        return null;
+    const id = String(tweet.rest_id ?? "");
+    if (!id || seen.has(id))
+        return null;
+    seen.add(id);
+    const legacy = asRecord(tweet.legacy) ?? {};
+    const user = asRecord(readPath(tweet, ["core", "user_results", "result"])) ?? {};
+    const userLegacy = asRecord(user.legacy) ?? {};
+    const userCore = asRecord(user.core) ?? {};
+    const author = String(userLegacy.screen_name ?? userCore.screen_name ?? "");
+    const noteText = readPath(tweet, [
+        "note_tweet",
+        "note_tweet_results",
+        "result",
+        "text",
+    ]);
+    return {
+        id,
+        author,
+        text: String(noteText ?? legacy.full_text ?? ""),
+        likes: numberValue(legacy.favorite_count),
+        retweets: numberValue(legacy.retweet_count),
+        bookmarks: numberValue(legacy.bookmark_count),
+        created_at: String(legacy.created_at ?? ""),
+        url: author
+            ? `https://x.com/${author}/status/${id}`
+            : `https://x.com/i/status/${id}`,
+    };
+}
+export function parseTwitterBookmarkFolderTimeline(data) {
+    const seen = new Set();
+    const tweets = [];
+    let nextCursor = null;
+    const instructions = readPath(data, [
+        "data",
+        "bookmark_collection_timeline",
+        "timeline",
+        "instructions",
+    ]) ??
+        readPath(data, [
+            "data",
+            "bookmark_timeline_v2",
+            "timeline",
+            "instructions",
+        ]) ??
+        readPath(data, ["data", "bookmark_timeline", "timeline", "instructions"]);
+    const items = Array.isArray(instructions) ? instructions : [];
+    for (const instruction of items) {
+        const entries = asRecord(instruction)?.entries;
+        if (!Array.isArray(entries))
+            continue;
+        for (const entry of entries) {
+            const entryRecord = asRecord(entry);
+            const content = asRecord(entryRecord?.content);
+            const entryId = String(entryRecord?.entryId ?? "");
+            if (content?.entryType === "TimelineTimelineCursor" ||
+                content?.__typename === "TimelineTimelineCursor") {
+                if (content.cursorType === "Bottom" ||
+                    content.cursorType === "ShowMore") {
+                    nextCursor = String(content.value ?? "") || nextCursor;
+                }
+                continue;
+            }
+            if (entryId.startsWith("cursor-bottom-") ||
+                entryId.startsWith("cursor-showMore-")) {
+                const itemContent = asRecord(content?.itemContent);
+                nextCursor =
+                    String(content?.value ?? itemContent?.value ?? "") || nextCursor;
+                continue;
+            }
+            const direct = extractFolderTweet(readPath(content, ["itemContent", "tweet_results", "result"]), seen);
+            if (direct) {
+                tweets.push(direct);
+                continue;
+            }
+            const nestedItems = Array.isArray(content?.items) ? content.items : [];
+            for (const item of nestedItems) {
+                const nested = extractFolderTweet(readPath(item, ["item", "itemContent", "tweet_results", "result"]), seen);
+                if (nested)
+                    tweets.push(nested);
+            }
+        }
+    }
+    return { tweets, nextCursor };
+}
+export function applyTwitterTopByEngagement(rows, value) {
+    const top = Number(value ?? 0);
+    if (!Number.isInteger(top) || top <= 0)
+        return rows;
+    return [...rows]
+        .sort((a, b) => {
+        const scoreA = a.likes + a.retweets * 3 + a.bookmarks * 5;
+        const scoreB = b.likes + b.retweets * 3 + b.bookmarks * 5;
+        return scoreB - scoreA;
+    })
+        .slice(0, top);
+}
+cli({
+    site: "twitter",
+    name: "bookmark-folders",
+    description: "List Twitter/X bookmark folders",
+    domain: "x.com",
+    strategy: Strategy.COOKIE,
+    args: [],
+    columns: ["id", "name", "items", "created_at"],
+    func: async () => {
+        const data = await twitterFetch(FOLDERS_ENDPOINT, FOLDERS_QUERY_ID, {}, FOLDERS_FEATURES);
+        return parseTwitterBookmarkFolders(data);
+    },
+});
+cli({
+    site: "twitter",
+    name: "bookmark-folder",
+    description: "Read tweets inside a Twitter/X bookmark folder",
+    domain: "x.com",
+    strategy: Strategy.COOKIE,
+    args: [
+        { name: "folder-id", type: "str", required: true, positional: true },
+        { name: "limit", type: "int", default: 20 },
+        { name: "top-by-engagement", type: "int", default: 0 },
+    ],
+    columns: [
+        "id",
+        "author",
+        "text",
+        "likes",
+        "retweets",
+        "bookmarks",
+        "created_at",
+        "url",
+    ],
+    func: async (_page, kwargs) => {
+        const folderId = requireTwitterBookmarkFolderId(kwargs["folder-id"]);
+        const limit = requireTwitterBookmarkLimit(kwargs.limit);
+        const rows = [];
+        let cursor = "";
+        for (let pageIndex = 0; pageIndex < 5 && rows.length < limit; pageIndex += 1) {
+            const variables = {
+                bookmark_collection_id: folderId,
+                count: Math.min(100, limit - rows.length + 10),
+                includePromotedContent: false,
+            };
+            if (cursor)
+                variables.cursor = cursor;
+            const data = await twitterFetch(FOLDER_TIMELINE_ENDPOINT, FOLDER_TIMELINE_QUERY_ID, variables, FOLDER_TIMELINE_FEATURES);
+            const parsed = parseTwitterBookmarkFolderTimeline(data);
+            rows.push(...parsed.tweets);
+            if (!parsed.nextCursor || parsed.nextCursor === cursor)
+                break;
+            cursor = parsed.nextCursor;
+        }
+        return applyTwitterTopByEngagement(rows.slice(0, limit), kwargs["top-by-engagement"]);
+    },
+});
+//# sourceMappingURL=bookmark-folders.js.map

package/dist/adapters/twitter/bookmark-folders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bookmark-folders.js","sourceRoot":"","sources":["../../../src/adapters/twitter/bookmark-folders.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,gBAAgB,GAAG,sBAAsB,CAAC;AAChD,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAClD,MAAM,wBAAwB,GAAG,wBAAwB,CAAC;AAC1D,MAAM,wBAAwB,GAAG,wBAAwB,CAAC;AAC1D,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAExC,MAAM,gBAAgB,GAA4B;IAChD,+BAA+B,EAAE,KAAK;IACtC,gDAAgD,EAAE,IAAI;IACtD,4BAA4B,EAAE,KAAK;IACnC,+CAA+C,EAAE,IAAI;IACrD,kDAAkD,EAAE,IAAI;IACxD,iEAAiE,EAAE,KAAK;CACzE,CAAC;AAEF,MAAM,wBAAwB,GAA4B;IACxD,yBAAyB,EAAE,KAAK;IAChC,oDAAoD,EAAE,IAAI;IAC1D,uCAAuC,EAAE,KAAK;IAC9C,+BAA+B,EAAE,KAAK;IACtC,4BAA4B,EAAE,KAAK;IACnC,+CAA+C,EAAE,IAAI;IACrD,kDAAkD,EAAE,IAAI;IACxD,iEAAiE,EAAE,KAAK;IACxE,gCAAgC,EAAE,KAAK;IACvC,oDAAoD,EAAE,IAAI;IAC1D,yCAAyC,EAAE,IAAI;IAC/C,wBAAwB,EAAE,IAAI;IAC9B,qCAAqC,EAAE,IAAI;IAC3C,0DAA0D,EAAE,IAAI;IAChE,kCAAkC,EAAE,IAAI;IACxC,uCAAuC,EAAE,IAAI;IAC7C,wDAAwD,EAAE,IAAI;IAC9D,gCAAgC,EAAE,KAAK;IACvC,oCAAoC,EAAE,IAAI;IAC1C,iDAAiD,EAAE,IAAI;IACvD,yCAAyC,EAAE,IAAI;IAC/C,2BAA2B,EAAE,IAAI;IACjC,uEAAuE,EAAE,IAAI;IAC7E,0CAA0C,EAAE,IAAI;IAChD,wCAAwC,EAAE,KAAK;IAC/C,oCAAoC,EAAE,KAAK;CAC5C,CAAC;AAoBF,MAAM,UAAU,8BAA8B,CAAC,KAAc;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,KAAc,EACd,QAAQ,GAAG,EAAE;IAEb,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QACvC,CAAC,CAAE,KAAiC;QACpC,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc,EAAE,IAAc;IAC9C,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QAC9B,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,IAAa;IAEb,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAA+B,EAAE,CAAC;IAC5C,MAAM,KAAK,GACT,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,4BAA4B,CAAC,CAAC;QAChE,QAAQ,CAAC,IAAI,EAAE;YACb,MAAM;YACN,WAAW;YACX,cAAc;YACd,QAAQ;YACR,4BAA4B;SAC7B,CAAC;QACF,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC,CAAC;IACzD,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC;QACnD,CAAC,CAAC,WAAW,CAAC,KAAK;QACnB,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,YAAY,GAAG,QAAQ,CAAC,WAAW,EAAE;QACzC,UAAU;QACV,UAAU;QACV,cAAc;KACf,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;QAC/C,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE;YACnC,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;YAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/C,CAAC,CAAC;QACJ,CAAC,CAAC,EAAE,CAAC;IACP,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,WAAW,EAAE,GAAG,aAAa,CAAC,EAAE,CAAC;QACtD,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,OAAO,GAAG,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC9C,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;QACnD,MAAM,MAAM,GACV,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;YACxC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;YACrC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;YAC1C,UAAU,CAAC;QACb,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,IAAI,MAAM,EAAE,EAAE,IAAI,MAAM,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAClC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACb,IAAI,CAAC,IAAI,CAAC;YACR,EAAE;YACF,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,MAAM,EAAE,eAAe,IAAI,EAAE,CAAC;YAC3D,KAAK,EAAE,WAAW,CAChB,MAAM,EAAE,eAAe,IAAI,MAAM,EAAE,WAAW,IAAI,MAAM,EAAE,KAAK,CAChE;YACD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,IAAI,MAAM,EAAE,YAAY,IAAI,EAAE,CAAC;SACrE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAc,EACd,IAAiB;IAEjB,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC;IAChD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;IACvC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACb,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,IAAI,GACR,QAAQ,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACtE,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3C,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,EAAE;QAC/B,YAAY;QACZ,oBAAoB;QACpB,QAAQ;QACR,MAAM;KACP,CAAC,CAAC;IACH,OAAO;QACL,EAAE;QACF,MAAM;QACN,IAAI,EAAE,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC;QAChD,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC;QACzC,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,aAAa,CAAC;QAC3C,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC;QAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC;QAC3C,GAAG,EAAE,MAAM;YACT,CAAC,CAAC,iBAAiB,MAAM,WAAW,EAAE,EAAE;YACxC,CAAC,CAAC,0BAA0B,EAAE,EAAE;KACnC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kCAAkC,CAAC,IAAa;IAI9D,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,MAAM,GAAoC,EAAE,CAAC;IACnD,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,MAAM,YAAY,GAChB,QAAQ,CAAC,IAAI,EAAE;QACb,MAAM;QACN,8BAA8B;QAC9B,UAAU;QACV,cAAc;KACf,CAAC;QACF,QAAQ,CAAC,IAAI,EAAE;YACb,MAAM;YACN,sBAAsB;YACtB,UAAU;YACV,cAAc;SACf,CAAC;QACF,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,mBAAmB,EAAE,UAAU,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5E,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,KAAK,MAAM,WAAW,IAAI,KAAK,EAAE,CAAC;QAChC,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,WAAW,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;YACnD,IACE,OAAO,EAAE,SAAS,KAAK,wBAAwB;gBAC/C,OAAO,EAAE,UAAU,KAAK,wBAAwB,EAChD,CAAC;gBACD,IACE,OAAO,CAAC,UAAU,KAAK,QAAQ;oBAC/B,OAAO,CAAC,UAAU,KAAK,UAAU,EACjC,CAAC;oBACD,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,UAAU,CAAC;gBACzD,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IACE,OAAO,CAAC,UAAU,CAAC,gBAAgB,CAAC;gBACpC,OAAO,CAAC,UAAU,CAAC,kBAAkB,CAAC,EACtC,CAAC;gBACD,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;gBACnD,UAAU;oBACR,MAAM,CAAC,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,UAAU,CAAC;gBACnE,SAAS;YACX,CAAC;YACD,MAAM,MAAM,GAAG,kBAAkB,CAC/B,QAAQ,CAAC,OAAO,EAAE,CAAC,aAAa,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,EAC7D,IAAI,CACL,CAAC;YACF,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;gBACpB,SAAS;YACX,CAAC;YACD,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACvE,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,kBAAkB,CAC/B,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,EAClE,IAAI,CACL,CAAC;gBACF,IAAI,MAAM;oBAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,IAAqC,EACrC,KAAc;IAEd,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACpD,OAAO,CAAC,GAAG,IAAI,CAAC;SACb,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACb,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC;QAC1D,OAAO,MAAM,GAAG,MAAM,CAAC;IACzB,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,kBAAkB;IACxB,WAAW,EAAE,iCAAiC;IAC9C,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC;IAC9C,IAAI,EAAE,KAAK,IAAI,EAAE;QACf,MAAM,IAAI,GAAG,MAAM,YAAY,CAC7B,gBAAgB,EAChB,gBAAgB,EAChB,EAAE,EACF,gBAAgB,CACjB,CAAC;QACF,OAAO,2BAA2B,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF,CAAC,CAAC;AAEH,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,gDAAgD;IAC7D,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ,CAAC,MAAM;IACzB,IAAI,EAAE;QACJ,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE;QACpE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;QAC3C,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE;KACvD;IACD,OAAO,EAAE;QACP,IAAI;QACJ,QAAQ;QACR,MAAM;QACN,OAAO;QACP,UAAU;QACV,WAAW;QACX,YAAY;QACZ,KAAK;KACN;IACD,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC5B,MAAM,QAAQ,GAAG,8BAA8B,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,2BAA2B,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxD,MAAM,IAAI,GAAoC,EAAE,CAAC;QACjD,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KACE,IAAI,SAAS,GAAG,CAAC,EACjB,SAAS,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,EACpC,SAAS,IAAI,CAAC,EACd,CAAC;YACD,MAAM,SAAS,GAA4B;gBACzC,sBAAsB,EAAE,QAAQ;gBAChC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;gBAC9C,sBAAsB,EAAE,KAAK;aAC9B,CAAC;YACF,IAAI,MAAM;gBAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,YAAY,CAC7B,wBAAwB,EACxB,wBAAwB,EACxB,SAAS,EACT,wBAAwB,CACzB,CAAC;YACF,MAAM,MAAM,GAAG,kCAAkC,CAAC,IAAI,CAAC,CAAC;YACxD,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,KAAK,MAAM;gBAAE,MAAM;YAC9D,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC;QAC7B,CAAC;QACD,OAAO,2BAA2B,CAChC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EACpB,MAAM,CAAC,mBAAmB,CAAC,CAC5B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC"}

package/dist/adapters/twitter/quote.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @owner   src/adapters/twitter/quote.ts
+ * @does    Register agent-facing Twitter quote-tweet composer automation implemented with site-specific safety checks.
+ * @needs   Logged-in x.com browser session, exact tweet URL scoping, optional image upload bridge.
+ * @feeds   surface coverage ledger and Twitter quote workflows with attachment guardrails.
+ * @breaks  X composer DOM drift or unverified quote-card rendering can post the wrong content.
+ */
+interface DownloadedImage {
+    absPath: string;
+    cleanupDir: string;
+}
+export declare function buildQuoteComposerUrl(value: unknown): string;
+export declare function resolveTwitterImagePath(value: unknown): string;
+export declare function resolveRemoteImageExtension(url: string, contentType: string | null): string;
+export declare function downloadTwitterImage(value: unknown): Promise<DownloadedImage>;
+export declare function buildQuoteSubmitScript(text: string, tweetId: string): string;
+export {};
+//# sourceMappingURL=quote.d.ts.map

package/dist/adapters/twitter/quote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote.d.ts","sourceRoot":"","sources":["../../../src/adapters/twitter/quote.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA4CH,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAG5D;AAMD,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAmB9D;AAED,wBAAgB,2BAA2B,CACzC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,MAAM,CAYR;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,eAAe,CAAC,CAmC1B;AAoED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CA6C5E"}