@productcraft/social 0.2.0 → 0.4.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;
@@ -287,7 +321,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List the actor's currently-active muted terms. */
+        /** List the actor's currently-active muted terms, newest-first. Cursor-paginated (task 008 / G13 — previously an unbounded bare array). */
         get: operations["MutedTermController_list"];
         put?: never;
         /** Add (or refresh) a muted term for the actor. Re-posting the same `term` updates the scope + expires_at. */
@@ -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;
@@ -649,7 +723,7 @@ interface paths {
         get: operations["ConversationController_getById"];
         put?: never;
         post?: never;
-        /** Leave the conversation. Drops the caller's participant row; the conversation is hard-deleted when the last participant leaves. */
+        /** Leave the conversation. Drops the caller's participant row; the conversation is hard-deleted when the last participant leaves. Pass the actor via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["ConversationController_leave"];
         options?: never;
         head?: 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;
@@ -720,7 +794,7 @@ interface paths {
         get?: never;
         put?: never;
         post?: never;
-        /** Soft-delete a message. Reserved to the sender; the row stays so the conversation timeline doesn't orphan replies. Reads return body `"(deleted)"`. */
+        /** Soft-delete a message. Reserved to the sender; the row stays so the conversation timeline doesn't orphan replies. Reads return body `"(deleted)"`. Pass the sender via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["ConversationController_deleteMessage"];
         options?: never;
         head?: 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;
@@ -945,7 +1053,7 @@ interface paths {
         get: operations["ActorListController_getById"];
         put?: never;
         post?: never;
-        /** Delete a list. Owner-only. */
+        /** Delete a list. Owner-only. Pass the caller via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["ActorListController_delete"];
         options?: never;
         head?: never;
@@ -998,7 +1106,7 @@ interface paths {
         get?: never;
         put?: never;
         post?: never;
-        /** Remove a member from a list. Owner-only. Idempotent — 204 either way. */
+        /** Remove a member from a list. Owner-only. Idempotent — 204 either way. Pass the caller via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["ActorListController_removeMember"];
         options?: never;
         head?: 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;
@@ -1057,6 +1165,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/posts/impressions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Batch-increment impression (`view_count`) counters on a list of posts. Client-side debounced; missing post ids are silently skipped (so a deleted post mid-batch doesn’t fail the rest). Renamed from `POST /posts/views` (task 008 / G14) to disambiguate from the story-side per-post `/posts/:postId/views` route. */
+        post: operations["PostController_recordImpressions"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/posts/views": {
         parameters: {
             query?: never;
@@ -1066,8 +1191,11 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Batch-increment view counts on a list of posts. Client-side debounced; missing post ids are silently skipped (so a deleted post mid-batch doesn’t fail the rest). */
-        post: operations["PostController_recordViews"];
+        /**
+         * DEPRECATED — use `POST /posts/impressions`. Batch-increment impression counters. This alias will be removed in a future version.
+         * @deprecated
+         */
+        post: operations["PostController_recordViewsDeprecated"];
         delete?: never;
         options?: never;
         head?: never;
@@ -1110,7 +1238,7 @@ interface paths {
          * @description Visibility-aware: the actor must be allowed to read the post. If they can't, returns 404 (opaque), matching the read-path opacity rule used everywhere else in Social.
          */
         post: operations["BookmarkController_create"];
-        /** Remove a bookmark on behalf of an actor. Idempotent — 204 either way. */
+        /** Remove a bookmark on behalf of an actor. Idempotent — 204 either way. Pass the actor via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["BookmarkController_delete"];
         options?: never;
         head?: never;
@@ -1127,7 +1255,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 +1381,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"];
@@ -1294,7 +1423,7 @@ interface paths {
          * @description Visibility is inherited from the source. The reposter must be allowed to read the source (else 404). Self-repost 422; private-source repost 422. Bumps `source.repost_count` and the reposter's `post_count`. Fires a `repost` notification to the source author (subject to per-kind preferences from task 021).
          */
         post: operations["RepostController_create"];
-        /** Undo my repost of a source post. Idempotent — 204 either way. */
+        /** Undo my repost of a source post. Idempotent — 204 either way. Pass the actor via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["RepostController_delete"];
         options?: never;
         head?: never;
@@ -1499,10 +1628,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 +1654,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 +1675,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 +1701,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 +1709,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;
@@ -1570,10 +1750,10 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List communities in a workspace */
+        /** List communities in a workspace, newest-first. Cursor-paginated as of task 008 / G13 (previously a bare array). */
         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 +1806,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 +1892,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;
@@ -1789,6 +1969,11 @@ interface components {
             updated_at: string;
         };
         ActorEdgeDto: {
+            /**
+             * @description Acting social actor UUID (the one performing the follow / mute / block / restrict). Standardized name (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id?: string;
             /**
              * @description Destination social actor UUID (the one being followed / muted / blocked / restricted).
              * @example aaaaaaaa-0000-0000-0000-000000000002
@@ -1797,10 +1982,11 @@ interface components {
             /** @description Optional free-form payload stored on the edge (e.g. mute reason). */
             payload?: Record<string, never>;
             /**
-             * @description Source social actor UUID (the one performing the follow / mute / block / restrict).
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11). Accepted for one more version.
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            src_actor_id: string;
+            src_actor_id?: string;
         };
         ActorListListResponseDto: {
             data: components["schemas"]["ActorListResponseDto"][];
@@ -1945,6 +2131,19 @@ interface components {
         ActorSearchResponseDto: {
             /** @description Up to `limit` (default 20, max 50) ranked hits. Not paginated in v1; results are bounded by `limit`. */
             data: components["schemas"]["ActorSearchHitDto"][];
+            /** @description Always `null` — this lane returns a single bounded, ranked page (no cursor in v1). Present for envelope consistency. */
+            pagination: components["schemas"]["PaginationResponseDto"] | null;
+        };
+        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: {
             /**
@@ -2011,6 +2210,109 @@ interface components {
             data: components["schemas"]["ModerationActionResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
+        BatchActorResultDto: {
+            /** @description The upserted actor — present on success. */
+            actor?: components["schemas"]["ActorResponseDto"];
+            /**
+             * @description `true` if this item inserted a new row, `false` on an update of an existing external_id. Present on success.
+             * @example true
+             */
+            created?: boolean;
+            /** @description The error this item would have returned as a standalone call — present on failure. */
+            error?: components["schemas"]["ErrorResponseDto"];
+            /**
+             * @description Position of this result in the request array.
+             * @example 0
+             */
+            index: number;
+            /**
+             * @description `true` when this item was upserted; `false` when it failed (see `error`).
+             * @example true
+             */
+            success: boolean;
+        };
+        BatchActorsResponseDto: {
+            /** @description One result per input item, same order. */
+            data: components["schemas"]["BatchActorResultDto"][];
+            /**
+             * @description Count of failed items.
+             * @example 1
+             */
+            failed: number;
+            /**
+             * @description Count of successful items.
+             * @example 199
+             */
+            succeeded: number;
+        };
+        BatchCountersResponseDto: {
+            /** @description Counters for each actor found, in `actor_ids` order (after de-duplication). */
+            data: components["schemas"]["ActorCountersResponseDto"][];
+            /**
+             * @description actor_ids with no actor in this community.
+             * @example []
+             */
+            missing: string[];
+        };
+        BatchExternalIdsDto: {
+            /**
+             * @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"];
@@ -2250,6 +2552,52 @@ interface components {
              */
             total_posts: number;
         };
+        CommunityListResponseDto: {
+            data: components["schemas"]["CommunityResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        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.
@@ -2282,12 +2630,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
@@ -2310,6 +2658,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"];
@@ -2488,10 +2864,16 @@ interface components {
         };
         CreateCommentReactionDto: {
             /**
-             * @description Reactor actor UUID.
+             * @description Reactor actor UUID. Standardized name (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            src_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            src_actor_id?: string;
             /**
              * @description Reaction type (free-form short label, e.g. `like`, `fire`, `heart`).
              * @example like
@@ -2514,8 +2896,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
@@ -2552,10 +2934,16 @@ interface components {
         };
         CreateDirectMessageReactionDto: {
             /**
-             * @description The reactor — social actor UUID.
+             * @description The reactor — social actor UUID. Standardized name (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            src_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            src_actor_id?: string;
             /**
              * @description Reaction type (emoji or label, 1..64 chars).
              * @example heart
@@ -2687,10 +3075,16 @@ interface components {
         };
         CreateReactionDto: {
             /**
-             * @description Reactor — social actor UUID.
+             * @description Reactor — social actor UUID. Standardized name (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            src_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            src_actor_id?: string;
             /**
              * @description Reaction type (1..64 chars).
              * @example like
@@ -2717,13 +3111,13 @@ interface components {
         };
         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
@@ -2757,13 +3151,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
@@ -2802,25 +3196,84 @@ interface components {
         };
         DeleteActorListDto: {
             /**
-             * @description Caller — social actor UUID. Must equal the list owner.
+             * @deprecated
+             * @description DEPRECATED — use `?actor_id=`. Caller social actor UUID (must equal the list owner).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            caller_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             */
+            caller_actor_id?: string;
         };
         DeleteMessageDto: {
             /**
-             * @description The sender — must match the message's sender_id.
+             * @deprecated
+             * @description DEPRECATED — use `?actor_id=`. The sender (must match the message's sender_id).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            sender_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             */
+            sender_id?: string;
         };
-        DeliveryListResponseDto: {
-            data: components["schemas"]["DeliveryResponseDto"][];
-            pagination: components["schemas"]["PaginationResponseDto"];
+        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;
@@ -2874,6 +3327,14 @@ interface components {
             /** @description Webhook UUID. */
             webhook_id: string;
         };
+        DeprecatedActorIdBodyDto: {
+            /**
+             * @deprecated
+             * @description DEPRECATED — pass the actor via the `?actor_id=` query parameter instead. Accepted from the body for one more version.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id?: string;
+        };
         DirectMessageAdminListResponseDto: {
             data: components["schemas"]["DirectMessageAdminResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -3079,10 +3540,6 @@ interface components {
             data: components["schemas"]["PostResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
-        EdgeListResponseDto: {
-            data: components["schemas"]["EdgeResponseDto"][];
-            pagination: components["schemas"]["PaginationResponseDto"];
-        };
         EdgeResponseDto: {
             /**
              * @description Owning community UUID.
@@ -3201,8 +3658,59 @@ 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"][];
+            /** @description Always `null` — autocomplete returns a single bounded, ranked page (no cursor). Present for envelope consistency (task 008 / G13). */
+            pagination: components["schemas"]["PaginationResponseDto"] | null;
         };
         HashtagDetailResponseDto: {
             /**
@@ -3284,10 +3792,11 @@ interface components {
         };
         LeaveConversationDto: {
             /**
-             * @description The participant leaving.
+             * @deprecated
+             * @description DEPRECATED — use `?actor_id=`. The participant leaving.
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            actor_id: string;
+            actor_id?: string;
         };
         MarkAllReadDto: {
             /**
@@ -3469,6 +3978,10 @@ interface components {
              */
             updated_at: string;
         };
+        MutedTermListResponseDto: {
+            data: components["schemas"]["MutedTermResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
         MutedTermResponseDto: {
             /**
              * @description Owning actor UUID.
@@ -3595,9 +4108,58 @@ interface components {
              */
             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: {
             /**
-             * @description `true` when at least one more page exists. Mirrors `next_cursor !== null`; published as a separate field so SDKs can drive a `while` loop without parsing the cursor.
+             * @description `true` when at least one more page exists. Mirrors `next_cursor !== null`; published as a separate field so SDKs can drive a `while` loop without parsing the cursor. A short or empty `data` array does NOT imply the end of the list when a lane post-filters — always page until this is `false`.
              * @example true
              */
             has_more: boolean;
@@ -3668,6 +4230,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.
@@ -3837,6 +4430,52 @@ interface components {
         PostSearchResponseDto: {
             /** @description Up to `limit` (default 20, max 50) hits. Not paginated in v1. */
             data: components["schemas"]["PostSearchHitDto"][];
+            /** @description Always `null` — this lane returns a single bounded, ranked page (no cursor in v1). Present for envelope consistency. */
+            pagination: components["schemas"]["PaginationResponseDto"] | null;
+        };
+        PostStateRequestDto: {
+            /**
+             * @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"
+             *     ]
+             */
+            post_ids: string[];
+        };
+        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"][];
+        };
+        PostViewerStateEntryDto: {
+            /**
+             * @description The viewer has bookmarked the post.
+             * @example true
+             */
+            bookmarked: boolean;
+            /**
+             * @description Post UUID this entry describes.
+             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
+             */
+            post_id: string;
+            /**
+             * @description Reaction types the viewer currently has on the post, sorted ascending. Empty when the viewer has not reacted.
+             * @example [
+             *       "fire",
+             *       "like"
+             *     ]
+             */
+            reacted_types: string[];
+            /**
+             * @description The viewer has a currently-published repost of the post.
+             * @example false
+             */
+            reposted: boolean;
+            /**
+             * @description Poll option index the viewer voted for; `null` when the viewer has not voted (or the post has no poll).
+             * @example null
+             */
+            voted_option: number | null;
         };
         ReactionCountsResponseDto: {
             /**
@@ -3907,10 +4546,16 @@ interface components {
         };
         RecordViewDto: {
             /**
-             * @description Viewer social actor UUID.
+             * @description Viewer social actor UUID. Standardized name (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000002
              */
-            viewer_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            viewer_actor_id?: string;
         };
         RecordViewsDto: {
             /**
@@ -3922,19 +4567,77 @@ interface components {
              */
             post_ids: string[];
         };
+        RelationshipEntryDto: {
+            /**
+             * @description This actor has blocked the source actor — surface it BEFORE attempting a follow/react write instead of handling the 409.
+             * @example false
+             */
+            blocked_by: boolean;
+            /**
+             * @description The source actor has blocked this actor.
+             * @example false
+             */
+            blocking: boolean;
+            /**
+             * @description This actor is on the source actor's close-friend list.
+             * @example false
+             */
+            close_friend: boolean;
+            /**
+             * @description Destination actor UUID this entry describes.
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            dst_actor_id: string;
+            /**
+             * @description This actor follows the source actor.
+             * @example false
+             */
+            followed_by: boolean;
+            /**
+             * @description The source actor follows this actor.
+             * @example true
+             */
+            following: boolean;
+            /**
+             * @description The source actor has muted this actor.
+             * @example false
+             */
+            muting: boolean;
+            /**
+             * @description The source actor has restricted this actor.
+             * @example false
+             */
+            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 Caller — social actor UUID. Must equal the list owner.
+             * @deprecated
+             * @description DEPRECATED — use `?actor_id=`. Caller social actor UUID (must equal the list owner).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            caller_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             */
+            caller_actor_id?: string;
         };
         RemoveMemberDto: {
             /**
-             * @description Social actor UUID of the acting party. Equal to the target for self-leave.
+             * @deprecated
+             * @description DEPRECATED — use `?actor_id=`. Acting actor UUID (equal to the target for self-leave).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            caller_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             */
+            caller_actor_id?: string;
         };
         RenameGroupDto: {
             /**
@@ -3951,6 +4654,11 @@ interface components {
             pagination: components["schemas"]["PaginationResponseDto"];
         };
         SendMessageDto: {
+            /**
+             * @description The sender — social actor UUID. Standardized name (task 008 / G11); the persisted `sender_id` defaults from it.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id?: string;
             attachments?: components["schemas"]["DirectMessageAttachmentDto"][];
             /**
              * @description Message body. Required when `kind="text"`. 1..10000 chars after trim.
@@ -3965,10 +4673,11 @@ interface components {
             /** @description Threaded inline reply target. */
             reply_to_id?: string | null;
             /**
-             * @description The sender — social actor UUID.
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            sender_id: string;
+            sender_id?: string;
         };
         StoryTrayEntryResponse: {
             /**
@@ -4009,6 +4718,8 @@ interface components {
         };
         StoryTrayResponse: {
             data: components["schemas"]["StoryTrayEntryResponse"][];
+            /** @description Always `null` — the tray is a single bounded page (≤200 entries, no cursor in v1). The key is present for envelope consistency with cursor-paginated lists (task 008 / G13). */
+            pagination: components["schemas"]["PaginationResponseDto"] | null;
         };
         StoryViewerResponse: {
             /**
@@ -4058,6 +4769,8 @@ interface components {
         SuggestedFollowsListResponseDto: {
             /** @description Ordered candidates. FoF candidates are returned first (highest count first); cold-start fallbacks fill any remaining slots up to the requested limit. */
             data: components["schemas"]["SuggestedFollowResponseDto"][];
+            /** @description Always `null` — suggestions are a single bounded, scored page (no cursor in v1). Present for envelope consistency (task 008 / G13). */
+            pagination: components["schemas"]["PaginationResponseDto"] | null;
         };
         UnreadCountResponse: {
             /**
@@ -4110,7 +4823,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";
         };
@@ -4140,16 +4854,22 @@ interface components {
             role: "member" | "admin";
         };
         UpdateMessageDto: {
+            /**
+             * @description The sender — must match the message's sender_id. Standardized name (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id?: string;
             /**
              * @description Updated body.
              * @example edited
              */
             body: string;
             /**
-             * @description The sender — must match the message's sender_id.
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            sender_id: string;
+            sender_id?: string;
         };
         UpdateNotificationDto: {
             /**
@@ -4189,8 +4909,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;
         };
@@ -4226,6 +4951,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.
@@ -4253,13 +4993,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
@@ -4302,10 +5042,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: {
@@ -4316,7 +5058,7 @@ 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;
@@ -4325,7 +5067,7 @@ interface operations {
                     "application/json": components["schemas"]["ActorPageResponseDto"];
                 };
             };
-            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            /** @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;
@@ -4408,6 +5150,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;
@@ -4587,6 +5437,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: {
@@ -4605,10 +5457,10 @@ 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`. */
+            /** @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;
@@ -4891,6 +5743,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: {
@@ -4909,10 +5763,10 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["EdgeListResponseDto"];
+                    "application/json": components["schemas"]["FollowerEdgeListResponseDto"];
                 };
             };
-            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            /** @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;
@@ -4946,6 +5800,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: {
@@ -4964,10 +5820,10 @@ 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`. */
+            /** @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;
@@ -5158,6 +6014,11 @@ interface operations {
                 /** @description Cursor from the prior page. */
                 cursor?: string;
                 /** @description Requester social actor UUID. Without it, only public pinned posts surface. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -5249,7 +6110,12 @@ interface operations {
     };
     MutedTermController_list: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 50, max 200). */
+                limit?: string;
+                /** @description Opaque cursor from a prior page's `pagination.next_cursor`. */
+                cursor?: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. */
@@ -5261,13 +6127,13 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Active muted terms. */
+            /** @description Active muted terms, paginated. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MutedTermResponseDto"][];
+                    "application/json": components["schemas"]["MutedTermListResponseDto"];
                 };
             };
             /** @description PAK lacks `social.list`. */
@@ -5394,6 +6260,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: {
@@ -5412,10 +6280,10 @@ 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`. */
+            /** @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;
@@ -5752,11 +6620,69 @@ interface operations {
             };
         };
     };
+    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"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community or actor not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     EdgeController_listRestricts: {
         parameters: {
             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: {
@@ -5775,10 +6701,10 @@ 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`. */
+            /** @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;
@@ -5913,13 +6839,68 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Ordered candidates. */
+            /** @description Ordered candidates. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["SuggestedFollowsListResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community or actor not found (or belongs to a different community). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    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"]["SuggestedFollowsListResponseDto"];
+                    "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`. */
@@ -5931,7 +6912,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community or actor not found (or belongs to a different community). */
+            /** @description Community or source actor not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -6212,7 +7193,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;
@@ -6234,7 +7218,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;
@@ -6261,7 +7245,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;
@@ -6364,7 +7348,10 @@ interface operations {
     };
     ConversationController_leave: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description The leaving participant — social actor UUID. */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
@@ -6387,6 +7374,15 @@ interface operations {
                 };
                 content?: never;
             };
+            /** @description Missing/invalid actor_id. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description PAK lacks `social.delete`. */
             403: {
                 headers: {
@@ -6530,7 +7526,10 @@ interface operations {
     };
     ConversationController_removeMember: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description Acting actor UUID (equal to the target for self-leave). */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
@@ -6555,6 +7554,15 @@ interface operations {
                 };
                 content?: never;
             };
+            /** @description Missing/invalid actor_id. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description Caller is not an admin and not the target. */
             403: {
                 headers: {
@@ -6695,7 +7703,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;
@@ -6719,7 +7730,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;
@@ -6746,7 +7757,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;
@@ -6759,7 +7770,10 @@ interface operations {
     };
     ConversationController_deleteMessage: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description The sender — must match the message's sender_id. */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
@@ -6784,6 +7798,15 @@ interface operations {
                 };
                 content?: never;
             };
+            /** @description Missing/invalid actor_id. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description Caller is not the sender, or PAK lacks `social.delete`. */
             403: {
                 headers: {
@@ -7156,9 +8179,68 @@ 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?: {
+                /** @description Viewer actor UUID. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 viewer_actor_id?: string;
                 limit?: number;
                 /** @description Opaque ranked cursor; encodes (score, id). */
@@ -7346,6 +8428,60 @@ interface operations {
             };
         };
     };
+    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: {
         parameters: {
             query?: never;
@@ -7543,7 +8679,12 @@ interface operations {
     ActorListController_list: {
         parameters: {
             query?: {
-                /** @description Surface the viewer's own private lists alongside the public catalog. */
+                /** @description Viewer actor UUID — surfaces the viewer's own private lists alongside the public catalog. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 viewer_actor_id?: string;
                 /** @description Filter to lists owned by this actor. */
                 owner_actor_id?: string;
@@ -7582,7 +8723,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;
@@ -7604,7 +8748,7 @@ interface operations {
                     "application/json": components["schemas"]["ActorListResponseDto"];
                 };
             };
-            /** @description Validation failure. */
+            /** @description Validation failure (including malformed Idempotency-Key). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -7631,12 +8775,26 @@ 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: {
         parameters: {
             query?: {
-                /** @description Required to see a private list (must equal owner). */
+                /** @description Viewer actor UUID — required to see a private list (must equal owner). */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 viewer_actor_id?: string;
             };
             header?: never;
@@ -7681,7 +8839,10 @@ interface operations {
     };
     ActorListController_delete: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description Caller social actor UUID (must equal the list owner). */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. */
@@ -7704,6 +8865,15 @@ interface operations {
                 };
                 content?: never;
             };
+            /** @description Missing/invalid actor_id. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description Caller is not the owner. */
             403: {
                 headers: {
@@ -7784,7 +8954,12 @@ interface operations {
         parameters: {
             query: {
                 /** @description Viewer — required for visibility checks + block-filter. */
-                viewer_actor_id: string;
+                actor_id: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
+                viewer_actor_id?: string;
                 limit?: number;
                 /** @description Opaque cursor; differs in shape between ranked and chronological. */
                 cursor?: string;
@@ -7810,7 +8985,7 @@ interface operations {
                     "application/json": components["schemas"]["FeedResponseDto"];
                 };
             };
-            /** @description INVALID_ORDER or INVALID_CURSOR. */
+            /** @description Missing/invalid actor_id, INVALID_ORDER, or INVALID_CURSOR. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -7842,6 +9017,12 @@ interface operations {
     ActorListController_listMembers: {
         parameters: {
             query?: {
+                /** @description Viewer actor UUID. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 viewer_actor_id?: string;
                 limit?: number;
                 cursor?: string;
@@ -7944,7 +9125,10 @@ interface operations {
     };
     ActorListController_removeMember: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description Caller social actor UUID (must equal the list owner). */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. */
@@ -7969,6 +9153,15 @@ interface operations {
                 };
                 content?: never;
             };
+            /** @description Missing/invalid actor_id. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description Caller is not the owner. */
             403: {
                 headers: {
@@ -8117,21 +9310,95 @@ interface operations {
             path: {
                 communityId: string;
             };
-            cookie?: never;
-        };
-        requestBody?: never;
-        responses: {
-            /** @description Page of posts (only `published`, non-expired, public-visibility unless filtered by author). */
-            200: {
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of posts (only `published`, non-expired, public-visibility unless filtered by author). */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PostListResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    PostController_create: {
+        parameters: {
+            query?: 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;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreatePostDto"];
+            };
+        };
+        responses: {
+            /** @description Post created. Defaults: `kind=text`, `visibility=public`, `status=published`. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PostResponseDto"];
+                };
+            };
+            /** @description Validation failure (missing actor_id; body/title/url all empty; bad URL; bad ISO timestamp; malformed Idempotency-Key). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.create`, or actor is suspended. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community, actor, or quote source post not found in the PAK's workspace. */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["PostListResponseDto"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.list`. */
-            403: {
+            /** @description `IDEMPOTENCY_KEY_REUSE` — the supplied Idempotency-Key was already used with a different request body. */
+            409: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -8139,8 +9406,8 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community not found. */
-            404: {
+            /** @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;
                 };
@@ -8150,7 +9417,7 @@ interface operations {
             };
         };
     };
-    PostController_create: {
+    PostController_recordImpressions: {
         parameters: {
             query?: never;
             header?: never;
@@ -8161,20 +9428,18 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CreatePostDto"];
+                "application/json": components["schemas"]["RecordViewsDto"];
             };
         };
         responses: {
-            /** @description Post created. Defaults: `kind=text`, `visibility=public`, `status=published`. */
-            201: {
+            /** @description Impressions recorded (or no-op if every id was missing). */
+            204: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["PostResponseDto"];
-                };
+                content?: never;
             };
-            /** @description Validation failure (missing actor_id; body/title/url all empty; bad URL; bad ISO timestamp). */
+            /** @description Empty `post_ids`, more than 200 ids, or a non-UUID in the list. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8183,7 +9448,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.create`, or actor is suspended. */
+            /** @description PAK lacks `social.view` on the community URN. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -8192,27 +9457,9 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @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 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;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponseDto"];
-                };
-            };
         };
     };
-    PostController_recordViews: {
+    PostController_recordViewsDeprecated: {
         parameters: {
             query?: never;
             header?: never;
@@ -8227,7 +9474,7 @@ interface operations {
             };
         };
         responses: {
-            /** @description Views recorded (or no-op if every id was missing). */
+            /** @description Impressions recorded (or no-op if every id was missing). */
             204: {
                 headers: {
                     [name: string]: unknown;
@@ -8243,7 +9490,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.list` on the community URN. */
+            /** @description PAK lacks `social.view` on the community URN. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -8258,6 +9505,11 @@ interface operations {
         parameters: {
             query?: {
                 /** @description Social actor UUID of the viewer. Surfaces non-public posts they are entitled to see. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11). Removed in a future version.
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -8461,7 +9713,10 @@ interface operations {
     };
     BookmarkController_delete: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description Acting actor UUID. */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
@@ -8471,9 +9726,9 @@ interface operations {
             };
             cookie?: never;
         };
-        requestBody: {
+        requestBody?: {
             content: {
-                "application/json": components["schemas"]["CreateBookmarkDto"];
+                "application/json": components["schemas"]["DeprecatedActorIdBodyDto"];
             };
         };
         responses: {
@@ -8484,7 +9739,7 @@ interface operations {
                 };
                 content?: never;
             };
-            /** @description Validation failure. */
+            /** @description Validation failure (missing/invalid actor_id). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8521,6 +9776,11 @@ interface operations {
                 /** @description List replies of this parent comment instead of top-level. */
                 parent_id?: string;
                 /** @description Viewer actor UUID — surfaces author_only replies they're entitled to see. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -8566,7 +9826,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;
@@ -8590,7 +9853,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;
@@ -8617,7 +9880,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;
@@ -8631,6 +9894,12 @@ interface operations {
     CommentController_getById: {
         parameters: {
             query?: {
+                /** @description Viewer actor UUID. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -9113,6 +10382,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;
@@ -9301,7 +10627,10 @@ interface operations {
     };
     RepostController_delete: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description Acting actor UUID. */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
@@ -9311,9 +10640,9 @@ interface operations {
             };
             cookie?: never;
         };
-        requestBody: {
+        requestBody?: {
             content: {
-                "application/json": components["schemas"]["CreateRepostDto"];
+                "application/json": components["schemas"]["DeprecatedActorIdBodyDto"];
             };
         };
         responses: {
@@ -9324,7 +10653,7 @@ interface operations {
                 };
                 content?: never;
             };
-            /** @description Validation failure. */
+            /** @description Validation failure (missing/invalid actor_id). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -9448,7 +10777,12 @@ interface operations {
         parameters: {
             query: {
                 /** @description Requester social actor UUID — must resolve to the post author. */
-                requester_id: string;
+                actor_id: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
+                requester_id?: string;
                 limit?: number;
                 /** @description Cursor from the prior page. */
                 cursor?: string;
@@ -9473,6 +10807,15 @@ interface operations {
                     "application/json": components["schemas"]["StoryViewersResponse"];
                 };
             };
+            /** @description Missing/invalid actor_id (author-only endpoint). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description PAK lacks `social.list` OR requester is not the post author. */
             403: {
                 headers: {
@@ -9751,6 +11094,11 @@ interface operations {
                 /** @description Max hits to return. */
                 limit?: number;
                 /** @description Viewer social actor UUID — filters out blocked / muted actors. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -9860,6 +11208,12 @@ interface operations {
                 q: string;
                 limit?: number;
                 order?: "relevance" | "recent";
+                /** @description Viewer social actor UUID. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -9909,7 +11263,7 @@ interface operations {
             };
         };
     };
-    WebhookController_getActive: {
+    WebhookController_list: {
         parameters: {
             query?: never;
             header?: never;
@@ -9921,13 +11275,13 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description The active webhook, or a literal JSON `null` body when the community has no active webhook registered. */
+            /** @description All webhooks on the community (no pagination — capped at 10 rows). */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["WebhookResponseDto"] | null;
+                    "application/json": components["schemas"]["WebhookListResponseDto"];
                 };
             };
             /** @description Community not found. */
@@ -9944,7 +11298,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;
@@ -9966,7 +11323,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;
@@ -9993,7 +11350,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;
@@ -10154,10 +11511,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;
@@ -10177,6 +11582,15 @@ 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: {
@@ -10186,12 +11600,89 @@ 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"];
+                };
+            };
         };
     };
-    CommunityController_list: {
+    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: {
+                    [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"];
+                };
+            };
+        };
+    };
+    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: {
+        parameters: {
+            query?: {
+                /** @description Page size (default 50, max 200). */
+                limit?: string;
+                /** @description Opaque cursor from a prior page's `pagination.next_cursor`. */
+                cursor?: string;
+            };
+            header?: never;
             path: {
                 /** @description ProductCraft workspace UUID owning the community. */
                 workspaceId: string;
@@ -10200,13 +11691,13 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Bare array of communities; not paginated (workspaces have a small handful). */
+            /** @description Paginated communities. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["CommunityResponseDto"][];
+                    "application/json": components["schemas"]["CommunityListResponseDto"];
                 };
             };
             /** @description Caller lacks `social.list`, or the workspace has not enabled the `social` service. */
@@ -10225,6 +11716,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. */
@@ -10247,7 +11740,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;
@@ -10283,7 +11776,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;
@@ -10480,7 +11973,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;
@@ -10503,7 +11999,7 @@ interface operations {
                     "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;
@@ -10530,6 +12026,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: {
@@ -10765,7 +12270,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;
@@ -10788,7 +12296,7 @@ interface operations {
                     "application/json": components["schemas"]["ActOnFlagResponseDto"];
                 };
             };
-            /** @description Invalid action or notes. */
+            /** @description Invalid action or notes, or malformed Idempotency-Key. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -10815,7 +12323,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @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. */
+            /** @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;