@itm-studio/partner-sdk 0.2.8 → 0.2.10

package/README.md

@@ -67,6 +67,19 @@ The token is sent as the `x-partner-api-key` header on every request. Your brand
 
 Keep the partner token on your server. Do not expose it from browser code or client-side mobile code.
 
+The SDK enforces this boundary and supports Node.js server runtimes only. Imports
+from browsers, React Native, Web or Service Workers, edge runtimes, and Electron
+processes fail before an authenticated client can be created. Send client-side
+requests to your own Node backend, then return only the data the client needs.
+
+In Next.js, also mark the module that reads the token as server-only so an
+accidental Client Component import fails during the application build:
+
+```typescript
+import "server-only";
+import { createITMPartnerClient } from "@itm-studio/partner-sdk";
+```
+
 For request-scoped mutations such as partner brand subscriptions, create the client inside the incoming request and forward `x-forwarded-for` and `user-agent` so the backend can enrich compliance metadata when those fields are omitted from `input.compliance`.
 
 ```typescript
@@ -223,6 +236,52 @@ basis points (`6000` = 60%). Refresh after `validUntil`. Because price is stored
 per tier, every upcoming admission window for a managed tier must fall within
 the configured horizon before that tier is eligible.
 
+## AgentMail
+
+Queue one to ten personalized plain-text emails from the authenticated brand's
+dedicated AgentMail inbox. Each item is a separate single-recipient message.
+The mutation returns after the durable batch is accepted; query the batch for
+final per-message provider status.
+
+```ts
+const queued = await client.mutation({
+  sendPartnerAgentEmail: {
+    __args: {
+      input: {
+        idempotencyKey: "venue-outreach-2026-08-13",
+        messages: [
+          {
+            to: "bookings@venue.example",
+            subject: "October show inquiry",
+            text: "Would October 10 work for a 200-person show?",
+          },
+        ],
+      },
+    },
+    uid: true,
+    status: true,
+    acceptedCount: true,
+    messages: { uid: true, recipient: true, status: true },
+  },
+});
+
+const status = await client.query({
+  getPartnerAgentEmailBatch: {
+    __args: { batchUid: queued.sendPartnerAgentEmail.uid },
+    status: true,
+    messages: {
+      recipient: true,
+      status: true,
+      agentMailMessageId: true,
+      lastErrorCode: true,
+    },
+  },
+});
+```
+
+Reuse an idempotency key only for the exact same logical batch. `SENT` means
+AgentMail accepted the message; it does not prove inbox delivery.
+
 ## Available Queries
 
 ### `getPartnerBrand`
@@ -264,6 +323,10 @@ const { getPartnerMomentsForBrand } = await itm.query({
       take: 20, // items per page (default: 50, omit to use default)
       cursor: nextCursor, // from previous response
       status: "UPCOMING", // UPCOMING | LIVE | ENDED
+      filters: {
+        search: "summer launch", // case-insensitive name or slug match
+        includePrivate: true, // include private moments owned by your brand
+      },
       sortOrder: "ASC", // ASC | DESC by start date (default: DESC)
     },
     moments: { uid: true, name: true, startDate: true },
@@ -274,6 +337,14 @@ const { getPartnerMomentsForBrand } = await itm.query({
 });
 ```
 
+By default, only public moments are returned. Set
+`filters.includePrivate` to `true` to return both public and private moments
+owned by the brand associated with the partner token. Omitting `filters`, or
+setting `includePrivate` to `false`, preserves the public-only behavior.
+`filters.search` matches moment names and slugs case-insensitively, is limited
+to 100 characters, and composes with visibility, status, sorting, and cursor
+pagination.
+
 ### `getPartnerDrops`
 
 Get paginated brand drops for the brand associated with your partner token.
