@11agents/cli 0.1.28 → 0.1.30

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

@@ -983,7 +983,7 @@ def main() -> None:
                 topics=args.topics,
                 dry_run=args.dry_run,
                 confirm_no_disclosure_needed=args.confirm_no_disclosure_needed,
-                copy_link_after_publish=args.copy_link_after_publish,
+                copy_link_after_publish=args.copy_link_after_publish and not args.dry_run,
                 resume_post_form=args.resume_post_form,
             )
 
@@ -1174,8 +1174,16 @@ def _add_publish_xiaohongshu_args(parser: argparse.ArgumentParser) -> None:
     )
     parser.add_argument(
         "--copy-link-after-publish",
+        dest="copy_link_after_publish",
         action="store_true",
-        help="After a successful publish, open the share sheet, tap copy link, and try to read the copied URL.",
+        default=True,
+        help="After a successful publish, open the share sheet, tap copy link, and try to read the copied URL. Enabled by default for live publish.",
+    )
+    parser.add_argument(
+        "--no-copy-link-after-publish",
+        dest="copy_link_after_publish",
+        action="store_false",
+        help="Disable automatic Xiaohongshu link recovery after publish.",
     )
     parser.add_argument("--parallel", action="store_true", help="Run target devices concurrently. Hard-capped at 5.")
     parser.add_argument("--max-concurrency", type=int, default=MAX_PARALLEL_DEVICES, help="Max concurrent devices, 1-5.")

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

@@ -319,7 +319,13 @@ class XiaohongshuAdbPublisher:
                 )
                 status = "published"
                 if copy_link_after_publish:
-                    link_result = self.copy_current_note_link(device, prepare=False, run_dir=run_dir / "link")
+                    link_result = self.copy_current_note_link(
+                        device,
+                        prepare=False,
+                        run_dir=run_dir / "link",
+                        expected_title=title,
+                        expected_caption=composed_caption,
+                    )
 
             ended_epoch = int(time.time())
             if status == "published":
@@ -757,6 +763,7 @@ class XiaohongshuAdbPublisher:
         expected_caption: str,
     ) -> Path:
         self._wait_for_publish_exit_after_confirm(device, run_dir)
