@11agents/cli 0.1.24 → 0.1.26

package/README.md

@@ -10,6 +10,14 @@ npm install -g @11agents/cli@latest
 
 The CLI requires Node.js 22 or newer.
 
+Android publishing machines can opt into mobile runtime setup during install:
+
+```bash
+ELEVENAGENTS_INSTALL_MOBILE=1 npm install -g @11agents/cli@latest
+```
+
+If setup must fail the npm install when Python/Appium prerequisites cannot be prepared, use `ELEVENAGENTS_REQUIRE_MOBILE=1`.
+
 ## Configure
 
 ```bash
@@ -125,6 +133,50 @@ export async function handleRuntimeTask(task) {
 }
 ```
 
+## Mobile Runtime
+
+`@11agents/cli` bundles the Android device-pool runtime that used to live in `android-group-control-mvp`: Python `device_control`, platform configs, mobile publish skills, data templates, and the Appium smoke script. Runtime state is kept outside the npm package:
+
+- Mobile home: `~/.11agents/mobile` or `ELEVENAGENTS_MOBILE_HOME`
+- Python venv: `~/.11agents/mobile/.venv`
+- Device/account data: `~/.11agents/mobile/data`
+- Screenshots/UI dumps: `~/.11agents/mobile/artifacts`
+- Task logs: `~/.11agents/mobile/runs/<task_id>/log`
+
+Prepare a publishing machine:
+
+```bash
+11agents mobile setup
+11agents mobile doctor --json
+```
+
+`setup` creates the Python venv, installs the bundled Python runtime, installs local Appium npm dependencies, installs UiAutomator2 into `APPIUM_HOME`, and seeds example data/config files without overwriting existing runtime data.
+
+Core commands:
+
+```bash
+11agents mobile list-adb
+11agents mobile list-devices --health --json
+11agents mobile ensure-appium --device D03 --json --task-id TASK_123
+11agents mobile publish-tiktok --device D03 --video /path/video.mp4 --caption "..." --json --task-id TASK_123
+11agents mobile publish-instagram --device D03 --post-type reel --video /path/video.mp4 --caption "..." --json --task-id TASK_123
+11agents mobile publish-facebook --device D03 --post-type text --text "..." --json --task-id TASK_123
+11agents mobile publish-reddit --device D02 --post-type text --subreddit test --title "..." --body "..." --json --task-id TASK_123
+11agents mobile publish-x --device D03 --post-type text --body "..." --json --task-id TASK_123
+11agents mobile publish-xiaohongshu --device D03 --publish-package /path/publish_package.json --json --task-id TASK_123
+```
+
+Post-publish data recovery:
+
+```bash
+11agents mobile list-publish-records --json --task-id TASK_123
+11agents mobile data collect --platform reddit --record-id pub_123 --json --task-id TASK_123
+11agents mobile data collect --platform tiktok --scope video --device D03 --record-id pub_123 --json --task-id TASK_123
+11agents mobile data collect --platform xiaohongshu --record-id pub_123 --copy-link --json --task-id TASK_123
+```
+
+Unsupported collectors return `missing_access`; provide an API token, export, or manual values and append them with `11agents mobile add-metrics`.
+
 ## Hosted MCP
 
 Runtime agents and MCP clients should use the hosted project MCP endpoint:

package/bin/11agents.js

@@ -4,6 +4,7 @@ import { fileURLToPath } from 'node:url'
 import { parseArgs } from '../src/args.js'
 import { knowledgeStatus, syncKnowledge } from '../src/commands/knowledge.js'
 import { showDaemonLog, showTaskLog } from '../src/commands/logs.js'
+import { runMobile } from '../src/commands/mobile.js'
 import { runNode } from '../src/commands/node.js'
 import { pushArtifact, pushBatch, pushObservation } from '../src/commands/push.js'
 import { registerRuntime, scanRuntime, startRuntimeDaemon } from '../src/commands/runtime.js'
@@ -33,6 +34,11 @@ Usage:
   11agents push observation --workspace <slug> --agent <key> --platform x --type post --external-id <id> --metric views=123
   11agents knowledge sync --project <slug> [--mode pull|push]
   11agents knowledge status --project <slug>
+  11agents mobile setup
+  11agents mobile doctor [--json]
+  11agents mobile <device|publish|records|metrics command> [args...]
+  11agents mobile data collect --platform <x|reddit|instagram|facebook|tiktok|xiaohongshu>
+  11agents mobile ... --task-id <task-id>  # logs under ~/.11agents/mobile/runs/<task-id>/log
   11agents node run --workspace <slug> --agent <key> --node <node-id> --handler ./collect-x.js [--once]
 
 Environment:
@@ -42,6 +48,7 @@ Environment:
   ELEVENAGENTS_MACHINE stable machine key, defaults to hostname
   GTM_SWARM_TOKEN      project swarm token for push/node commands
   ~/.11agents/credentials project token map for hosted MCP and sync commands
+  ELEVENAGENTS_MOBILE_HOME optional mobile runtime state dir, defaults ~/.11agents/mobile
 
 Runtime task workspace:
   Daemon project headquarters live under ~/.11agents/<project>/.
@@ -135,6 +142,11 @@ async function main() {
     return
   }
 
