Get a single event from a shared conversation by conversation_id and event_id.

Get all sub-conversation IDs for a given parent conversation. Args: parent_conversation_id: The ID of the parent conversation

Get the permissions for a "super" role. A super role is the same role row (``owner`` / ``admin`` / ``member``) referenced via ``user.rol

Get the email for the current user

Get list of GitLab group paths that the user is a member of.

Get list of organization logins that the user is a member of.

Get the current web client configuration.

Return the keycloak ``user_id`` of the installer for ``webhook_uuid``, or None. Used by :class:`BitbucketManager` to resolve "who ins

Return True iff ``api_key`` carries a non-empty value. A ``SecretStr('')`` should report as *not set* — otherwise the UI tells the user a key

Inject an object. The state object may be used to store variables for reuse by other injectors, as injection operations may be nested.

Check if the access token is still valid. Returns: True if the access token exists and is not expired, False otherwise

Check if the device code has expired.

Check if a user has been synced to a specific audience. Args: email: The email address to check. audience_id: The Res

Iterate over paged result sets. Assumes that the results sets contain an array of result objects, and a next_page_id

Profile "filenames" (``<name>.json``) — used only for emptiness checks.

List available secret names (no raw values). Includes both custom secrets and provider tokens (e.g. github_token).

Gather instance + org + user marketplaces and compose them. ``settings_store`` must expose ``get_org_marketplaces(user_id)`` (all ``SettingsS

Load an offline token from the database.

Factory to create mock OrgGitClaim objects.

Create a system key name with the appropriate prefix. Format: __SYSTEM__:<name>

Check if invitation is expired and update status if needed. Args: invitation: The invitation to check Returns:

Dry-run resolve a profile's LLM/MCP references into a diagnostics report. Dangling refs are reported in the body (``valid=False``), not raised; t

Return whether the current user must still complete onboarding. Kept as a dedicated endpoint instead of riding on ``GET /api/v1/settings`` (t

Refresh a conversation. Grab ConversationInfo and all events from the agent server and make sure they exist in the app server. IMPORTANT

Create or update the OpenHands webhook in Jira DC via the admin API. Uses Jira Data Center's ``jira-webhook`` plugin REST API (the same one t

* Common resolver for schema field text (labels and descriptions). * Uses the i18n fallback chain: * 1. If schema provides an explicit translation k

Resolve a saved profile's LLM for activation on the agent server. Fills the provider-default ``base_url`` when the profile saved none, and fa

Return the SandboxSpecInfo to use for a new sandbox. Resolution order: 1. ``sandbox_spec_id`` (caller-explicit) — not found is a hard error.

Begin the process of resuming a sandbox. Return True if the sandbox exists and is being resumed or is already running. Return False i

Retrieve an API key by name for a specific user.

Search / List sandboxed conversations.

Search for sandboxed conversations.

Search providers with optional filtering and pagination. Args: query: Case-insensitive substring match on the provider name.

Get suggested tasks for the user. Returns a paginated list of suggested tasks including: - PRs owned by the user - Issues assigned to the

* @param {Client} client * @param {any} message * @param {Array<Transferable>} transferrables * @returns {Promise<any>}

Send message to integration from OpenHands server. Args: message: The message content to send (plain text string).

Send message/comment to Jira DC issue. Args: message: The message content to send (plain text string) issue_key: The

Send a message to Slack. Args: message: The message content. Can be a string (for simple text) or a dict wit

Set ``key`` to ``value``, splitting across sibling cookies if needed. Always clears trailing chunk indices that this write does not use, so a

Update customer and instance identification information. Args: customer_id: Unique identifier for the customer instan

Flush and shut down the PostHog client. Safe to call multiple times. SDK errors are logged, not raised.

Store repositories in DB and create user-repository mappings Args: repos: List of Repository objects to store user_id: User

Store an offline token in the database.

Sync OpenHands users to Resend. This function syncs users from the OpenHands database to a Resend audience. It tracks which users have been s

Track 'conversation created' event. Fired when a new conversation is started.

Update conversation_id when task-id transitions to real conversation-id. Returns the number of messages updated.

Update org-default settings for a specific organization.

Update the last poll time and optionally increase the interval. Args: increase_interval: If True, increase the current interval f

Update an existing webhook via ``PUT .../webhooks/{id}``. BBDC requires the full payload on PUT (not partial), so we send the same bo

Update user app settings. Only updates fields that are explicitly provided in update_data. Uses flush() - commit happens at request e

Update user's role in an organization.