@11agents/cli 0.1.25 → 0.1.27

package/mobile-runtime/configs/platforms/xiaohongshu_d01.json

@@ -57,7 +57,7 @@
     "after_paste_probe": 1,
     "detail_load_timeout": 12,
     "publish_poll_interval": 2,
-    "publish_timeout": 45
+    "publish_timeout": 180
   },
   "success_focus_keywords": [
     "IndexActivityV2"

package/mobile-runtime/configs/platforms/xiaohongshu_d02.json

@@ -57,7 +57,7 @@
     "after_paste_probe": 1,
     "detail_load_timeout": 12,
     "publish_poll_interval": 2,
-    "publish_timeout": 45
+    "publish_timeout": 180
   },
   "success_focus_keywords": ["IndexActivityV2"],
   "detail_focus_keywords": ["NoteDetailActivity"],

package/mobile-runtime/configs/platforms/xiaohongshu_d03.json

@@ -57,7 +57,7 @@
     "after_paste_probe": 1,
     "detail_load_timeout": 12,
     "publish_poll_interval": 2,
-    "publish_timeout": 45
+    "publish_timeout": 180
   },
   "success_focus_keywords": [
     "IndexActivityV2"

package/mobile-runtime/python/src/device_control/adb.py

@@ -76,6 +76,9 @@ class AdbClient:
             "1",
         )
 
+    def force_stop(self, serial: str, package: str) -> CommandResult:
+        return self.shell(serial, "am", "force-stop", package)
+
     def push(self, serial: str, local_path: str | Path, remote_path: str) -> CommandResult:
         return self.run("-s", serial, "push", str(local_path), remote_path, timeout_s=120)
 

package/mobile-runtime/python/src/device_control/cli.py

@@ -224,7 +224,7 @@ def main() -> None:
     collect_tiktok_account_p.add_argument(
         "--allow-manual-required",
         action="store_true",
-        help="Exit 0 after screenshot capture even if values still need human extraction.",
+        help="Exit 0 after screenshot capture even if values still need manual extraction.",
     )
     collect_tiktok_account_p.add_argument("--no-append", action="store_true", help="Do not append the snapshot JSONL row.")
     collect_tiktok_account_p.add_argument("--json", action="store_true", help="Print JSON")
@@ -259,7 +259,7 @@ def main() -> None:
     collect_tiktok_video_p.add_argument(
         "--allow-manual-required",
         action="store_true",
-        help="Exit 0 after screenshot capture even if values still need human extraction.",
+        help="Exit 0 after screenshot capture even if values still need manual extraction.",
     )
     collect_tiktok_video_p.add_argument("--no-append", action="store_true", help="Do not append the snapshot JSONL row.")
     collect_tiktok_video_p.add_argument("--json", action="store_true", help="Print JSON")
@@ -319,8 +319,10 @@ def main() -> None:
     copy_xhs_link_p.add_argument("--appium-server", default="http://127.0.0.1:4723")
     _add_appium_preflight_args(copy_xhs_link_p)
     copy_xhs_link_p.add_argument("--flow-config", default="configs/platforms/xiaohongshu_d03.json")
-    copy_xhs_link_p.add_argument("--device", required=True, help="Device id, e.g. D03.")
+    copy_xhs_link_p.add_argument("--device", default="", help="Device id, e.g. D03. If omitted with --record-id, read it from the publish record.")
     copy_xhs_link_p.add_argument("--record-id", default="", help="Update this publish record when a URL is retrieved.")
+    copy_xhs_link_p.add_argument("--expected-title", default="", help="Expected Xiaohongshu note title for latest-note verification.")
+    copy_xhs_link_p.add_argument("--expected-caption", default="", help="Expected Xiaohongshu note caption/body for latest-note verification.")
     copy_xhs_link_p.add_argument("--json", action="store_true", help="Print JSON")
 
     args = parser.parse_args()
@@ -654,11 +656,9 @@ def main() -> None:
                 f"periods={complete}/{len(snapshot.periods)} duration={snapshot.duration_seconds}s "
                 f"artifact_dir={snapshot.artifact_dir} out={args.out if not args.no_append else '(not appended)'}"
             )
