@atproto/api 0.20.44 → 0.22.0

package/dist/client/lexicons.js

@@ -3475,6 +3475,14 @@ export const schemaDict = {
                         type: 'ref',
                         ref: 'lex:app.bsky.feed.defs#replyRef',
                     },
+                    opThreadPostIndex: {
+                        type: 'integer',
+                        description: 'The 1-indexed position of this post within the contiguous OP thread. Only present when this post is part of the OP thread.',
+                    },
+                    opThreadPostCount: {
+                        type: 'integer',
+                        description: 'The total number of posts in the contiguous OP thread that this post belongs to. Only present when this post is part of the OP thread.',
+                    },
                     reason: {
                         type: 'union',
                         refs: [
@@ -4611,6 +4619,11 @@ export const schemaDict = {
                         cursor: {
                             type: 'string',
                         },
+                        sort: {
+                            type: 'string',
+                            knownValues: ['latest', 'top'],
+                            description: "Ordering of results. 'latest' (default when unset) is newest first; 'top' orders quotes by their like count.",
+                        },
                     },
                 },
                 output: {
@@ -7611,6 +7624,7 @@ export const schemaDict = {
                     properties: {
                         priority: {
                             type: 'boolean',
+                            description: 'Deprecated: this parameter is ignored.',
                         },
                         seenAt: {
                             type: 'string',
@@ -7702,6 +7716,7 @@ export const schemaDict = {
                         },
                         priority: {
                             type: 'boolean',
+                            description: 'Deprecated: this parameter is ignored.',
                         },
                         cursor: {
                             type: 'string',
@@ -7709,6 +7724,7 @@ export const schemaDict = {
                         seenAt: {
                             type: 'string',
                             format: 'datetime',
+                            description: 'Deprecated: this parameter is unsupported and will cause an error.',
                         },
                     },
                 },
@@ -7730,6 +7746,7 @@ export const schemaDict = {
                             },
                             priority: {
                                 type: 'boolean',
+                                description: 'Deprecated: this field is no longer populated.',
                             },
                             seenAt: {
                                 type: 'string',
@@ -20036,6 +20053,270 @@ export const schemaDict = {
             },
         },
     },
+    ToolsOzoneInboxAppealActionedSubject: {
+        lexicon: 1,
+        id: 'tools.ozone.inbox.appealActionedSubject',
+        defs: {
+            main: {
+                type: 'procedure',
+                description: "Appeal a moderation action affecting the user's account or content.",
+                input: {
+                    encoding: 'application/json',
+                    schema: {
+                        type: 'object',
+                        required: ['subject'],
+                        properties: {
+                            action: {
+                                type: 'union',
+                                refs: [
+                                    'lex:tools.ozone.inbox.appealActionedSubject#actionRef',
+                                    'lex:tools.ozone.inbox.appealActionedSubject#labelRef',
+                                    'lex:tools.ozone.inbox.appealActionedSubject#takedownRef',
+                                ],
+                                closed: true,
+                                description: 'Moderation action being appealed.',
+                            },
+                            subject: {
+                                type: 'union',
+                                refs: [
+                                    'lex:com.atproto.admin.defs#repoRef',
+                                    'lex:com.atproto.repo.strongRef',
+                                ],
+                                description: 'Subject being appealed.',
+                            },
+                            reason: {
+                                type: 'string',
+                                maxGraphemes: 2000,
+                                maxLength: 20000,
+                                description: 'Optional explanation supplied by the user.',
+                            },
+                            modTool: {
+                                type: 'ref',
+                                ref: 'lex:com.atproto.moderation.createReport#modTool',
+                            },
+                        },
+                    },
+                },
+                output: {
+                    encoding: 'application/json',
+                    schema: {
+                        type: 'ref',
+                        ref: 'lex:tools.ozone.inbox.defs#subjectView',
+                    },
+                },
+                errors: [
+                    {
+                        name: 'InvalidAppealSubject',
+                        description: 'Invalid appeal subject input.',
+                    },
+                    {
+                        name: 'AlreadyAppealed',
+                        description: 'An active appeal already exists for this action.',
+                    },
+                    {
+                        name: 'NotAppealable',
+                        description: 'The subject cannot be appealed.',
+                    },
+                    {
+                        name: 'AppealWindowExpired',
+                        description: 'The appeal window for this action has closed.',
+                    },
+                ],
+            },
+            actionRef: {
+                type: 'object',
+                required: ['id'],
+                properties: {
+                    id: {
+                        type: 'integer',
+                        minimum: 1,
+                        description: 'ID of the moderation action being appealed, available via actions in mod inbox.',
+                    },
+                },
+            },
+            labelRef: {
+                type: 'object',
+                required: ['val'],
+                properties: {
+                    val: {
+                        type: 'string',
+                        minLength: 1,
+                        description: 'Label being appealed.',
+                    },
+                },
+            },
+            takedownRef: {
+                type: 'object',
+                properties: {},
+            },
+        },
+    },
+    ToolsOzoneInboxDefs: {
+        lexicon: 1,
+        id: 'tools.ozone.inbox.defs',
+        defs: {
+            subjectView: {
+                type: 'object',
+                description: 'A subject belonging to the viewer that has moderation actions against it.',
+                required: ['src', 'subject', 'enforcement', 'createdAt', 'updatedAt'],
+                properties: {
+                    src: {
+                        type: 'string',
+                        format: 'did',
+                        description: 'DID of the moderation service that took the actions.',
+                    },
+                    subject: {
+                        type: 'union',
+                        refs: [
+                            'lex:com.atproto.admin.defs#repoRef',
+                            'lex:com.atproto.repo.strongRef',
+                        ],
+                    },
+                    enforcement: {
+                        type: 'ref',
+                        ref: 'lex:tools.ozone.inbox.defs#enforcementView',
+                    },
+                    appeal: {
+                        type: 'ref',
+                        ref: 'lex:tools.ozone.inbox.defs#appealView',
+                    },
+                    availableActions: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                            knownValues: ['appeal'],
+                        },
+                    },
+                    latestAction: {
+                        type: 'ref',
+                        ref: 'lex:tools.ozone.inbox.defs#actionView',
+                    },
+                    actionCount: {
+                        type: 'integer',
+                    },
+                    createdAt: {
+                        type: 'string',
+                        format: 'datetime',
+                    },
+                    updatedAt: {
+                        type: 'string',
+                        format: 'datetime',
+                    },
+                },
+            },
+            enforcementView: {
+                type: 'object',
+                description: 'The current enforcement state of a subject.',
+                required: ['state'],
+                properties: {
+                    state: {
+                        type: 'string',
+                        knownValues: [
+                            'none',
+                            'labeled',
+                            'removed',
+                            'suspended',
+                            'takendown',
+                        ],
+                    },
+                    scope: {
+                        type: 'string',
+                        knownValues: ['network', 'app', 'labelOnly'],
+                    },
+                    expiresAt: {
+                        type: 'string',
+                        format: 'datetime',
+                    },
+                    labels: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                        },
+                        description: 'Active label values on the subject, excluding negated and expired labels.',
+                    },
+                },
+            },
+            appealView: {
+                type: 'object',
+                description: "The state of the viewer's appeal against the actions on a subject.",
+                required: ['state'],
+                properties: {
+                    state: {
+                        type: 'string',
+                        knownValues: [
+                            'none',
+                            'pending',
+                            'resolved',
+                            'superseded',
+                            'expired',
+                        ],
+                    },
+                    appealedAt: {
+                        type: 'string',
+                        format: 'datetime',
+                    },
+                    resolvedAt: {
+                        type: 'string',
+                        format: 'datetime',
+                        description: "When the appeal's report was closed.",
+                    },
+                    note: {
+                        type: 'string',
+                        description: 'Moderator explanation, from the publicNote on the closing activity. Absent if none was written.',
+                    },
+                    appealableUntil: {
+                        type: 'string',
+                        format: 'datetime',
+                    },
+                },
+            },
+            actionView: {
+                type: 'object',
+                description: 'A single moderation action taken against a subject.',
+                required: ['id', 'type', 'createdAt'],
+                properties: {
+                    id: {
+                        type: 'integer',
+                        description: 'Action ID (moderation event ID).',
+                    },
+                    type: {
+                        type: 'string',
+                        description: 'Public action type.',
+                    },
+                    scope: {
+                        type: 'string',
+                        knownValues: ['network', 'app', 'labelOnly'],
+                    },
+                    createdAt: {
+                        type: 'string',
+                        format: 'datetime',
+                    },
+                    reversedAt: {
+                        type: 'string',
+                        format: 'datetime',
+                    },
+                    expiresAt: {
+                        type: 'string',
+                        format: 'datetime',
+                    },
+                    labels: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                        },
+                        description: 'Label values, for labelApplied/labelRemoved.',
+                    },
+                    policies: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                        },
+                        description: 'Policies that were applied in this action.',
+                    },
+                },
+            },
+        },
+    },
     ToolsOzoneModerationCancelScheduledActions: {
         lexicon: 1,
         id: 'tools.ozone.moderation.cancelScheduledActions',
@@ -22891,6 +23172,13 @@ export const schemaDict = {
                                 },
                                 description: 'Policy keys to recommend when actioning reports in this queue',
                             },
