@openhands/extensions 0.31.0 → 0.32.1

package/automations/catalog/github-issue-to-pr/manifest.json

@@ -98,7 +98,7 @@
       }
     },
     "bundle": {
-      "version": "1.2.3",
+      "version": "1.2.4",
       "entrypoint": "python3 worker.py",
       "timeout": 300,
       "files": {
@@ -117,5 +117,5 @@
     },
     "message": "Configure the repositories, labels, branch prefix, pull request mode, agent profile, and schedule."
   },
-  "version": "1.2.2"
+  "version": "1.2.3"
 }

package/automations/catalog/github-issue-triage/manifest.json

@@ -1,6 +1,6 @@
 {
   "id": "github-issue-triage",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "name": "GitHub issue triage",
   "category": "Project management",
   "description": "Prioritize open issues and establish acceptance criteria before marking them ready for development.",
@@ -54,7 +54,7 @@
       }
     },
     "bundle": {
-      "version": "1.4.1",
+      "version": "1.4.2",
       "entrypoint": "python3 worker.py",
       "timeout": 300,
       "files": {

package/automations/catalog/github-pr-reviewer/manifest.json

@@ -1,6 +1,6 @@
 {
   "id": "github-pr-reviewer",
-  "version": "1.11.1",
+  "version": "1.11.2",
   "name": "GitHub code review",
   "category": "Code review",
   "description": "Review requested pull-request heads, resume an outstanding reviewer request on a schedule once its checks are green, classify all open non-draft pull requests that nobody requested and review eligible green heads, drain the backlog oldest-first under a small per-scan new-conversation bound, record exact-head decisions, stop early on out-of-scope changes, and optionally request a code-aware human maintainer after approval or a maintainer-decision scope stop only when a successfully fetched same-repository closing issue has priority:medium or priority:high.",
@@ -135,7 +135,7 @@
       }
     },
     "bundle": {
-      "version": "1.11.1",
+      "version": "1.11.2",
       "entrypoint": "python3 worker.py",
       "timeout": 300,
       "files": {

package/automations/catalog/incident-retrospective-drafter/manifest.json

@@ -23,6 +23,10 @@
   },
   "popularityRank": 78,
   "estimatedSetupMinutes": 8,
+  "triggers": [
+    "cron",
+    "event"
+  ],
   "skill": "incident-retrospective",
   "exampleImplementation": "Trigger: manual, cron, or incident label added\nRequired MCPs: Slack, Linear, Notion\n\n1. Gather incident messages, timestamps, and linked issue references.\n2. Pull Linear follow-up tickets, owners, and status.\n3. TODO: define the incident identifier format and approved Notion template.\n4. Build a timeline, impact summary, root-cause hypotheses, and action items.\n5. Publish a draft retrospective and notify the incident owner.",
   "setup": {

package/automations/catalog/jira-issue-to-bitbucket-pr/manifest.json

@@ -18,6 +18,9 @@
   },
   "popularityRank": 83,
   "estimatedSetupMinutes": 6,
+  "triggers": [
+    "cron"
+  ],
   "skill": "jira-issue-to-pr",
   "exampleImplementation": "Trigger: cron polling (e.g. every 5 minutes)\nRequired integrations: Atlassian Rovo MCP for Jira access and a Bitbucket connection. On OpenHands Cloud and Enterprise the poller reads and comments on Jira through the connected Atlassian Rovo MCP server, so it needs no Jira API token; the conversation it starts pushes with the connected Bitbucket integration, or commits through the Bitbucket tools of the same Atlassian Rovo MCP server when it has no token. A local Agent Canvas needs a Jira API token and a Bitbucket token as secrets instead.\n\n1. Connect Atlassian Rovo MCP and Bitbucket, then collect the Jira site, label to watch, and cron schedule from the user, and set git_provider to bitbucket. A local Agent Canvas also needs the Jira base URL, email, and API token secret name. No Bitbucket repo is needed at deploy time - each ticket must include the target repo (workspace/repo on bitbucket.org) in its body.\n2. Search the Jira Cloud instance for open issues carrying the configured label.\n3. Deduplicate against a KV-store-backed set of already-processed issue keys so re-runs never create duplicate PRs.\n4. For each new issue, start an independent OpenHands agent conversation that extracts the Bitbucket repo from the ticket body, clones it, creates a branch named after the Jira key, implements or scaffolds the requested change, and opens a pull request.\n5. Immediately after the conversation is created, post a Jira comment on the issue: 'I'm on it: <conversation URL>'.\n6. Persist the processed issue key immediately after dispatching so the next poll skips it."
 }

package/automations/catalog/jira-issue-to-gitlab-mr/manifest.json

@@ -18,6 +18,9 @@
   },
   "popularityRank": 84,
   "estimatedSetupMinutes": 6,