-            if snapshot.status == "needs_human":
-                print("manual values required: review period screenshots, then rerun with --values-json or --values-file")
             if snapshot.status == "failed":
-                print(f"error={snapshot.raw.get('error', '')}")
-        if snapshot.status == "failed" or (snapshot.status == "needs_human" and not args.allow_manual_required):
+                print(f"error={snapshot.raw.get('error', snapshot.raw.get('extraction_status', 'automatic extraction failed'))}")
+        if snapshot.status == "failed":
             raise SystemExit(1)
         return
 
@@ -696,11 +696,9 @@ def main() -> None:
                 f"published_at={snapshot.published_at or '(unknown)'} duration={snapshot.duration_seconds}s "
                 f"artifact_dir={snapshot.artifact_dir} out={args.out if not args.no_append else '(not appended)'}"
             )
-            if snapshot.status == "needs_human":
-                print("manual values required: review the video-insights screenshot, then rerun with --values-json or --values-file")
             if snapshot.status == "failed":
-                print(f"error={snapshot.raw.get('error', '')}")
-        if snapshot.status == "failed" or (snapshot.status == "needs_human" and not args.allow_manual_required):
+                print(f"error={snapshot.raw.get('error', snapshot.raw.get('extraction_status', 'automatic extraction failed'))}")
+        if snapshot.status == "failed":
             raise SystemExit(1)
         return
 
@@ -1006,7 +1004,14 @@ def main() -> None:
         return
 
     if args.command == "copy-xiaohongshu-link":
-        device = _get_device(args.devices, args.device)
+        record = None
+        if args.record_id:
+            records = load_publish_records(args.records)
+            record = _find_record(records, args.record_id)
+        device_id = args.device or (record.device_id if record else "")
+        if not device_id:
+            raise SystemExit("copy-xiaohongshu-link requires --device or --record-id for a record with device_id")
+        device = _get_device(args.devices, device_id)
         _ensure_appium_preflight(args, [device])
         publisher = XiaohongshuAdbPublisher(
             adb,
@@ -1014,11 +1019,17 @@ def main() -> None:
             records_path=args.records,
             flow_config_path=args.flow_config,
         )
+        expected_title = args.expected_title
+        expected_caption = args.expected_caption
+        if record and not expected_title and not expected_caption:
+            expected_title, expected_caption = _xiaohongshu_expected_from_record(record)
         with device_lock(device.device_id):
-            result = publisher.copy_current_note_link(device)
-        if result.platform_permalink and args.record_id:
-            records = load_publish_records(args.records)
-            record = _find_record(records, args.record_id)
+            result = publisher.copy_current_note_link(
+                device,
+                expected_title=expected_title,
+                expected_caption=expected_caption,
+            )
+        if result.platform_permalink and record:
             record.platform_permalink = result.platform_permalink
             write_publish_records(args.records, records)
         row = asdict(result)
@@ -1032,7 +1043,7 @@ def main() -> None:
                 + (f" method={result.clipboard_method}" if result.clipboard_method else "")
                 + (f" error={result.error}" if result.error else "")
             )
-        if result.status in {"failed", "needs_human"}:
+        if result.status == "failed":
             raise SystemExit(1)
         return
 
