@zenalexa/unicli 0.218.1 → 0.220.0

package/dist/adapters/twitter/quote.js

@@ -0,0 +1,285 @@
+/**
+ * @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.
+ */
+import { existsSync, mkdtempSync, readFileSync, rmSync, statSync, writeFileSync, } from "node:fs";
+import { homedir, tmpdir } from "node:os";
+import { basename, extname, join, resolve } from "node:path";
+import { cli, Strategy } from "../../registry.js";
+import { buildTwitterArticleScopeSource, parseTwitterTweetUrl, } from "./tweet-url.js";
+const COMPOSER_FILE_INPUT_SELECTOR = 'input[type="file"][data-testid="fileInput"]';
+const SUPPORTED_IMAGE_EXTENSIONS = new Set([
+    ".jpg",
+    ".jpeg",
+    ".png",
+    ".gif",
+    ".webp",
+]);
+const MAX_IMAGE_SIZE_BYTES = 20 * 1024 * 1024;
+const CONTENT_TYPE_TO_EXTENSION = {
+    "image/jpeg": ".jpg",
+    "image/jpg": ".jpg",
+    "image/png": ".png",
+    "image/gif": ".gif",
+    "image/webp": ".webp",
+};
+export function buildQuoteComposerUrl(value) {
+    const parsed = parseTwitterTweetUrl(value);
+    return `https://x.com/compose/post?url=${encodeURIComponent(parsed.url)}`;
+}
+function normalizeHomePath(value) {
+    return value.replace(/^~(?=$|\/)/, homedir());
+}
+export function resolveTwitterImagePath(value) {
+    const raw = String(value ?? "").trim();
+    if (!raw)
+        throw new Error("twitter quote image path cannot be empty.");
+    const absPath = resolve(normalizeHomePath(raw));
+    if (!existsSync(absPath))
+        throw new Error(`Image file not found: ${absPath}.`);
+    const ext = extname(absPath).toLowerCase();
+    if (!SUPPORTED_IMAGE_EXTENSIONS.has(ext)) {
+        throw new Error(`Unsupported image format "${ext}". Supported: jpg, jpeg, png, gif, webp.`);
+    }
+    const size = statSync(absPath).size;
+    if (size > MAX_IMAGE_SIZE_BYTES) {
+        throw new Error(`Image too large: ${(size / 1024 / 1024).toFixed(1)} MB (max 20 MB).`);
+    }
+    return absPath;
+}
+export function resolveRemoteImageExtension(url, contentType) {
+    const normalizedContentType = String(contentType ?? "")
+        .split(";")[0]
+        .trim()
+        .toLowerCase();
+    const fromContentType = CONTENT_TYPE_TO_EXTENSION[normalizedContentType];
+    if (fromContentType)
+        return fromContentType;
+    const fromPath = extname(new URL(url).pathname).toLowerCase();
+    if (SUPPORTED_IMAGE_EXTENSIONS.has(fromPath))
+        return fromPath;
+    throw new Error(`Unsupported remote image format "${normalizedContentType || "unknown"}". Supported: jpg, jpeg, png, gif, webp.`);
+}
+export async function downloadTwitterImage(value) {
+    const raw = String(value ?? "").trim();
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new Error(`Invalid image URL: ${raw}.`);
+    }
+    if (parsed.protocol !== "https:" && parsed.protocol !== "http:") {
+        throw new Error(`Unsupported image URL protocol: ${parsed.protocol}.`);
+    }
+    const response = await fetch(parsed.toString());
+    if (!response.ok)
+        throw new Error(`Image download failed: HTTP ${response.status}.`);
+    const contentLength = Number(response.headers.get("content-length") || "0");
+    if (contentLength > MAX_IMAGE_SIZE_BYTES) {
+        throw new Error(`Image too large: ${(contentLength / 1024 / 1024).toFixed(1)} MB (max 20 MB).`);
+    }
+    const ext = resolveRemoteImageExtension(parsed.toString(), response.headers.get("content-type"));
+    const cleanupDir = mkdtempSync(join(tmpdir(), "unicli-twitter-quote-"));
+    const absPath = join(cleanupDir, `image${ext}`);
+    const buffer = Buffer.from(await response.arrayBuffer());
+    if (buffer.byteLength > MAX_IMAGE_SIZE_BYTES) {
+        rmSync(cleanupDir, { recursive: true, force: true });
+        throw new Error(`Image too large: ${(buffer.byteLength / 1024 / 1024).toFixed(1)} MB (max 20 MB).`);
+    }
+    writeFileSync(absPath, buffer);
+    return { absPath, cleanupDir };
+}
+function mimeTypeForImage(absPath) {
+    const ext = extname(absPath).toLowerCase();
+    if (ext === ".png")
+        return "image/png";
+    if (ext === ".gif")
+        return "image/gif";
+    if (ext === ".webp")
+        return "image/webp";
+    return "image/jpeg";
+}
+async function attachComposerImage(page, absImagePath) {
+    let uploaded = false;
+    if (page.setFileInput) {
+        try {
+            await page.setFileInput(COMPOSER_FILE_INPUT_SELECTOR, [absImagePath]);
+            uploaded = true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (!/unknown action|not supported/i.test(message)) {
+                throw new Error(`Image upload failed: ${message}`);
+            }
+        }
+    }
+    if (!uploaded) {
+        const base64 = readFileSync(absImagePath).toString("base64");
+        const upload = (await page.evaluate(`
+      (() => {
+        const input = document.querySelector(${JSON.stringify(COMPOSER_FILE_INPUT_SELECTOR)});
+        if (!input) return { ok: false, error: 'No file input found on page' };
+        const binary = atob(${JSON.stringify(base64)});
+        const bytes = new Uint8Array(binary.length);
+        for (let i = 0; i < binary.length; i += 1) bytes[i] = binary.charCodeAt(i);
+        const transfer = new DataTransfer();
+        const blob = new Blob([bytes], { type: ${JSON.stringify(mimeTypeForImage(absImagePath))} });
+        transfer.items.add(new File([blob], ${JSON.stringify(basename(absImagePath))}, { type: ${JSON.stringify(mimeTypeForImage(absImagePath))} }));
+        Object.defineProperty(input, 'files', { value: transfer.files, writable: false });
+        input.dispatchEvent(new Event('change', { bubbles: true }));
+        input.dispatchEvent(new Event('input', { bubbles: true }));
+        return { ok: true };
+      })()
+    `));
+        if (!upload?.ok) {
+            throw new Error(`Image upload failed: ${upload?.error ?? "unknown error"}.`);
+        }
+    }
+    await page.wait(2);
+    const uploadState = (await page.evaluate(`
+    (() => {
+      const previewCount = document.querySelectorAll(
+        '[data-testid="attachments"] img, [data-testid="attachments"] video, [data-testid="tweetPhoto"]'
+      ).length;
+      const hasMedia = previewCount > 0
+        || !!document.querySelector('[data-testid="attachments"]')
+        || !!Array.from(document.querySelectorAll('button,[role="button"]')).find((el) =>
+          /remove media|remove image|remove/i.test((el.getAttribute('aria-label') || '') + ' ' + (el.textContent || ''))
+        );
+      return { ok: hasMedia, previewCount };
+    })()
+  `));
+    if (!uploadState?.ok)
+        throw new Error("Image upload failed: preview did not appear.");
+}
+export function buildQuoteSubmitScript(text, tweetId) {
+    return `(async () => {
+    try {
+      ${buildTwitterArticleScopeSource(tweetId)}
+      const visible = (el) => !!el && (el.offsetParent !== null || el.getClientRects().length > 0);
+      const boxes = Array.from(document.querySelectorAll('[data-testid="tweetTextarea_0"]'));
+      const box = boxes.find(visible) || boxes[0];
+      if (!box) return { ok: false, message: 'Could not find the quote composer text area. Are you logged in?' };
+      box.focus();
+      const textToInsert = ${JSON.stringify(text)};
+      if (!document.execCommand('insertText', false, textToInsert)) {
+        const transfer = new DataTransfer();
+        transfer.setData('text/plain', textToInsert);
+        box.dispatchEvent(new ClipboardEvent('paste', { clipboardData: transfer, bubbles: true, cancelable: true }));
+      }
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+      let hasQuoteCard = false;
+      for (let i = 0; i < 20; i += 1) {
+        hasQuoteCard = __twHasLinkToTarget(document);
+        if (hasQuoteCard) break;
+        await new Promise((resolve) => setTimeout(resolve, 250));
+      }
+      if (!hasQuoteCard) return { ok: false, message: 'Quote target did not render in the composer. The source tweet may be deleted or restricted.' };
+      const buttons = Array.from(document.querySelectorAll('[data-testid="tweetButton"], [data-testid="tweetButtonInline"]'));
+      const button = buttons.find((el) => visible(el) && !el.disabled && el.getAttribute('aria-disabled') !== 'true');
+      if (!button) return { ok: false, message: 'Tweet button is disabled or not found.' };
+      button.click();
+      const normalize = (value) => String(value || '').replace(/\\u00a0/g, ' ').replace(/\\s+/g, ' ').trim();
+      const expectedText = normalize(textToInsert);
+      for (let i = 0; i < 30; i += 1) {
+        await new Promise((resolve) => setTimeout(resolve, 500));
+        const alerts = Array.from(document.querySelectorAll('[role="alert"], [data-testid="toast"]')).filter(visible);
+        const success = alerts.find((el) => /sent|posted|your post was sent|your tweet was sent/i.test(el.textContent || ''));
+        if (success) return { ok: true, message: 'Quote tweet posted successfully.' };
+        const failure = alerts.find((el) => /failed|error|try again|not sent|could not/i.test(el.textContent || ''));
+        if (failure) return { ok: false, message: (failure.textContent || 'Quote tweet failed to post.').trim() };
+        const visibleBoxes = Array.from(document.querySelectorAll('[data-testid="tweetTextarea_0"]')).filter(visible);
+        const composerStillHasText = visibleBoxes.some((node) => normalize(node.innerText || node.textContent || '').includes(expectedText));
+        if (!composerStillHasText) return { ok: true, message: 'Quote tweet posted successfully.' };
+      }
+      return { ok: false, message: 'Quote tweet submission did not complete before timeout.' };
+    } catch (error) {
+      return { ok: false, message: String(error?.message || error) };
+    }
+  })()`;
+}
+const quoteArgs = [
+    {
+        name: "url",
+        type: "str",
+        required: true,
+        positional: true,
+        description: "Tweet URL to quote",
+        format: "uri",
+    },
+    {
+        name: "text",
+        type: "str",
+        required: true,
+        positional: true,
+        description: "Quote text",
+    },
+    { name: "image", type: "str", description: "Optional local image path" },
+    { name: "image-url", type: "str", description: "Optional remote image URL" },
+];
+cli({
+    site: "twitter",
+    name: "quote",
+    description: "Quote-tweet a specific tweet with text and optional image",
+    domain: "x.com",
+    strategy: Strategy.UI,
+    browser: true,
+    args: quoteArgs,
+    columns: ["status", "message", "text"],
+    func: async (page, kwargs) => {
+        if (!page || typeof page !== "object") {
+            throw new Error("Browser session required for twitter quote.");
+        }
+        if (kwargs.image && kwargs["image-url"]) {
+            throw new Error("Use either --image or --image-url, not both.");
+        }
+        const browserPage = page;
+        const target = parseTwitterTweetUrl(kwargs.url);
+        const text = String(kwargs.text ?? "").trim();
+        if (!text)
+            throw new Error("twitter quote text cannot be empty.");
+        let localImagePath;
+        let cleanupDir;
+        try {
+            if (kwargs.image) {
+                localImagePath = resolveTwitterImagePath(kwargs.image);
+            }
+            else if (kwargs["image-url"]) {
+                const downloaded = await downloadTwitterImage(kwargs["image-url"]);
+                localImagePath = downloaded.absPath;
+                cleanupDir = downloaded.cleanupDir;
+            }
+            await browserPage.goto(buildQuoteComposerUrl(target.url), {
+                waitUntil: "load",
+                settleMs: 2500,
+            });
+            await browserPage.wait({
+                selector: '[data-testid="tweetTextarea_0"]',
+                timeout: 15,
+            });
+            if (localImagePath)
+                await attachComposerImage(browserPage, localImagePath);
+            const result = (await browserPage.evaluate(buildQuoteSubmitScript(text, target.id)));
+            if (result.ok)
+                await browserPage.wait(3);
+            return [
+                {
+                    status: result.ok ? "success" : "failed",
+                    message: result.message || "",
+                    text,
+                    ...(kwargs.image ? { image: kwargs.image } : {}),
+                    ...(kwargs["image-url"] ? { "image-url": kwargs["image-url"] } : {}),
+                },
+            ];
+        }
+        finally {
+            if (cleanupDir)
+                rmSync(cleanupDir, { recursive: true, force: true });
+        }
+    },
+});
+//# sourceMappingURL=quote.js.map

