@webmcp-bridge/adapter-x 0.5.4 → 0.7.0

package/dist/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,2BAA2B,CAAC;AAuHnF,MAAM,MAAM,qBAAqB,GAAG;IAClC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AA4xNF,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,WAAW,CA2jB3E"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAwB,MAAM,2BAA2B,CAAC;AAuHnF,MAAM,MAAM,qBAAqB,GAAG;IAClC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAk3NF,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,WAAW,CA+jB3E"}

package/dist/adapter.js

@@ -537,7 +537,7 @@ const TOOL_DEFINITIONS = [
                 },
                 coverImagePath: {
                     type: "string",
-                    description: "Optional absolute local image path for the article cover image.",
+                    description: "Optional absolute local image path for the article cover image. X article covers work best when pre-cropped close to the editor's 5:2 aspect ratio.",
                     minLength: 1,
                     "x-uxc-kind": "file-path",
                 },
@@ -576,7 +576,7 @@ const TOOL_DEFINITIONS = [
                 },
                 coverImagePath: {
                     type: "string",
-                    description: "Optional absolute local image path for the article cover image when creating a new draft.",
+                    description: "Optional absolute local image path for the article cover image when creating a new draft. X article covers work best when pre-cropped close to the editor's 5:2 aspect ratio.",
                     minLength: 1,
                     "x-uxc-kind": "file-path",
                 },
@@ -605,7 +605,7 @@ const TOOL_DEFINITIONS = [
                 },
                 coverImagePath: {
                     type: "string",
-                    description: "Optional absolute local image path for the article cover image.",
+                    description: "Optional absolute local image path for the article cover image. X article covers work best when pre-cropped close to the editor's 5:2 aspect ratio.",
                     minLength: 1,
                     "x-uxc-kind": "file-path",
                 },
@@ -658,7 +658,7 @@ const TOOL_DEFINITIONS = [
                 },
                 coverImagePath: {
                     type: "string",
-                    description: "Absolute local image path for the article cover image.",
+                    description: "Absolute local image path for the article cover image. X article covers work best when pre-cropped close to the editor's 5:2 aspect ratio.",
                     minLength: 1,
                     "x-uxc-kind": "file-path",
                 },