+                            recommendedLabels: {
+                                type: 'array',
+                                items: {
+                                    type: 'string',
+                                },
+                                description: 'Labels to recommend for this queue and use as fallback appeal routing mappings',
+                            },
                         },
                     },
                 },
@@ -22975,6 +23263,13 @@ export const schemaDict = {
                         },
                         description: 'Policy keys recommended when actioning reports in this queue',
                     },
+                    recommendedLabels: {
+                        type: 'array',
+                        items: {
+                            type: 'string',
+                        },
+                        description: 'Labels recommended for this queue and used as a fallback when routing label appeals',
+                    },
                     createdBy: {
                         type: 'string',
                         format: 'did',
@@ -23360,6 +23655,13 @@ export const schemaDict = {
                                 },
                                 description: 'Policy keys to recommend when actioning reports in this queue',
                             },
+                            recommendedLabels: {
+                                type: 'array',
+                                items: {
+                                    type: 'string',
+                                },
+                                description: 'Labels to recommend for this queue and use as fallback appeal routing mappings',
+                            },
                         },
                     },
                 },
@@ -23381,6 +23683,10 @@ export const schemaDict = {
                         name: 'InvalidRecommendedPolicies',
                         description: 'One or more recommended policy keys do not exist in the configured policy list',
                     },
+                    {
+                        name: 'ConflictingQueue',
+                        description: 'The queue configuration conflicts with an existing queue',
+                    },
                 ],
             },
         },
@@ -23878,7 +24184,7 @@ export const schemaDict = {
                         items: {
                             type: 'integer',
                         },
-                        description: 'Array of moderation event IDs representing actions taken on this report (sorted DESC, most recent first)',
+                        description: 'Array of moderation event IDs representing actions taken on this report, in append order (most recently linked event last)',
                     },
                     actions: {
                         type: 'array',
@@ -24060,25 +24366,65 @@ export const schemaDict = {
                         type: 'integer',
                         description: 'Number of reports currently not closed.',
                     },
+                    closedCount: {
+                        type: 'integer',
+                        description: 'Number of close transitions.',
+                    },
                     actionedCount: {
                         type: 'integer',
-                        description: 'Number of reports closed today.',
+                        description: 'Number of closures whose last report action is label, tag, or takedown.',
+                    },
+                    acknowledgedCount: {
+                        type: 'integer',
+                        description: 'Number of closures whose last report action is not label, tag, or takedown.',
                     },
                     escalatedCount: {
                         type: 'integer',
-                        description: 'Number of reports escalated today.',
+                        description: 'Number of reports escalated.',
                     },
                     inboundCount: {
                         type: 'integer',
-                        description: 'Reports received today.',
+                        description: 'Reports received.',
+                    },
+                    labelActionCount: {
+                        type: 'integer',
+                        description: 'Closures whose last report action is a label event.',
+                    },
+                    tagActionCount: {
+                        type: 'integer',
+                        description: 'Closures whose last report action is a tag event.',
+                    },
+                    takedownActionCount: {
+                        type: 'integer',
+                        description: 'Closures whose last report action is a takedown event.',
+                    },
+                    ahtDurationSec: {
+                        type: 'integer',
+                        description: 'Sum of report assignment-to-close seconds.',
+                    },
+                    ahtSampleCount: {
+                        type: 'integer',
+                        description: 'Number of assigned closed-report samples in ahtDurationSec.',
+                    },
+                    resolutionDurationSec: {
+                        type: 'integer',
+                        description: 'Sum of report creation-to-close seconds.',
+                    },
+                    resolutionSampleCount: {
+                        type: 'integer',
+                        description: 'Number of closed-report samples in resolutionDurationSec.',
                     },
                     actionRate: {
                         type: 'integer',
-                        description: 'Percentage of reports actioned (actionedCount / inboundCount * 100), rounded to nearest integer.',
+                        description: 'Percentage of closures actioned (actionedCount / closedCount * 100), rounded to nearest integer.',
                     },
                     avgHandlingTimeSec: {
                         type: 'integer',
-                        description: 'Average time in seconds from report creation (or moderator assignment) to close.',
+                        description: 'Average handling time in seconds from report assignment to close.',
+                    },
+                    avgResolutionTimeSec: {
+                        type: 'integer',
+                        description: 'Average resolution time in seconds from report creation to close.',
                     },
                     lastUpdated: {
                         type: 'string',
@@ -24105,9 +24451,17 @@ export const schemaDict = {
                         type: 'integer',
                         description: 'Number of reports not closed at time of computation.',
                     },
+                    closedCount: {
+                        type: 'integer',
+                        description: 'Number of close transitions during this day.',
+                    },
                     actionedCount: {
                         type: 'integer',
-                        description: 'Number of reports closed during this day.',
+                        description: 'Number of closures whose last report action is label, tag, or takedown during this day.',
+                    },
+                    acknowledgedCount: {
+                        type: 'integer',
+                        description: 'Number of closures whose last report action is not label, tag, or takedown during this day.',
                     },
                     escalatedCount: {
                         type: 'integer',
@@ -24117,13 +24471,45 @@ export const schemaDict = {
                         type: 'integer',
                         description: 'Reports received during this day.',
                     },
+                    labelActionCount: {
+                        type: 'integer',
+                        description: 'Closures whose last report action is a label event during this day.',
+                    },
+                    tagActionCount: {
+                        type: 'integer',
+                        description: 'Closures whose last report action is a tag event during this day.',
+                    },
+                    takedownActionCount: {
+                        type: 'integer',
+                        description: 'Closures whose last report action is a takedown event during this day.',
+                    },
+                    ahtDurationSec: {
+                        type: 'integer',
+                        description: "Sum of report assignment-to-close seconds for this day's samples.",
+                    },
+                    ahtSampleCount: {
+                        type: 'integer',
+                        description: 'Number of assigned closed-report samples in ahtDurationSec.',
+                    },
+                    resolutionDurationSec: {
+                        type: 'integer',
+                        description: "Sum of report creation-to-close seconds for this day's samples.",
+                    },
+                    resolutionSampleCount: {
+                        type: 'integer',
+                        description: 'Number of closed-report samples in resolutionDurationSec.',
+                    },
                     actionRate: {
                         type: 'integer',
-                        description: 'Percentage of reports actioned (actionedCount / inboundCount * 100), rounded to nearest integer.',
+                        description: 'Percentage of closures actioned (actionedCount / closedCount * 100), rounded to nearest integer.',
                     },
                     avgHandlingTimeSec: {
                         type: 'integer',
-                        description: 'Average time in seconds from report creation (or moderator assignment) to close.',
+                        description: 'Average handling time in seconds from report assignment to close.',
+                    },
+                    avgResolutionTimeSec: {
+                        type: 'integer',
+                        description: 'Average resolution time in seconds from report creation to close.',
                     },
                 },
             },
@@ -24337,7 +24723,7 @@ export const schemaDict = {
         defs: {
             main: {
                 type: 'query',
-                description: 'Get live report statistics from the past 24 hours. Filter by queue, moderator, or report type. Omit all parameters for aggregate stats.',
+                description: 'Get live report statistics for the current UTC calendar day. Filter by queue, moderator, or report type. Omit all parameters for aggregate stats.',
                 parameters: {
                     type: 'params',
                     properties: {
@@ -24715,7 +25101,7 @@ export const schemaDict = {
         defs: {
             main: {
                 type: 'procedure',
-                description: 'Recompute report statistics for a date range. Useful for backfilling after failures or data corrections.',
+                description: 'Recompute report statistics for a date range.',
                 input: {
                     encoding: 'application/json',
                     schema: {
@@ -26877,6 +27263,8 @@ export const ids = {
     ToolsOzoneCommunicationListTemplates: 'tools.ozone.communication.listTemplates',
     ToolsOzoneCommunicationUpdateTemplate: 'tools.ozone.communication.updateTemplate',
     ToolsOzoneHostingGetAccountHistory: 'tools.ozone.hosting.getAccountHistory',
+    ToolsOzoneInboxAppealActionedSubject: 'tools.ozone.inbox.appealActionedSubject',
+    ToolsOzoneInboxDefs: 'tools.ozone.inbox.defs',
     ToolsOzoneModerationCancelScheduledActions: 'tools.ozone.moderation.cancelScheduledActions',
     ToolsOzoneModerationDefs: 'tools.ozone.moderation.defs',
     ToolsOzoneModerationEmitEvent: 'tools.ozone.moderation.emitEvent',