package/dist/adapters/twitter/quote.js.map

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

package/dist/adapters/twitter/tweet-actions.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @owner   src/adapters/twitter/tweet-actions.ts
+ * @does    Register agent-facing Twitter unlike, retweet, and unretweet URL actions.
+ * @needs   Browser session on x.com, exact tweet URL parsing, scoped article action buttons.
+ * @feeds   surface coverage ledger, Twitter write-action workflows, safe tweet-level UI actions.
+ * @breaks  X DOM test-id drift or weak tweet scoping can act on the wrong tweet.
+ */
+import { buildTwitterArticleScopeSource, parseTwitterTweetUrl } from "./tweet-url.js";
+export { buildTwitterArticleScopeSource, parseTwitterTweetUrl };
+type ToggleAction = "unlike" | "retweet" | "unretweet";
+export declare function buildTweetToggleScript(action: ToggleAction, tweetId: string): string;
+//# sourceMappingURL=tweet-actions.d.ts.map

package/dist/adapters/twitter/tweet-actions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweet-actions.d.ts","sourceRoot":"","sources":["../../../src/adapters/twitter/tweet-actions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,EACL,8BAA8B,EAC9B,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,CAAC;AAEhE,KAAK,YAAY,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;AAqDvD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,MAAM,GACd,MAAM,CAyCR"}