@@ -2329,6 +2329,7 @@ async function withEphemeralPage(page, url, run) {
     const context = page.context();
     const ephemeralPage = await context.newPage();
     try {
+        await installEphemeralBridgeStubs(page, ephemeralPage);
         await ensureNetworkCaptureInstalled(ephemeralPage);
         await ephemeralPage.goto(url, { waitUntil: "domcontentloaded", timeout: 60_000 });
         return await run(ephemeralPage);
@@ -2337,6 +2338,34 @@ async function withEphemeralPage(page, url, run) {
         await ephemeralPage.close().catch(() => { });
     }
 }
+async function installEphemeralBridgeStubs(ownerPage, targetPage) {
+    const names = (await ownerPage
+        .evaluate(() => {
+        const globalAny = window;
+        return {
+            callName: typeof globalAny.__WEBMCP_BRIDGE_CALL_NAME__ === "string" ? globalAny.__WEBMCP_BRIDGE_CALL_NAME__ : "",
+            resourceUpdatedName: typeof globalAny.__WEBMCP_BRIDGE_NOTIFY_RESOURCE_UPDATED_NAME__ === "string"
+                ? globalAny.__WEBMCP_BRIDGE_NOTIFY_RESOURCE_UPDATED_NAME__
+                : "",
+        };
+    })
+        .catch(() => ({ callName: "", resourceUpdatedName: "" })));
+    const callName = typeof names?.callName === "string" ? names.callName : "";
+    const resourceUpdatedName = typeof names?.resourceUpdatedName === "string" ? names.resourceUpdatedName : "";
+    if (callName) {
+        await targetPage
+            .exposeFunction(callName, async () => ({
+            error: {
+                code: "NOT_SUPPORTED",
+                message: "bridge call is unavailable on ephemeral pages",
+            },
+        }))
+            .catch(() => { });
+    }
+    if (resourceUpdatedName) {
+        await targetPage.exposeFunction(resourceUpdatedName, async () => undefined).catch(() => { });
+    }
+}
 function getReadPageCacheState(page) {
     let state = READ_PAGE_CACHE.get(page);
     if (!state) {
@@ -3418,12 +3447,17 @@ async function waitForArticleDraftPersisted(page, articleId, title) {
     await page.keyboard.press("Escape").catch(() => { });
     return await page
         .waitForFunction(({ targetId, expectedTitle }) => {
-        const anchors = Array.from(document.querySelectorAll("a[href]"));
-        const draftAnchor = anchors.find((anchor) => anchor.href.includes(`/compose/articles/edit/${targetId}`));
-        const containerText = draftAnchor?.closest("article, li, div")?.textContent || draftAnchor?.textContent || "";
-        const normalized = containerText.replace(/\s+/g, " ").trim();
-        return normalized.includes(expectedTitle) && !normalized.includes("(Needs title)");
-    }, { targetId: articleId, expectedTitle: title.trim() }, { timeout: 20_000 })
+        const normalize = (value) => value.replace(/\s+/g, " ").trim();
+        const currentUrl = window.location.href;
+        const titleValue = document.querySelector("textarea[placeholder='Add a title']")?.value ??
+            document.querySelector("textarea")?.value ??
+            "";
+        const bodyText = normalize(document.body?.innerText || "");
+        const onExpectedEditor = currentUrl.includes(`/compose/articles/edit/${targetId}`);
+        const titleMatches = normalize(titleValue) === expectedTitle;
+        const autosaveVisible = bodyText.includes("Last saved") || bodyText.includes("Saved") || bodyText.includes("Just now");
+        return onExpectedEditor && titleMatches && autosaveVisible;
+    }, { targetId: articleId, expectedTitle: title.trim() }, { timeout: 4_000 })
         .then(() => true)
         .catch(() => false);
 }
@@ -3852,6 +3886,9 @@ function buildArticleEditUrl(articleId) {
 function buildArticlePreviewUrl(articleId) {
     return `https://x.com/i/articles/${encodeURIComponent(articleId)}/preview`;
 }
+function buildArticlePublicUrl(articleId) {
+    return `https://x.com/i/articles/${encodeURIComponent(articleId)}`;
+}
 function isArticlePreviewUrl(url) {
     try {
         const parsed = new URL(url, "https://x.com");
@@ -4953,6 +4990,10 @@ async function readArticleByUrl(page, targetUrl, authorHandle) {
     return parseArticleReadErrorCode(ownerResult) ? publicResult : ownerResult;
 }
 async function publishArticleEditor(page, timeoutMs) {
+    const isTimeoutError = (error) => {
+        const message = error instanceof Error ? error.message : String(error ?? "");
+        return /timeout/i.test(message);
+    };
     const editUrl = page.url();
     await page
         .evaluate(() => {
@@ -5029,6 +5070,7 @@ async function publishArticleEditor(page, timeoutMs) {
     }
     await page.waitForTimeout(1_000);
     await clickPrimaryPublish().catch(() => false);
+    let publishTimedOut = false;
     try {
         await page.waitForFunction(({ previousUrl }) => {
             const currentUrl = window.location.href;
@@ -5041,8 +5083,17 @@ async function publishArticleEditor(page, timeoutMs) {
             return (document.body?.innerText || "").includes("Published");
         }, { previousUrl: editUrl }, { timeout: timeoutMs });
     }
-    catch {
-        return { ok: false, reason: "publish_not_confirmed" };
+    catch (error) {
+        if (!isTimeoutError(error)) {
+            return {
+                ok: false,
+                reason: "publish_wait_failed",
+                details: {
+                    message: error instanceof Error ? error.message : String(error ?? ""),
+                },
+            };
+        }
+        publishTimedOut = true;
     }
     const details = await page.evaluate(({ op }) => {
         if (op !== "article_collect_publish_details") {
@@ -5065,11 +5116,30 @@ async function publishArticleEditor(page, timeoutMs) {
     const articleId = parseArticleIdFromUrl(details.currentUrl) ??
         (typeof details.editUrl === "string" ? parseArticleIdFromUrl(details.editUrl) : undefined) ??
         undefined;
-    const articleUrl = typeof details.publicUrl === "string" && details.publicUrl.length > 0
+    let articleUrl = typeof details.publicUrl === "string" && details.publicUrl.length > 0
         ? details.publicUrl
         : !details.currentUrl.includes("/compose/articles/edit/")
             ? details.currentUrl
             : undefined;
+    if (!articleUrl && articleId) {
+        const publicUrl = buildArticlePublicUrl(articleId);
+        const readback = await readArticleByUrl(page, publicUrl);
+        if (!parseArticleReadErrorCode(readback)) {
+            articleUrl = publicUrl;
+        }
+    }
+    if (publishTimedOut && !articleUrl) {
+        return {
+            ok: false,
+            reason: "publish_not_confirmed",
+            details: {
+                currentUrl: details.currentUrl,
+                ...(typeof details.editUrl === "string" ? { editUrl: details.editUrl } : {}),
+                ...(typeof details.publicUrl === "string" ? { publicUrl: details.publicUrl } : {}),
+                ...(articleId ? { articleId } : {}),
+            },
+        };
+    }
     const output = {
         ok: true,
         editUrl: typeof details.editUrl === "string" && details.editUrl.length > 0 ? details.editUrl : editUrl,
@@ -5227,6 +5297,7 @@ async function draftArticleMarkdown(page, markdownPath, explicitTitle, coverImag
     const articlePage = await page.context().newPage();
     let shouldClose = true;
     try {
+        await installEphemeralBridgeStubs(page, articlePage);
         await ensureNetworkCaptureInstalled(articlePage);
         await articlePage.goto("https://x.com/compose/articles", { waitUntil: "domcontentloaded", timeout: 60_000 });
         const started = await openNewArticleEditor(articlePage);
@@ -6490,7 +6561,12 @@ export function createXAdapter(options) {
                 }
                 const explicitTitle = typeof args.title === "string" ? args.title.trim() : "";
                 const coverImagePath = typeof args.coverImagePath === "string" ? args.coverImagePath.trim() : "";
-                return await draftArticleMarkdown(page, markdownPath, explicitTitle || undefined, coverImagePath || undefined);
+                try {
+                    return await draftArticleMarkdown(page, markdownPath, explicitTitle || undefined, coverImagePath || undefined);
+                }
+                catch (error) {
+                    return errorResult("EXECUTION_FAILED", error instanceof Error ? error.message : String(error ?? ""));
+                }
             }
             if (name === "article.upsertDraftMarkdown") {
                 const authCheck = await requireAuthenticated(page);