@nextclaw/x-harness 0.2.47 → 0.2.49

package/SOURCE.md

@@ -1,8 +1,8 @@
 # Corresponding source
 
-Version 0.2.47, commit b993ce6df34c50bdff2f4010b5935ca532f12f7a.
+Version 0.2.49, commit d4a3b2e37cebcd8bb86fd558faad4e3b2022e5ab.
 
-Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/b993ce6df34c50bdff2f4010b5935ca532f12f7a
+Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/d4a3b2e37cebcd8bb86fd558faad4e3b2022e5ab
 
 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");

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/dist/platform-observation.js

@@ -62,9 +62,9 @@ export class PlatformObservation {
         const waitingForOffset = query.view === "posts" &&
             Number.isInteger(query.offset) &&
             query.offset > 0 &&
-            value.renderedArticles > 0 &&
             !value.posts?.length;
-        if ((value.needsStateCheck || waitingForOffset) &&
+        const waitingForList = query.view === "posts" && !query.targetId && !value.posts?.length;
+        if ((value.needsStateCheck || waitingForOffset || waitingForList) &&
             !value.alerts?.length &&
             query.view === "posts") {
             try {
@@ -78,6 +78,8 @@ export class PlatformObservation {
                     throw error;
             }
             value = await this.handleObserved(query);
+            if (waitingForList && !query.offset && !value.posts?.length)
+                value = { ...value, needsStateCheck: true };
         }
         return value;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/x-harness",
-  "version": "0.2.47",
+  "version": "0.2.49",
   "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": "b993ce6df34c50bdff2f4010b5935ca532f12f7a"
+  "gitHead": "d4a3b2e37cebcd8bb86fd558faad4e3b2022e5ab"
 }

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 |