fusesell 1.2.0__py3-none-any.whl

fusesell-1.2.0.dist-info/RECORD

@@ -0,0 +1,31 @@
+fusesell.py,sha256=dBmhnVtoAk4bhY0fpXnwdo8Jo2g1fQ60SHVUYh2Qru0,365
+fusesell-1.2.0.dist-info/licenses/LICENSE,sha256=GDz1ZoC4lB0kwjERpzqc_OdA_awYVso2aBnUH-ErW_w,1070
+fusesell_local/__init__.py,sha256=RNrjXYe65DuxE4cY_R1lTr3UWrPsV7EPz9DHRp62I58,930
+fusesell_local/api.py,sha256=AcPune5YJdgi7nsMeusCUqc49z5UiycsQb6n3yiV_No,10839
+fusesell_local/cli.py,sha256=l9ZjiRJpYCjFfSLmTvxRs8XhB6TqRPkeqbFZsM2xP5o,64870
+fusesell_local/pipeline.py,sha256=KO5oAIHZ3L_uAZWOszauJyv0QWlsQMIDNGRuwQSxNmQ,39531
+fusesell_local/config/__init__.py,sha256=0ErO7QiSDqKn-LHcjIRdLZzh5QaRTkRsIlwfgpkkDz8,209
+fusesell_local/config/prompts.py,sha256=5O3Y2v3GCi9d9FEyR6Ekc1UXVq2TcZp3Rrspvx4bkac,10164
+fusesell_local/config/settings.py,sha256=rbjGPLQTFFr7DiWrPnZDFaOSNsdEMMYFx6pn7b13xGs,10743
+fusesell_local/stages/__init__.py,sha256=2mAmzcMlVKZdseOR5Jju4PaPdKGsBT1ePqvt5RS3ZfQ,514
+fusesell_local/stages/base_stage.py,sha256=ldo5xuHZto7ceEg3i_3rxAx0xPccK4n2jaxEJA96RUE,22069
+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=2CSen5SHJ5k6KMHXpqoRBb3n3IrcMRdDnuyTsOeuRTA,74625
+fusesell_local/stages/initial_outreach.py,sha256=jox2caveSwI3xIfjn8FGYprkjTbW8YhDNvCzz9wNcBE,107503
+fusesell_local/stages/lead_scoring.py,sha256=ir3l849eMGrGLf0OYUcmA1F3FwyYhAplS4niU3R2GRY,60658
+fusesell_local/tests/test_api.py,sha256=763rUVb5pAuAQOovug6Ka0T9eGK8-WVOC_J08M7TETo,1827
+fusesell_local/tests/test_cli.py,sha256=iNgU8nDlVrcQM5MpBUTIJ5q3oh2-jgX77hJeaqBxToM,1007
+fusesell_local/utils/__init__.py,sha256=TVemlo0wpckhNUxP3a1Tky3ekswy8JdIHaXBlkKXKBQ,330
+fusesell_local/utils/birthday_email_manager.py,sha256=NKLoUyzPedyhewZPma21SOoU8p9wPquehloer7TRA9U,20478
+fusesell_local/utils/data_manager.py,sha256=wMP0fGeFVCEVOl6QOu2lXvzGqfW3apn_H3Fl7vy11lE,175558
+fusesell_local/utils/event_scheduler.py,sha256=rjtWwtYQoJP0YwoN1-43t6K9GpLfqRq3c7Fv4papvbI,25725
+fusesell_local/utils/llm_client.py,sha256=FVc25UlGt6hro7h5Iw7PHSXY3E3_67Xc-SUbHuMSRs0,10437
+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.2.0.dist-info/METADATA,sha256=L7O3gPF5e0-yvIOrVjs8LpvIguZqWQkLRWVLDvTRMLw,36070
+fusesell-1.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+fusesell-1.2.0.dist-info/entry_points.txt,sha256=Vqek7tbiX7iF4rQkCRBZvT5WrB0HUduqKTsI2ZjhsXo,53
+fusesell-1.2.0.dist-info/top_level.txt,sha256=VP9y1K6DEq6gNq2UgLd7ChujxViF6OzeAVCK7IUBXPA,24
+fusesell-1.2.0.dist-info/RECORD,,

fusesell-1.2.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

fusesell-1.2.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fusesell = fusesell_local.cli:main