@@ -1497,6 +1508,14 @@ def _filter_records(
     return out
 
 
+def _xiaohongshu_expected_from_record(record: PublishRecord) -> tuple[str, str]:
+    caption = (record.caption or "").strip()
+    if " | " in caption:
+        title, body = caption.split(" | ", 1)
+        return title.strip(), body.strip()
+    return caption, ""
+
+
 def _run_publish_jobs(devices: list[object], parallel: bool, max_concurrency: int, run_one, print_one) -> bool:
     if max_concurrency < 1:
         raise SystemExit("--max-concurrency must be >= 1")
@@ -1518,7 +1537,7 @@ def _run_publish_jobs(devices: list[object], parallel: bool, max_concurrency: in
                 any_failed = True
                 continue
             print_one(result)
-            any_failed = any_failed or getattr(result, "status", "") in {"failed", "needs_human"}
+            any_failed = any_failed or getattr(result, "status", "") == "failed"
         return any_failed
 
     workers = min(max_concurrency, MAX_PARALLEL_DEVICES, len(devices))
@@ -1533,7 +1552,7 @@ def _run_publish_jobs(devices: list[object], parallel: bool, max_concurrency: in
                 any_failed = True
                 continue
             print_one(result)
-            any_failed = any_failed or getattr(result, "status", "") in {"failed", "needs_human"}
+            any_failed = any_failed or getattr(result, "status", "") == "failed"
     return any_failed
 
 

package/mobile-runtime/python/src/device_control/metrics/tiktok_account_adb.py

@@ -108,7 +108,7 @@ class TikTokAccountMetricsAdbCollector:
                 )
 
             ended_epoch = int(time.time())
-            status = "collected" if all(period.has_all_metrics() for period in periods_out.values()) else "needs_human"
+            status = "collected" if all(period.has_all_metrics() for period in periods_out.values()) else "failed"
             raw["extraction_status"] = (
                 "manual_values_recorded" if status == "collected" else "manual_values_required"
             )

package/mobile-runtime/python/src/device_control/metrics/tiktok_video_adb.py

@@ -168,7 +168,7 @@ class TikTokVideoMetricsAdbCollector:
                 device_id=device.device_id,
                 fetched_at=utc_now_iso(),
                 source="tiktok_video_insights_adb",
-                status="needs_human",
+                status="failed",
                 video_order=video_order,
                 screenshot_path=str(screenshot_path),
                 ui_dump_path=str(ui_dump_path),
@@ -216,7 +216,7 @@ class TikTokVideoMetricsAdbCollector:
             raw=combined_raw,
         )
         if not snapshot.has_key_metrics():
-            snapshot.status = "needs_human"
+            snapshot.status = "failed"
         return snapshot
 
     def _prepare_device(self, device: Device) -> None:

package/mobile-runtime/python/src/device_control/models.py

@@ -263,7 +263,7 @@ class TikTokAccountMetricsSnapshot:
     device_id: str
     fetched_at: str
     source: str
-    status: str = "needs_human"
+    status: str = "failed"
     periods: dict[str, TikTokAccountMetricsPeriod] = field(default_factory=dict)
     artifact_dir: str = ""
     started_at: str = ""
@@ -284,7 +284,7 @@ class TikTokAccountMetricsSnapshot:
             device_id=str(data["device_id"]),
             fetched_at=str(data["fetched_at"]),
             source=str(data.get("source", "unknown")),
-            status=str(data.get("status", "needs_human")),
+            status=str(data.get("status", "failed")),
             periods=periods,
             artifact_dir=str(data.get("artifact_dir", "")),
             started_at=str(data.get("started_at", "")),
@@ -319,7 +319,7 @@ class TikTokVideoMetricsSnapshot:
     device_id: str
     fetched_at: str
     source: str
-    status: str = "needs_human"
+    status: str = "failed"
     published_at: str = ""
     published_at_raw: str = ""
     video_order: int | None = None
@@ -354,7 +354,7 @@ class TikTokVideoMetricsSnapshot:
             device_id=str(data["device_id"]),
             fetched_at=str(data["fetched_at"]),
             source=str(data.get("source", "unknown")),
-            status=str(data.get("status", "needs_human")),
+            status=str(data.get("status", "failed")),
             published_at=str(data.get("published_at", "")),
             published_at_raw=str(data.get("published_at_raw", "")),
             video_order=_optional_int(data.get("video_order")),

package/mobile-runtime/python/src/device_control/publishers/facebook_adb.py

@@ -18,7 +18,7 @@ from device_control.store import append_publish_record
 FACEBOOK_LITE_PACKAGE = "com.facebook.lite"
 
 
-class NeedsHumanError(RuntimeError):
+class AutomationBlockedError(RuntimeError):
     pass
 
 
@@ -167,7 +167,7 @@ class FacebookAdbPublisher:
                 link_url=link_url,
                 screenshot_path=str(final_shot),
             )