@@ -428,9 +499,13 @@ const { getMomentLineupByToken } = await itm.query({
 
 ### `getPartnerMomentStats`
 
-Get cached partner-facing counts for a moment owned by the authenticated partner's brand.
+Get cached partner-facing counts for a moment owned by the authenticated partner's brand. Counts
+can be up to five minutes old.
 
 - `ticketsCount` counts confirmed tickets only.
+- `generatedAt` identifies when this cached count set was computed.
+- `paidTicketsCount` counts confirmed tickets with a materialized price above zero.
+- `freeTicketsCount` counts confirmed tickets with a zero materialized price.
 - `waitlistCount` counts active waitlist entries.
 - `externalRsvpCount` counts external RSVPs.
 - `ticketRsvpRequestsCount` counts ticket RSVP requests.
@@ -439,7 +514,10 @@ Get cached partner-facing counts for a moment owned by the authenticated partner
 const { getPartnerMomentStats } = await itm.query({
   getPartnerMomentStats: {
     __args: { momentSlug: "my-event-slug" },
+    generatedAt: true,
     ticketsCount: true,
+    paidTicketsCount: true,
+    freeTicketsCount: true,
     waitlistCount: true,
     externalRsvpCount: true,
     ticketRsvpRequestsCount: true,

package/dist/index.d.mts

@@ -8,6 +8,8 @@ type Scalars = {
     Float: number;
 };
 type MomentStatus = 'UPCOMING' | 'LIVE' | 'ENDED';
+type BrandAgentEmailSendBatchStatus = 'PENDING' | 'SENDING' | 'SENT' | 'PARTIAL' | 'FAILED' | 'UNKNOWN';
+type BrandAgentEmailSendMessageStatus = 'PENDING' | 'SENDING' | 'SENT' | 'FAILED' | 'UNKNOWN';
 type MomentSortOrder = 'ASC' | 'DESC';
 type BrandDropCtaType = 'EXTERNAL_URL' | 'GATED_LINK' | 'MUSIC_LINK' | 'SUBSCRIBE';
 type MusicReleaseType = 'ALBUM' | 'EP' | 'SINGLE';
@@ -210,7 +212,12 @@ interface PartnerCustomer {
     __typename: 'PartnerCustomer';
 }
 interface PartnerMomentStats {
+    generatedAt: Scalars['DateTime'];
     ticketsCount: Scalars['Int'];
+    /** Confirmed tickets whose materialized price is greater than zero. */
+    paidTicketsCount: Scalars['Int'];
+    /** Confirmed tickets whose materialized price is zero. */
+    freeTicketsCount: Scalars['Int'];
     waitlistCount: Scalars['Int'];
     externalRsvpCount: Scalars['Int'];
     ticketRsvpRequestsCount: Scalars['Int'];
@@ -575,9 +582,35 @@ interface MomentLineupResponseResult {
     success: Scalars['Boolean'];
     __typename: 'MomentLineupResponseResult';
 }
+interface BrandAgentEmailSendMessage {
+    uid: Scalars['String'];
+    position: Scalars['Int'];
+    recipient: Scalars['String'];
+    subject: Scalars['String'];
+    text: Scalars['String'];
+    status: BrandAgentEmailSendMessageStatus;
+    agentMailMessageId: (Scalars['String'] | null);
+    agentMailThreadId: (Scalars['String'] | null);
+    sentAt: (Scalars['DateTime'] | null);
+    failedAt: (Scalars['DateTime'] | null);
+    lastErrorCode: (Scalars['String'] | null);
+    lastErrorMessage: (Scalars['String'] | null);
+    __typename: 'BrandAgentEmailSendMessage';
+}
+interface BrandAgentEmailSendBatch {
+    uid: Scalars['String'];
+    createdAt: Scalars['DateTime'];
+    status: BrandAgentEmailSendBatchStatus;
+    senderEmailAddress: Scalars['String'];
+    acceptedCount: Scalars['Int'];
+    messages: BrandAgentEmailSendMessage[];
+    __typename: 'BrandAgentEmailSendBatch';
+}
 interface Query {
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand: PartnerBrand;
+    /** Retrieve one AgentMail send batch owned by the authenticated partner brand. */
+    getPartnerAgentEmailBatch: BrandAgentEmailSendBatch;
     /** Get paginated moments for the brand associated with the partner token. */
     getPartnerMomentsForBrand: GetPublicMomentsResponse;
     /** Get paginated drops for the brand associated with the partner token. */
@@ -691,6 +724,8 @@ interface Mutation {
      * When type is IRL, the venue field is required.
      */
     createPartnerMoment: Moment;
+    /** Queue one to ten emails from the authenticated brand's AgentMail inbox. */
+    sendPartnerAgentEmail: BrandAgentEmailSendBatch;
     /**
      * Bulk edit partner-owned ticket tiers for a moment.
      * Supports per-tier price, facility-fee, and supply updates.
@@ -899,7 +934,12 @@ interface PartnerCustomerGenqlSelection {
     __scalar?: boolean | number;
 }
 interface PartnerMomentStatsGenqlSelection {
+    generatedAt?: boolean | number;
     ticketsCount?: boolean | number;
+    /** Confirmed tickets whose materialized price is greater than zero. */
+    paidTicketsCount?: boolean | number;
+    /** Confirmed tickets whose materialized price is zero. */
+    freeTicketsCount?: boolean | number;
     waitlistCount?: boolean | number;
     externalRsvpCount?: boolean | number;
     ticketRsvpRequestsCount?: boolean | number;
@@ -1302,9 +1342,47 @@ interface MomentLineupResponseResultGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface PartnerMomentsFiltersInput {
+    /** Case-insensitive search over moment name and slug. Whitespace-only values are ignored. */
+    search?: (Scalars['String'] | null);
+    /** When true, includes private moments owned by the authenticated brand. Default: false. */
+    includePrivate?: (Scalars['Boolean'] | null);
+}
+interface BrandAgentEmailSendMessageGenqlSelection {
+    uid?: boolean | number;
+    position?: boolean | number;
+    recipient?: boolean | number;
+    subject?: boolean | number;
+    text?: boolean | number;
+    status?: boolean | number;
+    agentMailMessageId?: boolean | number;
+    agentMailThreadId?: boolean | number;
+    sentAt?: boolean | number;
+    failedAt?: boolean | number;
+    lastErrorCode?: boolean | number;
+    lastErrorMessage?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
+interface BrandAgentEmailSendBatchGenqlSelection {
+    uid?: boolean | number;
+    createdAt?: boolean | number;
+    status?: boolean | number;
+    senderEmailAddress?: boolean | number;
+    acceptedCount?: boolean | number;
+    messages?: BrandAgentEmailSendMessageGenqlSelection;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface QueryGenqlSelection {
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand?: PartnerBrandGenqlSelection;
+    /** Retrieve one AgentMail send batch owned by the authenticated partner brand. */
+    getPartnerAgentEmailBatch?: (BrandAgentEmailSendBatchGenqlSelection & {
+        __args: {
+            batchUid: Scalars['String'];
+        };
+    });
     /** Get paginated moments for the brand associated with the partner token. */
     getPartnerMomentsForBrand?: (GetPublicMomentsResponseGenqlSelection & {
         __args: {
@@ -1312,6 +1390,7 @@ interface QueryGenqlSelection {
             cursor?: (Scalars['String'] | null);
             take?: (Scalars['Int'] | null);
             status?: (MomentStatus | null);
+            filters?: (PartnerMomentsFiltersInput | null);
             /** Sort order for moments by start date (default: DESC - newest to oldest) */
             sortOrder?: (MomentSortOrder | null);
         };
@@ -1449,6 +1528,18 @@ interface DimensionsInput {
     width: Scalars['Float'];
     height: Scalars['Float'];
 }
+interface BrandAgentEmailMessageInput {
+    /** One normalized recipient. Each item is sent as a separate email. */
+    to: Scalars['String'];
+    subject: Scalars['String'];
+    text: Scalars['String'];
+}
+interface SendPartnerAgentEmailInput {
+    /** Stable business idempotency key for this logical batch. */
+    idempotencyKey: Scalars['String'];
+    /** One to ten personalized, single-recipient plain-text emails. */
+    messages: BrandAgentEmailMessageInput[];
+}
 interface VenueInput {
     name: Scalars['String'];
     city: Scalars['String'];
@@ -1749,6 +1840,12 @@ interface MutationGenqlSelection {
             input: CreatePartnerMomentInput;
         };
     });
+    /** Queue one to ten emails from the authenticated brand's AgentMail inbox. */
+    sendPartnerAgentEmail?: (BrandAgentEmailSendBatchGenqlSelection & {
+        __args: {
+            input: SendPartnerAgentEmailInput;
+        };
+    });
     /**
      * Bulk edit partner-owned ticket tiers for a moment.
      * Supports per-tier price, facility-fee, and supply updates.
@@ -1893,4 +1990,4 @@ type ITMPartnerClient = Client;
  */
 declare function createITMPartnerClient(config: ITMPartnerClientConfig): ITMPartnerClient;
 
-export { type ApplyDynamicPricingInput, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type CreateMomentOnlineConfigInput, type CreatePartnerBrandSubscriptionInput, type CreatePartnerBrandSubscriptionResponse, type CreatePartnerMomentInput, type CreatePartnerTicketTierInput, type Currency, DEFAULT_API_URL, type Dimensions, type DimensionsInput, type DynamicPricingActorType, type DynamicPricingAdmissionWindow, type DynamicPricingBatch, type DynamicPricingBatchEvent, type DynamicPricingBatchEventType, type DynamicPricingBatchItem, type DynamicPricingBatchItemStatus, type DynamicPricingBatchStatus, type DynamicPricingContext, type DynamicPricingExecutionMode, type DynamicPricingInventoryGuardInput, type DynamicPricingInventoryGuardMode, type DynamicPricingInventoryMetric, type DynamicPricingMomentInput, type DynamicPricingTierContext, type DynamicPricingTierUpdateInput, type Echo, type EchoMediaAsset, type EchoType, type EditPartnerTicketTiersForMomentInput, type EventImportPlatform, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerClient, type ITMPartnerClientConfig, type ITMPartnerHeaders, type ITMPartnerHeadersObject, type MediaAsset, type MediaAssetUploadUrl, type MerchPurchase, type Moment, type MomentCategory, type MomentCollection, type MomentCollectionLink, type MomentDiscountCodeUsage, type MomentDynamicPricingPolicy, type MomentDynamicPricingTierRule, type MomentLineup, type MomentLineupDisplayLabel, type MomentLineupResponseResult, type MomentLineupStatus, type MomentLineupType, type MomentOnlineProvider, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type MusicReleaseType, type Mutation, type PartnerBrand, type PartnerCustomer, type PartnerMomentAttendanceCount, type PartnerMomentAttendanceLookupInput, type PartnerMomentAttendanceStats, type PartnerMomentGuestlistAttendance, type PartnerMomentGuestlistLabelAttendance, type PartnerMomentStats, type PartnerMomentTicketAttendance, type PartnerMomentTicketTierAttendance, type PartnerTicketTier, type PartnerTicketTierUpdateInput, type Payment, type PaymentStatus, type PostSubscriptionEmailInput, type PostSubscriptionMessageInput, type PostSubscriptionPushInput, type PostSubscriptionSmsInput, type PublicMomentLineupInfo, type Query, type RespondToMomentLineupInput, type SubscriptionComplianceInput, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };
+export { type ApplyDynamicPricingInput, type BrandAgentEmailMessageInput, type BrandAgentEmailSendBatch, type BrandAgentEmailSendBatchStatus, type BrandAgentEmailSendMessage, type BrandAgentEmailSendMessageStatus, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type CreateMomentOnlineConfigInput, type CreatePartnerBrandSubscriptionInput, type CreatePartnerBrandSubscriptionResponse, type CreatePartnerMomentInput, type CreatePartnerTicketTierInput, type Currency, DEFAULT_API_URL, type Dimensions, type DimensionsInput, type DynamicPricingActorType, type DynamicPricingAdmissionWindow, type DynamicPricingBatch, type DynamicPricingBatchEvent, type DynamicPricingBatchEventType, type DynamicPricingBatchItem, type DynamicPricingBatchItemStatus, type DynamicPricingBatchStatus, type DynamicPricingContext, type DynamicPricingExecutionMode, type DynamicPricingInventoryGuardInput, type DynamicPricingInventoryGuardMode, type DynamicPricingInventoryMetric, type DynamicPricingMomentInput, type DynamicPricingTierContext, type DynamicPricingTierUpdateInput, type Echo, type EchoMediaAsset, type EchoType, type EditPartnerTicketTiersForMomentInput, type EventImportPlatform, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerClient, type ITMPartnerClientConfig, type ITMPartnerHeaders, type ITMPartnerHeadersObject, type MediaAsset, type MediaAssetUploadUrl, type MerchPurchase, type Moment, type MomentCategory, type MomentCollection, type MomentCollectionLink, type MomentDiscountCodeUsage, type MomentDynamicPricingPolicy, type MomentDynamicPricingTierRule, type MomentLineup, type MomentLineupDisplayLabel, type MomentLineupResponseResult, type MomentLineupStatus, type MomentLineupType, type MomentOnlineProvider, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type MusicReleaseType, type Mutation, type PartnerBrand, type PartnerCustomer, type PartnerMomentAttendanceCount, type PartnerMomentAttendanceLookupInput, type PartnerMomentAttendanceStats, type PartnerMomentGuestlistAttendance, type PartnerMomentGuestlistLabelAttendance, type PartnerMomentStats, type PartnerMomentTicketAttendance, type PartnerMomentTicketTierAttendance, type PartnerMomentsFiltersInput, type PartnerTicketTier, type PartnerTicketTierUpdateInput, type Payment, type PaymentStatus, type PostSubscriptionEmailInput, type PostSubscriptionMessageInput, type PostSubscriptionPushInput, type PostSubscriptionSmsInput, type PublicMomentLineupInfo, type Query, type RespondToMomentLineupInput, type SendPartnerAgentEmailInput, type SubscriptionComplianceInput, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };

package/dist/index.d.ts

@@ -8,6 +8,8 @@ type Scalars = {
     Float: number;
 };
 type MomentStatus = 'UPCOMING' | 'LIVE' | 'ENDED';
+type BrandAgentEmailSendBatchStatus = 'PENDING' | 'SENDING' | 'SENT' | 'PARTIAL' | 'FAILED' | 'UNKNOWN';
+type BrandAgentEmailSendMessageStatus = 'PENDING' | 'SENDING' | 'SENT' | 'FAILED' | 'UNKNOWN';
 type MomentSortOrder = 'ASC' | 'DESC';
 type BrandDropCtaType = 'EXTERNAL_URL' | 'GATED_LINK' | 'MUSIC_LINK' | 'SUBSCRIBE';
 type MusicReleaseType = 'ALBUM' | 'EP' | 'SINGLE';
@@ -210,7 +212,12 @@ interface PartnerCustomer {
     __typename: 'PartnerCustomer';
 }
 interface PartnerMomentStats {
+    generatedAt: Scalars['DateTime'];
     ticketsCount: Scalars['Int'];
+    /** Confirmed tickets whose materialized price is greater than zero. */
+    paidTicketsCount: Scalars['Int'];
+    /** Confirmed tickets whose materialized price is zero. */
+    freeTicketsCount: Scalars['Int'];
     waitlistCount: Scalars['Int'];
     externalRsvpCount: Scalars['Int'];
     ticketRsvpRequestsCount: Scalars['Int'];
@@ -575,9 +582,35 @@ interface MomentLineupResponseResult {
     success: Scalars['Boolean'];
     __typename: 'MomentLineupResponseResult';
 }
+interface BrandAgentEmailSendMessage {
+    uid: Scalars['String'];
+    position: Scalars['Int'];
+    recipient: Scalars['String'];
+    subject: Scalars['String'];
+    text: Scalars['String'];
+    status: BrandAgentEmailSendMessageStatus;
+    agentMailMessageId: (Scalars['String'] | null);
+    agentMailThreadId: (Scalars['String'] | null);
+    sentAt: (Scalars['DateTime'] | null);
+    failedAt: (Scalars['DateTime'] | null);
+    lastErrorCode: (Scalars['String'] | null);
+    lastErrorMessage: (Scalars['String'] | null);
+    __typename: 'BrandAgentEmailSendMessage';
+}
+interface BrandAgentEmailSendBatch {
+    uid: Scalars['String'];
+    createdAt: Scalars['DateTime'];
+    status: BrandAgentEmailSendBatchStatus;
+    senderEmailAddress: Scalars['String'];
+    acceptedCount: Scalars['Int'];
+    messages: BrandAgentEmailSendMessage[];
+    __typename: 'BrandAgentEmailSendBatch';
+}
 interface Query {
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand: PartnerBrand;
+    /** Retrieve one AgentMail send batch owned by the authenticated partner brand. */
+    getPartnerAgentEmailBatch: BrandAgentEmailSendBatch;
     /** Get paginated moments for the brand associated with the partner token. */
     getPartnerMomentsForBrand: GetPublicMomentsResponse;
     /** Get paginated drops for the brand associated with the partner token. */
@@ -691,6 +724,8 @@ interface Mutation {
      * When type is IRL, the venue field is required.
      */
     createPartnerMoment: Moment;
+    /** Queue one to ten emails from the authenticated brand's AgentMail inbox. */
+    sendPartnerAgentEmail: BrandAgentEmailSendBatch;
     /**
      * Bulk edit partner-owned ticket tiers for a moment.
      * Supports per-tier price, facility-fee, and supply updates.
@@ -899,7 +934,12 @@ interface PartnerCustomerGenqlSelection {
     __scalar?: boolean | number;
 }
 interface PartnerMomentStatsGenqlSelection {
+    generatedAt?: boolean | number;
     ticketsCount?: boolean | number;
+    /** Confirmed tickets whose materialized price is greater than zero. */
+    paidTicketsCount?: boolean | number;
+    /** Confirmed tickets whose materialized price is zero. */
+    freeTicketsCount?: boolean | number;
     waitlistCount?: boolean | number;
     externalRsvpCount?: boolean | number;
     ticketRsvpRequestsCount?: boolean | number;
@@ -1302,9 +1342,47 @@ interface MomentLineupResponseResultGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface PartnerMomentsFiltersInput {
+    /** Case-insensitive search over moment name and slug. Whitespace-only values are ignored. */
+    search?: (Scalars['String'] | null);
+    /** When true, includes private moments owned by the authenticated brand. Default: false. */
+    includePrivate?: (Scalars['Boolean'] | null);
+}
+interface BrandAgentEmailSendMessageGenqlSelection {
+    uid?: boolean | number;
+    position?: boolean | number;
+    recipient?: boolean | number;
+    subject?: boolean | number;
+    text?: boolean | number;
+    status?: boolean | number;
+    agentMailMessageId?: boolean | number;
+    agentMailThreadId?: boolean | number;
+    sentAt?: boolean | number;
+    failedAt?: boolean | number;
+    lastErrorCode?: boolean | number;
+    lastErrorMessage?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
+interface BrandAgentEmailSendBatchGenqlSelection {
+    uid?: boolean | number;
+    createdAt?: boolean | number;
+    status?: boolean | number;
+    senderEmailAddress?: boolean | number;
+    acceptedCount?: boolean | number;
+    messages?: BrandAgentEmailSendMessageGenqlSelection;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface QueryGenqlSelection {
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand?: PartnerBrandGenqlSelection;
+    /** Retrieve one AgentMail send batch owned by the authenticated partner brand. */
+    getPartnerAgentEmailBatch?: (BrandAgentEmailSendBatchGenqlSelection & {
+        __args: {
+            batchUid: Scalars['String'];
+        };
+    });
     /** Get paginated moments for the brand associated with the partner token. */
     getPartnerMomentsForBrand?: (GetPublicMomentsResponseGenqlSelection & {
         __args: {
@@ -1312,6 +1390,7 @@ interface QueryGenqlSelection {
             cursor?: (Scalars['String'] | null);
             take?: (Scalars['Int'] | null);
             status?: (MomentStatus | null);
+            filters?: (PartnerMomentsFiltersInput | null);
             /** Sort order for moments by start date (default: DESC - newest to oldest) */
             sortOrder?: (MomentSortOrder | null);
         };
@@ -1449,6 +1528,18 @@ interface DimensionsInput {
     width: Scalars['Float'];
     height: Scalars['Float'];
 }
+interface BrandAgentEmailMessageInput {
+    /** One normalized recipient. Each item is sent as a separate email. */
+    to: Scalars['String'];
+    subject: Scalars['String'];
+    text: Scalars['String'];
+}
+interface SendPartnerAgentEmailInput {
+    /** Stable business idempotency key for this logical batch. */
+    idempotencyKey: Scalars['String'];
+    /** One to ten personalized, single-recipient plain-text emails. */
+    messages: BrandAgentEmailMessageInput[];
+}
 interface VenueInput {
     name: Scalars['String'];
     city: Scalars['String'];
@@ -1749,6 +1840,12 @@ interface MutationGenqlSelection {
             input: CreatePartnerMomentInput;
         };
     });
+    /** Queue one to ten emails from the authenticated brand's AgentMail inbox. */
+    sendPartnerAgentEmail?: (BrandAgentEmailSendBatchGenqlSelection & {
+        __args: {
+            input: SendPartnerAgentEmailInput;
+        };
+    });
     /**
      * Bulk edit partner-owned ticket tiers for a moment.
      * Supports per-tier price, facility-fee, and supply updates.
@@ -1893,4 +1990,4 @@ type ITMPartnerClient = Client;
  */
 declare function createITMPartnerClient(config: ITMPartnerClientConfig): ITMPartnerClient;
 
-export { type ApplyDynamicPricingInput, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type CreateMomentOnlineConfigInput, type CreatePartnerBrandSubscriptionInput, type CreatePartnerBrandSubscriptionResponse, type CreatePartnerMomentInput, type CreatePartnerTicketTierInput, type Currency, DEFAULT_API_URL, type Dimensions, type DimensionsInput, type DynamicPricingActorType, type DynamicPricingAdmissionWindow, type DynamicPricingBatch, type DynamicPricingBatchEvent, type DynamicPricingBatchEventType, type DynamicPricingBatchItem, type DynamicPricingBatchItemStatus, type DynamicPricingBatchStatus, type DynamicPricingContext, type DynamicPricingExecutionMode, type DynamicPricingInventoryGuardInput, type DynamicPricingInventoryGuardMode, type DynamicPricingInventoryMetric, type DynamicPricingMomentInput, type DynamicPricingTierContext, type DynamicPricingTierUpdateInput, type Echo, type EchoMediaAsset, type EchoType, type EditPartnerTicketTiersForMomentInput, type EventImportPlatform, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerClient, type ITMPartnerClientConfig, type ITMPartnerHeaders, type ITMPartnerHeadersObject, type MediaAsset, type MediaAssetUploadUrl, type MerchPurchase, type Moment, type MomentCategory, type MomentCollection, type MomentCollectionLink, type MomentDiscountCodeUsage, type MomentDynamicPricingPolicy, type MomentDynamicPricingTierRule, type MomentLineup, type MomentLineupDisplayLabel, type MomentLineupResponseResult, type MomentLineupStatus, type MomentLineupType, type MomentOnlineProvider, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type MusicReleaseType, type Mutation, type PartnerBrand, type PartnerCustomer, type PartnerMomentAttendanceCount, type PartnerMomentAttendanceLookupInput, type PartnerMomentAttendanceStats, type PartnerMomentGuestlistAttendance, type PartnerMomentGuestlistLabelAttendance, type PartnerMomentStats, type PartnerMomentTicketAttendance, type PartnerMomentTicketTierAttendance, type PartnerTicketTier, type PartnerTicketTierUpdateInput, type Payment, type PaymentStatus, type PostSubscriptionEmailInput, type PostSubscriptionMessageInput, type PostSubscriptionPushInput, type PostSubscriptionSmsInput, type PublicMomentLineupInfo, type Query, type RespondToMomentLineupInput, type SubscriptionComplianceInput, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };
+export { type ApplyDynamicPricingInput, type BrandAgentEmailMessageInput, type BrandAgentEmailSendBatch, type BrandAgentEmailSendBatchStatus, type BrandAgentEmailSendMessage, type BrandAgentEmailSendMessageStatus, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type CreateMomentOnlineConfigInput, type CreatePartnerBrandSubscriptionInput, type CreatePartnerBrandSubscriptionResponse, type CreatePartnerMomentInput, type CreatePartnerTicketTierInput, type Currency, DEFAULT_API_URL, type Dimensions, type DimensionsInput, type DynamicPricingActorType, type DynamicPricingAdmissionWindow, type DynamicPricingBatch, type DynamicPricingBatchEvent, type DynamicPricingBatchEventType, type DynamicPricingBatchItem, type DynamicPricingBatchItemStatus, type DynamicPricingBatchStatus, type DynamicPricingContext, type DynamicPricingExecutionMode, type DynamicPricingInventoryGuardInput, type DynamicPricingInventoryGuardMode, type DynamicPricingInventoryMetric, type DynamicPricingMomentInput, type DynamicPricingTierContext, type DynamicPricingTierUpdateInput, type Echo, type EchoMediaAsset, type EchoType, type EditPartnerTicketTiersForMomentInput, type EventImportPlatform, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerClient, type ITMPartnerClientConfig, type ITMPartnerHeaders, type ITMPartnerHeadersObject, type MediaAsset, type MediaAssetUploadUrl, type MerchPurchase, type Moment, type MomentCategory, type MomentCollection, type MomentCollectionLink, type MomentDiscountCodeUsage, type MomentDynamicPricingPolicy, type MomentDynamicPricingTierRule, type MomentLineup, type MomentLineupDisplayLabel, type MomentLineupResponseResult, type MomentLineupStatus, type MomentLineupType, type MomentOnlineProvider, type MomentSortOrder, type MomentStatus, type MomentSubcategory, type MomentType, type MusicReleaseType, type Mutation, type PartnerBrand, type PartnerCustomer, type PartnerMomentAttendanceCount, type PartnerMomentAttendanceLookupInput, type PartnerMomentAttendanceStats, type PartnerMomentGuestlistAttendance, type PartnerMomentGuestlistLabelAttendance, type PartnerMomentStats, type PartnerMomentTicketAttendance, type PartnerMomentTicketTierAttendance, type PartnerMomentsFiltersInput, type PartnerTicketTier, type PartnerTicketTierUpdateInput, type Payment, type PaymentStatus, type PostSubscriptionEmailInput, type PostSubscriptionMessageInput, type PostSubscriptionPushInput, type PostSubscriptionSmsInput, type PublicMomentLineupInfo, type Query, type RespondToMomentLineupInput, type SendPartnerAgentEmailInput, type SubscriptionComplianceInput, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };