@mesh-sync/worker-backend-client 4.0.9 → 4.0.15

package/README.md

@@ -163,6 +163,52 @@ Used for:
 
 
 
+### ekg-edge-batch-create-completed
+
+**Description:** Completion event for EKG edge batch creation with propagation results.
+
+**Method:** `client.ekgEdgeBatchCreateCompleted(data)`
+
+**Payload Type:** `EkgEdgeBatchCreateCompletedMessage`
+
+**Fields:**
+
+- `requestId` (string) [✓]: Original request ID from ekg-edge-batch-create-request
+
+- `success` (boolean) [✓]: Whether the batch operation succeeded
+
+- `statistics` (object) [✓]: Batch operation statistics
+
+- `conflicts` (array) [✗]: List of high-conflict edges requiring review
+
+- `errors` (array) [✗]: Errors encountered during processing
+
+- `graphMetrics` (object) [✗]: Overall graph state after this batch
+
+
+
+### ekg-edge-batch-create-request
+
+**Description:** Create multiple EKG edges with Dempster-Shafer mass functions. Triggered by metamodel detection completion.
+
+**Method:** `client.ekgEdgeBatchCreateRequest(data)`
+
+**Payload Type:** `EkgEdgeBatchCreateRequestMessage`
+
+**Fields:**
+
+- `requestId` (string) [✓]: Unique request ID for tracking (e.g., metamodel detection job ID)
+
+- `source` (string) [✓]: Source of the edges: metamodel-heuristic, manual, taxonomy-import, etc.
+
+- `edges` (array) [✓]: Batch of edges to create/update in the EKG
+
+- `propagationOptions` (object) [✗]: Options for evidential edge propagation after edge creation
+
+- `webhookUrl` (string) [✗]: Optional webhook URL for async completion notification
+
+
+
 ### etsy-analytics-sync-completed
 
 **Description:** Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
@@ -601,6 +647,60 @@ This is typically triggered after initial connection or periodically to keep mar
 
 
 
