@mesh-sync/worker-backend-client 4.0.19 → 4.0.24-pr.51.20260312132340

package/dist/types.d.ts

@@ -2,9 +2,8 @@
  * Message type constants
  */
 export declare const MessageTypes: {
+    readonly ANALYTICS_COLLECTION_REQUEST: "analytics-collection-request";
     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";
@@ -13,13 +12,15 @@ export declare const MessageTypes: {
     readonly FILE_DOWNLOAD_REQUEST: "file-download-request";
     readonly FILE_VECTORIZE_COMPLETED: "file-vectorize-completed";
     readonly FILE_VECTORIZE_REQUEST: "file-vectorize-request";
-    readonly MARKETPLACE_ANALYTICS_SYNC_COMPLETED: "marketplace-analytics-sync-completed";
-    readonly MARKETPLACE_ANALYTICS_SYNC_REQUEST: "marketplace-analytics-sync-request";
+    readonly IP_CHECK_COMPLETED: "ip-check-completed";
+    readonly IP_CHECK_REQUEST: "ip-check-request";
     readonly MARKETPLACE_CONNECTION_SYNC_COMPLETED: "marketplace-connection-sync-completed";
     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_INTELLIGENCE_COMPLETED: "marketplace-intelligence-completed";
     readonly MARKETPLACE_INTELLIGENCE_EVENT: "marketplace-intelligence-event";
+    readonly MARKETPLACE_INTELLIGENCE_REQUEST: "marketplace-intelligence-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";
@@ -30,8 +31,6 @@ export declare const MessageTypes: {
     readonly MARKETPLACE_LISTING_TITLE_GENERATION_REQUEST: "marketplace-listing-title-generation-request";
     readonly MARKETPLACE_LISTING_UPDATE_COMPLETED: "marketplace-listing-update-completed";
     readonly MARKETPLACE_LISTING_UPDATE_REQUEST: "marketplace-listing-update-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";
     readonly MEDIA_BATCH_DOWNLOAD_REQUEST: "media-batch-download-request";
     readonly METAMODEL_METADATA_GENERATION_COMPLETED: "metamodel-metadata-generation-completed";
@@ -48,12 +47,20 @@ export declare const MessageTypes: {
     readonly MODEL_METADATA_GENERATION_REQUEST: "model-metadata-generation-request";
     readonly MODEL_METAMODEL_DETECTION_FOUND: "model-metamodel-detection-found";
     readonly MODEL_METAMODEL_DETECTION_REQUEST: "model-metamodel-detection-request";
+    readonly MODEL_PRINT_ANALYSIS_COMPLETED: "model-print-analysis-completed";
+    readonly MODEL_PRINT_ANALYSIS_REQUEST: "model-print-analysis-request";
     readonly MODEL_SELLABILITY_ANALYSIS_COMPLETED: "model-sellability-analysis-completed";
     readonly MODEL_SELLABILITY_ANALYSIS_REQUEST: "model-sellability-analysis-request";
     readonly MODEL_SEMANTIC_ANALYSIS_COMPLETED: "model-semantic-analysis-completed";
     readonly MODEL_SEMANTIC_ANALYSIS_REQUEST: "model-semantic-analysis-request";
     readonly MODEL_TECHNICAL_METADATA_COMPLETED: "model-technical-metadata-completed";
     readonly MODEL_TECHNICAL_METADATA_REQUEST: "model-technical-metadata-request";
+    readonly SLICING_FDM_REQUEST: "slicing-fdm-request";
+    readonly SLICING_FDM_RESULT: "slicing-fdm-result";
+    readonly SLICING_SLA_REQUEST: "slicing-sla-request";
+    readonly SLICING_SLA_RESULT: "slicing-sla-result";
+    readonly TEXTURE_GENERATION_COMPLETED: "texture-generation-completed";
+    readonly TEXTURE_GENERATION_REQUEST: "texture-generation-request";
     readonly THUMBNAIL_GENERATION_COMPLETED: "thumbnail-generation-completed";
     readonly THUMBNAIL_GENERATION_REQUEST: "thumbnail-generation-request";
     readonly USER_ENGAGEMENT_EVENT: "user-engagement-event";
@@ -61,6 +68,21 @@ export declare const MessageTypes: {
     readonly WORKER_METRICS_ENRICHED_EVENT: "worker-metrics-enriched-event";
 };
 export type MessageType = typeof MessageTypes[keyof typeof MessageTypes];
+/**
+ * Request to trigger a manual market data collection job.
+Used for ad-hoc scraping of specific queries on marketplaces.
+
+ */
+export interface AnalyticsCollectionRequestMessage {
+    /** The marketplace to scrape (etsy, ebay, etc.) */
+    marketplace?: string;
+    /** The search query to use */
+    query: string;
+    /** Collection options (pages, filters, etc.) */
+    options?: {
+        pages?: number;
+    };
+}
 /**
  * Centralized logging event for capturing all warn/error/failure logs from meshsync-backend.
 This event is sent to ELK for centralized monitoring, alerting, and debugging.
@@ -99,7 +121,7 @@ export interface BackendLoggingEventMessage {
     /** Request URL path (without query params for privacy) */
     httpUrl?: string;
     /** HTTP response status code */
-    httpStatusCode?: string | number | boolean;
+    httpStatusCode?: number;
     /** Error class/type name */
     errorType?: string;
     /** Stack trace (sanitized, no sensitive data) */
@@ -107,7 +129,14 @@ export interface BackendLoggingEventMessage {
     /** Application-specific error code for categorization */
     errorCode?: string;
     /** Additional structured context (sanitized, no PII) */
-    metadata?: Record<string, string | number | boolean>;
+    metadata?: {
+        modelId?: string;
+        storageId?: string;
+        workerId?: string;
+        jobId?: string;
+        marketplace?: string;
+        operation?: string;
+    };
     /** Deployment environment */
     environment?: string;
     /** Backend service version */
@@ -117,38 +146,6 @@ 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.
 
@@ -159,15 +156,42 @@ export interface EtsyAnalyticsSyncCompletedMessage {
     /**  */
     status?: string;
     /** Number of listings successfully synced */
-    syncedCount?: string | number | boolean;
+    syncedCount?: number;
     /** Number of listings that failed */
-    errorCount?: string | number | boolean;
+    errorCount?: number;
     /** Analytics for each synced listing */
-    results?: Array<Record<string, string | number | boolean>>;
+    results?: Array<{
+        listingId?: string;
+        etsyListingId?: string;
+        materialName?: string;
+        analytics?: {
+            views?: number;
+            favorites?: number;
+            sales?: number;
+            revenue?: number;
+            conversionRate?: number;
+            averageOrderValue?: number;
+            topSearchTerms?: string[];
+            trafficSources?: Record<string, number>;
+            timeSeries?: Array<{
+                date?: string;
+                views?: number;
+                sales?: number;
+            }>;
+        };
+        status?: string;
+    }>;
     /** New credentials if token was refreshed during operation */
-    credentialUpdate?: Record<string, string | number | boolean>;
+    credentialUpdate?: {
+        newAccessToken?: string;
+        newRefreshToken?: string;
+        expiresIn?: number;
+    };
     /** Errors for failed listings */
-    errors?: Array<Record<string, string | number | boolean>>;
+    errors?: Array<{
+        listingId?: string;
+        error?: string;
+    }>;
     /**  */
     syncedAt?: string;
     /** When next automatic sync should occur */
@@ -180,19 +204,34 @@ Can sync: - Specific listings (provide listingIds) - All user listings (provide
  */
 export interface EtsyAnalyticsSyncRequestMessage {
     /** Internal listing IDs to sync. Empty = sync all for user. */
-    listingIds?: Array<Record<string, string | number | boolean>>;
+    listingIds?: string[];
     /** User whose listings to sync (if listingIds empty) */
     userId?: string;
     /** Etsy shop ID for shop-level analytics */
     shopId?: string;
     /** Etsy OAuth credentials */
-    credentials?: Record<string, string | number | boolean>;
+    credentials?: {
+        apiKey?: string;
+        shopId?: string;
+        accessToken?: string;
+        refreshToken?: string;
+    };
     /** Date range for historical analytics */
-    timeRange?: Record<string, string | number | boolean>;
+    timeRange?: {
+        startDate: string;
+        endDate: string;
+    };
     /**  */
-    syncOptions?: Record<string, string | number | boolean>;
+    syncOptions?: {
+        includeDetailedMetrics?: boolean;
+        includeTrafficSources?: boolean;
+        includeSearchTerms?: boolean;
+    };
     /** Encrypted Etsy OAuth credentials */
-    etsyCredentials?: Record<string, string | number | boolean>;
+    etsyCredentials?: {
+        accessToken: string;
+        shopId: string;
+    };
     /**  */
     webhookUrl?: string;
 }
@@ -216,15 +255,24 @@ export interface EtsyPublishListingCompletedMessage {
     /** URL to view listing on Etsy (only if status=SUCCESS) */
     etsyListingUrl?: string;
     /** New credentials if token was refreshed during operation */
-    credentialUpdate?: Record<string, string | number | boolean>;
+    credentialUpdate?: {
+        newAccessToken?: string;
+        newRefreshToken?: string;
+        expiresIn?: number;
+    };
     /** Etsy digital file ID (only if status=SUCCESS) */
     etsyFileId?: string;
     /** Error details (only if status=FAILED) */
-    error?: Record<string, string | number | boolean>;
+    error?: {
+        code?: string;
+        message?: string;
+        details?: Record<string, unknown>;
+        retryable?: boolean;
+    };
     /** When the listing was created (only if status=SUCCESS) */
     publishedAt?: string;
     /** Processing time in milliseconds */
-    processingDuration?: string | number | boolean;
+    processingDuration?: number;
 }
 /**
  * Publishes a single metamodel listing to Etsy for a specific material variant. Creates Etsy listing, uploads digital file, and returns external listing ID.
@@ -240,17 +288,48 @@ export interface EtsyPublishListingRequestMessage {
     /** User ID who owns the metamodel */
     ownerId?: string;
     /** Etsy OAuth credentials */
-    credentials?: Record<string, string | number | boolean>;
+    credentials?: {
+        apiKey?: string;
+        shopId?: string;
+        accessToken?: string;
+        refreshToken?: string;
+    };
     /** Material-specific listing configuration */
-    materialVariant?: Record<string, string | number | boolean>;
+    materialVariant?: {
+        materialName: string;
+        price: number;
+        sku?: string;
+        currency?: string;
+    };
     /** Common listing information */
-    baseListingData?: Record<string, string | number | boolean>;
+    baseListingData?: {
+        title: string;
+        description: string;
+        tags: string[];
+        taxonomyId: number;
+        whoMade?: string;
+        whenMade?: string;
+        isDigital?: boolean;
+        quantity?: number;
+    };
     /**  */
-    publishOptions?: Record<string, string | number | boolean>;
+    publishOptions?: {
+        autoActivate?: boolean;
+        shippingProfileId?: number;
+    };
     /** Encrypted Etsy OAuth credentials */
-    etsyCredentials?: Record<string, string | number | boolean>;
+    etsyCredentials?: {
+        accessToken: string;
+        shopId: string;
+        expiresAt?: string;
+    };
     /** Digital file to upload */
-    fileMetadata?: Record<string, string | number | boolean>;
+    fileMetadata?: {
+        storageItemId: string;
+        fileName: string;
+        fileSize?: number;
+        mimeType?: string;
+    };
     /** Callback URL for completion notification */
     webhookUrl?: string;
 }
@@ -265,7 +344,11 @@ export interface FileDownloadCompletedMessage {
     /** The final status of the download operation. */
     status?: string;
     /** Details of the file's location in Minio S3 (present on success). */
-    s3Location?: Record<string, string | number | boolean>;
+    s3Location?: {
+        bucket: string;
+        key: string;
+        versionId?: string;
+    };
     /** Contains error details if the status is FAILED. */
     errorMessage?: string;
     /** The timestamp when the download was completed or failed. */
@@ -288,13 +371,31 @@ export interface FileDownloadRequestMessage {
     /** The identifier of the user who owns the model. Optional - if not provided, will be retrieved from StorageConnection. */
     ownerId?: string;
     /** The storage location of the model. */
-    storageLocation?: Record<string, string | number | boolean>;
+    storageLocation?: {
+        storageConnectionId: string;
+        path: string;
+    };
     /** Optional metadata from discovery. For Thingiverse, contains downloadUrl for direct file access. */
-    metadata?: Record<string, string | number | boolean>;
+    metadata?: {
+        downloadUrl?: string;
+    };
     /** Decrypted credentials required for this specific download operation. Injected by the backend. */
-    credentials?: Record<string, string | number | boolean>;
+    credentials?: {
+        providerType?: string;
+        accessKeyId?: string;
+        secretAccessKey?: string;
+        region?: string;
+        accessToken?: string;
+        refreshToken?: string;
+        username?: string;
+        password?: string;
+        privateKey?: string;
+    };
     /** Destination in MinIO where file will be uploaded after download. */
-    minioDestination?: Record<string, string | number | boolean>;
+    minioDestination?: {
+        bucket?: string;
+        path: string;
+    };
     /** Automatically enqueue thumbnail generation, technical metadata analysis, and metadata generation jobs after download completes. */
     autoEnqueueChildren?: boolean;
     /** Preview type for thumbnail generation (passed to child job). */
@@ -311,11 +412,11 @@ export interface FileVectorizeCompletedMessage {
     /**  */
     fileId?: string;
     /** The computed embedding vector */
-    vector?: Array<Record<string, string | number | boolean>>;
+    vector?: number[];
     /**  */
     modelName?: string;
     /** Length of the vector (e.g., 512) */
-    dimension?: string | number | boolean;
+    dimension?: number;
 }
 /**
  * Request to generate a vector embedding for an image file using CLIP.
@@ -324,55 +425,108 @@ export interface FileVectorizeRequestMessage {
     /** The ID of the file in the database */
     fileId?: string;
     /** Location of the image file */
-    storageItem?: string | number | boolean;
+    storageItem?: unknown;
     /** Optional: Specific model version to use */
     modelName?: string;
 }
 /**
- * Contains synced analytics data for marketplace listings. Backend stores this in marketplace_analytics_snapshots table and indexes to ELK. Works with any marketplace provider.
+ * Contains IP verification results including trademark risk, copyright risk, detected brands/franchises, and analysis confidence scores
  */
-export interface MarketplaceAnalyticsSyncCompletedMessage {
-    /** BullMQ job ID from original request */
-    originalJobId?: string;
-    /** Marketplace provider type (etsy, ebay, etc.) */
-    marketplaceProvider?: string;
-    /** Sync result (SUCCESS, PARTIAL_SUCCESS, or FAILED) */
+export interface IpCheckCompletedMessage {
+    /** Model UUID that was analyzed */
+    modelId?: string;
+    /** Owner user ID */
+    ownerId?: string;
+    /** Type of entity checked: 'model' or 'metamodel' */
+    entityType?: string;
+    /** Overall IP check outcome: 'clear', 'flagged', or 'error' */
     status?: string;
-    /** Number of listings successfully synced */
-    syncedCount?: string | number | boolean;
-    /** Number of listings that failed */
-    errorCount?: string | number | boolean;
-    /** Analytics for each synced listing */
-    results?: Array<Record<string, string | number | boolean>>;
-    /** Errors for failed listings */
-    errors?: Array<Record<string, string | number | boolean>>;
-    /** When sync completed (ISO 8601) */
-    syncedAt?: string;
-    /** When next automatic sync should occur (ISO 8601) */
-    nextScheduledSync?: string;
+    /** Detected trademark infringement risk level: 'none', 'low', 'medium', 'high' */
+    trademarkRisk?: string;
+    /** Detected copyright infringement risk level: 'none', 'low', 'medium', 'high' */
+    copyrightRisk?: string;
+    /** Brand names detected in model name or content */
+    matchedBrands?: string[];
+    /** Franchise/character names detected */
+    matchedFranchises?: string[];
+    /** Number of visually similar models found */
+    similarModelsCount?: number;
+    /** Overall confidence score for the analysis (0.0-1.0) */
+    confidence?: number;
+    /** Risk score as 0-100 integer (FR-024: >70 HIGH, 40-70 MEDIUM, <40 LOW) */
+    riskScorePercent?: number;
+    /** Overall risk level: 'none', 'low', 'medium', 'high' */
+    riskLevel?: string;
+    /** Recommended action: 'block' (HIGH risk), 'warn' (MEDIUM risk), 'allow' (LOW/NONE risk) */
+    recommendation?: string;
+    /** Suggested modifications to reduce IP risk */
+    suggestedChanges?: {
+        title?: string;
+        tagsToRemove?: string[];
+        descriptionChanges?: string;
+    };
+    /** Detailed results from each heuristic check */
+    heuristicResults?: {
+        perceptualHash?: {
+            executed?: boolean;
+            matchesFound?: number;
+            highestSimilarity?: number;
+            flagged?: boolean;
+        };
+        trademark?: {
+            executed?: boolean;
+            brandsDetected?: string[];
+            flagged?: boolean;
+        };
+        franchise?: {
+            executed?: boolean;
+            franchisesDetected?: string[];
+            flagged?: boolean;
+        };
+        reverseSearch?: {
+            executed?: boolean;
+            provider?: string;
+            matchesFound?: number;
+            commercialMatchesFound?: number;
+            flagged?: boolean;
+        };
+    };
+    /** Error details if status is 'error' */
+    error?: {
+        code?: string;
+        message?: string;
+    };
+    /** Total processing time in milliseconds */
+    processingDurationMs?: number;
 }
 /**
- * Syncs analytics data from marketplace API for one or more listings. Fetches views, favorites, sales, revenue, and traffic source data. Can sync: specific listings, all user listings, or shop-level analytics. Works with any marketplace provider that supports analytics (etsy, ebay, etc.).
+ * Triggers intellectual property verification analysis for a model thumbnail, detecting potential trademark and copyright issues using perceptual hashing, text analysis, and optional reverse image search.
  */
-export interface MarketplaceAnalyticsSyncRequestMessage {
-    /** Marketplace provider type (etsy, ebay, etc.) */
-    marketplaceProvider?: string;
-    /** UUID of the marketplace connection configuration */
-    marketplaceConnectionId?: string;
-    /** Internal listing UUIDs to sync. Empty array = sync all for user. */
-    listingIds?: Array<Record<string, string | number | boolean>>;
-    /** UUID of user whose listings to sync (if listingIds empty) */
-    userId?: string;
-    /** External marketplace shop ID for shop-level analytics */
-    externalShopId?: string;
-    /** Date range for historical analytics */
-    timeRange?: Record<string, string | number | boolean>;
-    /** Optional sync configuration */
-    syncOptions?: Record<string, string | number | boolean>;
-    /** Encrypted marketplace credentials (retrieved from marketplaceConnectionId) */
-    marketplaceCredentials?: Record<string, string | number | boolean>;
-    /** Callback URL for completion notification */
-    webhookUrl?: string;
+export interface IpCheckRequestMessage {
+    /** Unique identifier for the model to analyze */
+    modelId?: string;
+    /** User ID who owns the model */
+    ownerId?: string;
+    /** Type of entity being checked: 'model' or 'metamodel' */
+    entityType?: string;
+    /** Name of the model for trademark/franchise text detection */
+    modelName?: string;
+    /** Model tags for IP reference detection */
+    tags?: string[];
+    /** Model description for text-based IP analysis */
+    description?: string;
+    /** URL to fetch the thumbnail image for visual analysis */
+    thumbnailUrl?: string;
+    /** Path to thumbnail in MinIO if stored internally */
+    minioPath?: string;
+    /** Optional additional images for more comprehensive analysis (e.g., 360° views) */
+    additionalImageUrls?: string[];
+    /** Optional analysis configuration */
+    analysisOptions?: {
+        enableExternalSearch?: boolean;
+        strictMode?: boolean;
+        skipHeuristics?: string[];
+    };
 }
 /**
  * Notification that marketplace connection sync has completed. Contains updated connection metadata, profile information, and sync statistics.
@@ -392,15 +546,42 @@ export interface MarketplaceConnectionSyncCompletedMessage {
     /** Type of sync that was performed */
     syncType?: string;
     /** Updated connection information */
-    connectionData?: Record<string, string | number | boolean>;
+    connectionData?: {
+        status?: string;
+        shopName?: string;
+        shopUrl?: string;
+        shopId?: string;
+        permissions?: string[];
+        rateLimit?: {
+            remaining?: number;
+            resetAt?: string;
+        };
+    };
     /** Available marketplace categories */
-    categories?: Array<Record<string, string | number | boolean>>;
+    categories?: Array<{
+        id?: string;
+        name?: string;
+        path?: string;
+        level?: number;
+    }>;
     /** Sync operation statistics */
-    statistics?: Record<string, string | number | boolean>;
+    statistics?: {
+        duration?: number;
+        itemsSynced?: number;
+        errors?: Array<{
+            type?: string;
+            message?: string;
+            timestamp?: string;
+        }>;
+    };
     /** When sync completed */
     completedAt?: string;
     /** Error details if sync failed */
-    error?: Record<string, string | number | boolean>;
+    error?: {
+        code?: string;
+        message?: string;
+        details?: Record<string, unknown>;
+    };
 }
 /**
  * Requests synchronization of marketplace connection data including: - Profile information and shop details - Account status and permissions - Available categories and shipping profiles - Rate limits and API quotas
@@ -423,7 +604,10 @@ export interface MarketplaceConnectionSyncRequestMessage {
     /** Webhook URL to call when sync completes */
     webhookUrl?: string;
     /** Additional context data */
-    metadata?: Record<string, string | number | boolean>;
+    metadata?: {
+        source?: string;
+        retryCount?: number;
+    };
 }
 /**
  * Notification that marketplace credential rotation has completed. Contains the rotation results, new credential metadata, and any issues encountered.
@@ -445,19 +629,62 @@ export interface MarketplaceCredentialRotationCompletedMessage {
     /** Original reason for rotation */
     reason?: string;
     /** Metadata about new credentials */
-    newCredentials?: Record<string, string | number | boolean>;
+    newCredentials?: {
+        tokenType?: string;
+        createdAt?: string;
+        expiresAt?: string;
+        scope?: string[];
+        testResult?: {
+            tested?: boolean;
+            success?: boolean;
+            testedAt?: string;
+            testError?: string;
+        };
+    };
     /** Status of previous credentials */
-    oldCredentials?: Record<string, string | number | boolean>;
+    oldCredentials?: {
+        revoked?: boolean;
+        revokedAt?: string;
+        preservedUntil?: string;
+    };
     /** Details of the rotation operation */
-    operationDetails?: Record<string, string | number | boolean>;
+    operationDetails?: {
+        duration?: number;
+        attempts?: number;
+        method?: string;
+        completedAt?: string;
+    };
     /** Connection status after credential rotation */
-    connectionStatus?: Record<string, string | number | boolean>;
+    connectionStatus?: {
+        status?: string;
+        lastTest?: {
+            success?: boolean;
+            timestamp?: string;
+            error?: string;
+        };
+        permissions?: string[];
+    };
     /** Information about next scheduled rotation */
-    nextRotation?: Record<string, string | number | boolean>;
+    nextRotation?: {
+        scheduledAt?: string;
+        reason?: string;
+        reminderAt?: string;
+    };
     /** Error details if rotation failed */
-    error?: Record<string, string | number | boolean>;
+    error?: {
+        code?: string;
+        message?: string;
+        details?: Record<string, unknown>;
+        retryable?: boolean;
+        nextRetryAt?: string;
+    };
     /** Notifications sent as part of rotation */
-    notifications?: Array<Record<string, string | number | boolean>>;
+    notifications?: Array<{
+        type?: string;
+        recipient?: string;
+        status?: string;
+        sentAt?: string;
+    }>;
 }
 /**
  * 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
@@ -477,9 +704,20 @@ export interface MarketplaceCredentialRotationRequestMessage {
     /** How urgently the rotation is needed */
     urgency?: string;
     /** Current credential metadata (no actual secrets) */
-    currentCredentials?: Record<string, string | number | boolean>;
+    currentCredentials?: {
+        tokenType?: string;
+        expiresAt?: string;
+        lastUsedAt?: string;
+        errorsSinceLastRotation?: number;
+    };
     /** Rotation configuration options */
-    options?: Record<string, string | number | boolean>;
+    options?: {
+        preserveOldToken?: boolean;
+        testNewCredentials?: boolean;
+        notifyUser?: boolean;
+        retryOnFailure?: boolean;
+        maxRetries?: number;
+    };
     /** Unique request identifier */
     requestId?: string;
     /** Webhook URL for completion notification */
@@ -487,7 +725,70 @@ export interface MarketplaceCredentialRotationRequestMessage {
     /** When this rotation was scheduled (if scheduled) */
     scheduledAt?: string;
     /** Additional request context */
-    metadata?: Record<string, string | number | boolean>;
+    metadata?: {
+        source?: string;
+        originalError?: {
+            code?: string;
+            message?: string;
+            timestamp?: string;
+        };
+    };
+}
+/**
+ * Response from marketplace intelligence scraping.
+Contains aggregated similarity data from marketplace searches.
+
+Consumed by worker-backend to update pipeline context before
+sellability analysis runs.
+
+ */
+export interface MarketplaceIntelligenceCompletedMessage {
+    /** UUID of the model that was researched */
+    modelId: string;
+    /** UUID of the model owner */
+    ownerId: string;
+    /** Result status */
+    status: string;
+    /** Aggregated market intelligence across all scraped marketplaces */
+    marketData?: {
+        totalListingsFound?: number;
+        averagePrice?: number;
+        priceRange?: {
+            min?: number;
+            max?: number;
+            median?: number;
+        };
+        averageRating?: number;
+        averageSalesCount?: number;
+        topTags?: string[];
+        competitorCount?: number;
+        hasDigitalDownloads?: boolean;
+        bestSellerPercentage?: number;
+    };
+    /** Results per marketplace */
+    marketplaceBreakdown?: Array<{
+        marketplace?: string;
+        listingsFound?: number;
+        averagePrice?: number;
+        topResult?: {
+            title?: string;
+            price?: number;
+            url?: string;
+            favorites?: number;
+        };
+    }>;
+    /** How saturated the market is for this model type (0=unique, 100=very common) */
+    similarityScore?: number;
+    /** Error information if status is FAILED */
+    error?: {
+        code?: string;
+        message?: string;
+        failedMarketplaces?: string[];
+    };
+    /** When the analysis completed */
+    analyzedAt?: string;
+    /** Version of the intelligence collector */
+    analysisVersion?: string;
 }
 /**
  * Public marketplace intelligence data scraped from external marketplaces.
@@ -513,13 +814,48 @@ export interface MarketplaceIntelligenceEventMessage {
     /** Marketplace-native listing ID */
     externalId: string;
     /** Core listing information */
-    listing: Record<string, string | number | boolean>;
+    listing: {
+        title: string;
+        price: number;
+        currency: string;
+        url: string;
+        thumbnailUrl: string;
+    };
     /** Public engagement and sales metrics */
-    metrics?: Record<string, string | number | boolean>;
+    metrics?: {
+        favorites?: number;
+        reviewsCount?: number;
+        averageRating?: number;
+        views?: number;
+        salesCount?: number;
+        salesVelocity?: number;
+        sentimentScore?: number;
+    };
     /** Additional listing context and categorization */
-    metadata?: Record<string, string | number | boolean>;
+    metadata?: {
+        tags?: string[];
+        materials?: string[];
+        shopName?: string;
+        shopLocation?: string;
+        isDigital?: boolean;
+        isBestseller?: boolean;
+        isAd?: boolean;
+        isPopularNow?: boolean;
+        isStarSeller?: boolean;
+        hasFreeShipping?: boolean;
+        originalPrice?: number;
+        discountPercent?: number;
+        shopRating?: number;
+        shopReviewsCount?: number;
+        reviews?: string[];
+    };
     /** Search context that found this listing */
-    queryContext?: Record<string, string | number | boolean>;
+    queryContext?: {
+        searchQuery?: string;
+        pageNumber?: number;
+        position?: number;
+        filters?: Record<string, unknown>;
+    };
     /** ISO 8601 timestamp when data was scraped */
     collectedAt: string;
     /** Version of collector that scraped this data */
@@ -527,6 +863,48 @@ export interface MarketplaceIntelligenceEventMessage {
     /** Method used for scraping */
     scrapingMethod?: string;
 }
+/**
+ * Triggers automated marketplace scraping to find similar/competing listings
+for a given model. This is a pipeline stage that runs after metadata generation
+to inform sellability analysis with real market data.
+
+The worker-analytic-collector (or marketplace-connectors worker) will:
+1. Use model metadata (title, tags, category) to build search queries
+2. Scrape connected marketplaces (Etsy, eBay, etc.) for similar listings
+3. Emit marketplace-intelligence-event results for Elasticsearch indexing
+4. Return aggregated similarity data to the pipeline context
+
+Pipeline integration:
+- Triggered after: metadata-generation (needs model title/tags/category)
+- Results feed into: sellability-analysis (market positioning data)
+
+ */
+export interface MarketplaceIntelligenceRequestMessage {
+    /** UUID of the model to research */
+    modelId: string;
+    /** UUID of the model owner */
+    ownerId: string;
+    /** Model metadata used to build marketplace search queries */
+    searchContext?: {
+        title?: string;
+        tags?: string[];
+        category?: string;
+        description?: string;
+        materials?: string[];
+    };
+    /** Configuration for the marketplace scraping */
+    scrapingOptions?: {
+        targetMarketplaces?: string[];
+        maxResultsPerMarketplace?: number;
+        maxPages?: number;
+        includeMetrics?: boolean;
+        includeReviews?: boolean;
+    };
+    /** Pipeline execution ID for correlation */
+    pipelineId?: string;
+    /** Pipeline execution UUID for correlation */
+    executionId?: string;
+}
 /**
  * Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp) and suggested price.
  */
@@ -540,9 +918,21 @@ export interface MarketplaceListingDescriptionGenerationCompletedMessage {
     /** SEO-optimized marketplace description (3-5 sentences) */
     description: string;
     /** Content generation metadata for tracking */
-    metadata: Record<string, string | number | boolean>;
+    metadata: {
+        source: string;
+        generatedAt: string;
+        aiModel: string;
+        confidence: number;
+    };
     /** Volume-based price calculation for 3D printed item */
-    suggestedPrice?: Record<string, string | number | boolean>;
+    suggestedPrice?: {
+        suggestedPrice?: number;
+        currency?: string;
+        materialCost?: number;
+        laborCost?: number;
+        marketplaceMarkup?: number;
+        breakdown?: Record<string, unknown>;
+    };
     /** Error message if generation failed */
     error?: string;
 }
@@ -563,11 +953,17 @@ export interface MarketplaceListingDescriptionGenerationRequestMessage {
     /** Callback URL for completion notification */
     webhookUrl?: string;
     /** Technical analysis data for context */
-    technicalMetadata?: Record<string, string | number | boolean>;
+    technicalMetadata?: {
+        vertices?: number;
+        faces?: number;
+        volumeMm3?: number;
+        dimensionsMm?: number[];
+        isWatertight?: boolean;
+    };
     /** URLs to 360-degree thumbnail views */
-    thumbnailUrls?: Array<Record<string, string | number | boolean>>;
+    thumbnailUrls?: string[];
     /** Currently assigned tags for context */
-    existingTags?: Array<Record<string, string | number | boolean>>;
+    existingTags?: string[];
     /** Current classification for context */
     existingCategory?: string;
     /** Desired tone/voice for the listing (e.g., 'professional', 'playful') */
@@ -575,7 +971,7 @@ export interface MarketplaceListingDescriptionGenerationRequestMessage {
     /** Target geographic market (e.g., 'US', 'EU') */
     targetMarket?: string;
     /** Specific keywords to include */
-    keywords?: Array<Record<string, string | number | boolean>>;
+    keywords?: string[];
 }
 /**
  * Notification that marketplace listing sync operation has completed. Contains detailed results of the sync including created/updated listings, errors encountered, and performance statistics.
@@ -595,15 +991,56 @@ export interface MarketplaceListingSyncCompletedMessage {
     /** Direction of sync that was performed */
     syncDirection?: string;
     /** Detailed sync operation statistics */
-    statistics?: Record<string, string | number | boolean>;
+    statistics?: {
+        duration?: number;
+        listingsProcessed?: number;
+        listingsCreated?: number;
+        listingsUpdated?: number;
+        listingsSkipped?: number;
+        listingsFailed?: number;
+        imagesProcessed?: number;
+        variationsProcessed?: number;
+    };
     /** Detailed sync results by operation */
-    results?: Record<string, string | number | boolean>;
+    results?: {
+        pull?: {
+            listingsRetrieved?: number;
+            newListingsCreated?: number;
+            existingListingsUpdated?: number;
+        };
+        push?: {
+            listingsPushed?: number;
+            listingsCreated?: number;
+            listingsUpdated?: number;
+        };
+    };
     /** Details of successfully processed listings */
-    successfulListings?: Array<Record<string, string | number | boolean>>;
+    successfulListings?: Array<{
+        internalId?: string;
+        externalId?: string;
+        title?: string;
+        operation?: string;
+        timestamp?: string;
+    }>;
     /** Details of listings that failed to sync */
-    failedListings?: Array<Record<string, string | number | boolean>>;
+    failedListings?: Array<{
+        internalId?: string;
+        externalId?: string;
+        title?: string;
+        error?: {
+            code?: string;
+            message?: string;
+            details?: Record<string, unknown>;
+        };
+        timestamp?: string;
+    }>;
     /** Non-listing-specific errors encountered */
-    errors?: Array<Record<string, string | number | boolean>>;
+    errors?: Array<{
+        type?: string;
+        message?: string;
+        timestamp?: string;
+        details?: Record<string, unknown>;
+    }>;
     /** When sync operation completed */
     completedAt?: string;
     /** When next sync is recommended */
@@ -626,11 +1063,17 @@ export interface MarketplaceListingSyncRequestMessage {
     /** Scope of listings to sync */
     syncScope?: string;
     /** Specific listing IDs to sync (if syncScope=specific) */
-    listingIds?: Array<Record<string, string | number | boolean>>;
+    listingIds?: string[];
     /** External marketplace listing IDs to sync */
-    externalListingIds?: Array<Record<string, string | number | boolean>>;
+    externalListingIds?: string[];
     /** Sync configuration options */
-    options?: Record<string, string | number | boolean>;
+    options?: {
+        includeInactive?: boolean;
+        includeImages?: boolean;
+        includeVariations?: boolean;
+        includeAnalytics?: boolean;
+        batchSize?: number;
+    };
     /** Processing priority */
     priority?: string;
     /** Unique request identifier */
@@ -638,7 +1081,11 @@ export interface MarketplaceListingSyncRequestMessage {
     /** Webhook URL for completion notification */
     webhookUrl?: string;
     /** Additional request context */
-    metadata?: Record<string, string | number | boolean>;
+    metadata?: {
+        source?: string;
+        scheduledSync?: boolean;
+        retryCount?: number;
+    };
 }
 /**
  * Notifies backend that marketplace tags generation completed. Contains generated tags optimized for discoverability with metadata tracking.
@@ -649,9 +1096,14 @@ export interface MarketplaceListingTagsGenerationCompletedMessage {
     /** Type of entity processed */
     entityType: string;
     /** Generated searchability tags (style, technical, usage keywords) */
-    tags: Array<Record<string, string | number | boolean>>;
+    tags: string[];
     /** Content generation metadata for tracking */
-    metadata: Record<string, string | number | boolean>;
+    metadata: {
+        source: string;
+        generatedAt: string;
+        aiModel: string;
+        confidence: number;
+    };
     /** Error message if generation failed */
     error?: string;
 }
@@ -672,11 +1124,17 @@ export interface MarketplaceListingTagsGenerationRequestMessage {
     /** Callback URL for completion notification */
     webhookUrl?: string;
     /** Technical analysis data for tag generation */
-    technicalMetadata?: Record<string, string | number | boolean>;
+    technicalMetadata?: {
+        vertices?: number;
+        faces?: number;
+        volumeMm3?: number;
+        dimensionsMm?: number[];
+        isWatertight?: boolean;
+    };
     /** URLs to 360-degree thumbnail views for visual analysis */
-    thumbnailUrls?: Array<Record<string, string | number | boolean>>;
+    thumbnailUrls?: string[];
     /** Currently assigned tags to supplement or replace */
-    existingTags?: Array<Record<string, string | number | boolean>>;
+    existingTags?: string[];
     /** Current classification for category-based tags */
     existingCategory?: string;
     /** Maximum number of tags for marketplace (e.g., 13 for Etsy) */
@@ -686,7 +1144,7 @@ export interface MarketplaceListingTagsGenerationRequestMessage {
     /** Artistic style of the model (e.g., 'realistic', 'low-poly') */
     style?: string;
     /** Intended uses for the model */
-    useCases?: Array<Record<string, string | number | boolean>>;
+    useCases?: string[];
 }
 /**
  * Notifies backend that marketplace title generation completed. Contains generated title with metadata tracking.
@@ -699,7 +1157,12 @@ export interface MarketplaceListingTitleGenerationCompletedMessage {
     /** Marketplace-optimized title */
     title: string;
     /** Content generation metadata for tracking */
-    metadata: Record<string, string | number | boolean>;
+    metadata: {
+        source: string;
+        generatedAt: string;
+        aiModel: string;
+        confidence: number;
+    };
     /** Error message if generation failed */
     error?: string;
 }
@@ -720,9 +1183,13 @@ export interface MarketplaceListingTitleGenerationRequestMessage {
     /** Callback URL for completion notification */
     webhookUrl?: string;
     /** Technical analysis data for context */
-    technicalMetadata?: Record<string, string | number | boolean>;
+    technicalMetadata?: {
+        vertices?: number;
+        faces?: number;
+        dimensionsMm?: number[];
+    };
     /** Currently assigned tags for SEO keywords */
-    existingTags?: Array<Record<string, string | number | boolean>>;
+    existingTags?: string[];
     /** Current classification for categorization */
     existingCategory?: string;
     /** Maximum character count for marketplace (e.g., 140 for Etsy) */
@@ -732,7 +1199,7 @@ export interface MarketplaceListingTitleGenerationRequestMessage {
     /** Target geographic market (e.g., 'US', 'EU') */
     targetMarket?: string;
     /** Specific keywords to include */
-    keywords?: Array<Record<string, string | number | boolean>>;
+    keywords?: string[];
 }
 /**
  * Result of a listing update operation
@@ -745,7 +1212,7 @@ export interface MarketplaceListingUpdateCompletedMessage {
     /** Status of the update (success, failed) */
     status?: string;
     /** Result details from the marketplace API */
-    result?: Record<string, string | number | boolean>;
+    result?: Record<string, unknown>;
     /** Error message if failed */
     error?: string;
 }
@@ -758,65 +1225,21 @@ export interface MarketplaceListingUpdateRequestMessage {
     /** External ID of the listing to update */
     listingId?: string;
     /** Fields to update */
-    updates?: Record<string, string | number | boolean>;
+    updates?: {
+        price?: number;
+        quantity?: number;
+        title?: string;
+        description?: string;
+        tags?: string[];
+    };
     /** User credentials for the marketplace */
-    credentials?: Record<string, string | number | boolean>;
-}
-/**
- * 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.).
- */
-export interface MarketplacePublishListingCompletedMessage {
-    /** BullMQ job ID from original request */
-    originalJobId?: string;
-    /** Internal marketplace_items UUID */
-    listingId?: string;
-    /** UUID of the metamodel that was published */
-    metamodelId?: string;
-    /** Marketplace provider type (etsy, ebay, etc.) */
-    marketplaceProvider?: string;
-    /** Material variant name */
-    materialName?: string;
-    /** Publication result (SUCCESS or FAILED) */
-    status?: string;
-    /** External marketplace listing ID (only if status=SUCCESS) */
-    externalListingId?: string;
-    /** URL to view listing on marketplace (only if status=SUCCESS) */
-    externalListingUrl?: string;
-    /** External marketplace file ID (only if status=SUCCESS) */
-    externalFileId?: string;
-    /** Error details (only if status=FAILED) */
-    error?: Record<string, string | number | boolean>;
-    /** When the listing was created (ISO 8601, only if status=SUCCESS) */
-    publishedAt?: string;
-    /** Processing time in milliseconds */
-    processingDuration?: string | number | boolean;
-}
-/**
- * Publishes a single metamodel listing to a marketplace for a specific material variant. Creates listing, uploads digital file, and returns external listing ID. This message is enqueued for EACH material variant when publishing a metamodel. The marketplace type (etsy, ebay, etc.) is determined by the marketplaceProvider field.
- */
-export interface MarketplacePublishListingRequestMessage {
-    /** Internal marketplace_items table UUID */
-    listingId?: string;
-    /** UUID of the metamodel being published */
-    metamodelId?: string;
-    /** UUID of the user who owns the metamodel */
-    ownerId?: string;
-    /** Marketplace provider type (etsy, ebay, leboncoin, etc.) */
-    marketplaceProvider?: string;
-    /** UUID of the marketplace connection configuration */
-    marketplaceConnectionId?: string;
-    /** Material-specific listing configuration */
-    materialVariant?: Record<string, string | number | boolean>;
-    /** Common listing information shared across variants */
-    baseListingData?: Record<string, string | number | boolean>;
-    /** Publishing configuration (marketplace-specific options) */
-    publishOptions?: Record<string, string | number | boolean>;
-    /** Encrypted marketplace credentials (retrieved from marketplaceConnectionId) */
-    marketplaceCredentials?: Record<string, string | number | boolean>;
-    /** Digital file to upload */
-    fileMetadata?: Record<string, string | number | boolean>;
-    /** Callback URL for completion notification */
-    webhookUrl?: string;
+    credentials?: {
+        access_token?: string;
+        refresh_token?: string;
+        expires_at?: number;
+        api_key?: string;
+        api_secret?: string;
+    };
 }
 /**
  * Notifies that a batch media download has been completed.
@@ -827,13 +1250,36 @@ export interface MediaBatchDownloadCompletedMessage {
     /** The final status of the batch download operation. */
     status: string;
     /** List of successfully processed files. */
-    processedFiles?: Array<Record<string, string | number | boolean>>;
+    processedFiles?: Array<{
+        originalPath: string;
+        originalName?: string;
+        s3Location: {
+            bucket?: string;
+            key?: string;
+            url?: string;
+        };
+        processedType?: string;
+        originalSize?: number;
+        processedSize?: number;
+        compressionRatio?: number;
+    }>;
     /** List of files that failed to process. */
-    failedFiles?: Array<Record<string, string | number | boolean>>;
+    failedFiles?: Array<{
+        path?: string;
+        error?: string;
+    }>;
     /** Timestamp when the batch processing completed. */
     processedAt: string;
     /** Statistics about the batch processing. */
-    statistics?: Record<string, string | number | boolean>;
+    statistics?: {
+        totalFiles?: number;
+        successfulFiles?: number;
+        failedFiles?: number;
+        totalOriginalSize?: number;
+        totalProcessedSize?: number;
+        averageCompressionRatio?: number;
+        processingDuration?: number;
+    };
 }
 /**
  * Request to download and process a batch of media files from a storage provider. Images are compressed and resized to specified dimensions, converted to WebP format. Text files and documents are processed and stored with metadata. All processed files are uploaded to MinIO S3 storage under the media/{batchId}/ prefix.
@@ -857,13 +1303,28 @@ export interface MediaBatchDownloadRequestMessage {
     storageConnectionId?: string;
     /** Decrypted credentials for the storage provider (Fat Payload pattern). Required when downloadStrategy is 'storage_provider'.
    */
-    credentials?: Record<string, string | number | boolean>;
+    credentials?: {
+        provider?: string;
+        accessToken?: string;
+        refreshToken?: string;
+        clientId?: string;
+        clientSecret?: string;
+        host?: string;
+        username?: string;
+        password?: string;
+        port?: number;
+    };
     /** Array of media files to download and process. Must contain at least one file. Each file includes metadata for identification and processing.
    */
-    mediaFiles?: Array<Record<string, string | number | boolean>>;
+    mediaFiles?: Array<unknown>;
     /** Optional compression settings that override deployment environment defaults. If not provided, uses values from MAX_IMAGE_WIDTH, MAX_IMAGE_HEIGHT, IMAGE_QUALITY, and OUTPUT_FORMAT environment variables.
    */
-    compressionSettings?: Record<string, string | number | boolean>;
+    compressionSettings?: {
+        maxWidth?: number;
+        maxHeight?: number;
+        imageQuality?: number;
+        outputFormat?: string;
+    };
 }
 /**
  * Handles metamodel metadata generation completion. Contains AI-generated metadata and aggregated technical analysis.
@@ -872,9 +1333,99 @@ export interface MetamodelMetadataGenerationCompletedMessage {
     /** The unique identifier for the metamodel */
     metamodelId: string;
     /** AI-generated metadata for the metamodel */
-    metadata: Record<string, string | number | boolean>;
+    metadata: {
+        classification: {
+            primary_category?: string;
+            sub_category?: string;
+            confidence?: number;
+            reasoning?: string[];
+        };
+        printTechnology: {
+            recommended?: string;
+            confidence?: number;
+            reasoning?: string[];
+            constituentsAnalysis?: {
+                fdmCompatible?: number;
+                resinRequired?: number;
+                totalParts?: number;
+            };
+        };
+        franchise: {
+            name?: string;
+            universe?: string;
+            confidence?: number;
+            licensingInfo?: string;
+        };
+        tagDataJson: {
+            style?: string[];
+            technical?: string[];
+            source?: string[];
+            quality?: string[];
+            scale?: string[];
+            usage?: string[];
+            custom?: string[];
+        };
+        assemblyMetadata: {
+            totalParts?: number;
+            complexity?: string;
+            estimatedAssemblyTime?: number;
+            requiresGlue?: boolean;
+            requiresPainting?: boolean;
+            requiresSupports?: boolean;
+            instructions?: {
+                url?: string;
+                embedded?: string;
+            };
+        };
+        aiGenerationMetadata: {
+            workerVersion?: string;
+            ollamaModels?: string[];
+            totalResponses?: number;
+            processingTimeSeconds?: number;
+            promptTokens?: number;
+            completionTokens?: number;
+            generatedAt?: string;
+        };
+        generatedDescription: string;
+        pricing: Record<string, unknown>;
+        marketplaceListingsJson: Record<string, unknown>;
+    };
     /** Aggregated technical analysis from constituent models */
-    technicalMetadata: Record<string, string | number | boolean>;
+    technicalMetadata: {
+        totalVertices: number;
+        totalFaces: number;
+        totalEdges: number;
+        averageDetailLevel: string;
+        assembledBoundingBox: {
+            width?: number;
+            height?: number;
+            depth?: number;
+            originalUnit?: string;
+        };
+        totalVolumeCubicMm: number;
+        totalSurfaceAreaSqMm: number;
+        allPartsManifold: boolean;
+        lowestQualityScore: number;
+        lowestPrintabilityScore: number;
+        partsRequiringRepair: number;
+        partsWithThinWalls: number;
+        constituentModels: Array<{
+            modelId?: string;
+            name?: string;
+            orderIndex?: number;
+            purpose?: string;
+            isOptional?: boolean;
+        }>;
+        validationStatus: {
+            allPartsPresent?: boolean;
+            allPartsAnalyzed?: boolean;
+            assemblyInstructionsComplete?: boolean;
+            minimumQualityMet?: boolean;
+            readyForMarketplace?: boolean;
+        };
+        analyzedAt: string;
+        analysisVersion: string;
+    };
 }
 /**
  * Handles metamodel metadata generation requests via Ollama. Aggregates data from constituent models and generates AI-enhanced metadata.
@@ -883,7 +1434,7 @@ export interface MetamodelMetadataGenerationRequestMessage {
     /** The unique identifier for the metamodel */
     metamodelId?: string;
     /** Array of model IDs that compose this metamodel */
-    constituentModelIds?: Array<Record<string, string | number | boolean>>;
+    constituentModelIds?: string[];
     /** The name of the metamodel */
     name?: string;
     /** The owner's user ID */
@@ -891,7 +1442,19 @@ export interface MetamodelMetadataGenerationRequestMessage {
     /** The library containing this metamodel */
     libraryId?: string;
     /** Enriched metadata for constituent models (includes storage items) */
-    constituentModels?: Array<Record<string, string | number | boolean>>;
+    constituentModels?: Array<{
+        modelId?: string;
+        name?: string;
+        storageConnectionId?: string;
+        storageItems?: Array<{
+            path?: string;
+            mimeType?: string;
+            size?: number;
+            s3Key?: string;
+            bucket?: string;
+            isImage?: boolean;
+        }>;
+    }>;
     /** Optional webhook URL for async completion notification */
     webhookUrl?: string;
 }
@@ -913,7 +1476,7 @@ export interface ModelAnalyticsCollectionRequestMessage {
     /** Sub-category for more specific targeting */
     subCategory?: string;
     /** Relevant tags from metamodel metadata (max 10) */
-    tags?: Array<Record<string, string | number | boolean>>;
+    tags?: string[];
     /** Franchise name if detected (e.g., "Dungeons & Dragons") */
     franchise?: string;
     /** Classification confidence score */
@@ -934,13 +1497,29 @@ export interface ModelDiscoveryFolderProcessedEventMessage {
     /** The path to the processed folder. */
     folderPath?: string;
     /** A list of files discovered in the folder. */
-    discoveredFiles?: Array<Record<string, string | number | boolean>>;
+    discoveredFiles?: Array<{
+        path: string;
+        name: string;
+        size: number;
+        modifiedAt: string;
+    }>;
     /** A signature representing the state of the folder. */
-    folderSignature?: Record<string, string | number | boolean>;
+    folderSignature?: {
+        hash: string;
+        calculatedAt: string;
+    };
     /** The timestamp when the folder was processed. */
     processedAt?: string;
     /** Statistics about the processed folder. */
-    statistics?: Record<string, string | number | boolean>;
+    statistics?: {
+        totalFiles: number;
+        modelFiles: number;
+        mediaFiles: number;
+        accessoryFiles: number;
+        totalFolders: number;
+        totalSize: number;
+        processingDuration: number;
+    };
 }
 /**
  * Handles model discovery scan found events.
@@ -955,22 +1534,34 @@ export interface ModelDiscoveryScanFoundEventMessage {
     /** A description of the model. */
     description?: string;
     /** An array of file types associated with the model. */
-    fileTypes?: Array<Record<string, string | number | boolean>>;
+    fileTypes?: string[];
     /** The size of the model file in bytes. */
     size?: number;
     /** The storage location of the model. */
-    storageLocation?: Record<string, string | number | boolean>;
+    storageLocation?: {
+        storageConnectionId: string;
+        path: string;
+        libraryId: string;
+        ownerId: string;
+    };
     /** The type of the storage provider. */
     providerType?: string;
     /** A flexible object for additional metadata. */
-    metadata?: Record<string, string | number | boolean>;
+    metadata?: Record<string, unknown>;
 }
 /**
  * Handles model discovery scan progress events.
  */
 export interface ModelDiscoveryScanProgressEventMessage {
     /** Contains the discovery scan progress details. */
-    payload?: Record<string, string | number | boolean>;
+    payload?: {
+        jobId: string;
+        storageConnectionId: string;
+        status: string;
+        message: string;
+        progress: number;
+        error?: string;
+    };
 }
 /**
  * Handles model discovery scan requests events.
@@ -985,30 +1576,34 @@ export interface ModelDiscoveryScanRequestMessage {
     /** The specific path within the storage connection to scan for this library. */
     path?: string;
     /** Decrypted credentials for the storage provider. */
-    credentials?: Record<string, string | number | boolean>;
+    credentials?: Record<string, unknown>;
     /** Configuration for the storage connection (e.g. scanRootPath). */
-    configuration?: Record<string, string | number | boolean>;
+    configuration?: Record<string, unknown>;
 }
 /**
- * Request to index a 3D model for similarity search.
+ * DEPRECATED (2026-02-18) — FR-023 retired. Merge 3D rendering into worker-file-vectorize.
  */
 export interface ModelFinderIndexRequestMessage {
     /**  */
     modelId?: string;
     /**  */
-    storageItem?: string | number | boolean;
+    storageItem?: unknown;
 }
 /**
- * Response containing search results from the model finder.
+ * DEPRECATED (2026-02-18) — FR-023 retired. Merge 3D rendering into worker-file-vectorize.
  */
 export interface ModelFinderResponseMessage {
     /**  */
     requestId?: string;
     /**  */
-    results?: Array<Record<string, string | number | boolean>>;
+    results?: Array<{
+        modelId?: string;
+        similarity?: number;
+        metamodelIds?: string[];
+    }>;
 }
 /**
- * Request to search for similar 3D models.
+ * DEPRECATED (2026-02-18) — FR-023 retired. Merge 3D rendering into worker-file-vectorize.
  */
 export interface ModelFinderSearchRequestMessage {
     /** Optional: Search using an existing model as reference */
@@ -1016,7 +1611,7 @@ export interface ModelFinderSearchRequestMessage {
     /** Optional: Search using an uploaded image */
     referenceImageId?: string;
     /**  */
-    limit?: string | number | boolean;
+    limit?: number;
 }
 /**
  * Notifies backend that enriched marketplace metadata generation completed. Backend updates Model entity with generated description, tags, classification, etc.
@@ -1025,7 +1620,12 @@ export interface ModelMetadataGenerationCompletedMessage {
     /** UUID of the model that was processed. */
     modelId: string;
     /** Enriched marketplace metadata generated by LLM. */
-    metadata: Record<string, string | number | boolean>;
+    metadata: {
+        description: string;
+        tags: string[];
+        primaryCategory: string;
+        subCategory: string;
+    };
 }
 /**
  * Generates enriched marketplace metadata (SEO descriptions, tags, categories) for 3D models using LLM vision analysis. Worker receives all necessary data in the payload (Model, TechnicalMetadata, Thumbnails) and does NOT query the database. Prerequisites: file download, technical metadata, and thumbnail generation must be complete before this message is sent.
@@ -1034,20 +1634,89 @@ export interface ModelMetadataGenerationRequestMessage {
     /** UUID of the model (reference only) */
     modelId?: string;
     /** Core model entity data */
-    model?: Record<string, string | number | boolean>;
+    model?: {
+        name?: string;
+        fileName?: string;
+        fileSize?: number;
+        ownerId?: string;
+    };
     /** Geometric and technical analysis results */
-    technicalMetadata?: Record<string, string | number | boolean>;
+    technicalMetadata?: {
+        vertices?: number;
+        faces?: number;
+        volumeMm3?: number;
+        dimensionsMm?: number[];
+        isWatertight?: boolean;
+        boundingBox?: Record<string, unknown>;
+    };
     /** List of 360 degree thumbnail views (URLs or paths) */
-    thumbnails?: Array<Record<string, string | number | boolean>>;
+    thumbnails?: Array<{
+        id?: string;
+        url?: string;
+        angle?: number;
+    }>;
 }
 /**
  * Handles model metamodel detection found with hierarchical relationships.
  */
 export interface ModelMetamodelDetectionFoundMessage {
     /** List of metamodel nodes in hierarchical structure (roots and children). */
-    metamodels: Array<Record<string, string | number | boolean>>;
+    metamodels: Array<{
+        internalId: string;
+        name: string;
+        storageItemIds?: string[];
+        childMetamodelIds?: string[];
+        parentMetamodelId?: string;
+        confidenceScore: number;
+        libraryId: string;
+        mediaBatchId?: string;
+        metaModelType?: string;
+        metadata?: {
+            level?: number;
+            sku?: string;
+            scale?: string;
+            creator?: string;
+            isVariant?: boolean;
+            partType?: string;
+            source?: string;
+            thingId?: string;
+            url?: string;
+            thumbnail?: string;
+            mediaUrls?: Array<{
+                url: string;
+                name?: string;
+                type?: string;
+                metadata?: {
+                    mediaType?: string;
+                    isPrimary?: boolean;
+                    width?: number;
+                    height?: number;
+                    thingId?: string;
+                    fileId?: string;
+                };
+            }>;
+        };
+    }>;
     /** EKG edges derived from Louvain clustering (OPTIONAL - new field) */
-    ekgEdges?: Array<Record<string, string | number | boolean>>;
+    ekgEdges?: Array<{
+        sourceMetamodelId: string;
+        targetId?: string;
+        targetType?: string;
+        massFunction: {
+            related?: number;
+            unrelated?: number;
+            uncertainty?: number;
+        };
+        heuristicContributions?: Array<{
+            name?: string;
+            belief?: number;
+        }>;
+        louvainMetadata?: {
+            communityId?: string;
+            modularity?: number;
+            edgeWeight?: number;
+        };
+    }>;
 }
 /**
  * Handles model metamodel detection requests.
@@ -1058,15 +1727,91 @@ export interface ModelMetamodelDetectionRequestMessage {
     /** The path to the folder that was processed. */
     folderPath: string;
     /** A list of files discovered in the folder. Worker should check this first, then manifestUrl. */
-    discoveredFiles?: Array<Record<string, string | number | boolean>>;
+    discoveredFiles?: Array<{
+        path: string;
+        name: string;
+        size: number;
+        modifiedAt: string;
+    }>;
     /** URL to a JSON file containing the list of discovered files (for large folders) */
     manifestUrl?: string;
     /** A signature representing the state of the folder. */
-    folderSignature: Record<string, string | number | boolean>;
+    folderSignature: {
+        hash: string;
+        calculatedAt: string;
+    };
     /** The timestamp when the folder was processed. */
     processedAt: string;
     /** Statistics about the processed folder. */
-    statistics: Record<string, string | number | boolean>;
+    statistics: {
+        totalFiles: number;
+        modelFiles: number;
+        mediaFiles: number;
+        accessoryFiles: number;
+        totalFolders: number;
+        totalSize: number;
+        processingDuration: number;
+    };
+}
+/**
+ * Reports completion of 3D print analysis — contains estimation, printability, and cost breakdown per FR-022
+ */
+export interface ModelPrintAnalysisCompletedMessage {
+    /** ID of the original analysis request job */
+    originalJobId?: string;
+    /** UUID of the analysed model */
+    modelId?: string;
+    /** Analysis result status */
+    status?: string;
+    /** Error description when status is FAILED */
+    errorMessage?: string;
+    /** Material type used for estimation */
+    material?: string;
+    /** Quality preset used */
+    quality?: string;
+    /** Estimated total print time in minutes */
+    printTimeMinutes?: number;
+    /** Estimated material consumption in grams (body only) */
+    materialGrams?: number;
+    /** Whether the model requires support structures */
+    needsSupport?: boolean;
+    /** Estimated support material in grams */
+    supportMaterialGrams?: number;
+    /** Percentage of surface area with overhangs > 45° */
+    overhangPercentage?: number;
+    /** Thinnest detected wall in millimeters */
+    minWallThicknessMm?: number;
+    /** Solid volume of the mesh in cm³ */
+    solidVolumeCm3?: number;
+    /** Total surface area in cm² */
+    surfaceAreaCm2?: number;
+    /** Bounding box in millimeters */
+    boundingBox?: {
+        x?: number;
+        y?: number;
+        z?: number;
+    };
+    /** Total estimated production cost in EUR */
+    estimatedCostEUR?: number;
+    /** Granular cost breakdown per WF-009 MaterialCostCalculatorService */
+    costBreakdown?: Record<string, unknown>;
+}
+/**
+ * Triggers 3D print analysis for a model — estimates print time, material usage, support needs, and cost breakdown per FR-022
+ */
+export interface ModelPrintAnalysisRequestMessage {
+    /** UUID of the model to analyse */
+    modelId?: string;
+    /** UUID of the user who owns the model */
+    ownerId?: string;
+    /** Material type enum value (e.g. PLA, PETG, RESIN_STANDARD) */
+    material?: string;
+    /** Print quality preset */
+    quality?: string;
+    /** URL called when analysis completes or fails */
+    webhookUrl?: string;
+    /** Path to model in MinIO storage for geometry analysis (e.g. 'raw_models/{modelId}/original.glb') */
+    minioPath?: string;
 }
 /**
  * Contains sellability analysis results including Etsy-specific recommendations, material pricing, and marketplace compatibility scores
@@ -1079,21 +1824,67 @@ export interface ModelSellabilityAnalysisCompletedMessage {
     /** Overall sellability score (0-100) */
     sellabilityScore?: number;
     /** Pricing analysis and recommendations with material-specific pricing (v2.0.0) */
-    pricingRecommendations?: Record<string, string | number | boolean>;
+    pricingRecommendations?: {
+        suggestedPrice?: number;
+        priceRange?: {
+            min?: number;
+            max?: number;
+            median?: number;
+        };
+        competitorAverage?: number;
+        materialPricing?: Record<string, unknown>;
+        factors?: Array<{
+            factor?: string;
+            impact?: string;
+            description?: string;
+        }>;
+    };
     /** Recommended marketplaces with Etsy-specific scoring (v2.0.0) */
-    marketplaceRecommendations?: Array<Record<string, string | number | boolean>>;
+    marketplaceRecommendations?: Array<{
+        marketplace?: string;
+        compatibilityScore?: number;
+        reasoning?: string;
+        estimatedReach?: number;
+        platformFee?: number;
+        etsySpecificData?: {
+            categoryFitScore?: number;
+            recommendedMaterials?: string[];
+            estimatedTimeToFirstSale?: string;
+        };
+    }>;
     /** Market demand insights */
-    demandAnalysis?: Record<string, string | number | boolean>;
+    demandAnalysis?: {
+        categoryDemand?: string;
+        trendingScore?: number;
+        searchVolume?: number;
+        competitionLevel?: string;
+        trendDirection?: string;
+    };
     /** Quality-related factors affecting sellability */
-    qualityFactors?: Record<string, string | number | boolean>;
+    qualityFactors?: {
+        technicalQuality?: number;
+        printability?: number;
+        uniqueness?: number;
+        marketFit?: number;
+    };
     /** Actionable recommendations to improve sellability */
-    recommendations?: Array<Record<string, string | number | boolean>>;
+    recommendations?: Array<{
+        category?: string;
+        priority?: string;
+        title?: string;
+        description?: string;
+        expectedImpact?: string;
+    }>;
     /** Analysis completion timestamp (ISO 8601) */
     analyzedAt?: string;
     /** Analysis algorithm version */
     analysisVersion?: string;
     /** Error information if analysis failed */
-    error?: Record<string, string | number | boolean>;
+    error?: {
+        code?: string;
+        message?: string;
+        details?: Record<string, unknown>;
+    };
 }
 /**
  * Analyzes a metamodel to determine sellability score, pricing recommendations, and optimal marketplace selection. Enhanced with Etsy-specific analysis including competitor pricing, category demand trends, and material suitability.
@@ -1104,11 +1895,21 @@ export interface ModelSellabilityAnalysisRequestMessage {
     /** UUID of the user who owns the metamodel */
     ownerId?: string;
     /** Full metamodel data including technical metadata, enriched metadata, and child models. Injected by backend to avoid DB access. */
