@atproto/api 0.24.3 → 0.26.0

package/dist/client/lexicons.d.ts

@@ -228,6 +228,14 @@ export declare const schemaDict: {
                         readonly type: 'ref';
                         readonly ref: 'lex:com.atproto.repo.strongRef';
                     };
+                    readonly links: {
+                        readonly type: 'array';
+                        readonly description: "The profile's links, in display order. Links that were taken down or don't resolve are left out.";
+                        readonly items: {
+                            readonly type: 'ref';
+                            readonly ref: 'lex:app.bsky.actor.defs#profileLinkView';
+                        };
+                    };
                     readonly verification: {
                         readonly type: 'ref';
                         readonly ref: 'lex:app.bsky.actor.defs#verificationState';
@@ -299,6 +307,43 @@ export declare const schemaDict: {
                     };
                 };
             };
+            readonly profileLinkView: {
+                readonly type: 'object';
+                readonly required: ["uri", "cid", "url"];
+                readonly properties: {
+                    readonly uri: {
+                        readonly type: 'string';
+                        readonly format: 'at-uri';
+                        readonly description: 'The app.bsky.actor.link record, e.g. for reporting the link.';
+                    };
+                    readonly cid: {
+                        readonly type: 'string';
+                        readonly format: 'cid';
+                    };
+                    readonly url: {
+                        readonly type: 'string';
+                        readonly format: 'uri';
+                        readonly description: 'The link destination.';
+                    };
+                    readonly title: {
+                        readonly type: 'string';
+                        readonly maxGraphemes: 40;
+                        readonly maxLength: 320;
+                    };
+                    readonly icon: {
+                        readonly type: 'string';
+                        readonly format: 'uri';
+                        readonly description: "Image URL for the destination site's icon.";
+                    };
+                    readonly labels: {
+                        readonly type: 'array';
+                        readonly items: {
+                            readonly type: 'ref';
+                            readonly ref: 'lex:com.atproto.label.defs#label';
+                        };
+                    };
+                };
+            };
             readonly profileAssociatedActivitySubscription: {
                 readonly type: 'object';
                 readonly required: ["allowSubscriptions"];
@@ -1030,6 +1075,49 @@ export declare const schemaDict: {
             };
         };
     };