+### marketplace-listing-description-generation-completed
+
+**Description:** Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp).
+
+**Method:** `client.marketplaceListingDescriptionGenerationCompleted(data)`
+
+**Payload Type:** `MarketplaceListingDescriptionGenerationCompletedMessage`
+
+**Fields:**
+
+- `modelId` (string) [✓]: UUID of the model that was processed
+
+- `entityType` (string) [✓]: Type of entity processed
+
+- `description` (string) [✓]: SEO-optimized marketplace description (3-5 sentences)
+
+- `metadata` (object) [✓]: Content generation metadata for tracking
+
+- `error` (string) [✗]: Error message if generation failed
+
+
+
+### marketplace-listing-description-generation-request
+
+**Description:** Generates SEO-optimized marketplace description for a 3D model using LLM vision analysis. Worker receives model data, technical metadata, and thumbnail URLs to generate compelling product descriptions tailored to the target marketplace.
+
+**Method:** `client.marketplaceListingDescriptionGenerationRequest(data)`
+
+**Payload Type:** `MarketplaceListingDescriptionGenerationRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✓]: UUID of the model (reference only)
+
+- `entityType` (string) [✓]: Type of entity being processed
+
+- `entityName` (string) [✓]: Name/title of the model or metamodel
+
+- `targetMarketplace` (string) [✓]: Target marketplace ID (e.g., 'etsy', 'ebay', 'thingiverse')
+
+- `userId` (string) [✓]: UUID of the user requesting generation
+
+- `webhookUrl` (string) [✗]: Callback URL for completion notification
+
+- `technicalMetadata` (object) [✗]: Technical analysis data for context
+
+- `thumbnailUrls` (array) [✗]: URLs to 360-degree thumbnail views
+
+- `existingTags` (array) [✗]: Currently assigned tags for context
+
+- `existingCategory` (string) [✗]: Current classification for context
+
+
+
 ### marketplace-listing-sync-completed
 
 **Description:** Notification that marketplace listing sync operation has completed. Contains detailed results of the sync including created/updated listings, errors encountered, and performance statistics.
@@ -678,6 +778,116 @@ Includes bidirectional sync: - Pull: Fetch listings from marketplace to update l
 
 
 
+### marketplace-listing-tags-generation-completed
+
+**Description:** Notifies backend that marketplace tags generation completed. Contains generated tags optimized for discoverability with metadata tracking.
+
+**Method:** `client.marketplaceListingTagsGenerationCompleted(data)`
+
+**Payload Type:** `MarketplaceListingTagsGenerationCompletedMessage`
+
+**Fields:**
+
+- `modelId` (string) [✓]: UUID of the model that was processed
+
+- `entityType` (string) [✓]: Type of entity processed
+
+- `tags` (array) [✓]: Generated searchability tags (style, technical, usage keywords)
+
+- `metadata` (object) [✓]: Content generation metadata for tracking
+
+- `error` (string) [✗]: Error message if generation failed
+
+
+
+### marketplace-listing-tags-generation-request
+
+**Description:** Generates searchability tags for a 3D model optimized for marketplace discoverability. Worker creates style, technical, and usage keywords following marketplace tag limits and SEO best practices.
+
+**Method:** `client.marketplaceListingTagsGenerationRequest(data)`
+
+**Payload Type:** `MarketplaceListingTagsGenerationRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✓]: UUID of the model (reference only)
+
+- `entityType` (string) [✓]: Type of entity being processed
+
+- `entityName` (string) [✓]: Name/title of the model or metamodel
+
+- `targetMarketplace` (string) [✓]: Target marketplace ID (e.g., 'etsy', 'ebay', 'thingiverse')
+
+- `userId` (string) [✓]: UUID of the user requesting generation
+
+- `webhookUrl` (string) [✗]: Callback URL for completion notification
+
+- `technicalMetadata` (object) [✗]: Technical analysis data for tag generation
+
+- `thumbnailUrls` (array) [✗]: URLs to 360-degree thumbnail views for visual analysis
+
+- `existingTags` (array) [✗]: Currently assigned tags to supplement or replace
+
+- `existingCategory` (string) [✗]: Current classification for category-based tags
+
+- `tagLimit` (number) [✗]: Maximum number of tags for marketplace (e.g., 13 for Etsy)
+
+
+
+### marketplace-listing-title-generation-completed
+
+**Description:** Notifies backend that marketplace title generation completed. Contains generated title with metadata tracking.
+
+**Method:** `client.marketplaceListingTitleGenerationCompleted(data)`
+
+**Payload Type:** `MarketplaceListingTitleGenerationCompletedMessage`
+
+**Fields:**
+
+- `modelId` (string) [✓]: UUID of the model that was processed
+
+- `entityType` (string) [✓]: Type of entity processed
+
+- `title` (string) [✓]: Marketplace-optimized title
+
+- `metadata` (object) [✓]: Content generation metadata for tracking
+
+- `error` (string) [✗]: Error message if generation failed
+
+
+
+### marketplace-listing-title-generation-request
+
+**Description:** Generates marketplace-optimized title for a 3D model. Worker creates concise, SEO-friendly titles following marketplace character limits and best practices.
+
+**Method:** `client.marketplaceListingTitleGenerationRequest(data)`
+
+**Payload Type:** `MarketplaceListingTitleGenerationRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✓]: UUID of the model (reference only)
+
+- `entityType` (string) [✓]: Type of entity being processed
+
+- `currentName` (string) [✓]: Current model/metamodel name
+
+- `targetMarketplace` (string) [✓]: Target marketplace ID (e.g., 'etsy', 'ebay', 'thingiverse')
+
+- `userId` (string) [✓]: UUID of the user requesting generation
+
+- `webhookUrl` (string) [✗]: Callback URL for completion notification
+
+- `technicalMetadata` (object) [✗]: Technical analysis data for context
+
+- `existingTags` (array) [✗]: Currently assigned tags for SEO keywords
+
+- `existingCategory` (string) [✗]: Current classification for categorization
+
+- `characterLimit` (number) [✗]: Maximum character count for marketplace (e.g., 140 for Etsy)
+
+
+
 ### marketplace-publish-listing-completed
 
 **Description:** Indicates completion of marketplace listing publication. Contains external listing ID and URL, or error details if failed. Works with any marketplace provider (etsy, ebay, etc.).
@@ -1080,6 +1290,8 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 - `metamodels` (array) [✓]: List of metamodel nodes in hierarchical structure (roots and children).
 
+- `ekgEdges` (array) [✗]: EKG edges derived from Louvain clustering (OPTIONAL - new field)
+
 
 
 ### model-metamodel-detection-request
@@ -1358,6 +1570,8 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 - `thumbnail360Views` (array) [✗]: Array of 360° thumbnail view paths (16 angles) for vision-based analysis.
 
+- `gltfPreviewPath` (string) [✗]: The path to the generated GLTF/GLB 3D preview file.
+
 - `errorMessage` (string) [✗]: An error message if the thumbnail generation failed.
 
 - `storageLocation` (object) [✗]: The storage location of the model.
@@ -1621,6 +1835,12 @@ Used for:
 - Compliance and audit trails
 
 
+- `ekgEdgeBatchCreateCompleted(data: EkgEdgeBatchCreateCompletedMessage): Promise<JobResponse>`
+  - Completion event for EKG edge batch creation with propagation results.
+
+- `ekgEdgeBatchCreateRequest(data: EkgEdgeBatchCreateRequestMessage): Promise<JobResponse>`
+  - Create multiple EKG edges with Dempster-Shafer mass functions. Triggered by metamodel detection completion.
+
 - `etsyAnalyticsSyncCompleted(data: EtsyAnalyticsSyncCompletedMessage): Promise<JobResponse>`
   - Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
 
@@ -1683,6 +1903,12 @@ This is typically triggered after initial connection or periodically to keep mar
   - Requests rotation/refresh of marketplace connection credentials. This is used for: - OAuth token refresh when tokens are near expiry - API key rotation for enhanced security - Re-authentication after connection errors - Scheduled credential updates
 
 
+- `marketplaceListingDescriptionGenerationCompleted(data: MarketplaceListingDescriptionGenerationCompletedMessage): Promise<JobResponse>`
+  - Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp).
+
+- `marketplaceListingDescriptionGenerationRequest(data: MarketplaceListingDescriptionGenerationRequestMessage): Promise<JobResponse>`
+  - Generates SEO-optimized marketplace description for a 3D model using LLM vision analysis. Worker receives model data, technical metadata, and thumbnail URLs to generate compelling product descriptions tailored to the target marketplace.
+
 - `marketplaceListingSyncCompleted(data: MarketplaceListingSyncCompletedMessage): Promise<JobResponse>`
   - Notification that marketplace listing sync operation has completed. Contains detailed results of the sync including created/updated listings, errors encountered, and performance statistics.
 
@@ -1692,6 +1918,18 @@ This is typically triggered after initial connection or periodically to keep mar
 Includes bidirectional sync: - Pull: Fetch listings from marketplace to update local database - Push: Update marketplace listings with local changes - Full: Both pull and push operations
 
 
+- `marketplaceListingTagsGenerationCompleted(data: MarketplaceListingTagsGenerationCompletedMessage): Promise<JobResponse>`
+  - Notifies backend that marketplace tags generation completed. Contains generated tags optimized for discoverability with metadata tracking.
+
+- `marketplaceListingTagsGenerationRequest(data: MarketplaceListingTagsGenerationRequestMessage): Promise<JobResponse>`
+  - Generates searchability tags for a 3D model optimized for marketplace discoverability. Worker creates style, technical, and usage keywords following marketplace tag limits and SEO best practices.
+
+- `marketplaceListingTitleGenerationCompleted(data: MarketplaceListingTitleGenerationCompletedMessage): Promise<JobResponse>`
+  - Notifies backend that marketplace title generation completed. Contains generated title with metadata tracking.
+
+- `marketplaceListingTitleGenerationRequest(data: MarketplaceListingTitleGenerationRequestMessage): Promise<JobResponse>`
+  - Generates marketplace-optimized title for a 3D model. Worker creates concise, SEO-friendly titles following marketplace character limits and best practices.
+
 - `marketplacePublishListingCompleted(data: MarketplacePublishListingCompletedMessage): Promise<JobResponse>`
   - Indicates completion of marketplace listing publication. Contains external listing ID and URL, or error details if failed. Works with any marketplace provider (etsy, ebay, etc.).
 

package/dist/client.d.ts

@@ -58,6 +58,18 @@ export declare class WorkerClient {
      * @returns Job response with job ID
      */
     backendLoggingEvent(data: types.BackendLoggingEventMessage): Promise<JobResponse>;
+    /**
+     * Completion event for EKG edge batch creation with propagation results.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    ekgEdgeBatchCreateCompleted(data: types.EkgEdgeBatchCreateCompletedMessage): Promise<JobResponse>;
+    /**
+     * Create multiple EKG edges with Dempster-Shafer mass functions. Triggered by metamodel detection completion.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    ekgEdgeBatchCreateRequest(data: types.EkgEdgeBatchCreateRequestMessage): Promise<JobResponse>;
     /**
      * Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
   
@@ -162,6 +174,18 @@ export declare class WorkerClient {
      * @returns Job response with job ID
      */
     marketplaceCredentialRotationRequest(data: types.MarketplaceCredentialRotationRequestMessage): Promise<JobResponse>;
+    /**
+     * Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp).
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplaceListingDescriptionGenerationCompleted(data: types.MarketplaceListingDescriptionGenerationCompletedMessage): Promise<JobResponse>;
+    /**
+     * Generates SEO-optimized marketplace description for a 3D model using LLM vision analysis. Worker receives model data, technical metadata, and thumbnail URLs to generate compelling product descriptions tailored to the target marketplace.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplaceListingDescriptionGenerationRequest(data: types.MarketplaceListingDescriptionGenerationRequestMessage): Promise<JobResponse>;
     /**
      * Notification that marketplace listing sync operation has completed. Contains detailed results of the sync including created/updated listings, errors encountered, and performance statistics.
   
@@ -177,6 +201,30 @@ export declare class WorkerClient {
      * @returns Job response with job ID
      */
     marketplaceListingSyncRequest(data: types.MarketplaceListingSyncRequestMessage): Promise<JobResponse>;
+    /**
+     * Notifies backend that marketplace tags generation completed. Contains generated tags optimized for discoverability with metadata tracking.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplaceListingTagsGenerationCompleted(data: types.MarketplaceListingTagsGenerationCompletedMessage): Promise<JobResponse>;
+    /**
+     * Generates searchability tags for a 3D model optimized for marketplace discoverability. Worker creates style, technical, and usage keywords following marketplace tag limits and SEO best practices.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplaceListingTagsGenerationRequest(data: types.MarketplaceListingTagsGenerationRequestMessage): Promise<JobResponse>;
+    /**
+     * Notifies backend that marketplace title generation completed. Contains generated title with metadata tracking.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplaceListingTitleGenerationCompleted(data: types.MarketplaceListingTitleGenerationCompletedMessage): Promise<JobResponse>;
+    /**
+     * Generates marketplace-optimized title for a 3D model. Worker creates concise, SEO-friendly titles following marketplace character limits and best practices.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    marketplaceListingTitleGenerationRequest(data: types.MarketplaceListingTitleGenerationRequestMessage): Promise<JobResponse>;
     /**
      * Indicates completion of marketplace listing publication. Contains external listing ID and URL, or error details if failed. Works with any marketplace provider (etsy, ebay, etc.).
      * @param data - The message payload

package/dist/client.js

@@ -83,6 +83,22 @@ export class WorkerClient {
     async backendLoggingEvent(data) {
         return this.sendToQueue(types.MessageTypes.BACKEND_LOGGING_EVENT, data);
     }
+    /**
+     * Completion event for EKG edge batch creation with propagation results.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async ekgEdgeBatchCreateCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.EKG_EDGE_BATCH_CREATE_COMPLETED, data);
+    }
+    /**
+     * Create multiple EKG edges with Dempster-Shafer mass functions. Triggered by metamodel detection completion.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async ekgEdgeBatchCreateRequest(data) {
+        return this.sendToQueue(types.MessageTypes.EKG_EDGE_BATCH_CREATE_REQUEST, data);
+    }
     /**
      * Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
   
@@ -215,6 +231,22 @@ export class WorkerClient {
     async marketplaceCredentialRotationRequest(data) {
         return this.sendToQueue(types.MessageTypes.MARKETPLACE_CREDENTIAL_ROTATION_REQUEST, data);
     }
+    /**
+     * Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp).
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplaceListingDescriptionGenerationCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_LISTING_DESCRIPTION_GENERATION_COMPLETED, data);
+    }
+    /**
+     * Generates SEO-optimized marketplace description for a 3D model using LLM vision analysis. Worker receives model data, technical metadata, and thumbnail URLs to generate compelling product descriptions tailored to the target marketplace.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplaceListingDescriptionGenerationRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_LISTING_DESCRIPTION_GENERATION_REQUEST, data);
+    }
     /**
      * Notification that marketplace listing sync operation has completed. Contains detailed results of the sync including created/updated listings, errors encountered, and performance statistics.
   
@@ -234,6 +266,38 @@ export class WorkerClient {
     async marketplaceListingSyncRequest(data) {
         return this.sendToQueue(types.MessageTypes.MARKETPLACE_LISTING_SYNC_REQUEST, data);
     }
+    /**
+     * Notifies backend that marketplace tags generation completed. Contains generated tags optimized for discoverability with metadata tracking.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplaceListingTagsGenerationCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_LISTING_TAGS_GENERATION_COMPLETED, data);
+    }
+    /**
+     * Generates searchability tags for a 3D model optimized for marketplace discoverability. Worker creates style, technical, and usage keywords following marketplace tag limits and SEO best practices.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplaceListingTagsGenerationRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_LISTING_TAGS_GENERATION_REQUEST, data);
+    }
+    /**
+     * Notifies backend that marketplace title generation completed. Contains generated title with metadata tracking.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplaceListingTitleGenerationCompleted(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_LISTING_TITLE_GENERATION_COMPLETED, data);
+    }
+    /**
+     * Generates marketplace-optimized title for a 3D model. Worker creates concise, SEO-friendly titles following marketplace character limits and best practices.
+     * @param data - The message payload
+     * @returns Job response with job ID
+     */
+    async marketplaceListingTitleGenerationRequest(data) {
+        return this.sendToQueue(types.MessageTypes.MARKETPLACE_LISTING_TITLE_GENERATION_REQUEST, data);
+    }
     /**
      * Indicates completion of marketplace listing publication. Contains external listing ID and URL, or error details if failed. Works with any marketplace provider (etsy, ebay, etc.).
      * @param data - The message payload

package/dist/types.d.ts

@@ -3,6 +3,8 @@
  */
 export declare const MessageTypes: {
     readonly BACKEND_LOGGING_EVENT: "backend-logging-event";
+    readonly EKG_EDGE_BATCH_CREATE_COMPLETED: "ekg-edge-batch-create-completed";
+    readonly EKG_EDGE_BATCH_CREATE_REQUEST: "ekg-edge-batch-create-request";
     readonly ETSY_ANALYTICS_SYNC_COMPLETED: "etsy-analytics-sync-completed";
     readonly ETSY_ANALYTICS_SYNC_REQUEST: "etsy-analytics-sync-request";
     readonly ETSY_PUBLISH_LISTING_COMPLETED: "etsy-publish-listing-completed";
@@ -17,8 +19,14 @@ export declare const MessageTypes: {
     readonly MARKETPLACE_CONNECTION_SYNC_REQUEST: "marketplace-connection-sync-request";
     readonly MARKETPLACE_CREDENTIAL_ROTATION_COMPLETED: "marketplace-credential-rotation-completed";
     readonly MARKETPLACE_CREDENTIAL_ROTATION_REQUEST: "marketplace-credential-rotation-request";
+    readonly MARKETPLACE_LISTING_DESCRIPTION_GENERATION_COMPLETED: "marketplace-listing-description-generation-completed";
+    readonly MARKETPLACE_LISTING_DESCRIPTION_GENERATION_REQUEST: "marketplace-listing-description-generation-request";
     readonly MARKETPLACE_LISTING_SYNC_COMPLETED: "marketplace-listing-sync-completed";
     readonly MARKETPLACE_LISTING_SYNC_REQUEST: "marketplace-listing-sync-request";
+    readonly MARKETPLACE_LISTING_TAGS_GENERATION_COMPLETED: "marketplace-listing-tags-generation-completed";
+    readonly MARKETPLACE_LISTING_TAGS_GENERATION_REQUEST: "marketplace-listing-tags-generation-request";
+    readonly MARKETPLACE_LISTING_TITLE_GENERATION_COMPLETED: "marketplace-listing-title-generation-completed";
+    readonly MARKETPLACE_LISTING_TITLE_GENERATION_REQUEST: "marketplace-listing-title-generation-request";
     readonly MARKETPLACE_PUBLISH_LISTING_COMPLETED: "marketplace-publish-listing-completed";
     readonly MARKETPLACE_PUBLISH_LISTING_REQUEST: "marketplace-publish-listing-request";
     readonly MEDIA_BATCH_DOWNLOAD_COMPLETED: "media-batch-download-completed";
@@ -106,6 +114,38 @@ export interface BackendLoggingEventMessage {
     /** Operation duration in milliseconds (if applicable) */
     durationMs?: number;
 }
+/**
+ * Completion event for EKG edge batch creation with propagation results.
+ */
+export interface EkgEdgeBatchCreateCompletedMessage {
+    /** Original request ID from ekg-edge-batch-create-request */
+    requestId: string;
+    /** Whether the batch operation succeeded */
+    success: boolean;
+    /** Batch operation statistics */
+    statistics: Record<string, string | number | boolean>;
+    /** List of high-conflict edges requiring review */
+    conflicts?: Array<Record<string, string | number | boolean>>;
+    /** Errors encountered during processing */
+    errors?: Array<Record<string, string | number | boolean>>;
+    /** Overall graph state after this batch */
+    graphMetrics?: Record<string, string | number | boolean>;
+}
+/**
+ * Create multiple EKG edges with Dempster-Shafer mass functions. Triggered by metamodel detection completion.
+ */
+export interface EkgEdgeBatchCreateRequestMessage {
+    /** Unique request ID for tracking (e.g., metamodel detection job ID) */
+    requestId: string;
+    /** Source of the edges: metamodel-heuristic, manual, taxonomy-import, etc. */
+    source: string;
+    /** Batch of edges to create/update in the EKG */
+    edges: Array<Record<string, string | number | boolean>>;
+    /** Options for evidential edge propagation after edge creation */
+    propagationOptions?: Record<string, string | number | boolean>;
+    /** Optional webhook URL for async completion notification */
+    webhookUrl?: string;
+}
 /**
  * Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
 
@@ -446,6 +486,46 @@ export interface MarketplaceCredentialRotationRequestMessage {
     /** Additional request context */
     metadata?: Record<string, string | number | boolean>;
 }
+/**
+ * Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp).
+ */
+export interface MarketplaceListingDescriptionGenerationCompletedMessage {
+    /** UUID of the model that was processed */
+    modelId: string;
+    /** Type of entity processed */
+    entityType: string;
+    /** SEO-optimized marketplace description (3-5 sentences) */
+    description: string;
+    /** Content generation metadata for tracking */
+    metadata: Record<string, string | number | boolean>;
+    /** Error message if generation failed */
+    error?: string;
+}
+/**
+ * Generates SEO-optimized marketplace description for a 3D model using LLM vision analysis. Worker receives model data, technical metadata, and thumbnail URLs to generate compelling product descriptions tailored to the target marketplace.
+ */
+export interface MarketplaceListingDescriptionGenerationRequestMessage {
+    /** UUID of the model (reference only) */
+    modelId: string;
+    /** Type of entity being processed */
+    entityType: string;
+    /** Name/title of the model or metamodel */
+    entityName: string;
+    /** Target marketplace ID (e.g., 'etsy', 'ebay', 'thingiverse') */
+    targetMarketplace: string;
+    /** UUID of the user requesting generation */
+    userId: string;
+    /** Callback URL for completion notification */
+    webhookUrl?: string;
+    /** Technical analysis data for context */
+    technicalMetadata?: Record<string, string | number | boolean>;
+    /** URLs to 360-degree thumbnail views */
+    thumbnailUrls?: Array<Record<string, string | number | boolean>>;
+    /** Currently assigned tags for context */
+    existingTags?: Array<Record<string, string | number | boolean>>;
+    /** Current classification for context */
+    existingCategory?: string;
+}
 /**
  * Notification that marketplace listing sync operation has completed. Contains detailed results of the sync including created/updated listings, errors encountered, and performance statistics.
 
@@ -509,6 +589,88 @@ export interface MarketplaceListingSyncRequestMessage {
     /** Additional request context */
     metadata?: Record<string, string | number | boolean>;
 }
+/**
+ * Notifies backend that marketplace tags generation completed. Contains generated tags optimized for discoverability with metadata tracking.
+ */
+export interface MarketplaceListingTagsGenerationCompletedMessage {
+    /** UUID of the model that was processed */
+    modelId: string;
+    /** Type of entity processed */
+    entityType: string;
+    /** Generated searchability tags (style, technical, usage keywords) */
+    tags: Array<Record<string, string | number | boolean>>;
+    /** Content generation metadata for tracking */
+    metadata: Record<string, string | number | boolean>;
+    /** Error message if generation failed */
+    error?: string;
+}
+/**
+ * Generates searchability tags for a 3D model optimized for marketplace discoverability. Worker creates style, technical, and usage keywords following marketplace tag limits and SEO best practices.
+ */
+export interface MarketplaceListingTagsGenerationRequestMessage {
+    /** UUID of the model (reference only) */
+    modelId: string;
+    /** Type of entity being processed */
+    entityType: string;
+    /** Name/title of the model or metamodel */
+    entityName: string;
+    /** Target marketplace ID (e.g., 'etsy', 'ebay', 'thingiverse') */
+    targetMarketplace: string;
+    /** UUID of the user requesting generation */
+    userId: string;
+    /** Callback URL for completion notification */
+    webhookUrl?: string;
+    /** Technical analysis data for tag generation */
+    technicalMetadata?: Record<string, string | number | boolean>;
+    /** URLs to 360-degree thumbnail views for visual analysis */
+    thumbnailUrls?: Array<Record<string, string | number | boolean>>;
+    /** Currently assigned tags to supplement or replace */
+    existingTags?: Array<Record<string, string | number | boolean>>;
+    /** Current classification for category-based tags */
+    existingCategory?: string;
+    /** Maximum number of tags for marketplace (e.g., 13 for Etsy) */
+    tagLimit?: number;
+}
+/**
+ * Notifies backend that marketplace title generation completed. Contains generated title with metadata tracking.
+ */
+export interface MarketplaceListingTitleGenerationCompletedMessage {
+    /** UUID of the model that was processed */
+    modelId: string;
+    /** Type of entity processed */
+    entityType: string;
+    /** Marketplace-optimized title */
+    title: string;
+    /** Content generation metadata for tracking */
+    metadata: Record<string, string | number | boolean>;
+    /** Error message if generation failed */
+    error?: string;
+}
+/**
+ * Generates marketplace-optimized title for a 3D model. Worker creates concise, SEO-friendly titles following marketplace character limits and best practices.
+ */
+export interface MarketplaceListingTitleGenerationRequestMessage {
+    /** UUID of the model (reference only) */
+    modelId: string;
+    /** Type of entity being processed */
+    entityType: string;
+    /** Current model/metamodel name */
+    currentName: string;
+    /** Target marketplace ID (e.g., 'etsy', 'ebay', 'thingiverse') */
+    targetMarketplace: string;
+    /** UUID of the user requesting generation */
+    userId: string;
+    /** Callback URL for completion notification */
+    webhookUrl?: string;
+    /** Technical analysis data for context */
+    technicalMetadata?: Record<string, string | number | boolean>;
+    /** Currently assigned tags for SEO keywords */
+    existingTags?: Array<Record<string, string | number | boolean>>;
+    /** Current classification for categorization */
+    existingCategory?: string;
+    /** Maximum character count for marketplace (e.g., 140 for Etsy) */
+    characterLimit?: number;
+}
 /**
  * Indicates completion of marketplace listing publication. Contains external listing ID and URL, or error details if failed. Works with any marketplace provider (etsy, ebay, etc.).
  */
@@ -793,6 +955,8 @@ export interface ModelMetadataGenerationRequestMessage {
 export interface ModelMetamodelDetectionFoundMessage {
     /** List of metamodel nodes in hierarchical structure (roots and children). */
     metamodels: Array<Record<string, string | number | boolean>>;
+    /** EKG edges derived from Louvain clustering (OPTIONAL - new field) */
+    ekgEdges?: Array<Record<string, string | number | boolean>>;
 }
 /**
  * Handles model metamodel detection requests.
@@ -1015,6 +1179,8 @@ export interface ThumbnailGenerationCompletedMessage {
     thumbnailPath?: string;
     /** Array of 360° thumbnail view paths (16 angles) for vision-based analysis. */
     thumbnail360Views?: Array<Record<string, string | number | boolean>>;
+    /** The path to the generated GLTF/GLB 3D preview file. */
+    gltfPreviewPath?: string;
     /** An error message if the thumbnail generation failed. */
     errorMessage?: string;
     /** The storage location of the model. */

package/dist/types.js

@@ -4,6 +4,8 @@
  */
 export const MessageTypes = {
     BACKEND_LOGGING_EVENT: 'backend-logging-event',
+    EKG_EDGE_BATCH_CREATE_COMPLETED: 'ekg-edge-batch-create-completed',
+    EKG_EDGE_BATCH_CREATE_REQUEST: 'ekg-edge-batch-create-request',
     ETSY_ANALYTICS_SYNC_COMPLETED: 'etsy-analytics-sync-completed',
     ETSY_ANALYTICS_SYNC_REQUEST: 'etsy-analytics-sync-request',
     ETSY_PUBLISH_LISTING_COMPLETED: 'etsy-publish-listing-completed',
@@ -18,8 +20,14 @@ export const MessageTypes = {
     MARKETPLACE_CONNECTION_SYNC_REQUEST: 'marketplace-connection-sync-request',
     MARKETPLACE_CREDENTIAL_ROTATION_COMPLETED: 'marketplace-credential-rotation-completed',
     MARKETPLACE_CREDENTIAL_ROTATION_REQUEST: 'marketplace-credential-rotation-request',
+    MARKETPLACE_LISTING_DESCRIPTION_GENERATION_COMPLETED: 'marketplace-listing-description-generation-completed',
+    MARKETPLACE_LISTING_DESCRIPTION_GENERATION_REQUEST: 'marketplace-listing-description-generation-request',
     MARKETPLACE_LISTING_SYNC_COMPLETED: 'marketplace-listing-sync-completed',
     MARKETPLACE_LISTING_SYNC_REQUEST: 'marketplace-listing-sync-request',
+    MARKETPLACE_LISTING_TAGS_GENERATION_COMPLETED: 'marketplace-listing-tags-generation-completed',
+    MARKETPLACE_LISTING_TAGS_GENERATION_REQUEST: 'marketplace-listing-tags-generation-request',
+    MARKETPLACE_LISTING_TITLE_GENERATION_COMPLETED: 'marketplace-listing-title-generation-completed',
+    MARKETPLACE_LISTING_TITLE_GENERATION_REQUEST: 'marketplace-listing-title-generation-request',
     MARKETPLACE_PUBLISH_LISTING_COMPLETED: 'marketplace-publish-listing-completed',
     MARKETPLACE_PUBLISH_LISTING_REQUEST: 'marketplace-publish-listing-request',
     MEDIA_BATCH_DOWNLOAD_COMPLETED: 'media-batch-download-completed',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mesh-sync/worker-backend-client",
-  "version": "4.0.9",
+  "version": "4.0.15",
   "description": "Auto-generated TypeScript client for worker-backend - provides type-safe methods for enqueueing jobs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",