+  if (command === 'mobile') {
+    await runMobile(argv.slice(1))
+    return
+  }
+
   if (command === 'validate') {
     const file = subcommand
     if (!file) throw new Error('validate requires a file')

package/mobile-runtime/README.md

@@ -0,0 +1,19 @@
+# 11agents Mobile Runtime
+
+This directory is bundled into `@11agents/cli` and contains the Android device-pool runtime:
+
+- Python package: `python/src/device_control`
+- Platform configs: `configs`
+- Mobile skills: `skills`
+- Data templates: `data-templates`
+- Diagnostic scripts: `scripts`
+
+Mutable state must not be written here. `11agents mobile setup` seeds state under `${ELEVENAGENTS_MOBILE_HOME:-~/.11agents/mobile}`.
+
+Agent task logs are written to:
+
+```text
+~/.11agents/mobile/runs/<task_id>/log
+```
+
+Use `11agents mobile skills list` and `11agents mobile skills show <skill-name>` to inspect bundled mobile skill guidance.

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

@@ -0,0 +1,73 @@
+{
+  "package": "com.xingin.xhs",
+  "screen": {
+    "width": 1080,
+    "height": 2400
+  },
+  "coords": {
+    "unlock_swipe": [540, 1850, 540, 550, 350],
+    "home_plus": [540, 2230],
+    "album_drawer_first": [540, 1695],
+    "latest_video_select": [1025, 425],
+    "latest_image_select": [305, 425],
+    "multi_image_select": [
+      [305, 425],
+      [665, 425],
+      [1025, 425],
+      [305, 787],
+      [665, 787],
+      [1025, 787],
+      [305, 1150]
+    ],
+    "gallery_next": [800, 2240],
+    "editor_next": [885, 2220],
+    "first_publish": [945, 180],
+    "confirm_publish": [725, 2200],
+    "bottom_me": [972, 2230],
+    "profile_latest_note": [270, 1220],
+    "post_publish_prompt_close": [1020, 1200],
+    "note_share": [988, 186],
+    "copy_link": [137, 2142],
+    "comment_input": [421, 374]
+  },
+  "selectors": {
+    "title": "com.xingin.xhs:id/editTitle",
+    "caption": "com.xingin.xhs:id/postNoteEditContentView"
+  },
+  "waits": {
+    "after_wake": 1,
+    "after_unlock": 1,
+    "after_launch": 5,
+    "after_plus": 1,
+    "after_album_entry": 3,
+    "after_latest_video_select": 1,
+    "after_gallery_next": 4,
+    "after_editor_next": 4,
+    "after_title_click": 1,
+    "after_caption_click": 1,
+    "after_caption_input": 1,
+    "after_first_publish": 2,
+    "after_confirm_publish": 2,
+    "after_prompt_dismiss": 1,
+    "after_me_tab": 3,
+    "after_latest_note_tap": 3,
+    "after_share_tap": 1,
+    "after_copy_link": 1,
+    "after_comment_input_tap": 1,
+    "after_paste_probe": 1,
+    "detail_load_timeout": 12,
+    "publish_poll_interval": 2,
+    "publish_timeout": 45
+  },
+  "success_focus_keywords": [
+    "IndexActivityV2"
+  ],
+  "detail_focus_keywords": [
+    "NoteDetailActivity"
+  ],
+  "in_progress_focus_keywords": [
+    "CapaPostNotePlatformActivity",
+    "VideoEditActivity",
+    "CapaAlbumActivity"
+  ]
+}

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

@@ -0,0 +1,70 @@
+{
+  "package": "com.xingin.xhs",
+  "screen": {
+    "width": 1080,
+    "height": 2280
+  },
+  "coords": {
+    "unlock_swipe": [540, 1758, 540, 523, 350],
+    "home_plus": [540, 2119],
+    "album_drawer_first": [540, 1610],
+    "latest_video_select": [1025, 404],
+    "latest_image_select": [305, 404],
+    "multi_image_select": [
+      [305, 404],
+      [665, 404],
+      [1025, 404],
+      [305, 748],
+      [665, 748],
+      [1025, 748],
+      [305, 1092]
+    ],
+    "gallery_next": [800, 2128],
+    "editor_next": [885, 2109],
+    "first_publish": [945, 180],
+    "confirm_publish": [725, 2090],
+    "bottom_me": [972, 2119],
+    "profile_latest_note": [270, 1135],
+    "post_publish_prompt_close": [1020, 1140],
+    "note_share": [988, 186],
+    "copy_link": [137, 2035],
+    "comment_input": [421, 355]
+  },
+  "selectors": {
+    "title": "com.xingin.xhs:id/editTitle",
+    "caption": "com.xingin.xhs:id/postNoteEditContentView"
+  },
+  "waits": {
+    "after_wake": 1,
+    "after_unlock": 1,
+    "after_launch": 5,
+    "after_plus": 1,
+    "after_album_entry": 3,
+    "after_latest_video_select": 1,
+    "after_gallery_next": 4,
+    "after_editor_next": 4,
+    "after_title_click": 1,
+    "after_caption_click": 1,
+    "after_caption_input": 1,
+    "after_first_publish": 2,
+    "after_confirm_publish": 2,
+    "after_prompt_dismiss": 1,
+    "after_me_tab": 3,
+    "after_latest_note_tap": 3,
+    "after_share_tap": 1,
+    "after_copy_link": 1,
+    "after_comment_input_tap": 1,
+    "after_paste_probe": 1,
+    "detail_load_timeout": 12,
+    "publish_poll_interval": 2,
+    "publish_timeout": 45
+  },
+  "success_focus_keywords": ["IndexActivityV2"],
+  "detail_focus_keywords": ["NoteDetailActivity"],
+  "in_progress_focus_keywords": [
+    "CapaPostNotePlatformActivity",
+    "VideoEditActivity",
+    "ImageEditActivity",
+    "CapaAlbumActivity"
+  ]
+}

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

@@ -0,0 +1,73 @@
+{
+  "package": "com.xingin.xhs",
+  "screen": {
+    "width": 1080,
+    "height": 2400
+  },
+  "coords": {
+    "unlock_swipe": [540, 1850, 540, 550, 350],
+    "home_plus": [540, 2230],
+    "album_drawer_first": [540, 1695],
+    "latest_video_select": [1025, 425],
+    "latest_image_select": [1025, 425],
+    "multi_image_select": [
+      [1028, 424],
+      [665, 424],
+      [302, 424],
+      [1028, 787],
+      [665, 787],
+      [302, 787],
+      [1028, 1150]
+    ],
+    "gallery_next": [800, 2240],
+    "editor_next": [885, 2220],
+    "first_publish": [945, 180],
+    "confirm_publish": [725, 2200],
+    "bottom_me": [972, 2230],
+    "profile_latest_note": [270, 1220],
+    "post_publish_prompt_close": [1020, 1200],
+    "note_share": [988, 186],
+    "copy_link": [137, 2142],
+    "comment_input": [421, 374]
+  },
+  "selectors": {
+    "title": "com.xingin.xhs:id/editTitle",
+    "caption": "com.xingin.xhs:id/postNoteEditContentView"
+  },
+  "waits": {
+    "after_wake": 1,
+    "after_unlock": 1,
+    "after_launch": 5,
+    "after_plus": 1,
+    "after_album_entry": 3,
+    "after_latest_video_select": 1,
+    "after_gallery_next": 4,
+    "after_editor_next": 4,
+    "after_title_click": 1,
+    "after_caption_click": 1,
+    "after_caption_input": 1,
+    "after_first_publish": 2,
+    "after_confirm_publish": 2,
+    "after_prompt_dismiss": 1,
+    "after_me_tab": 3,
+    "after_latest_note_tap": 3,
+    "after_share_tap": 1,
+    "after_copy_link": 1,
+    "after_comment_input_tap": 1,
+    "after_paste_probe": 1,
+    "detail_load_timeout": 12,
+    "publish_poll_interval": 2,
+    "publish_timeout": 45
+  },
+  "success_focus_keywords": [
+    "IndexActivityV2"
+  ],
+  "detail_focus_keywords": [
+    "NoteDetailActivity"
+  ],
+  "in_progress_focus_keywords": [
+    "CapaPostNotePlatformActivity",
+    "VideoEditActivity",
+    "CapaAlbumActivity"
+  ]
+}

package/mobile-runtime/configs/publish_policy.json

@@ -0,0 +1,40 @@
+{
+  "global": {
+    "explicit_live_publish_auto_confirm": true
+  },
+  "instagram": {
+    "auto_confirm_reels_public": true
+  },
+  "xiaohongshu": {
+    "approval_bridge": {
+      "enabled": true,
+      "explicit_publish_states": [
+        "approved_for_publish",
+        "approved_to_publish",
+        "approved_to_publish_by_request",
+        "publish_requested_by_member_comment",
+        "publish_requested_for_series_by_member_comment",
+        "publish_requested_for_single_post_by_member_comment"
+      ]
+    },
+    "commercial_disclosure": {
+      "auto_confirm_no_disclosure_needed": true,
+      "default_decision": "no_disclosure_needed",
+      "trust_explicit_publish_request": true,
+      "strict_package_disclosure_decision": false,
+      "unresolved_decisions_follow_default": true,
+      "no_disclosure_decisions": [
+        "no_disclosure_needed",
+        "not_required",
+        "not_needed",
+        "none"
+      ],
+      "requires_disclosure_decisions": [
+        "disclosure_required",
+        "commercial_disclosure_required",
+        "content_declaration_required",
+        "required"
+      ]
+    }
+  }
+}

package/mobile-runtime/data-templates/README.md

@@ -0,0 +1,4 @@
+# 11agents Mobile Data Templates
+
+These files seed `~/.11agents/mobile/data` during `11agents mobile setup`.
+Replace example devices and accounts with company-owned, authorized Android devices and logged-in accounts before publishing.

package/mobile-runtime/data-templates/accounts.example.csv

@@ -0,0 +1,6 @@
+account_id,platform,username,bound_device_id,login_status,status,notes
+RD_001,reddit,company_reddit_001,D01,logged_in,active,example account
+TT_001,tiktok,company_tiktok_001,D01,logged_in,active,example account
+IG_001,instagram,company_instagram_001,D02,unknown,paused,example account
+FB_001,facebook,company_facebook_001,D03,unknown,paused,example account
+XHS_001,xiaohongshu,company_xiaohongshu_001,D04,unknown,paused,example account

package/mobile-runtime/data-templates/devices.example.csv

@@ -0,0 +1,2 @@
+device_id,adb_serial,ip_address,brand,model,android_version,status,notes
+D01,REPLACE_WITH_ADB_SERIAL,,ExampleBrand,ExampleModel,13,active,replace with an authorized company-owned Android device

package/mobile-runtime/data-templates/publish_records.example.jsonl

@@ -0,0 +1,2 @@
+{"account_id":"acct_tiktok_001","caption":"demo caption","created_at":"2026-05-27T09:00:00+00:00","device_id":"D01","local_media_path":"/Users/edy/Desktop/demo.mp4","platform":"tiktok","platform_permalink":"https://www.tiktok.com/@example/video/1234567890","platform_post_id":"1234567890","post_type":"video","published_at":"2026-05-27T09:00:00+00:00","record_id":"pub_demo_tiktok_001","remote_media_path":"/sdcard/DCIM/Camera/demo.mp4","result_screenshot_path":"artifacts/screenshots/demo-after-post/D01.png","status":"published","task_id":"task_demo_001"}
+{"account_id":"acct_reddit_001","caption":"","created_at":"2026-05-27T09:05:00+00:00","device_id":"D02","local_media_path":"","platform":"reddit","platform_permalink":"https://www.reddit.com/r/test/comments/abc123/demo/","platform_post_id":"abc123","post_type":"text","published_at":"2026-05-27T09:05:00+00:00","record_id":"pub_demo_reddit_001","remote_media_path":"","result_screenshot_path":"artifacts/screenshots/demo-reddit-after-post/D02.png","status":"published","task_id":"task_demo_002"}

package/mobile-runtime/data-templates/tasks.example.jsonl

@@ -0,0 +1,5 @@
+{"task_id":"TASK_RD_001","action":"publish_content","platform":"reddit","post_type":"text","account_id":"RD_001","device_id":"D01","target":"r/test","title":"Dry-run test post","body":"This is a dry-run test post.","link_url":null,"media_path":null,"caption":null,"hashtags":[],"dry_run":true,"require_human_confirm":true}
+{"task_id":"TASK_TT_001","action":"publish_content","platform":"tiktok","post_type":"video","account_id":"TT_001","device_id":"D01","target":null,"title":null,"body":null,"link_url":null,"media_path":"media/video-001.mp4","caption":"New product demo","hashtags":["demo","product"],"dry_run":true,"require_human_confirm":true}
+{"task_id":"TASK_IG_001","action":"publish_content","platform":"instagram","post_type":"video","account_id":"IG_001","device_id":"D02","target":null,"title":null,"body":null,"link_url":null,"media_path":"media/video-001.mp4","caption":"New product demo","hashtags":["demo","product"],"dry_run":true,"require_human_confirm":true}
+{"task_id":"TASK_FB_001","action":"publish_content","platform":"facebook","post_type":"text","account_id":"FB_001","device_id":"D03","target":null,"title":null,"body":"Dry-run Facebook post.","link_url":null,"media_path":null,"caption":null,"hashtags":[],"dry_run":true,"require_human_confirm":true}
+{"task_id":"TASK_XHS_001","action":"publish_content","platform":"xiaohongshu","post_type":"image","account_id":"XHS_001","device_id":"D04","target":null,"title":"Dry-run Xiaohongshu note","body":null,"link_url":null,"media_path":"media/image-001.jpg","caption":"New product note","hashtags":["demo","product"],"dry_run":true,"require_human_confirm":true}

package/mobile-runtime/data-templates/video_metrics.example.jsonl

@@ -0,0 +1 @@
+{"account_id":"acct_tiktok_001","comments":3,"fetched_at":"2026-05-27T10:00:00+00:00","likes":42,"platform":"tiktok","platform_permalink":"https://www.tiktok.com/@example/video/1234567890","platform_post_id":"1234567890","raw":{"view_count":1200},"record_id":"pub_demo_tiktok_001","saves":null,"score":null,"shares":5,"snapshot_id":"met_demo_tiktok_001","source":"tiktok_display_api","views":1200}

package/mobile-runtime/python/pyproject.toml

@@ -0,0 +1,34 @@
+[project]
+name = "elevenagents-mobile-runtime"
+version = "0.1.0"
+description = "11agents Android device-pool runtime for mobile publishing, records, and data collection."
+requires-python = ">=3.10"
+dependencies = [
+  "Pillow>=10",
+]
+
+[project.optional-dependencies]
+appium = [
+  "Appium-Python-Client>=4.0",
+]
+
+[project.scripts]
+groupctl = "device_control.cli:main"
+publish-facebook = "device_control.entrypoints:publish_facebook"
+publish-instagram = "device_control.entrypoints:publish_instagram"
+publish-reddit = "device_control.entrypoints:publish_reddit"
+publish-tiktok = "device_control.entrypoints:publish_tiktok"
+publish-x = "device_control.entrypoints:publish_x"
+publish-xiaohongshu = "device_control.entrypoints:publish_xiaohongshu"
+copy-xiaohongshu-link = "device_control.entrypoints:copy_xiaohongshu_link"
+ensure-appium = "device_control.entrypoints:ensure_appium"
+stop-appium = "device_control.entrypoints:stop_appium"
+collect-tiktok-account-metrics = "device_control.entrypoints:collect_tiktok_account_metrics"
+collect-tiktok-video-metrics = "device_control.entrypoints:collect_tiktok_video_metrics"
+
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.packages.find]
+where = ["src"]

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