-        except NeedsHumanError as exc:
+        except AutomationBlockedError as exc:
             return self._failure_result(
                 device,
                 run_dir,
@@ -178,7 +178,7 @@ class FacebookAdbPublisher:
                 post_type=post_type,
                 remote_media_path=remote,
                 link_url=link_url,
-                status="needs_human",
+                status="failed",
                 error=str(exc),
             )
         except Exception as exc:
@@ -242,7 +242,7 @@ class FacebookAdbPublisher:
         time.sleep(7)
         self.adb.screenshot(device.adb_serial, run_dir / "home.png")
         if app_package not in self.adb.current_focus(device.adb_serial):
-            raise NeedsHumanError(f"Facebook is not foreground after launch; check install/login state for {app_package}")
+            raise AutomationBlockedError(f"Facebook is not foreground after launch; check install/login state for {app_package}")
 
     def _open_composer(self, device: Device, run_dir: Path) -> None:
         self._tap(device, 95, 180, 6)
@@ -257,7 +257,7 @@ class FacebookAdbPublisher:
         composer_shot = run_dir / "composer.png"
         self.adb.screenshot(device.adb_serial, composer_shot)
         if not self._is_compose_form(device, run_dir / "composer.xml") and not _locate_blue_post_button(composer_shot):
-            raise NeedsHumanError("Facebook composer not detected; check login, verification, prompts, or layout calibration")
+            raise AutomationBlockedError("Facebook composer not detected; check login, verification, prompts, or layout calibration")
 
     def _input_text(self, device: Device, text: str, run_dir: Path) -> None:
         self._tap(device, 170, 520, 1)
@@ -284,7 +284,7 @@ class FacebookAdbPublisher:
                 self.adb.screenshot(device.adb_serial, run_dir / "after-media-select.png")
                 return
         self.adb.screenshot(device.adb_serial, run_dir / "media-picker-not-found.png")
-        raise NeedsHumanError(f"Facebook {post_type} media picker did not expose a selectable gallery item")
+        raise AutomationBlockedError(f"Facebook {post_type} media picker did not expose a selectable gallery item")
 
     def _tap_post(self, device: Device, run_dir: Path) -> None:
         post_shot = run_dir / "before-post-locator.png"

package/mobile-runtime/python/src/device_control/publishers/instagram_adb.py

@@ -23,7 +23,7 @@ INSTAGRAM_SHARE_BUTTON_IDS = {
 }
 
 
-class NeedsHumanError(RuntimeError):
+class AutomationBlockedError(RuntimeError):
     pass
 
 
@@ -159,7 +159,7 @@ class InstagramAdbPublisher:
                 remote_media_path=remote,
                 screenshot_path=str(final_shot),
             )
-        except NeedsHumanError as exc:
+        except AutomationBlockedError as exc:
             return self._failure_result(
                 device,
                 run_dir,
@@ -168,7 +168,7 @@ class InstagramAdbPublisher:
                 started_epoch,
                 remote,
                 post_type=post_type,
-                status="needs_human",
+                status="failed",
                 error=str(exc),
             )
         except Exception as exc:
@@ -227,7 +227,7 @@ class InstagramAdbPublisher:
         self.adb.screenshot(device.adb_serial, run_dir / "home.png")
         focus = self.adb.current_focus(device.adb_serial)
         if INSTAGRAM_PACKAGE not in focus:
-            raise NeedsHumanError("Instagram is not foreground after launch; check install/login/verification state")
+            raise AutomationBlockedError("Instagram is not foreground after launch; check install/login/verification state")
         self._raise_if_blocked(device, run_dir / "home.xml")
 
     def _open_new_post(self, device: Device, run_dir: Path) -> None:
@@ -243,7 +243,7 @@ class InstagramAdbPublisher:
         self.adb.screenshot(device.adb_serial, run_dir / "gallery.png")
         self._raise_if_blocked(device, run_dir / "gallery.xml")
         if not self._has_any_text(device, run_dir / "gallery-check.xml", {"新帖子", "New post"}):
-            raise NeedsHumanError("Instagram gallery did not open; check login, verification, prompts, or layout calibration")
+            raise AutomationBlockedError("Instagram gallery did not open; check login, verification, prompts, or layout calibration")
 
     def _select_destination(self, device: Device, run_dir: Path, post_type: str) -> None:
         target_id = "com.instagram.android:id/cam_dest_clips" if post_type == "reel" else "com.instagram.android:id/cam_dest_feed"
@@ -260,7 +260,7 @@ class InstagramAdbPublisher:
         media_node = _find_first_visible_media_thumbnail(root, media_kind)
         if media_node is None:
             self.adb.screenshot(device.adb_serial, run_dir / f"no-visible-{media_kind}.png")
-            raise NeedsHumanError(f"No visible {media_kind} thumbnail found in Instagram gallery")
+            raise AutomationBlockedError(f"No visible {media_kind} thumbnail found in Instagram gallery")
         x, y = _center(_bounds(media_node))
         self._tap(device, x, y, 1)
         self.adb.screenshot(device.adb_serial, run_dir / "gallery-selected.png")
@@ -310,7 +310,7 @@ class InstagramAdbPublisher:
                 continue
             time.sleep(2)
         self.adb.screenshot(device.adb_serial, run_dir / "post-share-form-timeout.png")
-        raise NeedsHumanError("Instagram Post share form was not detected after selecting media")
+        raise AutomationBlockedError("Instagram Post share form was not detected after selecting media")
 
     def _tap_post_public_sheet_if_present(self, device: Device, root: ET.Element, run_dir: Path, attempt: int) -> bool:
         text = _all_text(root)
@@ -339,7 +339,7 @@ class InstagramAdbPublisher:
                 if self._has_any_id(device, run_dir / "share-form-check.xml", {"com.instagram.android:id/caption_input_text_view"}):
                     return
             time.sleep(2)
-        raise NeedsHumanError("Instagram editor next button/share form was not detected")
+        raise AutomationBlockedError("Instagram editor next button/share form was not detected")
 
     def _set_caption(self, device: Device, caption: str, run_dir: Path, caption_input: str) -> None:
         last_error = ""
@@ -415,7 +415,7 @@ class InstagramAdbPublisher:
         if self._is_reels_public_sheet(device, run_dir / "reels-public-sheet.xml"):
             self.adb.screenshot(device.adb_serial, run_dir / "reels-public-sheet.png")
             if not confirm_reels_public:
-                raise NeedsHumanError("Instagram Reels public sharing prompt needs explicit confirmation")
+                raise AutomationBlockedError("Instagram Reels public sharing prompt needs explicit confirmation")
             if not self._tap_node(
                 device,
                 run_dir / "reels-public-sheet.xml",
@@ -493,7 +493,7 @@ class InstagramAdbPublisher:
                 "restricted",
             },
         ):
-            raise NeedsHumanError("Instagram needs login, verification, captcha, or account review")
+            raise AutomationBlockedError("Instagram needs login, verification, captcha, or account review")
 
     def _is_reels_public_sheet(self, device: Device, xml_path: Path) -> bool:
         root = self._dump(device, xml_path)

package/mobile-runtime/python/src/device_control/publishers/tiktok_adb.py

@@ -52,7 +52,7 @@ TIKTOK_PREVIEW_TEXTS = (
 )
 
 
-class TikTokNeedsHumanError(RuntimeError):
+class TikTokAutomationBlockedError(RuntimeError):
     """Raised when TikTok blocks the publish flow with an account/platform state."""
 
 
@@ -152,13 +152,13 @@ class TikTokAdbPublisher:
                 remote_media_path=remote,
                 screenshot_path=str(final_shot),
             )
-        except TikTokNeedsHumanError as exc:
+        except TikTokAutomationBlockedError as exc:
             ended_epoch = int(time.time())
