@productcraft/social 0.1.1 → 0.2.0

package/dist/index.d.ts

@@ -1740,6 +1740,12 @@ interface paths {
 }
 interface components {
     schemas: {
+        ActOnFlagResponseDto: {
+            /** @description The flag after the action (status flipped to actioned/dismissed for punitive/dismiss actions; reversals re-resolve it too). */
+            flag: components["schemas"]["FlagResponseDto"];
+            /** @description The audit row this action recorded. */
+            moderation_action: components["schemas"]["ModerationActionResponseDto"];
+        };
         ActorCountersResponseDto: {
             /**
              * @description Actor UUID.
@@ -1827,11 +1833,62 @@ interface components {
             list_id: string;
         };
         ActorListResponseDto: {
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Optional description.
+             * @example Curated tech accounts I follow.
+             */
+            description: string | null;
+            /**
+             * @description List UUID.
+             * @example llllllll-0000-0000-0000-000000000001
+             */
+            id: string;
+            /**
+             * @description Current member count.
+             * @example 12
+             */
+            member_count: number;
+            /**
+             * @description List display name.
+             * @example Tech news
+             */
+            name: string;
+            /**
+             * @description List owner — social actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            owner_id: string;
+            /**
+             * @description ISO timestamp.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            updated_at: string;
+            /**
+             * @description public = discoverable; private = owner-only.
+             * @example public
+             * @enum {string}
+             */
+            visibility: "public" | "private";
+        };
+        ActorPageResponseDto: {
             data: components["schemas"]["ActorResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
         ActorResponseDto: {
-            /** @description Avatar URL. */
+            /**
+             * @description Avatar URL.
+             * @example https://cdn.example.com/avatars/ada.png
+             */
             avatar_url: string | null;
             /**
              * @description Owning community UUID.
@@ -1839,43 +1896,46 @@ interface components {
              */
             community_id: string;
             /**
-             * @description ISO timestamp.
+             * @description ISO timestamp the row was inserted.
              * @example 2026-05-01T12:00:00.000Z
              */
             created_at: string;
             /**
              * @description Display name.
-             * @example Alice
+             * @example Ada Lovelace
              */
             display_name: string | null;
             /**
-             * @description Customer-supplied stable id.
-             * @example user-42
+             * @description Customer-supplied stable identifier (your user id).
+             * @example user_abc123
              */
             external_id: string;
             /**
-             * @description Actor UUID.
-             * @example aaaaaaaa-0000-0000-0000-000000000001
+             * @description Social actor UUID.
+             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
              */
             id: string;
-            /** @description Free-form metadata. */
+            /**
+             * @description Free-form metadata blob.
+             * @example {
+             *       "tier": "pro"
+             *     }
+             */
             metadata: Record<string, never>;
-            /** @description ISO timestamp the shadow ban was applied, or null. */
-            shadow_banned_at: string | null;
-            /** @description Moderator note attached to the ban. */
-            shadow_banned_reason: string | null;
-            /** @description ISO timestamp the shadow ban auto-expires, or null for indefinite. */
-            shadow_banned_until: string | null;
-            /** @enum {string} */
+            /**
+             * @description Lifecycle status. `suspended` is moderator-applied via PATCH `status=suspended`; `deleted` is soft-deletion. Shadow-banning is a separate moderation mechanism that does not change `status`.
+             * @example active
+             * @enum {string}
+             */
             status: "active" | "suspended" | "deleted";
             /**
-             * @description ISO timestamp.
+             * @description ISO timestamp of the last update.
              * @example 2026-05-01T12:00:00.000Z
              */
             updated_at: string;
         };
         ActorSearchHitDto: {
-            actor: components["schemas"]["SearchActorResponseDto"];
+            actor: components["schemas"]["ActorResponseDto"];
             /**
              * @description PG `ts_rank` score on the (display_name A, external_id B, bio C) tsvector. Higher = more relevant.
              * @example 0.6079
@@ -1901,6 +1961,18 @@ interface components {
              */
             reaction_counts: Record<string, never>;
         };
+        AddListMemberDto: {
+            /**
+             * @description New member — social actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            actor_id: string;
+            /**
+             * @description Caller — social actor UUID. Must equal the list owner.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            caller_actor_id: string;
+        };
         AddMemberDto: {
             /**
              * @description The new member — social actor UUID.
@@ -2019,7 +2091,7 @@ interface components {
         };
         CloseFriendsListResponse: {
             data: components["schemas"]["CloseFriendResponse"][];
-            pagination: components["schemas"]["CursorPagination"];
+            pagination: components["schemas"]["PaginationResponseDto"];
         };
         CommentListResponseDto: {
             data: components["schemas"]["CommentResponseDto"][];
@@ -2107,11 +2179,18 @@ interface components {
              */
             post_id: string;
             /**
-             * @description Lifecycle status. `removed` rows are hidden from public reads.
+             * @description Map of reaction type to count, denormalised on the comment row in lock-step with the comment-reaction writes.
+             * @example {
+             *       "like": 2
+             *     }
+             */
+            reaction_counts: Record<string, never>;
+            /**
+             * @description Lifecycle status. `pending_approval` = held by restricted-commenter pre-moderation; list endpoints surface these rows only to the comment author and the post-author (who publishes them via POST :commentId/approve). `removed` rows are hidden from public reads.
              * @example published
              * @enum {string}
              */
-            status: "published" | "hidden" | "removed";
+            status: "published" | "hidden" | "removed" | "pending_approval";
             /**
              * @description ISO timestamp of the last update.
              * @example 2026-05-01T12:00:00.000Z
@@ -2514,6 +2593,20 @@ interface components {
              */
             target_kind: "post" | "comment";
         };
+        CreateFlagResponseDto: {
+            /**
+             * @description `true` when this flag pushed the target over the community's `auto_hide_flag_threshold` and the target was auto-hidden as a side effect.
+             * @example false
+             */
+            auto_hidden: boolean;
+            /**
+             * @description `true` when this call inserted a new flag; `false` when de-duplicated to an existing open flag from the same reporter on the same target.
+             * @example true
+             */
+            created: boolean;
+            /** @description The flag row (existing open flag on de-duplicated retry). */
+            flag: components["schemas"]["FlagResponseDto"];
+        };
         CreateHashtagFollowDto: {
             /**
              * @description Lowercase tag (without `#`). Must already exist in the community directory.
@@ -2618,9 +2711,9 @@ interface components {
              */
             created: boolean;
             /** @description The newly-created (or existing) repost post row. */
-            repost: components["schemas"]["RepostPostResponseDto"];
+            repost: components["schemas"]["PostResponseDto"];
             /** @description The source post, with refreshed `repost_count`. */
-            source: components["schemas"]["RepostPostResponseDto"];
+            source: components["schemas"]["PostResponseDto"];
         };
         CreateWebhookDto: {
             /**
@@ -2707,18 +2800,6 @@ interface components {
              */
             url: string;
         };
-        CursorPagination: {
-            /**
-             * @description Whether more pages exist after this one.
-             * @example false
-             */
-            has_more: boolean;
-            /**
-             * @description Opaque base64url cursor; null when no further pages.
-             * @example null
-             */
-            next_cursor: string | null;
-        };
         DeleteActorListDto: {
             /**
              * @description Caller — social actor UUID. Must equal the list owner.
@@ -2766,10 +2847,10 @@ interface components {
             /** @description Delivery row UUID. */
             id: string;
             /**
-             * @description Total round-trip time in ms.
+             * @description Total round-trip time in ms. Null on transport-level failure.
              * @example 67
              */
-            latency_ms: number;
+            latency_ms: number | null;
             /**
              * @description Signed request body that was sent.
              * @example {}
@@ -2843,6 +2924,13 @@ interface components {
              * @enum {string}
              */
             kind: "text" | "image" | "video" | "audio" | "system";
+            /**
+             * @description Map of reaction type to count, denormalised on the message row in lock-step with the DM-reaction writes.
+             * @example {
+             *       "like": 1
+             *     }
+             */
+            reaction_counts: Record<string, never>;
             /**
              * @description Threaded inline reply target.
              * @example null
@@ -2968,6 +3056,13 @@ interface components {
              * @enum {string}
              */
             kind: "text" | "image" | "video" | "audio" | "system";
+            /**
+             * @description Map of reaction type to count, denormalised on the message row in lock-step with the DM-reaction writes.
+             * @example {
+             *       "like": 1
+             *     }
+             */
+            reaction_counts: Record<string, never>;
             /**
              * @description Threaded inline reply target.
              * @example null
@@ -2980,93 +3075,10 @@ interface components {
             sender_id: string;
         };
         DraftListResponseDto: {
-            data: components["schemas"]["DraftPostResponseDto"][];
+            /** @description Draft post rows — status is always 'draft' on this endpoint. */
+            data: components["schemas"]["PostResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
-        DraftPostResponseDto: {
-            /**
-             * @description Author actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
-             */
-            actor_id: string;
-            /**
-             * @description Free-form attributes blob.
-             * @example {}
-             */
-            attributes: Record<string, never>;
-            /**
-             * @description Body draft text.
-             * @example WIP — half a thought…
-             */
-            body: string | null;
-            /**
-             * @description Always 0 for drafts.
-             * @example 0
-             */
-            comment_count: number;
-            /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
-             */
-            community_id: string;
-            /**
-             * @description ISO timestamp the draft was created.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            created_at: string;
-            /**
-             * @description Optional expires_at carried into the published post.
-             * @example null
-             */
-            expires_at: string | null;
-            /**
-             * @description Draft post UUID.
-             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
-             */
-            id: string;
-            /**
-             * @description Free-form post kind.
-             * @example text
-             */
-            kind: string;
-            /**
-             * @description Pinned flag carried into the published post.
-             * @example false
-             */
-            pinned: boolean;
-            /**
-             * @description Empty for drafts (engagement begins at publish).
-             * @example {}
-             */
-            reaction_counts: Record<string, never>;
-            /**
-             * @description Always 'draft' for this endpoint.
-             * @example draft
-             * @enum {string}
-             */
-            status: "draft";
-            /**
-             * @description Optional title.
-             * @example null
-             */
-            title: string | null;
-            /**
-             * @description ISO timestamp of the last update.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            updated_at: string;
-            /**
-             * @description Optional URL.
-             * @example null
-             */
-            url: string | null;
-            /**
-             * @description Visibility scope chosen at draft time. Applies once promoted to published.
-             * @example public
-             * @enum {string}
-             */
-            visibility: "public" | "followers" | "close_friends" | "private";
-        };
         EdgeListResponseDto: {
             data: components["schemas"]["EdgeResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -3098,10 +3110,11 @@ interface components {
              */
             id: string;
             /**
-             * @description Edge kind. `follow`, `mute`, `block`, `save`, or `reaction:<type>` for post reactions.
+             * @description Edge kind. The actor-edge routes emit exactly these four; post reactions and bookmarks have their own response shapes.
              * @example follow
+             * @enum {string}
              */
-            kind: string;
+            kind: "follow" | "mute" | "block" | "restrict";
             /**
              * @description Free-form payload stored on the edge (e.g. mute reason).
              * @example {}
@@ -3113,23 +3126,6 @@ interface components {
              */
             src_actor_id: string;
         };
-        ErrorResponse: {
-            /**
-             * @description Stable error code.
-             * @example NOT_FOUND
-             */
-            code?: string;
-            /**
-             * @description Human-readable error message.
-             * @example Post not found
-             */
-            message: Record<string, never>;
-            /**
-             * @description HTTP status code echoed in the body.
-             * @example 404
-             */
-            statusCode: number;
-        };
         ErrorResponseDto: {
             /**
              * @description Stable error code for programmatic handling. Optional — newer routes set it where the message alone is ambiguous.
@@ -3147,130 +3143,44 @@ interface components {
              */
             statusCode: number;
         };
-        FeedPostResponseDto: {
-            /**
-             * @description Author actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
-             */
-            actor_id: string;
-            /**
-             * @description Free-form attributes blob.
-             * @example {}
-             */
-            attributes: Record<string, never>;
-            /**
-             * @description Body text/markdown.
-             * @example Stories are live!
-             */
-            body: string | null;
-            /**
-             * @description Live denormalised comment count.
-             * @example 4
-             */
-            comment_count: number;
+        FeedResponseDto: {
+            data: components["schemas"]["PostResponseDto"][];
+            /** @description Cursor encodes `(score, id)` for `ranked` feeds and `(created_at, id)` for `chronological` feeds. Cursors are NOT interchangeable between modes. */
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        FlagListResponseDto: {
+            data: components["schemas"]["FlagResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        FlagResponseDto: {
             /**
              * @description Owning community UUID.
              * @example cccccccc-cccc-cccc-cccc-cccccccccccc
              */
             community_id: string;
             /**
-             * @description ISO timestamp the post was created.
+             * @description ISO timestamp the row was inserted.
              * @example 2026-05-01T12:00:00.000Z
              */
             created_at: string;
             /**
-             * @description ISO timestamp; null = no expiry.
-             * @example null
-             */
-            expires_at: string | null;
-            /**
-             * @description Post UUID.
-             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
+             * @description Flag UUID.
+             * @example ffffffff-0000-0000-0000-000000000001
              */
             id: string;
             /**
-             * @description Free-form post kind.
-             * @example text
-             */
-            kind: string;
-            /**
-             * @description Pinned for highlights.
-             * @example false
+             * @description Free-text reason; empty string when none provided.
+             * @example Spam — same link posted 6 times in 5 minutes.
              */
-            pinned: boolean;
+            reason: string;
             /**
-             * @description Live denormalised reaction counts.
-             * @example {
-             *       "like": 12
-             *     }
+             * @description Social actor UUID who reported.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            reaction_counts: Record<string, never>;
+            reporter_actor_id: string;
             /**
-             * @description Lifecycle status. Feed only returns `published`.
-             * @example published
-             * @enum {string}
-             */
-            status: "published" | "hidden" | "removed";
-            /**
-             * @description Optional title.
-             * @example null
-             */
-            title: string | null;
-            /**
-             * @description ISO timestamp of the last update.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            updated_at: string;
-            /**
-             * @description Optional URL.
-             * @example null
-             */
-            url: string | null;
-            /**
-             * @description Visibility scope; the feed is already filtered to what the requester can see.
-             * @example public
-             * @enum {string}
-             */
-            visibility: "public" | "followers" | "close_friends" | "private";
-        };
-        FeedResponseDto: {
-            data: components["schemas"]["FeedPostResponseDto"][];
-            /** @description Cursor encodes `(score, id)` for `ranked` feeds and `(created_at, id)` for `chronological` feeds. Cursors are NOT interchangeable between modes. */
-            pagination: components["schemas"]["PaginationResponseDto"];
-        };
-        FlagListResponseDto: {
-            data: components["schemas"]["FlagResponseDto"][];
-            pagination: components["schemas"]["PaginationResponseDto"];
-        };
-        FlagResponseDto: {
-            /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
-             */
-            community_id: string;
-            /**
-             * @description ISO timestamp the row was inserted.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            created_at: string;
-            /**
-             * @description Flag UUID.
-             * @example ffffffff-0000-0000-0000-000000000001
-             */
-            id: string;
-            /**
-             * @description Free-text reason; empty string when none provided.
-             * @example Spam — same link posted 6 times in 5 minutes.
-             */
-            reason: string;
-            /**
-             * @description Social actor UUID who reported.
-             * @example aaaaaaaa-0000-0000-0000-000000000001
-             */
-            reporter_actor_id: string;
-            /**
-             * @description Lifecycle. `open` is in the queue; admins close to `dismissed` or `actioned`.
-             * @example open
+             * @description Lifecycle. `open` is in the queue; admins close to `dismissed` or `actioned`.
+             * @example open
              * @enum {string}
              */
             status: "open" | "dismissed" | "actioned";
@@ -3368,12 +3278,9 @@ interface components {
             tag: string;
         };
         HighlightsResponse: {
-            /**
-             * @description Page of pinned posts.
-             * @example []
-             */
-            data: string[];
-            pagination: components["schemas"]["CursorPagination"];
+            /** @description Page of pinned posts (full post rows; expiry is bypassed for pinned rows). */
+            data: components["schemas"]["PostResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
         };
         LeaveConversationDto: {
             /**
@@ -3443,7 +3350,7 @@ interface components {
         };
         ModerationActionDto: {
             /**
-             * @description Action to apply. `hide`/`remove` transition target status; `unhide`/`restore` reverse them. `warn`/`ban` are audit-only. `dismiss` closes the flag with no target change.
+             * @description Action to apply. `hide`/`remove` transition target status; `unhide`/`restore` reverse them. `warn`/`ban` are audit-only — they record the decision without touching the target; for actor-level enforcement use PATCH `/actors/:actorId` with `status=suspended` or the shadow-ban endpoints on this controller. `dismiss` closes the flag with no target change.
              * @example hide
              * @enum {string}
              */
@@ -3472,7 +3379,7 @@ interface components {
              */
             created_at: string;
             /**
-             * @description Flag UUID this action closed; `null` for unsolicited mod actions.
+             * @description Flag UUID this action was applied to.
              * @example ffffffff-0000-0000-0000-000000000001
              */
             flag_id: string | null;
@@ -3502,6 +3409,66 @@ interface components {
              */
             target_kind: "post" | "comment";
         };
+        ModerationActorListResponseDto: {
+            data: components["schemas"]["ModerationActorResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
+        ModerationActorResponseDto: {
+            /**
+             * @description Avatar URL.
+             * @example https://cdn.example.com/avatars/ada.png
+             */
+            avatar_url: string | null;
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp the row was inserted.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Display name.
+             * @example Ada Lovelace
+             */
+            display_name: string | null;
+            /**
+             * @description Customer-supplied stable identifier (your user id).
+             * @example user_abc123
+             */
+            external_id: string;
+            /**
+             * @description Social actor UUID.
+             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
+             */
+            id: string;
+            /**
+             * @description Free-form metadata blob.
+             * @example {
+             *       "tier": "pro"
+             *     }
+             */
+            metadata: Record<string, never>;
+            /** @description ISO timestamp the shadow ban was applied, or null. */
+            shadow_banned_at: string | null;
+            /** @description Moderator note attached to the ban. */
+            shadow_banned_reason: string | null;
+            /** @description ISO timestamp the shadow ban auto-expires, or null for indefinite. */
+            shadow_banned_until: string | null;
+            /**
+             * @description Lifecycle status. `suspended` is moderator-applied via PATCH `status=suspended`; `deleted` is soft-deletion. Shadow-banning is a separate moderation mechanism that does not change `status`.
+             * @example active
+             * @enum {string}
+             */
+            status: "active" | "suspended" | "deleted";
+            /**
+             * @description ISO timestamp of the last update.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            updated_at: string;
+        };
         MutedTermResponseDto: {
             /**
              * @description Owning actor UUID.
@@ -3535,22 +3502,10 @@ interface components {
              */
             term: string;
         };
-        NotificationListPagination: {
-            /**
-             * @description Whether more pages exist after this one.
-             * @example false
-             */
-            has_more: boolean;
-            /**
-             * @description Opaque base64url cursor for the next page; `null` when no further pages.
-             * @example eyJjcmVhdGVkX2F0IjoiMjAyNi0wNS0wMVQxMjowMDowMC4wMDBaIiwiaWQiOiIxMTExMSJ9
-             */
-            next_cursor: string | null;
-        };
         NotificationListResponse: {
             /** @description Page of notifications, newest first. */
             data: components["schemas"]["NotificationResponse"][];
-            pagination: components["schemas"]["NotificationListPagination"];
+            pagination: components["schemas"]["PaginationResponseDto"];
         };
         NotificationPrefListResponseDto: {
             /** @description One row per known NotificationKind. Kinds the actor has not explicitly toggled report `enabled=true` and an epoch `updated_at`, so the client always sees the full catalogue with effective state. */
@@ -3572,7 +3527,7 @@ interface components {
              * @example follow
              * @enum {string}
              */
-            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post";
+            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction";
             /**
              * @description ISO timestamp of the last update. Synthesised entries (no explicit row) report epoch.
              * @example 2026-05-01T12:00:00.000Z
@@ -3601,13 +3556,13 @@ interface components {
              */
             id: string;
             /**
-             * @description What happened. `follow` / `reaction` / `comment_on_post` / `reply_to_comment`. `mention` is reserved.
+             * @description What happened. Content kinds (`follow`, `reaction`, `comment_on_post`, `reply_to_comment`, `mention`, `vote`, `repost`, `quote_post`) plus the DM kinds (`dm_new_message`, `dm_added_to_group`, `dm_role_changed`, `dm_reaction`).
              * @example reaction
              * @enum {string}
              */
-            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention";
+            kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction";
             /**
-             * @description Kind-specific extras. `reaction`: `{type}`. `comment_on_post` / `reply_to_comment`: `{comment_id}`.
+             * @description Kind-specific extras. `reaction`: `{type}` (+ `{post_id}` when the target is a comment). `comment_on_post` / `reply_to_comment`: `{comment_id}`. `mention`: `{post_id}` (+ `{comment_id}` for comment mentions).
              * @example {
              *       "type": "like"
              *     }
@@ -3623,17 +3578,22 @@ interface components {
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
             recipient_actor_id: string;
+            /**
+             * @description When `true`, the recipient has restricted the triggering actor — the row is hidden from the default `inbox` slice and surfaces on `?status=requests` (or `all`).
+             * @example false
+             */
+            suppressed: boolean;
             /**
              * @description id of the actor / post / comment the event happened on.
              * @example bbbbbbbb-0000-0000-0000-000000000001
              */
             target_id: string;
             /**
-             * @description Switches what `target_id` references. `actor` for follow; `post` for reaction / comment_on_post; `comment` for reply_to_comment.
+             * @description Switches what `target_id` references. `actor` for follow; `post` for vote / repost / quote_post / comment_on_post and post-targeted reactions/mentions; `comment` for reply_to_comment and comment-targeted reactions/mentions; `direct_message` for the dm_* kinds.
              * @example post
              * @enum {string}
              */
-            target_kind: "actor" | "post" | "comment";
+            target_kind: "actor" | "post" | "comment" | "direct_message";
         };
         PaginationResponseDto: {
             /**
@@ -3760,7 +3720,7 @@ interface components {
              */
             id: string;
             /**
-             * @description Free-form post kind. Common: text, link, image, story.
+             * @description Free-form post kind. Common: text, link, image, story, repost, quote.
              * @example text
              */
             kind: string;
@@ -3787,17 +3747,22 @@ interface components {
              * @example 0
              */
             repost_count: number;
+            /**
+             * @description ISO publish-at timestamp, set while status='scheduled'. The scheduler cron promotes the post to published and clears this field; a manual PATCH promotion leaves the last value in place unless the caller also passes scheduled_for: null.
+             * @example null
+             */
+            scheduled_for: string | null;
             /**
              * @description For kind='repost' / 'quote': the source post UUID.
              * @example null
              */
             source_post_id: string | null;
             /**
-             * @description Lifecycle status. `removed` rows are hidden from public reads.
+             * @description Lifecycle status. Public list/feed surfaces only return `published`; `draft` and `scheduled` rows surface exclusively on the author-scoped drafts / scheduled-posts listings and author reads. `removed` rows are hidden from reads.
              * @example published
              * @enum {string}
              */
-            status: "published" | "hidden" | "removed";
+            status: "published" | "hidden" | "removed" | "draft" | "scheduled";
             /**
              * @description Optional title (1-240 chars).
              * @example Shipping Phase 8
@@ -3814,7 +3779,7 @@ interface components {
              */
             url: string | null;
             /**
-             * @description Denormalised impression count, bumped via POST /posts/views.
+             * @description Denormalised impression count, bumped via the batch POST /posts/views endpoint.
              * @example 0
              */
             view_count: number;
@@ -3862,7 +3827,7 @@ interface components {
             title: string | null;
         };
         PostSearchHitDto: {
-            post: components["schemas"]["SearchPostResponseDto"];
+            post: components["schemas"]["PostResponseDto"];
             /**
              * @description PG ts_rank score on the (title A, body B) tsvector. Higher = more relevant. Returned even when order='recent' so clients can render a relevance badge.
              * @example 0.6079
@@ -3882,13 +3847,55 @@ interface components {
              */
             reaction_counts: Record<string, never>;
         };
+        ReactionEdgeResponseDto: {
+            /**
+             * @description Owning community UUID.
+             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
+             */
+            community_id: string;
+            /**
+             * @description ISO timestamp.
+             * @example 2026-05-01T12:00:00.000Z
+             */
+            created_at: string;
+            /**
+             * @description Destination actor UUID — always `null` for post reactions (the target is `dst_post_id`).
+             * @example null
+             */
+            dst_actor_id: string | null;
+            /**
+             * @description Target post UUID.
+             * @example pppppppp-pppp-pppp-pppp-pppppppppppp
+             */
+            dst_post_id: string;
+            /**
+             * @description Edge UUID.
+             * @example eeeeeeee-0000-0000-0000-000000000001
+             */
+            id: string;
+            /**
+             * @description Edge kind (`reaction:<type>`).
+             * @example reaction:like
+             */
+            kind: string;
+            /**
+             * @description Free-form payload.
+             * @example {}
+             */
+            payload: Record<string, never>;
+            /**
+             * @description Reactor actor UUID.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            src_actor_id: string;
+        };
         ReactionResponseDto: {
             /**
              * @description `true` on first call; `false` on idempotent retry.
              * @example true
              */
             created: boolean;
-            edge: components["schemas"]["EdgeResponseDto"];
+            edge: components["schemas"]["ReactionEdgeResponseDto"];
             /**
              * @description Denormalised reaction counts after the write.
              * @example {
@@ -3915,6 +3922,13 @@ interface components {
              */
             post_ids: string[];
         };
+        RemoveListMemberDto: {
+            /**
+             * @description Caller — social actor UUID. Must equal the list owner.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            caller_actor_id: string;
+        };
         RemoveMemberDto: {
             /**
              * @description Social actor UUID of the acting party. Equal to the target for self-leave.
@@ -3933,235 +3947,9 @@ interface components {
         };
         RepostListResponseDto: {
             /** @description Page of repost post rows, each carrying the reposting actor_id. */
-            data: components["schemas"]["RepostPostResponseDto"][];
+            data: components["schemas"]["PostResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
         };
-        RepostPostResponseDto: {
-            /**
-             * @description Author actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
-             */
-            actor_id: string;
-            /**
-             * @description Free-form attributes blob.
-             * @example {}
-             */
-            attributes: Record<string, never>;
-            /**
-             * @description Body. Always null for reposts.
-             * @example null
-             */
-            body: string | null;
-            /**
-             * @description Live denormalised comment count.
-             * @example 0
-             */
-            comment_count: number;
-            /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
-             */
-            community_id: string;
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            created_at: string;
-            /**
-             * @description ISO timestamp; null = no expiry.
-             * @example null
-             */
-            expires_at: string | null;
-            /**
-             * @description Post UUID.
-             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
-             */
-            id: string;
-            /**
-             * @description Post kind. 'repost' for repost rows.
-             * @example repost
-             */
-            kind: string;
-            /**
-             * @description Pinned for highlights.
-             * @example false
-             */
-            pinned: boolean;
-            /**
-             * @description Live denormalised reaction counts.
-             * @example {}
-             */
-            reaction_counts: Record<string, never>;
-            /**
-             * @description Reposts of this post (always 0 for the repost row itself).
-             * @example 0
-             */
-            repost_count: number;
-            /**
-             * @description For reposts: source post UUID.
-             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
-             */
-            source_post_id: string | null;
-            /**
-             * @description Lifecycle status.
-             * @example published
-             * @enum {string}
-             */
-            status: "published" | "hidden" | "removed" | "draft";
-            /**
-             * @description Optional title.
-             * @example null
-             */
-            title: string | null;
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            updated_at: string;
-            /**
-             * @description Optional URL.
-             * @example null
-             */
-            url: string | null;
-            /**
-             * @description Visibility scope (inherited from the source).
-             * @example public
-             * @enum {string}
-             */
-            visibility: "public" | "followers" | "close_friends" | "private";
-        };
-        SearchActorResponseDto: {
-            /**
-             * @description Avatar URL.
-             * @example https://...
-             */
-            avatar_url: string | null;
-            /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
-             */
-            community_id: string;
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            created_at: string;
-            /**
-             * @description Display name.
-             * @example Ada Lovelace
-             */
-            display_name: string | null;
-            /**
-             * @description Customer-supplied stable identifier.
-             * @example ada
-             */
-            external_id: string;
-            /**
-             * @description Social actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
-             */
-            id: string;
-            /**
-             * @description Free-form metadata.
-             * @example {}
-             */
-            metadata: Record<string, never>;
-            /**
-             * @description Lifecycle status. Search only surfaces `active` actors.
-             * @example active
-             * @enum {string}
-             */
-            status: "active" | "suspended" | "deleted";
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            updated_at: string;
-        };
-        SearchPostResponseDto: {
-            /**
-             * @description Author actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
-             */
-            actor_id: string;
-            /**
-             * @description Free-form attributes blob.
-             * @example {}
-             */
-            attributes: Record<string, never>;
-            /**
-             * @description Body text.
-             * @example shipping today.
-             */
-            body: string | null;
-            /**
-             * @description Live denormalised comment count.
-             * @example 0
-             */
-            comment_count: number;
-            /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
-             */
-            community_id: string;
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            created_at: string;
-            /**
-             * @description ISO timestamp; null = no expiry.
-             * @example null
-             */
-            expires_at: string | null;
-            /**
-             * @description Post UUID.
-             * @example bbbbbbbb-bbbb-bbbb-bbbb-bbbbbbbbbbbb
-             */
-            id: string;
-            /**
-             * @description Free-form post kind.
-             * @example text
-             */
-            kind: string;
-            /**
-             * @description Pinned for highlights.
-             * @example false
-             */
-            pinned: boolean;
-            /**
-             * @description Live denormalised reaction counts.
-             * @example {}
-             */
-            reaction_counts: Record<string, never>;
-            /**
-             * @description Lifecycle status. Search only surfaces 'published'.
-             * @example published
-             * @enum {string}
-             */
-            status: "published" | "hidden" | "removed" | "draft";
-            /**
-             * @description Optional title.
-             * @example null
-             */
-            title: string | null;
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            updated_at: string;
-            /**
-             * @description Optional URL.
-             * @example null
-             */
-            url: string | null;
-            /**
-             * @description Visibility scope.
-             * @example public
-             * @enum {string}
-             */
-            visibility: "public" | "followers" | "close_friends" | "private";
-        };
         SendMessageDto: {
             attachments?: components["schemas"]["DirectMessageAttachmentDto"][];
             /**
@@ -4251,60 +4039,10 @@ interface components {
         };
         StoryViewersResponse: {
             data: components["schemas"]["StoryViewerResponse"][];
-            pagination: components["schemas"]["CursorPagination"];
-        };
-        SuggestedActorResponseDto: {
-            /**
-             * @description Avatar URL.
-             * @example https://cdn.example.com/avatars/ada.png
-             */
-            avatar_url: string | null;
-            /**
-             * @description Owning community UUID.
-             * @example cccccccc-cccc-cccc-cccc-cccccccccccc
-             */
-            community_id: string;
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            created_at: string;
-            /**
-             * @description Display name.
-             * @example Ada Lovelace
-             */
-            display_name: string | null;
-            /**
-             * @description Customer-supplied stable identifier.
-             * @example user_abc123
-             */
-            external_id: string;
-            /**
-             * @description Social actor UUID.
-             * @example aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa
-             */
-            id: string;
-            /**
-             * @description Free-form metadata blob.
-             * @example {
-             *       "tier": "pro"
-             *     }
-             */
-            metadata: Record<string, never>;
-            /**
-             * @description Lifecycle status. Suggestions only surface `active` actors.
-             * @example active
-             * @enum {string}
-             */
-            status: "active" | "suspended" | "deleted";
-            /**
-             * @description ISO timestamp.
-             * @example 2026-05-01T12:00:00.000Z
-             */
-            updated_at: string;
+            pagination: components["schemas"]["PaginationResponseDto"];
         };
         SuggestedFollowResponseDto: {
-            actor: components["schemas"]["SuggestedActorResponseDto"];
+            actor: components["schemas"]["ActorResponseDto"];
             /**
              * @description Why this candidate surfaced. `followed_by_friends` is the friend-of-a-friend signal; `top_in_community` is the cold-start fallback used when FoF doesn't fill the requested limit.
              * @example followed_by_friends
@@ -4439,7 +4177,7 @@ interface components {
             /** @description ISO-8601 publish-at timestamp. Updating only valid while the post is `status="scheduled"`. Pass null to clear (typically only the scheduler does this on promotion). */
             scheduled_for?: string | null;
             /**
-             * @description Direct status transition. Pass `published` to promote a `draft` or `scheduled`. Prefer the moderation lane for `hidden`/`removed`. Transitions to/from `draft`/`scheduled` other than to `published` are 422.
+             * @description Direct status transition. Pass `published` to promote a `draft` or `scheduled`. Prefer the moderation lane for `hidden`/`removed`.
              * @enum {string}
              */
             status?: "published" | "hidden" | "removed" | "draft" | "scheduled";
@@ -4584,10 +4322,19 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ActorListResponseDto"];
+                    "application/json": components["schemas"]["ActorPageResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4861,7 +4608,16 @@ interface operations {
                     "application/json": components["schemas"]["EdgeListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -4954,13 +4710,13 @@ interface operations {
                     "application/json": components["schemas"]["CloseFriendsListResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            400: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description PAK lacks `social.close-friend.read`. */
@@ -4969,7 +4725,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found. */
@@ -4978,7 +4734,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -5110,7 +4866,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -5156,7 +4912,16 @@ interface operations {
                     "application/json": components["schemas"]["EdgeListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -5202,7 +4967,16 @@ interface operations {
                     "application/json": components["schemas"]["EdgeListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -5383,7 +5157,7 @@ interface operations {
                 limit?: number;
                 /** @description Cursor from the prior page. */
                 cursor?: string;
-                /** @description Requester's external_id. Without it, only public pinned posts surface. */
+                /** @description Requester social actor UUID. Without it, only public pinned posts surface. */
                 requester_id?: string;
             };
             header?: never;
@@ -5406,22 +5180,13 @@ interface operations {
                     "application/json": components["schemas"]["HighlightsResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description PAK lacks `social.read`. */
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found. */
@@ -5430,7 +5195,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -5650,7 +5415,16 @@ interface operations {
                     "application/json": components["schemas"]["EdgeListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -5722,8 +5496,8 @@ interface operations {
                 communityId: string;
                 /** @description Social actor UUID. */
                 actorId: string;
-                /** @description NotificationKind label (`follow` | `reaction` | `comment_on_post` | `reply_to_comment` | `mention` | `vote`). */
-                kind: string;
+                /** @description NotificationKind label. */
+                kind: "follow" | "reaction" | "comment_on_post" | "reply_to_comment" | "mention" | "vote" | "repost" | "quote_post" | "dm_new_message" | "dm_added_to_group" | "dm_role_changed" | "dm_reaction";
             };
             cookie?: never;
         };
@@ -5803,22 +5577,13 @@ interface operations {
                     "application/json": components["schemas"]["NotificationListResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
             /** @description PAK lacks `social.notify.read` for this community. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found (also returned for cross-workspace probes). */
@@ -5827,7 +5592,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -5865,16 +5630,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description PAK lacks `social.notify.update` for this community. */
@@ -5883,7 +5639,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found. */
@@ -5892,7 +5648,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -5920,22 +5676,13 @@ interface operations {
                     "application/json": components["schemas"]["UnreadCountResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
             /** @description PAK lacks `social.notify.read` for this community. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found. */
@@ -5944,7 +5691,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -5982,16 +5729,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description PAK lacks `social.notify.update` for this community. */
@@ -6000,7 +5738,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Notification not found, or belongs to a different actor. */
@@ -6009,7 +5747,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -6040,7 +5778,16 @@ interface operations {
                     "application/json": components["schemas"]["EdgeListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description Invalid cursor (`INVALID_CURSOR`) — legacy raw-id cursors are rejected; restart from the first page and follow `pagination.next_cursor`. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -6129,22 +5876,13 @@ interface operations {
                     "application/json": components["schemas"]["StoryTrayResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description PAK lacks `social.read`. */
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or actor not found. */
@@ -6153,7 +5891,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -6256,6 +5994,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Cannot block yourself. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     EdgeController_unblock: {
@@ -6274,7 +6021,7 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Unblocked. */
+            /** @description Unblocked (or no edge to remove). */
             204: {
                 headers: {
                     [name: string]: unknown;
@@ -6290,7 +6037,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community not found. */
+            /** @description Community or actor not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -6330,16 +6077,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description PAK lacks `social.close-friend.manage`. */
@@ -6348,7 +6086,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community / owner / member not found. */
@@ -6357,7 +6095,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Block in place between owner and member. */
@@ -6366,7 +6104,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Cannot add yourself as a close friend. */
@@ -6375,7 +6113,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -6403,22 +6141,13 @@ interface operations {
                 };
                 content?: never;
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
             /** @description PAK lacks `social.close-friend.manage`. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community not found. */
@@ -6427,7 +6156,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -7489,13 +7218,13 @@ interface operations {
             };
         };
         responses: {
-            /** @description Flag created (or de-duplicated to existing open flag). */
+            /** @description Flag created (or de-duplicated to existing open flag). `auto_hidden` reports whether the auto-hide threshold tripped. */
             201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["FlagResponseDto"];
+                    "application/json": components["schemas"]["CreateFlagResponseDto"];
                 };
             };
             /** @description Validation failure (bad reporter / target / reason). */
@@ -7525,7 +7254,16 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Cannot flag your own content, or the target post/comment is already removed. */
+            /** @description The target post/comment is already removed; nothing to flag. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Cannot flag your own content. */
             422: {
                 headers: {
                     [name: string]: unknown;
@@ -7597,6 +7335,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Cannot follow yourself. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     EdgeController_unfollow: {
@@ -7631,7 +7378,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community not found. */
+            /** @description Community or actor not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -7764,6 +7511,15 @@ interface operations {
                     "application/json": components["schemas"]["HashtagPostListResponseDto"];
                 };
             };
+            /** @description Invalid tag (empty after normalisation, or longer than 32 chars). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
@@ -8144,7 +7900,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["AddMemberDto"];
+                "application/json": components["schemas"]["AddListMemberDto"];
             };
         };
         responses: {
@@ -8202,7 +7958,7 @@ interface operations {
         };
         requestBody: {
             content: {
-                "application/json": components["schemas"]["RemoveMemberDto"];
+                "application/json": components["schemas"]["RemoveListMemberDto"];
             };
         };
         responses: {
@@ -8294,6 +8050,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Cannot mute yourself. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     EdgeController_unmute: {
@@ -8312,7 +8077,7 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Unmuted. */
+            /** @description Unmuted (or no edge to remove). */
             204: {
                 headers: {
                     [name: string]: unknown;
@@ -8328,7 +8093,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community not found. */
+            /** @description Community or actor not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -8365,7 +8130,7 @@ interface operations {
                     "application/json": components["schemas"]["PostListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -8427,7 +8192,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community or actor not found in the PAK's workspace. */
+            /** @description Community, actor, or quote source post not found in the PAK's workspace. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -8436,6 +8201,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Quote rules: `CANNOT_QUOTE_SELF` (kind='quote' with your own post as source) or `CANNOT_QUOTE_PRIVATE` (source post is private). */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     PostController_recordViews: {
@@ -8618,6 +8392,15 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description `EDIT_WINDOW_EXPIRED` (content edit after the community's edit window), or `scheduled_for` passed while the post is not `status='scheduled'`. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     BookmarkController_create: {
@@ -8760,7 +8543,7 @@ interface operations {
                     "application/json": components["schemas"]["CommentListResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.read`. */
+            /** @description PAK lacks `social.list`. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -9256,22 +9039,13 @@ interface operations {
                     "application/json": components["schemas"]["PollResultsResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
             /** @description PAK lacks `social.read`. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or post not found. */
@@ -9280,7 +9054,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Post does not contain a poll. */
@@ -9289,7 +9063,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -9673,7 +9447,7 @@ interface operations {
     StoryController_listViewers: {
         parameters: {
             query: {
-                /** @description Must resolve to the post author. */
+                /** @description Requester social actor UUID — must resolve to the post author. */
                 requester_id: string;
                 limit?: number;
                 /** @description Cursor from the prior page. */
@@ -9699,22 +9473,13 @@ interface operations {
                     "application/json": components["schemas"]["StoryViewersResponse"];
                 };
             };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description PAK lacks `social.read` OR requester is not the post author. */
+            /** @description PAK lacks `social.list` OR requester is not the post author. */
             403: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community or post not found. */
@@ -9723,7 +9488,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -9759,16 +9524,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description PAK lacks `social.view`. */
@@ -9777,7 +9533,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community / post / viewer not found, or the post is invisible to the viewer. */
@@ -9786,7 +9542,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Cannot view your own story. */
@@ -9795,7 +9551,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -9831,16 +9587,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
-                };
-            };
-            /** @description Missing or invalid PAK. */
-            401: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description PAK lacks `social.vote`. */
@@ -9849,7 +9596,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Community / post / voter not found, or post invisible. */
@@ -9858,7 +9605,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Block in place between voter and poll author. */
@@ -9867,7 +9614,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
             /** @description Self-vote / no poll / option_index out of range. */
@@ -9876,7 +9623,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ErrorResponse"];
+                    "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
         };
@@ -9933,6 +9680,24 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
+            /** @description Block exists between the pair. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description Cannot restrict yourself. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
         };
     };
     EdgeController_unrestrict: {
@@ -9951,7 +9716,7 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Unrestricted. */
+            /** @description Unrestricted (or no edge to remove). */
             204: {
                 headers: {
                     [name: string]: unknown;
@@ -9967,7 +9732,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Community not found. */
+            /** @description Community or actor not found. */
             404: {
                 headers: {
                     [name: string]: unknown;
@@ -10156,13 +9921,13 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Webhook or null. */
+            /** @description The active webhook, or a literal JSON `null` body when the community has no active webhook registered. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["WebhookResponseDto"];
+                    "application/json": components["schemas"]["WebhookResponseDto"] | null;
                 };
             };
             /** @description Community not found. */
@@ -10444,7 +10209,7 @@ interface operations {
                     "application/json": components["schemas"]["CommunityResponseDto"][];
                 };
             };
-            /** @description Caller lacks `social.read`, or the workspace has not enabled the `social` service. */
+            /** @description Caller lacks `social.list`, or the workspace has not enabled the `social` service. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -10735,7 +10500,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ActorResponseDto"];
+                    "application/json": components["schemas"]["ModerationActorResponseDto"];
                 };
             };
             /** @description Invalid duration_hours or reason. */
@@ -10786,7 +10551,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ActorResponseDto"];
+                    "application/json": components["schemas"]["ModerationActorResponseDto"];
                 };
             };
             /** @description Caller lacks `social.moderate`. */
@@ -11014,13 +10779,13 @@ interface operations {
             };
         };
         responses: {
-            /** @description Action recorded; target status updated where applicable. */
+            /** @description Action recorded; target status updated where applicable. Returns the updated flag and the audit row. */
             201: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ModerationActionResponseDto"];
+                    "application/json": components["schemas"]["ActOnFlagResponseDto"];
                 };
             };
             /** @description Invalid action or notes. */
@@ -11050,7 +10815,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description Flag already actioned/dismissed and the requested action would be a no-op. */
+            /** @description FLAG_ALREADY_CLOSED — the flag is already actioned/dismissed and the requested action is punitive (hide/remove/warn/ban). Reversals (unhide/restore/dismiss) stay legal on a closed flag. */
             409: {
                 headers: {
                     [name: string]: unknown;
@@ -11082,7 +10847,7 @@ interface operations {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["ActorListResponseDto"];
+                    "application/json": components["schemas"]["ModerationActorListResponseDto"];
                 };
             };
             /** @description Caller lacks `social.audit.read`. */