@@ -0,0 +1,5 @@
+"""Android group control MVP package."""
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

package/mobile-runtime/python/src/device_control/adapters/__init__.py

@@ -0,0 +1,31 @@
+from .base import AdapterRegistry, PlatformAdapter
+from .facebook import FacebookAdapter
+from .instagram import InstagramAdapter
+from .reddit import RedditAdapter
+from .tiktok import TikTokAdapter
+from .x import XAdapter
+from .xiaohongshu import XiaohongshuAdapter
+
+
+def default_registry() -> AdapterRegistry:
+    registry = AdapterRegistry()
+    registry.register(RedditAdapter())
+    registry.register(TikTokAdapter())
+    registry.register(InstagramAdapter())
+    registry.register(FacebookAdapter())
+    registry.register(XiaohongshuAdapter())
+    registry.register(XAdapter())
+    return registry
+
+
+__all__ = [
+    "AdapterRegistry",
+    "PlatformAdapter",
+    "FacebookAdapter",
+    "RedditAdapter",
+    "TikTokAdapter",
+    "InstagramAdapter",
+    "XiaohongshuAdapter",
+    "XAdapter",
+    "default_registry",
+]

package/mobile-runtime/python/src/device_control/adapters/base.py

@@ -0,0 +1,43 @@
+from __future__ import annotations
+
+from abc import ABC, abstractmethod
+
+from device_control.models import PublishTask
+
+
+class PlatformAdapter(ABC):
+    platform: str
+    package_names: tuple[str, ...]
+    supported_post_types: tuple[str, ...]
+
+    def validate(self, task: PublishTask) -> list[str]:
+        errors: list[str] = []
+        if task.platform != self.platform:
+            errors.append(f"Task platform {task.platform!r} does not match adapter {self.platform!r}")
+        if task.post_type not in self.supported_post_types:
+            errors.append(
+                f"Post type {task.post_type!r} is not supported by {self.platform}; "
+                f"supported={self.supported_post_types}"
+            )
+        return errors
+
+    @abstractmethod
+    def plan(self, task: PublishTask) -> list[str]:
+        """Return human-readable execution steps for dry planning."""
+
+
+class AdapterRegistry:
+    def __init__(self) -> None:
+        self._adapters: dict[str, PlatformAdapter] = {}
+
+    def register(self, adapter: PlatformAdapter) -> None:
+        self._adapters[adapter.platform] = adapter
+
+    def get(self, platform: str) -> PlatformAdapter:
+        key = platform.lower()
+        if key not in self._adapters:
+            raise KeyError(f"No adapter registered for platform {platform!r}")
+        return self._adapters[key]
+
+    def platforms(self) -> list[str]:
+        return sorted(self._adapters)