-            failure_shot = run_dir / "needs-human.png"
+            failure_shot = run_dir / "failed.png"
             self.adb.screenshot(device.adb_serial, failure_shot)
             return TikTokAdbPublishResult(
                 device_id=device.device_id,
-                status="needs_human",
+                status="failed",
                 record_id=record_id,
                 started_at=started_at,
                 ended_at=_now_shanghai(),
@@ -430,7 +430,7 @@ class TikTokAdbPublisher:
         text = ui.all_text(root)
         blocking = _first_contained(text, TIKTOK_BLOCKING_TEXTS)
         if blocking:
-            raise TikTokNeedsHumanError(f"TikTok publish blocked by visible prompt: {blocking}")
+            raise TikTokAutomationBlockedError(f"TikTok publish blocked by visible prompt: {blocking}")
         if ("访问你的麦克风" in text or "访问麦克风" in text) and "直播" in text:
             raise RuntimeError("TikTok opened the LIVE microphone permission surface, not the video publish flow")
         return root

package/mobile-runtime/python/src/device_control/publishers/x_adb.py

@@ -42,7 +42,7 @@ POST_PUBLISH_NOTICE_MARKERS = {
 }
 
 
-class NeedsHumanError(RuntimeError):
+class AutomationBlockedError(RuntimeError):
     pass
 
 
@@ -168,7 +168,7 @@ class XAdbPublisher:
                 link_url=link_url,
                 screenshot_path=str(final_shot),
             )
-        except NeedsHumanError as exc:
+        except AutomationBlockedError as exc:
             return self._failure_result(
                 device,
                 run_dir,
@@ -179,7 +179,7 @@ class XAdbPublisher:
                 post_type=post_type,
                 remote_media_path=remote,
                 link_url=link_url,
-                status="needs_human",
+                status="failed",
                 error=str(exc),
             )
         except Exception as exc:
@@ -244,7 +244,7 @@ class XAdbPublisher:
         self.adb.screenshot(device.adb_serial, run_dir / "home.png")
         focus = self.adb.current_focus(device.adb_serial)
         if X_PACKAGE not in focus:
-            raise NeedsHumanError("X is not foreground after launch; check install/login/verification state")
+            raise AutomationBlockedError("X is not foreground after launch; check install/login/verification state")
         self._raise_if_blocked(device, run_dir / "home.xml")
 
     def _open_compose(self, device: Device, run_dir: Path) -> None:
@@ -300,7 +300,7 @@ class XAdbPublisher:
             self._reveal_compose_button(device)
 
         self.adb.screenshot(device.adb_serial, run_dir / "compose-entry-missing.png")
-        raise NeedsHumanError("X compose button was not found after scrolling the timeline")
+        raise AutomationBlockedError("X compose button was not found after scrolling the timeline")
 
     def _reveal_compose_button(self, device: Device) -> None:
         # X hides the bottom-right plus after the timeline sits idle or during scroll.
@@ -329,7 +329,7 @@ class XAdbPublisher:
         root = ui.dump_ui(self.adb, device, run_dir / "before-text.xml")
         field = ui.find_node(root, ids={f"{X_PACKAGE}:id/tweet_text"}, id_suffixes={"tweet_text"}, clickable_only=False)
         if field is None:
-            raise NeedsHumanError("X compose text field was not found")
+            raise AutomationBlockedError("X compose text field was not found")
         ui.tap_node(self.adb, device, field, sleep_s=0.5)
         result = self.adb.input_text(device.adb_serial, text)
         if not result.ok:
@@ -363,7 +363,7 @@ class XAdbPublisher:
         root = ui.dump_ui(self.adb, device, run_dir / "before-gallery.xml")
         gallery = ui.find_node(root, ids={f"{X_PACKAGE}:id/gallery"}, id_suffixes={"gallery"}, descs={"相片", "Photo", "Photos"})
         if gallery is None:
-            raise NeedsHumanError("X gallery button was not found on compose form")
+            raise AutomationBlockedError("X gallery button was not found on compose form")
         ui.tap_node(self.adb, device, gallery, sleep_s=3)
         self._tap_permission_if_present(device, run_dir / "gallery-permission.xml")
 
@@ -371,7 +371,7 @@ class XAdbPublisher:
         image_node = _find_first_gallery_image(grid_root)
         if image_node is None:
             self.adb.screenshot(device.adb_serial, run_dir / "gallery-image-missing.png")
-            raise NeedsHumanError("X gallery did not expose a selectable image")
+            raise AutomationBlockedError("X gallery did not expose a selectable image")
         ui.tap_node(self.adb, device, image_node, sleep_s=1.5)
         self.adb.screenshot(device.adb_serial, run_dir / "gallery-selected.png")
 
