@artsy/cohesion 4.403.0 → 4.405.0--canary.751.16435.0

package/CHANGELOG.md

@@ -1,15 +1,3 @@
-# v4.403.0 (Mon Sep 21 2026)
-
-#### 🚀  Enhancement
-
-- feat: add OwnerType.cityGuide for the City Guide home screen [#752](https://github.com/artsy/cohesion/pull/752) ([@MounirDhahri](https://github.com/MounirDhahri))
-
-#### Authors: 1
-
-- Mounir Dhahri ([@MounirDhahri](https://github.com/MounirDhahri))
-
----
-
 # v4.402.0 (Fri Sep 18 2026)
 
 #### 🚀  Enhancement

package/dist/Schema/Values/OwnerType.d.ts

@@ -54,7 +54,6 @@ export declare enum OwnerType {
     basedOnYourRecentSaves = "basedOnYourRecentSaves",
     brandSettings = "brandSettings",
     category = "category",
-    cityGuide = "cityGuide",
     cityGuideGuide = "cityGuideGuide",
     cityGuideMap = "cityGuideMap",
     cityPicker = "cityPicker",
@@ -184,7 +183,7 @@ export declare enum OwnerType {
 /**
  * Owner types available in iOS/Android
  */
-export type ScreenOwnerType = OwnerType.about | OwnerType.account | OwnerType.accountDarkMode | OwnerType.accountDeleteMyAccount | OwnerType.accountEmail | OwnerType.accountLoginAndSecurity | OwnerType.accountNotifications | OwnerType.accountOrders | OwnerType.accountPassword | OwnerType.accountPayment | OwnerType.accountAddPayment | OwnerType.accountPersonalDataRequest | OwnerType.accountPhoneNumber | OwnerType.accountPreferences | OwnerType.accountPriceRange | OwnerType.accountPrivacy | OwnerType.accountSettings | OwnerType.accountTermsAndConditions | OwnerType.activities | OwnerType.activity | OwnerType.album | OwnerType.alertConfirmation | OwnerType.alertDetails | OwnerType.alertFilters | OwnerType.alerts | OwnerType.alert | OwnerType.alertsInfoModal | OwnerType.allArtistSeries | OwnerType.artAssistant | OwnerType.article | OwnerType.articles | OwnerType.artist | OwnerType.artistArticles | OwnerType.artistAuctionResults | OwnerType.artistSeries | OwnerType.artwork | OwnerType.artworkList | OwnerType.artworkPriceFilter | OwnerType.artworkRecommendations | OwnerType.auctionResult | OwnerType.auctionResultsForArtistsYouFollow | OwnerType.auctions | OwnerType.auctionsOverview | OwnerType.authModal | OwnerType.basedOnYourRecentSaves | OwnerType.category | OwnerType.cityGuide | OwnerType.cityGuideGuide | OwnerType.cityGuideMap | OwnerType.cityPicker | OwnerType.collect | OwnerType.collection | OwnerType.collectionsCategory | OwnerType.confirmYourBid | OwnerType.consign | OwnerType.consignmentFlow | OwnerType.consignmentInquiry | OwnerType.consignmentSubmission | OwnerType.conversation | OwnerType.conversationMakeOfferConfirmArtwork | OwnerType.createAlert | OwnerType.editAlert | OwnerType.editProfile | OwnerType.explore | OwnerType.fair | OwnerType.fairArtworks | OwnerType.favorites | OwnerType.favoritesAlerts | OwnerType.favoritesFollows | OwnerType.favoritesSaves | OwnerType.featuredFairs | OwnerType.follows | OwnerType.gallery | OwnerType.galleriesForYou | OwnerType.gene | OwnerType.home | OwnerType.inbox | OwnerType.inboxBids | OwnerType.inboxConversation | OwnerType.inboxInquiries | OwnerType.infiniteDiscoveryArtwork | OwnerType.infiniteDiscoveryArtist | OwnerType.infiniteDiscoveryOnboarding | OwnerType.lotsByArtistsYouFollow | OwnerType.lotsForYou | OwnerType.marketNews | OwnerType.marketingCollection | OwnerType.myCollection | OwnerType.myCollectionAddArtworkArtist | OwnerType.myCollectionArtwork | OwnerType.myCollectionArtwork | OwnerType.myCollectionArtworkAbout | OwnerType.myCollectionArtworkInsights | OwnerType.myCollectionInsights | OwnerType.myCollectionInsightsMedianAuctionPrice | OwnerType.myCollectionOnboarding | OwnerType.newWorksForYou | OwnerType.newWorksFromGalleriesYouFollow | OwnerType.notification | OwnerType.onboarding | OwnerType.ordersDetail | OwnerType.partner | OwnerType.priceDatabase | OwnerType.profile | OwnerType.quickLinks | OwnerType.recentlyViewed | OwnerType.sale | OwnerType.saleInformation | OwnerType.savedSearch | OwnerType.savedSearches | OwnerType.savedSearchArtworkMatches | OwnerType.saves | OwnerType.savesAndFollows | OwnerType.savesInfoModal | OwnerType.search | OwnerType.searchByImage | OwnerType.sell | OwnerType.settings | OwnerType.show | OwnerType.shows | OwnerType.similarToRecentlyViewed | OwnerType.submitArtworkStepAddDetails | OwnerType.submitArtworkStepAddDimensions | OwnerType.submitArtworkStepAddPhoneNumber | OwnerType.submitArtworkStepAddPhotos | OwnerType.submitArtworkStepAddtionalDocuments | OwnerType.submitArtworkStepAddTitle | OwnerType.submitArtworkStepArtistRejected | OwnerType.submitArtworkStepCompleteYourSubmission | OwnerType.submitArtworkStepCompleteYourSubmissionPostApproval | OwnerType.submitArtworkStepCondition | OwnerType.submitArtworkStepFrameInformation | OwnerType.submitArtworkStepPurchaseHistory | OwnerType.submitArtworkStepSelectArtist | OwnerType.submitArtworkStepSelectArtworkMyCollectionArtwork | OwnerType.submitArtworkStepShippingLocation | OwnerType.submitArtworkStepStart | OwnerType.tag | OwnerType.upcomingAuctions | OwnerType.viewingRoom | OwnerType.viewingRoomArtworkPage | OwnerType.viewingRoomArtworks | OwnerType.viewingRoomList | OwnerType.worksForYou | OwnerType.yourMaxBid;
+export type ScreenOwnerType = OwnerType.about | OwnerType.account | OwnerType.accountDarkMode | OwnerType.accountDeleteMyAccount | OwnerType.accountEmail | OwnerType.accountLoginAndSecurity | OwnerType.accountNotifications | OwnerType.accountOrders | OwnerType.accountPassword | OwnerType.accountPayment | OwnerType.accountAddPayment | OwnerType.accountPersonalDataRequest | OwnerType.accountPhoneNumber | OwnerType.accountPreferences | OwnerType.accountPriceRange | OwnerType.accountPrivacy | OwnerType.accountSettings | OwnerType.accountTermsAndConditions | OwnerType.activities | OwnerType.activity | OwnerType.album | OwnerType.alertConfirmation | OwnerType.alertDetails | OwnerType.alertFilters | OwnerType.alerts | OwnerType.alert | OwnerType.alertsInfoModal | OwnerType.allArtistSeries | OwnerType.artAssistant | OwnerType.article | OwnerType.articles | OwnerType.artist | OwnerType.artistArticles | OwnerType.artistAuctionResults | OwnerType.artistSeries | OwnerType.artwork | OwnerType.artworkList | OwnerType.artworkPriceFilter | OwnerType.artworkRecommendations | OwnerType.auctionResult | OwnerType.auctionResultsForArtistsYouFollow | OwnerType.auctions | OwnerType.auctionsOverview | OwnerType.authModal | OwnerType.basedOnYourRecentSaves | OwnerType.category | OwnerType.cityGuideGuide | OwnerType.cityGuideMap | OwnerType.cityPicker | OwnerType.collect | OwnerType.collection | OwnerType.collectionsCategory | OwnerType.confirmYourBid | OwnerType.consign | OwnerType.consignmentFlow | OwnerType.consignmentInquiry | OwnerType.consignmentSubmission | OwnerType.conversation | OwnerType.conversationMakeOfferConfirmArtwork | OwnerType.createAlert | OwnerType.editAlert | OwnerType.editProfile | OwnerType.explore | OwnerType.fair | OwnerType.fairArtworks | OwnerType.favorites | OwnerType.favoritesAlerts | OwnerType.favoritesFollows | OwnerType.favoritesSaves | OwnerType.featuredFairs | OwnerType.follows | OwnerType.gallery | OwnerType.galleriesForYou | OwnerType.gene | OwnerType.home | OwnerType.inbox | OwnerType.inboxBids | OwnerType.inboxConversation | OwnerType.inboxInquiries | OwnerType.infiniteDiscoveryArtwork | OwnerType.infiniteDiscoveryArtist | OwnerType.infiniteDiscoveryOnboarding | OwnerType.lotsByArtistsYouFollow | OwnerType.lotsForYou | OwnerType.marketNews | OwnerType.marketingCollection | OwnerType.myCollection | OwnerType.myCollectionAddArtworkArtist | OwnerType.myCollectionArtwork | OwnerType.myCollectionArtwork | OwnerType.myCollectionArtworkAbout | OwnerType.myCollectionArtworkInsights | OwnerType.myCollectionInsights | OwnerType.myCollectionInsightsMedianAuctionPrice | OwnerType.myCollectionOnboarding | OwnerType.newWorksForYou | OwnerType.newWorksFromGalleriesYouFollow | OwnerType.notification | OwnerType.onboarding | OwnerType.ordersDetail | OwnerType.partner | OwnerType.priceDatabase | OwnerType.profile | OwnerType.quickLinks | OwnerType.recentlyViewed | OwnerType.sale | OwnerType.saleInformation | OwnerType.savedSearch | OwnerType.savedSearches | OwnerType.savedSearchArtworkMatches | OwnerType.saves | OwnerType.savesAndFollows | OwnerType.savesInfoModal | OwnerType.search | OwnerType.searchByImage | OwnerType.sell | OwnerType.settings | OwnerType.show | OwnerType.shows | OwnerType.similarToRecentlyViewed | OwnerType.submitArtworkStepAddDetails | OwnerType.submitArtworkStepAddDimensions | OwnerType.submitArtworkStepAddPhoneNumber | OwnerType.submitArtworkStepAddPhotos | OwnerType.submitArtworkStepAddtionalDocuments | OwnerType.submitArtworkStepAddTitle | OwnerType.submitArtworkStepArtistRejected | OwnerType.submitArtworkStepCompleteYourSubmission | OwnerType.submitArtworkStepCompleteYourSubmissionPostApproval | OwnerType.submitArtworkStepCondition | OwnerType.submitArtworkStepFrameInformation | OwnerType.submitArtworkStepPurchaseHistory | OwnerType.submitArtworkStepSelectArtist | OwnerType.submitArtworkStepSelectArtworkMyCollectionArtwork | OwnerType.submitArtworkStepShippingLocation | OwnerType.submitArtworkStepStart | OwnerType.tag | OwnerType.upcomingAuctions | OwnerType.viewingRoom | OwnerType.viewingRoomArtworkPage | OwnerType.viewingRoomArtworks | OwnerType.viewingRoomList | OwnerType.worksForYou | OwnerType.yourMaxBid;
 /**
  * Owner types available in web/mobile web
  */

package/dist/Schema/Values/OwnerType.js

@@ -72,7 +72,6 @@ exports.OwnerType = OwnerType;
   OwnerType["basedOnYourRecentSaves"] = "basedOnYourRecentSaves";
   OwnerType["brandSettings"] = "brandSettings";
   OwnerType["category"] = "category";
-  OwnerType["cityGuide"] = "cityGuide";
   OwnerType["cityGuideGuide"] = "cityGuideGuide";
   OwnerType["cityGuideMap"] = "cityGuideMap";
   OwnerType["cityPicker"] = "cityPicker";

package/dist/Schema/os/Events/InventoryTable.d.ts

@@ -154,6 +154,156 @@ export interface OsEditedArtworkField {
     /** Artist and location only: the resolved Artsy entity ID */
     matched_id?: string;
 }
+/**
+ * A partner clicks the Writing Assistant button on a description cell to open the
+ * AI description drawer.
+ *
+ * This schema describes events sent to Segment from [[OsClickedWritingAssistant]]
+ *
+ * @example
+ * ```
+ * {
+ *   action: "clickedWritingAssistant",
+ *   context_module: "artworkTable",
+ *   context_page_owner_type: "inventory",
+ *   artwork_id: "abc123"
+ * }
+ * ```
+ */
+export interface OsClickedWritingAssistant {
+    action: OsActionType.clickedWritingAssistant;
+    context_module: OsContextModule.artworkTable;
+    context_page_owner_type: OsOwnerType;
+    artwork_id: string;
+}
+/**
+ * A partner clicks "Add Description" in the Writing Assistant drawer, applying the
+ * generated (and possibly edited) description to the description cell.
+ *
+ * This schema describes events sent to Segment from [[OsAddedGeneratedArtworkDescription]]
+ *
+ * @example
+ * ```
+ * {
+ *   action: "addedGeneratedArtworkDescription",
+ *   context_module: "writingAssistantDrawer",
+ *   context_page_owner_type: "inventory",
+ *   artwork_id: "abc123",
+ *   regenerate_count: 2,
+ *   was_edited: true,
+ *   document_count: 1,
+ *   generated_description: "A vibrant abstract composition..."
+ * }
+ * ```
+ */
+export interface OsAddedGeneratedArtworkDescription {
+    action: OsActionType.addedGeneratedArtworkDescription;
+    context_module: OsContextModule.writingAssistantDrawer;
+    context_page_owner_type: OsOwnerType;
+    artwork_id: string;
+    /** Number of times the partner clicked Regenerate (excludes automatic regenerations triggered by adding/removing a document) */
+    regenerate_count: number;
+    /** Whether the final text differs from the last generated text */
+    was_edited: boolean;
+    /** Number of supporting documents attached at the time of adding the description */
+    document_count: number;
+    /** The raw AI-generated text, before any edits the partner made */
+    generated_description: string;
+}
+/**
+ * A partner closes the Writing Assistant drawer without adding the generated description,
+ * via the Cancel button, the X, the backdrop, or Escape.
+ *
+ * This schema describes events sent to Segment from [[OsClosedWritingAssistant]]
+ *
+ * @example
+ * ```
+ * {
+ *   action: "closedWritingAssistant",
+ *   context_module: "writingAssistantDrawer",
+ *   context_page_owner_type: "inventory",
+ *   artwork_id: "abc123",
+ *   value: "cancel",
+ *   regenerate_count: 2,
+ *   was_edited: true,
+ *   document_count: 1,
+ *   generated_description: "A vibrant abstract composition..."
+ * }
+ * ```
+ */
+export interface OsClosedWritingAssistant {
+    action: OsActionType.closedWritingAssistant;
+    context_module: OsContextModule.writingAssistantDrawer;
+    context_page_owner_type: OsOwnerType;
+    artwork_id: string;
+    /** "cancel" = Cancel button, "close" = X, backdrop, or Escape */
+    value: "cancel" | "close";
+    /** Number of times the partner clicked Regenerate (excludes automatic regenerations triggered by adding/removing a document) */
+    regenerate_count: number;
+    /** Whether the discarded text differs from the last generated text */
+    was_edited: boolean;
+    /** Number of supporting documents attached when the drawer was closed */
+    document_count: number;
+    /** The raw AI-generated text that was discarded */
+    generated_description: string;
+}
+/**
+ * A partner rates a generated description as helpful or not, via the thumbs feedback
+ * shown below the text in the Writing Assistant drawer. Fires once the follow-up detail
+ * modal resolves (Send, Skip, or close) — `detail` is the optional free text the partner
+ * added, or an empty string if they skipped or closed without typing anything.
+ *
+ * This schema describes events sent to Segment from [[OsRatedGeneratedArtworkDescription]]
+ *
+ * @example
+ * ```
+ * {
+ *   action: "ratedGeneratedArtworkDescription",
+ *   context_module: "writingAssistantDrawer",
+ *   context_page_owner_type: "inventory",
+ *   artwork_id: "abc123",
+ *   value: "up",
+ *   detail: "",
+ *   regenerate_count: 2,
+ *   was_edited: false,
+ *   document_count: 1,
+ *   generated_description: "A vibrant abstract composition..."
+ * }
+ * ```
+ *
+ * @example With optional detail text
+ * ```
+ * {
+ *   action: "ratedGeneratedArtworkDescription",
+ *   context_module: "writingAssistantDrawer",
+ *   context_page_owner_type: "inventory",
+ *   artwork_id: "abc123",
+ *   value: "down",
+ *   detail: "Too generic, didn't mention the material",
+ *   regenerate_count: 0,
+ *   was_edited: false,
+ *   document_count: 0,
+ *   generated_description: "A vibrant abstract composition..."
+ * }
+ * ```
+ */
+export interface OsRatedGeneratedArtworkDescription {
+    action: OsActionType.ratedGeneratedArtworkDescription;
+    context_module: OsContextModule.writingAssistantDrawer;
+    context_page_owner_type: OsOwnerType;
+    artwork_id: string;
+    value: "up" | "down";
+    /** Optional free text the partner added in the follow-up modal; empty string if skipped or closed without typing */
+    detail: string;
+    /** Number of times the partner clicked Regenerate (excludes automatic regenerations triggered by adding/removing a document) */
+    regenerate_count: number;
+    /** Whether the rated text differs from the last generated text */
+    was_edited: boolean;
+    /** Number of supporting documents attached at the time of rating */
+    document_count: number;
+    /** The raw AI-generated text being rated */
+    generated_description: string;
+}
 /**
  * A partner successfully adds a new location via the Add Location modal (2-step flow).
  * Fires on useCreatePartnerLocation mutation success.
@@ -267,10 +417,22 @@ export interface OsSavedArtworkImages {
  *   document_count: 3
  * }
  * ```
+ *
+ * @example Uploaded from the Writing Assistant drawer
+ * ```
+ * {
+ *   action: "addedArtworkDocument",
+ *   context_module: "writingAssistantDrawer",
+ *   context_page_owner_type: "inventory",
+ *   artwork_id: "abc123",
+ *   document_count: 1,
+ *   value: { type: "pdf", size: "1.2MB" }
+ * }
+ * ```
  */
 export interface OsAddedArtworkDocument {
     action: OsActionType.addedArtworkDocument;
-    context_module: OsContextModule.documentsModal;
+    context_module: OsContextModule.documentsModal | OsContextModule.writingAssistantDrawer;
     context_page_owner_type: OsOwnerType;
     artwork_id: string;
     /** Document count after the upload */
@@ -422,4 +584,4 @@ export interface OsReorderedInventoryTableColumns {
     /** Full resulting column key order (reorderable columns only, pinned columns excluded) */
     new_order: string[];
 }
-export type OsInventoryTable = ChangedInventoryTableColumnVisibility | EditedInventoryField | OsAddedArtist | OsAddedArtworkDocument | OsAddedLocation | OsClickedActionsDropdown | OsClickedArtworkRow | OsClickedEditArtworkButton | OsClickedEditionSetRow | OsClickedImagesModal | OsEditedArtworkField | OsRemovedArtworkDocument | OsReorderedInventoryTableColumns | OsSavedArtworkImages;
+export type OsInventoryTable = ChangedInventoryTableColumnVisibility | EditedInventoryField | OsAddedArtist | OsAddedArtworkDocument | OsAddedGeneratedArtworkDescription | OsAddedLocation | OsClickedActionsDropdown | OsClickedArtworkRow | OsClickedEditArtworkButton | OsClickedEditionSetRow | OsClickedImagesModal | OsClickedWritingAssistant | OsClosedWritingAssistant | OsEditedArtworkField | OsRatedGeneratedArtworkDescription | OsRemovedArtworkDocument | OsReorderedInventoryTableColumns | OsSavedArtworkImages;

package/dist/Schema/os/Events/index.d.ts

@@ -39,6 +39,10 @@ export declare enum OsActionType {
      * Corresponds to {@link AddedArtworksToList}
      */
     addedArtworksToList = "addedArtworksToList",
+    /**
+     * Corresponds to {@link OsInventoryTable}
+     */
+    addedGeneratedArtworkDescription = "addedGeneratedArtworkDescription",
     /**
      * Corresponds to {@link OsInventoryTable}
      */
@@ -152,6 +156,14 @@ export declare enum OsActionType {
      * Corresponds to {@link OsInstagramEditor}
      */
     clickedUploadImageBank = "clickedUploadImageBank",
+    /**
+     * Corresponds to {@link OsInventoryTable}
+     */
+    clickedWritingAssistant = "clickedWritingAssistant",
+    /**
+     * Corresponds to {@link OsInventoryTable}
+     */
+    closedWritingAssistant = "closedWritingAssistant",
     /**
      * Corresponds to {@link CompletedArtworkDistribution}
      */
@@ -221,6 +233,10 @@ export declare enum OsActionType {
      * Corresponds to {@link ProgressedGettingStarted}
      */
     progressedOnboarding = "progressedOnboarding",
+    /**
+     * Corresponds to {@link OsInventoryTable}
+     */
+    ratedGeneratedArtworkDescription = "ratedGeneratedArtworkDescription",
     /**
      * Corresponds to {@link OsInventoryTable}
      */

package/dist/Schema/os/Events/index.js

@@ -24,6 +24,7 @@ exports.OsActionType = OsActionType;
   OsActionType["appliedFilter"] = "appliedFilter";
   OsActionType["addedArtworkDocument"] = "addedArtworkDocument";
   OsActionType["addedArtworksToList"] = "addedArtworksToList";
+  OsActionType["addedGeneratedArtworkDescription"] = "addedGeneratedArtworkDescription";
   OsActionType["addedLocation"] = "addedLocation";
   OsActionType["bulkEditedArtworks"] = "bulkEditedArtworks";
   OsActionType["cancelledArtworkImport"] = "cancelledArtworkImport";
@@ -53,6 +54,8 @@ exports.OsActionType = OsActionType;
   OsActionType["clickedShowMeHow"] = "clickedShowMeHow";
   OsActionType["clickedSendConfirmation"] = "clickedSendConfirmation";
   OsActionType["clickedUploadImageBank"] = "clickedUploadImageBank";
+  OsActionType["clickedWritingAssistant"] = "clickedWritingAssistant";
+  OsActionType["closedWritingAssistant"] = "closedWritingAssistant";
   OsActionType["completedArtworkDistribution"] = "completedArtworkDistribution";
   OsActionType["completedArtworkImport"] = "completedArtworkImport";
   OsActionType["completedOnboarding"] = "completedOnboarding";
@@ -70,6 +73,7 @@ exports.OsActionType = OsActionType;
   OsActionType["editedInventoryField"] = "editedInventoryField";
   OsActionType["movedArtworksBetweenLists"] = "movedArtworksBetweenLists";
   OsActionType["progressedOnboarding"] = "progressedOnboarding";
+  OsActionType["ratedGeneratedArtworkDescription"] = "ratedGeneratedArtworkDescription";
   OsActionType["removedArtworkDocument"] = "removedArtworkDocument";
   OsActionType["removedFilter"] = "removedFilter";
   OsActionType["removedArtworksFromList"] = "removedArtworksFromList";

package/dist/Schema/os/Values/OsContextModule.d.ts

@@ -39,5 +39,6 @@ export declare enum OsContextModule {
     privateViewingRoomEditor = "privateViewingRoomEditor",
     publishConfirmationModal = "publishConfirmationModal",
     sendConfirmationModal = "sendConfirmationModal",
-    tableActions = "tableActions"
+    tableActions = "tableActions",
+    writingAssistantDrawer = "writingAssistantDrawer"
 }

package/dist/Schema/os/Values/OsContextModule.js

@@ -50,4 +50,5 @@ exports.OsContextModule = OsContextModule;
   OsContextModule["publishConfirmationModal"] = "publishConfirmationModal";
   OsContextModule["sendConfirmationModal"] = "sendConfirmationModal";
   OsContextModule["tableActions"] = "tableActions";
+  OsContextModule["writingAssistantDrawer"] = "writingAssistantDrawer";
 })(OsContextModule || (exports.OsContextModule = OsContextModule = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artsy/cohesion",
-  "version": "4.403.0",
+  "version": "4.405.0--canary.751.16435.0",
   "description": "Analytics schema",
   "main": "dist/index.js",
   "publishConfig": {