@oxy.so/contracts 4.21.0 → 4.22.0

package/dist/types/contentClaims.d.ts

@@ -0,0 +1,383 @@
+/**
+ * Content claims (ADR 0043 D10): the public "Report content / rights claim"
+ * intake, `POST /content-claims`, and the staff review of a claim.
+ *
+ * {@link contentClaimSubmissionSchema} is the request body the API parses and
+ * the Oxy website validates its form with before posting, so the form cannot
+ * accept what the API would answer 400 to. Every validation message is a
+ * stable KEY under `contentClaim.errors.*` (filled with
+ * {@link CONTENT_CLAIM_LIMITS} by whoever shows it), never English: the website
+ * translates the key, and the API answers its own English sentence for it in
+ * `fields`.
+ */
+import { z } from 'zod';
+import { type ClaimantRelationship, type ContentClaimKind, type ContentClaimState } from './client/contentClaims';
+export { CLAIMANT_RELATIONSHIPS, CLOSED_CONTENT_CLAIM_STATES, CONTENT_CLAIM_COUNTER_NOTICE_LIMITS, CONTENT_CLAIM_ERROR_CODES, CONTENT_CLAIM_KINDS, CONTENT_CLAIM_LIMITS, CONTENT_CLAIM_REFERENCE_PATTERN, CONTENT_CLAIM_STATES, COUNTER_NOTICE_STATEMENT_VERSION, COUNTER_NOTICE_STATEMENTS, ERASURE_REQUEST_DEADLINE_DAYS, OPEN_CONTENT_CLAIM_STATES, isErasureRequest, isRightsClaim, } from './client/contentClaims';
+export type { ClaimantRelationship, ContentClaimErrorCode, ContentClaimKind, ContentClaimState, } from './client/contentClaims';
+/** Every key a submission's validation can produce, under `contentClaim.errors.*`. */
+export declare const CONTENT_CLAIM_VALIDATION_KEYS: readonly ["contentClaim.errors.kind", "contentClaim.errors.contentUrlsRequired", "contentClaim.errors.contentUrlsTooMany", "contentClaim.errors.contentUrlInvalid", "contentClaim.errors.descriptionShort", "contentClaim.errors.descriptionLong", "contentClaim.errors.originalWorkUrl", "contentClaim.errors.name", "contentClaim.errors.email", "contentClaim.errors.organization", "contentClaim.errors.relationship", "contentClaim.errors.goodFaith", "contentClaim.errors.accurate", "contentClaim.errors.signature"];
+export type ContentClaimValidationKey = (typeof CONTENT_CLAIM_VALIDATION_KEYS)[number];
+/**
+ * `POST /content-claims` — a claim, as the claimant sends it. Strict: an
+ * unknown key is refused rather than dropped.
+ */
+export declare const contentClaimSubmissionSchema: z.ZodObject<{
+    kind: z.ZodEnum<["copyright", "trademark", "privacy", "illegal_content", "other"]>;
+    contentUrls: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+    description: z.ZodString;
+    originalWorkUrl: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    claimant: z.ZodObject<{
+        name: z.ZodString;
+        email: z.ZodString;
+        organization: z.ZodOptional<z.ZodString>;
+        relationship: z.ZodEnum<["rights_holder", "authorized_agent", "affected_person", "other"]>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        email: string;
+        relationship: "other" | "rights_holder" | "authorized_agent" | "affected_person";
+        organization?: string | undefined;
+    }, {
+        name: string;
+        email: string;
+        relationship: "other" | "rights_holder" | "authorized_agent" | "affected_person";
+        organization?: string | undefined;
+    }>;
+    statements: z.ZodObject<{
+        goodFaith: z.ZodLiteral<true>;
+        accurate: z.ZodLiteral<true>;
+    }, "strict", z.ZodTypeAny, {
+        goodFaith: true;
+        accurate: true;
+    }, {
+        goodFaith: true;
+        accurate: true;
+    }>;
+    signature: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    kind: "other" | "copyright" | "trademark" | "privacy" | "illegal_content";
+    description: string;
+    signature: string;
+    contentUrls: string[];
+    claimant: {
+        name: string;
+        email: string;
+        relationship: "other" | "rights_holder" | "authorized_agent" | "affected_person";
+        organization?: string | undefined;
+    };
+    statements: {
+        goodFaith: true;
+        accurate: true;
+    };
+    originalWorkUrl?: string | undefined;
+}, {
+    kind: "other" | "copyright" | "trademark" | "privacy" | "illegal_content";
+    description: string;
+    signature: string;
+    contentUrls: string[];
+    claimant: {
+        name: string;
+        email: string;
+        relationship: "other" | "rights_holder" | "authorized_agent" | "affected_person";
+        organization?: string | undefined;
+    };
+    statements: {
+        goodFaith: true;
+        accurate: true;
+    };
+    originalWorkUrl?: string | undefined;
+}>;
+export type ContentClaimSubmission = z.infer<typeof contentClaimSubmissionSchema>;
+/** `201` to a submission: the claim's id and the reference the claimant quotes. */
+export interface ContentClaimSubmissionResponse {
+    id: string;
+    /** e.g. `OXY-7K3M-9Q2D`: what the claimant quotes when writing about the claim. */
+    reference: string;
+}
+/**
+ * `400` to a submission: `error` is a sentence for the person, and `fields`
+ * maps a body path (`claimant.email`, `contentUrls.3`) to a sentence about it.
+ */
+export interface ContentClaimSubmissionError {
+    error: string;
+    code: string;
+    fields?: Record<string, string>;
+}
+/** How a target's URL was understood. */
+export declare const CONTENT_CLAIM_TARGET_RESOLUTIONS: readonly ["file", "unresolved"];
+export type ContentClaimTargetResolution = (typeof CONTENT_CLAIM_TARGET_RESOLUTIONS)[number];
+/** Who added a target: the claimant's URL, or staff attaching a file by id. */
+export declare const CONTENT_CLAIM_TARGET_SOURCES: readonly ["claimant", "staff"];
+export type ContentClaimTargetSource = (typeof CONTENT_CLAIM_TARGET_SOURCES)[number];
+/** What the audit trail records. */
+export declare const CONTENT_CLAIM_EVENT_ACTIONS: readonly ["submitted", "review_started", "targets_attached", "targets_blocked", "rejected", "counter_notice_recorded", "counter_notice_submitted", "reinstated", "upheld", "note_added"];
+export type ContentClaimEventAction = (typeof CONTENT_CLAIM_EVENT_ACTIONS)[number];
+/** One target as staff see it. */
+export interface ContentClaimTargetView {
+    id: string;
+    source: ContentClaimTargetSource;
+    url: string | null;
+    resolution: ContentClaimTargetResolution;
+    /** The file this target names, when it names one (null after the file's owner was deleted). */
+    fileId: string | null;
+    sha256: string | null;
+    /** The file as it stands now, or null when there is no such row any more. */
+    file: {
+        id: string;
+        status: 'active' | 'trash' | 'blocked' | 'deleted';
+        visibility: 'private' | 'public' | 'unlisted';
+        mime: string;
+        size: number;
+        ownerKind: 'account' | 'application' | 'platform';
+        ownerUserId: string | null;
+        ownerApplicationId: string | null;
+    } | null;
+    blockedAt: string | null;
+    unblockedAt: string | null;
+    createdAt: string;
+}
+/** One audit entry. */
+export interface ContentClaimEventView {
+    id: string;
+    action: ContentClaimEventAction;
+    /** The staff member (or the signed-in claimant, for `submitted`); null when anonymous or deleted. */
+    actorUserId: string | null;
+    fromState: ContentClaimState | null;
+    toState: ContentClaimState | null;
+    /** Free text staff wrote (a rejection reason, a counter-notice summary, a note). */
+    note: string | null;
+    details: Record<string, unknown>;
+    createdAt: string;
+}
+/** A row of the queue. */
+export interface ContentClaimSummaryView {
+    id: string;
+    reference: string;
+    kind: ContentClaimKind;
+    relationship: ClaimantRelationship;
+    state: ContentClaimState;
+    /** The statutory deadline (an erasure request), or null. */
+    deadlineAt: string | null;
+    targetCount: number;
+    blockedTargetCount: number;
+    receivedAt: string;
+    updatedAt: string;
+    closedAt: string | null;
+}
+/** A claim in full, for its detail page. */
+export interface ContentClaimDetailView extends ContentClaimSummaryView {
+    submittedByUserId: string | null;
+    /** The claimant's statement; null once the retention period erased it. */
+    claimant: {
+        name: string;
+        email: string;
+        organization: string | null;
+        signature: string;
+        description: string;
+        originalWorkUrl: string | null;
+    } | null;
+    /** When the claimant's statement is erased (set when the claim closes). */
+    claimantExpiresAt: string | null;
+    targets: ContentClaimTargetView[];
+    events: ContentClaimEventView[];
+    /** The owners' own counter-notices, oldest first. */
+    counterNotices: ContentClaimCounterNoticeView[];
+}
+/** `GET /content-claims` */
+export interface ContentClaimListResponse {
+    claims: ContentClaimSummaryView[];
+    /** Pass as `cursor` for the next page; null on the last. */
+    nextCursor: string | null;
+}
+/** Every key a counter-notice's validation can produce, under `contentClaim.counterNotice.errors.*`. */
+export declare const CONTENT_CLAIM_COUNTER_NOTICE_VALIDATION_KEYS: readonly ["contentClaim.counterNotice.errors.claim", "contentClaim.counterNotice.errors.reference", "contentClaim.counterNotice.errors.claimId", "contentClaim.counterNotice.errors.fileIds", "contentClaim.counterNotice.errors.name", "contentClaim.counterNotice.errors.address", "contentClaim.counterNotice.errors.phone", "contentClaim.counterNotice.errors.email", "contentClaim.counterNotice.errors.materialDescription", "contentClaim.counterNotice.errors.materialLocation", "contentClaim.counterNotice.errors.explanation", "contentClaim.counterNotice.errors.perjury", "contentClaim.counterNotice.errors.jurisdiction", "contentClaim.counterNotice.errors.serviceOfProcess", "contentClaim.counterNotice.errors.disclosure", "contentClaim.counterNotice.errors.signature"];
+export type ContentClaimCounterNoticeValidationKey = (typeof CONTENT_CLAIM_COUNTER_NOTICE_VALIDATION_KEYS)[number];
+/**
+ * `POST /content-claims/counter-notices` — the owner of content a claim took
+ * down disputes it (17 U.S.C. § 512(g)(3)). Signed in: the API answers only
+ * for files the caller owns.
+ *
+ * Names the claim by its `reference` (the `OXY-XXXX-XXXX` the owner was
+ * emailed), its `claimId`, or the blocked `fileIds` — at least one. With
+ * `fileIds` the notice covers exactly those files; without, every one of the
+ * caller's files the claim blocked. Strict: an unknown key is refused.
+ */
+export declare const contentClaimCounterNoticeSchema: z.ZodEffects<z.ZodObject<{
+    reference: z.ZodOptional<z.ZodString>;
+    claimId: z.ZodOptional<z.ZodString>;
+    fileIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    subscriber: z.ZodObject<{
+        name: z.ZodString;
+        address: z.ZodString;
+        phone: z.ZodString;
+        email: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    }, {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    }>;
+    material: z.ZodObject<{
+        /** What was removed. */
+        description: z.ZodString;
+        /** Where it appeared before it was removed (a URL, or where in an app). */
+        location: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        description: string;
+        location: string;
+    }, {
+        description: string;
+        location: string;
+    }>;
+    /** Why it was a mistake or a misidentification, in the owner's words. */
+    explanation: z.ZodString;
+    /** Each of `COUNTER_NOTICE_STATEMENTS`, affirmed. */
+    statements: z.ZodObject<{
+        perjury: z.ZodLiteral<true>;
+        jurisdiction: z.ZodLiteral<true>;
+        serviceOfProcess: z.ZodLiteral<true>;
+        disclosure: z.ZodLiteral<true>;
+    }, "strict", z.ZodTypeAny, {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    }, {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    }>;
+    /** The owner's full legal name, typed as their signature. */
+    signature: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    signature: string;
+    statements: {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    };
+    subscriber: {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    };
+    material: {
+        description: string;
+        location: string;
+    };
+    explanation: string;
+    reference?: string | undefined;
+    claimId?: string | undefined;
+    fileIds?: string[] | undefined;
+}, {
+    signature: string;
+    statements: {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    };
+    subscriber: {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    };
+    material: {
+        description: string;
+        location: string;
+    };
+    explanation: string;
+    reference?: string | undefined;
+    claimId?: string | undefined;
+    fileIds?: string[] | undefined;
+}>, {
+    signature: string;
+    statements: {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    };
+    subscriber: {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    };
+    material: {
+        description: string;
+        location: string;
+    };
+    explanation: string;
+    reference?: string | undefined;
+    claimId?: string | undefined;
+    fileIds?: string[] | undefined;
+}, {
+    signature: string;
+    statements: {
+        perjury: true;
+        jurisdiction: true;
+        serviceOfProcess: true;
+        disclosure: true;
+    };
+    subscriber: {
+        name: string;
+        email: string;
+        address: string;
+        phone: string;
+    };
+    material: {
+        description: string;
+        location: string;
+    };
+    explanation: string;
+    reference?: string | undefined;
+    claimId?: string | undefined;
+    fileIds?: string[] | undefined;
+}>;
+export type ContentClaimCounterNotice = z.infer<typeof contentClaimCounterNoticeSchema>;
+/** `201` to a counter-notice. */
+export interface ContentClaimCounterNoticeResponse {
+    /** The counter-notice's id. */
+    id: string;
+    /** The claim it answers, as the owner was emailed it. */
+    reference: string;
+    /** Where the claim is now: `counter_noticed`. */
+    state: ContentClaimState;
+    /** The caller's blocked files the notice covers. */
+    fileIds: string[];
+}
+/**
+ * `400` to a counter-notice: `{ error, code: CONTENT_CLAIM_COUNTER_NOTICE_INVALID,
+ * fields }`, `fields` mapping each body path to a sentence.
+ */
+export type ContentClaimCounterNoticeError = ContentClaimSubmissionError;
+/** An owner's counter-notice as staff see it on the claim. */
+export interface ContentClaimCounterNoticeView {
+    id: string;
+    /** The account that sent it (null once that account is deleted). */
+    submittedByUserId: string | null;
+    fileIds: string[];
+    /** Which wording of `COUNTER_NOTICE_STATEMENTS` was affirmed. */
+    statementVersion: string;
+    /** What the owner wrote; null once the retention period erased it. */
+    statement: {
+        name: string;
+        address: string;
+        phone: string;
+        email: string;
+        materialDescription: string;
+        materialLocation: string;
+        explanation: string;
+        signature: string;
+    } | null;
+    createdAt: string;
+}

package/dist/types/email/messages.d.ts

@@ -761,9 +761,9 @@ export declare const emailFilterSchema: z.ZodObject<{
     id: string;
     enabled: boolean;
     userId: string;
+    matchAll: boolean;
     _id: string;
     order: number;
-    matchAll: boolean;
     conditions: {
         value: string;
         field: "subject" | "from" | "size" | "to" | "has-attachment";
@@ -780,9 +780,9 @@ export declare const emailFilterSchema: z.ZodObject<{
     id: string;
     enabled: boolean;
     userId: string;
+    matchAll: boolean;
     _id: string;
     order: number;
-    matchAll: boolean;
     conditions: {
         value: string;
         field: "subject" | "from" | "size" | "to" | "has-attachment";

package/dist/types/externalIdentity.d.ts

@@ -339,14 +339,14 @@ export declare const resolveExternalIdentityResponseSchema: z.ZodEffects<z.ZodOb
         publicKey?: string | undefined;
         verified?: boolean | undefined;
         did?: string | undefined;
-        _id?: string | undefined;
-        phone?: string | undefined;
+        relationship?: import("./userResponse").UserRelationship | undefined;
         address?: string | undefined;
+        phone?: string | undefined;
+        _id?: string | undefined;
         birthday?: string | undefined;
         dateOfBirth?: string | undefined;
         isAdult?: boolean | undefined;
         languages?: string[] | undefined;
-        relationship?: import("./userResponse").UserRelationship | undefined;
         themePreference?: import("./userResponse").ThemePreference | undefined;
         personalization?: {
             mentionMono: {
@@ -400,14 +400,14 @@ export declare const resolveExternalIdentityResponseSchema: z.ZodEffects<z.ZodOb
         publicKey?: string | undefined;
         verified?: boolean | undefined;
         did?: string | undefined;
-        _id?: string | undefined;
-        phone?: string | undefined;
+        relationship?: import("./userResponse").UserRelationship | undefined;
         address?: string | undefined;
+        phone?: string | undefined;
+        _id?: string | undefined;
         birthday?: string | undefined;
         dateOfBirth?: string | undefined;
         isAdult?: boolean | undefined;
         languages?: string[] | undefined;
-        relationship?: import("./userResponse").UserRelationship | undefined;
         themePreference?: import("./userResponse").ThemePreference | undefined;
         personalization?: {
             mentionMono: {
@@ -461,14 +461,14 @@ export declare const resolveExternalIdentityResponseSchema: z.ZodEffects<z.ZodOb
         publicKey?: string | undefined;
         verified?: boolean | undefined;
         did?: string | undefined;
-        _id?: string | undefined;
-        phone?: string | undefined;
+        relationship?: import("./userResponse").UserRelationship | undefined;
         address?: string | undefined;
+        phone?: string | undefined;
+        _id?: string | undefined;
         birthday?: string | undefined;
         dateOfBirth?: string | undefined;
         isAdult?: boolean | undefined;
         languages?: string[] | undefined;
-        relationship?: import("./userResponse").UserRelationship | undefined;
         themePreference?: import("./userResponse").ThemePreference | undefined;
         personalization?: {
             mentionMono: {
@@ -522,14 +522,14 @@ export declare const resolveExternalIdentityResponseSchema: z.ZodEffects<z.ZodOb
         publicKey?: string | undefined;
         verified?: boolean | undefined;
         did?: string | undefined;
-        _id?: string | undefined;
-        phone?: string | undefined;
+        relationship?: import("./userResponse").UserRelationship | undefined;
         address?: string | undefined;
+        phone?: string | undefined;
+        _id?: string | undefined;
         birthday?: string | undefined;
         dateOfBirth?: string | undefined;
         isAdult?: boolean | undefined;
         languages?: string[] | undefined;
-        relationship?: import("./userResponse").UserRelationship | undefined;
         themePreference?: import("./userResponse").ThemePreference | undefined;
         personalization?: {
             mentionMono: {

package/dist/types/index.d.ts

@@ -139,3 +139,4 @@ export * from './organizations';
 export * from './safety';
 export { serviceTokenScopesSchema, serviceTokenOptionsSchema, type ServiceTokenOptions, } from './serviceToken';
 export * from './applicationRoles';
+export * from './contentClaims';

package/dist/types/inference/aliaModelRelease.d.ts

@@ -219,9 +219,9 @@ export declare const aliaModelReleaseManifestSchema: z.ZodEffects<z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         schemaVersion: 1;
         revision: string;
+        reference: string;
         modelId: string;
         revisionId: string;
-        reference: string;
         releasedAt: string;
         evaluations: {
             score: string;
@@ -242,9 +242,9 @@ export declare const aliaModelReleaseManifestSchema: z.ZodEffects<z.ZodObject<{
     }, {
         schemaVersion: 1;
         revision: string;
+        reference: string;
         modelId: string;
         revisionId: string;
-        reference: string;
         releasedAt: string;
         retiredAt?: string | undefined;
         artifactDigest?: string | undefined;
@@ -265,9 +265,9 @@ export declare const aliaModelReleaseManifestSchema: z.ZodEffects<z.ZodObject<{
     }>, {
         schemaVersion: 1;
         revision: string;
+        reference: string;
         modelId: string;
         revisionId: string;
-        reference: string;
         releasedAt: string;
         evaluations: {
             score: string;
@@ -288,9 +288,9 @@ export declare const aliaModelReleaseManifestSchema: z.ZodEffects<z.ZodObject<{
     }, {
         schemaVersion: 1;
         revision: string;
+        reference: string;
         modelId: string;
         revisionId: string;
-        reference: string;
         releasedAt: string;
         retiredAt?: string | undefined;
         artifactDigest?: string | undefined;
@@ -392,9 +392,9 @@ export declare const aliaModelReleaseManifestSchema: z.ZodEffects<z.ZodObject<{
     revision: {
         schemaVersion: 1;
         revision: string;
+        reference: string;
         modelId: string;
         revisionId: string;
-        reference: string;
         releasedAt: string;
         evaluations: {
             score: string;
@@ -446,9 +446,9 @@ export declare const aliaModelReleaseManifestSchema: z.ZodEffects<z.ZodObject<{
     revision: {
         schemaVersion: 1;
         revision: string;
+        reference: string;
         modelId: string;
         revisionId: string;
-        reference: string;
         releasedAt: string;
         retiredAt?: string | undefined;
         artifactDigest?: string | undefined;
@@ -500,9 +500,9 @@ export declare const aliaModelReleaseManifestSchema: z.ZodEffects<z.ZodObject<{
     revision: {
         schemaVersion: 1;
         revision: string;
+        reference: string;
         modelId: string;
         revisionId: string;
-        reference: string;
         releasedAt: string;
         evaluations: {
             score: string;
@@ -554,9 +554,9 @@ export declare const aliaModelReleaseManifestSchema: z.ZodEffects<z.ZodObject<{
     revision: {
         schemaVersion: 1;
         revision: string;
+        reference: string;
         modelId: string;
         revisionId: string;
-        reference: string;
         releasedAt: string;
         retiredAt?: string | undefined;
         artifactDigest?: string | undefined;

package/dist/types/inference/catalogue.d.ts

@@ -876,9 +876,9 @@ export declare const modelRevisionSchema: z.ZodEffects<z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     schemaVersion: 1;
     revision: string;
+    reference: string;
     modelId: string;
     revisionId: string;
-    reference: string;
     releasedAt: string;
     evaluations: {
         score: string;
@@ -899,9 +899,9 @@ export declare const modelRevisionSchema: z.ZodEffects<z.ZodObject<{
 }, {
     schemaVersion: 1;
     revision: string;
+    reference: string;
     modelId: string;
     revisionId: string;
-    reference: string;
     releasedAt: string;
     retiredAt?: string | undefined;
     artifactDigest?: string | undefined;
@@ -922,9 +922,9 @@ export declare const modelRevisionSchema: z.ZodEffects<z.ZodObject<{
 }>, {
     schemaVersion: 1;
     revision: string;
+    reference: string;
     modelId: string;
     revisionId: string;
-    reference: string;
     releasedAt: string;
     evaluations: {
         score: string;
@@ -945,9 +945,9 @@ export declare const modelRevisionSchema: z.ZodEffects<z.ZodObject<{
 }, {
     schemaVersion: 1;
     revision: string;
+    reference: string;
     modelId: string;
     revisionId: string;
-    reference: string;
     releasedAt: string;
     retiredAt?: string | undefined;
     artifactDigest?: string | undefined;

package/dist/types/inference/inbox.d.ts

@@ -137,7 +137,7 @@ export declare const inboxNaturalSearchResponseSchema: z.ZodObject<{
         unread?: boolean | undefined;
         after?: string | undefined;
         before?: string | undefined;
-        mailbox?: "inbox" | "sent" | "drafts" | "trash" | "spam" | "archive" | undefined;
+        mailbox?: "trash" | "inbox" | "sent" | "drafts" | "spam" | "archive" | undefined;
     }, {
         subject?: string | undefined;
         from?: string | undefined;
@@ -148,7 +148,7 @@ export declare const inboxNaturalSearchResponseSchema: z.ZodObject<{
         unread?: boolean | undefined;
         after?: string | undefined;
         before?: string | undefined;
-        mailbox?: "inbox" | "sent" | "drafts" | "trash" | "spam" | "archive" | undefined;
+        mailbox?: "trash" | "inbox" | "sent" | "drafts" | "spam" | "archive" | undefined;
     }>;
     interpretation: z.ZodString;
 }, "strict", z.ZodTypeAny, {
@@ -162,7 +162,7 @@ export declare const inboxNaturalSearchResponseSchema: z.ZodObject<{
         unread?: boolean | undefined;
         after?: string | undefined;
         before?: string | undefined;
-        mailbox?: "inbox" | "sent" | "drafts" | "trash" | "spam" | "archive" | undefined;
+        mailbox?: "trash" | "inbox" | "sent" | "drafts" | "spam" | "archive" | undefined;
     };
     interpretation: string;
 }, {
@@ -176,7 +176,7 @@ export declare const inboxNaturalSearchResponseSchema: z.ZodObject<{
         unread?: boolean | undefined;
         after?: string | undefined;
         before?: string | undefined;
-        mailbox?: "inbox" | "sent" | "drafts" | "trash" | "spam" | "archive" | undefined;
+        mailbox?: "trash" | "inbox" | "sent" | "drafts" | "spam" | "archive" | undefined;
     };
     interpretation: string;
 }>;