@itm-studio/partner-sdk 0.3.1 → 0.3.3

package/README.md

@@ -1829,3 +1829,59 @@ When exposing a new backend endpoint to partners:
 3. Add tests in `tests/queries.test.ts`
 4. Open a PR — Hive will validate the schema change isn't breaking
 5. After merge, the schema is auto-published to Hive and a new SDK version can be released
+
+### Browse brand media (partners and agents)
+
+`getPartnerMediaAssets` returns active assets linked to the authenticated brand,
+newest first. It defaults to 50 assets per page and caps `take` at 100. Follow
+`nextCursor` while `hasNextPage` is true; `totalCount` counts the matching library,
+not just this page. `mimeTypePrefix` is case-insensitive (`image/`, `video/`,
+`application/pdf`, etc.). Existing upload paths without a brand association are
+not included; an empty result does not prove the brand never uploaded a file.
+
+```ts
+const { getPartnerMediaAssets: page } = await client.query({
+  getPartnerMediaAssets: {
+    __args: { input: { take: 20, mimeTypePrefix: 'image/' } },
+    mediaAssets: {
+      uid: true, url: true, mimeType: true,
+      dimensions: { width: true, height: true },
+      transforms: { original: true, small: true, hls: true },
+      createdAt: true,
+    },
+    totalCount: true, hasNextPage: true, nextCursor: true,
+  },
+});
+
+if (page.mediaAssets.length > 0) {
+  const { getPartnerMediaAsset: asset } = await client.query({
+    getPartnerMediaAsset: {
+      __args: { uid: page.mediaAssets[0].uid },
+      uid: true, url: true, mimeType: true,
+    },
+  });
+}
+```
+
+Only look up a UID after checking that a page contains an asset. Lookup returns
+`null` for missing, archived, unlinked, or other-brand assets. Transform fields
+may be null while processing is pending. Agents need `READ_MEDIA` for both reads.
+
+Agent sessions may also use `getPartnerUploadUrl` and `createPartnerMediaAsset`
+with `UPLOAD_MEDIA`. PUT the bytes to the returned presigned URL, then register
+with the exact returned `filename` and the caller-supplied `mimetype` and
+`dimensions`. Add both
+`idempotencyKey` and `toolCallId` (nonblank, at most 255 characters) to registration.
+Persist the filename and registration payload before registering; after an
+unknown result, retry that same payload and key rather than requesting a fresh
+upload key. Replays return the same asset UID. The backend checks object existence
+and brand ownership and records an audit entry. Partner-token callers must omit
+both audit identifiers and retain their existing upload flow.
+
+Deploy the backend media schema and migration before releasing this SDK contract.
+
+### Automatic operator CC for Eve
+
+Agent-session email callers first query `getPartnerAgentEmailContext { operatorCcEmail }`, show that address with every email draft, and include `operatorCcEmail` in `SendPartnerAgentEmailInput` after approval. The backend verifies it against the authenticated admin, snapshots it on the batch, and CCs that address on each message. When the operator is already the primary recipient, no duplicate CC is added. Read the approved snapshot through `BrandAgentEmailSendBatch.operatorCcEmail`. A changed operator address before queuing requires a revised draft and approval; queued retries retain the original address.
+
+Partner API-key callers cannot query operator context or supply operator CC. Existing partner sends and the brand Reply-To address retain their existing behavior.

package/dist/index.d.mts

@@ -654,7 +654,12 @@ interface BrandAgentEmailSendMessage {
     lastErrorMessage: (Scalars['String'] | null);
     __typename: 'BrandAgentEmailSendMessage';
 }
+interface BrandAgentEmailContext {
+    operatorCcEmail: Scalars['String'];
+    __typename: 'BrandAgentEmailContext';
+}
 interface BrandAgentEmailSendBatch {
+    operatorCcEmail: (Scalars['String'] | null);
     uid: Scalars['String'];
     createdAt: Scalars['DateTime'];
     status: BrandAgentEmailSendBatchStatus;
@@ -674,7 +679,20 @@ interface AgentThreadSeedContext {
     truncated: Scalars['Boolean'];
     __typename: 'AgentThreadSeedContext';
 }
+interface GetPartnerMediaAssetsResponse {
+    mediaAssets: MediaAsset[];
+    totalCount: Scalars['Int'];
+    hasNextPage: Scalars['Boolean'];
+    nextCursor: (Scalars['String'] | null);
+    __typename: 'GetPartnerMediaAssetsResponse';
+}
 interface Query {
+    /** Get the authenticated agent operator email for the approval preview. Requires a brand-agent session with SEND_EMAIL; unavailable to partner API keys. */
+    getPartnerAgentEmailContext: BrandAgentEmailContext;
+    /** Active brand-linked assets, newest first. Defaults to 50, capped at 100. READ_MEDIA for agents. */
+    getPartnerMediaAssets: GetPartnerMediaAssetsResponse;
+    /** An active asset linked to the caller's brand; null when unavailable. READ_MEDIA for agents. */
+    getPartnerMediaAsset: (MediaAsset | null);
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand: PartnerBrand;
     /** Retrieve one AgentMail send batch owned by the authenticated partner brand. */
@@ -772,10 +790,19 @@ interface MediaAsset {
     size: Scalars['Int'];
     placeholderUrl: (Scalars['String'] | null);
     blurhash: (Scalars['String'] | null);
+    transforms: (Transforms | null);
     createdAt: Scalars['DateTime'];
     updatedAt: Scalars['DateTime'];
     __typename: 'MediaAsset';
 }
+interface Transforms {
+    original: Scalars['String'];
+    small: (Scalars['String'] | null);
+    medium: (Scalars['String'] | null);
+    large: (Scalars['String'] | null);
+    hls: (Scalars['String'] | null);
+    __typename: 'Transforms';
+}
 interface CreatePartnerBrandSubscriptionResponse {
     subscription: (BrandSubscription | null);
     verificationRequired: Scalars['Boolean'];
@@ -1546,7 +1573,13 @@ interface BrandAgentEmailSendMessageGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface BrandAgentEmailContextGenqlSelection {
+    operatorCcEmail?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface BrandAgentEmailSendBatchGenqlSelection {
+    operatorCcEmail?: boolean | number;
     uid?: boolean | number;
     createdAt?: boolean | number;
     status?: boolean | number;
@@ -1568,7 +1601,35 @@ interface AgentThreadSeedContextGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface GetPartnerMediaAssetsInput {
+    cursor?: (Scalars['String'] | null);
+    take?: (Scalars['Int'] | null);
+    /** Case-insensitive MIME prefix, for example image/ or application/pdf. */
+    mimeTypePrefix?: (Scalars['String'] | null);
+}
+interface GetPartnerMediaAssetsResponseGenqlSelection {
+    mediaAssets?: MediaAssetGenqlSelection;
+    totalCount?: boolean | number;
+    hasNextPage?: boolean | number;
+    nextCursor?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface QueryGenqlSelection {
+    /** Get the authenticated agent operator email for the approval preview. Requires a brand-agent session with SEND_EMAIL; unavailable to partner API keys. */
+    getPartnerAgentEmailContext?: BrandAgentEmailContextGenqlSelection;
+    /** Active brand-linked assets, newest first. Defaults to 50, capped at 100. READ_MEDIA for agents. */
+    getPartnerMediaAssets?: (GetPartnerMediaAssetsResponseGenqlSelection & {
+        __args: {
+            input: GetPartnerMediaAssetsInput;
+        };
+    });
+    /** An active asset linked to the caller's brand; null when unavailable. READ_MEDIA for agents. */
+    getPartnerMediaAsset?: (MediaAssetGenqlSelection & {
+        __args: {
+            uid: Scalars['String'];
+        };
+    });
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand?: PartnerBrandGenqlSelection;
     /** Retrieve one AgentMail send batch owned by the authenticated partner brand. */
@@ -1744,6 +1805,8 @@ interface BrandAgentEmailMessageInput {
     text: Scalars['String'];
 }
 interface SendPartnerAgentEmailInput {
+    /** Required for agent callers: operator CC from getPartnerAgentEmailContext, shown in the approved draft. Partner callers cannot set this. */
+    operatorCcEmail?: (Scalars['String'] | null);
     /** Stable business idempotency key for this logical batch. */
     idempotencyKey: Scalars['String'];
     /** One to ten personalized, single-recipient plain-text emails. */
@@ -2009,11 +2072,21 @@ interface MediaAssetGenqlSelection {
     size?: boolean | number;
     placeholderUrl?: boolean | number;
     blurhash?: boolean | number;
+    transforms?: TransformsGenqlSelection;
     createdAt?: boolean | number;
     updatedAt?: boolean | number;
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface TransformsGenqlSelection {
+    original?: boolean | number;
+    small?: boolean | number;
+    medium?: boolean | number;
+    large?: boolean | number;
+    hls?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface CreatePartnerBrandSubscriptionResponseGenqlSelection {
     subscription?: BrandSubscriptionGenqlSelection;
     verificationRequired?: boolean | number;
@@ -2041,6 +2114,10 @@ interface MutationGenqlSelection {
             mimetype: Scalars['String'];
             filename: Scalars['String'];
             dimensions: DimensionsInput;
+            /** Required for agent sessions; omit for partner tokens. Reuse with the same upload payload on retry. */
+            idempotencyKey?: (Scalars['String'] | null);
+            /** Required for agent sessions; omit for partner tokens. */
+            toolCallId?: (Scalars['String'] | null);
         };
     });
     /**
@@ -2300,4 +2377,4 @@ type ITMPartnerClient = Client;
  */
 declare function createITMPartnerClient(config: ITMPartnerClientConfig): ITMPartnerClient;
 
-export { type AgentThreadSeedContext, type ApplyDynamicPricingInput, type BrandAgentEmailMessageInput, type BrandAgentEmailSendBatch, type BrandAgentEmailSendBatchStatus, type BrandAgentEmailSendMessage, type BrandAgentEmailSendMessageStatus, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type ConsentStatus, 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, GenqlError, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetMomentTagAssignmentsResponse, type GetPartnerAudienceInput, type GetPartnerAudienceResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerAgentAccessConfig, type ITMPartnerAgentAccessCredentials, type ITMPartnerAgentSessionConfig, type ITMPartnerAgentSessionCredentials, type ITMPartnerClient, type ITMPartnerClientConfig, type ITMPartnerHeaders, type ITMPartnerHeadersObject, type ITMPartnerTokenConfig, 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 MomentTagAssignment, type MomentType, type MusicReleaseType, type Mutation, type PaginationInput, type PartnerAudienceCustomer, type PartnerAudienceFiltersInput, type PartnerAudienceSortField, type PartnerAudienceSortInput, 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 SortDirection, type SubscriptionComplianceInput, type Tag, type TagSource, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type UserSource, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };
+export { type AgentThreadSeedContext, type ApplyDynamicPricingInput, type BrandAgentEmailMessageInput, type BrandAgentEmailSendBatch, type BrandAgentEmailSendBatchStatus, type BrandAgentEmailSendMessage, type BrandAgentEmailSendMessageStatus, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type ConsentStatus, 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, GenqlError, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetMomentTagAssignmentsResponse, type GetPartnerAudienceInput, type GetPartnerAudienceResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerMediaAssetsInput, type GetPartnerMediaAssetsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerAgentAccessConfig, type ITMPartnerAgentAccessCredentials, type ITMPartnerAgentSessionConfig, type ITMPartnerAgentSessionCredentials, type ITMPartnerClient, type ITMPartnerClientConfig, type ITMPartnerHeaders, type ITMPartnerHeadersObject, type ITMPartnerTokenConfig, 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 MomentTagAssignment, type MomentType, type MusicReleaseType, type Mutation, type PaginationInput, type PartnerAudienceCustomer, type PartnerAudienceFiltersInput, type PartnerAudienceSortField, type PartnerAudienceSortInput, 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 SortDirection, type SubscriptionComplianceInput, type Tag, type TagSource, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type Transforms, type User, type UserSource, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };

package/dist/index.d.ts

@@ -654,7 +654,12 @@ interface BrandAgentEmailSendMessage {
     lastErrorMessage: (Scalars['String'] | null);
     __typename: 'BrandAgentEmailSendMessage';
 }
+interface BrandAgentEmailContext {
+    operatorCcEmail: Scalars['String'];
+    __typename: 'BrandAgentEmailContext';
+}
 interface BrandAgentEmailSendBatch {
+    operatorCcEmail: (Scalars['String'] | null);
     uid: Scalars['String'];
     createdAt: Scalars['DateTime'];
     status: BrandAgentEmailSendBatchStatus;
@@ -674,7 +679,20 @@ interface AgentThreadSeedContext {
     truncated: Scalars['Boolean'];
     __typename: 'AgentThreadSeedContext';
 }
+interface GetPartnerMediaAssetsResponse {
+    mediaAssets: MediaAsset[];
+    totalCount: Scalars['Int'];
+    hasNextPage: Scalars['Boolean'];
+    nextCursor: (Scalars['String'] | null);
+    __typename: 'GetPartnerMediaAssetsResponse';
+}
 interface Query {
+    /** Get the authenticated agent operator email for the approval preview. Requires a brand-agent session with SEND_EMAIL; unavailable to partner API keys. */
+    getPartnerAgentEmailContext: BrandAgentEmailContext;
+    /** Active brand-linked assets, newest first. Defaults to 50, capped at 100. READ_MEDIA for agents. */
+    getPartnerMediaAssets: GetPartnerMediaAssetsResponse;
+    /** An active asset linked to the caller's brand; null when unavailable. READ_MEDIA for agents. */
+    getPartnerMediaAsset: (MediaAsset | null);
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand: PartnerBrand;
     /** Retrieve one AgentMail send batch owned by the authenticated partner brand. */
@@ -772,10 +790,19 @@ interface MediaAsset {
     size: Scalars['Int'];
     placeholderUrl: (Scalars['String'] | null);
     blurhash: (Scalars['String'] | null);
+    transforms: (Transforms | null);
     createdAt: Scalars['DateTime'];
     updatedAt: Scalars['DateTime'];
     __typename: 'MediaAsset';
 }
+interface Transforms {
+    original: Scalars['String'];
+    small: (Scalars['String'] | null);
+    medium: (Scalars['String'] | null);
+    large: (Scalars['String'] | null);
+    hls: (Scalars['String'] | null);
+    __typename: 'Transforms';
+}
 interface CreatePartnerBrandSubscriptionResponse {
     subscription: (BrandSubscription | null);
     verificationRequired: Scalars['Boolean'];
@@ -1546,7 +1573,13 @@ interface BrandAgentEmailSendMessageGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface BrandAgentEmailContextGenqlSelection {
+    operatorCcEmail?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface BrandAgentEmailSendBatchGenqlSelection {
+    operatorCcEmail?: boolean | number;
     uid?: boolean | number;
     createdAt?: boolean | number;
     status?: boolean | number;
@@ -1568,7 +1601,35 @@ interface AgentThreadSeedContextGenqlSelection {
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface GetPartnerMediaAssetsInput {
+    cursor?: (Scalars['String'] | null);
+    take?: (Scalars['Int'] | null);
+    /** Case-insensitive MIME prefix, for example image/ or application/pdf. */
+    mimeTypePrefix?: (Scalars['String'] | null);
+}
+interface GetPartnerMediaAssetsResponseGenqlSelection {
+    mediaAssets?: MediaAssetGenqlSelection;
+    totalCount?: boolean | number;
+    hasNextPage?: boolean | number;
+    nextCursor?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface QueryGenqlSelection {
+    /** Get the authenticated agent operator email for the approval preview. Requires a brand-agent session with SEND_EMAIL; unavailable to partner API keys. */
+    getPartnerAgentEmailContext?: BrandAgentEmailContextGenqlSelection;
+    /** Active brand-linked assets, newest first. Defaults to 50, capped at 100. READ_MEDIA for agents. */
+    getPartnerMediaAssets?: (GetPartnerMediaAssetsResponseGenqlSelection & {
+        __args: {
+            input: GetPartnerMediaAssetsInput;
+        };
+    });
+    /** An active asset linked to the caller's brand; null when unavailable. READ_MEDIA for agents. */
+    getPartnerMediaAsset?: (MediaAssetGenqlSelection & {
+        __args: {
+            uid: Scalars['String'];
+        };
+    });
     /** Get details for the brand associated with the partner token. */
     getPartnerBrand?: PartnerBrandGenqlSelection;
     /** Retrieve one AgentMail send batch owned by the authenticated partner brand. */
@@ -1744,6 +1805,8 @@ interface BrandAgentEmailMessageInput {
     text: Scalars['String'];
 }
 interface SendPartnerAgentEmailInput {
+    /** Required for agent callers: operator CC from getPartnerAgentEmailContext, shown in the approved draft. Partner callers cannot set this. */
+    operatorCcEmail?: (Scalars['String'] | null);
     /** Stable business idempotency key for this logical batch. */
     idempotencyKey: Scalars['String'];
     /** One to ten personalized, single-recipient plain-text emails. */
@@ -2009,11 +2072,21 @@ interface MediaAssetGenqlSelection {
     size?: boolean | number;
     placeholderUrl?: boolean | number;
     blurhash?: boolean | number;
+    transforms?: TransformsGenqlSelection;
     createdAt?: boolean | number;
     updatedAt?: boolean | number;
     __typename?: boolean | number;
     __scalar?: boolean | number;
 }
+interface TransformsGenqlSelection {
+    original?: boolean | number;
+    small?: boolean | number;
+    medium?: boolean | number;
+    large?: boolean | number;
+    hls?: boolean | number;
+    __typename?: boolean | number;
+    __scalar?: boolean | number;
+}
 interface CreatePartnerBrandSubscriptionResponseGenqlSelection {
     subscription?: BrandSubscriptionGenqlSelection;
     verificationRequired?: boolean | number;
@@ -2041,6 +2114,10 @@ interface MutationGenqlSelection {
             mimetype: Scalars['String'];
             filename: Scalars['String'];
             dimensions: DimensionsInput;
+            /** Required for agent sessions; omit for partner tokens. Reuse with the same upload payload on retry. */
+            idempotencyKey?: (Scalars['String'] | null);
+            /** Required for agent sessions; omit for partner tokens. */
+            toolCallId?: (Scalars['String'] | null);
         };
     });
     /**
@@ -2300,4 +2377,4 @@ type ITMPartnerClient = Client;
  */
 declare function createITMPartnerClient(config: ITMPartnerClientConfig): ITMPartnerClient;
 
-export { type AgentThreadSeedContext, type ApplyDynamicPricingInput, type BrandAgentEmailMessageInput, type BrandAgentEmailSendBatch, type BrandAgentEmailSendBatchStatus, type BrandAgentEmailSendMessage, type BrandAgentEmailSendMessageStatus, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type ConsentStatus, 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, GenqlError, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetMomentTagAssignmentsResponse, type GetPartnerAudienceInput, type GetPartnerAudienceResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerAgentAccessConfig, type ITMPartnerAgentAccessCredentials, type ITMPartnerAgentSessionConfig, type ITMPartnerAgentSessionCredentials, type ITMPartnerClient, type ITMPartnerClientConfig, type ITMPartnerHeaders, type ITMPartnerHeadersObject, type ITMPartnerTokenConfig, 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 MomentTagAssignment, type MomentType, type MusicReleaseType, type Mutation, type PaginationInput, type PartnerAudienceCustomer, type PartnerAudienceFiltersInput, type PartnerAudienceSortField, type PartnerAudienceSortInput, 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 SortDirection, type SubscriptionComplianceInput, type Tag, type TagSource, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type User, type UserSource, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };
+export { type AgentThreadSeedContext, type ApplyDynamicPricingInput, type BrandAgentEmailMessageInput, type BrandAgentEmailSendBatch, type BrandAgentEmailSendBatchStatus, type BrandAgentEmailSendMessage, type BrandAgentEmailSendMessageStatus, type BrandDrop, type BrandDropCtaType, type BrandDropMusicLink, type BrandSubscription, type ConsentStatus, 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, GenqlError, type GetBrandEchoesForUserResponse, type GetMomentLineupsResponse, type GetMomentTagAssignmentsResponse, type GetPartnerAudienceInput, type GetPartnerAudienceResponse, type GetPartnerCustomersResponse, type GetPartnerDropsResponse, type GetPartnerMediaAssetsInput, type GetPartnerMediaAssetsResponse, type GetPartnerTicketTiersForMomentInput, type GetPartnerTicketTiersForMomentResponse, type GetPublicMomentsResponse, type GetTicketsResponse, type ITMPartnerAgentAccessConfig, type ITMPartnerAgentAccessCredentials, type ITMPartnerAgentSessionConfig, type ITMPartnerAgentSessionCredentials, type ITMPartnerClient, type ITMPartnerClientConfig, type ITMPartnerHeaders, type ITMPartnerHeadersObject, type ITMPartnerTokenConfig, 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 MomentTagAssignment, type MomentType, type MusicReleaseType, type Mutation, type PaginationInput, type PartnerAudienceCustomer, type PartnerAudienceFiltersInput, type PartnerAudienceSortField, type PartnerAudienceSortInput, 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 SortDirection, type SubscriptionComplianceInput, type Tag, type TagSource, type ThirdPartyEchoType, type Ticket, type TicketAdmissionWindowSource, type TicketAttendanceMode, type TicketExtension, type TicketExtensionStatus, type TicketTier, type Transforms, type User, type UserSource, type Venue, type VenueInput, type VerifyPartnerBrandSubscriptionInput, createITMPartnerClient, everything, generateMutationOp, generateQueryOp };