@nextclaw/x-harness 0.1.0 → 0.2.0

package/dist/platform.js

@@ -1,681 +1,128 @@
-const handlePattern = /^[A-Za-z0-9_]{1,15}$/;
-export function xURL(value) {
-    const url = new URL(/^x\.com\//.test(value ?? "") ? `https://${value}` : value);
-    if (url.protocol !== "https:" ||
-        url.hostname !== "x.com" ||
-        url.username ||
-        url.password ||
-        url.port)
-        throw new Error("只接受已观察的https://x.com目标");
-    return url;
-}
-const sameHandle = (a, b) => typeof a === "string" &&
-    typeof b === "string" &&
-    a.toLowerCase() === b.toLowerCase();
-// Draft.js innerText can insert an extra separator for an empty paragraph block.
-const sameText = (a, b) => typeof a === "string" &&
-    typeof b === "string" &&
-    a.replace(/\r\n/g, "\n").replace(/\n{3,}/g, "\n\n") ===
-        b.replace(/\r\n/g, "\n").replace(/\n{3,}/g, "\n\n");
-export function createXPlatform(browser, { clock = () => Date.now() } = {}) {
-    // Bounded semantic diagnostics travel with existing proof captures; no page dump or second state store.
-    const followDiagnostics = [];
-    async function followStage(action, stage, run) {
-        const started = clock();
-        const event = {
-            actionId: action.id ?? null,
-            handle: action.handle,
-            stage,
-            startedAt: new Date(started).toISOString(),
-        };
-        followDiagnostics.push(event);
-        if (followDiagnostics.length > 40)
-            followDiagnostics.shift();
-        try {
-            const value = await run();
-            Object.assign(event, {
-                status: "returned",
-                durationMs: clock() - started,
-            });
-            if (value && typeof value === "object")
-                Object.assign(event, {
-                    page: value.page,
-                    accountHandle: value.accountHandle,
-                    relationship: value.relationship,
-                    relationshipControls: value.relationshipControls,
-                    needsStateCheck: value.needsStateCheck,
-                    alerts: value.alerts,
-                    fresh: value.fresh,
-                });
-            return value;
-        }
-        catch (error) {
-            Object.assign(event, {
-                status: "error",
-                durationMs: clock() - started,
-                error: String(error.message ?? error).slice(0, 500),
-            });
-            throw error;
-        }
-    }
-    const methods = ["observe", "act"];
-    const missing = (operation) => [
-        ...methods.filter((name) => typeof browser?.[name] !== "function"),
-        ...(typeof browser?.capabilities === "function"
-            ? browser.capabilities(operation)
-            : ["capabilities"]),
-    ];
-    async function observed(query) {
-        const value = await browser.observe(query);
-        return {
-            ...value,
-            observedAt: new Date(clock()).toISOString(),
-            fresh: true,
-        };
-    }
-    async function open(target, query) {
-        const url = xURL(target.url);
-        if (!target.evidenceRef)
-            throw new Error("目标URL缺已观察证据");
-        let value = await observed(query);
-        let atTarget = false;
-        try {
-            atTarget = xURL(value.page).href === url.href;
-        }
-        catch {
-            /* Blank/non-X pages require observed navigation. */
-        }
-        if (!atTarget) {
-            await browser.act({
-                operation: "openObserved",
-                url: url.href,
-                evidenceRef: target.evidenceRef,
-                view: query.view,
-                handle: query.handle,
-            });
-            value = await ready(query);
-        }
-        if (!value.page || xURL(value.page).href !== url.href)
-            return {
-                ...value,
-                needsStateCheck: true,
-                missing: ["target-page-mismatch"],
-            };
-        return value;
-    }
-    async function ready(query) {
-        let value = await observed(query);
-        if (value.needsStateCheck &&
-            !value.alerts?.length &&
-            query.view === "posts") {
-            try {
-                await browser.act({ operation: "waitForPosts" });
-            }
-            catch (error) {
-                if (!/timed out|timeout/i.test(error.message))
-                    throw error;
-            }
-            value = await observed(query);
-        }
-        return value;
-    }
-    async function choose(value, pattern, { activateSelected = false } = {}) {
-        const controls = (value.controls ?? value.items ?? []).filter((c) => !c.disabled && pattern(c));
-        if (controls.length !== 1)
-            return false;
-        if (controls[0].selected && !activateSelected)
-            return true;
-        await browser.act({ operation: "openControl", ...controls[0] });
-        return true;
-    }
-    const source = (post, page) => ({
-        id: post.id,
-        author: post.author,
-        datetime: post.datetime,
-        url: post.primary ? new URL(post.primary, page).href : null,
-        body: post.body,
-        images: post.images ?? [],
-        media: post.media ?? [],
-        links: post.links ?? [],
-        needsExpansion: post.needsExpansion,
-        missing: [
-            ...(post.missing ?? []),
-            ...(!post.body ? ["exact-body-unconfirmed"] : []),
-        ],
-    });
-    async function collectSources({ processedIds = [], maxPages = 3, limit = 1, } = {}) {
-        if (!Array.isArray(processedIds) ||
-            !Number.isInteger(maxPages) ||
-            maxPages < 1 ||
-            maxPages > 10 ||
-            !Number.isInteger(limit) ||
-            limit < 1 ||
-            limit > 5)
-            throw new Error("来源窗口须为1–5，页面上限1–10及已处理ID数组");
-        const seen = new Set(processedIds), sources = [], missing = [];
-        let last, previousIds = "", offset = 0, firstDOMId;
-        for (let page = 0; page < maxPages && sources.length < limit; page++) {
-            last = await ready({ view: "posts", offset, limit: 5 });
-            if (page === 0)
-                firstDOMId = last.posts?.[0]?.id;
-            if (last.needsStateCheck || last.alerts?.length)
-                return {
-                    ...last,
-                    sources,
-                    complete: false,
-                    missing: ["source-page-unconfirmed"],
-                };
-            if (offset && !last.posts?.length) {
-                missing.push("source-window-not-yet-rendered");
-                break;
-            }
-            const ids = (last.posts ?? []).map((p) => p.id).join(",");
-            if (page && ids === previousIds) {
-                missing.push("pagination-did-not-advance");
-                break;
-            }
-            previousIds = ids;
-            for (const candidate of last.posts ?? []) {
-                if (!candidate.id || seen.has(candidate.id))
-                    continue;
-                seen.add(candidate.id);
-                let post = candidate;
-                if (candidate.needsExpansion) {
-                    const target = await observed({
-                        view: "posts",
-                        targetId: candidate.id,
-                        limit: 1,
-                    });
-                    if (target.posts?.length !== 1) {
-                        missing.push("expansion-target-unconfirmed");
-                        continue;
-                    }
-                    await browser.act({ operation: "expandPost", postId: candidate.id });
-                    const expanded = await ready({
-                        view: "posts",
-                        targetId: candidate.id,
-                        limit: 1,
-                    });
-                    if (expanded.needsStateCheck || expanded.alerts?.length)
-                        return {
-                            ...expanded,
-                            sources,
-                            complete: false,
-                            missing: ["expanded-source-unconfirmed"],
-                        };
-                    post = expanded.posts?.[0];
-                }
-                if (!post ||
-                    post.needsExpansion ||
-                    !post.body ||
-                    !post.author ||
-                    !Number.isFinite(Date.parse(post.datetime))) {
-                    missing.push(`incomplete-source:${candidate.id}`);
-                    continue;
-                }
-                sources.push(source(post, last.page));
-                if (sources.length >= limit)
-                    break;
-            }
-            if (sources.length < limit && page + 1 < maxPages) {
-                // Expansion narrowed the semantic window; restore the list before scrolling.
-                last = await observed({ view: "posts", offset, limit: 5 });
-                if (last.moreInDOM)
-                    offset += 5;
-                else {
-                    await browser.act({ operation: "nextPosts" });
-                    const advanced = await ready({ view: "posts", limit: 5 });
-                    // Retained DOM prefixes include a partial final window too; skip
-                    // exactly the consumed cards, while virtualized replacements restart.
-                    offset =
-                        firstDOMId && advanced.posts?.[0]?.id === firstDOMId
-                            ? offset + (last.posts?.length ?? 0)
-                            : 0;
-                    firstDOMId = advanced.posts?.[0]?.id;
-                }
-            }
-        }
-        return {
-            page: last?.page,
-            accountHandle: last?.accountHandle,
-            observedAt: last?.observedAt,
-            fresh: true,
-            sources,
-            complete: sources.length >= limit,
-            pageComplete: false,
-            missing: sources.length >= limit
-                ? []
-                : [...new Set([...missing, "bounded-source-window-exhausted"])],
-        };
-    }
-    const api = {
-        preflight({ operation, input = {} }) {
-            const absent = missing(operation);
-            if (operation === "readCreator" &&
-                typeof browser.collectCreator !== "function")
-                absent.push("browser.collectCreator");
-            if (input.kind === "follow" || operation === "submitFollow")
-                absent.push(...(browser.capabilities?.("refreshPerson") ?? ["refreshPerson"]));
-            if (operation !== "read" && input.assets?.length)
-                absent.push(...(browser.capabilities?.("attachAssets") ?? ["attachAssets"]));
-            return {
-                covered: absent.length === 0,
-                missing: [...new Set(absent)],
-                owner: "scripts/x-harness-browser.mjs",
-            };
-        },
-        async readCreator(args) {
-            if (typeof browser.collectCreator !== "function")
-                return {
-                    status: "needsCapability",
-                    complete: false,
-                    missing: ["browser.collectCreator"],
-                };
-            const value = await browser.collectCreator(args);
-            const absent = [
-                ...new Set([
-                    ...(value.missing ?? []),
-                    ...(value.profile?.alerts ?? []),
-                    ...(value.meta?.missing ?? []),
-                ]),
-            ];
-            return {
-                ...value,
-                sources: value.posts,
-                page: `https://x.com/${args.handle}`,
-                pageComplete: false,
-                complete: value.complete === true && !absent.length && !value.alerts?.length,
-                missing: absent,
-            };
-        },
-        readAccount: () => observed({ view: "account" }),
-        async readBookmarks({ folder, ...window } = {}) {
-            if (typeof folder !== "string" || !folder.trim())
-                throw new Error("需指定收藏文件夹；不以全部书签冒充命名文件夹");
-            let nav = await ready({ view: "navigation", targetLabel: folder });
-            const bookmark = (c) => /^(书签|收藏|Bookmarks)$/i.test(c.label);
-            if (!(await choose(nav, bookmark, { activateSelected: true }))) {
-                if (await choose(nav, (c) => /^(更多菜单项|More menu items)$/i.test(c.label))) {
-                    nav = await ready({ view: "menu" });
-                    if (!(await choose(nav, bookmark))) {
-                        if (nav.items?.length)
-                            await browser.act({ operation: "dismissMenu" });
-                        nav = await ready({ view: "navigation", targetLabel: folder });
-                        if (!(await choose(nav, (c) => /^(历史|History)$/i.test(c.label))))
-                            return {
-                                status: "needsCapability",
-                                owner: "scripts/x-harness-browser.mjs",
-                                missing: ["bookmarks-entry-not-observed"],
-                            };
-                    }
-                }
-                else if (!(await choose(nav, (c) => /^(历史|History)$/i.test(c.label))))
-                    return {
-                        status: "needsCapability",
-                        owner: "scripts/x-harness-browser.mjs",
-                        missing: ["bookmarks-entry-not-observed"],
-                    };
-            }
-            nav = await ready({ view: "navigation", targetLabel: folder });
-            const tabs = (nav.controls ?? []).filter((c) => c.role === "tab" && bookmark(c));
-            if (tabs.length === 1 &&
-                (!tabs[0].selected ||
-                    !(nav.controls ?? []).some((c) => c.label.split("\n")[0] === folder))) {
-                await choose(nav, (c) => c === tabs[0], {
-                    activateSelected: true,
-                });
-                nav = await ready({ view: "navigation", targetLabel: folder });
-            }
-            if (!(nav.controls ?? []).some((c) => c.label.split("\n")[0] === folder)) {
-                try {
-                    await browser.act({ operation: "waitForFolder", folder });
-                }
-                catch (error) {
-                    if (!/timed out|timeout/i.test(error.message))
-                        throw error;
-                }
-                nav = await ready({ view: "navigation", targetLabel: folder });
-            }
-            if (!(await choose(nav, (c) => c.label.split("\n")[0] === folder)))
-                return {
-                    status: "needsCapability",
-                    owner: "scripts/x-harness-browser.mjs",
-                    page: nav.page,
-                    missing: ["named-bookmark-folder-not-observed"],
-                    folder,
-                    controls: nav.controls,
-                };
-            const selected = await ready({ view: "navigation" });
-            if (selected.page === nav.page && !selected.headings?.includes(folder))
-                return {
-                    status: "needsDecision",
-                    complete: false,
-                    missing: ["folder-selection-unconfirmed"],
-                    folder,
-                    page: selected.page,
-                };
-            const value = await collectSources(window);
-            return {
-                ...value,
-                folder,
-                folderEvidence: {
-                    entryPage: nav.page,
-                    selectedPage: selected.page,
-                    name: folder,
-                },
-            };
-        },
-        async searchSources({ query, limit = 3, maxPages = 1, processedIds = [], } = {}) {
-            await browser.act({ operation: "searchSources", query });
-            const value = await collectSources({ limit, maxPages, processedIds });
-            if (!value.page ||
-                xURL(value.page).pathname !== "/search" ||
-                xURL(value.page).searchParams.get("q") !== query)
-                return {
-                    ...value,
-                    complete: false,
-                    missing: ["search-query-unconfirmed"],
-                };
-            return { ...value, query };
-        },
-        async readFeedback({ targets, replyLimit = 3 } = {}) {
-            if (!Array.isArray(targets) || targets.length < 1 || targets.length > 5)
-                throw new Error("反馈窗口须为1–5个已发布ID");
-            if (!Number.isInteger(replyLimit) || replyLimit < 0 || replyLimit > 3)
-                throw new Error("回复核验窗口须为0–3");
-            const feedback = [];
-            for (const target of targets) {
-                const value = await api.readPost(target), post = value.posts?.find((p) => p.id === target.postId);
-                if (value.needsStateCheck || value.alerts?.length || !post) {
-                    feedback.push({
-                        id: target.postId,
-                        missing: ["published-post-unconfirmed"],
-                    });
-                    continue;
-                }
-                const thread = await observed({ view: "posts", limit: 5 });
-                const replies = [], unconfirmedReplyIds = [];
-                const targetIndex = (thread.posts ?? []).findIndex((p) => p.id === post.id);
-                const candidates = targetIndex < 0
-                    ? []
-                    : thread.posts.slice(targetIndex + 1, targetIndex + 1 + replyLimit);
-                for (const candidate of candidates) {
-                    if (!candidate.primary || !candidate.id)
-                        continue;
-                    const url = new URL(candidate.primary, thread.page).href;
-                    const detail = await open({
-                        url,
-                        evidenceRef: {
-                            page: thread.page,
-                            observedAt: thread.observedAt,
-                            publicId: candidate.id,
-                            primary: candidate.primary,
-                        },
-                    }, {
-                        view: "posts",
-                        targetId: candidate.id,
-                        replyTargetId: target.postId,
-                        limit: 1,
-                    });
-                    const reply = detail.posts?.find((p) => p.id === candidate.id);
-                    if (!detail.needsStateCheck &&
-                        !detail.alerts?.length &&
-                        reply?.replyToId === target.postId &&
-                        reply.body &&
-                        !reply.needsExpansion)
-                        replies.push(source(reply, detail.page));
-                    else
-                        unconfirmedReplyIds.push(candidate.id);
-                }
-                feedback.push({
-                    id: post.id,
-                    author: post.author,
-                    metrics: [...(post.buttons ?? []), ...(post.metrics ?? [])],
-                    replies,
-                    unconfirmedReplyIds,
-                    pageComplete: false,
-                    observedAt: value.observedAt,
-                });
-            }
-            return {
-                feedback,
-                fresh: true,
-                complete: feedback.every((f) => !f.missing),
-                pageComplete: false,
-            };
-        },
-        async readPerson(target) {
-            if (!handlePattern.test(target.handle ?? ""))
-                throw new Error("无效已观察handle");
-            if (xURL(target.url).pathname.toLowerCase() !==
-                `/${target.handle}`.toLowerCase())
-                throw new Error("人物URL与handle不一致");
-            const value = await open(target, {
-                view: "person",
-                handle: target.handle,
-            });
-            return sameHandle(value.handle, target.handle)
-                ? { ...value, url: target.url }
-                : {
-                    ...value,
-                    needsStateCheck: true,
-                    missing: ["person-identity-mismatch"],
-                };
-        },
-        async readPost(target) {
-            if (!/^\d+$/.test(target.postId ?? "") ||
-                xURL(target.url).pathname.match(/\/status\/(\d+)$/)?.[1] !==
-                    target.postId)
-                throw new Error("帖子URL与公开ID不一致");
-            let value = await open(target, {
-                view: "posts",
-                targetId: target.postId,
-            });
-            if (!target.expand)
-                return value;
-            let posts = (value.posts ?? []).filter((p) => p.id === target.postId);
-            if (!value.needsStateCheck &&
-                !value.alerts?.length &&
-                posts.length === 1 &&
-                posts[0].needsExpansion) {
-                await browser.act({ operation: "expandPost", postId: target.postId });
-                value = await ready({ view: "posts", targetId: target.postId });
-                posts = (value.posts ?? []).filter((p) => p.id === target.postId);
-            }
-            const missing = [...(value.missing ?? [])];
-            if (posts.length !== 1)
-                missing.push("unique-target-post-unconfirmed");
-            else {
-                if (!posts[0].body)
-                    missing.push("exact-body-unconfirmed");
-                if (posts[0].needsExpansion)
-                    missing.push("post-expansion-unconfirmed");
-                if (!posts[0].author)
-                    missing.push("post-author-unconfirmed");
-                if (!Number.isFinite(Date.parse(posts[0].datetime)))
-                    missing.push("absolute-time-unconfirmed");
-            }
-            return {
-                ...value,
-                posts,
-                complete: !missing.length && !value.needsStateCheck && !value.alerts?.length,
-                missing,
-            };
-        },
-        async findSubmission(action) {
-            if (action.kind === "follow") {
-                let value = await followStage(action, "verify-read", () => api.readPerson(action));
-                if (!value.needsStateCheck) {
-                    const absent = browser.capabilities?.("refreshPerson") ?? [
-                        "refreshPerson",
-                    ];
-                    if (absent.length)
-                        return {
-                            ...value,
-                            verified: false,
-                            missing: absent,
-                            needsStateCheck: true,
-                        };
-                    await followStage(action, "verify-refresh", () => browser.act({
-                        operation: "refreshPerson",
-                        handle: action.handle,
-                        url: action.url,
-                        evidenceRef: action.evidenceRef,
-                    }));
-                    value = await followStage(action, "verify-after-refresh", () => api.readPerson(action));
-                }
-                return {
-                    ...value,
-                    verified: !value.needsStateCheck &&
-                        !value.alerts?.length &&
-                        value.relationship === "following" &&
-                        (!action.accountHandle ||
-                            sameHandle(value.accountHandle, action.accountHandle)),
-                    publicId: null,
-                };
-            }
-            // A bounded window cannot prove absence. Reply receipts use the observed target conversation.
-            const observedReceipt = action.kind === "reply" &&
-                action.observedPublicURL &&
-                action.observedPublicEvidenceRef;
-            const receiptPath = observedReceipt
-                ? xURL(action.observedPublicURL).pathname.split("/")
-                : [];
-            if (observedReceipt &&
-                (receiptPath.length !== 4 ||
-                    !sameHandle(receiptPath[1], action.accountHandle) ||
-                    receiptPath[2] !== "status" ||
-                    !/^[0-9]+$/.test(receiptPath[3])))
-                throw new Error("已观察回复回执须属于原账号");
-            const receiptTarget = observedReceipt
-                ? {
-                    url: action.observedPublicURL,
-                    evidenceRef: action.observedPublicEvidenceRef,
-                }
-                : action.kind === "reply" && action.url && action.evidenceRef
-                    ? { url: action.url, evidenceRef: action.evidenceRef }
-                    : { url: action.accountURL, evidenceRef: action.accountEvidenceRef };
-            let value = await open(receiptTarget, { view: "posts", limit: 5 });
-            if (!value.needsStateCheck &&
-                !(browser.capabilities?.("refreshPosts") ?? ["refreshPosts"]).length) {
-                await browser.act({
-                    operation: "refreshPosts",
-                    url: receiptTarget.url,
-                    evidenceRef: receiptTarget.evidenceRef,
-                });
-                value = await observed({ view: "posts", limit: 5 });
-            }
-            const matchesContent = (post) => sameHandle(post.author, action.accountHandle) &&
-                sameText(post.body, action.text) &&
-                /^\d+$/.test(post.id ?? "") &&
-                (!action.assets?.length ||
-                    action.assets.every((asset) => post.images?.some((image) => image.alt === asset.alt))) &&
-                !(action.beforeIds ?? []).includes(post.id) &&
-                Number.isFinite(Date.parse(post.datetime)) &&
-                Date.parse(post.datetime) >= Date.parse(action.intentAt) &&
-                Date.parse(post.datetime) <= clock() + 5000 &&
-                !post.needsExpansion;
-            let matches = (value.posts ?? []).filter(matchesContent);
-            if (action.kind === "reply" &&
-                matches.length === 1 &&
-                matches[0].replyToId == null &&
-                matches[0].primary) {
-                // The candidate URL comes from this fresh public observation, not from a guessed ID path.
-                const candidate = matches[0];
-                const url = xURL(new URL(candidate.primary, xURL(value.page).origin).href);
-                if (url.pathname.toLowerCase() ===
-                    `/${action.accountHandle}/status/${candidate.id}`.toLowerCase()) {
-                    value = await open({
-                        url: url.href,
-                        evidenceRef: {
-                            page: value.page,
-                            observedAt: value.observedAt,
-                            publicId: candidate.id,
-                            primary: candidate.primary,
-                        },
-                    }, {
-                        view: "posts",
-                        targetId: candidate.id,
-                        replyTargetId: action.postId,
-                    });
-                    matches = (value.posts ?? []).filter(matchesContent);
-                }
-            }
-            if (action.kind === "reply")
-                matches = matches.filter((post) => post.replyToId === action.postId);
-            return {
-                ...value,
-                verified: !value.needsStateCheck &&
-                    !value.alerts?.length &&
-                    matches.length === 1,
-                publicId: matches.length === 1 ? matches[0].id : null,
-                missing: matches.length === 1 ? [] : ["unique-public-submission-unconfirmed"],
-            };
-        },
-        async submitFollow(action) {
-            const value = await followStage(action, "submit-preflight-read", () => api.readPerson(action));
-            if (value.needsStateCheck ||
-                value.alerts?.length ||
-                !["not-following", "follows-you"].includes(value.relationship) ||
-                (action.accountHandle &&
-                    !sameHandle(value.accountHandle, action.accountHandle)))
-                throw new Error("fresh账号/人物关系不允许关注");
-            await followStage(action, "submit-guard", () => action.beforeSubmit?.());
-            // A returned click is not a receipt from X; durable success still requires fresh verification.
-            const clicked = await followStage(action, "click", () => browser.act({ operation: "follow", handle: action.handle }));
-            try {
-                await followStage(action, "click-ui-observation", () => observed({ view: "person", handle: action.handle }));
-            }
-            catch {
-                /* The click may have committed; retain diagnostic failure and use the original fresh receipt path. */
-            }
-            return clicked;
-        },
-        async submitPost(action) {
-            await open({ url: action.composeURL, evidenceRef: action.composeEvidenceRef }, { view: "composer" });
-            return compose(action);
-        },
-        async submitReply(action) {
-            const value = await api.readPost(action);
-            if (value.needsStateCheck ||
-                value.alerts?.length ||
-                !(value.posts ?? []).some((p) => p.id === action.postId))
-                throw new Error("回复主帖身份未核实");
-            await browser.act({ operation: "openReply", postId: action.postId });
-            return compose(action);
-        },
-        captureProof: ({ observation }) => ({
-            capturedAt: new Date(clock()).toISOString(),
-            observation,
-            ...(followDiagnostics.length
-                ? { followDiagnostics: structuredClone(followDiagnostics) }
-                : {}),
-        }),
-    };
-    async function compose(action) {
-        let value = await observed({ view: "composer" });
-        if (value.needsStateCheck ||
-            value.alerts?.length ||
-            typeof value.editorText !== "string" ||
-            value.editorText.trim() !== "" ||
-            (action.kind === "reply" && value.replyToId !== action.postId))
-            throw new Error("编辑器不为空或回复上下文未绑定");
-        if (action.assets?.length)
-            await browser.act({ operation: "attachAssets", assets: action.assets });
-        await browser.act({ operation: "fillComposer", text: action.text });
-        value = await observed({ view: "composer" });
-        if (!sameText(value.editorText, action.text) ||
-            value.needsStateCheck ||
-            value.alerts?.length ||
-            (action.kind === "reply" && value.replyToId !== action.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 })}`);
-        return browser.act({
-            operation: action.kind === "reply" ? "submitReply" : "submitPost",
-            beforeSubmit: action.beforeSubmit,
-            ...(action.activation ? { activation: action.activation } : {}),
+import { createPlatformObservation } from "./platform-observation.js";
+import { createPlatformTargets } from "./platform-targets.js";
+import { createPlatformCollections } from "./platform-collections.js";
+import { createPlatformDiagnostics } from "./platform-diagnostics.js";
+import { createPlatformWriting } from "./platform-writing.js";
+import { createPlatformCapabilities } from "./platform-capabilities.js";
+export { xURL } from "./platform-rules.js";
+export class XPlatform {
+    #clock;
+    #createPlatformObservationResult;
+    #missing;
+    #observed;
+    #open;
+    #ready;
+    #choose;
+    #createPlatformTargetsResult;
+    #readAccount;
+    #readFeedback;
+    #readPerson;
+    #readPost;
+    #createPlatformCollectionsResult;
+    #collectSources;
+    #readCreator;
+    #readBookmarks;
+    #searchSources;
+    #createPlatformDiagnosticsResult;
+    #followStage;
+    #captureProof;
+    #createPlatformWritingResult;
+    #compose;
+    #findSubmission;
+    #submitFollow;
+    #submitPost;
+    #submitReply;
+    #createPlatformCapabilitiesResult;
+    #preflight;
+    preflight;
+    readCreator;
+    readAccount;
+    readBookmarks;
+    searchSources;
+    readFeedback;
+    readPerson;
+    readPost;
+    findSubmission;
+    submitFollow;
+    submitPost;
+    submitReply;
+    captureProof;
+    constructor(browser, { clock = () => Date.now() } = {}) {
+        this.#clock = clock;
+        this.#createPlatformObservationResult = createPlatformObservation({
+            browser: browser,
+            clock: this.#clock,
         });
+        const { missing, observed, open, ready, choose } = this.#createPlatformObservationResult;
+        this.#missing = missing;
+        this.#observed = observed;
+        this.#open = open;
+        this.#ready = ready;
+        this.#choose = choose;
+        this.#createPlatformTargetsResult = createPlatformTargets({
+            observed: this.#observed,
+            open: this.#open,
+            browser: browser,
+            ready: this.#ready,
+        });
+        const { readAccount, readFeedback, readPerson, readPost } = this.#createPlatformTargetsResult;
+        this.#readAccount = readAccount;
+        this.#readFeedback = readFeedback;
+        this.#readPerson = readPerson;
+        this.#readPost = readPost;
+        this.#createPlatformCollectionsResult = createPlatformCollections({
+            ready: this.#ready,
+            observed: this.#observed,
+            browser: browser,
+            choose: this.#choose,
+        });
+        const { collectSources, readCreator, readBookmarks, searchSources } = this.#createPlatformCollectionsResult;
+        this.#collectSources = collectSources;
+        this.#readCreator = readCreator;
+        this.#readBookmarks = readBookmarks;
+        this.#searchSources = searchSources;
+        this.#createPlatformDiagnosticsResult = createPlatformDiagnostics({
+            clock: this.#clock,
+        });
+        const { followStage, captureProof } = this.#createPlatformDiagnosticsResult;
+        this.#followStage = followStage;
+        this.#captureProof = captureProof;
+        this.#createPlatformWritingResult = createPlatformWriting({
+            observed: this.#observed,
+            browser: browser,
+            followStage: this.#followStage,
+            readPerson: this.#readPerson,
+            open: this.#open,
+            clock: this.#clock,
+            readPost: this.#readPost,
+        });
+        const { compose, findSubmission, submitFollow, submitPost, submitReply } = this.#createPlatformWritingResult;
+        this.#compose = compose;
+        this.#findSubmission = findSubmission;
+        this.#submitFollow = submitFollow;
+        this.#submitPost = submitPost;
+        this.#submitReply = submitReply;
+        this.#createPlatformCapabilitiesResult = createPlatformCapabilities({
+            missing: this.#missing,
+            browser: browser,
+        });
+        const { preflight } = this.#createPlatformCapabilitiesResult;
+        this.#preflight = preflight;
+        this.preflight = this.#preflight;
+        this.readCreator = this.#readCreator;
+        this.readAccount = this.#readAccount;
+        this.readBookmarks = this.#readBookmarks;
+        this.searchSources = this.#searchSources;
+        this.readFeedback = this.#readFeedback;
+        this.readPerson = this.#readPerson;
+        this.readPost = this.#readPost;
+        this.findSubmission = this.#findSubmission;
+        this.submitFollow = this.#submitFollow;
+        this.submitPost = this.#submitPost;
+        this.submitReply = this.#submitReply;
+        this.captureProof = this.#captureProof;
     }
-    return api;
+}
+export function createXPlatform(...args) {
+    return new XPlatform(...args);
 }