+    readonly AppBskyActorLink: {
+        readonly lexicon: 1;
+        readonly id: 'app.bsky.actor.link';
+        readonly defs: {
+            readonly main: {
+                readonly type: 'record';
+                readonly description: "A link shown on the account's profile. The profile record's links field sets which links are shown, and in what order.";
+                readonly key: 'tid';
+                readonly record: {
+                    readonly type: 'object';
+                    readonly required: ["url", "createdAt"];
+                    readonly properties: {
+                        readonly url: {
+                            readonly type: 'string';
+                            readonly format: 'uri';
+                            readonly description: 'The link destination, an https URL.';
+                        };
+                        readonly title: {
+                            readonly type: 'string';
+                            readonly description: "Optional label for the link. Clients can fall back to the destination's domain.";
+                            readonly maxGraphemes: 40;
+                            readonly maxLength: 320;
+                        };
+                        readonly icon: {
+                            readonly type: 'blob';
+                            readonly description: "The destination site's icon, uploaded when the link is saved.";
+                            readonly accept: ["image/png", "image/jpeg", "image/webp"];
+                            readonly maxSize: 100000;
+                        };
+                        readonly createdAt: {
+                            readonly type: 'string';
+                            readonly format: 'datetime';
+                        };
+                        readonly labels: {
+                            readonly type: 'union';
+                            readonly description: 'Self-label values for this link.';
+                            readonly refs: ["lex:com.atproto.label.defs#selfLabels"];
+                        };
+                    };
+                };
+            };
+        };
+    };
     readonly AppBskyActorProfile: {
         readonly lexicon: 1;
         readonly id: 'app.bsky.actor.profile';
@@ -1087,6 +1175,15 @@ export declare const schemaDict: {
                             readonly type: 'ref';
                             readonly ref: 'lex:com.atproto.repo.strongRef';
                         };
+                        readonly links: {
+                            readonly type: 'array';
+                            readonly description: 'Links shown on the profile, in display order. Each ref points to an app.bsky.actor.link record in this repo.';
+                            readonly maxLength: 10;
+                            readonly items: {
+                                readonly type: 'ref';
+                                readonly ref: 'lex:com.atproto.repo.strongRef';
+                            };
+                        };
                         readonly createdAt: {
                             readonly type: 'string';
                             readonly format: 'datetime';
@@ -3148,19 +3245,24 @@ export declare const schemaDict: {
         readonly defs: {
             readonly main: {
                 readonly type: 'query';
-                readonly description: "Resolve one or more AT-URIs into the data needed to render an enhanced external embed. Returns `associatedRefs` (strongRefs to embed into a post's external.associatedRefs), the raw `associatedRecords`, and a hydrated `view`. The response is empty (`{}`) when no records were resolvable, or when validation determined the resolved records don't actually back the requested URL; clients should fall back to their own link-card rendering in that case and skip writing strongRefs to the post.";
+                readonly description: "Resolve one AT-URI record into the data needed to render an enhanced external embed. The records are validated against the requested `url` before any view is built. When validation passes, returns `data`, `associatedRefs` (strongRefs to embed into a post's external.associatedRefs) and the raw `associatedRecords`, plus a legacy `view` for Standard.site records only. When validation fails, only `unverifiedAssociatedRefs` and `unverifiedAssociatedRecords` are returned and no view or data is built. The response is empty (`{}`) when no record URI was usable or the record could not be resolved; clients should fall back to their own link-card rendering in that case and skip writing strongRefs to the post.";
                 readonly parameters: {
                     readonly type: 'params';
-                    readonly required: ["url", "uris"];
+                    readonly required: ["url"];
                     readonly properties: {
                         readonly url: {
                             readonly type: 'string';
                             readonly format: 'uri';
-                            readonly description: "The canonical web URL the embed represents (typically the URL the user pasted into the composer). Used as the returned view's `uri`. May be used for validation in the future.";
+                            readonly description: "The canonical web URL the embed represents (typically the URL the user pasted into the composer). Used as the returned view's `uri`, and validated against the resolved records.";
+                        };
+                        readonly canonicalUri: {
+                            readonly type: 'string';
+                            readonly format: 'at-uri';
+                            readonly description: 'The canonical AT URI of the atproto record found on the webpage. When provided, takes precedence over `uris`, which is then ignored.';
                         };
                         readonly uris: {
                             readonly type: 'array';
-                            readonly description: 'AT-URIs of any Atmosphere records that can be resolved and used to construct #externalView views. Example: a site.standard.document and optionally its associated site.standard.publication.';
+                            readonly description: "Legacy input for Standard.site callers, ignored when `canonicalUri` is provided. A single record is selected from it: the first site.standard.document URI, otherwise the first site.standard.publication URI. Other entries are ignored; a document's publication is discovered from the document itself.";
                             readonly items: {
                                 readonly type: 'string';
                                 readonly format: 'at-uri';
@@ -3177,12 +3279,12 @@ export declare const schemaDict: {
                             readonly view: {
                                 readonly type: 'ref';
                                 readonly ref: 'lex:app.bsky.embed.external#view';
-                                readonly description: 'Hydrated view of the embed. Present only when the resolved records back the requested URL and supply enough information to populate the required `viewExternal` fields. Omitted alongside the rest of the response when no records resolved or validation failed.';
+                                readonly description: 'Legacy hydrated view of the embed, returned for Standard.site records only. Present only when validation passed and the records supply enough information to populate the required `viewExternal` fields.';
                             };
                             readonly data: {
                                 readonly type: 'union';
                                 readonly refs: ["lex:app.bsky.embed.external#viewArticle", "lex:app.bsky.embed.external#viewArticlePublication", "lex:app.bsky.embed.external#viewGallery", "lex:app.bsky.embed.external#viewLivestream"];
-                                readonly description: 'Preferred to #view. Hydrated data of the embed. Present only when the resolved records back the requested URL and supply enough information to populate the required fields. Omitted alongside the rest of the response when no records resolved or validation failed.';
+                                readonly description: 'Preferred to #view. Hydrated data of the embed. Present only when validation passed and the records supply enough information to populate the required fields.';
                             };
                             readonly associatedRefs: {
                                 readonly type: 'array';
@@ -3190,13 +3292,28 @@ export declare const schemaDict: {
                                     readonly type: 'ref';
                                     readonly ref: 'lex:com.atproto.repo.strongRef';
                                 };
-                                readonly description: "StrongRefs (URI+CID) of the Atmosphere records that backed this view, suitable for embedding into a post's external.associatedRefs.";
+                                readonly description: 'StrongRefs (URI+CID) of the Atmosphere records selected for persistence in a post, suitable for embedding into its external.associatedRefs: the canonical record, plus only the additional records the service chooses to persist for its collection. This can be a subset of the records used to render `data`, which may also draw on other hydrated records such as recommendations, subscriptions, or favorites. Present only when validation passed. Index-aligned with `associatedRecords`.';
                             };
                             readonly associatedRecords: {
                                 readonly type: 'array';
                                 readonly items: {
                                     readonly type: 'unknown';
-                                    readonly description: 'The raw record data of the Atmosphere records that backed this view. This is returned for convenience, to avoid the need for the client to separately fetch the record data for the associatedRefs. Example: the site.standard.document and site.standard.publication records that backed this view.';
+                                    readonly description: 'The raw record data of the Atmosphere records selected for persistence, index-aligned with `associatedRefs`. Returned for convenience, to avoid the client separately fetching them. Present only when validation passed.';
+                                };
+                            };
+                            readonly unverifiedAssociatedRefs: {
+                                readonly type: 'array';
+                                readonly items: {
+                                    readonly type: 'ref';
+                                    readonly ref: 'lex:com.atproto.repo.strongRef';
+                                };
+                                readonly description: 'StrongRefs (URI+CID) of the same persistence-selected Atmosphere records (the canonical record plus chosen additional records) when validation of the requested `url` failed. These must not be written to a post. Index-aligned with `unverifiedAssociatedRecords`.';
+                            };
+                            readonly unverifiedAssociatedRecords: {
+                                readonly type: 'array';
+                                readonly items: {
+                                    readonly type: 'unknown';
+                                    readonly description: 'The raw record data of the persistence-selected Atmosphere records, index-aligned with `unverifiedAssociatedRefs`. Present only when validation failed.';
                                 };
                             };
                         };
@@ -7755,7 +7872,7 @@ export declare const schemaDict: {
                                 readonly description: 'Reusable views referenced by notifications. Views shared across notifications appear once to avoid duplication. Each group contributes only its first 10 of each related view to this array. Ex: for a group containing likes in a post, we might have a large number of likeItem (e.g., 50) in a group, but only the profile views for the newest 10 items will be included here.';
                                 readonly items: {
                                     readonly type: 'union';
-                                    readonly refs: ["lex:app.bsky.actor.defs#profileViewDetailed", "lex:app.bsky.feed.defs#blockedPost", "lex:app.bsky.feed.defs#generatorView", "lex:app.bsky.feed.defs#notFoundPost", "lex:app.bsky.feed.defs#postView", "lex:app.bsky.graph.defs#starterPackView"];
+                                    readonly refs: ["lex:app.bsky.actor.defs#profileViewBasic", "lex:app.bsky.feed.defs#blockedPost", "lex:app.bsky.feed.defs#generatorView", "lex:app.bsky.feed.defs#notFoundPost", "lex:app.bsky.feed.defs#postView", "lex:app.bsky.graph.defs#starterPackViewBasic"];
                                 };
                             };
                         };
@@ -7784,7 +7901,7 @@ export declare const schemaDict: {
                     };
                     readonly kind: {
                         readonly type: 'union';
-                        readonly refs: ["lex:app.bsky.notification.getGroupedNotifications#likeGroup", "lex:app.bsky.notification.getGroupedNotifications#multiPostLikeGroup", "lex:app.bsky.notification.getGroupedNotifications#repostGroup", "lex:app.bsky.notification.getGroupedNotifications#likeViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#repostViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#followGroup", "lex:app.bsky.notification.getGroupedNotifications#subscribedPostGroup", "lex:app.bsky.notification.getGroupedNotifications#generatorLikeGroup", "lex:app.bsky.notification.getGroupedNotifications#replyNotification", "lex:app.bsky.notification.getGroupedNotifications#quoteNotification", "lex:app.bsky.notification.getGroupedNotifications#mentionNotification", "lex:app.bsky.notification.getGroupedNotifications#followBackNotification", "lex:app.bsky.notification.getGroupedNotifications#verifiedNotification", "lex:app.bsky.notification.getGroupedNotifications#unverifiedNotification", "lex:app.bsky.notification.getGroupedNotifications#starterPackJoinedNotification", "lex:app.bsky.notification.getGroupedNotifications#contactMatchNotification"];
+                        readonly refs: ["lex:app.bsky.notification.getGroupedNotifications#likeGroup", "lex:app.bsky.notification.getGroupedNotifications#multiPostLikeGroup", "lex:app.bsky.notification.getGroupedNotifications#multiPostRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#multiPostLikeViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#multiPostRepostViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#repostGroup", "lex:app.bsky.notification.getGroupedNotifications#likeViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#repostViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#followGroup", "lex:app.bsky.notification.getGroupedNotifications#subscribedPostGroup", "lex:app.bsky.notification.getGroupedNotifications#generatorLikeGroup", "lex:app.bsky.notification.getGroupedNotifications#replyNotification", "lex:app.bsky.notification.getGroupedNotifications#quoteNotification", "lex:app.bsky.notification.getGroupedNotifications#mentionNotification", "lex:app.bsky.notification.getGroupedNotifications#followBackNotification", "lex:app.bsky.notification.getGroupedNotifications#verifiedNotification", "lex:app.bsky.notification.getGroupedNotifications#unverifiedNotification", "lex:app.bsky.notification.getGroupedNotifications#starterPackJoinedNotification", "lex:app.bsky.notification.getGroupedNotifications#contactMatchNotification"];
                     };
                 };
             };
@@ -7848,6 +7965,104 @@ export declare const schemaDict: {
                     };
                 };
             };
+            readonly multiPostRepostGroup: {
+                readonly type: 'object';
+                readonly description: 'Group of reposts by the same actor of different posts.';
+                readonly required: ["actor", "items"];
+                readonly properties: {
+                    readonly actor: {
+                        readonly type: 'string';
+                        readonly format: 'did';
+                    };
+                    readonly items: {
+                        readonly type: 'array';
+                        readonly minLength: 2;
+                        readonly items: {
+                            readonly type: 'ref';
+                            readonly ref: 'lex:app.bsky.notification.getGroupedNotifications#multiPostRepostItem';
+                        };
+                    };
+                };
+            };
+            readonly multiPostRepostItem: {
+                readonly type: 'object';
+                readonly description: "One post which was reposted by the group's actor.";
+                readonly required: ["post"];
+                readonly properties: {
+                    readonly post: {
+                        readonly type: 'string';
+                        readonly format: 'at-uri';
+                    };
+                };
+            };
+            readonly multiPostLikeViaRepostGroup: {
+                readonly type: 'object';
+                readonly description: "Group of likes by the same actor on different posts via the requesting account's reposts.";
+                readonly required: ["actor", "items"];
+                readonly properties: {
+                    readonly actor: {
+                        readonly type: 'string';
+                        readonly format: 'did';
+                    };
+                    readonly items: {
+                        readonly type: 'array';
+                        readonly minLength: 2;
+                        readonly items: {
+                            readonly type: 'ref';
+                            readonly ref: 'lex:app.bsky.notification.getGroupedNotifications#multiPostLikeViaRepostItem';
+                        };
+                    };
+                };
+            };
+            readonly multiPostLikeViaRepostItem: {
+                readonly type: 'object';
+                readonly description: "One post which was liked by the group's actor via the requesting account's repost.";
+                readonly required: ["post", "viaRepost"];
+                readonly properties: {
+                    readonly post: {
+                        readonly type: 'string';
+                        readonly format: 'at-uri';
+                    };
+                    readonly viaRepost: {
+                        readonly type: 'string';
+                        readonly format: 'at-uri';
+                    };
+                };
+            };
+            readonly multiPostRepostViaRepostGroup: {
+                readonly type: 'object';
+                readonly description: "Group of reposts by the same actor of different posts via the requesting account's reposts.";
+                readonly required: ["actor", "items"];
+                readonly properties: {
+                    readonly actor: {
+                        readonly type: 'string';
+                        readonly format: 'did';
+                    };
+                    readonly items: {
+                        readonly type: 'array';
+                        readonly minLength: 2;
+                        readonly items: {
+                            readonly type: 'ref';
+                            readonly ref: 'lex:app.bsky.notification.getGroupedNotifications#multiPostRepostViaRepostItem';
+                        };
+                    };
+                };
+            };
+            readonly multiPostRepostViaRepostItem: {
+                readonly type: 'object';
+                readonly description: "One post which was reposted by the group's actor via the requesting account's repost.";
+                readonly required: ["post", "viaRepost"];
+                readonly properties: {
+                    readonly post: {
+                        readonly type: 'string';
+                        readonly format: 'at-uri';
+                    };
+                    readonly viaRepost: {
+                        readonly type: 'string';
+                        readonly format: 'at-uri';
+                    };
+                };
+            };
             readonly repostGroup: {
                 readonly type: 'object';
                 readonly description: 'Group of reposts by different actors of the same post.';
@@ -20399,10 +20614,20 @@ export declare const schemaDict: {
             };
             readonly notificationPreferences: {
                 readonly type: 'object';
-                readonly required: ["push"];
+                readonly description: 'Push notification preferences by moderation notification category. These preferences do not hide in-app inbox activity. Each category defaults to enabled.';
+                readonly required: ["reports", "account", "labels"];
                 readonly properties: {
-                    readonly push: {
+                    readonly reports: {
+                        readonly type: 'boolean';
+                        readonly description: 'Notify about outcomes of reports filed by the account (reportResolved and reportReopened).';
+                    };
+                    readonly account: {
                         readonly type: 'boolean';
+                        readonly description: 'Notify about moderation actions against the account or its content, action reversals, appeal outcomes, and standing changes. Label application and removal are controlled by labels.';
+                    };
+                    readonly labels: {
+                        readonly type: 'boolean';
+                        readonly description: 'Notify when labels are applied to or removed from the account or its content (labelApplied and labelRemoved actions).';
                     };
                 };
             };
@@ -20558,6 +20783,7 @@ export declare const schemaDict: {
         readonly defs: {
             readonly main: {
                 readonly type: 'query';
+                readonly description: 'Get moderation push notification preferences for report outcomes, account actions, and labeling. Returns all three categories, defaulting to enabled for an account without saved preferences.';
                 readonly parameters: {
                     readonly type: 'params';
                     readonly properties: {
@@ -21005,14 +21231,23 @@ export declare const schemaDict: {
         readonly defs: {
             readonly main: {
                 readonly type: 'procedure';
+                readonly description: "Update the authenticated account's moderation push notification preferences. Only provided categories are updated; omitted categories retain their values. At least one category must be provided. Returns all three preferences. These preferences do not hide in-app inbox activity.";
                 readonly input: {
                     readonly encoding: 'application/json';
                     readonly schema: {
                         readonly type: 'object';
-                        readonly required: ["push"];
                         readonly properties: {
-                            readonly push: {
+                            readonly reports: {
                                 readonly type: 'boolean';
+                                readonly description: 'Notify about outcomes of reports filed by the account.';
+                            };
+                            readonly account: {
+                                readonly type: 'boolean';
+                                readonly description: 'Notify about moderation actions against the account or its content, excluding labeling.';
+                            };
+                            readonly labels: {
+                                readonly type: 'boolean';
+                                readonly description: 'Notify about labels applied to or removed from the account or its content.';
                             };
                         };
                     };
@@ -27630,6 +27865,14 @@ export declare const schemas: ({
                     readonly type: 'ref';
                     readonly ref: 'lex:com.atproto.repo.strongRef';
                 };
+                readonly links: {
+                    readonly type: 'array';
+                    readonly description: "The profile's links, in display order. Links that were taken down or don't resolve are left out.";
+                    readonly items: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.actor.defs#profileLinkView';
+                    };
+                };
                 readonly verification: {
                     readonly type: 'ref';
                     readonly ref: 'lex:app.bsky.actor.defs#verificationState';
@@ -27701,6 +27944,43 @@ export declare const schemas: ({
                 };
             };
         };
+        readonly profileLinkView: {
+            readonly type: 'object';
+            readonly required: ["uri", "cid", "url"];
+            readonly properties: {
+                readonly uri: {
+                    readonly type: 'string';
+                    readonly format: 'at-uri';
+                    readonly description: 'The app.bsky.actor.link record, e.g. for reporting the link.';
+                };
+                readonly cid: {
+                    readonly type: 'string';
+                    readonly format: 'cid';
+                };
+                readonly url: {
+                    readonly type: 'string';
+                    readonly format: 'uri';
+                    readonly description: 'The link destination.';
+                };
+                readonly title: {
+                    readonly type: 'string';
+                    readonly maxGraphemes: 40;
+                    readonly maxLength: 320;
+                };
+                readonly icon: {
+                    readonly type: 'string';
+                    readonly format: 'uri';
+                    readonly description: "Image URL for the destination site's icon.";
+                };
+                readonly labels: {
+                    readonly type: 'array';
+                    readonly items: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:com.atproto.label.defs#label';
+                    };
+                };
+            };
+        };
         readonly profileAssociatedActivitySubscription: {
             readonly type: 'object';
             readonly required: ["allowSubscriptions"];
@@ -28427,6 +28707,48 @@ export declare const schemas: ({
             };
         };
     };
+} | {
+    readonly lexicon: 1;
+    readonly id: 'app.bsky.actor.link';
+    readonly defs: {
+        readonly main: {
+            readonly type: 'record';
+            readonly description: "A link shown on the account's profile. The profile record's links field sets which links are shown, and in what order.";
+            readonly key: 'tid';
+            readonly record: {
+                readonly type: 'object';
+                readonly required: ["url", "createdAt"];
+                readonly properties: {
+                    readonly url: {
+                        readonly type: 'string';
+                        readonly format: 'uri';
+                        readonly description: 'The link destination, an https URL.';
+                    };
+                    readonly title: {
+                        readonly type: 'string';
+                        readonly description: "Optional label for the link. Clients can fall back to the destination's domain.";
+                        readonly maxGraphemes: 40;
+                        readonly maxLength: 320;
+                    };
+                    readonly icon: {
+                        readonly type: 'blob';
+                        readonly description: "The destination site's icon, uploaded when the link is saved.";
+                        readonly accept: ["image/png", "image/jpeg", "image/webp"];
+                        readonly maxSize: 100000;
+                    };
+                    readonly createdAt: {
+                        readonly type: 'string';
+                        readonly format: 'datetime';
+                    };
+                    readonly labels: {
+                        readonly type: 'union';
+                        readonly description: 'Self-label values for this link.';
+                        readonly refs: ["lex:com.atproto.label.defs#selfLabels"];
+                    };
+                };
+            };
+        };
+    };
 } | {
     readonly lexicon: 1;
     readonly id: 'app.bsky.actor.profile';
@@ -28484,6 +28806,15 @@ export declare const schemas: ({
                         readonly type: 'ref';
                         readonly ref: 'lex:com.atproto.repo.strongRef';
                     };
+                    readonly links: {
+                        readonly type: 'array';
+                        readonly description: 'Links shown on the profile, in display order. Each ref points to an app.bsky.actor.link record in this repo.';
+                        readonly maxLength: 10;
+                        readonly items: {
+                            readonly type: 'ref';
+                            readonly ref: 'lex:com.atproto.repo.strongRef';
+                        };
+                    };
                     readonly createdAt: {
                         readonly type: 'string';
                         readonly format: 'datetime';
@@ -30515,19 +30846,24 @@ export declare const schemas: ({
     readonly defs: {
         readonly main: {
             readonly type: 'query';
-            readonly description: "Resolve one or more AT-URIs into the data needed to render an enhanced external embed. Returns `associatedRefs` (strongRefs to embed into a post's external.associatedRefs), the raw `associatedRecords`, and a hydrated `view`. The response is empty (`{}`) when no records were resolvable, or when validation determined the resolved records don't actually back the requested URL; clients should fall back to their own link-card rendering in that case and skip writing strongRefs to the post.";
+            readonly description: "Resolve one AT-URI record into the data needed to render an enhanced external embed. The records are validated against the requested `url` before any view is built. When validation passes, returns `data`, `associatedRefs` (strongRefs to embed into a post's external.associatedRefs) and the raw `associatedRecords`, plus a legacy `view` for Standard.site records only. When validation fails, only `unverifiedAssociatedRefs` and `unverifiedAssociatedRecords` are returned and no view or data is built. The response is empty (`{}`) when no record URI was usable or the record could not be resolved; clients should fall back to their own link-card rendering in that case and skip writing strongRefs to the post.";
             readonly parameters: {
                 readonly type: 'params';
-                readonly required: ["url", "uris"];
+                readonly required: ["url"];
                 readonly properties: {
                     readonly url: {
                         readonly type: 'string';
                         readonly format: 'uri';
-                        readonly description: "The canonical web URL the embed represents (typically the URL the user pasted into the composer). Used as the returned view's `uri`. May be used for validation in the future.";
+                        readonly description: "The canonical web URL the embed represents (typically the URL the user pasted into the composer). Used as the returned view's `uri`, and validated against the resolved records.";
+                    };
+                    readonly canonicalUri: {
+                        readonly type: 'string';
+                        readonly format: 'at-uri';
+                        readonly description: 'The canonical AT URI of the atproto record found on the webpage. When provided, takes precedence over `uris`, which is then ignored.';
                     };
                     readonly uris: {
                         readonly type: 'array';
-                        readonly description: 'AT-URIs of any Atmosphere records that can be resolved and used to construct #externalView views. Example: a site.standard.document and optionally its associated site.standard.publication.';
+                        readonly description: "Legacy input for Standard.site callers, ignored when `canonicalUri` is provided. A single record is selected from it: the first site.standard.document URI, otherwise the first site.standard.publication URI. Other entries are ignored; a document's publication is discovered from the document itself.";
                         readonly items: {
                             readonly type: 'string';
                             readonly format: 'at-uri';
@@ -30544,12 +30880,12 @@ export declare const schemas: ({
                         readonly view: {
                             readonly type: 'ref';
                             readonly ref: 'lex:app.bsky.embed.external#view';
-                            readonly description: 'Hydrated view of the embed. Present only when the resolved records back the requested URL and supply enough information to populate the required `viewExternal` fields. Omitted alongside the rest of the response when no records resolved or validation failed.';
+                            readonly description: 'Legacy hydrated view of the embed, returned for Standard.site records only. Present only when validation passed and the records supply enough information to populate the required `viewExternal` fields.';
                         };
                         readonly data: {
                             readonly type: 'union';
                             readonly refs: ["lex:app.bsky.embed.external#viewArticle", "lex:app.bsky.embed.external#viewArticlePublication", "lex:app.bsky.embed.external#viewGallery", "lex:app.bsky.embed.external#viewLivestream"];
-                            readonly description: 'Preferred to #view. Hydrated data of the embed. Present only when the resolved records back the requested URL and supply enough information to populate the required fields. Omitted alongside the rest of the response when no records resolved or validation failed.';
+                            readonly description: 'Preferred to #view. Hydrated data of the embed. Present only when validation passed and the records supply enough information to populate the required fields.';
                         };
                         readonly associatedRefs: {
                             readonly type: 'array';
@@ -30557,13 +30893,28 @@ export declare const schemas: ({
                                 readonly type: 'ref';
                                 readonly ref: 'lex:com.atproto.repo.strongRef';
                             };
-                            readonly description: "StrongRefs (URI+CID) of the Atmosphere records that backed this view, suitable for embedding into a post's external.associatedRefs.";
+                            readonly description: 'StrongRefs (URI+CID) of the Atmosphere records selected for persistence in a post, suitable for embedding into its external.associatedRefs: the canonical record, plus only the additional records the service chooses to persist for its collection. This can be a subset of the records used to render `data`, which may also draw on other hydrated records such as recommendations, subscriptions, or favorites. Present only when validation passed. Index-aligned with `associatedRecords`.';
                         };
                         readonly associatedRecords: {
                             readonly type: 'array';
                             readonly items: {
                                 readonly type: 'unknown';
-                                readonly description: 'The raw record data of the Atmosphere records that backed this view. This is returned for convenience, to avoid the need for the client to separately fetch the record data for the associatedRefs. Example: the site.standard.document and site.standard.publication records that backed this view.';
+                                readonly description: 'The raw record data of the Atmosphere records selected for persistence, index-aligned with `associatedRefs`. Returned for convenience, to avoid the client separately fetching them. Present only when validation passed.';
+                            };
+                        };
+                        readonly unverifiedAssociatedRefs: {
+                            readonly type: 'array';
+                            readonly items: {
+                                readonly type: 'ref';
+                                readonly ref: 'lex:com.atproto.repo.strongRef';
+                            };
+                            readonly description: 'StrongRefs (URI+CID) of the same persistence-selected Atmosphere records (the canonical record plus chosen additional records) when validation of the requested `url` failed. These must not be written to a post. Index-aligned with `unverifiedAssociatedRecords`.';
+                        };
+                        readonly unverifiedAssociatedRecords: {
+                            readonly type: 'array';
+                            readonly items: {
+                                readonly type: 'unknown';
+                                readonly description: 'The raw record data of the persistence-selected Atmosphere records, index-aligned with `unverifiedAssociatedRefs`. Present only when validation failed.';
                             };
                         };
                     };
@@ -35053,7 +35404,7 @@ export declare const schemas: ({
                             readonly description: 'Reusable views referenced by notifications. Views shared across notifications appear once to avoid duplication. Each group contributes only its first 10 of each related view to this array. Ex: for a group containing likes in a post, we might have a large number of likeItem (e.g., 50) in a group, but only the profile views for the newest 10 items will be included here.';
                             readonly items: {
                                 readonly type: 'union';
-                                readonly refs: ["lex:app.bsky.actor.defs#profileViewDetailed", "lex:app.bsky.feed.defs#blockedPost", "lex:app.bsky.feed.defs#generatorView", "lex:app.bsky.feed.defs#notFoundPost", "lex:app.bsky.feed.defs#postView", "lex:app.bsky.graph.defs#starterPackView"];
+                                readonly refs: ["lex:app.bsky.actor.defs#profileViewBasic", "lex:app.bsky.feed.defs#blockedPost", "lex:app.bsky.feed.defs#generatorView", "lex:app.bsky.feed.defs#notFoundPost", "lex:app.bsky.feed.defs#postView", "lex:app.bsky.graph.defs#starterPackViewBasic"];
                             };
                         };
                     };
@@ -35082,7 +35433,7 @@ export declare const schemas: ({
                 };
                 readonly kind: {
                     readonly type: 'union';
-                    readonly refs: ["lex:app.bsky.notification.getGroupedNotifications#likeGroup", "lex:app.bsky.notification.getGroupedNotifications#multiPostLikeGroup", "lex:app.bsky.notification.getGroupedNotifications#repostGroup", "lex:app.bsky.notification.getGroupedNotifications#likeViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#repostViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#followGroup", "lex:app.bsky.notification.getGroupedNotifications#subscribedPostGroup", "lex:app.bsky.notification.getGroupedNotifications#generatorLikeGroup", "lex:app.bsky.notification.getGroupedNotifications#replyNotification", "lex:app.bsky.notification.getGroupedNotifications#quoteNotification", "lex:app.bsky.notification.getGroupedNotifications#mentionNotification", "lex:app.bsky.notification.getGroupedNotifications#followBackNotification", "lex:app.bsky.notification.getGroupedNotifications#verifiedNotification", "lex:app.bsky.notification.getGroupedNotifications#unverifiedNotification", "lex:app.bsky.notification.getGroupedNotifications#starterPackJoinedNotification", "lex:app.bsky.notification.getGroupedNotifications#contactMatchNotification"];
+                    readonly refs: ["lex:app.bsky.notification.getGroupedNotifications#likeGroup", "lex:app.bsky.notification.getGroupedNotifications#multiPostLikeGroup", "lex:app.bsky.notification.getGroupedNotifications#multiPostRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#multiPostLikeViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#multiPostRepostViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#repostGroup", "lex:app.bsky.notification.getGroupedNotifications#likeViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#repostViaRepostGroup", "lex:app.bsky.notification.getGroupedNotifications#followGroup", "lex:app.bsky.notification.getGroupedNotifications#subscribedPostGroup", "lex:app.bsky.notification.getGroupedNotifications#generatorLikeGroup", "lex:app.bsky.notification.getGroupedNotifications#replyNotification", "lex:app.bsky.notification.getGroupedNotifications#quoteNotification", "lex:app.bsky.notification.getGroupedNotifications#mentionNotification", "lex:app.bsky.notification.getGroupedNotifications#followBackNotification", "lex:app.bsky.notification.getGroupedNotifications#verifiedNotification", "lex:app.bsky.notification.getGroupedNotifications#unverifiedNotification", "lex:app.bsky.notification.getGroupedNotifications#starterPackJoinedNotification", "lex:app.bsky.notification.getGroupedNotifications#contactMatchNotification"];
                 };
             };
         };
@@ -35146,6 +35497,104 @@ export declare const schemas: ({
                 };
             };
         };
+        readonly multiPostRepostGroup: {
+            readonly type: 'object';
+            readonly description: 'Group of reposts by the same actor of different posts.';
+            readonly required: ["actor", "items"];
+            readonly properties: {
+                readonly actor: {
+                    readonly type: 'string';
+                    readonly format: 'did';
+                };
+                readonly items: {
+                    readonly type: 'array';
+                    readonly minLength: 2;
+                    readonly items: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.notification.getGroupedNotifications#multiPostRepostItem';
+                    };
+                };
+            };
+        };
+        readonly multiPostRepostItem: {
+            readonly type: 'object';
+            readonly description: "One post which was reposted by the group's actor.";
+            readonly required: ["post"];
+            readonly properties: {
+                readonly post: {
+                    readonly type: 'string';
+                    readonly format: 'at-uri';
+                };
+            };
+        };
+        readonly multiPostLikeViaRepostGroup: {
+            readonly type: 'object';
+            readonly description: "Group of likes by the same actor on different posts via the requesting account's reposts.";
+            readonly required: ["actor", "items"];
+            readonly properties: {
+                readonly actor: {
+                    readonly type: 'string';
+                    readonly format: 'did';
+                };
+                readonly items: {
+                    readonly type: 'array';
+                    readonly minLength: 2;
+                    readonly items: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.notification.getGroupedNotifications#multiPostLikeViaRepostItem';
+                    };
+                };
+            };
+        };
+        readonly multiPostLikeViaRepostItem: {
+            readonly type: 'object';
+            readonly description: "One post which was liked by the group's actor via the requesting account's repost.";
+            readonly required: ["post", "viaRepost"];
+            readonly properties: {
+                readonly post: {
+                    readonly type: 'string';
+                    readonly format: 'at-uri';
+                };
+                readonly viaRepost: {
+                    readonly type: 'string';
+                    readonly format: 'at-uri';
+                };
+            };
+        };
+        readonly multiPostRepostViaRepostGroup: {
+            readonly type: 'object';
+            readonly description: "Group of reposts by the same actor of different posts via the requesting account's reposts.";
+            readonly required: ["actor", "items"];
+            readonly properties: {
+                readonly actor: {
+                    readonly type: 'string';
+                    readonly format: 'did';
+                };
+                readonly items: {
+                    readonly type: 'array';
+                    readonly minLength: 2;
+                    readonly items: {
+                        readonly type: 'ref';
+                        readonly ref: 'lex:app.bsky.notification.getGroupedNotifications#multiPostRepostViaRepostItem';
+                    };
+                };
+            };
+        };
+        readonly multiPostRepostViaRepostItem: {
+            readonly type: 'object';
+            readonly description: "One post which was reposted by the group's actor via the requesting account's repost.";
+            readonly required: ["post", "viaRepost"];
+            readonly properties: {
+                readonly post: {
+                    readonly type: 'string';
+                    readonly format: 'at-uri';
+                };
+                readonly viaRepost: {
+                    readonly type: 'string';
+                    readonly format: 'at-uri';
+                };
+            };
+        };
         readonly repostGroup: {
             readonly type: 'object';
             readonly description: 'Group of reposts by different actors of the same post.';
@@ -47484,10 +47933,20 @@ export declare const schemas: ({
         };
         readonly notificationPreferences: {
             readonly type: 'object';
-            readonly required: ["push"];
+            readonly description: 'Push notification preferences by moderation notification category. These preferences do not hide in-app inbox activity. Each category defaults to enabled.';
+            readonly required: ["reports", "account", "labels"];
             readonly properties: {
-                readonly push: {
+                readonly reports: {
+                    readonly type: 'boolean';
+                    readonly description: 'Notify about outcomes of reports filed by the account (reportResolved and reportReopened).';
+                };
+                readonly account: {
+                    readonly type: 'boolean';
+                    readonly description: 'Notify about moderation actions against the account or its content, action reversals, appeal outcomes, and standing changes. Label application and removal are controlled by labels.';
+                };
+                readonly labels: {
                     readonly type: 'boolean';
+                    readonly description: 'Notify when labels are applied to or removed from the account or its content (labelApplied and labelRemoved actions).';
                 };
             };
         };
@@ -47640,6 +48099,7 @@ export declare const schemas: ({
     readonly defs: {
         readonly main: {
             readonly type: 'query';
+            readonly description: 'Get moderation push notification preferences for report outcomes, account actions, and labeling. Returns all three categories, defaulting to enabled for an account without saved preferences.';
             readonly parameters: {
                 readonly type: 'params';
                 readonly properties: {
@@ -48081,14 +48541,23 @@ export declare const schemas: ({
     readonly defs: {
         readonly main: {
             readonly type: 'procedure';
+            readonly description: "Update the authenticated account's moderation push notification preferences. Only provided categories are updated; omitted categories retain their values. At least one category must be provided. Returns all three preferences. These preferences do not hide in-app inbox activity.";
             readonly input: {
                 readonly encoding: 'application/json';
                 readonly schema: {
                     readonly type: 'object';
-                    readonly required: ["push"];
                     readonly properties: {
-                        readonly push: {
+                        readonly reports: {
+                            readonly type: 'boolean';
+                            readonly description: 'Notify about outcomes of reports filed by the account.';
+                        };
+                        readonly account: {
+                            readonly type: 'boolean';
+                            readonly description: 'Notify about moderation actions against the account or its content, excluding labeling.';
+                        };
+                        readonly labels: {
                             readonly type: 'boolean';
+                            readonly description: 'Notify about labels applied to or removed from the account or its content.';
                         };
                     };
                 };
@@ -54421,6 +54890,7 @@ export declare const ids: {
     readonly AppBskyActorGetProfile: 'app.bsky.actor.getProfile';
     readonly AppBskyActorGetProfiles: 'app.bsky.actor.getProfiles';
     readonly AppBskyActorGetSuggestions: 'app.bsky.actor.getSuggestions';
+    readonly AppBskyActorLink: 'app.bsky.actor.link';
     readonly AppBskyActorProfile: 'app.bsky.actor.profile';
     readonly AppBskyActorPutPreferences: 'app.bsky.actor.putPreferences';
     readonly AppBskyActorSearchActors: 'app.bsky.actor.searchActors';