+  "triggers": [
+    "cron"
+  ],
   "skill": "jira-issue-to-pr",
   "exampleImplementation": "Trigger: cron polling (e.g. every 5 minutes)\nRequired integrations: Atlassian Rovo MCP for Jira access and a GitLab connection. On OpenHands Cloud and Enterprise the poller reads and comments on Jira through the connected Atlassian Rovo MCP server, so it needs no Jira API token; the conversation it starts pushes with the connected GitLab integration, or commits through the connected GitLab MCP server when it has no token. Calling GitLab MCP directly needs GitLab 19.4 or later. On an older GitLab, sign in with GitLab or connect it under Settings -> Integrations; add a GITLAB_TOKEN secret only if you can do neither. A local Agent Canvas needs a Jira API token and a GitLab token (api scope) as secrets instead.\n\n1. Connect Atlassian Rovo MCP and GitLab, then collect the Jira site, label to watch, and cron schedule from the user, and set git_provider to gitlab. A local Agent Canvas also needs the Jira base URL, email, and API token secret name. No GitLab project is needed at deploy time - each ticket must include the target project (group/project, subgroups included, or its URL on a self-managed host) in its body.\n2. Search the Jira Cloud instance for open issues carrying the configured label.\n3. Deduplicate against a KV-store-backed set of already-processed issue keys so re-runs never create duplicate merge requests.\n4. For each new issue, start an independent OpenHands agent conversation that extracts the GitLab project from the ticket body, clones it, creates a branch named after the Jira key, implements or scaffolds the requested change, and opens a merge request.\n5. Immediately after the conversation is created, post a Jira comment on the issue: 'I'm on it: <conversation URL>'.\n6. Persist the processed issue key immediately after dispatching so the next poll skips it."
 }

package/automations/catalog/jira-issue-to-pr/manifest.json

@@ -15,5 +15,8 @@
   },
   "popularityRank": 85,
   "estimatedSetupMinutes": 5,
+  "triggers": [
+    "cron"
+  ],
   "exampleImplementation": "Trigger: cron polling (e.g. every 5 minutes)\nRequired integrations: Atlassian Rovo MCP for Jira access and a GitHub connection. On OpenHands Cloud and Enterprise the poller reads and comments on Jira through the connected Atlassian Rovo MCP server, so it needs no Jira API token. A local Agent Canvas needs a Jira API token and a GitHub personal access token (repo + workflow scope) as secrets instead.\n\n1. Connect Atlassian Rovo MCP and GitHub, then collect the Jira site, label to watch, and cron schedule from the user. A local Agent Canvas also needs the Jira base URL, email, and API token secret name. No GitHub repo is needed at deploy time - each ticket must include the target repo (owner/repo) in its body.\n2. Search the Jira Cloud instance for open issues carrying the configured label.\n3. Deduplicate against a KV-store-backed set of already-processed issue keys so re-runs never create duplicate PRs.\n4. For each new issue, start an independent OpenHands agent conversation that extracts the GitHub repo from the ticket body, clones it, creates a branch named after the Jira key, implements or scaffolds the requested change, and opens a pull request.\n5. Immediately after the conversation is created, post a Jira comment on the issue: 'I'm on it: <conversation URL>'.\n6. Persist the processed issue key immediately after dispatching so the next poll skips it."
 }

package/automations/catalog/linear-issue-to-bitbucket-pr/manifest.json

@@ -18,6 +18,10 @@
   },
   "popularityRank": 87,
   "estimatedSetupMinutes": 6,