package/dist/adapters/twitter/tweet-actions.js

@@ -0,0 +1,145 @@
+/**
+ * @owner   src/adapters/twitter/tweet-actions.ts
+ * @does    Register agent-facing Twitter unlike, retweet, and unretweet URL actions.
+ * @needs   Browser session on x.com, exact tweet URL parsing, scoped article action buttons.
+ * @feeds   surface coverage ledger, Twitter write-action workflows, safe tweet-level UI actions.
+ * @breaks  X DOM test-id drift or weak tweet scoping can act on the wrong tweet.
+ */
+import { cli, Strategy } from "../../registry.js";
+import { buildTwitterArticleScopeSource, parseTwitterTweetUrl, } from "./tweet-url.js";
+export { buildTwitterArticleScopeSource, parseTwitterTweetUrl };
+const ACTIONS = {
+    unlike: {
+        activeTestId: "unlike",
+        inactiveTestId: "like",
+        confirmTestId: "",
+        alreadyMessage: "Tweet is not liked (already unliked).",
+        successMessage: "Tweet successfully unliked.",
+        missingMessage: "Could not find the Unlike button on this tweet. Are you logged in?",
+        mismatchMessage: "Unlike action was initiated but UI did not update as expected.",
+        needsConfirm: false,
+    },
+    retweet: {
+        activeTestId: "retweet",
+        inactiveTestId: "unretweet",
+        confirmTestId: "retweetConfirm",
+        alreadyMessage: "Tweet is already retweeted.",
+        successMessage: "Tweet successfully retweeted.",
+        missingMessage: "Could not find the Retweet button on this tweet. Are you logged in?",
+        mismatchMessage: "Retweet action was initiated but UI did not update as expected.",
+        needsConfirm: true,
+    },
+    unretweet: {
+        activeTestId: "unretweet",
+        inactiveTestId: "retweet",
+        confirmTestId: "unretweetConfirm",
+        alreadyMessage: "Tweet is not retweeted (already removed).",
+        successMessage: "Tweet successfully unretweeted.",
+        missingMessage: "Could not find the Unretweet button on this tweet. Are you logged in?",
+        mismatchMessage: "Unretweet action was initiated but UI did not update as expected.",
+        needsConfirm: true,
+    },
+};
+export function buildTweetToggleScript(action, tweetId) {
+    const config = ACTIONS[action];
+    return `(async () => {
+    try {
+      ${buildTwitterArticleScopeSource(tweetId)}
+      let targetArticle = null;
+      let activeButton = null;
+      let inactiveButton = null;
+      for (let i = 0; i < 20; i++) {
+        targetArticle = findTargetArticle();
+        activeButton = targetArticle?.querySelector('[data-testid="${config.activeTestId}"]') || null;
+        inactiveButton = targetArticle?.querySelector('[data-testid="${config.inactiveTestId}"]') || null;
+        if (activeButton || inactiveButton) break;
+        await new Promise((resolve) => setTimeout(resolve, 500));
+      }
+      if (inactiveButton) return { ok: true, message: ${JSON.stringify(config.alreadyMessage)} };
+      if (!activeButton) return { ok: false, message: ${JSON.stringify(config.missingMessage)} };
+      activeButton.click();
+      ${config.needsConfirm
+        ? `
+      let confirmButton = null;
+      for (let i = 0; i < 20; i++) {
+        await new Promise((resolve) => setTimeout(resolve, 250));
+        confirmButton = document.querySelector('[data-testid="${config.confirmTestId}"]');
+        if (confirmButton) break;
+      }
+      if (!confirmButton) return { ok: false, message: 'Confirmation menu item did not appear.' };
+      confirmButton.click();
+      `
+        : ""}
+      await new Promise((resolve) => setTimeout(resolve, 1000));
+      const verifyArticle = findTargetArticle() || targetArticle;
+      const verifyButton = verifyArticle?.querySelector('[data-testid="${config.inactiveTestId}"]');
+      if (verifyButton) return { ok: true, message: ${JSON.stringify(config.successMessage)} };
+      return { ok: false, message: ${JSON.stringify(config.mismatchMessage)} };
+    } catch (error) {
+      return { ok: false, message: String(error?.message || error) };
+    }
+  })()`;
+}
+function tweetActionFunc(action) {
+    return async (page, kwargs) => {
+        if (!page || typeof page !== "object") {
+            throw new Error(`Browser session required for twitter ${action}.`);
+        }
+        const target = parseTwitterTweetUrl(kwargs.url);
+        const browserPage = page;
+        await browserPage.goto(target.url);
+        await browserPage.wait({ selector: '[data-testid="primaryColumn"]' });
+        const result = await browserPage.evaluate(buildTweetToggleScript(action, target.id));
+        if (result.ok)
+            await browserPage.wait(2);
+        return [
+            {
+                status: result.ok ? "success" : "failed",
+                message: result.message || "",
+            },
+        ];
+    };
+}
+const tweetUrlArg = [
+    {
+        name: "url",
+        type: "str",
+        required: true,
+        positional: true,
+        description: "Tweet URL",
+    },
+];
+cli({
+    site: "twitter",
+    name: "unlike",
+    description: "Twitter unlike a specific tweet",
+    domain: "x.com",
+    strategy: Strategy.UI,
+    browser: true,
+    args: tweetUrlArg,
+    columns: ["status", "message"],
+    func: tweetActionFunc("unlike"),
+});
+cli({
+    site: "twitter",
+    name: "retweet",
+    description: "Twitter retweet a specific tweet",
+    domain: "x.com",
+    strategy: Strategy.UI,
+    browser: true,
+    args: tweetUrlArg,
+    columns: ["status", "message"],
+    func: tweetActionFunc("retweet"),
+});
+cli({
+    site: "twitter",
+    name: "unretweet",
+    description: "Twitter unretweet a specific tweet",
+    domain: "x.com",
+    strategy: Strategy.UI,
+    browser: true,
+    args: tweetUrlArg,
+    columns: ["status", "message"],
+    func: tweetActionFunc("unretweet"),
+});
+//# sourceMappingURL=tweet-actions.js.map