fusesell-1.2.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 FuseSell Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fusesell-1.2.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+fusesell
+fusesell_local

fusesell.py

@@ -0,0 +1,15 @@
+#!/usr/bin/env python3
+"""
+Backward-compatible CLI entry point for running the FuseSell pipeline.
+
+Delegates to ``fusesell_local.cli.main`` so both the installed console script
+and direct script execution share the same implementation.
+"""
+
+from fusesell_local.cli import FuseSellCLI, main
+
+__all__ = ["FuseSellCLI", "main"]
+
+
+if __name__ == "__main__":
+    main()

fusesell_local/__init__.py

@@ -0,0 +1,37 @@
+"""
+FuseSell Local - AI-powered sales automation platform for local execution.
+
+This package exposes a programmatic API so the pipeline can be embedded in
+workflows and code interpreters without launching the CLI entry point.
+"""
+
+from .api import (
+    ConfigValidationError,
+    build_config,
+    configure_logging,
+    execute_pipeline,
+    generate_execution_id,
+    prepare_data_directory,
+    run_pipeline,
+    validate_config,
+)
+from .cli import FuseSellCLI, main as cli_main
+from .pipeline import FuseSellPipeline
+
+__all__ = [
+    "ConfigValidationError",
+    "FuseSellCLI",
+    "FuseSellPipeline",
+    "build_config",
+    "cli_main",
+    "configure_logging",
+    "execute_pipeline",
+    "generate_execution_id",
+    "prepare_data_directory",
+    "run_pipeline",
+    "validate_config",
+]
+
+__version__ = "1.2.0"
+__author__ = "FuseSell Team"
+__description__ = "Local implementation of FuseSell AI sales automation pipeline"

fusesell_local/api.py

