buildlog 0.7.0__py3-none-any.whl → 0.9.0__py3-none-any.whl

buildlog/engine/__init__.py

@@ -0,0 +1,61 @@
+"""Buildlog Engine — agent-agnostic core for rule learning and experiment tracking.
+
+This package provides the pure algorithmic core of buildlog without any
+CLI, copier, or agent-specific rendering dependencies. Use it when you
+want Thompson Sampling bandits, confidence scoring, embedding similarity,
+or experiment tracking in your own tools.
+
+Usage:
+    from buildlog.engine import ThompsonSamplingBandit, BetaParams
+    from buildlog.engine import calculate_confidence, ConfidenceMetrics
+    from buildlog.engine import start_session, end_session, log_mistake
+    from buildlog.engine.types import Skill, Session, Mistake, RewardEvent
+
+Install:
+    pip install buildlog          # engine is part of the base package
+    pip install buildlog[engine]  # same thing — documents the namespace
+"""
+
+from buildlog.engine.bandit import BetaParams, ThompsonSamplingBandit
+from buildlog.engine.confidence import (
+    ConfidenceConfig,
+    ConfidenceMetrics,
+    calculate_confidence,
+    get_confidence_tier,
+    merge_confidence_metrics,
+)
+from buildlog.engine.experiments import (
+    end_session,
+    experiment_report,
+    get_rewards,
+    log_mistake,
+    log_reward,
+    session_metrics,
+    start_session,
+)
+from buildlog.engine.types import Mistake, RewardEvent, Session, Skill
+
+__all__ = [
+    # Bandit
+    "ThompsonSamplingBandit",
+    "BetaParams",
+    # Confidence
+    "calculate_confidence",
+    "get_confidence_tier",
+    "merge_confidence_metrics",
+    "ConfidenceMetrics",
+    "ConfidenceConfig",
+    # Experiments
+    "start_session",
+    "end_session",
+    "log_mistake",
+    "log_reward",
+    "get_rewards",
+    "session_metrics",
+    "experiment_report",
+    # Types
+    "Skill",
+    "Session",
+    "Mistake",
+    "RewardEvent",
+]

buildlog/engine/bandit.py

@@ -0,0 +1,23 @@
+"""Re-export Thompson Sampling bandit from core.
+
+Provides clean access to the bandit without reaching into core internals.
+
+Usage:
+    from buildlog.engine.bandit import ThompsonSamplingBandit, BetaParams
+"""
+
+from buildlog.core.bandit import (
+    DEFAULT_CONTEXT,
+    DEFAULT_SEED_BOOST,
+    BanditState,
+    BetaParams,
+    ThompsonSamplingBandit,
+)
+
+__all__ = [
+    "ThompsonSamplingBandit",
+    "BetaParams",
+    "BanditState",
+    "DEFAULT_SEED_BOOST",
+    "DEFAULT_CONTEXT",
+]

buildlog/engine/confidence.py

@@ -0,0 +1,28 @@
+"""Re-export confidence scoring from buildlog.confidence.
+
+Provides clean access to confidence calculation without reaching into
+top-level module internals.
+
+Usage:
+    from buildlog.engine.confidence import calculate_confidence, ConfidenceMetrics
+"""
+
+from buildlog.confidence import (
+    ConfidenceConfig,
+    ConfidenceMetrics,
+    ConfidenceTier,
+    add_contradiction,
+    calculate_confidence,
+    get_confidence_tier,
+    merge_confidence_metrics,
+)
+
+__all__ = [
+    "calculate_confidence",
+    "get_confidence_tier",
+    "merge_confidence_metrics",
+    "add_contradiction",
+    "ConfidenceMetrics",
+    "ConfidenceConfig",
+    "ConfidenceTier",
+]

buildlog/engine/embeddings.py

@@ -0,0 +1,28 @@
+"""Re-export embedding backends from buildlog.embeddings.
+
+Provides clean access to embedding similarity without reaching into
+top-level module internals.
+
+Usage:
+    from buildlog.engine.embeddings import similarity, TokenBackend
+"""
+
+from buildlog.embeddings import (
+    EmbeddingBackend,
+    OpenAIBackend,
+    SentenceTransformerBackend,
+    TokenBackend,
+    compute_embeddings,
+    get_backend,
+    similarity,
+)
+
+__all__ = [
+    "EmbeddingBackend",
+    "TokenBackend",
+    "SentenceTransformerBackend",
+    "OpenAIBackend",
+    "get_backend",
+    "similarity",
+    "compute_embeddings",
+]