@@ -387,7 +387,7 @@ class XAdbPublisher:
         )
         if done is None:
             self.adb.screenshot(device.adb_serial, run_dir / "gallery-done-missing.png")
-            raise NeedsHumanError("X gallery Done/Add button was not found")
+            raise AutomationBlockedError("X gallery Done/Add button was not found")
         ui.tap_node(self.adb, device, done, sleep_s=3)
         self.adb.screenshot(device.adb_serial, run_dir / "after-image.png")
 
@@ -398,9 +398,9 @@ class XAdbPublisher:
         root = ui.dump_ui(self.adb, device, run_dir / "before-post.xml")
         node = ui.find_node(root, ids={f"{X_PACKAGE}:id/button_tweet"}, id_suffixes={"button_tweet"}, texts={"发帖", "Post", "Tweet"})
         if node is None:
-            raise NeedsHumanError("X post button was not found on compose form")
+            raise AutomationBlockedError("X post button was not found on compose form")
         if node.attrib.get("enabled") != "true":
-            raise NeedsHumanError("X post button is disabled; check text/media/content declaration")
+            raise AutomationBlockedError("X post button is disabled; check text/media/content declaration")
         ui.tap_node(self.adb, device, node, sleep_s=2)
 
     def _wait_for_publish_complete(self, device: Device, run_dir: Path, publish_text: str, *, verify_profile: bool) -> Path:
@@ -415,7 +415,7 @@ class XAdbPublisher:
                 text = ui.all_text(root)
                 if ui.contains_any(text, BLOCKING_TEXT_MARKERS):
                     self.adb.screenshot(device.adb_serial, run_dir / "post-blocked.png")
-                    raise NeedsHumanError("X showed a verification/account restriction prompt after tapping post")
+                    raise AutomationBlockedError("X showed a verification/account restriction prompt after tapping post")
                 self.adb.screenshot(device.adb_serial, after_post_shot)
                 if not verify_profile:
                     return after_post_shot
@@ -424,7 +424,7 @@ class XAdbPublisher:
             root = ui.dump_ui(self.adb, device, run_dir / f"post-poll-{poll}.xml")
             text = ui.all_text(root)
             if ui.contains_any(text, BLOCKING_TEXT_MARKERS):
-                raise NeedsHumanError("X showed a verification/account restriction prompt after tapping post")
+                raise AutomationBlockedError("X showed a verification/account restriction prompt after tapping post")
             time.sleep(2)
         self.adb.screenshot(device.adb_serial, run_dir / "post-timeout.png")
         raise RuntimeError("X still appears to be on the compose screen after tapping post")
@@ -459,7 +459,7 @@ class XAdbPublisher:
             time.sleep(2)
 
         self.adb.screenshot(device.adb_serial, run_dir / "profile-post-missing.png")
-        raise NeedsHumanError("X publish completed, but the expected post text was not found on the profile page")
+        raise AutomationBlockedError("X publish completed, but the expected post text was not found on the profile page")
 
     def _open_profile(self, device: Device, run_dir: Path) -> None:
         if self._is_profile_open(device):
@@ -509,7 +509,7 @@ class XAdbPublisher:
                 return
 
         self.adb.screenshot(device.adb_serial, run_dir / "profile-open-failed.png")
-        raise NeedsHumanError("X profile page could not be opened from the navigation drawer")
+        raise AutomationBlockedError("X profile page could not be opened from the navigation drawer")
 
     def _is_profile_open(self, device: Device) -> bool:
         return X_PROFILE_ACTIVITY in self.adb.current_focus(device.adb_serial)
@@ -521,7 +521,7 @@ class XAdbPublisher:
             return
         text = ui.all_text(root)
         if ui.contains_any(text, BLOCKING_TEXT_MARKERS):
-            raise NeedsHumanError("X login, verification, or account restriction prompt is visible")
+            raise AutomationBlockedError("X login, verification, or account restriction prompt is visible")
 
     @staticmethod
     def _ok(result, action: str) -> None: