@productcraft/social 0.1.1 → 0.3.0

package/dist/index.d.ts

@@ -13,7 +13,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List actors in a community. 50 per page by default (max 200) — paginate with the cursor returned in `pagination.next_cursor` while `pagination.has_more` is true. */
+        /** List actors in a community. 50 per page by default (max 200) — paginate with the cursor returned in `pagination.next_cursor` while `pagination.has_more` is true. Pass `?ids=<uuid,uuid,…>` (max 100) to batch-fetch specific actors instead — one hydration call for a screenful of ids; unknown ids are silently omitted and `pagination` is the exhausted shape (`next_cursor: null`). */
         get: operations["ActorController_list"];
         put?: never;
         /** Upsert an actor by external_id. Creates on first call, updates on subsequent calls with the same external_id. Idempotent on `(community, external_id)`. Note: omitted fields on a follow-up call are overwritten with the new body — pass every field you want to keep on each call. */
@@ -24,6 +24,40 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/batch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Bulk actor upsert (max 200 per call) — the import lane. Each item runs the exact single-upsert path; results come back per item with partial success (`201` even when some items fail — inspect `success` / `error` per entry). No wrapping transaction. */
+        post: operations["ActorController_batchUpsert"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/actors/by-external/batch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Batch-resolve external_ids to actors (max 200 per call). POST-only — external_ids are up to 256 chars and can't ride a querystring. Unknown ids come back in `missing[]` instead of failing the call. */
+        post: operations["ActorController_batchGetByExternal"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/actors/by-external/{externalId}": {
         parameters: {
             query?: never;
@@ -67,7 +101,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List actors this actor has blocked. */
+        /** List actors this actor has blocked. Pass `?expand=dst_actor` to nest each blocked actor's full row on the edge. */
         get: operations["EdgeController_listBlocks"];
         put?: never;
         post?: never;
@@ -178,7 +212,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List the actors who follow this actor. */
+        /** List the actors who follow this actor. Pass `?expand=src_actor` to nest each follower's full actor row on the edge — a followers screen renders from this one call. */
         get: operations["EdgeController_listFollowers"];
         put?: never;
         post?: never;
@@ -195,7 +229,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List the actors this actor follows. */
+        /** List the actors this actor follows. Pass `?expand=dst_actor` to nest each followee's full actor row on the edge (no N+1 hydration). */
         get: operations["EdgeController_listFollowing"];
         put?: never;
         post?: never;
@@ -322,7 +356,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List actors this actor has muted. */
+        /** List actors this actor has muted. Pass `?expand=dst_actor` to nest each muted actor's full row on the edge. */
         get: operations["EdgeController_listMutes"];
         put?: never;
         post?: never;
@@ -452,6 +486,26 @@ interface paths {
         patch: operations["NotificationController_markRead"];
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/{actorId}/post-state": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Batch viewer-state hydration: the actor's reactions, bookmark, repost, and poll-vote state for up to 200 posts in one call.
+         * @description Read-over-POST (the id list is too large for a query string) — no side effects, no Idempotency-Key needed. Renders a whole feed page's "liked by you" / saved / reposted / voted state with one request on top of the feed call.
+         */
+        post: operations["ViewerStateController_postState"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/actors/{actorId}/restricts": {
         parameters: {
             query?: never;
@@ -459,7 +513,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List actors this actor has restricted. */
+        /** List actors this actor has restricted. Pass `?expand=dst_actor` to nest each restricted actor's full row on the edge. */
         get: operations["EdgeController_listRestricts"];
         put?: never;
         post?: never;
@@ -529,6 +583,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/{srcActorId}/relationships": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Batched pairwise relationship lookup: does this actor follow / mute / block / restrict each of up to 100 others (and is it followed / blocked back)?
+         * @description One query resolves the seven pairwise flags for a whole profile header or member list — no paging of full edge lists, and `blocked_by` is visible without attempting a write and handling the 409. Unknown or cross-community ids resolve to all-false flags; the id list is de-duplicated preserving request order. Bounded input (max 100 ids), so the response has no pagination envelope.
+         */
+        get: operations["EdgeController_relationships"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/blocks": {
         parameters: {
             query?: never;
@@ -613,7 +687,7 @@ interface paths {
         /** List the caller's conversations in this community, most-recent-activity first. */
         get: operations["ConversationController_list"];
         put?: never;
-        /** Open a conversation. Default `kind="direct"` is the idempotent 1-on-1 path. Pass `kind="group"` with `actor_ids` for a multi-participant chat (always creates a new row; no idempotency for groups). */
+        /** Open a conversation. Default `kind="direct"` is the naturally-idempotent 1-on-1 path (get-or-create by participant pair). Pass `kind="group"` with `actor_ids` for a multi-participant chat — group creates always insert a new row, so pass an `Idempotency-Key` header to make group-create retries safe. */
         post: operations["ConversationController_create"];
         delete?: never;
         options?: never;
@@ -702,7 +776,7 @@ interface paths {
         /** List messages in the conversation. Default newest-first cursor. Pass `since` (encoded cursor of the last-seen message) to poll for newer messages instead. */
         get: operations["ConversationController_listMessages"];
         put?: never;
-        /** Send a message in the conversation. */
+        /** Send a message in the conversation. Pass an `Idempotency-Key` header to make retries safe — a retried send never delivers the message twice. */
         post: operations["ConversationController_send"];
         delete?: never;
         options?: never;
@@ -797,6 +871,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/counters": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Batch counters (max 100 actors per call) — render a member list with follower badges from ONE call instead of one per actor. Unknown actor_ids come back in `missing[]` instead of failing the read. */
+        get: operations["CounterController_getBatchCounters"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/discover-feed": {
         parameters: {
             query?: never;
@@ -848,6 +939,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/follows/batch": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Bulk follow creation (max 200 per call) — the graph-import lane. Each item runs the exact single-follow path (block checks, counters, idempotency), so a blocked pair fails ITS item with a 409 in `error` while the rest of the batch proceeds. `201` even with failures — inspect per-item results. Set `suppress_notifications: true` when importing an existing graph. */
+        post: operations["EdgeController_batchFollows"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/follows/{srcActorId}/{dstActorId}": {
         parameters: {
             query?: never;
@@ -926,7 +1034,7 @@ interface paths {
         /** List discoverable lists in this community. Public lists are visible to anyone; private lists surface only when `viewer_actor_id` is their owner. */
         get: operations["ActorListController_list"];
         put?: never;
-        /** Create a new list. Default visibility `private`. */
+        /** Create a new list. Default visibility `private`. List creation has no natural key (an owner can hold many same-named lists), so pass an `Idempotency-Key` header to make retries safe. */
         post: operations["ActorListController_create"];
         delete?: never;
         options?: never;
@@ -1049,7 +1157,7 @@ interface paths {
         /** List posts. Pass `author_id` to filter to a single author. 50/page (max 200), cursor-paginated. */
         get: operations["PostController_list"];
         put?: never;
-        /** Create a post on behalf of an actor. */
+        /** Create a post on behalf of an actor. Pass an `Idempotency-Key` header to make retries safe — replays return the original response with `Idempotent-Replay: true` for 24h. */
         post: operations["PostController_create"];
         delete?: never;
         options?: never;
@@ -1127,7 +1235,7 @@ interface paths {
         /** List comments on a post. Default returns top-level comments newest-first; pass `parent_id` to expand a thread (oldest-first). Pass `requester_id` so DM-style `author_only` replies surface only to the post-author and the comment-author pair. */
         get: operations["CommentController_list"];
         put?: never;
-        /** Add a comment on a post. Pass `parent_id` to reply; the depth is computed and capped by the community config. */
+        /** Add a comment on a post. Pass `parent_id` to reply; the depth is computed and capped by the community config. Pass an `Idempotency-Key` header to make retries safe. */
         post: operations["CommentController_create"];
         delete?: never;
         options?: never;
@@ -1253,7 +1361,8 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /** List reactions on a post, newest-first. Cursor encodes `(created_at, actor_id, type)` so multi-reaction-from-same-actor stays stable. Pass `type` to narrow to one reaction type. */
+        get: operations["PostReactionController_list"];
         put?: never;
         /** React to a post. Idempotent: re-posting the same (actor, type) returns the existing edge with `created: false`. */
         post: operations["PostReactionController_react"];
@@ -1499,10 +1608,10 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** Read the community's active webhook (or null). */
-        get: operations["WebhookController_getActive"];
+        /** List the community's webhooks — disabled rows included, so an auto-disabled subscriber stays discoverable. */
+        get: operations["WebhookController_list"];
         put?: never;
-        /** Create the community webhook. One active subscriber per community. Returns the signing secret ONCE — store it. */
+        /** Create a community webhook. Multiple subscribers per community are supported (cap 10). Returns the signing secret ONCE — store it. Pass an `Idempotency-Key` header so a retried create replays the SAME secret instead of minting a duplicate subscriber. */
         post: operations["WebhookController_create"];
         delete?: never;
         options?: never;
@@ -1525,7 +1634,7 @@ interface paths {
         delete: operations["WebhookController_delete"];
         options?: never;
         head?: never;
-        /** Update webhook url + subscribed event types. */
+        /** Update webhook url, subscribed event types, or disabled state. `{ "disabled": false }` is the re-enable path after an auto-disable — no secret rotation required. */
         patch: operations["WebhookController_update"];
         trace?: never;
     };
@@ -1546,6 +1655,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/webhooks/{webhookId}/deliveries/{deliveryId}/redeliver": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Re-publish a past delivery from its stored request body. Async (202). The payload is byte-identical to the original (same event id), so subscriber-side event-id dedupe treats it as a redelivery. */
+        post: operations["WebhookController_redeliver"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/webhooks/{webhookId}/rotate-secret": {
         parameters: {
             query?: never;
@@ -1555,7 +1681,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Rotate the signing secret. Also clears any auto-disable flag. Returns the new secret ONCE. */
+        /** Rotate the signing secret. Also clears any auto-disable flag. Returns the new secret ONCE. Pass an `Idempotency-Key` header so a retried rotate replays the SAME new secret instead of rotating twice. */
         post: operations["WebhookController_rotateSecret"];
         delete?: never;
         options?: never;
@@ -1563,6 +1689,40 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/webhooks/{webhookId}/test": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Enqueue a `ping` test delivery. Async (202): the dispatch worker signs and POSTs it exactly like a real event — SSRF guard, TLS, HMAC signature and all. Watch the deliveries list for the outcome. */
+        post: operations["WebhookController_testPing"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/webhook-event-types": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List the webhook event-type catalog. Static metadata, no auth required. Create/update webhooks reject anything not in this list with a 400. */
+        get: operations["WebhookEventTypesController_list"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/workspaces/{workspaceId}/communities": {
         parameters: {
             query?: never;
@@ -1573,7 +1733,7 @@ interface paths {
         /** List communities in a workspace */
         get: operations["CommunityController_list"];
         put?: never;
-        /** Create an social community. `app_id` is optional — when supplied Social connects the community to an Auth app and refuses if the app belongs to a different workspace (cross-tenant gate) or is already connected. Omit `app_id` for a standalone community (no Auth integration; the customer manages actor identity). */
+        /** Create an social community. `app_id` is optional — when supplied Social connects the community to an Auth app and refuses if the app belongs to a different workspace (cross-tenant gate) or is already connected. Omit `app_id` for a standalone community (no Auth integration; the customer manages actor identity). Pass an `Idempotency-Key` header to make retries safe. */
         post: operations["CommunityController_create"];
         delete?: never;
         options?: never;
@@ -1626,7 +1786,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Apply a shadow ban to an actor. The actor sees their own content normally; everyone else sees nothing from them. Pass `duration_hours` for a timed ban or omit for indefinite. */
+        /** Apply a shadow ban to an actor. The actor sees their own content normally; everyone else sees nothing from them. Pass `duration_hours` for a timed ban or omit for indefinite. Pass an `Idempotency-Key` header so a retried timed ban doesn't restart the clock. */
         post: operations["ModerationAdminController_shadowBan"];
         /** Remove a shadow ban. No-op if not currently shadow-banned. */
         delete: operations["ModerationAdminController_unshadow"];
@@ -1712,7 +1872,7 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Apply a moderation action to a flag. Records an audit entry and updates the target post/comment status. */
+        /** Apply a moderation action to a flag. Records an audit entry and updates the target post/comment status. Pass an `Idempotency-Key` header so a retried request records ONE audit entry, not two. */
         post: operations["ModerationAdminController_act"];
         delete?: never;
         options?: never;
@@ -1740,6 +1900,12 @@ interface paths {
 }
 interface components {
     schemas: {
+        ActOnFlagResponseDto: {
+            /** @description The flag after the action (status flipped to actioned/dismissed for punitive/dismiss actions; reversals re-resolve it too). */
+            flag: components["schemas"]["FlagResponseDto"];
+            /** @description The audit row this action recorded. */
+            moderation_action: components["schemas"]["ModerationActionResponseDto"];
+        };
         ActorCountersResponseDto: {
             /**
              * @description Actor UUID.
@@ -1827,11 +1993,62 @@ interface components {
             list_id: string;
         };
         ActorListResponseDto: {
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Optional description.
+             * @example Curated tech accounts I follow.
+             */
+            description: string | null;
+            /**
+             * @description List UUID.
+             * @example llllllll-0000-0000-0000-000000000001
+             */
+            id: string;
+            /**
+             * @description Current member count.
+             * @example 12
+             */
+            member_count: number;
+            /**
+             * @description List display name.
+             * @example Tech news
+             */
+            name: string;
+            /**
+             * @description List owner — social actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            owner_id: string;
+            /**
+             * @description ISO timestamp.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            updated_at: string;
+            /**
+             * @description public = discoverable; private = owner-only.
+             * @example public
+             * @enum {string}
+             */
+            visibility: "public" | "private";
+        };
+        ActorPageResponseDto: {
             data: components["schemas"]["ActorResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
         ActorResponseDto: {
-            /** @description Avatar URL. */
+            /**
+             * @description Avatar URL.
+             * @example https://cdn.example.com/avatars/ada.png
+             */
             avatar_url: string | null;
             /**
              * @description Owning community UUID.
@@ -1839,43 +2056,46 @@ interface components {
              */
             community_id: string;
             /**
-             * @description ISO timestamp.
+             * @description ISO timestamp the row was inserted.
              * @example 2026-05-01T12:00:00.000Z
              */
             created_at: string;
             /**
              * @description Display name.
-             * @example Alice
+             * @example Ada Lovelace
              */
             display_name: string | null;
             /**
-             * @description Customer-supplied stable id.
-             * @example user-42
+             * @description Customer-supplied stable identifier (your user id).
+             * @example user_abc123
              */
             external_id: string;
             /**
-             * @description Actor UUID.
-             * @example aaaaaaaa-0000-0000-0000-000000000001
+             * @description Social actor UUID.
+             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
              */
             id: string;
-            /** @description Free-form metadata. */
+            /**
+             * @description Free-form metadata blob.
+             * @example {
+             *       "tier": "pro"
+             *     }
+             */
             metadata: Record<string, never>;
-            /** @description ISO timestamp the shadow ban was applied, or null. */
-            shadow_banned_at: string | null;
-            /** @description Moderator note attached to the ban. */
-            shadow_banned_reason: string | null;
-            /** @description ISO timestamp the shadow ban auto-expires, or null for indefinite. */
-            shadow_banned_until: string | null;
-            /** @enum {string} */
+            /**
+             * @description Lifecycle status. `suspended` is moderator-applied via PATCH `status=suspended`; `deleted` is soft-deletion. Shadow-banning is a separate moderation mechanism that does not change `status`.
+             * @example active
+             * @enum {string}
+             */
             status: "active" | "suspended" | "deleted";
             /**
-             * @description ISO timestamp.
+             * @description ISO timestamp of the last update.
              * @example 2026-05-01T12:00:00.000Z
              */
             updated_at: string;
         };
         ActorSearchHitDto: {
-            actor: components["schemas"]["SearchActorResponseDto"];
+            actor: components["schemas"]["ActorResponseDto"];
             /**
              * @description PG `ts_rank` score on the (display_name A, external_id B, bio C) tsvector. Higher = more relevant.
              * @example 0.6079
@@ -1886,6 +2106,17 @@ interface components {
             /** @description Up to `limit` (default 20, max 50) ranked hits. Not paginated in v1; results are bounded by `limit`. */
             data: components["schemas"]["ActorSearchHitDto"][];
         };
+        ActorsByExternalBatchResponseDto: {
+            /** @description Actors found, in request order (after de-duplication). */
+            data: components["schemas"]["ActorResponseDto"][];
+            /**
+             * @description external_ids with no actor in this community.
+             * @example [
+             *       "user_ghost"
+             *     ]
+             */
+            missing: string[];
+        };
         AddCommentReactionResponseDto: {
             /**
              * @description `true` on first call; `false` on idempotent retry.
@@ -1901,6 +2132,18 @@ interface components {
              */
             reaction_counts: Record<string, never>;
         };
+        AddListMemberDto: {
+            /**
+             * @description New member — social actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            actor_id: string;
+            /**
+             * @description Caller — social actor UUID. Must equal the list owner.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            caller_actor_id: string;
+        };
         AddMemberDto: {
             /**
              * @description The new member — social actor UUID.
@@ -1939,48 +2182,151 @@ interface components {
             data: components["schemas"]["ModerationActionResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
-        BookmarkListResponseDto: {
-            data: components["schemas"]["BookmarkResponseDto"][];
-            pagination: components["schemas"]["PaginationResponseDto"];
-        };
-        BookmarkResponseDto: {
+        BatchActorResultDto: {
+            /** @description The upserted actor — present on success. */
+            actor?: components["schemas"]["ActorResponseDto"];
             /**
-             * @description Social actor UUID who saved the post.
-             * @example aaaaaaaa-0000-0000-0000-000000000001
+             * @description `true` if this item inserted a new row, `false` on an update of an existing external_id. Present on success.
+             * @example true
              */
-            actor_id: string;
+            created?: boolean;
+            /** @description The error this item would have returned as a standalone call — present on failure. */
+            error?: components["schemas"]["ErrorResponseDto"];
             /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             * @description Position of this result in the request array.
+             * @example 0
              */
-            community_id: string;
+            index: number;
             /**
-             * @description ISO timestamp the bookmark was created.
-             * @example 2026-05-01T12:00:00.000Z
+             * @description `true` when this item was upserted; `false` when it failed (see `error`).
+             * @example true
              */
-            created_at: string;
+            success: boolean;
+        };
+        BatchActorsResponseDto: {
+            /** @description One result per input item, same order. */
+            data: components["schemas"]["BatchActorResultDto"][];
             /**
-             * @description Saved post UUID.
-             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
+             * @description Count of failed items.
+             * @example 1
              */
-            post_id: string;
-        };
-        BookmarkToggleResponseDto: {
-            bookmark: components["schemas"]["BookmarkResponseDto"];
+            failed: number;
             /**
-             * @description `true` on first call (row inserted); `false` on idempotent retry of an existing bookmark.
-             * @example true
+             * @description Count of successful items.
+             * @example 199
              */
-            created: boolean;
+            succeeded: number;
         };
-        CastVoteDto: {
+        BatchCountersResponseDto: {
+            /** @description Counters for each actor found, in `actor_ids` order (after de-duplication). */
+            data: components["schemas"]["ActorCountersResponseDto"][];
             /**
-             * @description Voter social actor UUID.
-             * @example aaaaaaaa-0000-0000-0000-000000000002
+             * @description actor_ids with no actor in this community.
+             * @example []
              */
-            actor_id: string;
+            missing: string[];
+        };
+        BatchExternalIdsDto: {
             /**
-             * @description Zero-based index into post.attributes.poll.options.
+             * @description external_ids to resolve, 1–200 items (POST body — 256-char ids can't ride a querystring). Duplicates are de-duplicated.
+             * @example [
+             *       "user_abc123",
+             *       "user_def456"
+             *     ]
+             */
+            external_ids: string[];
+        };
+        BatchFollowResultDto: {
+            /**
+             * @description `true` if this item created a new edge, `false` on an idempotent retry of an existing follow. Present on success.
+             * @example true
+             */
+            created?: boolean;
+            /** @description The follow edge — present on success. */
+            edge?: components["schemas"]["EdgeResponseDto"];
+            /** @description The error this item would have returned as a standalone call (e.g. 409 block in place, 422 self-follow, 404 unknown actor) — present on failure. */
+            error?: components["schemas"]["ErrorResponseDto"];
+            /**
+             * @description Position of this result in the request array.
+             * @example 0
+             */
+            index: number;
+            /**
+             * @description `true` when this follow was created (or already existed); `false` when it failed (see `error`).
+             * @example true
+             */
+            success: boolean;
+        };
+        BatchFollowsDto: {
+            /** @description Follow edges to create, in order. 1–200 items; each item follows the single-follow body exactly. */
+            follows: components["schemas"]["ActorEdgeDto"][];
+            /**
+             * @description Import lane: when `true`, the per-item `edge.follow.created` fan-out (follow notifications AND webhooks) is skipped for this batch. Follower/following counters still update. Use when importing an existing graph so long-standing followers don't get "X followed you" notifications.
+             * @default false
+             * @example true
+             */
+            suppress_notifications: boolean;
+        };
+        BatchFollowsResponseDto: {
+            /** @description One result per input item, same order. */
+            data: components["schemas"]["BatchFollowResultDto"][];
+            /**
+             * @description Count of failed items.
+             * @example 1
+             */
+            failed: number;
+            /**
+             * @description Count of successful items.
+             * @example 4999
+             */
+            succeeded: number;
+        };
+        BatchUpsertActorsDto: {
+            /** @description Actors to upsert, in order. 1–200 items; each item follows the single-upsert body exactly. */
+            actors: components["schemas"]["UpsertActorDto"][];
+        };
+        BookmarkListResponseDto: {
+            data: components["schemas"]["BookmarkResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        BookmarkResponseDto: {
+            /**
+             * @description Social actor UUID who saved the post.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id: string;
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp the bookmark was created.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Saved post UUID.
+             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
+             */
+            post_id: string;
+        };
+        BookmarkToggleResponseDto: {
+            bookmark: components["schemas"]["BookmarkResponseDto"];
+            /**
+             * @description `true` on first call (row inserted); `false` on idempotent retry of an existing bookmark.
+             * @example true
+             */
+            created: boolean;
+        };
+        CastVoteDto: {
+            /**
+             * @description Voter social actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            actor_id: string;
+            /**
+             * @description Zero-based index into post.attributes.poll.options.
              * @example 1
              */
             option_index: number;
@@ -2019,7 +2365,7 @@ interface components {
         };
         CloseFriendsListResponse: {
             data: components["schemas"]["CloseFriendResponse"][];
-            pagination: components["schemas"]["CursorPagination"];
+            pagination: components["schemas"]["PaginationResponseDto"];
         };
         CommentListResponseDto: {
             data: components["schemas"]["CommentResponseDto"][];
@@ -2107,11 +2453,18 @@ interface components {
              */
             post_id: string;
             /**
-             * @description Lifecycle status. `removed` rows are hidden from public reads.
+             * @description Map of reaction type to count, denormalised on the comment row in lock-step with the comment-reaction writes.
+             * @example {
+             *       "like": 2
+             *     }
+             */
+            reaction_counts: Record<string, never>;
+            /**
+             * @description Lifecycle status. `pending_approval` = held by restricted-commenter pre-moderation; list endpoints surface these rows only to the comment author and the post-author (who publishes them via POST :commentId/approve). `removed` rows are hidden from public reads.
              * @example published
              * @enum {string}
              */
-            status: "published" | "hidden" | "removed";
+            status: "published" | "hidden" | "removed" | "pending_approval";
             /**
              * @description ISO timestamp of the last update.
              * @example 2026-05-01T12:00:00.000Z
@@ -2171,6 +2524,48 @@ interface components {
              */
             total_posts: number;
         };
+        CommunityRankingSettingsDto: {
+            /**
+             * @description Ranked-feed candidate window in days — posts older than this are not scored. Strictly positive finite number.
+             * @default 30
+             * @example 30
+             */
+            candidate_window_days: number;
+            /**
+             * @description Recency half-life in hours for the ranked feed. Strictly positive finite number.
+             * @default 24
+             * @example 24
+             */
+            half_life_hours: number;
+            /** @description Per-signal weights for the ranked feed. Each key falls back to its default independently. */
+            weights?: components["schemas"]["CommunityRankingWeightsDto"];
+        };
+        CommunityRankingWeightsDto: {
+            /**
+             * @description Engagement signal weight (log-scaled comments + reactions). Non-negative finite number.
+             * @default 0.6
+             * @example 0.6
+             */
+            engagement: number;
+            /**
+             * @description Follow-graph bias weight. Non-negative finite number.
+             * @default 0.4
+             * @example 0.4
+             */
+            follow_bias: number;
+            /**
+             * @description Recency signal weight (exponential decay). Non-negative finite number; anything else falls back to the default.
+             * @default 1
+             * @example 1
+             */
+            recency: number;
+            /**
+             * @description Self-author boost weight (keeps the viewer's own posts visible). Non-negative finite number.
+             * @default 0.2
+             * @example 0.2
+             */
+            self_boost: number;
+        };
         CommunityResponseDto: {
             /**
              * @description Auth app UUID this community wraps; `null` for standalone communities.
@@ -2203,12 +2598,12 @@ interface components {
              */
             id: string;
             /**
-             * @description Per-community settings blob (ranking, max_comment_depth, auto_hide_flag_threshold, reaction_types).
+             * @description Per-community settings blob. See CommunitySettingsDto for every key the service reads; unrecognized keys are stored and returned unchanged but not consumed.
              * @example {
              *       "max_comment_depth": 3
              *     }
              */
-            settings: Record<string, never>;
+            settings: components["schemas"]["CommunitySettingsDto"];
             /**
              * @description URL-friendly community slug.
              * @example my-product-community
@@ -2231,6 +2626,34 @@ interface components {
              */
             workspace_id: string;
         };
+        CommunitySettingsDto: {
+            /**
+             * @description Distinct-reporter count at which a flagged post/comment is auto-hidden. Integer 0..1000; floored. Read by the moderation flag pipeline.
+             * @default 3
+             * @example 3
+             */
+            auto_hide_flag_threshold: number;
+            /**
+             * @description Minutes after publication during which a post body/title may still be edited (`EDIT_WINDOW_EXPIRED` afterwards). Strictly positive finite number. Drafts edit freely.
+             * @default 30
+             * @example 30
+             */
+            edit_window_minutes: number;
+            /**
+             * @description Maximum comment thread depth (0 = flat). Integer 0..10; floored; out-of-bounds falls back to the default. Replying past the cap returns 409.
+             * @default 3
+             * @example 3
+             */
+            max_comment_depth: number;
+            /**
+             * @description Maximum participants in a group conversation. Integer 2..200; floored. Exceeding it returns 409 on create / member add.
+             * @default 50
+             * @example 50
+             */
+            max_group_conversation_size: number;
+            /** @description Ranked-feed tuning (weights, half-life, candidate window). Read at query time by the actor feed, list feeds, and the discover feed. */
+            ranking?: components["schemas"]["CommunityRankingSettingsDto"];
+        };
         ConversationAdminListResponseDto: {
             data: components["schemas"]["ConversationAdminResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -2435,8 +2858,8 @@ interface components {
              * @example My Product Community
              */
             display_name: string;
-            /** @description Per-community settings blob (ranking, max_comment_depth, auto_hide_flag_threshold). */
-            settings?: Record<string, never>;
+            /** @description Per-community settings blob. Supported keys are typed on CommunitySettingsDto; unrecognized keys are stored verbatim but not consumed. */
+            settings?: components["schemas"]["CommunitySettingsDto"];
             /**
              * @description URL-friendly community slug. Lowercase letters, digits, and hyphens (3-64 chars).
              * @example my-product-community
@@ -2514,6 +2937,20 @@ interface components {
              */
             target_kind: "post" | "comment";
         };
+        CreateFlagResponseDto: {
+            /**
+             * @description `true` when this flag pushed the target over the community's `auto_hide_flag_threshold` and the target was auto-hidden as a side effect.
+             * @example false
+             */
+            auto_hidden: boolean;
+            /**
+             * @description `true` when this call inserted a new flag; `false` when de-duplicated to an existing open flag from the same reporter on the same target.
+             * @example true
+             */
+            created: boolean;
+            /** @description The flag row (existing open flag on de-duplicated retry). */
+            flag: components["schemas"]["FlagResponseDto"];
+        };
         CreateHashtagFollowDto: {
             /**
              * @description Lowercase tag (without `#`). Must already exist in the community directory.
@@ -2618,19 +3055,19 @@ interface components {
              */
             created: boolean;
             /** @description The newly-created (or existing) repost post row. */
-            repost: components["schemas"]["RepostPostResponseDto"];
+            repost: components["schemas"]["PostResponseDto"];
             /** @description The source post, with refreshed `repost_count`. */
-            source: components["schemas"]["RepostPostResponseDto"];
+            source: components["schemas"]["PostResponseDto"];
         };
         CreateWebhookDto: {
             /**
-             * @description Event types to subscribe to. Currently supported: `post.created`, `post.updated`, `post.reaction.created`, `repost.created`, `comment.created`, `comment.updated`, `comment.reaction.created`, `edge.follow.created`.
+             * @description Event types to subscribe to. Unknown values are rejected with a 400 naming the valid set — see GET /v1/webhook-event-types.
              * @example [
              *       "post.created",
              *       "comment.created"
              *     ]
              */
-            event_types: string[];
+            event_types: ("post.created" | "post.updated" | "post.deleted" | "post.reaction.created" | "repost.created" | "comment.created" | "comment.updated" | "comment.deleted" | "comment.reaction.created" | "edge.follow.created" | "edge.follow.deleted" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created")[];
             /**
              * @description Subscriber URL. Must be `https://`.
              * @example https://example.com/webhooks/social
@@ -2664,13 +3101,13 @@ interface components {
              */
             disabled_reason: string | null;
             /**
-             * @description Subscribed event types. Each item is one of the social event names (e.g. `post.created`, `comment.created`, `edge.follow.created`).
+             * @description Subscribed event types. Each item is one of the social event names — see GET /v1/webhook-event-types for the live catalog.
              * @example [
              *       "post.created",
              *       "comment.created"
              *     ]
              */
-            event_types: string[];
+            event_types: ("post.created" | "post.updated" | "post.deleted" | "post.reaction.created" | "repost.created" | "comment.created" | "comment.updated" | "comment.deleted" | "comment.reaction.created" | "edge.follow.created" | "edge.follow.deleted" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created")[];
             /**
              * @description Webhook UUID.
              * @example wwwwwwww-0000-0000-0000-000000000001
@@ -2707,18 +3144,6 @@ interface components {
              */
             url: string;
         };
-        CursorPagination: {
-            /**
-             * @description Whether more pages exist after this one.
-             * @example false
-             */
-            has_more: boolean;
-            /**
-             * @description Opaque base64url cursor; null when no further pages.
-             * @example null
-             */
-            next_cursor: string | null;
-        };
         DeleteActorListDto: {
             /**
              * @description Caller — social actor UUID. Must equal the list owner.
@@ -2733,13 +3158,60 @@ interface components {
              */
             sender_id: string;
         };
+        DeliveryJobResponseDto: {
+            /**
+             * @description Delivery attempts made so far.
+             * @example 0
+             */
+            attempt_count: number;
+            /**
+             * @description ISO timestamp.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Stable event id (carried in the request body as `id`; stable across retries and redelivers).
+             * @example evt_…
+             */
+            event_id: string;
+            /**
+             * @description Event type. `ping` for test deliveries.
+             * @example post.created
+             */
+            event_type: string;
+            /** @description Delivery job UUID. */
+            id: string;
+            /**
+             * @description Error from the most recent failed attempt. Null before the first failure.
+             * @example null
+             */
+            last_error: string | null;
+            /**
+             * @description ISO timestamp of the next scheduled attempt (backoff: 1m, 5m, 30m, 2h, 6h, 24h).
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            next_attempt_at: string;
+            /**
+             * @description Job state.
+             * @example pending
+             * @enum {string}
+             */
+            status: "pending" | "delivering" | "succeeded" | "exhausted" | "canceled";
+            /**
+             * @description ISO timestamp.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            updated_at: string;
+            /** @description Webhook UUID the job targets. */
+            webhook_id: string;
+        };
         DeliveryListResponseDto: {
             data: components["schemas"]["DeliveryResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
         DeliveryResponseDto: {
             /**
-             * @description Attempt number. Always 1 in v1 (no retry).
+             * @description Attempt number, 1-based. Increments per retry along the backoff schedule (1m, 5m, 30m, 2h, 6h, 24h — 7 attempts total).
              * @example 1
              */
             attempt_number: number;
@@ -2766,10 +3238,10 @@ interface components {
             /** @description Delivery row UUID. */
             id: string;
             /**
-             * @description Total round-trip time in ms.
+             * @description Total round-trip time in ms. Null on transport-level failure.
              * @example 67
              */
-            latency_ms: number;
+            latency_ms: number | null;
             /**
              * @description Signed request body that was sent.
              * @example {}
@@ -2843,6 +3315,13 @@ interface components {
              * @enum {string}
              */
             kind: "text" | "image" | "video" | "audio" | "system";
+            /**
+             * @description Map of reaction type to count, denormalised on the message row in lock-step with the DM-reaction writes.
+             * @example {
+             *       "like": 1
+             *     }
+             */
+            reaction_counts: Record<string, never>;
             /**
              * @description Threaded inline reply target.
              * @example null
@@ -2968,6 +3447,13 @@ interface components {
              * @enum {string}
              */
             kind: "text" | "image" | "video" | "audio" | "system";
+            /**
+             * @description Map of reaction type to count, denormalised on the message row in lock-step with the DM-reaction writes.
+             * @example {
+             *       "like": 1
+             *     }
+             */
+            reaction_counts: Record<string, never>;
             /**
              * @description Threaded inline reply target.
              * @example null
@@ -2980,95 +3466,8 @@ interface components {
             sender_id: string;
         };
         DraftListResponseDto: {
-            data: components["schemas"]["DraftPostResponseDto"][];
-            pagination: components["schemas"]["PaginationResponseDto"];
-        };
-        DraftPostResponseDto: {
-            /**
-             * @description Author actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
-             */
-            actor_id: string;
-            /**
-             * @description Free-form attributes blob.
-             * @example {}
-             */
-            attributes: Record<string, never>;
-            /**
-             * @description Body draft text.
-             * @example WIP — half a thought…
-             */
-            body: string | null;
-            /**
-             * @description Always 0 for drafts.
-             * @example 0
-             */
-            comment_count: number;
-            /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
-             */
-            community_id: string;
-            /**
-             * @description ISO timestamp the draft was created.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            created_at: string;
-            /**
-             * @description Optional expires_at carried into the published post.
-             * @example null
-             */
-            expires_at: string | null;
-            /**
-             * @description Draft post UUID.
-             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
-             */
-            id: string;
-            /**
-             * @description Free-form post kind.
-             * @example text
-             */
-            kind: string;
-            /**
-             * @description Pinned flag carried into the published post.
-             * @example false
-             */
-            pinned: boolean;
-            /**
-             * @description Empty for drafts (engagement begins at publish).
-             * @example {}
-             */
-            reaction_counts: Record<string, never>;
-            /**
-             * @description Always 'draft' for this endpoint.
-             * @example draft
-             * @enum {string}
-             */
-            status: "draft";
-            /**
-             * @description Optional title.
-             * @example null
-             */
-            title: string | null;
-            /**
-             * @description ISO timestamp of the last update.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            updated_at: string;
-            /**
-             * @description Optional URL.
-             * @example null
-             */
-            url: string | null;
-            /**
-             * @description Visibility scope chosen at draft time. Applies once promoted to published.
-             * @example public
-             * @enum {string}
-             */
-            visibility: "public" | "followers" | "close_friends" | "private";
-        };
-        EdgeListResponseDto: {
-            data: components["schemas"]["EdgeResponseDto"][];
+            /** @description Draft post rows — status is always 'draft' on this endpoint. */
+            data: components["schemas"]["PostResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
         EdgeResponseDto: {
@@ -3098,10 +3497,11 @@ interface components {
              */
             id: string;
             /**
-             * @description Edge kind. `follow`, `mute`, `block`, `save`, or `reaction:<type>` for post reactions.
+             * @description Edge kind. The actor-edge routes emit exactly these four; post reactions and bookmarks have their own response shapes.
              * @example follow
+             * @enum {string}
              */
-            kind: string;
+            kind: "follow" | "mute" | "block" | "restrict";
             /**
              * @description Free-form payload stored on the edge (e.g. mute reason).
              * @example {}
@@ -3113,23 +3513,6 @@ interface components {
              */
             src_actor_id: string;
         };
-        ErrorResponse: {
-            /**
-             * @description Stable error code.
-             * @example NOT_FOUND
-             */
-            code?: string;
-            /**
-             * @description Human-readable error message.
-             * @example Post not found
-             */
-            message: Record<string, never>;
-            /**
-             * @description HTTP status code echoed in the body.
-             * @example 404
-             */
-            statusCode: number;
-        };
         ErrorResponseDto: {
             /**
              * @description Stable error code for programmatic handling. Optional — newer routes set it where the message alone is ambiguous.
@@ -3147,94 +3530,8 @@ interface components {
              */
             statusCode: number;
         };
-        FeedPostResponseDto: {
-            /**
-             * @description Author actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
-             */
-            actor_id: string;
-            /**
-             * @description Free-form attributes blob.
-             * @example {}
-             */
-            attributes: Record<string, never>;
-            /**
-             * @description Body text/markdown.
-             * @example Stories are live!
-             */
-            body: string | null;
-            /**
-             * @description Live denormalised comment count.
-             * @example 4
-             */
-            comment_count: number;
-            /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
-             */
-            community_id: string;
-            /**
-             * @description ISO timestamp the post was created.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            created_at: string;
-            /**
-             * @description ISO timestamp; null = no expiry.
-             * @example null
-             */
-            expires_at: string | null;
-            /**
-             * @description Post UUID.
-             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
-             */
-            id: string;
-            /**
-             * @description Free-form post kind.
-             * @example text
-             */
-            kind: string;
-            /**
-             * @description Pinned for highlights.
-             * @example false
-             */
-            pinned: boolean;
-            /**
-             * @description Live denormalised reaction counts.
-             * @example {
-             *       "like": 12
-             *     }
-             */
-            reaction_counts: Record<string, never>;
-            /**
-             * @description Lifecycle status. Feed only returns `published`.
-             * @example published
-             * @enum {string}
-             */
-            status: "published" | "hidden" | "removed";
-            /**
-             * @description Optional title.
-             * @example null
-             */
-            title: string | null;
-            /**
-             * @description ISO timestamp of the last update.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            updated_at: string;
-            /**
-             * @description Optional URL.
-             * @example null
-             */
-            url: string | null;
-            /**
-             * @description Visibility scope; the feed is already filtered to what the requester can see.
-             * @example public
-             * @enum {string}
-             */
-            visibility: "public" | "followers" | "close_friends" | "private";
-        };
         FeedResponseDto: {
-            data: components["schemas"]["FeedPostResponseDto"][];
+            data: components["schemas"]["PostResponseDto"][];
             /** @description Cursor encodes `(score, id)` for `ranked` feeds and `(created_at, id)` for `chronological` feeds. Cursors are NOT interchangeable between modes. */
             pagination: components["schemas"]["PaginationResponseDto"];
         };
@@ -3291,6 +3588,55 @@ interface components {
              */
             updated_at: string;
         };
+        FollowerEdgeListResponseDto: {
+            data: components["schemas"]["FollowerEdgeResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        FollowerEdgeResponseDto: {
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp the edge was created.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Destination actor UUID (for actor edges).
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            dst_actor_id: string | null;
+            /**
+             * @description Destination post UUID (for reaction / save edges).
+             * @example null
+             */
+            dst_post_id: string | null;
+            /**
+             * @description Edge UUID.
+             * @example eeeeeeee-0000-0000-0000-000000000001
+             */
+            id: string;
+            /**
+             * @description Edge kind. The actor-edge routes emit exactly these four; post reactions and bookmarks have their own response shapes.
+             * @example follow
+             * @enum {string}
+             */
+            kind: "follow" | "mute" | "block" | "restrict";
+            /**
+             * @description Free-form payload stored on the edge (e.g. mute reason).
+             * @example {}
+             */
+            payload: Record<string, never>;
+            /** @description The follower's full actor row. Present only when requested via `?expand=src_actor`. */
+            src_actor?: components["schemas"]["ActorResponseDto"];
+            /**
+             * @description Source actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            src_actor_id: string;
+        };
         HashtagAutocompleteResponseDto: {
             data: components["schemas"]["HashtagResponseDto"][];
         };
@@ -3368,12 +3714,9 @@ interface components {
             tag: string;
         };
         HighlightsResponse: {
-            /**
-             * @description Page of pinned posts.
-             * @example []
-             */
-            data: string[];
-            pagination: components["schemas"]["CursorPagination"];
+            /** @description Page of pinned posts (full post rows; expiry is bypassed for pinned rows). */
+            data: components["schemas"]["PostResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
         };
         LeaveConversationDto: {
             /**
@@ -3443,7 +3786,7 @@ interface components {
         };
         ModerationActionDto: {
             /**
-             * @description Action to apply. `hide`/`remove` transition target status; `unhide`/`restore` reverse them. `warn`/`ban` are audit-only. `dismiss` closes the flag with no target change.
+             * @description Action to apply. `hide`/`remove` transition target status; `unhide`/`restore` reverse them. `warn`/`ban` are audit-only — they record the decision without touching the target; for actor-level enforcement use PATCH `/actors/:actorId` with `status=suspended` or the shadow-ban endpoints on this controller. `dismiss` closes the flag with no target change.
              * @example hide
              * @enum {string}
              */
@@ -3472,7 +3815,7 @@ interface components {
              */
             created_at: string;
             /**
-             * @description Flag UUID this action closed; `null` for unsolicited mod actions.
+             * @description Flag UUID this action was applied to.
              * @example ffffffff-0000-0000-0000-000000000001
              */
             flag_id: string | null;
@@ -3502,6 +3845,66 @@ interface components {
              */
             target_kind: "post" | "comment";
         };
+        ModerationActorListResponseDto: {
+            data: components["schemas"]["ModerationActorResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        ModerationActorResponseDto: {
+            /**
+             * @description Avatar URL.
+             * @example https://cdn.example.com/avatars/ada.png
+             */
+            avatar_url: string | null;
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp the row was inserted.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Display name.
+             * @example Ada Lovelace
+             */
+            display_name: string | null;
+            /**
+             * @description Customer-supplied stable identifier (your user id).
+             * @example user_abc123
+             */
+            external_id: string;
+            /**
+             * @description Social actor UUID.
+             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
+             */
+            id: string;
+            /**
+             * @description Free-form metadata blob.
+             * @example {
+             *       "tier": "pro"
+             *     }
+             */
+            metadata: Record<string, never>;
+            /** @description ISO timestamp the shadow ban was applied, or null. */
+            shadow_banned_at: string | null;
+            /** @description Moderator note attached to the ban. */
+            shadow_banned_reason: string | null;
+            /** @description ISO timestamp the shadow ban auto-expires, or null for indefinite. */
+            shadow_banned_until: string | null;
+            /**
+             * @description Lifecycle status. `suspended` is moderator-applied via PATCH `status=suspended`; `deleted` is soft-deletion. Shadow-banning is a separate moderation mechanism that does not change `status`.
+             * @example active
+             * @enum {string}
+             */
+            status: "active" | "suspended" | "deleted";
+            /**
+             * @description ISO timestamp of the last update.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            updated_at: string;
+        };
         MutedTermResponseDto: {
             /**
              * @description Owning actor UUID.
@@ -3535,22 +3938,10 @@ interface components {
              */
             term: string;
         };
-        NotificationListPagination: {
-            /**
-             * @description Whether more pages exist after this one.
-             * @example false
-             */
-            has_more: boolean;
-            /**
-             * @description Opaque base64url cursor for the next page; `null` when no further pages.
-             * @example eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQxMjowMDowMC4wMDBaIiwiaWQiOiIxMTExMSJ9
-             */
-            next_cursor: string | null;
-        };
         NotificationListResponse: {
             /** @description Page of notifications, newest first. */
             data: components["schemas"]["NotificationResponse"][];
-            pagination: components["schemas"]["NotificationListPagination"];
+            pagination: components["schemas"]["PaginationResponseDto"];
         };
         NotificationPrefListResponseDto: {
             /** @description One row per known NotificationKind. Kinds the actor has not explicitly toggled report `enabled=true` and an epoch `updated_at`, so the client always sees the full catalogue with effective state. */
@@ -3572,7 +3963,7 @@ interface components {
              * @example follow
              * @enum {string}
              */
-            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post";
+            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction";
             /**
              * @description ISO timestamp of the last update. Synthesised entries (no explicit row) report epoch.
              * @example 2026-05-01T12:00:00.000Z
@@ -3601,13 +3992,13 @@ interface components {
              */
             id: string;
             /**
-             * @description What happened. `follow` / `reaction` / `comment_on_post` / `reply_to_comment`. `mention` is reserved.
+             * @description What happened. Content kinds (`follow`, `reaction`, `comment_on_post`, `reply_to_comment`, `mention`, `vote`, `repost`, `quote_post`) plus the DM kinds (`dm_new_message`, `dm_added_to_group`, `dm_role_changed`, `dm_reaction`).
              * @example reaction
              * @enum {string}
              */
-            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention";
+            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction";
             /**
-             * @description Kind-specific extras. `reaction`: `{type}`. `comment_on_post` / `reply_to_comment`: `{comment_id}`.
+             * @description Kind-specific extras. `reaction`: `{type}` (+ `{post_id}` when the target is a comment). `comment_on_post` / `reply_to_comment`: `{comment_id}`. `mention`: `{post_id}` (+ `{comment_id}` for comment mentions).
              * @example {
              *       "type": "like"
              *     }
@@ -3623,17 +4014,71 @@ interface components {
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
             recipient_actor_id: string;
+            /**
+             * @description When `true`, the recipient has restricted the triggering actor — the row is hidden from the default `inbox` slice and surfaces on `?status=requests` (or `all`).
+             * @example false
+             */
+            suppressed: boolean;
             /**
              * @description id of the actor / post / comment the event happened on.
              * @example bbbbbbbb-0000-0000-0000-000000000001
              */
             target_id: string;
             /**
-             * @description Switches what `target_id` references. `actor` for follow; `post` for reaction / comment_on_post; `comment` for reply_to_comment.
+             * @description Switches what `target_id` references. `actor` for follow; `post` for vote / repost / quote_post / comment_on_post and post-targeted reactions/mentions; `comment` for reply_to_comment and comment-targeted reactions/mentions; `direct_message` for the dm_* kinds.
              * @example post
              * @enum {string}
              */
-            target_kind: "actor" | "post" | "comment";
+            target_kind: "actor" | "post" | "comment" | "direct_message";
+        };
+        OutboundEdgeListResponseDto: {
+            data: components["schemas"]["OutboundEdgeResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        OutboundEdgeResponseDto: {
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp the edge was created.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /** @description The destination actor's full row. Present only when requested via `?expand=dst_actor`. */
+            dst_actor?: components["schemas"]["ActorResponseDto"];
+            /**
+             * @description Destination actor UUID (for actor edges).
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            dst_actor_id: string | null;
+            /**
+             * @description Destination post UUID (for reaction / save edges).
+             * @example null
+             */
+            dst_post_id: string | null;
+            /**
+             * @description Edge UUID.
+             * @example eeeeeeee-0000-0000-0000-000000000001
+             */
+            id: string;
+            /**
+             * @description Edge kind. The actor-edge routes emit exactly these four; post reactions and bookmarks have their own response shapes.
+             * @example follow
+             * @enum {string}
+             */
+            kind: "follow" | "mute" | "block" | "restrict";
+            /**
+             * @description Free-form payload stored on the edge (e.g. mute reason).
+             * @example {}
+             */
+            payload: Record<string, never>;
+            /**
+             * @description Source actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            src_actor_id: string;
         };
         PaginationResponseDto: {
             /**
@@ -3708,6 +4153,37 @@ interface components {
             data: components["schemas"]["PostResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
+        PostReactionEntryDto: {
+            /**
+             * @description Reactor actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id: string;
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Post UUID.
+             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
+             */
+            post_id: string;
+            /**
+             * @description Reaction type label.
+             * @example like
+             */
+            type: string;
+        };
+        PostReactionListResponseDto: {
+            data: components["schemas"]["PostReactionEntryDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
         PostResponseDto: {
             /**
              * @description Author actor UUID.
@@ -3760,7 +4236,7 @@ interface components {
              */
             id: string;
             /**
-             * @description Free-form post kind. Common: text, link, image, story.
+             * @description Free-form post kind. Common: text, link, image, story, repost, quote.
              * @example text
              */
             kind: string;
@@ -3787,17 +4263,22 @@ interface components {
              * @example 0
              */
             repost_count: number;
+            /**
+             * @description ISO publish-at timestamp, set while status='scheduled'. The scheduler cron promotes the post to published and clears this field; a manual PATCH promotion leaves the last value in place unless the caller also passes scheduled_for: null.
+             * @example null
+             */
+            scheduled_for: string | null;
             /**
              * @description For kind='repost' / 'quote': the source post UUID.
              * @example null
              */
             source_post_id: string | null;
             /**
-             * @description Lifecycle status. `removed` rows are hidden from public reads.
+             * @description Lifecycle status. Public list/feed surfaces only return `published`; `draft` and `scheduled` rows surface exclusively on the author-scoped drafts / scheduled-posts listings and author reads. `removed` rows are hidden from reads.
              * @example published
              * @enum {string}
              */
-            status: "published" | "hidden" | "removed";
+            status: "published" | "hidden" | "removed" | "draft" | "scheduled";
             /**
              * @description Optional title (1-240 chars).
              * @example Shipping Phase 8
@@ -3814,7 +4295,7 @@ interface components {
              */
             url: string | null;
             /**
-             * @description Denormalised impression count, bumped via POST /posts/views.
+             * @description Denormalised impression count, bumped via the batch POST /posts/views endpoint.
              * @example 0
              */
             view_count: number;
@@ -3862,7 +4343,7 @@ interface components {
             title: string | null;
         };
         PostSearchHitDto: {
-            post: components["schemas"]["SearchPostResponseDto"];
+            post: components["schemas"]["PostResponseDto"];
             /**
              * @description PG ts_rank score on the (title A, body B) tsvector. Higher = more relevant. Returned even when order='recent' so clients can render a relevance badge.
              * @example 0.6079
@@ -3873,41 +4354,9 @@ interface components {
             /** @description Up to `limit` (default 20, max 50) hits. Not paginated in v1. */
             data: components["schemas"]["PostSearchHitDto"][];
         };
-        ReactionCountsResponseDto: {
+        PostStateRequestDto: {
             /**
-             * @description Denormalised reaction counts after the write.
-             * @example {
-             *       "like": 12
-             *     }
-             */
-            reaction_counts: Record<string, never>;
-        };
-        ReactionResponseDto: {
-            /**
-             * @description `true` on first call; `false` on idempotent retry.
-             * @example true
-             */
-            created: boolean;
-            edge: components["schemas"]["EdgeResponseDto"];
-            /**
-             * @description Denormalised reaction counts after the write.
-             * @example {
-             *       "fire": 3,
-             *       "like": 13
-             *     }
-             */
-            reaction_counts: Record<string, never>;
-        };
-        RecordViewDto: {
-            /**
-             * @description Viewer social actor UUID.
-             * @example aaaaaaaa-0000-0000-0000-000000000002
-             */
-            viewer_actor_id: string;
-        };
-        RecordViewsDto: {
-            /**
-             * @description UUIDs of posts that became visible to the viewer in this batch. Capped at 200 to keep the payload sensible — the server will silently skip ids that aren't in the community or have been removed.
+             * @description UUIDs of the posts to hydrate viewer state for. Capped at 200 (matches the batch-views precedent); ids that are unknown, removed, or from another community resolve to the empty state instead of failing the batch.
              * @example [
              *       "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
              *       "cccccccc-cccc-cccc-cccc-cccccccccccc"
@@ -3915,127 +4364,50 @@ interface components {
              */
             post_ids: string[];
         };
-        RemoveMemberDto: {
-            /**
-             * @description Social actor UUID of the acting party. Equal to the target for self-leave.
-             * @example aaaaaaaa-0000-0000-0000-000000000001
-             */
-            caller_actor_id: string;
-        };
-        RenameGroupDto: {
-            /**
-             * @description Social actor UUID of the renaming admin.
-             * @example aaaaaaaa-0000-0000-0000-000000000001
-             */
-            caller_actor_id: string;
-            /** @description New display name. Pass null or empty to clear. */
-            name: string | null;
-        };
-        RepostListResponseDto: {
-            /** @description Page of repost post rows, each carrying the reposting actor_id. */
-            data: components["schemas"]["RepostPostResponseDto"][];
-            pagination: components["schemas"]["PaginationResponseDto"];
+        PostStateResponseDto: {
+            /** @description One entry per requested post id (de-duplicated, request order). Unknown / cross-community ids resolve to the empty state. */
+            data: components["schemas"]["PostViewerStateEntryDto"][];
         };
-        RepostPostResponseDto: {
-            /**
-             * @description Author actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
-             */
-            actor_id: string;
-            /**
-             * @description Free-form attributes blob.
-             * @example {}
-             */
-            attributes: Record<string, never>;
+        PostViewerStateEntryDto: {
             /**
-             * @description Body. Always null for reposts.
-             * @example null
-             */
-            body: string | null;
-            /**
-             * @description Live denormalised comment count.
-             * @example 0
-             */
-            comment_count: number;
-            /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
-             */
-            community_id: string;
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            created_at: string;
-            /**
-             * @description ISO timestamp; null = no expiry.
-             * @example null
+             * @description The viewer has bookmarked the post.
+             * @example true
              */
-            expires_at: string | null;
+            bookmarked: boolean;
             /**
-             * @description Post UUID.
+             * @description Post UUID this entry describes.
              * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
              */
-            id: string;
+            post_id: string;
             /**
-             * @description Post kind. 'repost' for repost rows.
-             * @example repost
+             * @description Reaction types the viewer currently has on the post, sorted ascending. Empty when the viewer has not reacted.
+             * @example [
+             *       "fire",
+             *       "like"
+             *     ]
              */
-            kind: string;
+            reacted_types: string[];
             /**
-             * @description Pinned for highlights.
+             * @description The viewer has a currently-published repost of the post.
              * @example false
              */
-            pinned: boolean;
-            /**
-             * @description Live denormalised reaction counts.
-             * @example {}
-             */
-            reaction_counts: Record<string, never>;
-            /**
-             * @description Reposts of this post (always 0 for the repost row itself).
-             * @example 0
-             */
-            repost_count: number;
+            reposted: boolean;
             /**
-             * @description For reposts: source post UUID.
-             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
-             */
-            source_post_id: string | null;
-            /**
-             * @description Lifecycle status.
-             * @example published
-             * @enum {string}
-             */
-            status: "published" | "hidden" | "removed" | "draft";
-            /**
-             * @description Optional title.
+             * @description Poll option index the viewer voted for; `null` when the viewer has not voted (or the post has no poll).
              * @example null
              */
-            title: string | null;
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            updated_at: string;
-            /**
-             * @description Optional URL.
-             * @example null
-             */
-            url: string | null;
-            /**
-             * @description Visibility scope (inherited from the source).
-             * @example public
-             * @enum {string}
-             */
-            visibility: "public" | "followers" | "close_friends" | "private";
+            voted_option: number | null;
         };
-        SearchActorResponseDto: {
+        ReactionCountsResponseDto: {
             /**
-             * @description Avatar URL.
-             * @example https://...
+             * @description Denormalised reaction counts after the write.
+             * @example {
+             *       "like": 12
+             *     }
              */
-            avatar_url: string | null;
+            reaction_counts: Record<string, never>;
+        };
+        ReactionEdgeResponseDto: {
             /**
              * @description Owning community UUID.
              * @example cccccccc-cccc-cccc-cccc-cccccccccccc
@@ -4047,120 +4419,142 @@ interface components {
              */
             created_at: string;
             /**
-             * @description Display name.
-             * @example Ada Lovelace
+             * @description Destination actor UUID — always `null` for post reactions (the target is `dst_post_id`).
+             * @example null
              */
-            display_name: string | null;
+            dst_actor_id: string | null;
             /**
-             * @description Customer-supplied stable identifier.
-             * @example ada
+             * @description Target post UUID.
+             * @example pppppppp-pppp-pppp-pppp-pppppppppppp
              */
-            external_id: string;
+            dst_post_id: string;
             /**
-             * @description Social actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
+             * @description Edge UUID.
+             * @example eeeeeeee-0000-0000-0000-000000000001
              */
             id: string;
             /**
-             * @description Free-form metadata.
-             * @example {}
+             * @description Edge kind (`reaction:<type>`).
+             * @example reaction:like
              */
-            metadata: Record<string, never>;
+            kind: string;
             /**
-             * @description Lifecycle status. Search only surfaces `active` actors.
-             * @example active
-             * @enum {string}
+             * @description Free-form payload.
+             * @example {}
              */
-            status: "active" | "suspended" | "deleted";
+            payload: Record<string, never>;
             /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
+             * @description Reactor actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            updated_at: string;
+            src_actor_id: string;
         };
-        SearchPostResponseDto: {
-            /**
-             * @description Author actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
-             */
-            actor_id: string;
+        ReactionResponseDto: {
             /**
-             * @description Free-form attributes blob.
-             * @example {}
+             * @description `true` on first call; `false` on idempotent retry.
+             * @example true
              */
-            attributes: Record<string, never>;
+            created: boolean;
+            edge: components["schemas"]["ReactionEdgeResponseDto"];
             /**
-             * @description Body text.
-             * @example shipping today.
+             * @description Denormalised reaction counts after the write.
+             * @example {
+             *       "fire": 3,
+             *       "like": 13
+             *     }
              */
-            body: string | null;
+            reaction_counts: Record<string, never>;
+        };
+        RecordViewDto: {
             /**
-             * @description Live denormalised comment count.
-             * @example 0
+             * @description Viewer social actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000002
              */
-            comment_count: number;
+            viewer_actor_id: string;
+        };
+        RecordViewsDto: {
             /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             * @description UUIDs of posts that became visible to the viewer in this batch. Capped at 200 to keep the payload sensible — the server will silently skip ids that aren't in the community or have been removed.
+             * @example [
+             *       "bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb",
+             *       "cccccccc-cccc-cccc-cccc-cccccccccccc"
+             *     ]
              */
-            community_id: string;
+            post_ids: string[];
+        };
+        RelationshipEntryDto: {
             /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
+             * @description This actor has blocked the source actor — surface it BEFORE attempting a follow/react write instead of handling the 409.
+             * @example false
              */
-            created_at: string;
+            blocked_by: boolean;
             /**
-             * @description ISO timestamp; null = no expiry.
-             * @example null
+             * @description The source actor has blocked this actor.
+             * @example false
              */
-            expires_at: string | null;
+            blocking: boolean;
             /**
-             * @description Post UUID.
-             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
+             * @description This actor is on the source actor's close-friend list.
+             * @example false
              */
-            id: string;
+            close_friend: boolean;
             /**
-             * @description Free-form post kind.
-             * @example text
+             * @description Destination actor UUID this entry describes.
+             * @example aaaaaaaa-0000-0000-0000-000000000002
              */
-            kind: string;
+            dst_actor_id: string;
             /**
-             * @description Pinned for highlights.
+             * @description This actor follows the source actor.
              * @example false
              */
-            pinned: boolean;
+            followed_by: boolean;
             /**
-             * @description Live denormalised reaction counts.
-             * @example {}
+             * @description The source actor follows this actor.
+             * @example true
              */
-            reaction_counts: Record<string, never>;
+            following: boolean;
             /**
-             * @description Lifecycle status. Search only surfaces 'published'.
-             * @example published
-             * @enum {string}
+             * @description The source actor has muted this actor.
+             * @example false
              */
-            status: "published" | "hidden" | "removed" | "draft";
+            muting: boolean;
             /**
-             * @description Optional title.
-             * @example null
+             * @description The source actor has restricted this actor.
+             * @example false
              */
-            title: string | null;
+            restricting: boolean;
+        };
+        RelationshipListResponseDto: {
+            /** @description One entry per requested id (de-duplicated, request order). Unknown ids resolve to all-false flags. */
+            data: components["schemas"]["RelationshipEntryDto"][];
+        };
+        RemoveListMemberDto: {
             /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
+             * @description Caller — social actor UUID. Must equal the list owner.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            updated_at: string;
+            caller_actor_id: string;
+        };
+        RemoveMemberDto: {
             /**
-             * @description Optional URL.
-             * @example null
+             * @description Social actor UUID of the acting party. Equal to the target for self-leave.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            url: string | null;
+            caller_actor_id: string;
+        };
+        RenameGroupDto: {
             /**
-             * @description Visibility scope.
-             * @example public
-             * @enum {string}
+             * @description Social actor UUID of the renaming admin.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            visibility: "public" | "followers" | "close_friends" | "private";
+            caller_actor_id: string;
+            /** @description New display name. Pass null or empty to clear. */
+            name: string | null;
+        };
+        RepostListResponseDto: {
+            /** @description Page of repost post rows, each carrying the reposting actor_id. */
+            data: components["schemas"]["PostResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
         };
         SendMessageDto: {
             attachments?: components["schemas"]["DirectMessageAttachmentDto"][];
@@ -4251,60 +4645,10 @@ interface components {
         };
         StoryViewersResponse: {
             data: components["schemas"]["StoryViewerResponse"][];
-            pagination: components["schemas"]["CursorPagination"];
-        };
-        SuggestedActorResponseDto: {
-            /**
-             * @description Avatar URL.
-             * @example https://cdn.example.com/avatars/ada.png
-             */
-            avatar_url: string | null;
-            /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
-             */
-            community_id: string;
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            created_at: string;
-            /**
-             * @description Display name.
-             * @example Ada Lovelace
-             */
-            display_name: string | null;
-            /**
-             * @description Customer-supplied stable identifier.
-             * @example user_abc123
-             */
-            external_id: string;
-            /**
-             * @description Social actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
-             */
-            id: string;
-            /**
-             * @description Free-form metadata blob.
-             * @example {
-             *       "tier": "pro"
-             *     }
-             */
-            metadata: Record<string, never>;
-            /**
-             * @description Lifecycle status. Suggestions only surface `active` actors.
-             * @example active
-             * @enum {string}
-             */
-            status: "active" | "suspended" | "deleted";
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            updated_at: string;
+            pagination: components["schemas"]["PaginationResponseDto"];
         };
         SuggestedFollowResponseDto: {
-            actor: components["schemas"]["SuggestedActorResponseDto"];
+            actor: components["schemas"]["ActorResponseDto"];
             /**
              * @description Why this candidate surfaced. `followed_by_friends` is the friend-of-a-friend signal; `top_in_community` is the cold-start fallback used when FoF doesn't fill the requested limit.
              * @example followed_by_friends
@@ -4372,7 +4716,8 @@ interface components {
         UpdateCommunityDto: {
             description?: string | null;
             display_name?: string;
-            settings?: Record<string, never>;
+            /** @description Replaces the settings blob. Supported keys are typed on CommunitySettingsDto; unrecognized keys are stored verbatim but not consumed. */
+            settings?: components["schemas"]["CommunitySettingsDto"];
             /** @enum {string} */
             status?: "active" | "suspended" | "archived";
         };
@@ -4439,7 +4784,7 @@ interface components {
             /** @description ISO-8601 publish-at timestamp. Updating only valid while the post is `status="scheduled"`. Pass null to clear (typically only the scheduler does this on promotion). */
             scheduled_for?: string | null;
             /**
-             * @description Direct status transition. Pass `published` to promote a `draft` or `scheduled`. Prefer the moderation lane for `hidden`/`removed`. Transitions to/from `draft`/`scheduled` other than to `published` are 422.
+             * @description Direct status transition. Pass `published` to promote a `draft` or `scheduled`. Prefer the moderation lane for `hidden`/`removed`.
              * @enum {string}
              */
             status?: "published" | "hidden" | "removed" | "draft" | "scheduled";
@@ -4451,8 +4796,13 @@ interface components {
             visibility?: "public" | "followers" | "close_friends" | "private";
         };
         UpdateWebhookDto: {
-            /** @description New subscription set. */
-            event_types?: string[];
+            /**
+             * @description Set `false` to re-enable a disabled webhook (clears the auto-disable state and resets the failure streak — no secret rotation required). Set `true` to disable it manually.
+             * @example false
+             */
+            disabled?: boolean;
+            /** @description New subscription set. Unknown values are rejected with a 400 naming the valid set. */
+            event_types?: ("post.created" | "post.updated" | "post.deleted" | "post.reaction.created" | "repost.created" | "comment.created" | "comment.updated" | "comment.deleted" | "comment.reaction.created" | "edge.follow.created" | "edge.follow.deleted" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created")[];
             /** @description New subscriber URL. */
             url?: string;
         };
@@ -4488,6 +4838,21 @@ interface components {
              */
             created: boolean;
         };
+        WebhookEventTypesResponseDto: {
+            /**
+             * @description Every event type a webhook can subscribe to, in catalog order.
+             * @example [
+             *       "post.created",
+             *       "post.deleted",
+             *       "comment.created"
+             *     ]
+             */
+            data: ("post.created" | "post.updated" | "post.deleted" | "post.reaction.created" | "repost.created" | "comment.created" | "comment.updated" | "comment.deleted" | "comment.reaction.created" | "edge.follow.created" | "edge.follow.deleted" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created")[];
+        };
+        WebhookListResponseDto: {
+            /** @description Every webhook on the community — disabled rows included, so auto-disabled subscribers stay discoverable. */
+            data: components["schemas"]["WebhookResponseDto"][];
+        };
         WebhookResponseDto: {
             /**
              * @description Owning community UUID.
@@ -4515,13 +4880,13 @@ interface components {
              */
             disabled_reason: string | null;
             /**
-             * @description Subscribed event types. Each item is one of the social event names (e.g. `post.created`, `comment.created`, `edge.follow.created`).
+             * @description Subscribed event types. Each item is one of the social event names — see GET /v1/webhook-event-types for the live catalog.
              * @example [
              *       "post.created",
              *       "comment.created"
              *     ]
              */
-            event_types: string[];
+            event_types: ("post.created" | "post.updated" | "post.deleted" | "post.reaction.created" | "repost.created" | "comment.created" | "comment.updated" | "comment.deleted" | "comment.reaction.created" | "edge.follow.created" | "edge.follow.deleted" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created")[];
             /**
              * @description Webhook UUID.
              * @example wwwwwwww-0000-0000-0000-000000000001
@@ -4564,10 +4929,12 @@ interface operations {
     ActorController_list: {
         parameters: {
             query?: {
-                /** @description Page size; capped at 200. */
+                /** @description Page size; capped at 200. Ignored when `ids` is passed. */
                 limit?: number;
-                /** @description Opaque cursor from the previous page's `pagination.next_cursor`. */
+                /** @description Opaque cursor from the previous page's `pagination.next_cursor`. Ignored when `ids` is passed. */
                 cursor?: string;
+                /** @description Comma-separated actor UUIDs (max 100, de-duplicated) to batch-fetch. Returns matching actors in request order; unknown ids are silently omitted. */
+                ids?: string;
             };
             header?: never;
             path: {
@@ -4578,16 +4945,25 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Page of actors with `next_cursor` + `has_more`. */
+            /** @description Page of actors with `next_cursor` + `has_more` (batch-fetch responses always report `has_more: false`). */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ActorListResponseDto"];
+                    "application/json": components["schemas"]["ActorPageResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or invalid `ids` (`INVALID_ID_LIST` — empty / non-UUID entry; `TOO_MANY_IDS` — over 100). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4661,6 +5037,114 @@ interface operations {
             };
         };
     };
+    ActorController_batchUpsert: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BatchUpsertActorsDto"];
+            };
+        };
+        responses: {
+            /** @description Per-item results, request order. `succeeded` + `failed` summarise the batch. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BatchActorsResponseDto"];
+                };
+            };
+            /** @description Envelope validation failure: `actors` missing, empty, over 200 items, or an item shape invalid. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.create` for this community. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community not found in the PAK's workspace. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    ActorController_batchGetByExternal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BatchExternalIdsDto"];
+            };
+        };
+        responses: {
+            /** @description Actors found (request order, de-duplicated) plus the `missing[]` external_ids. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ActorsByExternalBatchResponseDto"];
+                };
+            };
+            /** @description `external_ids` missing, empty, over 200 items, or an entry exceeding 256 chars. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community not found in the PAK's workspace. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     ActorController_getByExternal: {
         parameters: {
             query?: never;
@@ -4840,6 +5324,8 @@ interface operations {
             query?: {
                 limit?: number;
                 cursor?: string;
+                /** @description Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`. */
+                expand?: "dst_actor";
             };
             header?: never;
             path: {
@@ -4858,10 +5344,19 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EdgeListResponseDto"];
+                    "application/json": components["schemas"]["OutboundEdgeListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4954,13 +5449,13 @@ interface operations {
                     "application/json": components["schemas"]["CloseFriendsListResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description PAK lacks `social.close-friend.read`. */
@@ -4969,7 +5464,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found. */
@@ -4978,7 +5473,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -5110,7 +5605,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -5135,6 +5630,8 @@ interface operations {
             query?: {
                 limit?: number;
                 cursor?: string;
+                /** @description Stripe-style expansion. Pass the response field to expand (supported here: `src_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`. */
+                expand?: "src_actor";
             };
             header?: never;
             path: {
@@ -5153,10 +5650,19 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EdgeListResponseDto"];
+                    "application/json": components["schemas"]["FollowerEdgeListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -5181,6 +5687,8 @@ interface operations {
             query?: {
                 limit?: number;
                 cursor?: string;
+                /** @description Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`. */
+                expand?: "dst_actor";
             };
             header?: never;
             path: {
@@ -5199,10 +5707,19 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EdgeListResponseDto"];
+                    "application/json": components["schemas"]["OutboundEdgeListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -5383,7 +5900,7 @@ interface operations {
                 limit?: number;
                 /** @description Cursor from the prior page. */
                 cursor?: string;
-                /** @description Requester's external_id. Without it, only public pinned posts surface. */
+                /** @description Requester social actor UUID. Without it, only public pinned posts surface. */
                 requester_id?: string;
             };
             header?: never;
@@ -5406,22 +5923,13 @@ interface operations {
                     "application/json": components["schemas"]["HighlightsResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description PAK lacks `social.read`. */
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found. */
@@ -5430,7 +5938,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -5629,6 +6137,8 @@ interface operations {
             query?: {
                 limit?: number;
                 cursor?: string;
+                /** @description Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`. */
+                expand?: "dst_actor";
             };
             header?: never;
             path: {
@@ -5647,10 +6157,19 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EdgeListResponseDto"];
+                    "application/json": components["schemas"]["OutboundEdgeListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -5722,8 +6241,8 @@ interface operations {
                 communityId: string;
                 /** @description Social actor UUID. */
                 actorId: string;
-                /** @description NotificationKind label (`follow` | `reaction` | `comment_on_post` | `reply_to_comment` | `mention` | `vote`). */
-                kind: string;
+                /** @description NotificationKind label. */
+                kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction";
             };
             cookie?: never;
         };
@@ -5803,22 +6322,13 @@ interface operations {
                     "application/json": components["schemas"]["NotificationListResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
             /** @description PAK lacks `social.notify.read` for this community. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found (also returned for cross-workspace probes). */
@@ -5827,7 +6337,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -5865,16 +6375,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description PAK lacks `social.notify.update` for this community. */
@@ -5883,7 +6384,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found. */
@@ -5892,7 +6393,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -5920,22 +6421,13 @@ interface operations {
                     "application/json": components["schemas"]["UnreadCountResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
             /** @description PAK lacks `social.notify.read` for this community. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found. */
@@ -5944,7 +6436,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -5982,34 +6474,81 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
+            /** @description PAK lacks `social.notify.update` for this community. */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.notify.update` for this community. */
+            /** @description Notification not found, or belongs to a different actor. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    ViewerStateController_postState: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Viewer actor UUID — the perspective all state is computed from. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PostStateRequestDto"];
+            };
+        };
+        responses: {
+            /** @description One state entry per requested post id. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PostStateResponseDto"];
+                };
+            };
+            /** @description Empty `post_ids`, more than 200 ids, or a non-UUID in the list. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Notification not found, or belongs to a different actor. */
+            /** @description Community or actor not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -6019,6 +6558,8 @@ interface operations {
             query?: {
                 limit?: number;
                 cursor?: string;
+                /** @description Stripe-style expansion. Pass the response field to expand (supported here: `dst_actor`) and the full object is nested under that field on every item. Omit for the unexpanded (default) shape. Unsupported values return 400 `INVALID_EXPAND`. */
+                expand?: "dst_actor";
             };
             header?: never;
             path: {
@@ -6037,10 +6578,19 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EdgeListResponseDto"];
+                    "application/json": components["schemas"]["OutboundEdgeListResponseDto"];
+                };
+            };
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. Or unsupported `expand` value (`INVALID_EXPAND`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -6129,22 +6679,13 @@ interface operations {
                     "application/json": components["schemas"]["StoryTrayResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description PAK lacks `social.read`. */
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found. */
@@ -6153,7 +6694,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -6204,6 +6745,61 @@ interface operations {
             };
         };
     };
+    EdgeController_relationships: {
+        parameters: {
+            query: {
+                /** @description Comma-separated destination actor UUIDs (1-100). */
+                with: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Source actor UUID — the perspective all flags are computed from. */
+                srcActorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description One relationship entry per requested id. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RelationshipListResponseDto"];
+                };
+            };
+            /** @description Missing `with`, more than 100 ids, or a non-UUID value in the list. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community or source actor not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     EdgeController_block: {
         parameters: {
             query?: never;
@@ -6256,6 +6852,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Cannot block yourself. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     EdgeController_unblock: {
@@ -6274,7 +6879,7 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Unblocked. */
+            /** @description Unblocked (or no edge to remove). */
             204: {
                 headers: {
                     [name: string]: unknown;
@@ -6290,7 +6895,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community not found. */
+            /** @description Community or actor not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -6330,16 +6935,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description PAK lacks `social.close-friend.manage`. */
@@ -6348,7 +6944,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community / owner / member not found. */
@@ -6357,7 +6953,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Block in place between owner and member. */
@@ -6366,7 +6962,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Cannot add yourself as a close friend. */
@@ -6375,7 +6971,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -6403,22 +6999,13 @@ interface operations {
                 };
                 content?: never;
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
             /** @description PAK lacks `social.close-friend.manage`. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community not found. */
@@ -6427,7 +7014,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -6483,7 +7070,10 @@ interface operations {
     ConversationController_create: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Mostly useful for `kind="group"` (direct conversations are get-or-create by participant pair anyway). Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
                 communityId: string;
@@ -6505,7 +7095,7 @@ interface operations {
                     "application/json": components["schemas"]["ConversationResponseDto"];
                 };
             };
-            /** @description Validation failure (missing recipient for direct, missing actor_ids for group, two equal actor ids). */
+            /** @description Validation failure (missing recipient for direct, missing actor_ids for group, two equal actor ids, malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -6532,7 +7122,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description A block exists, or the group exceeds `community.settings.max_group_conversation_size`. */
+            /** @description A block exists, the group exceeds `community.settings.max_group_conversation_size`, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -6966,7 +7556,10 @@ interface operations {
     ConversationController_send: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
                 communityId: string;
@@ -6990,7 +7583,7 @@ interface operations {
                     "application/json": components["schemas"]["DirectMessageResponseDto"];
                 };
             };
-            /** @description Validation failure (empty body for text, body too long). */
+            /** @description Validation failure (empty body for text, body too long, malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -7017,7 +7610,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description A block exists between the sender and another participant. */
+            /** @description A block exists between the sender and another participant, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -7427,6 +8020,59 @@ interface operations {
             };
         };
     };
+    CounterController_getBatchCounters: {
+        parameters: {
+            query: {
+                /** @description Comma-separated actor UUIDs (max 100, de-duplicated). */
+                actor_ids: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Counters for each actor found plus the `missing[]` ids. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BatchCountersResponseDto"];
+                };
+            };
+            /** @description `actor_ids` missing or empty, a non-UUID entry (`INVALID_ID_LIST`), or over 100 ids (`TOO_MANY_IDS`). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community not found in the PAK's workspace. (Unknown actors land in `missing[]`, not a 404.) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     FeedController_getDiscoverFeed: {
         parameters: {
             query?: {
@@ -7489,13 +8135,13 @@ interface operations {
             };
         };
         responses: {
-            /** @description Flag created (or de-duplicated to existing open flag). */
+            /** @description Flag created (or de-duplicated to existing open flag). `auto_hidden` reports whether the auto-hide threshold tripped. */
             201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["FlagResponseDto"];
+                    "application/json": components["schemas"]["CreateFlagResponseDto"];
                 };
             };
             /** @description Validation failure (bad reporter / target / reason). */
@@ -7525,7 +8171,16 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Cannot flag your own content, or the target post/comment is already removed. */
+            /** @description The target post/comment is already removed; nothing to flag. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Cannot flag your own content. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -7597,6 +8252,69 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Cannot follow yourself. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    EdgeController_batchFollows: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["BatchFollowsDto"];
+            };
+        };
+        responses: {
+            /** @description Per-item results, request order. `succeeded` + `failed` summarise the batch. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BatchFollowsResponseDto"];
+                };
+            };
+            /** @description Envelope validation failure: `follows` missing, empty, over 200 items, or an item shape invalid. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.create`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community not found in the PAK's workspace. (Unknown actors fail per item, not the whole call.) */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     EdgeController_unfollow: {
@@ -7631,7 +8349,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community not found. */
+            /** @description Community or actor not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -7764,6 +8482,15 @@ interface operations {
                     "application/json": components["schemas"]["HashtagPostListResponseDto"];
                 };
             };
+            /** @description Invalid tag (empty after normalisation, or longer than 32 chars). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
@@ -7826,7 +8553,10 @@ interface operations {
     ActorListController_create: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. */
                 communityId: string;
@@ -7848,7 +8578,7 @@ interface operations {
                     "application/json": components["schemas"]["ActorListResponseDto"];
                 };
             };
-            /** @description Validation failure. */
+            /** @description Validation failure (including malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -7875,6 +8605,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description `IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     ActorListController_getById: {
@@ -8144,7 +8883,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["AddMemberDto"];
+                "application/json": components["schemas"]["AddListMemberDto"];
             };
         };
         responses: {
@@ -8202,7 +8941,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["RemoveMemberDto"];
+                "application/json": components["schemas"]["RemoveListMemberDto"];
             };
         };
         responses: {
@@ -8294,6 +9033,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Cannot mute yourself. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     EdgeController_unmute: {
@@ -8312,7 +9060,7 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Unmuted. */
+            /** @description Unmuted (or no edge to remove). */
             204: {
                 headers: {
                     [name: string]: unknown;
@@ -8328,7 +9076,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community not found. */
+            /** @description Community or actor not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -8365,7 +9113,7 @@ interface operations {
                     "application/json": components["schemas"]["PostListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -8388,7 +9136,10 @@ interface operations {
     PostController_create: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 communityId: string;
             };
@@ -8409,7 +9160,7 @@ interface operations {
                     "application/json": components["schemas"]["PostResponseDto"];
                 };
             };
-            /** @description Validation failure (missing actor_id; body/title/url all empty; bad URL; bad ISO timestamp). */
+            /** @description Validation failure (missing actor_id; body/title/url all empty; bad URL; bad ISO timestamp; malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8427,8 +9178,26 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community or actor not found in the PAK's workspace. */
-            404: {
+            /** @description Community, actor, or quote source post not found in the PAK's workspace. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description `IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Quote rules: `CANNOT_QUOTE_SELF` (kind='quote' with your own post as source) or `CANNOT_QUOTE_PRIVATE` (source post is private). */
+            422: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -8618,6 +9387,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description `EDIT_WINDOW_EXPIRED` (content edit after the community's edit window), or `scheduled_for` passed while the post is not `status='scheduled'`. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     BookmarkController_create: {
@@ -8760,7 +9538,7 @@ interface operations {
                     "application/json": components["schemas"]["CommentListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -8783,7 +9561,10 @@ interface operations {
     CommentController_create: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
                 communityId: string;
@@ -8807,7 +9588,7 @@ interface operations {
                     "application/json": components["schemas"]["CommentResponseDto"];
                 };
             };
-            /** @description Validation failure (missing actor_id, empty body, body too long). */
+            /** @description Validation failure (missing actor_id, empty body, body too long, malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8834,7 +9615,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Block exists between commenter and post author, or depth exceeds community.settings.max_comment_depth. */
+            /** @description Block exists between commenter and post author, depth exceeds community.settings.max_comment_depth, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -9256,22 +10037,13 @@ interface operations {
                     "application/json": components["schemas"]["PollResultsResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
             /** @description PAK lacks `social.read`. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or post not found. */
@@ -9280,7 +10052,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Post does not contain a poll. */
@@ -9289,7 +10061,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -9339,6 +10111,63 @@ interface operations {
             };
         };
     };
+    PostReactionController_list: {
+        parameters: {
+            query?: {
+                /** @description Filter to a single reaction type label. */
+                type?: string;
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                /** @description Social post UUID. */
+                postId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of reactions. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PostReactionListResponseDto"];
+                };
+            };
+            /** @description Overlong `type` filter (max 64 chars). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community or post not found (or post removed). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     PostReactionController_react: {
         parameters: {
             query?: never;
@@ -9673,7 +10502,7 @@ interface operations {
     StoryController_listViewers: {
         parameters: {
             query: {
-                /** @description Must resolve to the post author. */
+                /** @description Requester social actor UUID — must resolve to the post author. */
                 requester_id: string;
                 limit?: number;
                 /** @description Cursor from the prior page. */
@@ -9699,22 +10528,13 @@ interface operations {
                     "application/json": components["schemas"]["StoryViewersResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description PAK lacks `social.read` OR requester is not the post author. */
+            /** @description PAK lacks `social.list` OR requester is not the post author. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or post not found. */
@@ -9723,7 +10543,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -9759,16 +10579,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description PAK lacks `social.view`. */
@@ -9777,7 +10588,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community / post / viewer not found, or the post is invisible to the viewer. */
@@ -9786,7 +10597,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Cannot view your own story. */
@@ -9795,7 +10606,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -9831,16 +10642,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description PAK lacks `social.vote`. */
@@ -9849,7 +10651,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community / post / voter not found, or post invisible. */
@@ -9858,7 +10660,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Block in place between voter and poll author. */
@@ -9867,7 +10669,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Self-vote / no poll / option_index out of range. */
@@ -9876,7 +10678,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -9933,6 +10735,24 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Block exists between the pair. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Cannot restrict yourself. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     EdgeController_unrestrict: {
@@ -9951,7 +10771,7 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Unrestricted. */
+            /** @description Unrestricted (or no edge to remove). */
             204: {
                 headers: {
                     [name: string]: unknown;
@@ -9967,7 +10787,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community not found. */
+            /** @description Community or actor not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -10144,7 +10964,7 @@ interface operations {
             };
         };
     };
-    WebhookController_getActive: {
+    WebhookController_list: {
         parameters: {
             query?: never;
             header?: never;
@@ -10156,13 +10976,13 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Webhook or null. */
+            /** @description All webhooks on the community (no pagination — capped at 10 rows). */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["WebhookResponseDto"];
+                    "application/json": components["schemas"]["WebhookListResponseDto"];
                 };
             };
             /** @description Community not found. */
@@ -10179,7 +10999,10 @@ interface operations {
     WebhookController_create: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. The signing secret is returned exactly once; a replay returns the original response (including the secret) with `Idempotent-Replay: true`. Same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. */
                 communityId: string;
@@ -10201,7 +11024,7 @@ interface operations {
                     "application/json": components["schemas"]["CreatedWebhookResponseDto"];
                 };
             };
-            /** @description Validation failure (bad url, empty event_types). */
+            /** @description Validation failure (bad url, empty or unknown event_types — the message names the valid set; malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -10228,7 +11051,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community already has an active webhook. */
+            /** @description Webhook cap reached (10 per community), or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -10389,10 +11212,58 @@ interface operations {
             };
         };
     };
-    WebhookController_rotateSecret: {
+    WebhookController_redeliver: {
         parameters: {
             query?: never;
             header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                /** @description Webhook UUID. */
+                webhookId: string;
+                /** @description Delivery row UUID (from GET …/deliveries). */
+                deliveryId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Redelivery enqueued. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeliveryJobResponseDto"];
+                };
+            };
+            /** @description Webhook or delivery not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Webhook is disabled — re-enable it first. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    WebhookController_rotateSecret: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. A replay returns the original response (including the new secret) with `Idempotent-Replay: true`; a retry WITHOUT the header rotates the secret again, invalidating the previous one. Same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 /** @description Social community UUID. */
                 communityId: string;
@@ -10412,6 +11283,58 @@ interface operations {
                     "application/json": components["schemas"]["CreatedWebhookResponseDto"];
                 };
             };
+            /** @description Malformed Idempotency-Key header. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Webhook not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description `IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    WebhookController_testPing: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                /** @description Webhook UUID. */
+                webhookId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Ping enqueued. */
+            202: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeliveryJobResponseDto"];
+                };
+            };
             /** @description Webhook not found. */
             404: {
                 headers: {
@@ -10421,6 +11344,35 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Webhook is disabled — re-enable it first. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    WebhookEventTypesController_list: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The full event-type catalog. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["WebhookEventTypesResponseDto"];
+                };
+            };
         };
     };
     CommunityController_list: {
@@ -10444,7 +11396,7 @@ interface operations {
                     "application/json": components["schemas"]["CommunityResponseDto"][];
                 };
             };
-            /** @description Caller lacks `social.read`, or the workspace has not enabled the `social` service. */
+            /** @description Caller lacks `social.list`, or the workspace has not enabled the `social` service. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -10460,6 +11412,8 @@ interface operations {
             query?: never;
             header: {
                 authorization: string;
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
             };
             path: {
                 /** @description ProductCraft workspace UUID owning the community. */
@@ -10482,7 +11436,7 @@ interface operations {
                     "application/json": components["schemas"]["CommunityResponseDto"];
                 };
             };
-            /** @description Validation failure (slug shape, display_name length). */
+            /** @description Validation failure (slug shape, display_name length, malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -10518,7 +11472,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community slug already taken in this workspace, or the supplied `app_id` is already connected to a community. */
+            /** @description Community slug already taken in this workspace, the supplied `app_id` is already connected to a community, or `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -10715,7 +11669,10 @@ interface operations {
     ModerationAdminController_shadowBan: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 workspaceId: string;
                 communityId: string;
@@ -10735,10 +11692,10 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ActorResponseDto"];
+                    "application/json": components["schemas"]["ModerationActorResponseDto"];
                 };
             };
-            /** @description Invalid duration_hours or reason. */
+            /** @description Invalid duration_hours or reason, or malformed Idempotency-Key. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -10765,6 +11722,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description `IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     ModerationAdminController_unshadow: {
@@ -10786,7 +11752,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ActorResponseDto"];
+                    "application/json": components["schemas"]["ModerationActorResponseDto"];
                 };
             };
             /** @description Caller lacks `social.moderate`. */
@@ -11000,7 +11966,10 @@ interface operations {
     ModerationAdminController_act: {
         parameters: {
             query?: never;
-            header?: never;
+            header?: {
+                /** @description Opaque client-generated string (1–256 chars, `[A-Za-z0-9_\-:]`) used to deduplicate retries within a 24h window. Replays return the original response with `Idempotent-Replay: true`; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
             path: {
                 workspaceId: string;
                 communityId: string;
@@ -11014,16 +11983,16 @@ interface operations {
             };
         };
         responses: {
-            /** @description Action recorded; target status updated where applicable. */
+            /** @description Action recorded; target status updated where applicable. Returns the updated flag and the audit row. */
             201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ModerationActionResponseDto"];
+                    "application/json": components["schemas"]["ActOnFlagResponseDto"];
                 };
             };
-            /** @description Invalid action or notes. */
+            /** @description Invalid action or notes, or malformed Idempotency-Key. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -11050,7 +12019,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Flag already actioned/dismissed and the requested action would be a no-op. */
+            /** @description FLAG_ALREADY_CLOSED — the flag is already actioned/dismissed and the requested action is punitive (hide/remove/warn/ban); reversals (unhide/restore/dismiss) stay legal on a closed flag. Also `IDEMPOTENCY_KEY_REUSE` (same Idempotency-Key, different body). */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -11082,7 +12051,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ActorListResponseDto"];
+                    "application/json": components["schemas"]["ModerationActorListResponseDto"];
                 };
             };
             /** @description Caller lacks `social.audit.read`. */