-    metamodelData?: Record<string, string | number | boolean>;
+    metamodelData?: Record<string, unknown>;
     /** URL to a JSON manifest containing the metamodel data if it is too large for the message payload. */
     manifestUrl?: string;
     /** Optional analysis configuration */
-    analysisOptions?: Record<string, string | number | boolean>;
+    analysisOptions?: {
+        targetMarketplaces?: string[];
+        competitorAnalysis?: boolean;
+        demandAnalysis?: boolean;
+        includeChildModels?: boolean;
+        etsyAnalysisOptions?: {
+            analyzeMaterialSuitability?: boolean;
+            fetchEtsyTrends?: boolean;
+            competitorCount?: number;
+        };
+    };
 }
 /**
  * Handles completion of 3D model semantic analysis with generated tags and similarity results.
@@ -1121,15 +1922,61 @@ export interface ModelSemanticAnalysisCompletedMessage {
     /** Final processing status. */
     processingStatus?: string;
     /** Generated semantic metadata and analysis results. */
-    semanticMetadata?: Record<string, string | number | boolean>;
+    semanticMetadata?: {
+        semanticTags?: Array<{
+            tagName?: string;
+            confidence?: number;
+            category?: string;
+        }>;
+        embedding?: number[];
+        similarModels?: Array<{
+            modelId?: string;
+            similarity?: number;
+            metadata?: Record<string, unknown>;
+        }>;
+        geometricFeatures?: {
+            vertexCount?: number;
+            faceCount?: number;
+            volume?: number;
+            surfaceArea?: number;
+            boundingBox?: {
+                width?: number;
+                height?: number;
+                depth?: number;
+            };
+            isWatertight?: boolean;
+            hasTextureCoords?: boolean;
+            complexity?: string;
+        };
+    };
     /** Processing performance metrics. */
-    processingTime?: Record<string, string | number | boolean>;
+    processingTime?: {
+        totalTimeMs?: number;
+        geometryTimeMs?: number;
+        neuralTimeMs?: number;
+        searchTimeMs?: number;
+    };
     /** Processing quality and confidence metrics. */
-    qualityMetrics?: Record<string, string | number | boolean>;
+    qualityMetrics?: {
+        overallConfidence?: number;
+        tagCount?: number;
+        duplicateDetected?: boolean;
+        knowledgeBaseUpdated?: boolean;
+    };
     /** Error information if processing failed. */
-    error?: Record<string, string | number | boolean>;
+    error?: {
+        message?: string;
+        category?: string;
+        retryable?: boolean;
+        technicalDetails?: string;
+    };
     /** Additional debug information for troubleshooting. */
-    debugInfo?: Record<string, string | number | boolean>;
+    debugInfo?: {
+        workerVersion?: string;
+        processingNode?: string;
+        gpuUsed?: boolean;
+        memoryUsageMb?: number;
+    };
 }
 /**
  * Handles 3D model semantic analysis requests using ULIP-2 neural networks and FAISS vector similarity search.
@@ -1150,7 +1997,13 @@ export interface ModelSemanticAnalysisRequestMessage {
     /** The type of the storage provider (S3, GoogleDrive, SFTP, etc). */
     storageProviderType?: string;
     /** Configuration options for semantic analysis. */
