fusesell 1.3.1__py3-none-any.whl → 1.3.3__py3-none-any.whl

{fusesell-1.3.1.dist-info → fusesell-1.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fusesell
-Version: 1.3.1
+Version: 1.3.3
 Summary: Local implementation of FuseSell AI sales automation pipeline
 Author-email: FuseSell Team <team@fusesell.ai>
 License-Expression: MIT

{fusesell-1.3.1.dist-info → fusesell-1.3.3.dist-info}/RECORD

@@ -1,7 +1,7 @@
 fusesell.py,sha256=t5PjkhWEJGINp4k517u0EX0ge7lzuHOUHHro-BE1mGk,596
-fusesell-1.3.1.dist-info/licenses/LICENSE,sha256=GDz1ZoC4lB0kwjERpzqc_OdA_awYVso2aBnUH-ErW_w,1070
-fusesell_local/__init__.py,sha256=4eRHhad_hjqLaoWSd_wZzPRBuX_V_Aqqf2_o93NeHao,967
-fusesell_local/api.py,sha256=AcPune5YJdgi7nsMeusCUqc49z5UiycsQb6n3yiV_No,10839
+fusesell-1.3.3.dist-info/licenses/LICENSE,sha256=GDz1ZoC4lB0kwjERpzqc_OdA_awYVso2aBnUH-ErW_w,1070
+fusesell_local/__init__.py,sha256=Q6pGa5zMldeiz9JEKEbO3rcIJphGt8qmZBl03G7wMMM,966
+fusesell_local/api.py,sha256=SABxRr0TsB1Xfhl_OlL2IiMKYLG0jxbsaBKVNsMh-Qo,10972
 fusesell_local/cli.py,sha256=MYnVxuEf5KTR4VcO3sc-VtP9NkWlSixJsYfOWST2Ds0,65859
 fusesell_local/pipeline.py,sha256=RMF_kgwNEc1ka8-CDJyzIOTSo8PGtR_zPKAgRevhlNo,39913
 fusesell_local/config/__init__.py,sha256=0ErO7QiSDqKn-LHcjIRdLZzh5QaRTkRsIlwfgpkkDz8,209
@@ -12,24 +12,24 @@ fusesell_local/stages/base_stage.py,sha256=ldo5xuHZto7ceEg3i_3rxAx0xPccK4n2jaxEJ
 fusesell_local/stages/data_acquisition.py,sha256=Td3mwakJRoEYbi3od4v2ZzKOHLgLSgccZVxH3ezs1_4,71081
 fusesell_local/stages/data_preparation.py,sha256=XWLg9b1w2NrMxLcrWDqB95mRmLQmVIMXpKNaBNr98TQ,52751
 fusesell_local/stages/follow_up.py,sha256=H9Xek6EoIbHrerQvGTRswXDNFH6zq71DcRxxj0zpo2g,77747
-fusesell_local/stages/initial_outreach.py,sha256=8Ra-Nmq4njAG1iMNiUW7FQbYnX0h9p5F59OXlyGdFdU,135285
+fusesell_local/stages/initial_outreach.py,sha256=98KMaGP_aFkCV4K8j8HgURmNEgbVTYZSvXfLOlXX3Mc,127216
 fusesell_local/stages/lead_scoring.py,sha256=ir3l849eMGrGLf0OYUcmA1F3FwyYhAplS4niU3R2GRY,60658
 fusesell_local/tests/conftest.py,sha256=TWUtlP6cNPVOYkTPz-j9BzS_KnXdPWy8D-ObPLHvXYs,366
-fusesell_local/tests/test_api.py,sha256=763rUVb5pAuAQOovug6Ka0T9eGK8-WVOC_J08M7TETo,1827
+fusesell_local/tests/test_api.py,sha256=vXlNaIDxqTTIFHRHs5zdUAPrxEleyoNxVOeyGuNgoQo,2304
 fusesell_local/tests/test_cli.py,sha256=iNgU8nDlVrcQM5MpBUTIJ5q3oh2-jgX77hJeaqBxToM,1007
 fusesell_local/tests/test_data_manager_products.py,sha256=g8EUSxTqdg18VifzhuOtDDywiMYzwOWFADny5Vntc28,4691
 fusesell_local/tests/test_data_manager_sales_process.py,sha256=NbwxQ9oBKCZfrkRQYxzHHQ08F7epqPUsyeGz_vm3kf8,4447
 fusesell_local/tests/test_data_manager_teams.py,sha256=kjk4V4r9ja4EVREIiQMxkuZd470SSwRHJAvpHln9KO4,4578
-fusesell_local/utils/__init__.py,sha256=TVemlo0wpckhNUxP3a1Tky3ekswy8JdIHaXBlkKXKBQ,330
+fusesell_local/utils/__init__.py,sha256=onCrMaFAr_RepjhilcATvo2VBsSwglbaDSS7M5UVNQ0,374
 fusesell_local/utils/birthday_email_manager.py,sha256=NKLoUyzPedyhewZPma21SOoU8p9wPquehloer7TRA9U,20478
 fusesell_local/utils/data_manager.py,sha256=FHW9nvLXDgf-HYNFwxZlegZp0OgB3altszW6INIgyLM,188910
 fusesell_local/utils/event_scheduler.py,sha256=TDk1v19cNgLhn2aJriQfpvZnwBcRpOWyHLDvkefW110,39834
-fusesell_local/utils/llm_client.py,sha256=FVc25UlGt6hro7h5Iw7PHSXY3E3_67Xc-SUbHuMSRs0,10437
+fusesell_local/utils/llm_client.py,sha256=eNfbZBcyawBvZGLDPuyeectwBUVi5fjeD5GeLkEqWXI,12271
 fusesell_local/utils/logger.py,sha256=sWlV8Tjyz_Z8J4zXKOnNalh8_iD6ytfrwPZpD-wcEOs,6259
 fusesell_local/utils/timezone_detector.py,sha256=0cAE4c8ZXqCA8AvxRKm6PrFKmAmsbq3HOHR6w-mW3KQ,39997
 fusesell_local/utils/validators.py,sha256=Z1VzeoxFsnuzlIA_ZaMWoy-0Cgyqupd47kIdljlMDbs,15438
-fusesell-1.3.1.dist-info/METADATA,sha256=hYcoE3sJK-2TPuxHSUv5yxaoNYu1_B5gW1bfScica5w,35074
-fusesell-1.3.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-fusesell-1.3.1.dist-info/entry_points.txt,sha256=Vqek7tbiX7iF4rQkCRBZvT5WrB0HUduqKTsI2ZjhsXo,53
-fusesell-1.3.1.dist-info/top_level.txt,sha256=VP9y1K6DEq6gNq2UgLd7ChujxViF6OzeAVCK7IUBXPA,24
-fusesell-1.3.1.dist-info/RECORD,,
+fusesell-1.3.3.dist-info/METADATA,sha256=KtGJ5IyUrdyBtlS2QwMsspFdzf61sJMSxzmZY-TO2t0,35074
+fusesell-1.3.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fusesell-1.3.3.dist-info/entry_points.txt,sha256=Vqek7tbiX7iF4rQkCRBZvT5WrB0HUduqKTsI2ZjhsXo,53
+fusesell-1.3.3.dist-info/top_level.txt,sha256=VP9y1K6DEq6gNq2UgLd7ChujxViF6OzeAVCK7IUBXPA,24
+fusesell-1.3.3.dist-info/RECORD,,

fusesell_local/__init__.py

@@ -32,6 +32,6 @@ __all__ = [
     "validate_config",
 ]
 
-__version__ = "1.3.1"
+__version__ = "1.3.3"
 __author__ = "FuseSell Team"
 __description__ = "Local implementation of FuseSell AI sales automation pipeline"

fusesell_local/api.py

@@ -16,6 +16,7 @@ from typing import Any, Callable, Dict, Mapping, MutableMapping, Optional, Seque
 from .pipeline import FuseSellPipeline
 from .utils.logger import setup_logging as _setup_logging
 from .utils.validators import InputValidator
+from .utils.llm_client import normalize_llm_base_url
 
 
 class ConfigValidationError(ValueError):
@@ -138,6 +139,8 @@ def build_config(options: OptionsType) -> Dict[str, Any]:
         "dry_run": _coerce_bool(_get("dry_run")),
     }
 
