@nextclaw/x-harness 0.2.43 → 0.2.45

package/SOURCE.md

@@ -1,8 +1,8 @@
 # Corresponding source
 
-Version 0.2.43, commit a1ddf2487e87818c3be2a23213700e9e5b2b4ce4.
+Version 0.2.45, commit 52258a7e88c8ebdab05e3981d37ec78becabffe6.
 
-Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/a1ddf2487e87818c3be2a23213700e9e5b2b4ce4
+Complete source, build scripts and dependencies: https://github.com/Peiiii/x-harness/tree/52258a7e88c8ebdab05e3981d37ec78becabffe6
 
 Clone this revision, run npm ci, npm run bootstrap and npm run release:build.
 

package/dist/browser-dom-capabilities.d.ts

@@ -3,6 +3,7 @@ export declare class DOMCapabilities {
     #private;
     constructor(dependencies: Pick<DOMDependencies, "tab" | "nativeSubmit">);
     capabilities(operation: any): any;
+    private quoteCapabilities;
     private creatorCapabilities;
     private collectionCapabilities;
 }

package/dist/browser-dom-capabilities.js

@@ -89,6 +89,8 @@ export class DOMCapabilities {
                     "press",
                 ]));
         }
+        if (operation === "openQuoteComposer")
+            return this.quoteCapabilities(base);
         if (operation === "attachAssets")
             base.push(...missingMethods(this.#tab?.playwright, [
                 "waitForEvent",
@@ -99,6 +101,26 @@ export class DOMCapabilities {
             base.push(...missingMethods(this.#tab, ["getAXState", "click"]));
         return base;
     }
+    quoteCapabilities(base) {
+        base.push(...missingMethods(this.#tab?.playwright, ["getByTestId"]));
+        if (typeof this.#tab?.playwright?.getByTestId === "function")
+            base.push(...missingMethods(this.#tab.playwright.getByTestId("attachments"), [
+                "getByTestId",
+                "waitFor",
+            ]));
+        base.push(...missingMethods(this.#tab?.playwright, ["locator", "getByRole"]));
+        if (typeof this.#tab?.playwright?.getByRole === "function") {
+            base.push(...missingMethods(this.#tab.playwright.getByRole("article"), [
+                "filter",
+                "getByRole",
+            ]));
+            base.push(...missingMethods(this.#tab.playwright.getByRole("button"), [
+                "press",
+                "waitFor",
+            ]));
+        }
+        return base;
+    }
     creatorCapabilities(base, operation) {
         base.push(...missingMethods(this.#tab, [
             "url",

package/dist/browser-dom-dependencies.d.ts

@@ -1,6 +1,7 @@
 export interface DOMSession {
     current?: any;
     replyBinding?: any;
+    quoteBinding?: any;
     refreshNotice?: any;
     editBinding?: any;
 }

package/dist/browser-dom-editing.d.ts

@@ -126,6 +126,7 @@ export declare class DOMEditing {
         submittedEditor: any;
     }>;
     likePost: (command: any) => Promise<any>;
+    openQuoteComposer: (command: any) => Promise<any>;
     openReply: (command: any) => Promise<{
         completed: boolean;
         loc: any;
@@ -165,6 +166,7 @@ export declare class DOMEditing {
     private handleAttachAssets;
     private handleFollow;
     private handleLikePost;
+    private handleOpenQuoteComposer;
     private handleOpenReply;
     private handleFillComposer;
     private handleSubmitPost;

package/dist/browser-dom-editing.js

@@ -19,6 +19,7 @@ export class DOMEditing {
     attachAssets;
     follow;
     likePost;
+    openQuoteComposer;
     openReply;
     fillComposer;
     submitPost;
@@ -44,6 +45,7 @@ export class DOMEditing {
         this.attachAssets = this.handleAttachAssets.bind(this);
         this.follow = this.handleFollow.bind(this);
         this.likePost = this.handleLikePost.bind(this);
+        this.openQuoteComposer = this.handleOpenQuoteComposer.bind(this);
         this.openReply = this.handleOpenReply.bind(this);
         this.fillComposer = this.handleFillComposer.bind(this);
         this.submitPost = this.handleSubmitPost.bind(this);
@@ -398,6 +400,44 @@ export class DOMEditing {
             },
         };
     }
+    async handleOpenQuoteComposer(command) {
+        const { query, result } = this.#session.current;
+        this.#session.quoteBinding = null;
+        if (query.targetId !== command.postId ||
+            result.needsStateCheck ||
+            result.alerts?.length ||
+            result.posts?.length !== 1 ||
+            result.posts[0].id !== command.postId)
+            throw Error("unique-quote-source-required");
+        const post = result.posts[0];
+        const buttons = post.buttons.filter((b) => /转帖|Repost|Retweet/i.test(b.label));
+        if (buttons.length !== 1 ||
+            !post.body?.trim() ||
+            !post.author ||
+            post.primary?.match(/\/status\/(\d+)$/)?.[1] !== command.postId)
+            throw Error("quote-source-controls-unconfirmed");
+        const article = await this.#unique(this.#locator("article").filter({
+            has: this.#tab.playwright.locator(`a[href=${JSON.stringify(post.primary)}]`),
+            visible: true,
+        }));
+        await (await this.#unique(article.getByRole("button", { name: buttons[0].label, exact: true }))).press("Enter");
+        const menu = this.#tab.playwright.getByRole("menuitem", {
+            name: /^(引用|Quote)$/,
+        });
+        await menu.waitFor({ state: "visible", timeoutMs: 2000 });
+        await (await this.#unique(menu)).press("Enter");
+        await this.#tab.playwright
+            .getByTestId("attachments")
+            .getByTestId("tweetText")
+            .waitFor({ state: "visible", timeoutMs: 2000 });
+        this.#session.quoteBinding = {
+            postId: post.id,
+            author: post.author,
+            body: post.body,
+        };
+        this.#session.current = null;
+        return { completed: true };
+    }
     async handleOpenReply(command) {
         const { query, result } = this.#session.current;
         let loc, submittedEditor;

package/dist/browser-dom.js

@@ -89,6 +89,12 @@ export class DOMXBrowser {
         }
         result.alerts = (result.alerts ?? []).filter((text) => text.trim() !== "检测到 AI 生成内容");
         if (query.view === "composer") {
+            if (this.#session.quoteBinding && raw.quoteContexts?.length === 1) {
+                const q = raw.quoteContexts[0], b = this.#session.quoteBinding;
+                if (q.author?.toLowerCase() === b.author?.toLowerCase() &&
+                    q.body?.startsWith(b.body))
+                    result.quoteSourceId = b.postId;
+            }
             result.editorText =
                 raw.editors?.length === 1 ? raw.editors[0].text : null;
             if (result.inlineComposer &&

package/dist/growth-policy.js

@@ -173,6 +173,11 @@ export class GrowthPolicy {
                     action.quality.draftFingerprint !==
                         this.#store.fingerprint(action.draftPath)))
                 return "draft-changed-since-quality-review";
+            if (action.quoteTarget &&
+                (!/^\d+$/.test(action.quoteTarget.postId ?? "") ||
+                    !this.#evidenceExists(action.quoteTarget.evidenceRef) ||
+                    xURL(action.quoteTarget.url).pathname.match(/\/status\/(\d+)$/)?.[1] !== action.quoteTarget.postId))
+                return "quote-target-proof-missing";
             const scheduleReason = new DraftSchedule().reason(action, this.#clock());
             if (scheduleReason)
                 return scheduleReason;

package/dist/growth-recovery.js

@@ -49,7 +49,8 @@ export class GrowthRecovery {
             url.pathname.toLowerCase() !==
                 `/${action.accountHandle}/status/${postId}`.toLowerCase())
             throw new Error("public-account-mismatch");
-        const resolveQuote = /\nhttps:\/\/x\.com\/\w{1,15}\/status\/\d+$/.test(action.text);
+        const resolveQuote = Boolean(action.quoteTarget) ||
+            /\nhttps:\/\/x\.com\/\w{1,15}\/status\/\d+$/.test(action.text);
         const quoteCaps = this.#capability("read", { resolveQuote });
         if (!quoteCaps.covered)
             return { status: "needsCapability", missing: quoteCaps.missing };
@@ -57,7 +58,7 @@ export class GrowthRecovery {
             postId,
             url: publicURL,
             evidenceRef,
-            resolveQuote: /\nhttps:\/\/x\.com\/\w{1,15}\/status\/\d+$/.test(action.text),
+            resolveQuote,
         });
         const trailing = action.text.match(/(?:\n+)?((?:https:\/\/|(?:[a-zA-Z0-9-]+\.)+[a-zA-Z]{2,}\/)\S+)$/);
         let sourceURL = null;
@@ -114,6 +115,9 @@ export class GrowthRecovery {
                 }
             }
             return (p.id === postId &&
+                (!action.quoteTarget ||
+                    (p.quoteSource?.parentId === p.id &&
+                        p.quoteSource?.id === action.quoteTarget.postId)) &&
                 same(p.author, action.accountHandle) &&
                 (exact ||
                     quote ||

package/dist/platform-capabilities.js

@@ -13,6 +13,10 @@ export class PlatformCapabilities {
         if (operation === "readCreator" &&
             typeof this.#browser.collectCreator !== "function")
             absent.push("browser.collectCreator");
+        if (input.quoteTarget)
+            absent.push(...(this.#browser.capabilities?.("openQuoteComposer") ?? [
+                "openQuoteComposer",
+            ]), ...(this.#browser.capabilities?.("openQuote") ?? ["openQuote"]));
         if (input.resolveQuote)
             absent.push(...(this.#browser.capabilities?.("openQuote") ?? ["openQuote"]));
         if (input.kind === "follow" || operation === "submitFollow")

package/dist/platform-writing.d.ts

@@ -9,6 +9,9 @@ export declare class PlatformWriting {
     constructor(dependencies: Pick<PlatformDependencies, "observed" | "browser" | "followStage" | "readPerson" | "open" | "clock" | "readPost">);
     private handleCompose;
     private handleFindSubmission;
+    private matchesQuote;
+    private matchesContent;
+    private readQuotedReceipt;
     private readLoadedReplyReceipt;
     private handleSubmitFollow;
     private handleSubmitPost;

package/dist/platform-writing.js

@@ -33,7 +33,8 @@ export class PlatformWriting {
             value.alerts?.length ||
             typeof value.editorText !== "string" ||
             value.editorText.trim() !== "" ||
-            (action.kind === "reply" && value.replyToId !== action.postId))
+            (action.kind === "reply" && value.replyToId !== action.postId) ||
+            (action.quoteTarget && value.quoteSourceId !== action.quoteTarget.postId))
             throw new Error("编辑器不为空或回复上下文未绑定");
         if (action.assets?.length)
             await this.#browser.act({
@@ -46,6 +47,8 @@ export class PlatformWriting {
             value.needsStateCheck ||
             value.alerts?.length ||
             (action.kind === "reply" && value.replyToId !== action.postId) ||
+            (action.quoteTarget &&
+                value.quoteSourceId !== action.quoteTarget.postId) ||
             (action.accountHandle &&
                 !sameHandle(value.accountHandle, action.accountHandle)))
             throw new Error(`提交前账号/正文/目标未核实 ${JSON.stringify({ textMatches: sameText(value.editorText, action.text), needsStateCheck: value.needsStateCheck, alerts: value.alerts, accountHandle: value.accountHandle, replyToId: value.replyToId })}`);
@@ -124,15 +127,7 @@ export class PlatformWriting {
             });
             value = await this.#observed({ view: "posts", limit: 5 });
         }
-        const matchesContent = (post) => sameHandle(post.author, action.accountHandle) &&
-            samePublishedText(post.body, action.text) &&
-            /^\d+$/.test(post.id ?? "") &&
-            matchesReviewedAssets(post, action.assets) &&
-            !(action.beforeIds ?? []).includes(post.id) &&
-            Number.isFinite(Date.parse(post.datetime)) &&
-            Date.parse(post.datetime) >= Date.parse(action.intentAt) &&
-            Date.parse(post.datetime) <= this.#clock() + 5000 &&
-            !post.needsExpansion;
+        const matchesContent = (post) => this.matchesContent(post, action);
         let matches = (value.posts ?? []).filter(matchesContent);
         const receiptCandidate = action.kind === "reply" &&
             matches.length === 1 &&
@@ -170,6 +165,12 @@ export class PlatformWriting {
                 matches = (value.posts ?? []).filter(matchesContent);
             }
         }
+        if (action.quoteTarget && matches.length === 1) {
+            value = await this.readQuotedReceipt(value, action, matches[0]);
+            matches = (value.posts ?? [])
+                .filter(matchesContent)
+                .filter((p) => this.matchesQuote(p, action));
+        }
         if (action.kind === "reply")
             matches = matches.filter((post) => post.replyToId === action.postId);
         return {
@@ -180,6 +181,29 @@ export class PlatformWriting {
             missing: matches.length === 1 ? [] : ["unique-public-submission-unconfirmed"],
         };
     }
+    matchesQuote(post, action) {
+        return (post.quoteSource?.parentId === post.id &&
+            post.quoteSource?.id === action.quoteTarget.postId);
+    }
+    matchesContent(post, action) {
+        return (sameHandle(post.author, action.accountHandle) &&
+            samePublishedText(post.body, action.text) &&
+            /^\d+$/.test(post.id ?? "") &&
+            matchesReviewedAssets(post, action.assets) &&
+            !(action.beforeIds ?? []).includes(post.id) &&
+            Number.isFinite(Date.parse(post.datetime)) &&
+            Date.parse(post.datetime) >= Date.parse(action.intentAt) &&
+            Date.parse(post.datetime) <= this.#clock() + 5000 &&
+            !post.needsExpansion);
+    }
+    async readQuotedReceipt(value, action, candidate) {
+        return this.#readPost({
+            postId: candidate.id,
+            url: new URL(candidate.primary, value.page).href,
+            evidenceRef: { page: value.page, observedAt: value.observedAt },
+            resolveQuote: true,
+        });
+    }
     async readLoadedReplyReceipt(value, targetId, matchesContent) {
         const candidates = (value.posts ?? []).filter(matchesContent);
         if (value.needsStateCheck ||
@@ -222,7 +246,21 @@ export class PlatformWriting {
         return clicked;
     }
     async handleSubmitPost(action) {
-        await this.#open({ url: action.composeURL, evidenceRef: action.composeEvidenceRef }, { view: "composer" });
+        if (action.quoteTarget) {
+            const source = await this.#readPost(action.quoteTarget);
+            if (source.needsStateCheck ||
+                source.alerts?.length ||
+                source.posts?.length !== 1 ||
+                source.posts[0].id !== action.quoteTarget.postId)
+                throw Error("quote-source-unconfirmed");
+            await this.#browser.act({
+                operation: "openQuoteComposer",
+                postId: action.quoteTarget.postId,
+            });
+        }
+        else {
+            await this.#open({ url: action.composeURL, evidenceRef: action.composeEvidenceRef }, { view: "composer" });
+        }
         return this.handleCompose(action);
     }
     async handleSubmitReply(action) {

package/dist/readers-composer.js

@@ -101,6 +101,15 @@ export function readComposer() {
             kind: "video",
             label: el.getAttribute("aria-label"),
         })),
+        quoteContexts: Array.from(scope.querySelectorAll('[data-testid="attachments"]'))
+            .filter(visible)
+            .filter((el) => el.innerText.startsWith("引用") || el.innerText.startsWith("Quote"))
+            .map((el) => ({
+            author: el
+                .querySelector('[data-testid="User-Name"]')
+                ?.innerText.match(/@([A-Za-z0-9_]{1,15})/)?.[1],
+            body: el.querySelector('[data-testid="tweetText"]')?.innerText,
+        })),
         needsStateCheck: false,
     };
 }

package/dist/types.d.ts

@@ -255,6 +255,7 @@ export type PreparedAction = PreparedActionBase & ({
     text: string;
     composeURL: string;
     composeEvidenceRef: EvidenceRef;
+    quoteTarget?: PostTarget;
     assets?: {
         path: string;
         alt: string;

package/generated/observation.mjs

@@ -383,6 +383,15 @@ export const readXObservation = (query) => {
             kind: "video",
             label: el.getAttribute("aria-label"),
         })),
+        quoteContexts: Array.from(scope.querySelectorAll('[data-testid="attachments"]'))
+            .filter(visible)
+            .filter((el) => el.innerText.startsWith("引用") || el.innerText.startsWith("Quote"))
+            .map((el) => ({
+            author: el
+                .querySelector('[data-testid="User-Name"]')
+                ?.innerText.match(/@([A-Za-z0-9_]{1,15})/)?.[1],
+            body: el.querySelector('[data-testid="tweetText"]')?.innerText,
+        })),
         needsStateCheck: false,
     };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextclaw/x-harness",
-  "version": "0.2.43",
+  "version": "0.2.45",
   "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": "a1ddf2487e87818c3be2a23213700e9e5b2b4ce4"
+  "gitHead": "52258a7e88c8ebdab05e3981d37ec78becabffe6"
 }

package/skill/references/quotes.md

@@ -0,0 +1,5 @@
+# Reviewed quote posts
+
+Use publishPost with original preparedAction.quoteTarget:{postId,url,evidenceRef} from a complete observed source, and the reviewed commentary as text. The publisher opens the source’s observed repost→Quote editor. Empty composer, source preview, account and exact commentary are bound before submission. No plain-post fallback.
+
+Public verification resolves the quote card and requires its exact source ID and parent binding. Wrong or absent card remains unknown. Same-ID recovery may run after notAfter; never resubmit unknown. Original draft, calendar deadline, quality fingerprint and shared intent guards remain.

package/skill/references/writes.md

@@ -16,15 +16,33 @@ Original action optional notBefore is an ISO timestamp with timezone. Explicit d
 
 Original actions may pass `notAfter` as the calendar window’s exclusive ISO end. It is rechecked at intent and immediately before activation; expiration submits nothing. Unknown verification remains allowed after expiry.
 
+Real quotes: pass `quoteTarget:{postId,url,evidenceRef}`; composer and public card must bind that ID. See [quotes](quotes.md).
+
 Additional fields: kind:'original', draftPath (existing .post.md), text (complete approved text), composeURL, composeEvidenceRef; optional assets:[{path,alt}], activation:'click'|'keyboard'. Every media path must exist and be reviewed. The DOM uploader supports one absolute PNG/JPEG/WebP image with required ALT, or one absolute MP4 video. Video uploads wait for a visible preview and public settlement requires a video on the exact fresh post; image ALT controls are not applied to videos.
 
 ```js
-var result = await x.publishPost({ taskId, draftPath, preparedAction: {
-  id: actionId, status: 'prepared', kind: 'original',
-  accountHandle, accountURL, accountEvidenceRef,
-  quality: { approved: true, approvedText: text, evidenceRef: reviewProof, draftFingerprint },
-  draftPath, text, composeURL, composeEvidenceRef,
-} });
+var result = await x.publishPost({
+  taskId,
+  draftPath,
+  preparedAction: {
+    id: actionId,
+    status: "prepared",
+    kind: "original",
+    accountHandle,
+    accountURL,
+    accountEvidenceRef,
+    quality: {
+      approved: true,
+      approvedText: text,
+      evidenceRef: reviewProof,
+      draftFingerprint,
+    },
+    draftPath,
+    text,
+    composeURL,
+    composeEvidenceRef,
+  },
+});
 ```
 
 Optional independentExecution:{tabId,evidenceRef,scopeEvidenceRef} requires real independent task-tab/scope proof; binding executor scope is covered in setup only if needed. Existing original action can omit preparedAction; draftPath still required.
@@ -34,12 +52,24 @@ Optional independentExecution:{tabId,evidenceRef,scopeEvidenceRef} requires real
 Additional fields: kind:'reply', postId, url, evidenceRef (observed parent), text; optional assets/activation as above. Common account/quality fields still required. The exact parent is verified by the API. `replyBatch({taskId,actions})` accepts 1–5 reviewed replies, submits serially and recovers an observed receipt once without resending; waiting returns unfinished work. Incoming clicks have a ≥30s minimum gap, not a safety guarantee. Incoming conversations require reviewed conversation:{recipientHandle,rootId,round,automatedLoop?}; at most 3 own rounds per recipient/root, with intent/unknown counted. Mark observed automatic loops to stop earlier.
 
 ```js
-var result = await x.replyToPost({ taskId, postId, text, preparedAction: {
-  id: actionId, status: 'prepared', kind: 'reply',
-  accountHandle, accountURL, accountEvidenceRef,
-  quality: { approved: true, approvedText: text, evidenceRef: reviewProof },
-  postId, url: parentURL, evidenceRef: parentProof, text,
-} });
+var result = await x.replyToPost({
+  taskId,
+  postId,
+  text,
+  preparedAction: {
+    id: actionId,
+    status: "prepared",
+    kind: "reply",
+    accountHandle,
+    accountURL,
+    accountEvidenceRef,
+    quality: { approved: true, approvedText: text, evidenceRef: reviewProof },
+    postId,
+    url: parentURL,
+    evidenceRef: parentProof,
+    text,
+  },
+});
 ```
 
 ## Follow