updates

Author: chiefMarlin

README.md

@@ -96,6 +96,13 @@ export LLM_API_KEY="your-api-key"
 
 # Run a predefined task
 ./droidrun-client -server http://localhost:8000 -task tasks/whatsapp-reply.toml
+
+# Discover deep links for an app
+./droidrun-client -server http://localhost:8000 -deeplinks com.instagram.android
+
+# Run a task with a deep link (opens specific screen before the agent starts)
+./droidrun-client -server http://localhost:8000 -key $LLM_API_KEY \
+  -app com.instagram.android -deeplink "instagram://mainfeed" "like the first post"
 ```
 
 ### curl
@@ -122,6 +129,38 @@ curl -H "X-Server-Key: $DROIDRUN_SERVER_KEY" http://localhost:8000/task/TASK_ID
 curl -X DELETE -H "X-Server-Key: $DROIDRUN_SERVER_KEY" http://localhost:8000/task/TASK_ID
 ```
 
+### Task Files
+
+Task files are TOML configs for reusable tasks. Example with a deep link:
+
+```toml
+[task]
+name = "instagram-feed"
+description = "Like the first post on Instagram feed"
+
+[task.goal]
+app = "com.instagram.android"
+deeplink = "instagram://mainfeed"
+prompt = """
+1. You are on the Instagram main feed.
+2. Like the first post you see.
+3. Return to home desktop when done.
+"""
+
+[task.model]
+provider = "Google"
+model = "gemini-flash-latest"
+
+[task.options]
+reasoning = true
+vision = false
+max_steps = 15
+```
+
+Run with: `./droidrun-client -task tasks/instagram-feed.toml -server http://localhost:8000`
+
+Use `-deeplinks` to discover available deep links for an app before writing task files.
+
 ## API Reference
 
 **Base URL:** `http://localhost:8000`
@@ -154,10 +193,14 @@ X-API-Key: your-llm-api-key
 | Field | Type | Required | Default | Description |
 |-------|------|----------|---------|-------------|
 | `goal` | string | Yes | - | What you want the agent to do |
+| `app` | string | No | - | Android package to launch (e.g. `com.whatsapp`) |
+| `deeplink` | string | No | - | Deep link URI to open (e.g. `instagram://mainfeed`) |
 | `provider` | string | No | `Google` | LLM provider (see below) |
 | `model` | string | No | auto | Model name |
 | `max_steps` | int | No | `30` | Maximum steps (1-100) |
 
+If both `app` and `deeplink` are set, the app is launched first, then the deep link is opened. If only `deeplink` is set, it opens directly (which implicitly opens the app).
+
 **Providers:**
 | Provider | Default Model |
 |----------|---------------|
@@ -238,6 +281,34 @@ X-Server-Key: your-server-key
 
 ---
 
+### GET /deeplinks
+
+Discover available deep links for an installed app. Runs `adb shell dumpsys package` and parses intent filters for non-http/https URI schemes.
+
+**Headers:**
+```
+X-Server-Key: your-server-key
+```
+
+**Query Parameters:**
+| Parameter | Required | Description |
+|-----------|----------|-------------|
+| `app` | Yes | Android package name (e.g. `com.instagram.android`) |
+
+**Response:** `200 OK`
+```json
+{
+  "app": "com.instagram.android",
+  "deeplinks": [
+    "instagram://camera",
+    "instagram://mainfeed",
+    "instagram://reels_home"
+  ]
+}
+```
+
+---
+
 ### GET /health
 
 Health check. No authentication required.

tasks/instagram-notifications.toml

@@ -0,0 +1,35 @@
+# Instagram in-app notification reply task
+
+[task]
+name = "instagram-notifications"
+description = "Navigate to Instagram notifications and reply to today's comments"
+
+[task.goal]
+app = "com.instagram.android"
+prompt = """
+1. You are now in Instagram. Tap the house icon in the bottom left corner to go to the home feed.
+2. Tap the heart icon in the top right corner to open your notifications/activity.
+3. You are now in the notifications screen. Look for notifications from TODAY only:
+   - Comments on your posts (these show the comment text)
+   - Ignore likes, follows, suggestions, and older notifications
+4. For each COMMENT notification from today:
+   - Tap on it to open the post with that comment
+   - Find the comment and tap "Reply"
+   - Write a friendly, relevant response to the comment
+   - Post the reply
+   - Tap the back arrow to return to notifications
+5. Continue until you've replied to all comment notifications from today.
+6. Return to home desktop when done.
+7. Report a summary of:
+   - How many comments you found from today
+   - What replies you sent and to whom
+"""
+
+[task.model]
+provider = "Google"
+model = "gemini-flash-latest"
+
+[task.options]
+reasoning = true
+vision = true
+max_steps = 40

tasks/whatsapp-joke.toml

@@ -0,0 +1,25 @@
+# WhatsApp joke task - send a joke to Boss via deep link
+
+[task]
+name = "whatsapp-joke"
+description = "Open WhatsApp chats, find Boss, and send him a joke"
+
+[task.goal]
+app = "com.whatsapp"
+prompt = """
+1. Navigate to the Chats tab (not Updates, Communities, or Calls).
+2. Find the chat with "Boss" - scroll through the chat list if needed.
+3. Open the chat with Boss.
+4. Type and send a short, clean, work-appropriate joke.
+5. Return to home desktop when done.
+6. Report what joke you sent.
+"""
+
+[task.model]
+provider = "Google"
+model = "gemini-flash-latest"
+
+[task.options]
+reasoning = true
+vision = false
+max_steps = 15