-    processingOptions?: Record<string, string | number | boolean>;
+    processingOptions?: {
+        pointCloudSize?: number;
+        similarityThreshold?: number;
+        similarityK?: number;
+        enableDuplicateDetection?: boolean;
+        generateThumbnail?: boolean;
+    };
     /** Processing priority (1=highest, 10=lowest). */
     priority?: number;
     /** Optional webhook URL for completion notification. */
@@ -1169,15 +2022,20 @@ export interface ModelTechnicalMetadataCompletedMessage {
     /** Analysis completion status */
     status?: string;
     /** Number of vertices in the mesh */
-    vertices?: string | number | boolean;
+    vertices?: number;
     /** Number of faces/polygons in the mesh */
-    faces?: string | number | boolean;
+    faces?: number;
     /** Number of edges in the mesh */
-    edges?: string | number | boolean;
+    edges?: number;
     /** Visual detail level based on polygon density */
     detailLevel?: string;
     /** 3D bounding box dimensions in millimeters */
-    boundingBox?: Record<string, string | number | boolean>;
+    boundingBox?: {
+        width?: number;
+        height?: number;
+        depth?: number;
+        originalUnit?: string;
+    };
     /** Model volume in cubic millimeters (for material calculation) */
     volumeCubicMm?: number;
     /** Total surface area in square millimeters */
@@ -1189,13 +2047,13 @@ export interface ModelTechnicalMetadataCompletedMessage {
     /** Is the mesh watertight/manifold? Critical for 3D printing (true = printable) */
     manifold?: boolean;
     /** Number of non-manifold edges (repair needed if > 0) */
-    nonManifoldEdges?: string | number | boolean;
+    nonManifoldEdges?: number;
     /** Number of holes/boundary loops in the mesh (0 = closed mesh) */
-    holes?: string | number | boolean;
+    holes?: number;
     /** Number of faces with inverted normals (causes rendering/slicing issues) */
-    flippedNormals?: string | number | boolean;
+    flippedNormals?: number;
     /** Number of self-intersecting faces (0 = clean geometry) */
-    selfIntersections?: string | number | boolean;
+    selfIntersections?: number;
     /** Overall quality score 0-100 (100 = perfect for printing, <60 needs repair) */
     qualityScore?: number;
     /** Printability score 0-100 (considers supports, orientation, size constraints) */
@@ -1203,17 +2061,47 @@ export interface ModelTechnicalMetadataCompletedMessage {
     /** Does this model require support structures for 3D printing? */
     requiresSupports?: boolean;
     /** Detected overhang areas requiring support structures */
-    overhangs?: Array<Record<string, string | number | boolean>>;
+    overhangs?: Array<{
+        angle?: number;
+        area?: number;
+        location?: string;
+    }>;
     /** Estimated print time in minutes using normal quality settings (0.2mm layers, 20% infill) */
-    estimatedPrintTimeMinutes?: string | number | boolean;
+    estimatedPrintTimeMinutes?: number;
     /** Print time estimates for different quality presets */
-    printTimeEstimates?: Record<string, string | number | boolean>;
+    printTimeEstimates?: {
+        draft?: number;
+        normal?: number;
+        highQuality?: number;
+    };
     /** Estimated material usage in grams using 20% infill (assumes PLA density 1.24g/cm³) */
     estimatedMaterialGrams?: number;
     /** Material usage estimates for different infill percentages */
-    materialEstimates?: Record<string, string | number | boolean>;
+    materialEstimates?: {
+        infill10?: number;
+        infill20?: number;
+        infill50?: number;
+        infill100?: number;
+    };
     /** Recommended print orientation for minimal support material and best results */
-    recommendedOrientation?: Record<string, string | number | boolean>;
+    recommendedOrientation?: {
+        rotationX?: number;
+        rotationY?: number;
+        rotationZ?: number;
+        reasoning?: string;
+    };
+    /** Slicer-derived recommended print settings based on model analysis (feeds into print job creation as defaults) */
+    slicerRecommendations?: {
+        layerHeightMm?: number;
+        infillPercentage?: number;
+        nozzleSizeMm?: number;
+        printSpeedMmS?: number;
+        temperatureC?: number;
+        bedTemperatureC?: number;
+        supportEnabled?: boolean;
+        materialType?: string;
+        estimatedLayerCount?: number;
+    };
     /** Original file format unit detected from metadata or inferred from scale */
     originalUnit?: string;
     /** File format version (e.g., 'STL Binary', 'OBJ v4', 'PLY 1.0') */
@@ -1231,7 +2119,11 @@ export interface ModelTechnicalMetadataCompletedMessage {
     /** Confidence level of analysis results (0.0 = uncertain, 1.0 = highly confident) */
     analysisConfidence?: number;
     /** Warnings or issues detected during analysis (structured for programmatic handling) */
-    analysisWarnings?: Array<Record<string, string | number | boolean>>;
+    analysisWarnings?: Array<{
+        code?: string;
+        message?: string;
+        severity?: string;
+    }>;
     /** ISO 8601 timestamp when analysis was performed (e.g., '2025-11-19T14:35:22Z') */
     analyzedAt?: string;
     /** Detailed error message if status is FAILED */
@@ -1248,13 +2140,217 @@ export interface ModelTechnicalMetadataRequestMessage {
     /** User ID who owns the model */
     ownerId?: string;
     /** Location of the 3D model file (legacy - used for direct download if minioPath not provided) */
-    storageLocation?: Record<string, string | number | boolean>;
+    storageLocation?: {
+        storageConnectionId: string;
+        path: string;
+    };
     /** Path to model in MinIO (e.g., 'raw_models/{modelId}/original.glb'). If provided, file will be read from MinIO instead of downloading from storage provider. */
     minioPath?: string;
     /** ID of parent file-download job (for BullMQ dependency tracking). */
     parentJobId?: string;
     /** Optional analysis configuration parameters */
-    analysisOptions?: Record<string, string | number | boolean>;
+    analysisOptions?: {
+        detailedAnalysis?: boolean;
+        estimatePrintMetrics?: boolean;
+        skipCache?: boolean;
+    };
+}
+/**
+ * Request FDM slicing simulation via OrcaSlicer (preferred) or heuristic fallback. Accepts OrcaSlicer-compatible printer/process/filament JSON profiles.
+ */
+export interface SlicingFdmRequestMessage {
+    /** UUID of the model */
+    modelId?: string;
+    /** UUID or path of the storage item to download the STL/3MF */
+    storageItemId?: string;
+    /** UUID of the user's slicer profile from the database */
+    profileId?: string;
+    /** Human-readable profile name (e.g. 'My Bambu X1C - PLA Fine') */
+    profileName?: string;
+    /** OrcaSlicer printer profile JSON: nozzle_diameter, bed_shape, max speeds, acceleration, retraction */
+    printerProfile?: Record<string, unknown>;
+    /** OrcaSlicer process profile JSON: layer_height, sparse_infill_density, wall_loops, speeds, support settings */
+    processProfile?: Record<string, unknown>;
+    /** OrcaSlicer filament profile JSON: filament_type, filament_density, temperature, flow_ratio, retraction */
+    filamentProfile?: Record<string, unknown>;
+    /** Override: layer height in mm (takes precedence over processProfile) */
+    layerHeight?: number;
+    /** Override: infill percentage (0-100) */
+    infillPercentage?: number;
+    /** Override: nozzle diameter in mm */
+    nozzleDiameter?: number;
+    /** Override: outer wall print speed in mm/s */
+    printSpeed?: number;
+    /** Override: number of wall loops / perimeters */
+    wallCount?: number;
+    /** Override: generate support structures */
+    supportEnabled?: boolean;
+    /** Override: filament density in g/cm³ (default: 1.24 PLA) */
+    materialDensity?: number;
+    /** URL to POST the slicing result back to */
+    webhookUrl?: string;
+}
+/**
+ * Result of FDM slicing simulation from OrcaSlicer (toolpath) or heuristic fallback. Contains exact physical metrics for cost calculation.
+ */
+export interface SlicingFdmResultMessage {
+    /** UUID of the model */
+    modelId?: string;
+    /** Status of the simulation */
+    status?: string;
+    /** Exact print time in hours (from toolpath analysis) */
+    printTimeHours?: number;
+    /** Total filament weight in grams (including supports) */
+    materialWeightGrams?: number;
+    /** Extruded material volume in cm³ */
+    materialVolumeCm3?: number;
+    /** Maximum Z height in mm */
+    maxZHeightMM?: number;
+    /** Support structure filament weight in grams */
+    supportMaterialWeightGrams?: number;
+    /** Total number of layers */
+    layerCount?: number;
+    /** Total filament extrusion length in mm */
+    totalExtrusionLengthMm?: number;
+    /** Engine that produced the result */
+    slicingMethod?: string;
+    /** Version of the slicer engine used */
+    slicerVersion?: string;
+    /** Name or ID of the slicer profile used */
+    profileUsed?: string;
+    /** Error code if simulation failed */
+    errorCode?: string;
+    /** Error message if simulation failed */
+    errorMessage?: string;
+}
+/**
+ * Request SLA/MSLA slicing simulation via PySLM cross-sectional analysis. Accepts resin printer profile with exposure, lift, and layer parameters.
+ */
+export interface SlicingSlaRequestMessage {
+    /** UUID of the model */
+    modelId?: string;
+    /** UUID or path of the storage item to download the STL/3MF */
+    storageItemId?: string;
+    /** SLA or MSLA */
+    technology?: string;
+    /** UUID of the user's slicer profile from the database */
+    profileId?: string;
+    /** Human-readable profile name (e.g. 'Elegoo Mars 3 - Standard Grey') */
+    profileName?: string;
+    /** Layer height in mm (default: 0.05) */
+    layerHeight?: number;
+    /** Normal layer UV exposure time in seconds (default: 2.5) */
+    exposureTime?: number;
+    /** Bottom/burn-in layer exposure time in seconds (default: 30) */
+    bottomExposureTime?: number;
+    /** Number of bottom/burn-in layers (default: 5) */
+    bottomLayers?: number;
+    /** Platform lift height in mm between layers (default: 5.0) */
+    liftHeight?: number;
+    /** Platform lift speed in mm/min (default: 60) */
+    liftSpeed?: number;
+    /** Platform retract speed in mm/min (default: 150) */
+    retractSpeed?: number;
+    /** Resin density in g/cm³ (default: 1.1) */
+    resinDensity?: number;
+    /** Generate support structures (default: true for SLA) */
+    supportEnabled?: boolean;
+    /** URL to POST the slicing result back to */
+    webhookUrl?: string;
+}
+/**
+ * Result of SLA/MSLA slicing simulation from PySLM cross-sectional analysis. Contains exact resin usage and print time metrics.
+ */
+export interface SlicingSlaResultMessage {
+    /** UUID of the model */
+    modelId?: string;
+    /** Status of the simulation */
+    status?: string;
+    /** Exact print time in hours (from cross-sectional analysis) */
+    printTimeHours?: number;
+    /** Total resin weight in grams (including supports) */
+    materialWeightGrams?: number;
+    /** Cured resin volume in cm³ (from cross-sectional area integration) */
+    materialVolumeCm3?: number;
+    /** Maximum Z height in mm */
+    maxZHeightMM?: number;
+    /** Support structure resin weight in grams */
+    supportMaterialWeightGrams?: number;
+    /** Total number of layers */
+    layerCount?: number;
+    /** Maximum cross-sectional area in mm² (affects MSLA peel force) */
+    maxCrossSectionAreaMm2?: number;
+    /** Engine that produced the result */
+    slicingMethod?: string;
+    /** Version of PySLM / trimesh used */
+    slicerVersion?: string;
+    /** Name or ID of the slicer profile used */
+    profileUsed?: string;
+    /** Error code if simulation failed */
+    errorCode?: string;
+    /** Error message if simulation failed */
+    errorMessage?: string;
+}
+/**
+ * Emitted when AI texture generation completes (success or failure). Contains artifact S3 URLs on success, or error details on failure. The credit reservation should be confirmed (success) or released (failure) based on the status.
+ */
+export interface TextureGenerationCompletedMessage {
+    /** The unique job identifier matching the original request. */
+    jobId?: string;
+    /** The ID of the model that was textured. */
+    modelId?: string;
+    /** The tenant who owns the model. */
+    tenantId?: string;
+    /** The result status of the texture generation. */
+    status?: string;
+    /** S3 URLs of generated texture artifacts. Present only when status is 'completed'. */
+    artifacts?: {
+        texturedGlb?: string;
+        albedoMap?: string;
+        normalMap?: string;
+        roughnessMap?: string;
+    };
+    /** Error details. Present only when status is 'failed'. */
+    error?: {
+        code?: string;
+        message?: string;
+        stage?: string;
+        retryable?: boolean;
+    };
+    /** Pipeline performance metrics. */
+    metrics?: {
+        totalDurationMs?: number;
+        uvUnwrapMs?: number;
+        depthExtractionMs?: number;
+        diffusionMs?: number;
+        pbrDecompMs?: number;
+        glbExportMs?: number;
+        gpuType?: string;
+        vramPeakMb?: number;
+    };
+    /** Credit reservation ID to confirm (on success) or release (on failure). */
+    creditReservationId?: string;
+}
+/**
+ * Request AI-powered texture generation for a 3D model. Requires a mesh file URL and a text prompt describing the desired texture. Credits are reserved before dispatch.
+ */
+export interface TextureGenerationRequestMessage {
+    /** Unique job identifier for tracking. */
+    jobId?: string;
+    /** The unique identifier for the model to texture. */
+    modelId?: string;
+    /** The identifier of the tenant requesting the generation. */
+    tenantId?: string;
+    /** S3 URL to the source mesh file (GLB, OBJ, or STL). */
+    meshUrl?: string;
+    /** Text description of the desired texture (1-500 characters). Example: 'weathered bronze with green patina'. */
+    prompt?: string;
+    /** Style preset to guide the texture generation aesthetic. */
+    stylePreset?: string;
+    /** Output texture resolution (width = height in pixels). */
+    resolution?: number;
+    /** Credit reservation ID from the credit ledger. Must be confirmed on completion or released on failure. */
+    creditReservationId?: string;
 }
 /**
  * Handles thumbnail generation completed.
@@ -1269,13 +2365,23 @@ export interface ThumbnailGenerationCompletedMessage {
     /** The path to the generated thumbnail. */
     thumbnailPath?: string;
     /** Array of 360° thumbnail view paths (16 angles) for vision-based analysis. */
-    thumbnail360Views?: Array<Record<string, string | number | boolean>>;
+    thumbnail360Views?: Array<{
+        angle_index?: number;
+        index?: number;
+        storage_path?: string;
+        url?: string;
+    }>;
     /** The path to the generated GLTF/GLB 3D preview file. */
     gltfPreviewPath?: string;
+    /** The path to the generated animated MP4 preview file. */
+    animatedPreviewPath?: string;
     /** An error message if the thumbnail generation failed. */
     errorMessage?: string;
     /** The storage location of the model. */
-    storageLocation?: Record<string, string | number | boolean>;
+    storageLocation?: {
+        storageConnectionId: string;
+        path: string;
+    };
 }
 /**
  * Handles thumbnail generation requests with customization options. Supports both storage provider downloads and MinIO-cached files.
@@ -1286,7 +2392,10 @@ export interface ThumbnailGenerationRequestMessage {
     /** The identifier of the user who owns the entity. */
     ownerId?: string;
     /** The storage location of the model (legacy - used for direct download if minioPath not provided). */
-    storageLocation?: Record<string, string | number | boolean>;
+    storageLocation?: {
+        storageConnectionId: string;
+        path: string;
+    };
     /** Path to model in MinIO (e.g., 'raw_models/{modelId}/original.glb'). If provided, file will be read from MinIO instead of downloading from storage provider. */
     minioPath?: string;
     /** The type of preview to generate, e.g., 'default', 'static', 'glb'. */
@@ -1296,7 +2405,24 @@ export interface ThumbnailGenerationRequestMessage {
     /** ID of parent file-download job (for BullMQ dependency tracking). */
     parentJobId?: string;
     /** User-defined customizations for the thumbnail. */
-    customization?: Record<string, string | number | boolean>;
+    customization?: {
+        texture?: {
+            storageConnectionId?: string;
+            path?: string;
+        };
+        background?: {
+            storageConnectionId?: string;
+            path?: string;
+            color?: string;
+        };
+        watermark?: {
+            storageConnectionId?: string;
+            path?: string;
+            text?: string;
+            position?: string;
+            opacity?: number;
+        };
+    };
 }
 /**
  * User engagement and onboarding tracking events for analytics and behavioral insights.
@@ -1318,6 +2444,8 @@ Used for:
 
  */
 export interface UserEngagementEventMessage {
+    /** Schema version for forward-compatible evolution */
+    eventVersion: string;
     /** Category of user engagement event */
     eventType: string;
     /** Specific user action performed */
@@ -1326,7 +2454,7 @@ export interface UserEngagementEventMessage {
     timestamp: string;
     /** Unique identifier of the user */
     userId: string;
-    /** User's email (hashed for privacy in analytics) */
+    /** User's email — MUST be SHA-256 hashed at the producer side before publishing (GDPR/CNIL compliance). Never send raw email. */
     userEmail?: string;
     /** When the user account was created (for cohort analysis) */
     userCreatedAt?: string;
@@ -1334,10 +2462,26 @@ export interface UserEngagementEventMessage {
     userPlanTier?: string;
     /** User session identifier for grouping actions */
     sessionId?: string;
-    /** Request ID for correlation with logs */
+    /** Request ID for correlation with backend logs */
     requestId?: string;
+    /** Correlation ID to link engagement events across frontend and backend boundaries, and to pipeline traces */
+    correlationId?: string;
     /** Additional context about the action */
-    actionDetails?: Record<string, string | number | boolean>;
+    actionDetails?: {
+        onboardingStep?: string;
+        modelId?: string;
+        modelStatus?: string;
+        modelCount?: number;
+        marketplace?: string;
+        marketplaceListingId?: string;
+        marketplaceAction?: string;
+        previousPlanTier?: string;
+        newPlanTier?: string;
+        featureName?: string;
+        featureCategory?: string;
+        storageProvider?: string;
+        settingChanged?: string;
+    };
     /** Where the action originated */
     source?: string;
     /** HTTP method used */
@@ -1345,7 +2489,7 @@ export interface UserEngagementEventMessage {
     /** API endpoint path */
     httpUrl?: string;
     /** HTTP response status code */
-    httpStatusCode?: string | number | boolean;
+    httpStatusCode?: number;
     /** Action duration in milliseconds */
     durationMs?: number;
     /** A/B test or experiment ID */
@@ -1355,7 +2499,12 @@ export interface UserEngagementEventMessage {
     /** Deployment environment */
     environment?: string;
     /** Client/browser information (anonymized) */
-    clientInfo?: Record<string, string | number | boolean>;
+    clientInfo?: {
+        userAgent?: string;
+        platform?: string;
+        browser?: string;
+        browserVersion?: string;
+    };
 }
 /**
  * Analytics event emitted by workers for tracking processing metrics, user behavior,
@@ -1389,9 +2538,13 @@ export interface WorkerAnalyticsEventMessage {
     /** Error message if status is failure */
     errorMessage?: string;
     /** Processing time metrics in milliseconds */
-    timing?: Record<string, string | number | boolean>;
+    timing?: {
+        queueWaitMs?: number;
+        processingMs?: number;
+        stages?: Record<string, number>;
+    };
     /** Worker-specific metrics. Structure varies by eventType. */
-    metrics?: Record<string, string | number | boolean>;
+    metrics?: Record<string, unknown>;
 }
 /**
  * Enriched metrics event for detailed worker monitoring, cost tracking,
@@ -1432,15 +2585,62 @@ export interface WorkerMetricsEnrichedEventMessage {
     /** Storage item ID (for file operations) */
     storageItemId?: string;
     /** Comprehensive timing breakdown */
-    timing?: Record<string, string | number | boolean>;
+    timing?: {
+        queueWaitMs?: number;
+        processingMs?: number;
+        stages?: Record<string, number>;
+    };
     /** LLM token usage and cost breakdown */
-    llmUsage?: Record<string, string | number | boolean>;
+    llmUsage?: {
+        provider?: string;
+        model?: string;
+        tokensPrompt?: number;
+        tokensCompletion?: number;
+        tokensTotal?: number;
+        costPerPromptToken?: number;
+        costPerCompletionToken?: number;
+        totalCostUsd?: number;
+        cacheHit?: boolean;
+        retries?: number;
+        fallbackUsed?: boolean;
+        modelLatencyMs?: number;
+    };
     /** System resource consumption during job */
-    resources?: Record<string, string | number | boolean>;
+    resources?: {
+        cpu?: {
+            peakPercent?: number;
+            avgPercent?: number;
+            systemTimeMs?: number;
+            userTimeMs?: number;
+        };
+        memory?: {
+            peakMb?: number;
+            avgMb?: number;
+            startMb?: number;
+            endMb?: number;
+            leakDetected?: boolean;
+        };
+        disk?: {
+            bytesRead?: number;
+            bytesWritten?: number;
+            opsRead?: number;
+            opsWrite?: number;
+        };
+        network?: {
+            bytesReceived?: number;
+            bytesSent?: number;
+            apiCallsCount?: number;
+            avgLatencyMs?: number;
+        };
+    };
     /** Worker-specific metrics (varies by worker type) */
-    workerMetrics?: Record<string, string | number | boolean>;
+    workerMetrics?: Record<string, unknown>;
     /** Error details if status is failure */
-    error?: Record<string, string | number | boolean>;
+    error?: {
+        code?: string;
+        message?: string;
+        category?: string;
+    };
     /** Deployment environment */
     environment?: string;
     /** Cloud region/datacenter */