@nextclaw/x-harness 0.2.46 → 0.2.48

package/SOURCE.md

@@ -1,8 +1,8 @@
 # Corresponding source
 
-Version 0.2.46, commit c242fc8d8d9b935668cf4093bb4cb9bda14edf16.
+Version 0.2.48, commit 036e19cbc6ce3e5f4ee944b887336aea0dc73231.
 
-Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/c242fc8d8d9b935668cf4093bb4cb9bda14edf16
+Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/036e19cbc6ce3e5f4ee944b887336aea0dc73231
 
 Clone this revision, run npm ci, npm run bootstrap and npm run release:build.
 

package/dist/browser-dom-capabilities.js

@@ -146,6 +146,7 @@ export class DOMCapabilities {
         if (typeof this.#tab?.playwright?.getByRole === "function")
             base.push(...missingMethods(this.#tab.playwright.getByRole("article"), [
                 "first",
+                "filter",
                 "waitFor",
             ]));
         if (operation === "readBookmarks" &&

package/dist/browser-dom-editing.js

@@ -198,7 +198,7 @@ export class DOMEditing {
             .locator(`a[href=${JSON.stringify(primary)}]`)
             .filter({ visible: true }));
         this.#session.current = null;
-        await anchor.press("PageDown");
+        await anchor.press("End");
         return { completed: true };
         return { completed: false, loc, submittedEditor };
     }

package/dist/browser-dom-navigation.js

@@ -100,6 +100,20 @@ export class DOMNavigation {
                 .waitFor({ state: "visible", timeoutMs: 5000 });
             return;
         }
+        if (command.excludeIds) {
+            if (!Array.isArray(command.excludeIds) ||
+                command.excludeIds.some((id) => !/^\d+$/.test(id)))
+                throw Error("source-pagination-wait-ids-invalid");
+            let articles = this.#tab.playwright.getByRole("article");
+            if (command.excludeIds.length)
+                articles = articles.filter({
+                    hasNot: this.#tab.playwright.locator(command.excludeIds
+                        .map((id) => `a[href$="/status/${id}"]`)
+                        .join(",")),
+                });
+            await articles.first().waitFor({ state: "visible", timeoutMs: 5000 });
+            return;
+        }
         const offset = command.offset ?? 0;
         if (!Number.isInteger(offset) || offset < 0)
             throw Error("帖子等待窗口须为非负整数offset");
@@ -279,10 +293,7 @@ export class DOMNavigation {
         // Native observation settles the real loading transition when the tab exposes it.
         if (typeof this.#tab.getAXState === "function")
             await this.#tab.getAXState({ emit: false });
-        await this.#tab.playwright
-            .getByRole("article")
-            .first()
-            .waitFor({ state: "visible", timeoutMs: 5000 });
+        await this.handleWaitPublicArticle(this.#tab.playwright.getByRole("article").first(), command.url);
         return;
     }
 }

package/dist/platform-collections.js

@@ -118,6 +118,26 @@ export class PlatformCollections {
                     offset += 5;
                 else {
                     await this.#browser.act({ operation: "nextPosts" });
+                    const scrolled = await this.#ready({ view: "posts", limit: 5 });
+                    if (scrolled.needsStateCheck || scrolled.alerts?.length)
+                        return {
+                            ...scrolled,
+                            sources,
+                            complete: false,
+                            missing: ["source-page-unconfirmed"],
+                        };
+                    // Scroll and lazy loading settle asynchronously. Existing cards are
+                    // already visible, so waiting for the first article proves nothing.
+                    try {
+                        await this.#browser.act({
+                            operation: "waitForPosts",
+                            excludeIds: [...seen],
+                        });
+                    }
+                    catch (error) {
+                        if (!/timed out|timeout/i.test(error.message))
+                            throw error;
+                    }
                     const advanced = await this.#ready({ view: "posts", limit: 5 });
                     // Retained DOM prefixes include a partial final window too; skip
                     // exactly the consumed cards, while virtualized replacements restart.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/x-harness",
-  "version": "0.2.46",
+  "version": "0.2.48",
   "type": "module",
   "description": "Typed X task harness with compact business results and explicit diagnostics.",
   "main": "./dist/index.js",
@@ -42,5 +42,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "c242fc8d8d9b935668cf4093bb4cb9bda14edf16"
+  "gitHead": "036e19cbc6ce3e5f4ee944b887336aea0dc73231"
 }

package/skill/references/reads.md

@@ -4,8 +4,8 @@
 | --- | --- | --- |
 | readIncomingReplies | none | processedIds, limit (5), maxPages (3), mode |
 | readCreator | handle | target (10;1–50), maxScrolls, navigate, expand, mode |
-| readBookmarks | folder (observed name), or discoverOnly:true | processedIds, limit, maxPages, mode |
-| searchSources | query | processedIds, limit, maxPages, mode |
+| readBookmarks | folder (observed name), or discoverOnly:true | processedIds, limit (1–5), maxPages (1–10), mode |
+| searchSources | query | processedIds, limit (1–5), maxPages (1–10), mode |
 | readPost | target: {postId,url,evidenceRef} | includeContext, resolveQuote, mode |
 | readPerson | target: {handle,url,evidenceRef} | mode |
 | readPeople | target: {url,evidenceRef} | offset, limit (1–5), advance, mode |