@mesh-sync/worker-backend-client 4.0.19 → 4.1.0

package/README.md

@@ -100,6 +100,26 @@ await client.sendToQueue(MessageTypes.FILE_DOWNLOAD_REQUEST, {
 ## Available Message Types
 
 
+### analytics-collection-request
+
+**Description:** Request to trigger a manual market data collection job.
+Used for ad-hoc scraping of specific queries on marketplaces.
+
+
+**Method:** `client.analyticsCollectionRequest(data)`
+
+**Payload Type:** `AnalyticsCollectionRequestMessage`
+
+**Fields:**
+
+- `marketplace` (string) [✗]: The marketplace to scrape (etsy, ebay, etc.)
+
+- `query` (string) [✓]: The search query to use
+
+- `options` (object) [✗]: Collection options (pages, filters, etc.)
+
+
+
 ### backend-logging-event
 
 **Description:** Centralized logging event for capturing all warn/error/failure logs from meshsync-backend.
@@ -163,52 +183,6 @@ Used for:
 
 
 
-### ekg-edge-batch-create-completed
-
-**Description:** Completion event for EKG edge batch creation with propagation results.
-
-**Method:** `client.ekgEdgeBatchCreateCompleted(data)`
-
-**Payload Type:** `EkgEdgeBatchCreateCompletedMessage`
-
-**Fields:**
-
-- `requestId` (string) [✓]: Original request ID from ekg-edge-batch-create-request
-
-- `success` (boolean) [✓]: Whether the batch operation succeeded
-
-- `statistics` (object) [✓]: Batch operation statistics
-
-- `conflicts` (array) [✗]: List of high-conflict edges requiring review
-
-- `errors` (array) [✗]: Errors encountered during processing
-
-- `graphMetrics` (object) [✗]: Overall graph state after this batch
-
-
-
-### ekg-edge-batch-create-request
-
-**Description:** Create multiple EKG edges with Dempster-Shafer mass functions. Triggered by metamodel detection completion.
-
-**Method:** `client.ekgEdgeBatchCreateRequest(data)`
-
-**Payload Type:** `EkgEdgeBatchCreateRequestMessage`
-
-**Fields:**
-
-- `requestId` (string) [✓]: Unique request ID for tracking (e.g., metamodel detection job ID)
-
-- `source` (string) [✓]: Source of the edges: metamodel-heuristic, manual, taxonomy-import, etc.
-
-- `edges` (array) [✓]: Batch of edges to create/update in the EKG
-
-- `propagationOptions` (object) [✗]: Options for evidential edge propagation after edge creation
-
-- `webhookUrl` (string) [✗]: Optional webhook URL for async completion notification
-
-
-
 ### etsy-analytics-sync-completed
 
 **Description:** Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
@@ -444,6 +418,84 @@ Retry Configuration:
 
 
 
+### ip-check-completed
+
+**Description:** Contains IP verification results including trademark risk, copyright risk, detected brands/franchises, and analysis confidence scores
+
+**Method:** `client.ipCheckCompleted(data)`
+
+**Payload Type:** `IpCheckCompletedMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: Model UUID that was analyzed
+
+- `ownerId` (string) [✗]: Owner user ID
+
+- `entityType` (string) [✗]: Type of entity checked: 'model' or 'metamodel'
+
+- `status` (string) [✗]: Overall IP check outcome: 'clear', 'flagged', or 'error'
+
+- `trademarkRisk` (string) [✗]: Detected trademark infringement risk level: 'none', 'low', 'medium', 'high'
+
+- `copyrightRisk` (string) [✗]: Detected copyright infringement risk level: 'none', 'low', 'medium', 'high'
+
+- `matchedBrands` (array) [✗]: Brand names detected in model name or content
+
+- `matchedFranchises` (array) [✗]: Franchise/character names detected
+
+- `similarModelsCount` (integer) [✗]: Number of visually similar models found
+
+- `confidence` (number) [✗]: Overall confidence score for the analysis (0.0-1.0)
+
+- `riskScorePercent` (integer) [✗]: Risk score as 0-100 integer (FR-024: >70 HIGH, 40-70 MEDIUM, <40 LOW)
+
+- `riskLevel` (string) [✗]: Overall risk level: 'none', 'low', 'medium', 'high'
+
+- `recommendation` (string) [✗]: Recommended action: 'block' (HIGH risk), 'warn' (MEDIUM risk), 'allow' (LOW/NONE risk)
+
+- `suggestedChanges` (object) [✗]: Suggested modifications to reduce IP risk
+
+- `heuristicResults` (object) [✗]: Detailed results from each heuristic check
+
+- `error` (object) [✗]: Error details if status is 'error'
+
+- `processingDurationMs` (integer) [✗]: Total processing time in milliseconds
+
+
+
+### ip-check-request
+
+**Description:** 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.
+
+**Method:** `client.ipCheckRequest(data)`
+
+**Payload Type:** `IpCheckRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: Unique identifier for the model to analyze
+
+- `ownerId` (string) [✗]: User ID who owns the model
+
+- `entityType` (string) [✗]: Type of entity being checked: 'model' or 'metamodel'
+
+- `modelName` (string) [✗]: Name of the model for trademark/franchise text detection
+
+- `tags` (array) [✗]: Model tags for IP reference detection
+
+- `description` (string) [✗]: Model description for text-based IP analysis
+
+- `thumbnailUrl` (string) [✗]: URL to fetch the thumbnail image for visual analysis
+
+- `minioPath` (string) [✗]: Path to thumbnail in MinIO if stored internally
+
+- `additionalImageUrls` (array) [✗]: Optional additional images for more comprehensive analysis (e.g., 360° views)
+
+- `analysisOptions` (object) [✗]: Optional analysis configuration
+
+
+
 ### marketplace-analytics-sync-completed
 
 **Description:** Contains synced analytics data for marketplace listings. Backend stores this in marketplace_analytics_snapshots table and indexes to ELK. Works with any marketplace provider.
@@ -647,6 +699,41 @@ This is typically triggered after initial connection or periodically to keep mar
 
 
 
+### marketplace-intelligence-completed
+
+**Description:** Response from marketplace intelligence scraping.
+Contains aggregated similarity data from marketplace searches.
+
+Consumed by worker-backend to update pipeline context before
+sellability analysis runs.
+
+
+**Method:** `client.marketplaceIntelligenceCompleted(data)`
+
+**Payload Type:** `MarketplaceIntelligenceCompletedMessage`
+
+**Fields:**
+
+- `modelId` (string) [✓]: UUID of the model that was researched
+
+- `ownerId` (string) [✓]: UUID of the model owner
+
+- `status` (string) [✓]: Result status
+
+- `marketData` (object) [✗]: Aggregated market intelligence across all scraped marketplaces
+
+- `marketplaceBreakdown` (array) [✗]: Results per marketplace
+
+- `similarityScore` (number) [✗]: How saturated the market is for this model type (0=unique, 100=very common)
+
+- `error` (object) [✗]: Error information if status is FAILED
+
+- `analyzedAt` (string) [✗]: When the analysis completed
+
+- `analysisVersion` (string) [✗]: Version of the intelligence collector
+
+
+
 ### marketplace-intelligence-event
 
 **Description:** Public marketplace intelligence data scraped from external marketplaces.
@@ -692,6 +779,43 @@ Used for market research, pricing optimization, and trend detection.
 
 
 
+### marketplace-intelligence-request
+
+**Description:** 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)
+
+
+**Method:** `client.marketplaceIntelligenceRequest(data)`
+
+**Payload Type:** `MarketplaceIntelligenceRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✓]: UUID of the model to research
+
+- `ownerId` (string) [✓]: UUID of the model owner
+
+- `searchContext` (object) [✗]: Model metadata used to build marketplace search queries
+
+- `scrapingOptions` (object) [✗]: Configuration for the marketplace scraping
+
+- `pipelineId` (string) [✗]: Pipeline execution ID for correlation
+
+- `executionId` (string) [✗]: Pipeline execution UUID for correlation
+
+
+
 ### marketplace-listing-description-generation-completed
 
 **Description:** Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp) and suggested price.
@@ -1429,6 +1553,76 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 
 
+### model-print-analysis-completed
+
+**Description:** Reports completion of 3D print analysis — contains estimation, printability, and cost breakdown per FR-022
+
+**Method:** `client.modelPrintAnalysisCompleted(data)`
+
+**Payload Type:** `ModelPrintAnalysisCompletedMessage`
+
+**Fields:**
+
+- `originalJobId` (string) [✗]: ID of the original analysis request job
+
+- `modelId` (string) [✗]: UUID of the analysed model
+
+- `status` (string) [✗]: Analysis result status
+
+- `errorMessage` (string) [✗]: Error description when status is FAILED
+
+- `material` (string) [✗]: Material type used for estimation
+
+- `quality` (string) [✗]: Quality preset used
+
+- `printTimeMinutes` (number) [✗]: Estimated total print time in minutes
+
+- `materialGrams` (number) [✗]: Estimated material consumption in grams (body only)
+
+- `needsSupport` (boolean) [✗]: Whether the model requires support structures
+
+- `supportMaterialGrams` (number) [✗]: Estimated support material in grams
+
+- `overhangPercentage` (number) [✗]: Percentage of surface area with overhangs > 45°
+
+- `minWallThicknessMm` (number) [✗]: Thinnest detected wall in millimeters
+
+- `solidVolumeCm3` (number) [✗]: Solid volume of the mesh in cm³
+
+- `surfaceAreaCm2` (number) [✗]: Total surface area in cm²
+
+- `boundingBox` (object) [✗]: Bounding box in millimeters
+
+- `estimatedCostEUR` (number) [✗]: Total estimated production cost in EUR
+
+- `costBreakdown` (object) [✗]: Granular cost breakdown per WF-009 MaterialCostCalculatorService
+
+
+
+### model-print-analysis-request
+
+**Description:** Triggers 3D print analysis for a model — estimates print time, material usage, support needs, and cost breakdown per FR-022
+
+**Method:** `client.modelPrintAnalysisRequest(data)`
+
+**Payload Type:** `ModelPrintAnalysisRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model to analyse
+
+- `ownerId` (string) [✗]: UUID of the user who owns the model
+
+- `material` (string) [✗]: Material type enum value (e.g. PLA, PETG, RESIN_STANDARD)
+
+- `quality` (string) [✗]: Print quality preset
+
+- `webhookUrl` (string) [✗]: URL called when analysis completes or fails
+
+- `minioPath` (string) [✗]: Path to model in MinIO storage for geometry analysis (e.g. 'raw_models/{modelId}/original.glb')
+
+
+
 ### model-sellability-analysis-completed
 
 **Description:** Contains sellability analysis results including Etsy-specific recommendations, material pricing, and marketplace compatibility scores
@@ -1609,6 +1803,8 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 - `recommendedOrientation` (object) [✗]: Recommended print orientation for minimal support material and best results
 
+- `slicerRecommendations` (object) [✗]: Slicer-derived recommended print settings based on model analysis (feeds into print job creation as defaults)
+
 - `originalUnit` (string) [✗]: Original file format unit detected from metadata or inferred from scale
 
 - `formatVersion` (string) [✗]: File format version (e.g., 'STL Binary', 'OBJ v4', 'PLY 1.0')
@@ -1659,6 +1855,236 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 
 
+### slicing-fdm-request
+
+**Description:** Request FDM slicing simulation via OrcaSlicer (preferred) or heuristic fallback. Accepts OrcaSlicer-compatible printer/process/filament JSON profiles.
+
+**Method:** `client.slicingFdmRequest(data)`
+
+**Payload Type:** `SlicingFdmRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model
+
+- `storageItemId` (string) [✗]: UUID or path of the storage item to download the STL/3MF
+
+- `profileId` (string) [✗]: UUID of the user's slicer profile from the database
+
+- `profileName` (string) [✗]: Human-readable profile name (e.g. 'My Bambu X1C - PLA Fine')
+
+- `printerProfile` (object) [✗]: OrcaSlicer printer profile JSON: nozzle_diameter, bed_shape, max speeds, acceleration, retraction
+
+- `processProfile` (object) [✗]: OrcaSlicer process profile JSON: layer_height, sparse_infill_density, wall_loops, speeds, support settings
+
+- `filamentProfile` (object) [✗]: OrcaSlicer filament profile JSON: filament_type, filament_density, temperature, flow_ratio, retraction
+
+- `layerHeight` (number) [✗]: Override: layer height in mm (takes precedence over processProfile)
+
+- `infillPercentage` (number) [✗]: Override: infill percentage (0-100)
+
+- `nozzleDiameter` (number) [✗]: Override: nozzle diameter in mm
+
+- `printSpeed` (number) [✗]: Override: outer wall print speed in mm/s
+
+- `wallCount` (integer) [✗]: Override: number of wall loops / perimeters
+
+- `supportEnabled` (boolean) [✗]: Override: generate support structures
+
+- `materialDensity` (number) [✗]: Override: filament density in g/cm³ (default: 1.24 PLA)
+
+- `webhookUrl` (string) [✗]: URL to POST the slicing result back to
+
+
+
+### slicing-fdm-result
+
+**Description:** Result of FDM slicing simulation from OrcaSlicer (toolpath) or heuristic fallback. Contains exact physical metrics for cost calculation.
+
+**Method:** `client.slicingFdmResult(data)`
+
+**Payload Type:** `SlicingFdmResultMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model
+
+- `status` (string) [✗]: Status of the simulation
+
+- `printTimeHours` (number) [✗]: Exact print time in hours (from toolpath analysis)
+
+- `materialWeightGrams` (number) [✗]: Total filament weight in grams (including supports)
+
+- `materialVolumeCm3` (number) [✗]: Extruded material volume in cm³
+
+- `maxZHeightMM` (number) [✗]: Maximum Z height in mm
+
+- `supportMaterialWeightGrams` (number) [✗]: Support structure filament weight in grams
+
+- `layerCount` (integer) [✗]: Total number of layers
+
+- `totalExtrusionLengthMm` (number) [✗]: Total filament extrusion length in mm
+
+- `slicingMethod` (string) [✗]: Engine that produced the result
+
+- `slicerVersion` (string) [✗]: Version of the slicer engine used
+
+- `profileUsed` (string) [✗]: Name or ID of the slicer profile used
+
+- `errorCode` (string) [✗]: Error code if simulation failed
+
+- `errorMessage` (string) [✗]: Error message if simulation failed
+
+
+
+### slicing-simulation-request
+
+**Description:** DEPRECATED: Use slicing-fdm-request or slicing-sla-request instead. Unified contract kept for backward compatibility only.
+
+**Method:** `client.slicingSimulationRequest(data)`
+
+**Payload Type:** `SlicingSimulationRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model
+
+- `storageItemId` (string) [✗]: UUID or path of the storage item to download the STL/3MF
+
+- `technology` (string) [✗]: Printing technology: FDM, SLA, MSLA, SLS
+
+- `slicerProfile` (object) [✗]: Complete slicer profile with user settings. For FDM: OrcaSlicer-compatible JSON profiles. For SLA: exposure/lift parameters.
+
+- `slicerConfig` (object) [✗]: DEPRECATED: Legacy simple config format. Use slicerProfile instead.
+
+- `slicerProfileId` (string) [✗]: DEPRECATED: UUID of the slicer profile. Use slicerProfile.profileId instead.
+
+- `webhookUrl` (string) [✗]: URL to POST the slicing result back to
+
+
+
+### slicing-simulation-result
+
+**Description:** DEPRECATED: Use slicing-fdm-result or slicing-sla-result instead. Unified contract kept for backward compatibility only.
+
+**Method:** `client.slicingSimulationResult(data)`
+
+**Payload Type:** `SlicingSimulationResultMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model
+
+- `status` (string) [✗]: Status of the simulation
+
+- `printTimeHours` (number) [✗]: Exact print time in hours (from toolpath or cross-sectional analysis)
+
+- `materialWeightGrams` (number) [✗]: Total material weight in grams (filament or resin, including supports)
+
+- `materialVolumeCm3` (number) [✗]: Material volume in cm³
+
+- `maxZHeightMM` (number) [✗]: Maximum Z height in mm
+
+- `supportMaterialWeightGrams` (number) [✗]: Support structure material weight in grams
+
+- `layerCount` (integer) [✗]: Total number of layers
+
+- `totalExtrusionLengthMm` (number) [✗]: Total filament extrusion length in mm (FDM only)
+
+- `slicingMethod` (string) [✗]: Engine that produced the result: orcaslicer_toolpath, pyslm_cross_section, heuristic_volumetric
+
+- `slicerVersion` (string) [✗]: Version of the slicer engine used
+
+- `profileUsed` (string) [✗]: Name or ID of the slicer profile used
+
+- `errorCode` (string) [✗]: Error code if simulation failed
+
+- `errorMessage` (string) [✗]: Error message if simulation failed
+
+
+
+### slicing-sla-request
+
+**Description:** Request SLA/MSLA slicing simulation via PySLM cross-sectional analysis. Accepts resin printer profile with exposure, lift, and layer parameters.
+
+**Method:** `client.slicingSlaRequest(data)`
+
+**Payload Type:** `SlicingSlaRequestMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model
+
+- `storageItemId` (string) [✗]: UUID or path of the storage item to download the STL/3MF
+
+- `technology` (string) [✗]: SLA or MSLA
+
+- `profileId` (string) [✗]: UUID of the user's slicer profile from the database
+
+- `profileName` (string) [✗]: Human-readable profile name (e.g. 'Elegoo Mars 3 - Standard Grey')
+
+- `layerHeight` (number) [✗]: Layer height in mm (default: 0.05)
+
+- `exposureTime` (number) [✗]: Normal layer UV exposure time in seconds (default: 2.5)
+
+- `bottomExposureTime` (number) [✗]: Bottom/burn-in layer exposure time in seconds (default: 30)
+
+- `bottomLayers` (integer) [✗]: Number of bottom/burn-in layers (default: 5)
+
+- `liftHeight` (number) [✗]: Platform lift height in mm between layers (default: 5.0)
+
+- `liftSpeed` (number) [✗]: Platform lift speed in mm/min (default: 60)
+
+- `retractSpeed` (number) [✗]: Platform retract speed in mm/min (default: 150)
+
+- `resinDensity` (number) [✗]: Resin density in g/cm³ (default: 1.1)
+
+- `supportEnabled` (boolean) [✗]: Generate support structures (default: true for SLA)
+
+- `webhookUrl` (string) [✗]: URL to POST the slicing result back to
+
+
+
+### slicing-sla-result
+
+**Description:** Result of SLA/MSLA slicing simulation from PySLM cross-sectional analysis. Contains exact resin usage and print time metrics.
+
+**Method:** `client.slicingSlaResult(data)`
+
+**Payload Type:** `SlicingSlaResultMessage`
+
+**Fields:**
+
+- `modelId` (string) [✗]: UUID of the model
+
+- `status` (string) [✗]: Status of the simulation
+
+- `printTimeHours` (number) [✗]: Exact print time in hours (from cross-sectional analysis)
+
+- `materialWeightGrams` (number) [✗]: Total resin weight in grams (including supports)
+
+- `materialVolumeCm3` (number) [✗]: Cured resin volume in cm³ (from cross-sectional area integration)
+
+- `maxZHeightMM` (number) [✗]: Maximum Z height in mm
+
+- `supportMaterialWeightGrams` (number) [✗]: Support structure resin weight in grams
+
+- `layerCount` (integer) [✗]: Total number of layers
+
+- `maxCrossSectionAreaMm2` (number) [✗]: Maximum cross-sectional area in mm² (affects MSLA peel force)
+
+- `slicingMethod` (string) [✗]: Engine that produced the result
+
+- `slicerVersion` (string) [✗]: Version of PySLM / trimesh used
+
+- `profileUsed` (string) [✗]: Name or ID of the slicer profile used
+
+- `errorCode` (string) [✗]: Error code if simulation failed
+
+- `errorMessage` (string) [✗]: Error message if simulation failed
+
+
+
 ### thumbnail-generation-completed
 
 **Description:** Handles thumbnail generation completed.
@@ -1681,6 +2107,8 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 
 - `gltfPreviewPath` (string) [✗]: The path to the generated GLTF/GLB 3D preview file.
 
+- `animatedPreviewPath` (string) [✗]: The path to the generated animated MP4 preview file.
+
 - `errorMessage` (string) [✗]: An error message if the thumbnail generation failed.
 
 - `storageLocation` (object) [✗]: The storage location of the model.
@@ -1926,6 +2354,11 @@ new WorkerClient(config: WorkerClientConfig)
   - Get the current status of a job
 
 
+- `analyticsCollectionRequest(data: AnalyticsCollectionRequestMessage): Promise<JobResponse>`
+  - Request to trigger a manual market data collection job.
+Used for ad-hoc scraping of specific queries on marketplaces.
+
+
 - `backendLoggingEvent(data: BackendLoggingEventMessage): Promise<JobResponse>`
   - 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.
@@ -1944,12 +2377,6 @@ Used for:
 - Compliance and audit trails
 
 
-- `ekgEdgeBatchCreateCompleted(data: EkgEdgeBatchCreateCompletedMessage): Promise<JobResponse>`
-  - Completion event for EKG edge batch creation with propagation results.
-
-- `ekgEdgeBatchCreateRequest(data: EkgEdgeBatchCreateRequestMessage): Promise<JobResponse>`
-  - Create multiple EKG edges with Dempster-Shafer mass functions. Triggered by metamodel detection completion.
-
 - `etsyAnalyticsSyncCompleted(data: EtsyAnalyticsSyncCompletedMessage): Promise<JobResponse>`
   - Contains synced analytics data for Etsy listings. Backend stores this in etsy_analytics_snapshots table and indexes to ELK.
 
@@ -1989,6 +2416,12 @@ Retry Configuration:
 - `fileVectorizeRequest(data: FileVectorizeRequestMessage): Promise<JobResponse>`
   - Request to generate a vector embedding for an image file using CLIP.
 
+- `ipCheckCompleted(data: IpCheckCompletedMessage): Promise<JobResponse>`
+  - Contains IP verification results including trademark risk, copyright risk, detected brands/franchises, and analysis confidence scores
+
+- `ipCheckRequest(data: IpCheckRequestMessage): Promise<JobResponse>`
+  - 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.
+
 - `marketplaceAnalyticsSyncCompleted(data: MarketplaceAnalyticsSyncCompletedMessage): Promise<JobResponse>`
   - Contains synced analytics data for marketplace listings. Backend stores this in marketplace_analytics_snapshots table and indexes to ELK. Works with any marketplace provider.
 
@@ -2012,6 +2445,14 @@ This is typically triggered after initial connection or periodically to keep mar
   - Requests rotation/refresh of marketplace connection credentials. This is used for: - OAuth token refresh when tokens are near expiry - API key rotation for enhanced security - Re-authentication after connection errors - Scheduled credential updates
 
 
+- `marketplaceIntelligenceCompleted(data: MarketplaceIntelligenceCompletedMessage): Promise<JobResponse>`
+  - Response from marketplace intelligence scraping.
+Contains aggregated similarity data from marketplace searches.
+
+Consumed by worker-backend to update pipeline context before
+sellability analysis runs.
+
+
 - `marketplaceIntelligenceEvent(data: MarketplaceIntelligenceEventMessage): Promise<JobResponse>`
   - Public marketplace intelligence data scraped from external marketplaces.
 
@@ -2030,6 +2471,22 @@ Consumed by worker-analytic-collector for Elasticsearch indexing.
 Used for market research, pricing optimization, and trend detection.
 
 
+- `marketplaceIntelligenceRequest(data: MarketplaceIntelligenceRequestMessage): Promise<JobResponse>`
+  - 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)
+
+
 - `marketplaceListingDescriptionGenerationCompleted(data: MarketplaceListingDescriptionGenerationCompletedMessage): Promise<JobResponse>`
   - Notifies backend that marketplace description generation completed. Contains generated description with metadata tracking (AI model, confidence, generation timestamp) and suggested price.
 
@@ -2123,6 +2580,12 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 - `modelMetamodelDetectionRequest(data: ModelMetamodelDetectionRequestMessage): Promise<JobResponse>`
   - Handles model metamodel detection requests.
 
+- `modelPrintAnalysisCompleted(data: ModelPrintAnalysisCompletedMessage): Promise<JobResponse>`
+  - Reports completion of 3D print analysis — contains estimation, printability, and cost breakdown per FR-022
+
+- `modelPrintAnalysisRequest(data: ModelPrintAnalysisRequestMessage): Promise<JobResponse>`
+  - Triggers 3D print analysis for a model — estimates print time, material usage, support needs, and cost breakdown per FR-022
+
 - `modelSellabilityAnalysisCompleted(data: ModelSellabilityAnalysisCompletedMessage): Promise<JobResponse>`
   - Contains sellability analysis results including Etsy-specific recommendations, material pricing, and marketplace compatibility scores
 
@@ -2141,6 +2604,24 @@ and stores aggregated statistics in Elasticsearch for trend analysis.
 - `modelTechnicalMetadataRequest(data: ModelTechnicalMetadataRequestMessage): Promise<JobResponse>`
   - Triggers comprehensive technical analysis of a 3D model file to extract geometry, quality metrics, and print-readiness information
 
+- `slicingFdmRequest(data: SlicingFdmRequestMessage): Promise<JobResponse>`
+  - Request FDM slicing simulation via OrcaSlicer (preferred) or heuristic fallback. Accepts OrcaSlicer-compatible printer/process/filament JSON profiles.
+
+- `slicingFdmResult(data: SlicingFdmResultMessage): Promise<JobResponse>`
+  - Result of FDM slicing simulation from OrcaSlicer (toolpath) or heuristic fallback. Contains exact physical metrics for cost calculation.
+
+- `slicingSimulationRequest(data: SlicingSimulationRequestMessage): Promise<JobResponse>`
+  - DEPRECATED: Use slicing-fdm-request or slicing-sla-request instead. Unified contract kept for backward compatibility only.
+
+- `slicingSimulationResult(data: SlicingSimulationResultMessage): Promise<JobResponse>`
+  - DEPRECATED: Use slicing-fdm-result or slicing-sla-result instead. Unified contract kept for backward compatibility only.
+
+- `slicingSlaRequest(data: SlicingSlaRequestMessage): Promise<JobResponse>`
+  - Request SLA/MSLA slicing simulation via PySLM cross-sectional analysis. Accepts resin printer profile with exposure, lift, and layer parameters.
+
+- `slicingSlaResult(data: SlicingSlaResultMessage): Promise<JobResponse>`
+  - Result of SLA/MSLA slicing simulation from PySLM cross-sectional analysis. Contains exact resin usage and print time metrics.
+
 - `thumbnailGenerationCompleted(data: ThumbnailGenerationCompletedMessage): Promise<JobResponse>`
   - Handles thumbnail generation completed.