@productcraft/social 0.4.0 → 0.5.0

package/dist/index.d.cts

@@ -94,6 +94,43 @@ interface paths {
         patch: operations["ActorController_update"];
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/{actorId}/archived": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List the actor's archived posts (status='archived'), newest-first. Cursor-paginated.
+         * @description Archived posts keep their engagement (reaction / comment counts intact) but fall out of every public surface, and `getById` treats them as author-only. Restore one with PATCH `{ status: 'published' }`. Same end-user authorization rules as drafts: the PAK lane trusts the customer-backend to gate the caller.
+         */
+        get: operations["DraftController_listArchived"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/actors/{actorId}/assets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List an actor's uploaded assets — the "your uploads" surface + GDPR export walk. 50/page (max 200), cursor-paginated newest-first. */
+        get: operations["AssetController_listByActor"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/actors/{actorId}/blocks": {
         parameters: {
             query?: never;
@@ -168,6 +205,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/{actorId}/dismissed-suggestions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List actors this actor has dismissed from suggestions. Pass `?expand=dst_actor` to nest each actor's full row. */
+        get: operations["EdgeController_listDismissedSuggestions"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/actors/{actorId}/drafts": {
         parameters: {
             query?: never;
@@ -205,6 +259,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/{actorId}/follow-requests": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List incoming follow requests for a (private) actor, newest-first (task 014). */
+        get: operations["EdgeController_listIncomingRequests"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/actors/{actorId}/followers": {
         parameters: {
             query?: never;
@@ -274,6 +345,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/{actorId}/hides": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List the posts an actor has hidden, newest-first. */
+        get: operations["EdgeController_listHides"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/actors/{actorId}/highlights": {
         parameters: {
             query?: never;
@@ -294,6 +382,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/{actorId}/insights": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** An actor's follower time series: live follower_count plus a nightly-snapshot daily series over ?from/?to (default trailing 30 days). */
+        get: operations["InsightsController_actorInsights"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/actors/{actorId}/mentions": {
         parameters: {
             query?: never;
@@ -583,6 +688,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/actors/{actorId}/tagged": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List posts an actor is tagged in.
+         * @description Approved tags only, on published + unexpired posts, newest-tag-first. Visibility- and block-aware: pass the viewer via `requester_id` to surface followers / close-friends posts they may read; without it only public posts appear. Pages may be short (post-visibility filtering) but never skip or duplicate.
+         */
+        get: operations["PostTagController_listTagged"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/actors/{srcActorId}/relationships": {
         parameters: {
             query?: never;
@@ -603,6 +728,41 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/assets": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Upload an image. Processed synchronously (EXIF stripped, renditions generated) and stored in a private bucket. Returns the asset id + status. */
+        post: operations["AssetController_upload"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/assets/{assetId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Fetch one asset with freshly-minted presigned rendition URLs. */
+        get: operations["AssetController_get"];
+        put?: never;
+        post?: never;
+        /** Delete an asset — removes every stored rendition object, then the row. */
+        delete: operations["AssetController_delete"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/blocks": {
         parameters: {
             query?: never;
@@ -677,6 +837,79 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/collections": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List collections. Public ones are visible to anyone; private ones surface only to their owner via actor_id. Filter by owner_actor_id / kind. */
+        get: operations["CollectionController_list"];
+        put?: never;
+        /** Create a collection. Default kind `bookmark`, visibility `private`. Pass an Idempotency-Key so retries are safe. */
+        post: operations["CollectionController_create"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/collections/{collectionId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Fetch one collection. Private collections resolve only for their owner (via actor_id). */
+        get: operations["CollectionController_getById"];
+        put?: never;
+        post?: never;
+        /** Delete a collection (owner only). Items cascade; the posts themselves are untouched. */
+        delete: operations["CollectionController_delete"];
+        options?: never;
+        head?: never;
+        /** Update a collection (owner only) — rename, cover, visibility, reorder position. */
+        patch: operations["CollectionController_update"];
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/collections/{collectionId}/items": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List a collection's posts in curator order. Highlight collections bypass story expiry; bookmark collections drop expired posts. 50/page (max 200). */
+        get: operations["CollectionController_listItems"];
+        put?: never;
+        /** Add a post to a collection (owner only). Idempotent per (collection, post). */
+        post: operations["CollectionController_addItem"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/collections/{collectionId}/items/{postId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Remove a post from a collection (owner only). */
+        delete: operations["CollectionController_removeItem"];
+        options?: never;
+        head?: never;
+        /** Reorder a post within a collection (owner only). */
+        patch: operations["CollectionController_reorderItem"];
+        trace?: never;
+    };
     "/v1/communities/{communityId}/conversations": {
         parameters: {
             query?: never;
@@ -727,7 +960,7 @@ interface paths {
         delete: operations["ConversationController_leave"];
         options?: never;
         head?: never;
-        /** Update the caller's participant row — toggle muted today. */
+        /** Conversation-level update (task 025). Pass `name` to rename a group (admin-only) — the canonical rename home. The participant fields (muted / muted_until / pinned) are the DEPRECATED alias for PATCH /:id/members/:actorId. */
         patch: operations["ConversationController_update"];
         trace?: never;
     };
@@ -762,8 +995,8 @@ interface paths {
         delete: operations["ConversationController_removeMember"];
         options?: never;
         head?: never;
-        /** Promote / demote a participant. Admin-only. */
-        patch: operations["ConversationController_updateMemberRole"];
+        /** Update a participant (task 025). Field-level authz: `role` is admin-only; `muted` / `muted_until` / `pinned` are self-only (the caller must be the path actor). The canonical home for participant state — the participant fields on PATCH /conversations/:id are the deprecated alias. */
+        patch: operations["ConversationController_updateMember"];
         trace?: never;
     };
     "/v1/communities/{communityId}/conversations/{conversationId}/messages": {
@@ -791,7 +1024,8 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /** Fetch a single message (task 024) — resolves a reply target without paging the whole thread. Participant-gated. */
+        get: operations["ConversationController_getMessage"];
         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)"`. Pass the sender via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
@@ -850,7 +1084,10 @@ interface paths {
         delete?: never;
         options?: never;
         head?: never;
-        /** Rename a group conversation. Admin-only. */
+        /**
+         * DEPRECATED (task 025) — rename via PATCH /conversations/:id with `name`. Rename a group conversation. Admin-only.
+         * @deprecated
+         */
         patch: operations["ConversationController_renameGroup"];
         trace?: never;
     };
@@ -905,7 +1142,7 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/communities/{communityId}/flags": {
+    "/v1/communities/{communityId}/dismissed-suggestions": {
         parameters: {
             query?: never;
             header?: never;
@@ -914,15 +1151,15 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** File a moderation report against a post or comment. Idempotent per (reporter, target) while open. */
-        post: operations["FlagController_create"];
+        /** Dismiss an actor from your follow suggestions ("don't suggest"). Idempotent. The actor never re-appears in your suggestions. */
+        post: operations["EdgeController_dismissSuggestion"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/communities/{communityId}/follows": {
+    "/v1/communities/{communityId}/dismissed-suggestions/{srcActorId}/{dstActorId}": {
         parameters: {
             query?: never;
             header?: never;
@@ -931,32 +1168,33 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Follow another actor. Idempotent: returns existing edge with `created: false` if the follow already exists. Refused if either side has a block. */
-        post: operations["EdgeController_follow"];
-        delete?: never;
+        post?: never;
+        /** Un-dismiss a suggestion. Idempotent — 204 either way. The actor becomes eligible for suggestions again. */
+        delete: operations["EdgeController_undismissSuggestion"];
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/communities/{communityId}/follows/batch": {
+    "/v1/communities/{communityId}/flags": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /** List a reporter's own flags (task 017). Requires `reporter_actor_id` — the customer lane sees only that reporter's reports ("was my report reviewed?"), never other reporters' flags. Cursor-paginated newest-first. */
+        get: operations["FlagController_listMine"];
         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"];
+        /** File a moderation report against a post or comment. Idempotent per (reporter, target) while open. */
+        post: operations["FlagController_create"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/communities/{communityId}/follows/{srcActorId}/{dstActorId}": {
+    "/v1/communities/{communityId}/follow-requests/{dstActorId}/{srcActorId}": {
         parameters: {
             query?: never;
             header?: never;
@@ -966,110 +1204,107 @@ interface paths {
         get?: never;
         put?: never;
         post?: never;
-        /** Unfollow. Idempotent — 204 even if the follow didn't exist. */
-        delete: operations["EdgeController_unfollow"];
+        /** Decline a pending follow request (task 014). Deletes the request; no edge, no notification. */
+        delete: operations["EdgeController_declineFollowRequest"];
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/communities/{communityId}/hashtags": {
+    "/v1/communities/{communityId}/follow-requests/{dstActorId}/{srcActorId}/approve": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List hashtags in this community. Cursor-paginated by `first_used_at` desc. */
-        get: operations["HashtagController_list"];
+        get?: never;
         put?: never;
-        post?: never;
+        /** Approve a pending follow request (task 014). The destination (private) actor approves the requesting actor; a follow edge is created. */
+        post: operations["EdgeController_approveFollowRequest"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/communities/{communityId}/hashtags/{tag}": {
+    "/v1/communities/{communityId}/follows": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Get a single hashtag with its current published post count. */
-        get: operations["HashtagController_getOne"];
+        get?: never;
         put?: never;
-        post?: never;
+        /** Follow another actor. Idempotent. If the destination is private (task 014), a follow request is created instead and the response is `{ status: "pending", edge: null }`; approve/decline it via the follow-request routes. Refused if either side has a block. */
+        post: operations["EdgeController_follow"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/communities/{communityId}/hashtags/{tag}/posts": {
+    "/v1/communities/{communityId}/follows/batch": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List posts using a hashtag. Same wire shape as the regular post list. */
-        get: operations["HashtagFeedController_list"];
+        get?: never;
         put?: never;
-        post?: 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}/lists": {
+    "/v1/communities/{communityId}/follows/{srcActorId}/{dstActorId}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** 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"];
+        get?: never;
         put?: never;
-        /** 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;
+        post?: never;
+        /** Unfollow. Idempotent — 204 even if the follow didn't exist. */
+        delete: operations["EdgeController_unfollow"];
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/communities/{communityId}/lists/{listId}": {
+    "/v1/communities/{communityId}/hashtags": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Get one list by id. */
-        get: operations["ActorListController_getById"];
+        /** List hashtags in this community. Default order is `first_used_at` desc; `order=trending` ranks by windowed post count (task 023) — pass `window=24h|7d`. `window_post_count` is populated only when trending. */
+        get: operations["HashtagController_list"];
         put?: never;
         post?: never;
-        /** Delete a list. Owner-only. Pass the caller via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
-        delete: operations["ActorListController_delete"];
+        delete?: never;
         options?: never;
         head?: never;
-        /** Update list name / description / visibility. Owner-only. */
-        patch: operations["ActorListController_update"];
+        patch?: never;
         trace?: never;
     };
-    "/v1/communities/{communityId}/lists/{listId}/feed": {
+    "/v1/communities/{communityId}/hashtags/{tag}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List-scoped feed (task 018). Returns posts authored by members of the list, filtered by what the viewer can see. Default order is `chronological`; pass `order=ranked` for the same engagement-blended scoring used by the actor feed. */
-        get: operations["FeedController_getListFeed"];
+        /** Get a single hashtag with its current published post count. */
+        get: operations["HashtagController_getOne"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1078,25 +1313,130 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/communities/{communityId}/lists/{listId}/members": {
+    "/v1/communities/{communityId}/hashtags/{tag}/posts": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List members of a list. Public lists are visible to anyone; private lists surface only when viewer_actor_id is the owner. */
-        get: operations["ActorListController_listMembers"];
+        /** List posts using a hashtag. `order=chronological` (default) or `order=ranked` (task 023) — ranked reuses the discover recency+engagement scoring, paginated on a (score, id) cursor. Same wire shape as the regular post list. */
+        get: operations["HashtagFeedController_list"];
         put?: never;
-        /** Add a member to a list. Owner-only. */
-        post: operations["ActorListController_addMember"];
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/communities/{communityId}/lists/{listId}/members/{actorId}": {
+    "/v1/communities/{communityId}/hides": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Hide a post from the actor's feeds ("not interested"). Idempotent. A hard filter — the post drops out of home + discover for that actor only. */
+        post: operations["EdgeController_hidePost"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/hides/{srcActorId}/{postId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Un-hide a post. Idempotent — 204 either way. */
+        delete: operations["EdgeController_unhidePost"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/lists": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** 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`. 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;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/lists/{listId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Get one list by id. */
+        get: operations["ActorListController_getById"];
+        put?: never;
+        post?: never;
+        /** 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;
+        /** Update list name / description / visibility. Owner-only. */
+        patch: operations["ActorListController_update"];
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/lists/{listId}/feed": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List-scoped feed (task 018). Returns posts authored by members of the list, filtered by what the viewer can see. Default order is `chronological`; pass `order=ranked` for the same engagement-blended scoring used by the actor feed. */
+        get: operations["FeedController_getListFeed"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/lists/{listId}/members": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List members of a list. Public lists are visible to anyone; private lists surface only when viewer_actor_id is the owner. */
+        get: operations["ActorListController_listMembers"];
+        put?: never;
+        /** Add a member to a list. Owner-only. */
+        post: operations["ActorListController_addMember"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/lists/{listId}/members/{actorId}": {
         parameters: {
             query?: never;
             header?: never;
@@ -1299,6 +1639,30 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/posts/{postId}/comments/{commentId}/pin": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Pin a top-level comment (post-author only).
+         * @description Pins a published top-level comment so it leads the top-level listing. Reserved to the post author (403 otherwise). 409 on a reply, a non-published comment, or when the per-post pin cap (community.settings.max_pinned_comments, default 3) is reached. Idempotent.
+         */
+        post: operations["CommentController_pin"];
+        /**
+         * Unpin a comment (post-author only).
+         * @description Clears the pin; the comment returns to its chronological position. Reserved to the post author (403). Idempotent. Pass the acting actor via the request body.
+         */
+        delete: operations["CommentController_unpin"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/posts/{postId}/comments/{commentId}/reactions": {
         parameters: {
             query?: never;
@@ -1334,6 +1698,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/posts/{postId}/insights": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Aggregate insights for a post: total views, unique reach, engagement counts, and a daily views/reach series over ?from/?to (default trailing 30 days). */
+        get: operations["InsightsController_postInsights"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/posts/{postId}/poll-results": {
         parameters: {
             query?: never;
@@ -1467,6 +1848,46 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/posts/{postId}/tags/{actorId}/approve": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Approve a pending tag (tagged actor only).
+         * @description The tagged actor accepts being tagged; the tag flips `pending → approved` and the post starts surfacing on their `/tagged` listing. 403 if the acting actor is not the tagged actor. 409 if the tag was already removed.
+         */
+        post: operations["PostTagController_approve"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/communities/{communityId}/posts/{postId}/tags/{actorId}/remove": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Remove a tag (tagged actor or post author).
+         * @description Flips the tag to `removed`. Removable by either the tagged actor or the post author (403 otherwise). Idempotent on an already-removed tag.
+         */
+        post: operations["PostTagController_remove"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/posts/{postId}/viewers": {
         parameters: {
             query?: never;
@@ -1507,6 +1928,26 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/posts/{postId}/voters": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * List voters of a poll (author-only).
+         * @description Only the poll author can list voters. Pass the author via `actor_id`; a requester whose id != post.actor_id gets 403. Each entry carries the voter and their `option_index`. Optionally filter to a single option with `option`. Ordered newest-first.
+         */
+        get: operations["StoryController_listVoters"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/posts/{postId}/votes": {
         parameters: {
             query?: never;
@@ -1527,6 +1968,30 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/posts/{postId}/votes/{actorId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Read an actor's vote on a poll.
+         * @description Returns the actor's chosen `option_index` and when it was cast. 404 when the post is gone or the actor has not voted. Naturally idempotent — no Idempotency-Key.
+         */
+        get: operations["StoryController_getVote"];
+        put?: never;
+        post?: never;
+        /**
+         * Retract an actor's vote on a poll.
+         * @description Deletes the vote edge. Idempotent — 204 whether or not a vote existed. No tally decrement: results are computed from surviving votes.
+         */
+        delete: operations["StoryController_deleteVote"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/restricts": {
         parameters: {
             query?: never;
@@ -1780,15 +2245,15 @@ interface paths {
         patch: operations["CommunityController_update"];
         trace?: never;
     };
-    "/v1/workspaces/{workspaceId}/communities/{communityId}/analytics": {
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/actors/{actorId}/comments": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Community-level analytics rollup: total active actors, published posts, published comments, open flags, and last-7-day windows for each. */
-        get: operations["AnalyticsController_getCommunityAnalytics"];
+        /** Every comment an actor authored, all statuses (published / hidden / removed) — the GDPR-export view. 50/page (max 200), cursor-paginated newest-first. */
+        get: operations["ExportController_comments"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1797,33 +2262,32 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/actors/{actorId}/shadow-ban": {
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/actors/{actorId}/reactions": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /** Every reaction an actor has given — post reactions and comment reactions unified into one stream, discriminated by `target_type`. The GDPR-export view. 50/page (max 200), cursor-paginated newest-first. */
+        get: operations["ExportController_reactions"];
         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. 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"];
+        post?: never;
+        delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/audit": {
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/analytics": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** Append-only audit of moderator actions in this community. 50/page (max 200), cursor-paginated. */
-        get: operations["ModerationAdminController_listAudit"];
+        /** Community-level analytics rollup: total active actors, published posts, published comments, open flags, and last-7-day windows for each. */
+        get: operations["AnalyticsController_getCommunityAnalytics"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1832,49 +2296,50 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/conversations": {
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/actions": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List every conversation in the community, most-recent-activity first. Moderation-only. */
-        get: operations["ConversationModerationController_listConversations"];
+        get?: never;
         put?: never;
-        post?: never;
+        /** Apply a moderation action directly, without a preceding flag (task 017). Acts on any target — post/comment (status), direct_message (moderator soft-delete), or actor (ban=suspend / restore=reinstate). Writes a flag_id=null audit row. */
+        post: operations["ModerationAdminController_actDirect"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/conversations/{conversationId}/messages": {
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/actors/{actorId}/shadow-ban": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List every message in a conversation. Moderation-only. */
-        get: operations["ConversationModerationController_listMessages"];
+        get?: never;
         put?: never;
-        post?: never;
-        delete?: 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. 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"];
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/flags": {
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/audit": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List flags in this community. Filter by ?status=open|dismissed|actioned. 50/page (max 200), cursor-paginated. */
-        get: operations["ModerationAdminController_listFlags"];
+        /** Append-only audit of moderator actions in this community. 50/page (max 200), cursor-paginated. */
+        get: operations["ModerationAdminController_listAudit"];
         put?: never;
         post?: never;
         delete?: never;
@@ -1883,51 +2348,148 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/flags/{flagId}/actions": {
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/blocked-terms": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        get?: never;
+        /** List the community hidden-words lexicon, newest-first. Cursor-paginated (50/page, max 200). */
+        get: operations["ModerationAdminController_listBlockedTerms"];
         put?: never;
-        /** 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"];
+        /** Add a hidden word to the community lexicon. A comment whose body contains the term is routed to `action`: `hide` → lands hidden; `pending_approval` → lands in the approve lane. Re-adding a term updates its action. Case-insensitive. */
+        post: operations["ModerationAdminController_addBlockedTerm"];
         delete?: never;
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/shadow-banned": {
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/blocked-terms/{term}": {
         parameters: {
             query?: never;
             header?: never;
             path?: never;
             cookie?: never;
         };
-        /** List currently shadow-banned actors in this community. 50/page (max 200), cursor-paginated newest-ban first. */
-        get: operations["ModerationAdminController_listShadowBanned"];
+        get?: never;
         put?: never;
         post?: never;
-        delete?: never;
+        /** Remove a hidden word. Idempotent — 204 whether or not it existed. */
+        delete: operations["ModerationAdminController_removeBlockedTerm"];
         options?: never;
         head?: never;
         patch?: never;
         trace?: never;
     };
-}
-interface components {
-    schemas: {
-        ActOnFlagResponseDto: {
-            /** @description The flag after the action (status flipped to actioned/dismissed for punitive/dismiss actions; reversals re-resolve it too). */
-            flag: components["schemas"]["FlagResponseDto"];
-            /** @description The audit row this action recorded. */
-            moderation_action: components["schemas"]["ModerationActionResponseDto"];
-        };
-        ActorCountersResponseDto: {
-            /**
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/conversations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List every conversation in the community, most-recent-activity first. Moderation-only. */
+        get: operations["ConversationModerationController_listConversations"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/conversations/{conversationId}/messages": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List every message in a conversation. Moderation-only. */
+        get: operations["ConversationModerationController_listMessages"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/flags": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List flags in this community. Filter by ?status=open|dismissed|actioned. 50/page (max 200), cursor-paginated. */
+        get: operations["ModerationAdminController_listFlags"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/flags/{flagId}/actions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** 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;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/workspaces/{workspaceId}/communities/{communityId}/moderation/shadow-banned": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** List currently shadow-banned actors in this community. 50/page (max 200), cursor-paginated newest-ban first. */
+        get: operations["ModerationAdminController_listShadowBanned"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+}
+interface components {
+    schemas: {
+        ActOnFlagResponseDto: {
+            /** @description The flag after the action (status flipped to actioned/dismissed for punitive/dismiss actions; reversals re-resolve it too). */
+            flag: components["schemas"]["FlagResponseDto"];
+            /** @description The audit row this action recorded. */
+            moderation_action: components["schemas"]["ModerationActionResponseDto"];
+        };
+        ActingActorDto: {
+            /**
+             * @description The actor performing the action (approve: the tagged actor; remove: the tagged actor or the post author).
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            actor_id: string;
+        };
+        ActorCommentsResponseDto: {
+            data: components["schemas"]["CommentResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        ActorCountersResponseDto: {
+            /**
              * @description Actor UUID.
              * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
              */
@@ -1988,6 +2550,24 @@ interface components {
              */
             src_actor_id?: string;
         };
+        ActorFollowerPointDto: {
+            /** @example 2026-05-01 */
+            day: string;
+            /** @example 1240 */
+            follower_count: number;
+        };
+        ActorInsightsResponseDto: {
+            /** @example aaaaaaaa-0000-0000-0000-000000000001 */
+            actor_id: string;
+            /** @example cccccccc-cccc-cccc-cccc-cccccccccccc */
+            community_id: string;
+            daily: components["schemas"]["ActorFollowerPointDto"][];
+            /**
+             * @description Live follower count.
+             * @example 1240
+             */
+            follower_count: number;
+        };
         ActorListListResponseDto: {
             data: components["schemas"]["ActorListResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -2070,6 +2650,33 @@ interface components {
             data: components["schemas"]["ActorResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
+        ActorReactionEntryDto: {
+            /**
+             * @description ISO timestamp the reaction was recorded.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description UUID of the reacted-to post or comment (per `target_type`).
+             * @example pppppppp-pppp-pppp-pppp-pppppppppppp
+             */
+            target_id: string;
+            /**
+             * @description What the reaction is on.
+             * @example post
+             * @enum {string}
+             */
+            target_type: "post" | "comment";
+            /**
+             * @description Reaction type (e.g. `like`).
+             * @example like
+             */
+            type: string;
+        };
+        ActorReactionsResponseDto: {
+            data: components["schemas"]["ActorReactionEntryDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
         ActorResponseDto: {
             /**
              * @description Avatar URL.
@@ -2101,6 +2708,11 @@ interface components {
              * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
              */
             id: string;
+            /**
+             * @description When true, the actor is private (task 014): effective post visibility is capped at `followers` and following requires an approved follow request.
+             * @example false
+             */
+            is_private: boolean;
             /**
              * @description Free-form metadata blob.
              * @example {
@@ -2160,6 +2772,20 @@ interface components {
              */
             reaction_counts: Record<string, never>;
         };
+        AddItemDto: {
+            /**
+             * @description The caller — must be the owner.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            caller_actor_id: string;
+            /** @description Curator ordering position. */
+            position?: number;
+            /**
+             * @description The post to add.
+             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
+             */
+            post_id: string;
+        };
         AddListMemberDto: {
             /**
              * @description New member — social actor UUID.
@@ -2206,6 +2832,81 @@ interface components {
              */
             approver_actor_id: string;
         };
+        AssetAttachmentDto: {
+            /**
+             * @description Per-attachment alt text for accessibility; null when unset.
+             * @example A golden retriever on a beach
+             */
+            alt_text: string | null;
+            /**
+             * @description The attached asset UUID.
+             * @example eeeeeeee-0000-0000-0000-000000000001
+             */
+            asset_id: string;
+        };
+        AssetAttachmentInputDto: {
+            /** @description Per-attachment alt text (≤1000 chars). */
+            alt_text?: string;
+            /**
+             * @description An uploaded asset UUID (status must be `ready`).
+             * @example eeeeeeee-0000-0000-0000-000000000001
+             */
+            asset_id: string;
+        };
+        AssetListResponseDto: {
+            data: components["schemas"]["AssetResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        AssetRenditionDto: {
+            /** @example 184320 */
+            byte_size: number;
+            /** @example image/jpeg */
+            content_type: string;
+            /** @example 960 */
+            height: number;
+            /**
+             * @description Ladder rung.
+             * @example medium
+             * @enum {string}
+             */
+            name: "original" | "medium" | "thumb";
+            /**
+             * @description Short-lived presigned GET URL (re-minted each read).
+             * @example https://…r2.cloudflarestorage.com/…?X-Amz-Signature=…
+             */
+            url: string;
+            /** @example 1280 */
+            width: number;
+        };
+        AssetResponseDto: {
+            /**
+             * @description Size of the original upload in bytes.
+             * @example 512000
+             */
+            byte_size: number;
+            /** @example cccccccc-cccc-cccc-cccc-cccccccccccc */
+            community_id: string;
+            /** @example image/jpeg */
+            content_type: string;
+            /** @example 2026-05-01T12:00:00.000Z */
+            created_at: string;
+            /** @example 4032 */
+            height: number | null;
+            /** @example eeeeeeee-0000-0000-0000-000000000001 */
+            id: string;
+            /** @example aaaaaaaa-0000-0000-0000-000000000001 */
+            owner_actor_id: string;
+            renditions: components["schemas"]["AssetRenditionDto"][];
+            /**
+             * @example ready
+             * @enum {string}
+             */
+            status: "processing" | "ready" | "failed";
+            /** @example 2026-05-01T12:00:00.000Z */
+            updated_at: string;
+            /** @example 3024 */
+            width: number | null;
+        };
         AuditListResponseDto: {
             data: components["schemas"]["ModerationActionResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -2313,6 +3014,38 @@ interface components {
             /** @description Actors to upsert, in order. 1–200 items; each item follows the single-upsert body exactly. */
             actors: components["schemas"]["UpsertActorDto"][];
         };
+        BlockedTermListResponseDto: {
+            data: components["schemas"]["BlockedTermResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        BlockedTermResponseDto: {
+            /**
+             * @description What a match does.
+             * @example hide
+             * @enum {string}
+             */
+            action: "hide" | "pending_approval";
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp the term was added.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Blocked term UUID.
+             * @example ffffffff-2222-0000-0000-000000000001
+             */
+            id: string;
+            /**
+             * @description The blocked term (lowercased).
+             * @example spoiler
+             */
+            term: string;
+        };
         BookmarkListResponseDto: {
             data: components["schemas"]["BookmarkResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -2395,6 +3128,64 @@ interface components {
             data: components["schemas"]["CloseFriendResponse"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
+        CollectionItemListResponseDto: {
+            data: components["schemas"]["CollectionItemResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        CollectionItemResponseDto: {
+            /** @example 2026-05-01T12:00:00.000Z */
+            added_at: string;
+            /** @example 99999999-0000-0000-0000-000000000001 */
+            collection_id: string;
+            /** @example cccccccc-cccc-cccc-cccc-cccccccccccc */
+            community_id: string;
+            /** @example 0 */
+            position: number;
+            /** @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb */
+            post_id: string;
+        };
+        CollectionListResponseDto: {
+            data: components["schemas"]["CollectionResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        CollectionResponseDto: {
+            /** @example cccccccc-cccc-cccc-cccc-cccccccccccc */
+            community_id: string;
+            /** @example null */
+            cover_asset_id: string | null;
+            /** @example null */
+            cover_url: string | null;
+            /** @example 2026-05-01T12:00:00.000Z */
+            created_at: string;
+            /** @example 99999999-0000-0000-0000-000000000001 */
+            id: string;
+            /**
+             * @description Number of posts in the collection.
+             * @example 12
+             */
+            item_count: number;
+            /**
+             * @example bookmark
+             * @enum {string}
+             */
+            kind: "bookmark" | "highlight";
+            /** @example Travel */
+            name: string;
+            /** @example aaaaaaaa-0000-0000-0000-000000000001 */
+            owner_actor_id: string;
+            /**
+             * @description Owner-defined ordering position.
+             * @example 0
+             */
+            position: number;
+            /** @example 2026-05-01T12:00:00.000Z */
+            updated_at: string;
+            /**
+             * @example private
+             * @enum {string}
+             */
+            visibility: "public" | "private";
+        };
         CommentListResponseDto: {
             data: components["schemas"]["CommentResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -2445,6 +3236,8 @@ interface components {
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
             actor_id: string;
+            /** @description Ordered image attachments (task 019). Ref-only; resolve renditions via GET /assets/:id. */
+            assets: components["schemas"]["AssetAttachmentDto"][];
             /**
              * @description Comment body.
              * @example Looks great, shipping today.
@@ -2475,6 +3268,16 @@ interface components {
              * @example null
              */
             parent_id: string | null;
+            /**
+             * @description True when the post author has pinned this top-level comment (task 012). Pinned comments lead the top-level listing.
+             * @example false
+             */
+            pinned: boolean;
+            /**
+             * @description ISO timestamp the comment was pinned; null when not pinned.
+             * @example null
+             */
+            pinned_at: string | null;
             /**
              * @description Post the comment threads under.
              * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
@@ -2683,6 +3486,12 @@ interface components {
              * @example 50
              */
             max_group_conversation_size: number;
+            /**
+             * @description Maximum pinned top-level comments per post (task 012). Integer 0..100; floored. Exceeding it returns 409 `PIN_CAP_REACHED`.
+             * @default 3
+             * @example 3
+             */
+            max_pinned_comments: 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"];
         };
@@ -2744,10 +3553,20 @@ interface components {
              */
             last_read_at: string | null;
             /**
-             * @description When true, dm_new_message notifications are suppressed for this participant.
+             * @description When true, dm_new_message notifications are suppressed indefinitely for this participant.
              * @example false
              */
             muted: boolean;
+            /**
+             * @description Timed mute (task 024): dm_new_message is suppressed while this is in the future. Additive beside `muted`; a past value is inert. Null when no timed mute.
+             * @example null
+             */
+            muted_until: string | null;
+            /**
+             * @description When true, the thread is pinned to the top of this actor's inbox (task 024).
+             * @example false
+             */
+            pinned: boolean;
             /**
              * @description Role on this conversation. `admin` for groups can add / remove members and rename.
              * @example member
@@ -2794,6 +3613,11 @@ interface components {
             name: string | null;
             /** @description Participants, joined-at ascending. */
             participants: components["schemas"]["ConversationParticipantDto"][];
+            /**
+             * @description Unread messages for the requesting actor (task 024) — messages from others created after the requester's last_read_at. Embedded on list + single GET for inbox badges.
+             * @example 0
+             */
+            unread_count: number;
             /**
              * @description ISO timestamp.
              * @example 2026-05-01T12:00:00.000Z
@@ -2820,13 +3644,33 @@ interface components {
              */
             visibility?: "public" | "private";
         };
+        CreateBlockedTermDto: {
+            /**
+             * @description What a match does. Default `hide`.
+             * @example hide
+             * @enum {string}
+             */
+            action?: "hide" | "pending_approval";
+            /**
+             * @description The word/phrase to block (case-insensitive substring). Max 128 chars.
+             * @example spoiler
+             */
+            term: string;
+        };
         CreateBookmarkDto: {
             /**
              * @description Social actor UUID who is bookmarking — the customer-backend supplies the end-user identity here.
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
             actor_id: string;
-        };
+            /**
+             * @description Optional collection UUIDs (task 020) to file this post into alongside the flat bookmark. Only the actor's own collections are written; unknown/other-owner ids are silently skipped. Max 20.
+             * @example [
+             *       "99999999-0000-0000-0000-000000000001"
+             *     ]
+             */
+            collection_ids?: string[];
+        };
         CreateCloseFriendDto: {
             /**
              * @description Member social actor UUID (the actor being added).
@@ -2839,12 +3683,45 @@ interface components {
              */
             owner_actor_id: string;
         };
+        CreateCollectionDto: {
+            /**
+             * Format: uuid
+             * @description Cover image — a ready asset (task 019) owned by the collection owner.
+             */
+            cover_asset_id?: string;
+            /** @description Cover image URL (alternative to cover_asset_id). */
+            cover_url?: string;
+            /**
+             * @description Default `bookmark` (owner-scoped). `highlight` is profile-public and bypasses story expiry.
+             * @enum {string}
+             */
+            kind?: "bookmark" | "highlight";
+            /**
+             * @description Collection name (1-200 chars).
+             * @example Travel
+             */
+            name: string;
+            /**
+             * @description The owning actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            owner_actor_id: string;
+            /** @description Owner-defined ordering position. */
+            position?: number;
+            /**
+             * @description Default `private`.
+             * @enum {string}
+             */
+            visibility?: "public" | "private";
+        };
         CreateCommentDto: {
             /**
              * @description Social actor UUID who authors the comment.
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
             actor_id: string;
+            /** @description Ordered image attachments (task 019). Each references a `ready` asset in this community owned by the author. Max 20. */
+            assets?: components["schemas"]["AssetAttachmentInputDto"][];
             /**
              * @description Comment body (1-10000 chars after trim).
              * @example Looks great, shipping today.
@@ -2970,16 +3847,16 @@ interface components {
              */
             reporter_actor_id: string;
             /**
-             * @description UUID of the post or comment being flagged.
+             * @description UUID of the target (post / comment / actor / message id per target_kind).
              * @example pppppppp-pppp-pppp-pppp-pppppppppppp
              */
             target_id: string;
             /**
-             * @description What kind of object is being flagged.
+             * @description What kind of object is being flagged (task 017 adds actor + direct_message). A direct_message flag requires the reporter to be a participant in the conversation.
              * @example post
              * @enum {string}
              */
-            target_kind: "post" | "comment";
+            target_kind: "post" | "comment" | "actor" | "direct_message";
         };
         CreateFlagResponseDto: {
             /**
@@ -3003,6 +3880,11 @@ interface components {
             tag: string;
         };
         CreateMutedTermDto: {
+            /**
+             * @description What matching does. `mute` (default) or `pending_approval` (task 015).
+             * @enum {string}
+             */
+            action?: "mute" | "pending_approval";
             /** @description Optional expiry (ISO timestamp in the future). */
             expires_at?: string | null;
             /**
@@ -3022,6 +3904,8 @@ interface components {
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
             actor_id: string;
+            /** @description Ordered image attachments (task 019). Each references a `ready` asset in this community owned by the author. Max 20. */
+            assets?: components["schemas"]["AssetAttachmentInputDto"][];
             /**
              * @description Free-form attributes blob. Polls live here at `attributes.poll`.
              * @example {
@@ -3046,6 +3930,8 @@ interface components {
             kind?: string;
             /** @description Required when status='scheduled'. ISO timestamp at least 30 seconds in the future. The PostSchedulerCron promotes scheduled posts to published once now() >= scheduled_for. */
             scheduled_for?: string | null;
+            /** @description Per-post interaction settings (comment policy, hide reaction counts, allow repost/quote). Omitted keys default to the open shape. Enforced server-side. */
+            settings?: components["schemas"]["PostSettingsInputDto"];
             /**
              * @description For `kind='quote'` ONLY: the source post being quoted. Reposts use the dedicated POST /posts/:postId/repost route instead. Validation: when `kind='quote'`, both `source_post_id` and a non-empty `body` are required.
              * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
@@ -3056,6 +3942,13 @@ interface components {
              * @enum {string}
              */
             status?: "published" | "draft" | "scheduled";
+            /**
+             * @description Actor UUIDs to tag in the post (task 011). Each lands as a pending tag the actor approves. Non-actors and blocked pairs are skipped. Max 30.
+             * @example [
+             *       "aaaaaaaa-0000-0000-0000-000000000002"
+             *     ]
+             */
+            tags?: string[];
             /**
              * @description Optional title (1-240 chars).
              * @example Shipping Phase 8
@@ -3117,7 +4010,7 @@ interface components {
              *       "comment.created"
              *     ]
              */
-            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")[];
+            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" | "edge.follow.requested" | "edge.follow.request_approved" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created" | "tag.created" | "asset.ready" | "asset.failed")[];
             /**
              * @description Subscriber URL. Must be `https://`.
              * @example https://example.com/webhooks/social
@@ -3157,7 +4050,7 @@ interface components {
              *       "comment.created"
              *     ]
              */
-            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")[];
+            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" | "edge.follow.requested" | "edge.follow.request_approved" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created" | "tag.created" | "asset.ready" | "asset.failed")[];
             /**
              * @description Webhook UUID.
              * @example wwwwwwww-0000-0000-0000-000000000001
@@ -3220,6 +4113,10 @@ interface components {
              */
             sender_id?: string;
         };
+        DeleteWithCallerDto: {
+            /** @example aaaaaaaa-0000-0000-0000-000000000001 */
+            caller_actor_id: string;
+        };
         DeliveryJobResponseDto: {
             /**
              * @description Delivery attempts made so far.
@@ -3340,6 +4237,11 @@ interface components {
             pagination: components["schemas"]["PaginationResponseDto"];
         };
         DirectMessageAdminResponseDto: {
+            /**
+             * @description Ordered image attachments (task 019); ref-only.
+             * @example []
+             */
+            assets: string[];
             /**
              * @description Attachments.
              * @example []
@@ -3476,6 +4378,8 @@ interface components {
             type: string;
         };
         DirectMessageResponseDto: {
+            /** @description Ordered image attachments (task 019). Ref-only; resolve renditions via GET /assets/:id. */
+            assets: components["schemas"]["AssetAttachmentDto"][];
             attachments: components["schemas"]["DirectMessageAttachmentDto"][];
             /**
              * @description Message body. Returns `"(deleted)"` when soft-deleted.
@@ -3535,6 +4439,27 @@ interface components {
              */
             sender_id: string;
         };
+        DirectModerationActionDto: {
+            /**
+             * @description Action. hide/remove act on the target; ban/restore suspend/reinstate an actor; warn is audit-only. The audit row has flag_id=null (unsolicited action).
+             * @example remove
+             * @enum {string}
+             */
+            action: "hide" | "remove" | "warn" | "ban" | "dismiss" | "unhide" | "restore";
+            /** @description Optional moderator notes (up to 2000 chars). */
+            notes?: string;
+            /**
+             * @description The target UUID (post/comment/actor/message id per target_kind).
+             * @example bbbbbbbb-0000-0000-0000-000000000001
+             */
+            target_id: string;
+            /**
+             * @description What the action targets (task 017). post/comment → status transition; direct_message → moderator soft-delete; actor → ban=suspend / restore=reinstate.
+             * @example direct_message
+             * @enum {string}
+             */
+            target_kind: "post" | "comment" | "actor" | "direct_message";
+        };
         DraftListResponseDto: {
             /** @description Draft post rows — status is always 'draft' on this endpoint. */
             data: components["schemas"]["PostResponseDto"][];
@@ -3651,13 +4576,64 @@ interface components {
              * @example post
              * @enum {string}
              */
-            target_kind: "post" | "comment";
+            target_kind: "post" | "comment" | "actor" | "direct_message";
             /**
              * @description ISO timestamp of the last update.
              * @example 2026-05-01T12:00:00.000Z
              */
             updated_at: string;
         };
+        FollowRequestEntryDto: {
+            /**
+             * @description When the request was created.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Follow request UUID.
+             * @example ffffffff-1111-0000-0000-000000000001
+             */
+            request_id: string;
+            /**
+             * @description Requesting actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            src_actor_id: string;
+            /**
+             * @description Requesting actor avatar URL.
+             * @example null
+             */
+            src_avatar_url: string | null;
+            /**
+             * @description Requesting actor display name.
+             * @example Bob
+             */
+            src_display_name: string | null;
+            /**
+             * @description Requesting actor's external_id.
+             * @example bob
+             */
+            src_external_id: string;
+        };
+        FollowRequestListResponseDto: {
+            data: components["schemas"]["FollowRequestEntryDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        FollowResultDto: {
+            /**
+             * @description `true` if the edge / request was created on this call; `false` on idempotent retry.
+             * @example true
+             */
+            created: boolean;
+            /** @description The follow edge when `status=followed`; null when `pending`. */
+            edge: components["schemas"]["EdgeResponseDto"] | null;
+            /**
+             * @description `followed` = an edge exists; `pending` = a follow request was created (private dst).
+             * @example followed
+             * @enum {string}
+             */
+            status: "followed" | "pending";
+        };
         FollowerEdgeListResponseDto: {
             data: components["schemas"]["FollowerEdgeResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -3733,6 +4709,11 @@ interface components {
              * @example storymode
              */
             tag: string;
+            /**
+             * @description Published posts using the tag inside the trending window; non-null only when `order=trending` (task 023).
+             * @example null
+             */
+            window_post_count: number | null;
         };
         HashtagFollowListResponseDto: {
             data: components["schemas"]["HashtagFollowResponseDto"][];
@@ -3784,12 +4765,69 @@ interface components {
              * @example storymode
              */
             tag: string;
+            /**
+             * @description Published posts using the tag inside the trending window; non-null only when `order=trending` (task 023).
+             * @example null
+             */
+            window_post_count: number | null;
+        };
+        HideEntryDto: {
+            /**
+             * @description When the post was hidden.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description The hidden post UUID.
+             * @example bbbbbbbb-0000-0000-0000-000000000001
+             */
+            post_id: string;
+        };
+        HideListResponseDto: {
+            data: components["schemas"]["HideEntryDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        HidePostDto: {
+            /**
+             * @description The actor hiding the post.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id: string;
+            /**
+             * @description The post to hide.
+             * @example bbbbbbbb-0000-0000-0000-000000000001
+             */
+            post_id: string;
+        };
+        HideResultDto: {
+            /**
+             * @description `true` if the hide was created on this call; `false` on idempotent retry.
+             * @example true
+             */
+            created: boolean;
         };
         HighlightsResponse: {
             /** @description Page of pinned posts (full post rows; expiry is bypassed for pinned rows). */
             data: components["schemas"]["PostResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
+        InsightsDailyBucketDto: {
+            /**
+             * @description ISO date (YYYY-MM-DD).
+             * @example 2026-05-01
+             */
+            day: string;
+            /**
+             * @description Distinct viewers that day.
+             * @example 210
+             */
+            reach: number;
+            /**
+             * @description Total impressions that day (repeats + anonymous).
+             * @example 340
+             */
+            views: number;
+        };
         LeaveConversationDto: {
             /**
              * @deprecated
@@ -3916,7 +4954,7 @@ interface components {
              * @example post
              * @enum {string}
              */
-            target_kind: "post" | "comment";
+            target_kind: "post" | "comment" | "actor" | "direct_message";
         };
         ModerationActorListResponseDto: {
             data: components["schemas"]["ModerationActorResponseDto"][];
@@ -3953,6 +4991,11 @@ interface components {
              * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
              */
             id: string;
+            /**
+             * @description When true, the actor is private (task 014): effective post visibility is capped at `followers` and following requires an approved follow request.
+             * @example false
+             */
+            is_private: boolean;
             /**
              * @description Free-form metadata blob.
              * @example {
@@ -3983,6 +5026,12 @@ interface components {
             pagination: components["schemas"]["PaginationResponseDto"];
         };
         MutedTermResponseDto: {
+            /**
+             * @description What matching does (task 015). `mute` = feed-filter only; `pending_approval` = hold a stranger's comment on your post for review.
+             * @example mute
+             * @enum {string}
+             */
+            action: "mute" | "pending_approval";
             /**
              * @description Owning actor UUID.
              * @example aaaaaaaa-0000-0000-0000-000000000001
@@ -4040,7 +5089,7 @@ interface components {
              * @example follow
              * @enum {string}
              */
-            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction";
+            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction" | "tag" | "follow_request" | "follow_request_approved";
             /**
              * @description ISO timestamp of the last update. Synthesised entries (no explicit row) report epoch.
              * @example 2026-05-01T12:00:00.000Z
@@ -4073,7 +5122,7 @@ interface components {
              * @example reaction
              * @enum {string}
              */
-            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction";
+            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction" | "tag" | "follow_request" | "follow_request_approved";
             /**
              * @description Kind-specific extras. `reaction`: `{type}` (+ `{post_id}` when the target is a comment). `comment_on_post` / `reply_to_comment`: `{comment_id}`. `mention`: `{post_id}` (+ `{comment_id}` for comment mentions).
              * @example {
@@ -4191,6 +5240,13 @@ interface components {
              */
             muted: boolean;
         };
+        PinCommentDto: {
+            /**
+             * @description The acting actor — must equal the post.actor_id (task 012).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id: string;
+        };
         PollResultOptionResponse: {
             /**
              * @description Number of votes recorded for this option.
@@ -4226,6 +5282,79 @@ interface components {
              */
             total_votes: number;
         };
+        PollVoteResponse: {
+            /**
+             * @description When the vote was cast (or last changed).
+             * @example 2026-05-01T11:30:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Zero-based index of the option the actor voted for.
+             * @example 1
+             */
+            option_index: number;
+        };
+        PollVoterResponse: {
+            /**
+             * @description The option this voter chose.
+             * @example 1
+             */
+            option_index: number;
+            /**
+             * @description When the vote was cast.
+             * @example 2026-05-01T11:30:00.000Z
+             */
+            voted_at: string;
+            /**
+             * @description Voter actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            voter_actor_id: string;
+            /**
+             * @description Voter avatar URL.
+             * @example https://...
+             */
+            voter_avatar_url: string | null;
+            /**
+             * @description Voter display name.
+             * @example Bob
+             */
+            voter_display_name: string | null;
+            /**
+             * @description Voter's external_id.
+             * @example bob
+             */
+            voter_external_id: string;
+        };
+        PollVotersResponse: {
+            data: components["schemas"]["PollVoterResponse"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        PostInsightsResponseDto: {
+            /** @example 34 */
+            comment_count: number;
+            /** @example cccccccc-cccc-cccc-cccc-cccccccccccc */
+            community_id: string;
+            daily: components["schemas"]["InsightsDailyBucketDto"][];
+            /** @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb */
+            post_id: string;
+            /** @example 4 */
+            quote_count: number;
+            /** @example 128 */
+            reaction_count: number;
+            /** @example 9 */
+            repost_count: number;
+            /**
+             * @description All-time distinct viewers.
+             * @example 3110
+             */
+            unique_reach: number;
+            /**
+             * @description All-time total impressions.
+             * @example 4820
+             */
+            views: number;
+        };
         PostListResponseDto: {
             data: components["schemas"]["PostResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -4267,6 +5396,8 @@ interface components {
              * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
              */
             actor_id: string;
+            /** @description Ordered image attachments (task 019). Ref-only; resolve renditions via GET /assets/:id. */
+            assets: components["schemas"]["AssetAttachmentDto"][];
             /**
              * @description Free-form attributes blob (polls live at `attributes.poll`).
              * @example {}
@@ -4345,17 +5476,19 @@ interface components {
              * @example null
              */
             scheduled_for: string | null;
+            /** @description Typed per-post interaction settings (comment policy, count hiding, repost/quote permission). Enforced server-side. */
+            settings: components["schemas"]["PostSettingsDto"];
             /**
              * @description For kind='repost' / 'quote': the source post UUID.
              * @example null
              */
             source_post_id: string | null;
             /**
-             * @description Lifecycle status. Public list/feed surfaces only return `published`; `draft` and `scheduled` rows surface exclusively on the author-scoped drafts / scheduled-posts listings and author reads. `removed` rows are hidden from reads.
+             * @description Lifecycle status. Public list/feed surfaces only return `published`; `draft`, `scheduled`, and `archived` rows surface exclusively on their author-scoped listings and author reads. `removed` rows are hidden from reads. `archived` keeps engagement but is author-only.
              * @example published
              * @enum {string}
              */
-            status: "published" | "hidden" | "removed" | "draft" | "scheduled";
+            status: "published" | "hidden" | "removed" | "draft" | "scheduled" | "archived";
             /**
              * @description Optional title (1-240 chars).
              * @example Shipping Phase 8
@@ -4433,6 +5566,42 @@ interface components {
             /** @description Always `null` — this lane returns a single bounded, ranked page (no cursor in v1). Present for envelope consistency. */
             pagination: components["schemas"]["PaginationResponseDto"] | null;
         };
+        PostSettingsDto: {
+            /**
+             * @description When false, quoting this post (kind='quote') is refused (422 QUOTE_NOT_ALLOWED).
+             * @example true
+             */
+            allow_quote: boolean;
+            /**
+             * @description When false, reposting this post is refused (422 REPOST_NOT_ALLOWED).
+             * @example true
+             */
+            allow_repost: boolean;
+            /**
+             * @description Who may comment. `everyone` (default), `followers`, `mentioned` (actors mentioned in the post body), or `off` (author only). Enforced server-side on comment create.
+             * @example everyone
+             * @enum {string}
+             */
+            comments: "everyone" | "followers" | "mentioned" | "off";
+            /**
+             * @description When true, `reaction_counts` is suppressed (emitted as `{}`) for everyone except the post author, on every read surface.
+             * @example false
+             */
+            hide_reaction_counts: boolean;
+        };
+        PostSettingsInputDto: {
+            /** @description Allow this post to be quoted. Default true. */
+            allow_quote?: boolean;
+            /** @description Allow this post to be reposted. Default true. */
+            allow_repost?: boolean;
+            /**
+             * @description Who may comment. `everyone` (default), `followers`, `mentioned`, or `off` (author only).
+             * @enum {string}
+             */
+            comments?: "everyone" | "followers" | "mentioned" | "off";
+            /** @description Suppress reaction_counts for everyone except the author. Default false. */
+            hide_reaction_counts?: boolean;
+        };
         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.
@@ -4447,6 +5616,49 @@ interface components {
             /** @description One entry per requested post id (de-duplicated, request order). Unknown / cross-community ids resolve to the empty state. */
             data: components["schemas"]["PostViewerStateEntryDto"][];
         };
+        PostTagResponseDto: {
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp the tag was created.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Tag UUID.
+             * @example ffffffff-0000-0000-0000-000000000001
+             */
+            id: string;
+            /**
+             * @description Opaque customer-defined metadata blob.
+             * @example null
+             */
+            metadata: Record<string, never> | null;
+            /**
+             * @description Tagged post UUID.
+             * @example bbbbbbbb-0000-0000-0000-000000000001
+             */
+            post_id: string;
+            /**
+             * @description Lifecycle state.
+             * @example approved
+             * @enum {string}
+             */
+            state: "pending" | "approved" | "removed";
+            /**
+             * @description Tagged actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            tagged_actor_id: string;
+            /**
+             * @description ISO timestamp of the last state change.
+             * @example 2026-05-01T12:05:00.000Z
+             */
+            updated_at: string;
+        };
         PostViewerStateEntryDto: {
             /**
              * @description The viewer has bookmarked the post.
@@ -4566,6 +5778,12 @@ interface components {
              *     ]
              */
             post_ids: string[];
+            /**
+             * Format: uuid
+             * @description Optional viewer actor UUID (task 021). When present, the impressions count toward the post's unique reach (deduped per viewer/day); omit for anonymous views (which count total views but not reach).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            viewer_actor_id?: string;
         };
         RelationshipEntryDto: {
             /**
@@ -4588,6 +5806,11 @@ interface components {
              * @example aaaaaaaa-0000-0000-0000-000000000002
              */
             dst_actor_id: string;
+            /**
+             * @description The source actor has a pending follow request against this (private) actor (task 014).
+             * @example false
+             */
+            follow_pending: boolean;
             /**
              * @description This actor follows the source actor.
              * @example false
@@ -4648,6 +5871,15 @@ interface components {
             /** @description New display name. Pass null or empty to clear. */
             name: string | null;
         };
+        ReorderItemDto: {
+            /** @example aaaaaaaa-0000-0000-0000-000000000001 */
+            caller_actor_id: string;
+            /**
+             * @description New curator position.
+             * @example 3
+             */
+            position: number;
+        };
         RepostListResponseDto: {
             /** @description Page of repost post rows, each carrying the reposting actor_id. */
             data: components["schemas"]["PostResponseDto"][];
@@ -4659,6 +5891,8 @@ interface components {
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
             actor_id?: string;
+            /** @description Ordered image attachments (task 019). Each references a `ready` asset in this community owned by the sender. Max 20. */
+            assets?: components["schemas"]["AssetAttachmentInputDto"][];
             attachments?: components["schemas"]["DirectMessageAttachmentDto"][];
             /**
              * @description Message body. Required when `kind="text"`. 1..10000 chars after trim.
@@ -4772,6 +6006,10 @@ interface components {
             /** @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;
         };
+        TaggedPostsResponse: {
+            data: components["schemas"]["PostResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
         UnreadCountResponse: {
             /**
              * @description Number of unread notifications for the actor.
@@ -4789,6 +6027,8 @@ interface components {
         UpdateActorDto: {
             avatar_url?: string | null;
             display_name?: string | null;
+            /** @description Make the actor private (task 014). Caps effective post visibility at `followers`; following requires an approved request. Flipping back to public auto-approves pending requests. */
+            is_private?: boolean;
             metadata?: Record<string, never>;
             /** @enum {string} */
             status?: "active" | "suspended" | "deleted";
@@ -4809,6 +6049,20 @@ interface components {
              */
             visibility?: "public" | "private";
         };
+        UpdateCollectionDto: {
+            /**
+             * @description The caller — must be the owner.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            caller_actor_id: string;
+            /** Format: uuid */
+            cover_asset_id?: string | null;
+            cover_url?: string | null;
+            name?: string;
+            position?: number;
+            /** @enum {string} */
+            visibility?: "public" | "private";
+        };
         UpdateCommentDto: {
             /** @description Updated body. */
             body?: string;
@@ -4835,27 +6089,60 @@ interface components {
              */
             actor_id: string;
             /**
-             * @description Mute / unmute on the caller's participant row.
+             * @deprecated
+             * @description DEPRECATED (task 025): use PATCH /:id/members/:actorId. Mute / unmute indefinitely on the caller's participant row.
              * @example true
              */
             muted?: boolean;
-        };
-        UpdateMemberRoleDto: {
             /**
-             * @description The admin performing the role change — social actor UUID.
-             * @example aaaaaaaa-0000-0000-0000-000000000001
+             * @deprecated
+             * @description DEPRECATED (task 025): use PATCH /:id/members/:actorId. Timed mute until this ISO timestamp; pass `null` to clear.
+             * @example 2026-05-02T12:00:00Z
              */
-            caller_actor_id: string;
+            muted_until?: string | null;
             /**
-             * @description Target role.
-             * @example admin
-             * @enum {string}
+             * @description Rename a group conversation (task 025) — group-only, admin-only. The canonical rename home, absorbing the deprecated PATCH /:id/name route.
+             * @example Weekend plans
              */
-            role: "member" | "admin";
+            name?: string | null;
+            /**
+             * @deprecated
+             * @description DEPRECATED (task 025): use PATCH /:id/members/:actorId. Pin / unpin the thread in the caller's inbox.
+             * @example true
+             */
+            pinned?: boolean;
         };
-        UpdateMessageDto: {
+        UpdateMemberDto: {
             /**
-             * @description The sender — must match the message's sender_id. Standardized name (task 008 / G11).
+             * @description The actor performing the change — social actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            caller_actor_id: string;
+            /**
+             * @description Mute the thread indefinitely (self-only — caller must be the path actor). Task 024/025.
+             * @example true
+             */
+            muted?: boolean;
+            /**
+             * @description Timed mute until this ISO timestamp (self-only). Pass null to clear.
+             * @example 2026-05-02T12:00:00Z
+             */
+            muted_until?: string | null;
+            /**
+             * @description Pin / unpin the thread in the caller's inbox (self-only).
+             * @example true
+             */
+            pinned?: boolean;
+            /**
+             * @description Target role (admin-only). Omit to leave unchanged.
+             * @example admin
+             * @enum {string}
+             */
+            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;
@@ -4896,11 +6183,20 @@ interface components {
             pinned?: boolean;
             /** @description ISO-8601 publish-at timestamp. Updating only valid while the post is `status="scheduled"`. Pass null to clear (typically only the scheduler does this on promotion). */
             scheduled_for?: string | null;
+            /** @description Partial update of the per-post interaction settings. Only the keys you pass change; the rest keep their current value. */
+            settings?: components["schemas"]["PostSettingsInputDto"];
             /**
-             * @description Direct status transition. Pass `published` to promote a `draft` or `scheduled`. Prefer the moderation lane for `hidden`/`removed`.
+             * @description Direct status transition. Pass `published` to promote a `draft`/`scheduled` or restore an `archived` post; pass `archived` to hide-without-deleting (engagement kept). Prefer the moderation lane for `hidden`/`removed`.
              * @enum {string}
              */
-            status?: "published" | "hidden" | "removed" | "draft" | "scheduled";
+            status?: "published" | "hidden" | "removed" | "draft" | "scheduled" | "archived";
+            /**
+             * @description Additional actor UUIDs to tag (task 011). Additive — creates new pending tags; never resets existing approved/removed tags. Max 30.
+             * @example [
+             *       "aaaaaaaa-0000-0000-0000-000000000002"
+             *     ]
+             */
+            tags?: string[];
             /** @description Updated title. */
             title?: string | null;
             /** @description Updated URL. */
@@ -4915,10 +6211,19 @@ interface components {
              */
             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")[];
+            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" | "edge.follow.requested" | "edge.follow.request_approved" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created" | "tag.created" | "asset.ready" | "asset.failed")[];
             /** @description New subscriber URL. */
             url?: string;
         };
+        UploadAssetResponseDto: {
+            /** @example eeeeeeee-0000-0000-0000-000000000001 */
+            id: string;
+            /**
+             * @example ready
+             * @enum {string}
+             */
+            status: "processing" | "ready" | "failed";
+        };
         UpsertActorDto: {
             /**
              * @description Avatar URL.
@@ -4960,7 +6265,7 @@ interface components {
              *       "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")[];
+            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" | "edge.follow.requested" | "edge.follow.request_approved" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created" | "tag.created" | "asset.ready" | "asset.failed")[];
         };
         WebhookListResponseDto: {
             /** @description Every webhook on the community — disabled rows included, so auto-disabled subscribers stay discoverable. */
@@ -4999,7 +6304,7 @@ interface components {
              *       "comment.created"
              *     ]
              */
-            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")[];
+            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" | "edge.follow.requested" | "edge.follow.request_approved" | "flag.created" | "flag.updated" | "moderation.action.applied" | "actor.updated" | "dm.message.created" | "tag.created" | "asset.ready" | "asset.failed")[];
             /**
              * @description Webhook UUID.
              * @example wwwwwwww-0000-0000-0000-000000000001
@@ -5432,6 +6737,89 @@ interface operations {
             };
         };
     };
+    DraftController_listArchived: {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Social actor UUID whose archived posts to list. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of archived posts. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DraftListResponseDto"];
+                };
+            };
+            /** @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"];
+                };
+            };
+        };
+    };
+    AssetController_listByActor: {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+                /** @description Owner actor UUID. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of the actor's assets. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AssetListResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.assets.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     EdgeController_listBlocks: {
         parameters: {
             query?: {
@@ -5634,6 +7022,36 @@ interface operations {
             };
         };
     };
+    EdgeController_listDismissedSuggestions: {
+        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: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Social actor UUID. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of dismissed-suggestion edges. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["OutboundEdgeListResponseDto"];
+                };
+            };
+        };
+    };
     DraftController_listDrafts: {
         parameters: {
             query?: {
@@ -5738,6 +7156,43 @@ interface operations {
             };
         };
     };
+    EdgeController_listIncomingRequests: {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description The private actor whose incoming requests to list. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of incoming follow requests. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FollowRequestListResponseDto"];
+                };
+            };
+            /** @description Community or actor not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     EdgeController_listFollowers: {
         parameters: {
             query?: {
@@ -6006,6 +7461,34 @@ interface operations {
             };
         };
     };
+    EdgeController_listHides: {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Social actor UUID. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of hidden posts. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HideListResponseDto"];
+                };
+            };
+        };
+    };
     StoryController_getHighlights: {
         parameters: {
             query?: {
@@ -6061,6 +7544,60 @@ interface operations {
             };
         };
     };
+    InsightsController_actorInsights: {
+        parameters: {
+            query?: {
+                from?: string;
+                to?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Actor insights. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ActorInsightsResponseDto"];
+                };
+            };
+            /** @description Invalid window. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.analytics.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Actor not found in this community. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     MentionController_list: {
         parameters: {
             query?: {
@@ -6365,7 +7902,7 @@ interface operations {
                 /** @description Social actor UUID. */
                 actorId: string;
                 /** @description NotificationKind label. */
-                kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction";
+                kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction" | "tag" | "follow_request" | "follow_request_approved";
             };
             cookie?: never;
         };
@@ -6868,33 +8405,70 @@ interface operations {
             };
         };
     };
-    EdgeController_relationships: {
+    PostTagController_listTagged: {
         parameters: {
-            query: {
-                /** @description Comma-separated destination actor UUIDs (1-100). */
-                with: string;
+            query?: {
+                /** @description Viewer actor UUID for visibility resolution. */
+                requester_id?: string;
+                limit?: number;
+                cursor?: string;
             };
             header?: never;
             path: {
-                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                /** @description Community UUID. */
                 communityId: string;
-                /** @description Source actor UUID — the perspective all flags are computed from. */
-                srcActorId: string;
+                /** @description The tagged actor UUID. */
+                actorId: string;
             };
             cookie?: never;
         };
         requestBody?: never;
         responses: {
-            /** @description One relationship entry per requested id. */
+            /** @description Page of tagged posts. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["RelationshipListResponseDto"];
+                    "application/json": components["schemas"]["TaggedPostsResponse"];
                 };
             };
-            /** @description Missing `with`, more than 100 ids, or a non-UUID value in the list. */
+            /** @description Community or actor not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    EdgeController_relationships: {
+        parameters: {
+            query: {
+                /** @description Comma-separated destination actor UUIDs (1-100). */
+                with: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Source actor UUID — the perspective all flags are computed from. */
+                srcActorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description One relationship entry per requested id. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["RelationshipListResponseDto"];
+                };
+            };
+            /** @description Missing `with`, more than 100 ids, or a non-UUID value in the list. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -6923,6 +8497,159 @@ interface operations {
             };
         };
     };
+    AssetController_upload: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "multipart/form-data": {
+                    /**
+                     * Format: binary
+                     * @description PNG / JPEG / WEBP, ≤10 MB.
+                     */
+                    file: string;
+                    /** Format: uuid */
+                    owner_actor_id: string;
+                };
+            };
+        };
+        responses: {
+            /** @description Asset stored and ready. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["UploadAssetResponseDto"];
+                };
+            };
+            /** @description Missing/oversize/wrong-type file, or the bytes do not match the declared image type. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.assets.write`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community or owner actor not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description The image could not be decoded/processed. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    AssetController_get: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+                assetId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The asset. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["AssetResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.assets.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Asset not found in this community. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    AssetController_delete: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+                assetId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Asset deleted. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description PAK lacks `social.assets.write`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Asset not found in this community. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     EdgeController_block: {
         parameters: {
             query?: never;
@@ -6972,11 +8699,434 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponseDto"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Cannot block yourself. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    EdgeController_unblock: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Blocker actor UUID. */
+                srcActorId: string;
+                /** @description Blockee actor UUID. */
+                dstActorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Unblocked (or no edge to remove). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description PAK lacks `social.delete`. */
+            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"];
+                };
+            };
+        };
+    };
+    StoryController_addCloseFriend: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCloseFriendDto"];
+            };
+        };
+        responses: {
+            /** @description Member added (or already present). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Body validation failed. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.close-friend.manage`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community / owner / member not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Block in place between owner and member. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Cannot add yourself as a close friend. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    StoryController_removeCloseFriend: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+                /** @description Owner social actor UUID. */
+                ownerActorId: string;
+                /** @description Member social actor UUID. */
+                memberActorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Removed (or was not in the list). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description PAK lacks `social.close-friend.manage`. */
+            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"];
+                };
+            };
+        };
+    };
+    CollectionController_list: {
+        parameters: {
+            query?: {
+                /** @description Viewer actor — surfaces their own private collections. */
+                actor_id?: string;
+                owner_actor_id?: string;
+                kind?: "bookmark" | "highlight";
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of collections. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CollectionListResponseDto"];
+                };
+            };
+        };
+    };
+    CollectionController_create: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Opaque client string; replays return the original response. */
+                "Idempotency-Key"?: string;
+            };
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateCollectionDto"];
+            };
+        };
+        responses: {
+            /** @description Collection created. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CollectionResponseDto"];
+                };
+            };
+            /** @description Validation failure. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.create`, owner suspended, or cover asset not owned. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community, owner, or cover asset not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Cover asset is not ready. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    CollectionController_getById: {
+        parameters: {
+            query?: {
+                actor_id?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                collectionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The collection. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CollectionResponseDto"];
+                };
+            };
+            /** @description Not found (or private and not the owner). */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    CollectionController_delete: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                collectionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DeleteWithCallerDto"];
+            };
+        };
+        responses: {
+            /** @description Deleted. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller is not the owner. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    CollectionController_update: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                collectionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["UpdateCollectionDto"];
+            };
+        };
+        responses: {
+            /** @description Updated. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CollectionResponseDto"];
+                };
+            };
+            /** @description Caller is not the owner, or PAK lacks `social.update`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Cover asset is not ready. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    CollectionController_listItems: {
+        parameters: {
+            query?: {
+                actor_id?: string;
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                collectionId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of items. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CollectionItemListResponseDto"];
                 };
             };
-            /** @description Cannot block yourself. */
-            422: {
+            /** @description Not found (or private and not the owner). */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -6986,30 +9136,33 @@ interface operations {
             };
         };
     };
-    EdgeController_unblock: {
+    CollectionController_addItem: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                /** @description Social community UUID. */
                 communityId: string;
-                /** @description Blocker actor UUID. */
-                srcActorId: string;
-                /** @description Blockee actor UUID. */
-                dstActorId: string;
+                collectionId: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AddItemDto"];
+            };
+        };
         responses: {
-            /** @description Unblocked (or no edge to remove). */
-            204: {
+            /** @description Item added (or already present). */
+            201: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["CollectionItemResponseDto"];
+                };
             };
-            /** @description PAK lacks `social.delete`. */
+            /** @description Caller is not the owner. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -7018,7 +9171,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community or actor not found. */
+            /** @description Collection or post not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -7029,39 +9182,32 @@ interface operations {
             };
         };
     };
-    StoryController_addCloseFriend: {
+    CollectionController_removeItem: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Community UUID. */
+                /** @description Social community UUID. */
                 communityId: string;
+                collectionId: string;
+                postId: string;
             };
             cookie?: never;
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["CreateCloseFriendDto"];
+                "application/json": components["schemas"]["DeleteWithCallerDto"];
             };
         };
         responses: {
-            /** @description Member added (or already present). */
+            /** @description Item removed. */
             204: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content?: never;
             };
-            /** @description Body validation failed. */
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponseDto"];
-                };
-            };
-            /** @description PAK lacks `social.close-friend.manage`. */
+            /** @description Caller is not the owner. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -7070,59 +9216,36 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community / owner / member not found. */
-            404: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponseDto"];
-                };
-            };
-            /** @description Block in place between owner and member. */
-            409: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponseDto"];
-                };
-            };
-            /** @description Cannot add yourself as a close friend. */
-            422: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponseDto"];
-                };
-            };
         };
     };
-    StoryController_removeCloseFriend: {
+    CollectionController_reorderItem: {
         parameters: {
             query?: never;
             header?: never;
             path: {
-                /** @description Community UUID. */
+                /** @description Social community UUID. */
                 communityId: string;
-                /** @description Owner social actor UUID. */
-                ownerActorId: string;
-                /** @description Member social actor UUID. */
-                memberActorId: string;
+                collectionId: string;
+                postId: string;
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ReorderItemDto"];
+            };
+        };
         responses: {
-            /** @description Removed (or was not in the list). */
-            204: {
+            /** @description Item repositioned. */
+            200: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content?: never;
+                content: {
+                    "application/json": components["schemas"]["CollectionItemResponseDto"];
+                };
             };
-            /** @description PAK lacks `social.close-friend.manage`. */
+            /** @description Caller is not the owner. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -7131,7 +9254,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community not found. */
+            /** @description Collection or item not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -7421,7 +9544,7 @@ interface operations {
             };
         };
         responses: {
-            /** @description Conversation after update. */
+            /** @description Conversation after update (with the caller's unread_count). */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -7439,7 +9562,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.update`. */
+            /** @description Not an admin (rename), or PAK lacks `social.update`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -7457,6 +9580,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Rename on a non-group conversation. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     ConversationController_addMember: {
@@ -7592,7 +9724,7 @@ interface operations {
             };
         };
     };
-    ConversationController_updateMemberRole: {
+    ConversationController_updateMember: {
         parameters: {
             query?: never;
             header?: never;
@@ -7608,11 +9740,11 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["UpdateMemberRoleDto"];
+                "application/json": components["schemas"]["UpdateMemberDto"];
             };
         };
         responses: {
-            /** @description Role updated. */
+            /** @description Participant updated. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -7621,7 +9753,7 @@ interface operations {
                     "application/json": components["schemas"]["ConversationResponseDto"];
                 };
             };
-            /** @description Caller is not an admin. */
+            /** @description Not an admin (role) or not the target (self-only fields). */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -7768,6 +9900,54 @@ interface operations {
             };
         };
     };
+    ConversationController_getMessage: {
+        parameters: {
+            query: {
+                /** @description The viewer actor UUID — must be a participant. */
+                actor_id: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Conversation UUID. */
+                conversationId: string;
+                /** @description Message UUID. */
+                messageId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The message. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DirectMessageResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Conversation/message not found, or caller not a participant. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     ConversationController_deleteMessage: {
         parameters: {
             query: {
@@ -8226,24 +10406,143 @@ interface operations {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponseDto"];
-                };
+                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). */
+                cursor?: string;
+                /** @description Optional post-kind filter (task 023) — e.g. `image`, `link`. Restricts discovery to that kind. */
+                kind?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of posts. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["FeedResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community or viewer actor not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    EdgeController_dismissSuggestion: {
+        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"]["ActorEdgeDto"];
+            };
+        };
+        responses: {
+            /** @description Suggestion dismissed. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CreateEdgeResponseDto"];
+                };
+            };
+            /** @description Community or actor not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Cannot dismiss yourself. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    EdgeController_undismissSuggestion: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description The dismissing actor UUID. */
+                srcActorId: string;
+                /** @description The dismissed actor UUID. */
+                dstActorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Un-dismissed (or no-op). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
             };
         };
     };
-    FeedController_getDiscoverFeed: {
+    FlagController_listMine: {
         parameters: {
-            query?: {
-                /** @description Viewer actor UUID. */
-                actor_id?: string;
-                /**
-                 * @deprecated
-                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
-                 */
-                viewer_actor_id?: string;
+            query: {
+                /** @description The reporter whose flags to list. */
+                reporter_actor_id: string;
+                status?: "open" | "dismissed" | "actioned";
                 limit?: number;
-                /** @description Opaque ranked cursor; encodes (score, id). */
                 cursor?: string;
             };
             header?: never;
@@ -8255,26 +10554,17 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Page of posts. */
+            /** @description Page of the reporter's flags. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["FeedResponseDto"];
-                };
-            };
-            /** @description PAK lacks `social.list`. */
-            403: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponseDto"];
+                    "application/json": components["schemas"]["FlagListResponseDto"];
                 };
             };
-            /** @description Community or viewer actor not found. */
-            404: {
+            /** @description Missing reporter_actor_id or invalid status. */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -8356,6 +10646,76 @@ interface operations {
             };
         };
     };
+    EdgeController_declineFollowRequest: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description The private actor (decliner). */
+                dstActorId: string;
+                /** @description The requesting actor. */
+                srcActorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Request declined. */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description No pending request for this pair. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    EdgeController_approveFollowRequest: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description The private actor being followed (approver). */
+                dstActorId: string;
+                /** @description The requesting actor. */
+                srcActorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Request approved; follow edge created. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CreateEdgeResponseDto"];
+                };
+            };
+            /** @description No pending request for this pair. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     EdgeController_follow: {
         parameters: {
             query?: never;
@@ -8372,13 +10732,13 @@ interface operations {
             };
         };
         responses: {
-            /** @description Follow edge created (or returned via idempotent retry). */
+            /** @description Follow edge created / exists (`status: followed`), or a follow request created (`status: pending`). */
             201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["CreateEdgeResponseDto"];
+                    "application/json": components["schemas"]["FollowResultDto"];
                 };
             };
             /** @description Missing / invalid src_actor_id / dst_actor_id. */
@@ -8528,6 +10888,10 @@ interface operations {
     HashtagController_list: {
         parameters: {
             query?: {
+                /** @description `recent` (default) = newest tags first; `trending` = most posts in the window. */
+                order?: "recent" | "trending";
+                /** @description Trending window (only meaningful with `order=trending`). */
+                window?: "24h" | "7d";
                 limit?: number;
                 cursor?: string;
             };
@@ -8549,6 +10913,15 @@ interface operations {
                     "application/json": components["schemas"]["HashtagListResponseDto"];
                 };
             };
+            /** @description Invalid order / window. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
@@ -8624,7 +10997,9 @@ interface operations {
     HashtagFeedController_list: {
         parameters: {
             query?: {
+                order?: "chronological" | "ranked";
                 limit?: number;
+                /** @description Chronological pages on (created_at, id); ranked on (score, id). A cursor is not portable across orders. */
                 cursor?: string;
             };
             header?: never;
@@ -8647,7 +11022,7 @@ interface operations {
                     "application/json": components["schemas"]["HashtagPostListResponseDto"];
                 };
             };
-            /** @description Invalid tag (empty after normalisation, or longer than 32 chars). */
+            /** @description Invalid tag or order value. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8676,6 +11051,67 @@ interface operations {
             };
         };
     };
+    EdgeController_hidePost: {
+        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"]["HidePostDto"];
+            };
+        };
+        responses: {
+            /** @description Post hidden. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HideResultDto"];
+                };
+            };
+            /** @description Community, actor, or post not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    EdgeController_unhidePost: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description The actor who hid the post. */
+                srcActorId: string;
+                /** @description The hidden post UUID. */
+                postId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Un-hidden (or no-op). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     ActorListController_list: {
         parameters: {
             query?: {
@@ -10101,8 +12537,115 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Comment is in a status that cannot be approved (hidden / removed). */
-            409: {
+            /** @description Comment is in a status that cannot be approved (hidden / removed). */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    CommentController_pin: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Social post UUID the comments thread under. */
+                postId: string;
+                /** @description Social comment UUID. */
+                commentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PinCommentDto"];
+            };
+        };
+        responses: {
+            /** @description Comment pinned. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentResponseDto"];
+                };
+            };
+            /** @description Caller is not the post-author. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Post or comment not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Reply / non-published comment, or pin cap reached (`PIN_CAP_REACHED`). */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    CommentController_unpin: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Social community UUID. Must belong to the PAK's workspace. */
+                communityId: string;
+                /** @description Social post UUID the comments thread under. */
+                postId: string;
+                /** @description Social comment UUID. */
+                commentId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["PinCommentDto"];
+            };
+        };
+        responses: {
+            /** @description Comment unpinned. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["CommentResponseDto"];
+                };
+            };
+            /** @description Caller is not the post-author. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Post or comment not found. */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -10285,6 +12828,62 @@ interface operations {
             };
         };
     };
+    InsightsController_postInsights: {
+        parameters: {
+            query?: {
+                /** @description Window start (YYYY-MM-DD). */
+                from?: string;
+                /** @description Window end (YYYY-MM-DD). */
+                to?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Social community UUID. */
+                communityId: string;
+                postId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Post insights. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PostInsightsResponseDto"];
+                };
+            };
+            /** @description Invalid window (inverted or > 366 days). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.analytics.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Post not found in this community. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     StoryController_getPollResults: {
         parameters: {
             query?: never;
@@ -10773,6 +13372,103 @@ interface operations {
             };
         };
     };
+    PostTagController_approve: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+                /** @description Post UUID. */
+                postId: string;
+                /** @description Tagged actor UUID. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ActingActorDto"];
+            };
+        };
+        responses: {
+            /** @description Tag approved. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PostTagResponseDto"];
+                };
+            };
+            /** @description Acting actor is not the tagged actor. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Post or tag not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Tag already removed. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
+    PostTagController_remove: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+                /** @description Post UUID. */
+                postId: string;
+                /** @description Tagged actor UUID. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["ActingActorDto"];
+            };
+        };
+        responses: {
+            /** @description Tag removed. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PostTagResponseDto"];
+                };
+            };
+            /** @description Acting actor is neither the tagged actor nor the post author. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Post or tag not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+        };
+    };
     StoryController_listViewers: {
         parameters: {
             query: {
@@ -10899,6 +13595,66 @@ interface operations {
             };
         };
     };
+    StoryController_listVoters: {
+        parameters: {
+            query: {
+                /** @description Requester social actor UUID — must resolve to the poll author. */
+                actor_id: string;
+                /** @description Filter to voters who chose this option index. */
+                option?: number;
+                limit?: number;
+                /** @description Cursor from the prior page. */
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+                /** @description Post UUID containing the poll. */
+                postId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of voters. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PollVotersResponse"];
+                };
+            };
+            /** @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 poll author. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community or post not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     StoryController_castVote: {
         parameters: {
             query?: never;
@@ -10942,17 +13698,105 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community / post / voter not found, or post invisible. */
-            404: {
+            /** @description Community / post / voter not found, or post invisible. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Block in place between voter and poll author. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Self-vote / no poll / option_index out of range / `POLL_CLOSED` (past the poll `closes_at`). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    StoryController_getVote: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+                /** @description Post UUID containing the poll. */
+                postId: string;
+                /** @description Voter social actor UUID. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description The actor's vote. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["PollVoteResponse"];
+                };
+            };
+            /** @description PAK lacks `social.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Post not found, or the actor has not voted. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    StoryController_deleteVote: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Community UUID. */
+                communityId: string;
+                /** @description Post UUID containing the poll. */
+                postId: string;
+                /** @description Voter social actor UUID. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Vote retracted (or no-op). */
+            204: {
                 headers: {
                     [name: string]: unknown;
                 };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponseDto"];
-                };
+                content?: never;
             };
-            /** @description Block in place between voter and poll author. */
-            409: {
+            /** @description PAK lacks `social.vote`. */
+            403: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -10960,8 +13804,8 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Self-vote / no poll / option_index out of range. */
-            422: {
+            /** @description Post not found. */
+            404: {
                 headers: {
                     [name: string]: unknown;
                 };
@@ -11100,6 +13944,8 @@ interface operations {
                  * @description DEPRECATED alias of `actor_id` (task 008 / G11).
                  */
                 requester_id?: string;
+                /** @description Opaque pagination cursor from a prior response. Valid only for the same `q` (task 022). */
+                cursor?: string;
             };
             header?: never;
             path: {
@@ -11110,7 +13956,7 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Ranked actor hits. */
+            /** @description Ranked actor hits, cursor-paginated by (rank, id). */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -11215,6 +14061,8 @@ interface operations {
                  * @description DEPRECATED alias of `actor_id` (task 008 / G11).
                  */
                 requester_id?: string;
+                /** @description Opaque pagination cursor from a prior response. Valid only for the same `(q, order)` pair (task 022). */
+                cursor?: string;
             };
             header?: never;
             path: {
@@ -11225,7 +14073,7 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Ranked post hits. */
+            /** @description Ranked post hits, cursor-paginated by (rank, id) for relevance or (created_at, id) for recent. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -11927,6 +14775,102 @@ interface operations {
             };
         };
     };
+    ExportController_comments: {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Workspace UUID. */
+                workspaceId: string;
+                /** @description Community UUID (must belong to the workspace). */
+                communityId: string;
+                /** @description The data subject — social actor UUID. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of the actor's comments. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ActorCommentsResponseDto"];
+                };
+            };
+            /** @description Caller lacks `social.audit.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community not found in this workspace. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    ExportController_reactions: {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                /** @description Workspace UUID. */
+                workspaceId: string;
+                /** @description Community UUID (must belong to the workspace). */
+                communityId: string;
+                /** @description The data subject — social actor UUID. */
+                actorId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of the actor's reactions. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ActorReactionsResponseDto"];
+                };
+            };
+            /** @description Caller lacks `social.audit.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community not found in this workspace. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     AnalyticsController_getCommunityAnalytics: {
         parameters: {
             query?: never;
@@ -11970,6 +14914,63 @@ interface operations {
             };
         };
     };
+    ModerationAdminController_actDirect: {
+        parameters: {
+            query?: never;
+            header?: {
+                /** @description Opaque client-generated string used to deduplicate retries within a 24h window. Replays return the original response; same key + different body returns 409 `IDEMPOTENCY_KEY_REUSE`. */
+                "Idempotency-Key"?: string;
+            };
+            path: {
+                workspaceId: string;
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["DirectModerationActionDto"];
+            };
+        };
+        responses: {
+            /** @description Action recorded (flag_id=null audit row); side-effect applied. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ModerationActionResponseDto"];
+                };
+            };
+            /** @description Invalid target_kind / action / notes. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Caller lacks `social.moderate`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Community or target not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     ModerationAdminController_shadowBan: {
         parameters: {
             query?: never;
@@ -12123,6 +15124,118 @@ interface operations {
             };
         };
     };
+    ModerationAdminController_listBlockedTerms: {
+        parameters: {
+            query?: {
+                limit?: number;
+                cursor?: string;
+            };
+            header?: never;
+            path: {
+                workspaceId: string;
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Page of blocked terms. */
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BlockedTermListResponseDto"];
+                };
+            };
+            /** @description Caller lacks `social.config.read`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    ModerationAdminController_addBlockedTerm: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: string;
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["CreateBlockedTermDto"];
+            };
+        };
+        responses: {
+            /** @description Blocked term added. */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["BlockedTermResponseDto"];
+                };
+            };
+            /** @description Empty or over-length term. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Caller lacks `social.config.update`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    ModerationAdminController_removeBlockedTerm: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                workspaceId: string;
+                communityId: string;
+                /** @description The blocked term to remove (case-insensitive). */
+                term: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Removed (or no-op). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Caller lacks `social.config.update`. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
     ConversationModerationController_listConversations: {
         parameters: {
             query?: {