package/mobile-runtime/python/src/device_control/adapters/facebook.py

@@ -0,0 +1,30 @@
+from __future__ import annotations
+
+from device_control.models import PublishTask
+
+from .base import PlatformAdapter
+
+
+class FacebookAdapter(PlatformAdapter):
+    platform = "facebook"
+    package_names = ("com.facebook.katana", "com.facebook.lite")
+    supported_post_types = ("text", "link", "image", "video")
+
+    def plan(self, task: PublishTask) -> list[str]:
+        steps = [
+            "wake device",
+            "open Facebook app",
+            f"choose content flow for post_type={task.post_type}",
+        ]
+        if task.media_path:
+            steps.append(f"push/select media: {task.media_path}")
+        if task.title:
+            steps.append(f"fill title: {task.title}")
+        if task.body:
+            steps.append("fill body")
+        if task.caption:
+            steps.append(f"fill caption: {task.caption}")
+        if task.link_url:
+            steps.append(f"fill link: {task.link_url}")
+        steps.extend(["capture pre-publish screenshot", "publish or stop at dry-run", "capture result screenshot"])
+        return steps

package/mobile-runtime/python/src/device_control/adapters/instagram.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from device_control.models import PublishTask
+
+from .base import PlatformAdapter
+
+
+class InstagramAdapter(PlatformAdapter):
+    platform = "instagram"
+    package_names = ("com.instagram.android",)
+    supported_post_types = ("image", "video")
+
+    def plan(self, task: PublishTask) -> list[str]:
+        return [
+            "wake device",
+            "push media to gallery directory",
+            "open Instagram app",
+            f"choose content flow for post_type={task.post_type}",
+            f"select media: {task.media_path}",
+            f"fill caption: {task.caption or ''}",
+            f"fill hashtags: {' '.join('#' + tag for tag in task.hashtags)}",
+            "capture pre-publish screenshot",
+            "publish or stop at dry-run",
+            "capture result screenshot",
+        ]

