Organization model.

User model with organizational relationships. This model satisfies the UserBase protocol via structural typing.

Role model for user permissions.

Conversation info which does not contain status.

Junction table for organization-member relationships with roles.

Persisted settings for OpenHands sessions. Agent settings (agent, llm, mcp, condenser) live in ``agent_settings``. Conversation settings (max

Model for storing provider tokens and custom secrets.

Message model for incoming webhook payloads from integrations. Note: This model is intended for INCOMING messages only. For outgoing messages

Registration for a plugin marketplace. Represents a marketplace that can be registered for plugin resolution. Marketplaces can be auto-loaded

Information about a sandbox.

User context for use in admin operations which allows access beyond the scope of a single user

Container for saved LLM configurations. Stores a named collection of ``LLM`` configurations plus the name of the currently active one (if any

Default implementation of GitService for Bitbucket data center integration. This is an extension point in OpenHands that allows applications to c

Specification for loading a plugin into a conversation. Extends SDK's PluginSource with user-provided plugin configuration parameters. Inheri

Assembled GitHub service class combining mixins by feature area. TODO: This doesn't seem a good candidate for the get_impl() pattern. What a

Represents an API key for a user.

Mock class for UserInfo to simulate user settings.

Extended SQLAppConversationInfoService with user and organization-based filtering and SAAS metadata handling.

URL to access some named service within the container.

Start conversation request object. Although a user can go directly to the sandbox and start conversations, they would need to manually supply

Request model for updating an organization. ``agent_settings_diff`` and ``conversation_settings_diff`` are sparse diffs that are deep-merged

Request model for updating organization app settings.

Payload for ``POST /api/organizations/provision-user``.

Assembled GitLab service class combining mixins by feature area. TODO: This doesn't seem a good candidate for the get_impl() pattern. What a

Model discovery backed by the bundled LiteLLM proxy. Inherits filtering, pagination, and provider logic from ``DefaultLLMModelService`` — onl

Store for CRUD operations on verified models. Follows the async pattern with db_session as an attribute.

Model discovery via litellm catalogue, optional Bedrock, and optional Ollama.

Configuration for an encryption key.

A template for creating a Sandbox (e.g: A Docker Image vs Container).

Request model for updating an organization member.

Resolver manager for Bitbucket Data Center webhook events.

Request body for saving a profile.

Object describing the start process for an app conversation. Because starting an app conversation can be slow (And can involve starting a sandbox

Exposed port within container to be matched to a free port on the host.

Persisted identity fields for a sandbox — no live runtime data. Contains only what is stored in the app server's own database (id and owner).

Model for user settings including the current user id.

Id-keyed collection of ``AgentProfile``\\ s + an org-default active pointer. Conforms to :class:`~openhands.sdk.profiles.AgentProfileStoreProtoco

Default implementation of GitService for Bitbucket integration. This is an extension point in OpenHands that allows applications to customize Bit

Exception for errors that should be communicated to the Slack user. This exception is caught by the centralized error handler in SlackManager,

LLM variant that rejects unknown fields. The base ``LLM`` model has ``extra='ignore'``, so typos and renamed keys silently disappear. For API

Testable concrete implementation of HTTPClient for unit testing.

Interface to old user settings service. Eventually we want to migrate this to use true database asyncio.

Stores collected telemetry metrics with upload tracking. Each record represents a single metrics collection event with associated metadata fo

App Conversation service which adds git specific functionality. Sets up repositories and installs hooks

Represents a Stripe billing session for credit purchases. Tracks the status of payment transactions and associated user information.

Device code for OAuth 2.0 Device Flow. This stores the device codes issued during the device authorization flow, along with their status and

Sandbox service built on docker. The Docker API does not currently support async operations, so some of these operations will block. Given th

Service for signing/verifying JWS tokens and encrypting/decrypting JWE tokens.

Store for organization app settings with injected db_session.

Raised when organization is not found or user doesn't have access.

User context for resolver operations that inherits from UserContext.

Error in Sandbox.

Generic auth error

Object representing the result of an event callback.

Shared settings updates that may be propagated to organization members. ``llm_api_key`` is typed as ``SecretStr`` so the raw value never ends up

SQL implementation of AppConversationInfoService focused on db operations. This allows storing a record of a conversation even after its sandbox

Request to switch a running conversation's LLM to a saved profile.

Resolved analytics context for a single user. Attributes: user_id: Raw user ID string (always set). consented: Whether the user

Dependency injector for docker sandbox services.

Model for storing maintenance tasks that perform background operations.

Stores persistent identity information for telemetry. This table is designed to contain exactly one row (enforced by database constraint) tha

Service for forwarding webhook events to the automation service. Optimized for high traffic with: - Redis caching for org claim lookups

Minimal mock of MaintenanceTaskRunner to verify initialization state.

Resolver manager for Bitbucket Cloud webhook events.

Raised when database operations fail.