+    config["llm_base_url"] = normalize_llm_base_url(config.get("llm_base_url"))
+
     return config
 
 
@@ -338,4 +341,3 @@ def execute_pipeline(
         }
 
     return run_pipeline(config)
-

fusesell_local/stages/initial_outreach.py

@@ -710,136 +710,119 @@ class InitialOutreachStage(BaseStage):
         if self.is_dry_run():
             return self._get_mock_email_drafts(customer_data, recommended_product, context)
         
-        try:
-            input_data = context.get('input_data', {})
-            rep_profile = rep_profile or {}
-            recipient_identity = self._resolve_recipient_identity(customer_data, context)
-            if recipient_identity.get('first_name') and not context.get('customer_first_name'):
-                context['customer_first_name'] = recipient_identity['first_name']
-            context.setdefault('_recipient_identity', recipient_identity)
-            if rep_profile:
-                primary_name = rep_profile.get('name')
-                if primary_name:
-                    input_data['staff_name'] = primary_name
-                    self.config['staff_name'] = primary_name
-                if rep_profile.get('email'):
-                    input_data.setdefault('staff_email', rep_profile.get('email'))
-                if rep_profile.get('phone') or rep_profile.get('primary_phone'):
-                    input_data.setdefault('staff_phone', rep_profile.get('phone') or rep_profile.get('primary_phone'))
-                if rep_profile.get('position'):
-                    input_data.setdefault('staff_title', rep_profile.get('position'))
-                if rep_profile.get('website'):
-                    input_data.setdefault('staff_website', rep_profile.get('website'))
-
-            company_info = customer_data.get('companyInfo', {})
-            contact_info = customer_data.get('primaryContact', {})
-            pain_points = customer_data.get('painPoints', [])
-
-            prompt_drafts = self._generate_email_drafts_from_prompt(
-                customer_data,
-                recommended_product,
-                scoring_data,
-                context
-            )
-            if prompt_drafts:
-                return prompt_drafts
-
-            # Generate multiple draft variations with different approaches
-            draft_approaches = [
-                {
-                    'name': 'professional_direct',
-                    'tone': 'professional and direct',
-                    'focus': 'business value and ROI',
-                    'length': 'concise'
-                },
-                {
-                    'name': 'consultative',
-                    'tone': 'consultative and helpful',
-                    'focus': 'solving specific pain points',
-                    'length': 'medium'
-                },
-                {
-                    'name': 'industry_expert',
-                    'tone': 'industry expert and insightful',
-                    'focus': 'industry trends and challenges',
-                    'length': 'detailed'
-                },
-                {
-                    'name': 'relationship_building',
-                    'tone': 'warm and relationship-focused',
-                    'focus': 'building connection and trust',
-                    'length': 'personal'
-                }
-            ]
-            
-            generated_drafts = []
-            
-            for approach in draft_approaches:
-                try:
-                    # Generate email content for this approach
-                    email_content = self._generate_single_email_draft(
-                        customer_data, recommended_product, scoring_data, 
-                        approach, context
-                    )
-                    email_content = self._ensure_html_email(email_content, context)
-                    
-                    # Generate subject lines for this approach
-                    subject_lines = self._generate_subject_lines(
-                        customer_data, recommended_product, approach, context
-                    )
-                    
-                    draft_id = f"uuid:{str(uuid.uuid4())}"
-                    draft_approach = approach['name']
-                    draft_type = "initial"
-                    
-                    # Select the best subject line (first one, or most relevant)
-                    selected_subject = subject_lines[0] if subject_lines else f"Partnership opportunity for {company_info.get('name', 'your company')}"
-                    
-                    draft = {
-                        'draft_id': draft_id,
-                        'approach': approach['name'],
-                        'tone': approach['tone'],
-                        'focus': approach['focus'],
-                        'subject': selected_subject,  # Single subject instead of array
-                        'subject_alternatives': subject_lines[1:4] if len(subject_lines) > 1 else [],  # Store alternatives separately
-                        'email_body': email_content,
-                        'email_format': 'html',
-                        'recipient_email': recipient_identity.get('email'),
-                        'recipient_name': recipient_identity.get('full_name'),
-                        'customer_first_name': recipient_identity.get('first_name'),
-                        'call_to_action': self._extract_call_to_action(email_content),
-                        'personalization_score': self._calculate_personalization_score(email_content, customer_data),
-                        'generated_at': datetime.now().isoformat(),
-                        'status': 'draft',
-                        'metadata': {
-                            'customer_company': company_info.get('name', 'Unknown'),
-                            'contact_name': contact_info.get('name', 'Unknown'),
-                            'recipient_email': recipient_identity.get('email'),
-                            'recipient_name': recipient_identity.get('full_name'),
-                            'email_format': 'html',
-                            'recommended_product': recommended_product.get('product_name', 'Unknown'),
-                            'pain_points_addressed': len([p for p in pain_points if p.get('severity') in ['high', 'medium']]),
-                            'generation_method': 'llm_powered'
-                        }
-                    }
-                    
-                    generated_drafts.append(draft)
-                    
-                except Exception as e:
-                    self.logger.warning(f"Failed to generate draft for approach {approach['name']}: {str(e)}")
-                    continue
-            
-            if not generated_drafts:
-                # Fallback to simple template if all LLM generations fail
-                self.logger.warning("All LLM draft generations failed, using fallback template")
-                return self._generate_fallback_draft(customer_data, recommended_product, context)
-            
-            self.logger.info(f"Generated {len(generated_drafts)} email drafts successfully")
-            return generated_drafts
-            
-        except Exception as e:
-            self.logger.error(f"Email draft generation failed: {str(e)}")
-            return self._generate_fallback_draft(customer_data, recommended_product, context)
+        input_data = context.get('input_data', {}) or {}
+        rep_profile = rep_profile or {}
+        recipient_identity = self._resolve_recipient_identity(customer_data, context)
+        if recipient_identity.get('first_name') and not context.get('customer_first_name'):
+            context['customer_first_name'] = recipient_identity['first_name']
+        context.setdefault('_recipient_identity', recipient_identity)
+        if rep_profile:
+            primary_name = rep_profile.get('name')
+            if primary_name:
+                input_data['staff_name'] = primary_name
+                self.config['staff_name'] = primary_name
+            if rep_profile.get('email'):
+                input_data.setdefault('staff_email', rep_profile.get('email'))
+            if rep_profile.get('phone') or rep_profile.get('primary_phone'):
+                input_data.setdefault('staff_phone', rep_profile.get('phone') or rep_profile.get('primary_phone'))
+            if rep_profile.get('position'):
+                input_data.setdefault('staff_title', rep_profile.get('position'))
+            if rep_profile.get('website'):
+                input_data.setdefault('staff_website', rep_profile.get('website'))
+
+        company_info = customer_data.get('companyInfo', {}) or {}
+        contact_info = customer_data.get('primaryContact', {}) or {}
+        pain_points = customer_data.get('painPoints', [])
+
+        prompt_drafts = self._generate_email_drafts_from_prompt(
+            customer_data,
+            recommended_product,
+            scoring_data,
+            context
+        )
+        if prompt_drafts:
+            return prompt_drafts
+
+        draft_approaches = [
+            {
+                'name': 'professional_direct',
+                'tone': 'professional and direct',
+                'focus': 'business value and ROI',
+                'length': 'concise'
+            },
+            {
+                'name': 'consultative',
+                'tone': 'consultative and helpful',
+                'focus': 'solving specific pain points',
+                'length': 'medium'
+            },
+            {
+                'name': 'industry_expert',
+                'tone': 'industry expert and insightful',
+                'focus': 'industry trends and challenges',
+                'length': 'detailed'
+            },
+            {
+                'name': 'relationship_building',
+                'tone': 'warm and relationship-focused',
+                'focus': 'building connection and trust',
+                'length': 'personal'
+            }
+        ]
+
+        generated_drafts: List[Dict[str, Any]] = []
+
+        for approach in draft_approaches:
+            email_body = self._generate_single_email_draft(
+                customer_data,
+                recommended_product,
+                scoring_data,
+                approach,
+                context
+            )
+
+            subject_lines = self._generate_subject_lines(
+                customer_data, recommended_product, approach, context
+            )
+
+            draft_id = f"uuid:{str(uuid.uuid4())}"
+            selected_subject = subject_lines[0] if subject_lines else f"Partnership opportunity for {company_info.get('name', 'your company')}"
+
+            draft = {
+                'draft_id': draft_id,
+                'approach': approach['name'],
+                'tone': approach['tone'],
+                'focus': approach['focus'],
+                'subject': selected_subject,
+                'subject_alternatives': subject_lines[1:4] if len(subject_lines) > 1 else [],
+                'email_body': email_body,
+                'email_format': 'html',
+                'recipient_email': recipient_identity.get('email'),
+                'recipient_name': recipient_identity.get('full_name'),
+                'customer_first_name': recipient_identity.get('first_name'),
+                'call_to_action': self._extract_call_to_action(email_body),
+                'personalization_score': self._calculate_personalization_score(email_body, customer_data),
+                'generated_at': datetime.now().isoformat(),
+                'status': 'draft',
+                'metadata': {
+                    'customer_company': company_info.get('name', 'Unknown'),
+                    'contact_name': contact_info.get('name', 'Unknown'),
+                    'recipient_email': recipient_identity.get('email'),
+                    'recipient_name': recipient_identity.get('full_name'),
+                    'email_format': 'html',
+                    'recommended_product': recommended_product.get('product_name', 'Unknown') if recommended_product else 'Unknown',
+                    'pain_points_addressed': len([p for p in pain_points if p.get('severity') in ['high', 'medium']]),
+                    'generation_method': 'llm_powered'
+                }
+            }
+
+            generated_drafts.append(draft)
+
+        if not generated_drafts:
+            raise RuntimeError("LLM returned no outreach drafts; initial outreach cannot proceed.")
+
+        self.logger.info("Generated %s email drafts successfully", len(generated_drafts))
+        return generated_drafts
 
     def _generate_email_drafts_from_prompt(self, customer_data: Dict[str, Any], recommended_product: Dict[str, Any], scoring_data: Dict[str, Any], context: Dict[str, Any]) -> List[Dict[str, Any]]:
         """Attempt to generate drafts using configured prompt template."""
@@ -1426,9 +1409,9 @@ class InitialOutreachStage(BaseStage):
             
             return cleaned_content
             
-        except Exception as e:
-            self.logger.error(f"Failed to generate single email draft: {str(e)}")
-            return self._generate_template_email(customer_data, recommended_product, approach, context)
+        except Exception as e:
+            self.logger.error("LLM single draft generation failed for approach %s: %s", approach.get('name'), e)
+            raise RuntimeError(f"Failed to generate draft for approach {approach.get('name')}") from e
 
     def _create_email_generation_prompt(self, customer_context: Dict[str, Any], approach: Dict[str, Any]) -> str:
         """Create LLM prompt for email generation."""
@@ -1671,118 +1654,6 @@ Generate 4 subject lines, one per line, no numbering or bullets:"""
 
         return min(score, 100)
 
-    def _generate_template_email(self, customer_data: Dict[str, Any], recommended_product: Dict[str, Any], 
-                               approach: Dict[str, Any], context: Dict[str, Any]) -> str:
-        """Generate a deterministic HTML email when LLM generation is unavailable."""
-        input_data = context.get('input_data', {}) or {}
-        company_info = customer_data.get('companyInfo', {}) or {}
-        contact_info = customer_data.get('primaryContact', {}) or {}
-        identity = context.get('_recipient_identity') or self._resolve_recipient_identity(customer_data, context)
-
-        first_name = identity.get('first_name') or contact_info.get('name') or input_data.get('customer_name') or input_data.get('recipient_name') or 'there'
-        first_name = self._extract_first_name(first_name) if isinstance(first_name, str) else 'there'
-
-        staff_name = input_data.get('staff_name') or self.config.get('staff_name', 'Sales Team')
-        org_name = input_data.get('org_name') or self.config.get('org_name', 'FuseSell')
-        company_name = company_info.get('name', 'your company')
-        industry = company_info.get('industry', 'your industry')
-        approach_name = approach.get('name', 'professional_direct')
-        approach_focus = approach.get('focus', 'business value')
-        approach_tone = approach.get('tone', 'professional')
-
-        benefits: List[str] = []
-        if recommended_product:
-            product_name = recommended_product.get('product_name')
-            benefits = [b for b in (recommended_product.get('key_benefits') or []) if b]
-            if not benefits and product_name:
-                benefits = [
-                    f"{product_name} accelerates {company_name}'s {approach_focus} goals",
-                    f"Designed specifically for {industry} operators",
-                    "Rapid onboarding with dedicated local support"
-                ]
-        if not benefits:
-            benefits = [
-                f"Measurable improvements in {approach_focus}",
-                f"Playbooks tailored for {industry} teams",
-                "Guided adoption with FuseSell specialists"
-            ]
-
-        bullet_html = ''.join(f"<li>{benefit}</li>" for benefit in benefits)
-
-        cta_map = {
-            'professional_direct': f"Would you have 20 minutes this week to explore how FuseSell can lighten {company_name}'s {approach_focus} workload?",
-            'consultative': f"Could we schedule a short working session to dig into your current {approach_focus} priorities?",
-            'industry_expert': f"Shall we review the latest {industry} benchmarks together and map them to your roadmap?",
-            'relationship_building': f"I'd love to hear how your team is approaching {approach_focus}; is a quick virtual coffee an option?"
-        }
-        cta_text = cta_map.get(approach_name, f"Would you be open to a brief call to discuss {approach_focus} priorities at {company_name}?")
-
-        product_sentence = ""
-        if recommended_product and recommended_product.get('product_name'):
-            product_sentence = f"<p>We engineered <strong>{recommended_product['product_name']}</strong> specifically for teams tackling {approach_focus} in {industry}. It's a natural fit for {company_name}'s next phase.</p>"
-
-        news = company_info.get('recentNews')
-        intro_sentence = f"<p>I'm reaching out because leaders at {company_name} are raising the same questions we hear from other {industry} innovators: how to keep {approach_focus} moving without burning out the team.</p>"
-        if news:
-            intro_sentence = f"<p>I noticed the recent update about {news}. Many {industry} peers use FuseSell to capitalise on moments exactly like this.</p>"
-
-        html = (
-            "<html><body>"
-            f"<p>Hi {first_name},</p>"
-            f"{intro_sentence}"
-            f"<p>From our {approach_tone.lower()} conversations with {industry} operators, three ideas could help {company_name} right away:</p>"
-            f"<ul>{bullet_html}</ul>"
-            f"{product_sentence}"
-            f"<p>{cta_text}</p>"
-            f"<p>Best regards,<br>{staff_name}<br>{org_name}</p>"
-            "</body></html>"
-        )
-
-        return html
-
-    def _generate_fallback_draft(self, customer_data: Dict[str, Any], recommended_product: Dict[str, Any], context: Dict[str, Any]) -> List[Dict[str, Any]]:
-        """Generate fallback draft when LLM generation fails."""
-        draft_id = f"uuid:{str(uuid.uuid4())}"
-        recipient_identity = self._resolve_recipient_identity(customer_data, context)
-        context.setdefault('_recipient_identity', recipient_identity)
-        if recipient_identity.get('first_name') and not context.get('customer_first_name'):
-            context['customer_first_name'] = recipient_identity['first_name']
-
-        template_body = self._generate_template_email(
-            customer_data,
-            recommended_product,
-            {'tone': 'professional'},
-            context
-        )
-        email_body = self._clean_email_content(template_body, context)
-
-        fallback_subjects = self._generate_fallback_subject_lines(customer_data, recommended_product)
-
-        return [{
-            'draft_id': draft_id,
-            'approach': 'fallback_template',
-            'tone': 'professional',
-            'focus': 'general outreach',
-            'subject': fallback_subjects[0],
-            'subject_alternatives': fallback_subjects[1:],
-            'email_body': email_body,
-            'email_format': 'html',
-            'recipient_email': recipient_identity.get('email'),
-            'recipient_name': recipient_identity.get('full_name'),
-            'customer_first_name': recipient_identity.get('first_name'),
-            'call_to_action': 'Would you be interested in a brief call?',
-            'personalization_score': 50,
-            'generated_at': datetime.now().isoformat(),
-            'status': 'draft',
-            'metadata': {
-                'generation_method': 'template_fallback',
-                'note': 'Generated using template due to LLM failure',
-                'recipient_email': recipient_identity.get('email'),
-                'recipient_name': recipient_identity.get('full_name'),
-                'email_format': 'html'
-            }
-        }]
-
     def _get_mock_email_drafts(self, customer_data: Dict[str, Any], recommended_product: Dict[str, Any], context: Dict[str, Any]) -> List[Dict[str, Any]]:
         """Get mock email drafts for dry run."""
         input_data = context.get('input_data', {})

fusesell_local/tests/test_api.py

@@ -24,20 +24,37 @@ def base_options(**overrides):
     return options
 
 
-def test_build_config_generates_defaults():
-    config = build_config(base_options())
-
-    assert config["execution_id"].startswith("fusesell_")
-    assert config["output_format"] == "json"
-    assert config["skip_stages"] == []
-    assert config["send_immediately"] is False
-
-
-def test_validate_config_detects_missing_sources():
-    config = build_config(
-        base_options(
-            input_description="",
-            input_website="",
+def test_build_config_generates_defaults():
+    config = build_config(base_options())
+
+    assert config["execution_id"].startswith("fusesell_")
+    assert config["output_format"] == "json"
+    assert config["skip_stages"] == []
+    assert config["send_immediately"] is False
+
+
+def test_build_config_normalizes_llm_base_url():
+    config = build_config(
+        base_options(
+            llm_base_url="https://custom-llm.example.com",
+        )
+    )
+
+    assert config["llm_base_url"] == "https://custom-llm.example.com/v1"
+
+
+def test_build_config_preserves_azure_base_url():
+    azure_url = "https://rtx-openai.openai.azure.com/openai/deployments/gpt4"
+    config = build_config(base_options(llm_base_url=azure_url))
+
+    assert config["llm_base_url"] == azure_url
+
+
+def test_validate_config_detects_missing_sources():
+    config = build_config(
+        base_options(
+            input_description="",
+            input_website="",
             input_freetext="",
         )
     )

fusesell_local/utils/__init__.py

@@ -2,14 +2,15 @@
 FuseSell Utilities - Common utilities and helper functions
 """
 
-from .data_manager import LocalDataManager
-from .llm_client import LLMClient
-from .validators import InputValidator
-from .logger import setup_logging
-
-__all__ = [
-    'LocalDataManager',
-    'LLMClient', 
-    'InputValidator',
-    'setup_logging'
-]
+from .data_manager import LocalDataManager
+from .llm_client import LLMClient, normalize_llm_base_url
+from .validators import InputValidator
+from .logger import setup_logging
+
+__all__ = [
+    'LocalDataManager',
+    'LLMClient',
+    'normalize_llm_base_url',
+    'InputValidator',
+    'setup_logging'
+]

fusesell_local/utils/llm_client.py

@@ -2,17 +2,74 @@
 LLM Client for OpenAI API integration
 """
 
-try:
-    import openai
-    OPENAI_AVAILABLE = True
-except ImportError:
-    OPENAI_AVAILABLE = False
-    openai = None
-
-from typing import Dict, Any, List, Optional
-import logging
-import time
-import json
+try:
+    import openai
+    OPENAI_AVAILABLE = True
+except ImportError:
+    OPENAI_AVAILABLE = False
+    openai = None
+
+from typing import Dict, Any, List, Optional
+import logging
+import time
+import json
+from urllib.parse import urlsplit, urlunsplit
+
+
+def normalize_llm_base_url(base_url: Optional[str], provider: Optional[str] = None) -> Optional[str]:
+    """
+    Ensure LLM base URLs point to the OpenAI-compatible /v1 endpoint unless they already target
+    Azure deployment paths that do not expect the suffix.
+
+    Args:
+        base_url: User-provided base URL.
+        provider: Optional provider hint (e.g., 'azure-openai').
+
+    Returns:
+        Normalized base URL with `/v1` appended when needed, or ``None`` if input is empty.
+    """
+    if not base_url:
+        return None
+
+    normalized = base_url.strip()
+    if not normalized:
+        return None
+
+    provider_hint = (provider or "").lower()
+    if provider_hint.startswith("azure") or "openai.azure.com" in normalized.lower():
+        return normalized.rstrip("/")
+
+    try:
+        parsed = urlsplit(normalized)
+    except ValueError:
+        parsed = None
+
+    if parsed and parsed.scheme and parsed.netloc:
+        path = parsed.path.rstrip("/")
+        segments = [segment for segment in path.split("/") if segment]
+
+        if not segments:
+            new_path = "/v1"
+        elif segments[-1] in {"v1", "v1beta"} or "v1" in segments or "deployments" in segments:
+            new_path = "/" + "/".join(segments)
+        else:
+            new_path = f"{path}/v1" if path else "/v1"
+
+        rebuilt = urlunsplit(
+            (
+                parsed.scheme,
+                parsed.netloc,
+                new_path,
+                parsed.query,
+                parsed.fragment,
+            )
+        )
+        return rebuilt.rstrip("/")
+
+    stripped = normalized.rstrip("/")
+    if stripped.endswith("/v1") or "/v1/" in stripped:
+        return stripped
+    return f"{stripped}/v1"
 
 
 class LLMClient:
@@ -35,13 +92,15 @@ class LLMClient:
         
         self.api_key = api_key
         self.model = model
-        self.logger = logging.getLogger("fusesell.llm_client")
-        
-        # Initialize OpenAI client
-        if base_url:
-            self.client = openai.OpenAI(api_key=api_key, base_url=base_url)
-        else:
-            self.client = openai.OpenAI(api_key=api_key)
+        self.logger = logging.getLogger("fusesell.llm_client")
+        
+        normalized_base_url = normalize_llm_base_url(base_url)
+        
+        # Initialize OpenAI client
+        if normalized_base_url:
+            self.client = openai.OpenAI(api_key=api_key, base_url=normalized_base_url)
+        else:
+            self.client = openai.OpenAI(api_key=api_key)
     
     def chat_completion(
         self, 
@@ -280,4 +339,4 @@ Response:"""
             return len(response) > 0
         except Exception as e:
             self.logger.error(f"API key validation failed: {str(e)}")
-            return False
+            return False