package/mobile-runtime/python/src/device_control/adapters/reddit.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from device_control.models import PublishTask
+
+from .base import PlatformAdapter
+
+
+class RedditAdapter(PlatformAdapter):
+    platform = "reddit"
+    package_names = ("com.reddit.frontpage",)
+    supported_post_types = ("text", "link", "image", "video")
+
+    def plan(self, task: PublishTask) -> list[str]:
+        steps = [
+            "wake device",
+            "open Reddit app",
+            f"select target community: {task.target}",
+            f"choose post type: {task.post_type}",
+        ]
+        if task.media_path:
+            steps.append(f"push/select media: {task.media_path}")
+        if task.title:
+            steps.append(f"fill title: {task.title}")
+        if task.body:
+            steps.append("fill body")
+        if task.link_url:
+            steps.append(f"fill link: {task.link_url}")
+        steps.extend(["capture pre-publish screenshot", "publish or stop at dry-run", "capture result screenshot"])
+        return steps

package/mobile-runtime/python/src/device_control/adapters/tiktok.py

@@ -0,0 +1,25 @@
+from __future__ import annotations
+
+from device_control.models import PublishTask
+
+from .base import PlatformAdapter
+
+
+class TikTokAdapter(PlatformAdapter):
+    platform = "tiktok"
+    package_names = ("com.zhiliaoapp.musically", "com.ss.android.ugc.trill")
+    supported_post_types = ("video",)
+
+    def plan(self, task: PublishTask) -> list[str]:
+        return [
+            "wake device",
+            "push video to gallery directory",
+            "open TikTok app",
+            "enter create flow",
+            f"select video: {task.media_path}",
+            f"fill caption: {task.caption or ''}",
+            f"fill hashtags: {' '.join('#' + tag for tag in task.hashtags)}",
+            "capture pre-publish screenshot",
+            "publish or stop at dry-run",
+            "capture result screenshot",
+        ]