+  "triggers": [
+    "cron",
+    "event"
+  ],
   "skill": "ticket-to-code-change",
   "exampleImplementation": "Trigger: Linear issue marked implementation-ready\nRequired integrations: Linear, Bitbucket\n\n1. Watch the selected Linear team or project for issues carrying a configurable implementation-ready label or state.\n2. Deduplicate issue IDs so each transition dispatches once.\n3. Read the issue, linked dependencies, acceptance criteria, and target repository.\n4. Start an independent OpenHands conversation that clones the Bitbucket repository, creates an issue-keyed branch, implements and tests the change, and opens a pull request.\n5. Post the conversation and pull request links back to the Linear issue and update its status according to the team's workflow."
 }

package/automations/catalog/linear-issue-to-github-pr/manifest.json

@@ -18,6 +18,10 @@
   },
   "popularityRank": 89,
   "estimatedSetupMinutes": 6,
+  "triggers": [
+    "cron",
+    "event"
+  ],
   "skill": "ticket-to-code-change",
   "exampleImplementation": "Trigger: Linear issue marked implementation-ready\nRequired integrations: Linear, GitHub\n\n1. Watch the selected Linear team or project for issues carrying a configurable implementation-ready label or state.\n2. Deduplicate issue IDs so each transition dispatches once.\n3. Read the issue, linked dependencies, acceptance criteria, and target repository.\n4. Start an independent OpenHands conversation that clones the GitHub repository, creates an issue-keyed branch, implements and tests the change, and opens a pull request.\n5. Post the conversation and pull request links back to the Linear issue and update its status according to the team's workflow."
 }

package/automations/catalog/linear-issue-to-gitlab-mr/manifest.json

@@ -18,6 +18,10 @@
   },
   "popularityRank": 88,
   "estimatedSetupMinutes": 6,
+  "triggers": [
+    "cron",
+    "event"
+  ],
   "skill": "ticket-to-code-change",
   "exampleImplementation": "Trigger: Linear issue marked implementation-ready\nRequired integrations: Linear, GitLab\n\n1. Watch the selected Linear team or project for issues carrying a configurable implementation-ready label or state.\n2. Deduplicate issue IDs so each transition dispatches once.\n3. Read the issue, linked dependencies, acceptance criteria, and target repository.\n4. Start an independent OpenHands conversation that clones the GitLab repository, creates an issue-keyed branch, implements and tests the change, and opens a merge request.\n5. Post the conversation and merge request links back to the Linear issue and update its status according to the team's workflow."
 }

package/automations/catalog/linear-triage-assistant/manifest.json

@@ -12,6 +12,10 @@
   },
   "popularityRank": 90,
   "estimatedSetupMinutes": 3,
+  "triggers": [
+    "cron",
+    "event"
+  ],
   "skill": "linear-triage",
   "exampleImplementation": "Trigger: linear Issue create\nRequired MCP: Linear\n\n1. Load the new issue, team context, project, labels, and recent similar issues.\n2. Score priority and classify the request as bug, feature, support, or chore.\n3. TODO: map local team labels and priority conventions.\n4. Add a triage comment with rationale and suggested next actions.\n5. Optionally update labels, priority, and assignee."
 }

package/automations/catalog/research-brief-writer/manifest.json

@@ -15,6 +15,9 @@
   },
   "popularityRank": 84,
   "estimatedSetupMinutes": 7,
+  "triggers": [
+    "cron"
+  ],
   "skill": "research-brief",
   "exampleImplementation": "Trigger: cron, weekly or daily\nRequired MCPs: Tavily, Notion\n\n1. Run focused Tavily searches for configured topics and competitors.\n2. Deduplicate sources and rank them by freshness and authority.\n3. TODO: confirm citation format and destination Notion database schema.\n4. Write an executive summary, implications, and recommended actions.\n5. Create or update a Notion page with citations and source links."
 }

package/automations/catalog/slack-channel-monitor/manifest.json

@@ -12,5 +12,8 @@
   },
   "popularityRank": 92,
   "estimatedSetupMinutes": 7,