+        self._restart_xiaohongshu_for_link_recovery(device, run_dir)
         return self._open_latest_own_note_for_link(
             device,
             run_dir,
@@ -797,7 +804,13 @@ class XiaohongshuAdbPublisher:
 
         self._open_me_tab(device, run_dir)
         self._dismiss_link_recovery_prompts(device, run_dir)
-        self._tap_latest_profile_note(device, run_dir, expected_title=expected_title)
+        self._tap_latest_profile_note(
+            device,
+            run_dir,
+            expected_title=expected_title,
+            require_expected_match=bool(expected_title or expected_caption),
+            allow_first_card_fallback=bool(expected_title or expected_caption),
+        )
         self._wait_for_detail_screen(device, run_dir)
         return self._verify_current_note_detail(
             device,
@@ -807,6 +820,13 @@ class XiaohongshuAdbPublisher:
             prefix="published-note-detail",
         )
 
+    def _restart_xiaohongshu_for_link_recovery(self, device: Device, run_dir: Path) -> None:
+        self._close_xiaohongshu(device)
+        time.sleep(self._wait("after_prompt_dismiss"))
+        self.adb.screenshot(device.adb_serial, run_dir / "after-publish-app-closed.png")
+        self._launch_xiaohongshu(device)
+        self.adb.screenshot(device.adb_serial, run_dir / "after-publish-relaunch.png")
+
     def _dismiss_link_recovery_prompts(self, device: Device, run_dir: Path) -> None:
         for idx in range(2):
             try:
@@ -844,7 +864,22 @@ class XiaohongshuAdbPublisher:
             self._tap_coord_or_default(device, "bottom_me", self._relative_coord(0.9, 0.93), self._wait("after_me_tab"))
         self.adb.screenshot(device.adb_serial, run_dir / "profile.png")
 
-    def _tap_latest_profile_note(self, device: Device, run_dir: Path, *, expected_title: str = "") -> None:
+    def _tap_latest_profile_note(
+        self,
+        device: Device,
+        run_dir: Path,
+        *,
+        expected_title: str = "",
+        require_expected_match: bool = False,
+        allow_first_card_fallback: bool = False,
+    ) -> None:
+        if require_expected_match and not expected_title:
+            not_identifiable_shot = run_dir / "expected-profile-note-not-identifiable.png"
+            self.adb.screenshot(device.adb_serial, not_identifiable_shot)
+            raise XiaohongshuAutomationError(
+                "expected Xiaohongshu profile note cannot be selected safely without a title",
+                not_identifiable_shot,
+            )
         attempts = 8 if expected_title else 3
         for attempt in range(attempts):
             root = ui.dump_ui(self.adb, device, run_dir / f"profile-before-latest-note-{attempt + 1}.xml")
@@ -857,7 +892,14 @@ class XiaohongshuAdbPublisher:
                 self._scroll_profile_notes_down_half_screen(device)
                 self.adb.screenshot(device.adb_serial, run_dir / f"profile-after-scroll-{attempt + 1}.png")
             time.sleep(2 if expected_title else 1)
-        if expected_title:
+        if allow_first_card_fallback:
+            root = ui.dump_ui(self.adb, device, run_dir / "profile-before-first-card-fallback.xml")
+            node = self._find_latest_profile_note_node(root, expected_title="")
+            if node is not None:
+                ui.tap_node(self.adb, device, node, sleep_s=self._wait("after_latest_note_tap"))
+                self.adb.screenshot(device.adb_serial, run_dir / "first-card-fallback-opened.png")
+                return
+        if expected_title or require_expected_match:
             not_found_shot = run_dir / "expected-profile-note-not-found.png"
             self.adb.screenshot(device.adb_serial, not_found_shot)
             raise XiaohongshuAutomationError(
@@ -966,7 +1008,8 @@ class XiaohongshuAdbPublisher:
                 continue
             note_text = f"{text}\n{desc}"
             if expected:
-                if not _looks_like_profile_note_card(node) or expected not in _normalize_match_text(note_text):
+                note_match = _normalize_match_text(note_text)
+                if not _looks_like_profile_note_card(node) or not _profile_card_matches_expected_title(note_match, expected):
                     continue
                 return node
             item = (top, left, node)
@@ -1462,7 +1505,7 @@ def _note_text_matches_expected(visible_text: str, expected_title: str, expected
     title = _normalize_match_text(expected_title)
     caption_fragment = _verification_fragment(expected_caption)
 
-    if title and title not in haystack:
+    if title and title not in haystack and not _visible_text_matches_truncated_title(haystack, title):
         return False, f"title not visible: {expected_title!r}"
     if caption_fragment and caption_fragment not in haystack:
         return False, f"caption fragment not visible: {caption_fragment!r}"
@@ -1471,6 +1514,13 @@ def _note_text_matches_expected(visible_text: str, expected_title: str, expected
     return True, ""
 
 
+def _visible_text_matches_truncated_title(visible_text: str, expected_title: str) -> bool:
+    if not visible_text or not expected_title:
+        return False
+    min_prefix = min(18, len(expected_title))
+    return len(expected_title) >= min_prefix and expected_title[:min_prefix] in visible_text
+
+
 def _looks_like_profile_note_card(node) -> bool:
     text = node.attrib.get("text", "")
     desc = node.attrib.get("content-desc", "")
@@ -1570,6 +1620,19 @@ def _verification_fragment(text: str) -> str:
     return normalized[:18]
 
 
+def _profile_card_matches_expected_title(card_text: str, expected_title: str) -> bool:
+    if not card_text or not expected_title:
+        return False
+    if expected_title in card_text:
+        return True
+    min_prefix = min(18, len(expected_title))
+    if len(card_text) >= min_prefix and card_text in expected_title:
+        return True
+    if len(card_text) >= min_prefix and expected_title.startswith(card_text):
+        return True
+    return expected_title[:min_prefix] in card_text
+
+
 def _strip_hashtags(text: str) -> str:
     return re.sub(r"#[^\s#]+", "", text or "").strip()
 

package/mobile-runtime/skills/android-group-control-cli/references/command-reference.md

@@ -84,7 +84,7 @@ X uses one `body` field, not a title/body split.
 11agents mobile copy-xiaohongshu-link --device D03 --record-id pub_123 --json --task-id TASK_123
 ```
 
-Use `--confirm-no-disclosure-needed` only when the approved package and policy explicitly allow it.
+Live Xiaohongshu publish recovers the note link by default after publish. Use `--no-copy-link-after-publish` only when automatic link recovery is explicitly not wanted. Use `--confirm-no-disclosure-needed` only when the approved package and policy explicitly allow it.
 
 ## Records And Data Recovery
 

package/mobile-runtime/skills/android-publish-xiaohongshu/SKILL.md

@@ -23,8 +23,8 @@ If approval, account lifecycle, media/package path, text fields, or device readi
 Image/video note:
 
 ```bash
-11agents mobile publish-xiaohongshu --device D03 --post-type image --image "/path/image.jpg" --title "title" --caption "body" --copy-link-after-publish --json --task-id TASK_123
-11agents mobile publish-xiaohongshu --device D03 --post-type video --video "/path/video.mp4" --title "title" --caption "body" --copy-link-after-publish --json --task-id TASK_123
+11agents mobile publish-xiaohongshu --device D03 --post-type image --image "/path/image.jpg" --title "title" --caption "body" --json --task-id TASK_123
+11agents mobile publish-xiaohongshu --device D03 --post-type video --video "/path/video.mp4" --title "title" --caption "body" --json --task-id TASK_123
 ```
 
 Structured package:
@@ -33,7 +33,7 @@ Structured package:
 11agents mobile publish-xiaohongshu --device D03 --publish-package "/path/publish_package.json" --json --task-id TASK_123
 ```
 
-Successful live publish is only confirmed after the CLI taps the final publish button, waits without tapping while Xiaohongshu shows upload/progress state, then opens the "我" page, opens the note whose title matches the expected title, and verifies the detail page against the expected title/body. If that evidence does not match, treat the result as `failed`; do not claim publish success from the publish button tap alone.
+Successful live publish is only confirmed after the CLI taps the final publish button, waits without tapping while Xiaohongshu shows upload/progress state, closes and relaunches Xiaohongshu, then opens the "我" page, opens the note whose title matches the expected title or the first visible profile note as a verified fallback, and verifies the detail page against the expected title/body. The CLI recovers the note link by default for live publish; use `--no-copy-link-after-publish` only when link recovery is explicitly not wanted. If that evidence does not match, treat the result as `failed`; do not claim publish success from the publish button tap alone.
 
 Link copy after publish or during the recovery skill:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@11agents/cli",
-  "version": "0.1.28",
+  "version": "0.1.30",
   "description": "11agents local runtime and telemetry CLI",
   "type": "module",
   "bin": {

package/src/commands/runtime.js

@@ -1083,13 +1083,12 @@ function buildCodexPrompt(task) {
     '- image_size alternatives: "1K", "2K". For a specific output size, pass aspect and image_size; pass size only when the MCP tool/provider explicitly supports the requested exact dimensions.',
     '- Use model="gpt" with model_id only when the task or current project notes confirm that GPT image generation is available for the hosted MCP key.',
     '- MCP authentication (agent_planning, database_sync, knowledge_sync, image_generate, etc.):',
-    '  1. Find your project_slug from the task context (task.workspace.slug).',
-    '  2. Open ~/.11agents/credentials.yaml and read the value under tokens.<project_slug>.',
-    '  3. Use that value as the Bearer token in the Authorization header for the 11agents hosted MCP endpoint.',
-    '  4. If the key is missing from credentials.yaml, add it:',
-    '       tokens:',
-    '         <project_slug>: <your-token>',
-    '     Get the token from the 11agents platform → open your project → Tokens menu.',
+    '  - The GTM_SWARM_TOKEN env var is already set to the correct project token for this workspace.',
+    '  - Configure the 11agents hosted MCP server using that env var:',
+    '      {"mcpServers":{"11agents-project-sync":{"url":"https://app.11agents.ai/mcp","transport":"streamable-http","headers":{"Authorization":"Bearer $GTM_SWARM_TOKEN"}}}}',
+    '  - NEVER hardcode the token value — always reference $GTM_SWARM_TOKEN so the config stays correct across workspaces.',
+    '  - If GTM_SWARM_TOKEN is missing, get the token from ~/.11agents/credentials.yaml under tokens.<project_slug>.',
+    '    If that file is empty, go to the 11agents platform → your project → Tokens menu.',
     '',
     'Final task comment requirements:',
     '> [!IMPORTANT]',