package/dist/adapters/twitter/tweet-actions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweet-actions.js","sourceRoot":"","sources":["../../../src/adapters/twitter/tweet-actions.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAElD,OAAO,EACL,8BAA8B,EAC9B,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,8BAA8B,EAAE,oBAAoB,EAAE,CAAC;AAIhE,MAAM,OAAO,GAYT;IACF,MAAM,EAAE;QACN,YAAY,EAAE,QAAQ;QACtB,cAAc,EAAE,MAAM;QACtB,aAAa,EAAE,EAAE;QACjB,cAAc,EAAE,uCAAuC;QACvD,cAAc,EAAE,6BAA6B;QAC7C,cAAc,EACZ,oEAAoE;QACtE,eAAe,EACb,gEAAgE;QAClE,YAAY,EAAE,KAAK;KACpB;IACD,OAAO,EAAE;QACP,YAAY,EAAE,SAAS;QACvB,cAAc,EAAE,WAAW;QAC3B,aAAa,EAAE,gBAAgB;QAC/B,cAAc,EAAE,6BAA6B;QAC7C,cAAc,EAAE,+BAA+B;QAC/C,cAAc,EACZ,qEAAqE;QACvE,eAAe,EACb,iEAAiE;QACnE,YAAY,EAAE,IAAI;KACnB;IACD,SAAS,EAAE;QACT,YAAY,EAAE,WAAW;QACzB,cAAc,EAAE,SAAS;QACzB,aAAa,EAAE,kBAAkB;QACjC,cAAc,EAAE,2CAA2C;QAC3D,cAAc,EAAE,iCAAiC;QACjD,cAAc,EACZ,uEAAuE;QACzE,eAAe,EACb,mEAAmE;QACrE,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,UAAU,sBAAsB,CACpC,MAAoB,EACpB,OAAe;IAEf,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO;;QAED,8BAA8B,CAAC,OAAO,CAAC;;;;;;qEAMsB,MAAM,CAAC,YAAY;uEACjB,MAAM,CAAC,cAAc;;;;wDAIpC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC;wDACrC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC;;QAGrF,MAAM,CAAC,YAAY;QACjB,CAAC,CAAC;;;;gEAIoD,MAAM,CAAC,aAAa;;;;;OAK7E;QACG,CAAC,CAAC,EACN;;;yEAGmE,MAAM,CAAC,cAAc;sDACxC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,cAAc,CAAC;qCACtD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,eAAe,CAAC;;;;OAIpE,CAAC;AACR,CAAC;AAED,SAAS,eAAe,CAAC,MAAoB;IAC3C,OAAO,KAAK,EAAE,IAAa,EAAE,MAA+B,EAAE,EAAE;QAC9D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,wCAAwC,MAAM,GAAG,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,WAAW,GAAG,IAInB,CAAC;QACF,MAAM,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,WAAW,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,+BAA+B,EAAE,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,CACvC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAC1C,CAAC;QACF,IAAI,MAAM,CAAC,EAAE;YAAE,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,OAAO;YACL;gBACE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;gBACxC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;aAC9B;SACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,WAAW,GAAiB;IAChC;QACE,IAAI,EAAE,KAAK;QACX,IAAI,EAAE,KAAK;QACX,QAAQ,EAAE,IAAI;QACd,UAAU,EAAE,IAAI;QAChB,WAAW,EAAE,WAAW;KACzB;CACF,CAAC;AAEF,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,QAAQ;IACd,WAAW,EAAE,iCAAiC;IAC9C,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ,CAAC,EAAE;IACrB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC9B,IAAI,EAAE,eAAe,CAAC,QAAQ,CAAC;CAChC,CAAC,CAAC;AAEH,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,kCAAkC;IAC/C,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ,CAAC,EAAE;IACrB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC9B,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC;CACjC,CAAC,CAAC;AAEH,GAAG,CAAC;IACF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,oCAAoC;IACjD,MAAM,EAAE,OAAO;IACf,QAAQ,EAAE,QAAQ,CAAC,EAAE;IACrB,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;IAC9B,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC;CACnC,CAAC,CAAC"}

package/dist/adapters/twitter/tweet-url.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @owner   src/adapters/twitter/tweet-url.ts
+ * @does    Provide exact Twitter/X tweet URL parsing and DOM target scoping helpers implemented with site-specific safety checks.
+ * @needs   Full https Twitter/X status URLs and browser DOM roots containing status links.
+ * @feeds   Twitter write-action adapters and agent-facing quote/retweet safety checks.
+ * @breaks  Twitter URL shape drift or substring matching can target the wrong tweet.
+ */
+interface ParsedTweetUrl {
+    id: string;
+    url: string;
+}
+export declare function parseTwitterTweetUrl(value: unknown): ParsedTweetUrl;
+export declare function buildTwitterArticleScopeSource(tweetId: string): string;
+export {};
+//# sourceMappingURL=tweet-url.d.ts.map

package/dist/adapters/twitter/tweet-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweet-url.d.ts","sourceRoot":"","sources":["../../../src/adapters/twitter/tweet-url.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,UAAU,cAAc;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;CACb;AAUD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAiBnE;AAED,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAqBtE"}

package/dist/adapters/twitter/tweet-url.js

@@ -0,0 +1,57 @@
+/**
+ * @owner   src/adapters/twitter/tweet-url.ts
+ * @does    Provide exact Twitter/X tweet URL parsing and DOM target scoping helpers implemented with site-specific safety checks.
+ * @needs   Full https Twitter/X status URLs and browser DOM roots containing status links.
+ * @feeds   Twitter write-action adapters and agent-facing quote/retweet safety checks.
+ * @breaks  Twitter URL shape drift or substring matching can target the wrong tweet.
+ */
+const TWEET_PATH_PATTERN = /^\/(?:[^/]+|i)\/status\/(\d+)\/?$/;
+const TWITTER_HOSTS = new Set(["x.com", "twitter.com"]);
+function isTwitterHost(hostname) {
+    return (TWITTER_HOSTS.has(hostname) ||
+        hostname.endsWith(".x.com") ||
+        hostname.endsWith(".twitter.com"));
+}
+export function parseTwitterTweetUrl(value) {
+    const raw = String(value ?? "").trim();
+    if (!raw)
+        throw new Error("twitter tweet URL cannot be empty.");
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new Error(`Invalid tweet URL: ${raw}.`);
+    }
+    const hostname = parsed.hostname.toLowerCase();
+    if (parsed.protocol !== "https:" || !isTwitterHost(hostname)) {
+        throw new Error(`Invalid tweet URL host: ${raw}.`);
+    }
+    const match = parsed.pathname.match(TWEET_PATH_PATTERN);
+    if (!match?.[1])
+        throw new Error(`Could not extract tweet ID from URL: ${raw}.`);
+    return { id: match[1], url: parsed.toString() };
+}
+export function buildTwitterArticleScopeSource(tweetId) {
+    return `
+    const tweetId = ${JSON.stringify(tweetId)};
+    const __twTweetPathRe = /^\\/(?:[^/]+|i)\\/status\\/(\\d+)\\/?$/;
+    const __twIsTwitterHost = (hostname) => hostname === 'x.com'
+      || hostname === 'twitter.com'
+      || hostname.endsWith('.x.com')
+      || hostname.endsWith('.twitter.com');
+    const __twGetStatusIdFromHref = (href) => {
+      try {
+        const parsed = new URL(href, window.location.origin);
+        if (parsed.protocol !== 'https:' || !__twIsTwitterHost(parsed.hostname.toLowerCase())) return null;
+        return parsed.pathname.match(__twTweetPathRe)?.[1] || null;
+      } catch {
+        return null;
+      }
+    };
+    const __twHasLinkToTarget = (root) => Array.from(root.querySelectorAll('a[href*="/status/"]'))
+      .some((link) => __twGetStatusIdFromHref(link.href) === tweetId);
+    const findTargetArticle = () => Array.from(document.querySelectorAll('article')).find(__twHasLinkToTarget);
+  `;
+}
+//# sourceMappingURL=tweet-url.js.map

package/dist/adapters/twitter/tweet-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tweet-url.js","sourceRoot":"","sources":["../../../src/adapters/twitter/tweet-url.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,kBAAkB,GAAG,mCAAmC,CAAC;AAC/D,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;AAOxD,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO,CACL,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC3B,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,CAClC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;IAChE,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,sBAAsB,GAAG,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,GAAG,CAAC,CAAC;IACrD,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACxD,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,GAAG,GAAG,CAAC,CAAC;IAClE,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,OAAe;IAC5D,OAAO;sBACa,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;;;;;;;;;;;;;;;;;;GAkB1C,CAAC;AACJ,CAAC"}

package/dist/adapters/uisdc/news.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @owner   src/adapters/uisdc/news.ts
+ * @does    Register agent-facing UISDC news browser extraction command.
+ * @needs   Public UISDC news page, browser runtime, selector-drift error reporting.
+ * @feeds   surface coverage ledger, design/AI news discovery, Chinese design news surface.
+ * @breaks  UISDC DOM drift or silent empty extraction hides news coverage failures.
+ */
+export declare function requireNewsLimit(value: unknown, fallback?: number): number;
+export declare function buildExtractUisdcNewsJs(): string;
+interface BrowserExtractPayload {
+    ok?: unknown;
+    reason?: unknown;
+    title?: unknown;
+    rows?: Array<{
+        title?: unknown;
+        summary?: unknown;
+        url?: unknown;
+    }>;
+}
+export declare function mapUisdcNewsPayload(payload: BrowserExtractPayload, limit: number): Array<Record<string, unknown>>;
+export {};
+//# sourceMappingURL=news.d.ts.map

package/dist/adapters/uisdc/news.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"news.d.ts","sourceRoot":"","sources":["../../../src/adapters/uisdc/news.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,SAAK,GAAG,MAAM,CAOtE;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAyBhD;AAED,UAAU,qBAAqB;IAC7B,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,GAAG,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACrE;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAyBhC"}