surfagent-x

Check whether X is open in SurfAgent, identify current X page state, and report composer/account readiness.

Open X in SurfAgent. Optionally choose a starting section such as home, notifications, search, or a profile path.

Inspect the active X account and any account-switcher entries currently visible.

Switch X accounts through the in-session account switcher and verify the resulting active account state.

Get structured X page state for the current tab: route, page kind, selected tabs, composer state, and account info.

Return the built-in X state maps for flaky surfaces like account switcher, composer, community, home, post, and profile.

Open the X home timeline and wait for a settled X page state.

Open a profile by username.

Open X notifications.

Open X search, optionally prefilled with a query and live filter.

Open a specific X post by full URL or by username + status ID.

Extract the currently visible X timeline posts with author, text, status URL, and social action labels.

Search X posts and return extracted live results from the search timeline.

Open an X community URL directly. Useful because community navigation has its own weird composer behavior.

Search X communities and return community cards/links discovered on the search surface.

Search X profiles and return discovered accounts with display names, handles, bios, and URLs.

Extract visible posts from the current or specified X community feed.

Open a community and return structured community metadata, including name, description, member/post hints, and join state when visible.

Open a post and return a structured post record with author, text, media, and visible stats.

Open a profile and return a structured profile record with bio, stats, and pinned post when visible.

Open a profile and extract visible posts from that profile timeline.

Open a post and extract the visible thread/timeline around it as structured post rows.

Inspect the current X composer state, including whether the Post/Reply button is enabled.

Create a new X post from the home composer with button-state verification and automatic real-typing fallback if X rejects the initial input.

Reply to a specific post with pre-submit composer verification, automatic real-typing fallback, and post-submit visibility verification.

Like a specific X post and verify resulting button state.

Repost a specific X post and verify the resulting repost state.

Follow an X profile and verify the resulting follow state from the active account.

Run a deterministic engage-post task with account switch, screenshots, optional like/repost actions, and a persisted run journal.

Run a deterministic quote-post task with screenshots before and after submit, account switching, and profile-level verification.

Run a deterministic reply-post task with account switching, screenshots, and post-surface verification.

Run a deterministic follow-profile task with account switching, screenshots, and profile-state verification.

Run a deterministic community-post task with membership check, screenshots, composer recovery, and feed verification.

Run a deterministic account switch followed by a focused action like open-home, open-url, or follow-profile.

Verify that a specific text snippet is visible on X. Scope can target body, article content, or the active composer.

Apply lightweight X recovery actions for common stuck states: composer, home, or target URL.

Run an autonomous X research pass for a topic, with retries, receipts, post/thread/profile extraction, and community sampling.

Run an autonomous community mapping pass: open a community, extract feed rows, and profile a sample of visible participants.