@@ -0,0 +1,341 @@
+"""
+Public library interface for FuseSell Local.
+
+This module exposes helpers that embed FuseSell in external Python runtimes
+without going through the CLI wrapper.
+"""
+
+from __future__ import annotations
+
+import logging
+import uuid
+from datetime import datetime
+from pathlib import Path
+from typing import Any, Callable, Dict, Mapping, MutableMapping, Optional, Sequence, Tuple, Union
+
+from .pipeline import FuseSellPipeline
+from .utils.logger import setup_logging as _setup_logging
+from .utils.validators import InputValidator
+
+
+class ConfigValidationError(ValueError):
+    """Raised when pipeline configuration fails validation."""
+
+
+OptionsType = Union[Mapping[str, Any], object]
+
+
+def generate_execution_id(prefix: str = "fusesell") -> str:
+    """
+    Generate a unique execution identifier.
+
+    Args:
+        prefix: Optional prefix for the identifier (default ``"fusesell"``).
+
+    Returns:
+        Execution ID string.
+    """
+    timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
+    unique_id = uuid.uuid4().hex[:8]
+    return f"{prefix}_{timestamp}_{unique_id}"
+
+
+def build_config(options: OptionsType) -> Dict[str, Any]:
+    """
+    Build a pipeline configuration dictionary from a mapping or namespace.
+
+    Args:
+        options: Mapping, dataclass, or argparse namespace containing pipeline options.
+
+    Returns:
+        Normalised configuration dictionary suitable for ``FuseSellPipeline``.
+    """
+
+    def _get(name: str, default: Any = None) -> Any:
+        if isinstance(options, Mapping):
+            return options.get(name, default)
+        return getattr(options, name, default)
+
+    def _coerce_bool(value: Any, default: bool = False) -> bool:
+        if value is None:
+            return default
+        if isinstance(value, bool):
+            return value
+        if isinstance(value, str):
+            return value.strip().lower() in {"1", "true", "t", "yes", "y", "on"}
+        return bool(value)
+
+    def _ensure_list(value: Any) -> Sequence[str]:
+        if value is None:
+            return []
+        if isinstance(value, (list, tuple, set)):
+            return [str(item) for item in value if item]
+        if isinstance(value, str):
+            return [item.strip() for item in value.split(",") if item.strip()]
+        return [str(value)]
+
+    config: Dict[str, Any] = {
+        # API and LLM settings
+        "openai_api_key": _get("openai_api_key"),
+        "serper_api_key": _get("serper_api_key"),
+        "llm_model": _get("llm_model", "gpt-4o-mini"),
+        "llm_base_url": _get("llm_base_url"),
+        "temperature": float(_get("temperature", 0.7) or 0.7),
+        "max_retries": int(_get("max_retries", 3) or 3),
+
+        # Organisation settings
+        "org_id": _get("org_id"),
+        "org_name": _get("org_name"),
+        "team_id": _get("team_id"),
+        "team_name": _get("team_name"),
+        "project_code": _get("project_code"),
+        "staff_name": _get("staff_name", "Sales Team"),
+
+        # Data sources
+        "input_website": _get("input_website") or "",
+        "input_description": _get("input_description") or "",
+        "input_business_card": _get("input_business_card") or "",
+        "input_linkedin_url": _get("input_linkedin_url") or "",
+        "input_facebook_url": _get("input_facebook_url") or "",
+        "input_freetext": _get("input_freetext") or "",
+
+        # Context fields
+        "customer_id": _get("customer_id", "null"),
+        "full_input": _get("full_input"),
+        "language": (_get("language") or "english").lower(),
+
+        # Processing control
+        "skip_stages": list(_ensure_list(_get("skip_stages"))),
+        "stop_after": _get("stop_after"),
+
+        # Continuation / action parameters
+        "continue_execution": _get("continue_execution"),
+        "action": _get("action", "draft_write"),
+        "selected_draft_id": _get("selected_draft_id"),
+        "reason": _get("reason") or "",
+        "recipient_address": _get("recipient_address"),
+        "recipient_name": _get("recipient_name") or "",
+        "interaction_type": _get("interaction_type", "email"),
+        "human_action_id": _get("human_action_id") or "",
+
+        # Scheduling preferences
+        "send_immediately": _coerce_bool(_get("send_immediately"), False),
+        "customer_timezone": _get("customer_timezone") or "",
+        "business_hours_start": _get("business_hours_start", "08:00") or "08:00",
+        "business_hours_end": _get("business_hours_end", "20:00") or "20:00",
+        "delay_hours": int(_get("delay_hours", 2) or 2),
+
+        # Output and storage settings
+        "output_format": (_get("output_format") or "json").lower(),
+        "data_dir": _get("data_dir", "./fusesell_data"),
+        "execution_id": _get("execution_id") or generate_execution_id(),
+        "save_intermediate": _coerce_bool(_get("save_intermediate")),
+
+        # Logging and diagnostics
+        "log_level": (_get("log_level") or "INFO").upper(),
+        "log_file": _get("log_file"),
+        "verbose": _coerce_bool(_get("verbose")),
+        "dry_run": _coerce_bool(_get("dry_run")),
+    }
+
+    return config
+
+
+def prepare_data_directory(
+    config: MutableMapping[str, Any],
+    *,
+    assign_default_log: bool = True,
+    on_create: Optional[Callable[[Path], None]] = None,
+) -> Path:
+    """
+    Ensure the data directory structure exists for the given configuration.
+
+    Args:
+        config: Configuration dictionary (mutated in-place when log_file is assigned).
+        assign_default_log: When True, write a default log file path if none provided.
+        on_create: Optional callback invoked with the created ``Path``.
+
+    Returns:
+        Path to the resolved data directory.
+    """
+    data_dir = Path(config.get("data_dir") or "./fusesell_data").expanduser()
+    directories = [
+        data_dir,
+        data_dir / "config",
+        data_dir / "drafts",
+        data_dir / "logs",
+        data_dir / "exports",
+    ]
+
+    for directory in directories:
+        directory.mkdir(parents=True, exist_ok=True)
+
+    if assign_default_log and not config.get("log_file"):
+        log_filename = f"fusesell_{config['execution_id']}.log"
+        config["log_file"] = str((data_dir / "logs" / log_filename).resolve())
+
+    if on_create:
+        on_create(data_dir)
+
+    return data_dir
+
+
+def configure_logging(config: Mapping[str, Any]) -> logging.Logger:
+    """
+    Configure logging for the pipeline execution.
+
+    Args:
+        config: Pipeline configuration dictionary.
+
+    Returns:
+        Configured logger instance.
+    """
+    return _setup_logging(
+        level=config.get("log_level", "INFO"),
+        log_file=config.get("log_file"),
+        verbose=bool(config.get("verbose", False)),
+    )
+
+
+def validate_config(config: Mapping[str, Any]) -> Tuple[bool, list]:
+    """
+    Validate pipeline configuration for common issues.
+
+    Args:
+        config: Configuration dictionary to validate.
+
+    Returns:
+        Tuple of ``(is_valid, errors)``.
+    """
+    errors: list = []
+    validator = InputValidator()
+    errors.extend(validator.validate_config(dict(config)))
+
+    if not config.get("full_input"):
+        errors.append("Missing required configuration: full_input")
+
+    data_dir_valid, data_errors = validate_data_directory(config.get("data_dir"))
+    if not data_dir_valid:
+        errors.extend(data_errors)
+
+    if config.get("continue_execution"):
+        cont_valid, cont_errors = validate_continuation_params(config)
+        if not cont_valid:
+            errors.extend(cont_errors)
+
+    return len(errors) == 0, errors
+
+
+def validate_data_directory(data_dir: Optional[str]) -> Tuple[bool, list]:
+    """
+    Validate that the configured data directory is writable.
+
+    Args:
+        data_dir: Directory path supplied in configuration.
+
+    Returns:
+        Tuple of ``(is_valid, errors)``.
+    """
+    errors: list = []
+
+    try:
+        if not data_dir:
+            raise ValueError("Data directory is not configured")
+
+        path = Path(data_dir).expanduser()
+        path.mkdir(parents=True, exist_ok=True)
+
+        test_file = path / ".__fusesell_write_test__"
+        test_file.write_text("test")
+        test_file.unlink()
+    except Exception as exc:
+        errors.append(f"Failed to prepare data directory '{data_dir}': {exc}")
+
+    return len(errors) == 0, errors
+
+
+def validate_continuation_params(config: Mapping[str, Any]) -> Tuple[bool, list]:
+    """
+    Validate continuation parameters for follow-up executions.
+
+    Args:
+        config: Configuration dictionary.
+
+    Returns:
+        Tuple of ``(is_valid, errors)``.
+    """
+    errors: list = []
+    action = config.get("action")
+
+    if not action:
+        errors.append("Action is required when continuing execution")
+        return False, errors
+
+    valid_actions = {"draft_write", "draft_rewrite", "send", "close"}
+    if action not in valid_actions:
+        errors.append(f"Invalid action. Must be one of: {', '.join(sorted(valid_actions))}")
+
+    if action in {"draft_rewrite", "send"} and not config.get("selected_draft_id"):
+        errors.append("selected_draft_id is required for draft_rewrite and send actions")
+
+    if action == "send" and not config.get("recipient_address"):
+        errors.append("recipient_address is required for send actions")
+
+    return len(errors) == 0, errors
+
+
+def run_pipeline(config: Mapping[str, Any]) -> Dict[str, Any]:
+    """
+    Execute the FuseSell pipeline with a prepared configuration.
+
+    Args:
+        config: Validated configuration dictionary.
+
+    Returns:
+        Pipeline execution result dictionary.
+    """
+    pipeline = FuseSellPipeline(dict(config))
+    return pipeline.execute()
+
+
+def execute_pipeline(
+    options: OptionsType,
+    *,
+    auto_prepare: bool = True,
+    auto_configure_logging: bool = True,
+    auto_validate: bool = True,
+) -> Dict[str, Any]:
+    """
+    High-level helper that builds configuration from options and executes the pipeline.
+
+    Args:
+        options: Mapping or namespace of pipeline options.
+        auto_prepare: When True, prepare the data directory structure automatically.
+        auto_configure_logging: When True, configure logging before execution.
+        auto_validate: When True, validate configuration and raise ``ConfigValidationError`` on failure.
+
+    Returns:
+        Pipeline execution result dictionary.
+    """
+    config = build_config(options)
+
+    if auto_prepare:
+        prepare_data_directory(config)
+
+    if auto_configure_logging:
+        configure_logging(config)
+
+    if auto_validate:
+        valid, errors = validate_config(config)
+        if not valid:
+            raise ConfigValidationError("; ".join(errors))
+
+    if config.get("dry_run"):
+        return {
+            "status": "dry_run",
+            "execution_id": config["execution_id"],
+            "config": config,
+        }
+
+    return run_pipeline(config)
+