+  "triggers": [
+    "cron"
+  ],
   "exampleImplementation": "Trigger: cron, every minute\nRequired secret: SLACK_BOT_TOKEN or SLACK_USER_TOKEN\n\n1. Poll up to 10 configured Slack channels for new messages since the last run.\n2. Match messages containing the trigger phrase (default: @openhands).\n3. React with 👀 and start an OpenHands conversation with the message and recent channel context.\n4. Post a thread reply with a link to the conversation, then post the agent response when done.\n5. Keep the thread in a short follow-up watch window and forward only replies that repeat the trigger phrase to the same conversation, with per-thread backoff for quiet threads."
 }

package/automations/catalog/slack-standup-digest/manifest.json

@@ -12,5 +12,8 @@
   },
   "popularityRank": 94,
   "estimatedSetupMinutes": 5,
+  "triggers": [
+    "cron"
+  ],
   "exampleImplementation": "Trigger: cron, weekday mornings\nRequired MCP: Slack\n\n1. Search configured channels for messages since the last digest window.\n2. Cluster updates into shipped work, active work, blockers, and decisions.\n3. TODO: choose a safe allowlist for channels and whether DMs are excluded.\n4. Draft a Slack message with owners, links, and unanswered questions.\n5. Optionally post to the configured standup channel."
 }

package/automations/catalog.schema.json

@@ -64,8 +64,25 @@
         }
       }
     },
-    "setup": { "$ref": "#/$defs/setup" }
+    "setup": { "$ref": "#/$defs/setup" },
+    "triggers": {
+      "description": "How the automation runs once created, for an entry without a setup form: `cron` for a schedule, `event` for an event-driven trigger, or both. An entry whose `setup.form.triggers` declares the variants states it there instead, so the two never coexist. Informational: Agent Canvas renders it as the card's trigger badge and filter.",
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "enum": ["cron", "event"] }
+    }
+  },
+  "if": {
+    "required": ["setup"],
+    "properties": {
+      "setup": {
+        "required": ["form"],
+        "properties": { "form": { "required": ["triggers"] } }
+      }
+    }
   },
