Witness type enabling SRTP-based overloading for actor DID parameters. Allows functions like follow, block, muteUser, and unmuteUser to accept a Did, ProfileSummary, or Profile directly. This type is an implementation detail and should not be used directly.

Witness type enabling SRTP-based overloading for actor parameters. Allows functions like getProfile to accept Handle, Did, ProfileSummary, or Profile directly. This type is an implementation detail and should not be used directly.

A reference to an uploaded blob, as returned by com.atproto.repo.uploadBlob. Contains both the raw JSON (for passing back to the API in embeds) and typed convenience fields.

A reference to a block record, returned by Bluesky.block. Pass to Bluesky.unblock to undo.

High-level convenience methods for common Bluesky operations: posting, replying, liking, reposting, following, blocking, uploading blobs, and deleting records. All methods require an authenticated AtpAgent.

Convenience methods for Bluesky direct message (DM) and chat operations. Wraps the chat.bsky.convo.* XRPC endpoints with a simplified API. All methods require an authenticated AtpAgent. The chat proxy header (atproto-proxy: did:web:api.bsky.chat#bsky_chat) is applied automatically -- callers do not need to use withChatProxy manually.

A message in a chat conversation.

A communication template used by the Ozone moderation service.

A summary of a chat conversation.

Witness type enabling SRTP-based overloading for conversation parameters. Allows Chat functions to accept either a ConvoSummary or a string convo ID directly. This type is an implementation detail and should not be used directly.

A custom feed generator.

A single item in a feed or timeline.

Reason a post appeared in a feed.

A reference to a follow record, returned by Bluesky.follow. Pass to Bluesky.unfollow to undo.

AT Protocol identity resolution: DID documents, handle resolution, and bidirectional verification. Supports both did:plc (via PLC directory) and did:web (via .well-known) methods.

Errors that can occur during identity resolution.

Functions for working with ImageMime values.

Supported image MIME types for blob upload. Use the named cases for common image types, or Custom for other MIME types.

Image data for upload with a post.

Summary of the last message in a conversation.

A reference to a like record, returned by Bluesky.like. Pass to Bluesky.unlike to undo.

A reference to a list block record, returned by Bluesky.blockModList. Pass to Bluesky.unblockModList to undo.

A list with its member profiles, returned by getList.

A reference to a list item record, returned by Bluesky.addListItem.

A reference to a list record, returned by Bluesky.createList.

A user-created list (curate list, mod list, or reference list).

A type-safe union of moderation events that can be emitted via Ozone.emitEvent. Each case maps to the corresponding tools.ozone.moderation.defs#modEvent* type.

A notification from the user's notification feed.

The content of a notification, varying by kind.

Convenience methods for Ozone moderation tooling (tools.ozone.* endpoints). Wraps the generated XRPC types with a simplified, type-safe API.

Ozone endpoints require the agent to be proxied to the moderation service. Pass the labeler/moderation service DID via the serviceDid parameter. The proxy header (atproto-proxy: {did}#atproto_labeler) is applied automatically -- callers do not need to configure proxy headers manually.

The subject of an Ozone moderation action: either an account (by DID) or a record (by AT-URI + CID).

A paginated result containing a list of items and an optional cursor for the next page.

Embedded content in a post (images, video, link card, quoted post, or combination).

Extension properties on PostView for convenient access to post content.

An external link card attached to a post.

An image attached to a post.

Media within a record-with-media embed.

A reference to a specific version of a post record. Contains both the AT-URI (identifying the record) and the CID (identifying the exact version). Accepted by like, repost, and replyTo.

Witness type enabling SRTP-based overloading for post reference parameters. Allows functions like like, repost, and replyTo to accept either a PostRef or a TimelinePost directly. This type is an implementation detail and should not be used directly.

Witness type enabling SRTP-based overloading for post AT-URI parameters. Allows functions like deleteRecord, muteThread, getLikes, and getPostThread to accept an AtUri, PostRef, or TimelinePost directly. This type is an implementation detail and should not be used directly.

A video attached to a post.

A full user profile with engagement counts and relationship state. Maps from ProfileViewDetailed.

A lightweight profile summary used in feeds, notifications, and conversations. Maps from ProfileViewBasic / ProfileView.

A bi-directional relationship between the authenticated user and another actor.

The subject of a content report.

A reference to a repost record, returned by Bluesky.repost. Pass to Bluesky.unrepost to undo.

Rich text processing for Bluesky posts. Detects mentions, links, and hashtags in text and resolves them to facets with correct UTF-8 byte offsets as required by the AT Protocol.

A reference to a starter pack record, returned by Bluesky.createStarterPack.

A member of an Ozone moderation team.

The role of a team member in an Ozone moderation service.

Factory methods for creating domain objects with sensible defaults. Useful for testing consumers of the library without needing a live API. All parameters are optional; unspecified fields use deterministic default values.

A node in a post thread tree.

A post within a thread, with parent and reply context.

Type alias for the thread union returned by getPostThread. Simplifies pattern matching when working with thread responses.

A post with engagement counts and viewer state, used in feeds and timelines. Maps from PostView.

Result of an undo operation. Undone means the record was deleted; WasNotPresent means there was nothing to undo (e.g., the post was not liked).

Witness type enabling SRTP-based overloading for undo operations. Allows the generic Bluesky.undo function to accept any ref type (LikeRef, RepostRef, FollowRef, BlockRef). This type is an implementation detail and should not be used directly.

Supported video MIME types for video upload.