+  "then": { "not": { "required": ["triggers"] } },
   "$defs": {
     "impactCopy": {
       "description": "One value-statement phrase. Markup-free, and the only placeholder it may open is {{count}}, which the host substitutes with the formatted run count.",

package/automations/index.d.ts

@@ -42,6 +42,14 @@ export interface RecommendedAutomation {
   impact?: AutomationImpact;
   /** Present when this automation ships an extension-owned setup experience. */
   setup?: AutomationSetup;
+  /**
+   * How the automation runs once created, for an entry without a setup form:
+   * `cron` for a schedule, `event` for an event-driven trigger, or both. An
+   * entry whose `setup.form.triggers` declares the variants states it there
+   * instead. Informational: the host renders it as the card's trigger badge
+   * and filter.
+   */
+  triggers?: AutomationTriggerKind[];
 }
 
 export interface AutomationImpact {

package/marketplaces/openhands-extensions.json

@@ -97,6 +97,7 @@
       "source": "./skills/software-factory",
       "description": "Set up a GitHub software factory fast: ask only for the repositories and the ticket source (GitHub issues, Jira or Linear), create a working issue-to-PR and PR-review pipeline from catalog automations with defaults, then let the user stop or extend it step by step.",
       "category": "automations",
+      "defaultEnabled": true,
       "keywords": [
         "onboarding",
         "software-factory",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openhands/extensions",
-  "version": "0.31.0",
+  "version": "0.32.1",
   "description": "Public OpenHands extension catalogs for skills, plugins, integrations, and automation templates.",
   "license": "MIT",
   "type": "module",

package/plugins/vulnerability-remediation/skills/github/scripts/agent_conversation.py

@@ -104,16 +104,16 @@ class CloudConversations:
         return found[0] if found else None
 
     def start(self, conversation_id, profile_id, title: str, prompt: str) -> None:
-        self._request(
-            "POST",
-            "/api/v1/app-conversations",
-            {
-                "conversation_id": str(conversation_id),
-                "agent_profile_id": str(profile_id),
-                "title": title,
-                "initial_message": _user_message(prompt),
-            },
-        )
+        body = {
+            "conversation_id": str(conversation_id),
+            "title": title,
+            "initial_message": _user_message(prompt),
+        }
+        if profile_id is not None:
+            # Without one the API launches the member's active profile, or the
+            # default settings when none is active.
+            body["agent_profile_id"] = str(profile_id)
+        self._request("POST", "/api/v1/app-conversations", body)
 
     def agent_profiles(self) -> list[dict]:
         listing = self._request("GET", "/api/agent-profiles")
@@ -177,7 +177,10 @@ class AgentConversationDispatcher:
         # local Agent Canvas; elsewhere conversations go through the OpenHands API.
         self.agent_url = os.environ.get("AGENT_SERVER_URL")
         self.api_key = os.environ["SESSION_API_KEY"]
-        self.profile_id = UUID(os.environ["AUTOMATION_AGENT_PROFILE_ID"])
+        # The automation service sets the variable only when the automation
+        # names an agent profile; a run without one launches the default.
+        profile_id = os.environ.get("AUTOMATION_AGENT_PROFILE_ID")
+        self.profile_id = UUID(profile_id) if profile_id else None
         payload = json.loads(os.environ["AUTOMATION_EVENT_PAYLOAD"])
         self.automation_id = str(payload["automation_id"])
         self._cloud = None if self.agent_url else CloudConversations()
@@ -187,6 +190,18 @@ class AgentConversationDispatcher:
     def __enter__(self):
         if self._cloud:
             return self
+        if self.profile_id is None:
+            # The Agent Server starts a conversation from a profile, and always
+            # has an active one: its listing seeds `default` when the store is
+            # empty.
+            listing = self._agent_server_get("/api/agent-profiles")
+            active = (listing or {}).get("active_agent_profile_id")
+            if not active:
+                raise RuntimeError(
+                    "No agent profile is selected and the Agent Server has "
+                    "none active"
+                )
+            self.profile_id = UUID(active)
         _register_tools()
         self._workspace = RemoteWorkspace(
             host=self.agent_url,

package/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "openhands-extensions"
-version = "0.31.0"
+version = "0.32.1"
 description = "OpenHands extensions, plugins, and skills (Python bindings for the integration catalog)"
 requires-python = ">=3.12"
 dependencies = [

package/python/openhands_extensions/_version.py

@@ -18,7 +18,7 @@ from importlib.metadata import PackageNotFoundError, version
 #: Kept in lock-step with pyproject.toml/package.json by the version test.
 #: release-please only rewrites a semver found on the annotated line itself, so
 #: the annotation must stay on the assignment; on its own line it is a no-op.
-_FALLBACK_VERSION = "0.31.0"  # x-release-please-version
+_FALLBACK_VERSION = "0.32.1"  # x-release-please-version
 
 try:
     __version__: str = version("openhands-extensions")

package/skills/bitbucket-data-center/SKILL.md

@@ -6,9 +6,11 @@ description: Bitbucket Data Center (self-hosted Bitbucket Server) specifics —
 Use authenticated Bitbucket Data Center MCP tools first when they are available in the agent's environment. Detect this by tool availability, without depending on a particular MCP server name. Use the token and direct REST API instructions below only when those tools are unavailable or when raw API or `curl` access is explicitly needed.
 
 You are working with **Bitbucket Data Center** (self-hosted Bitbucket Server). You have
-access to an environment variable, `BITBUCKET_DATA_CENTER_TOKEN`, which contains a basic
-auth token in the format `username:your-token` that allows you to interact with the git
-repository and the REST API.
+access to an environment variable, `BITBUCKET_DATA_CENTER_TOKEN`, which holds your Bitbucket
+Data Center credential in one of two forms:
+
+- An access or OAuth token: the value has no colon, or starts with `x-token-auth:`.
+- A `username:token` pair.
 
 > Environment variable names are case-sensitive. If `BITBUCKET_DATA_CENTER_TOKEN` is not
 > present, use whichever case variant actually exists (for example
@@ -17,19 +19,34 @@ repository and the REST API.
 - REST API base URL: `https://{domain}/rest/api/1.0`
 - Repository identifier format: `PROJECT/repo_slug` (project key, slash, repo slug)
 
-You can use this token to interact with the Bitbucket Data Center REST API:
-```bash
-curl -u "${BITBUCKET_DATA_CENTER_TOKEN}" https://{domain}/rest/api/1.0/...
-```
+Use it with the Bitbucket Data Center REST API as follows:
+
+- An access or OAuth token goes in a Bearer header, without any `x-token-auth:` prefix:
+  ```bash
+  curl -H "Authorization: Bearer ${BITBUCKET_DATA_CENTER_TOKEN#x-token-auth:}" https://{domain}/rest/api/1.0/...
+  ```
+- A `username:token` pair uses HTTP Basic auth:
+  ```bash
+  curl -u "${BITBUCKET_DATA_CENTER_TOKEN}" https://{domain}/rest/api/1.0/...
+  ```
 
 <IMPORTANT>
 ALWAYS use the Bitbucket Data Center API for operations instead of a web browser.
 ALWAYS use the `create_bitbucket_data_center_pr` tool to open a pull request
 </IMPORTANT>
 
-If you encounter authentication issues when pushing to Bitbucket Data Center (such as password prompts or permission errors), the old token may have expired. In such case, update the remote URL to include the current token: `git remote set-url origin https://${BITBUCKET_DATA_CENTER_TOKEN}@{domain}/scm/{project_lower}/{repo}.git`
+If you encounter authentication issues when pushing to Bitbucket Data Center (such as password prompts or permission errors), the token in the remote URL may have expired. Update the remote URL to include the current token:
+
+- For a `username:token` pair: `git remote set-url origin https://${BITBUCKET_DATA_CENTER_TOKEN}@{domain}/scm/{project_lower}/{repo}.git`
+- For an access or OAuth token, keep the username that is already in the remote URL and replace only the token. The git username these tokens need depends on the server, so don't choose one yourself. If the remote URL has no username, tell the user instead.
+  ```bash
+  GIT_USER=$(git remote get-url origin | sed -nE 's#^https://([^:@/]+):[^@]*@.*#\1#p') && \
+  [ -n "$GIT_USER" ] && \
+  NEW_TOKEN=$(python3 -c 'import sys, urllib.parse; print(urllib.parse.quote(sys.argv[1], safe=""))' "${BITBUCKET_DATA_CENTER_TOKEN#x-token-auth:}") && \
+  git remote set-url origin "https://${GIT_USER}:${NEW_TOKEN}@{domain}/scm/{project_lower}/{repo}.git"
+  ```
 
-The token is a `username:token` pair, so if the username or token contains characters that are reserved in URLs (such as `@`), split on the first `:` and URL-encode each part before embedding it in a remote:
+If the username or token contains characters that are reserved in URLs (such as `@`), split the pair on the first `:` and URL-encode each part before embedding it in a remote:
 
 ```bash
 BB_USER="${BITBUCKET_DATA_CENTER_TOKEN%%:*}" && \

package/skills/github/scripts/agent_conversation.py

@@ -104,16 +104,16 @@ class CloudConversations:
         return found[0] if found else None
 
     def start(self, conversation_id, profile_id, title: str, prompt: str) -> None:
-        self._request(
-            "POST",
-            "/api/v1/app-conversations",
-            {
-                "conversation_id": str(conversation_id),
-                "agent_profile_id": str(profile_id),
-                "title": title,
-                "initial_message": _user_message(prompt),
-            },
-        )
+        body = {
+            "conversation_id": str(conversation_id),
+            "title": title,
+            "initial_message": _user_message(prompt),
+        }
+        if profile_id is not None:
+            # Without one the API launches the member's active profile, or the
+            # default settings when none is active.
+            body["agent_profile_id"] = str(profile_id)
+        self._request("POST", "/api/v1/app-conversations", body)
 
     def agent_profiles(self) -> list[dict]:
         listing = self._request("GET", "/api/agent-profiles")
@@ -177,7 +177,10 @@ class AgentConversationDispatcher:
         # local Agent Canvas; elsewhere conversations go through the OpenHands API.
         self.agent_url = os.environ.get("AGENT_SERVER_URL")
         self.api_key = os.environ["SESSION_API_KEY"]
-        self.profile_id = UUID(os.environ["AUTOMATION_AGENT_PROFILE_ID"])
+        # The automation service sets the variable only when the automation
+        # names an agent profile; a run without one launches the default.
+        profile_id = os.environ.get("AUTOMATION_AGENT_PROFILE_ID")
+        self.profile_id = UUID(profile_id) if profile_id else None
         payload = json.loads(os.environ["AUTOMATION_EVENT_PAYLOAD"])
         self.automation_id = str(payload["automation_id"])
         self._cloud = None if self.agent_url else CloudConversations()
@@ -187,6 +190,18 @@ class AgentConversationDispatcher:
     def __enter__(self):
         if self._cloud:
             return self
+        if self.profile_id is None:
+            # The Agent Server starts a conversation from a profile, and always
+            # has an active one: its listing seeds `default` when the store is
+            # empty.
+            listing = self._agent_server_get("/api/agent-profiles")
+            active = (listing or {}).get("active_agent_profile_id")
+            if not active:
+                raise RuntimeError(
+                    "No agent profile is selected and the Agent Server has "
+                    "none active"
+                )
+            self.profile_id = UUID(active)
         _register_tools()
         self._workspace = RemoteWorkspace(
             host=self.agent_url,

package/skills/github-issue-to-pr/scripts/agent_conversation.py

@@ -104,16 +104,16 @@ class CloudConversations:
         return found[0] if found else None
 
     def start(self, conversation_id, profile_id, title: str, prompt: str) -> None:
-        self._request(
-            "POST",
-            "/api/v1/app-conversations",
-            {
-                "conversation_id": str(conversation_id),
-                "agent_profile_id": str(profile_id),
-                "title": title,
-                "initial_message": _user_message(prompt),
-            },
-        )
+        body = {
+            "conversation_id": str(conversation_id),
+            "title": title,
+            "initial_message": _user_message(prompt),
+        }
+        if profile_id is not None:
+            # Without one the API launches the member's active profile, or the
+            # default settings when none is active.
+            body["agent_profile_id"] = str(profile_id)
+        self._request("POST", "/api/v1/app-conversations", body)
 
     def agent_profiles(self) -> list[dict]:
         listing = self._request("GET", "/api/agent-profiles")
@@ -177,7 +177,10 @@ class AgentConversationDispatcher:
         # local Agent Canvas; elsewhere conversations go through the OpenHands API.
         self.agent_url = os.environ.get("AGENT_SERVER_URL")
         self.api_key = os.environ["SESSION_API_KEY"]
-        self.profile_id = UUID(os.environ["AUTOMATION_AGENT_PROFILE_ID"])
+        # The automation service sets the variable only when the automation
+        # names an agent profile; a run without one launches the default.
+        profile_id = os.environ.get("AUTOMATION_AGENT_PROFILE_ID")
+        self.profile_id = UUID(profile_id) if profile_id else None
         payload = json.loads(os.environ["AUTOMATION_EVENT_PAYLOAD"])
         self.automation_id = str(payload["automation_id"])
         self._cloud = None if self.agent_url else CloudConversations()
@@ -187,6 +190,18 @@ class AgentConversationDispatcher:
     def __enter__(self):
         if self._cloud:
             return self
+        if self.profile_id is None:
+            # The Agent Server starts a conversation from a profile, and always
+            # has an active one: its listing seeds `default` when the store is
+            # empty.
+            listing = self._agent_server_get("/api/agent-profiles")
+            active = (listing or {}).get("active_agent_profile_id")
+            if not active:
+                raise RuntimeError(
+                    "No agent profile is selected and the Agent Server has "
+                    "none active"
+                )
+            self.profile_id = UUID(active)
         _register_tools()
         self._workspace = RemoteWorkspace(
             host=self.agent_url,

package/skills/github-issue-triage/scripts/agent_conversation.py

@@ -104,16 +104,16 @@ class CloudConversations:
         return found[0] if found else None
 
     def start(self, conversation_id, profile_id, title: str, prompt: str) -> None:
-        self._request(
-            "POST",
-            "/api/v1/app-conversations",
-            {
-                "conversation_id": str(conversation_id),
-                "agent_profile_id": str(profile_id),
-                "title": title,
-                "initial_message": _user_message(prompt),
-            },
-        )
+        body = {
+            "conversation_id": str(conversation_id),
+            "title": title,
+            "initial_message": _user_message(prompt),
+        }
+        if profile_id is not None:
+            # Without one the API launches the member's active profile, or the
+            # default settings when none is active.
+            body["agent_profile_id"] = str(profile_id)
+        self._request("POST", "/api/v1/app-conversations", body)
 
     def agent_profiles(self) -> list[dict]:
         listing = self._request("GET", "/api/agent-profiles")
@@ -177,7 +177,10 @@ class AgentConversationDispatcher:
         # local Agent Canvas; elsewhere conversations go through the OpenHands API.
         self.agent_url = os.environ.get("AGENT_SERVER_URL")
         self.api_key = os.environ["SESSION_API_KEY"]
-        self.profile_id = UUID(os.environ["AUTOMATION_AGENT_PROFILE_ID"])
+        # The automation service sets the variable only when the automation
+        # names an agent profile; a run without one launches the default.
+        profile_id = os.environ.get("AUTOMATION_AGENT_PROFILE_ID")
+        self.profile_id = UUID(profile_id) if profile_id else None
         payload = json.loads(os.environ["AUTOMATION_EVENT_PAYLOAD"])
         self.automation_id = str(payload["automation_id"])
         self._cloud = None if self.agent_url else CloudConversations()
@@ -187,6 +190,18 @@ class AgentConversationDispatcher:
     def __enter__(self):
         if self._cloud:
             return self
+        if self.profile_id is None:
+            # The Agent Server starts a conversation from a profile, and always
+            # has an active one: its listing seeds `default` when the store is
+            # empty.
+            listing = self._agent_server_get("/api/agent-profiles")
+            active = (listing or {}).get("active_agent_profile_id")
+            if not active:
+                raise RuntimeError(
+                    "No agent profile is selected and the Agent Server has "
+                    "none active"
+                )
+            self.profile_id = UUID(active)
         _register_tools()
         self._workspace = RemoteWorkspace(
             host=self.agent_url,

package/skills/github-pr-reviewer/scripts/agent_conversation.py

@@ -104,16 +104,16 @@ class CloudConversations:
         return found[0] if found else None
 
     def start(self, conversation_id, profile_id, title: str, prompt: str) -> None:
-        self._request(
-            "POST",
-            "/api/v1/app-conversations",
-            {
-                "conversation_id": str(conversation_id),
-                "agent_profile_id": str(profile_id),
-                "title": title,
-                "initial_message": _user_message(prompt),
-            },
-        )
+        body = {
+            "conversation_id": str(conversation_id),
+            "title": title,
+            "initial_message": _user_message(prompt),
+        }
+        if profile_id is not None:
+            # Without one the API launches the member's active profile, or the
+            # default settings when none is active.
+            body["agent_profile_id"] = str(profile_id)
+        self._request("POST", "/api/v1/app-conversations", body)
 
     def agent_profiles(self) -> list[dict]:
         listing = self._request("GET", "/api/agent-profiles")
@@ -177,7 +177,10 @@ class AgentConversationDispatcher:
         # local Agent Canvas; elsewhere conversations go through the OpenHands API.
         self.agent_url = os.environ.get("AGENT_SERVER_URL")
         self.api_key = os.environ["SESSION_API_KEY"]
-        self.profile_id = UUID(os.environ["AUTOMATION_AGENT_PROFILE_ID"])
+        # The automation service sets the variable only when the automation
+        # names an agent profile; a run without one launches the default.
+        profile_id = os.environ.get("AUTOMATION_AGENT_PROFILE_ID")
+        self.profile_id = UUID(profile_id) if profile_id else None
         payload = json.loads(os.environ["AUTOMATION_EVENT_PAYLOAD"])
         self.automation_id = str(payload["automation_id"])
         self._cloud = None if self.agent_url else CloudConversations()
@@ -187,6 +190,18 @@ class AgentConversationDispatcher:
     def __enter__(self):
         if self._cloud:
             return self
+        if self.profile_id is None:
+            # The Agent Server starts a conversation from a profile, and always
+            # has an active one: its listing seeds `default` when the store is
+            # empty.
+            listing = self._agent_server_get("/api/agent-profiles")
+            active = (listing or {}).get("active_agent_profile_id")
+            if not active:
+                raise RuntimeError(
+                    "No agent profile is selected and the Agent Server has "
+                    "none active"
+                )
+            self.profile_id = UUID(active)
         _register_tools()
         self._workspace = RemoteWorkspace(
             host=self.agent_url,