thoughtflow 0.0.2__py3-none-any.whl → 0.0.3__py3-none-any.whl

{thoughtflow-0.0.2.dist-info → thoughtflow-0.0.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: thoughtflow
-Version: 0.0.2
+Version: 0.0.3
 Summary: A minimal, explicit, Pythonic substrate for building reproducible, portable, testable LLM and agent systems.
 Project-URL: Homepage, https://github.com/jrolf/thoughtflow
 Project-URL: Documentation, https://thoughtflow.dev

thoughtflow-0.0.3.dist-info/RECORD

@@ -0,0 +1,25 @@
+thoughtflow/__init__.py,sha256=oeMPn51oJCvIB1m4hOj7yemq_2Ng9sTAlQ3zb0nNXnU,2541
+thoughtflow/_util.py,sha256=c0pMAdFXCGUFf9yhK3xwnqAD3SrlijD0eJVh0EekjMA,25260
+thoughtflow/action.py,sha256=ZCKC95luZwZPEUkHIf8V0ZYxRXZ_msFLtb85Zs_cETg,14246
+thoughtflow/agent.py,sha256=nSwUwUjjkcE2_dF81waSqRFmQ8xW3nQgwzX1VlEOJMo,1977
+thoughtflow/llm.py,sha256=_aZiTHzlavabeKNgdYd-uM45_R10JvvgEgSavNx_k0M,10528
+thoughtflow/message.py,sha256=5hR2Zs3tDRYLtYuuArqmJ4CgBDTUhjHj_RQhCN7tRrg,3800
+thoughtflow/py.typed,sha256=Y3QpSe9qtWcL1vKplcWdRY0cn5071TLJQWBO0QbxTm8,84
+thoughtflow/thought.py,sha256=i5Ca0IxaVGE688AhCpYFlk2vnJzotWZTX2IsW3cuLLU,43229
+thoughtflow/thoughtflow6.py,sha256=GMKlqxFyNvvMD7yIU7NEYAtuDZplapeFeK1pGf20u5o,162824
+thoughtflow/eval/__init__.py,sha256=WiXk5IarMdgQV-mCpWVq_ZwCq6iC6pAKwl9wbZsmmNA,866
+thoughtflow/eval/harness.py,sha256=DH8EGajfxIGsb9HLk7g-hnQM0t1C90VAk7bOPLK9OBQ,5505
+thoughtflow/eval/replay.py,sha256=-osU4BbjVdThLeM1bygCss7sqqHHvg9I43XEvVZkNd8,4011
+thoughtflow/memory/__init__.py,sha256=3DAxZ4NlvJbvyP-8p86WlwoU1BUF24V97a4Z0c0ZC0w,859
+thoughtflow/memory/base.py,sha256=TQn0JJd_t_k4FW73MWEbYNudwe0GEaaDqRyZIe9irvo,64870
+thoughtflow/tools/__init__.py,sha256=1bDivRtNS2rGDForiLMOGKjStBeZAWFH8wylAN3Ihjk,648
+thoughtflow/tools/base.py,sha256=VYRFDhzG912HFUR6W82kykm_FU-r4xg4aEzHBDN_b8M,4069
+thoughtflow/tools/registry.py,sha256=ERKStxvh_UkfLg7GebVFaifSuudFYAfYXbnxr7lC5o0,3335
+thoughtflow/trace/__init__.py,sha256=fQSpJJyYdtaI_L_QAD4NqvYA6yXS5xCJXxS5-rVUpoM,891
+thoughtflow/trace/events.py,sha256=jJtVzs2xSLb43CAW6_CqgBVGgM0gBJ1x-_xmQjwUGkw,4647
+thoughtflow/trace/schema.py,sha256=teyUJ3gV80ZgsU8oCYJmku_f-SDULKtvqqLjvp1eQ_E,3180
+thoughtflow/trace/session.py,sha256=ZYKMGe3t98A7LujG-nSuRQo83BvzqhZGKFXHZZU0amw,4225
+thoughtflow-0.0.3.dist-info/METADATA,sha256=4QewTCLBg1f8bGIsJiqUf6HPrZCMlk27t80eLiFGmkc,7548
+thoughtflow-0.0.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+thoughtflow-0.0.3.dist-info/licenses/LICENSE,sha256=Z__Z0xyty_n2lxI7UNvfqkgemXIP0_UliF5sZN8GsPw,1073
+thoughtflow-0.0.3.dist-info/RECORD,,

thoughtflow/adapters/__init__.py

@@ -1,43 +0,0 @@
-"""
-Provider adapters for ThoughtFlow.
-
-Adapters translate between ThoughtFlow's stable message schema and
-provider-specific APIs (OpenAI, Anthropic, local models, etc.).
-
-Example:
-    >>> from thoughtflow.adapters import OpenAIAdapter
-    >>> adapter = OpenAIAdapter(api_key="...")
-    >>> response = adapter.complete(messages, params)
-"""
-
-from __future__ import annotations
-
-from thoughtflow.adapters.base import Adapter, AdapterConfig
-
-# Lazy imports to avoid requiring all provider dependencies
-# Users only need to install the providers they use
-
-__all__ = [
-    "Adapter",
-    "AdapterConfig",
-    "OpenAIAdapter",
-    "AnthropicAdapter",
-    "LocalAdapter",
-]
-
-
-def __getattr__(name: str):
-    """Lazy load adapters to avoid import errors for missing dependencies."""
-    if name == "OpenAIAdapter":
-        from thoughtflow.adapters.openai import OpenAIAdapter
-
-        return OpenAIAdapter
-    elif name == "AnthropicAdapter":
-        from thoughtflow.adapters.anthropic import AnthropicAdapter
-
-        return AnthropicAdapter
-    elif name == "LocalAdapter":
-        from thoughtflow.adapters.local import LocalAdapter
-
-        return LocalAdapter
-    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

thoughtflow/adapters/anthropic.py

@@ -1,119 +0,0 @@
-"""
-Anthropic adapter for ThoughtFlow.
-
-Provides integration with Anthropic's API (Claude models).
-
-Requires: pip install thoughtflow[anthropic]
-"""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any
-
-from thoughtflow.adapters.base import Adapter, AdapterConfig, AdapterResponse
-
-if TYPE_CHECKING:
-    from thoughtflow.message import MessageList
-
-
-class AnthropicAdapter(Adapter):
-    """Adapter for Anthropic's API.
-
-    Supports Claude 3, Claude 2, and other Anthropic models.
-
-    Example:
-        >>> adapter = AnthropicAdapter(api_key="sk-ant-...")
-        >>> response = adapter.complete([
-        ...     {"role": "user", "content": "Hello!"}
-        ... ])
-        >>> print(response.content)
-
-    Attributes:
-        config: Adapter configuration.
-        client: Anthropic client instance (created lazily).
-    """
-
-    DEFAULT_MODEL = "claude-sonnet-4-20250514"
-
-    def __init__(
-        self,
-        api_key: str | None = None,
-        config: AdapterConfig | None = None,
-        **kwargs: Any,
-    ) -> None:
-        """Initialize the Anthropic adapter.
-
-        Args:
-            api_key: Anthropic API key. Can also be set via ANTHROPIC_API_KEY env var.
-            config: Full adapter configuration.
-            **kwargs: Additional config options.
-        """
-        if config is None:
-            config = AdapterConfig(api_key=api_key, **kwargs)
-        super().__init__(config)
-        self._client = None
-
-    @property
-    def client(self) -> Any:
-        """Lazy-load the Anthropic client.
-
-        Returns:
-            Anthropic client instance.
-
-        Raises:
-            ImportError: If anthropic package is not installed.
-        """
-        if self._client is None:
-            try:
-                from anthropic import Anthropic
-            except ImportError as e:
-                raise ImportError(
-                    "Anthropic package not installed. "
-                    "Install with: pip install thoughtflow[anthropic]"
-                ) from e
-
-            self._client = Anthropic(
-                api_key=self.config.api_key,
-                base_url=self.config.base_url,
-                timeout=self.config.timeout,
-                max_retries=self.config.max_retries,
-            )
-        return self._client
-
-    def complete(
-        self,
-        messages: MessageList,
-        params: dict[str, Any] | None = None,
-    ) -> AdapterResponse:
-        """Generate a completion using Anthropic's API.
-
-        Args:
-            messages: List of message dicts.
-            params: Optional parameters (model, temperature, max_tokens, etc.)
-
-        Returns:
-            AdapterResponse with the generated content.
-
-        Raises:
-            NotImplementedError: This is a placeholder implementation.
-        """
-        # TODO: Implement actual Anthropic API call
-        # Note: Anthropic uses a different message format (system as separate param)
-        raise NotImplementedError(
-            "AnthropicAdapter.complete() is not yet implemented. "
-            "This is a placeholder for the ThoughtFlow alpha release."
-        )
-
-    def get_capabilities(self) -> dict[str, Any]:
-        """Get Anthropic adapter capabilities.
-
-        Returns:
-            Dict of supported features.
-        """
-        return {
-            "streaming": True,
-            "tool_calling": True,
-            "vision": True,
-            "json_mode": False,  # Anthropic doesn't have native JSON mode
-            "seed": False,
-        }

thoughtflow/adapters/base.py

@@ -1,140 +0,0 @@
-"""
-Base adapter interface for ThoughtFlow.
-
-All provider adapters implement this interface, ensuring a stable
-contract across different LLM providers.
-"""
-
-from __future__ import annotations
-
-from abc import ABC, abstractmethod
-from dataclasses import dataclass, field
-from typing import TYPE_CHECKING, Any
-
-if TYPE_CHECKING:
-    from thoughtflow.message import MessageList
-
-
-@dataclass
-class AdapterConfig:
-    """Configuration for an adapter.
-
-    Attributes:
-        api_key: API key for the provider (if required).
-        base_url: Optional custom base URL for the API.
-        timeout: Request timeout in seconds.
-        max_retries: Maximum number of retries for failed requests.
-        default_model: Default model to use if not specified in params.
-        extra: Additional provider-specific configuration.
-    """
-
-    api_key: str | None = None
-    base_url: str | None = None
-    timeout: float = 60.0
-    max_retries: int = 3
-    default_model: str | None = None
-    extra: dict[str, Any] = field(default_factory=dict)
-
-
-@dataclass
-class AdapterResponse:
-    """Response from an adapter completion call.
-
-    Attributes:
-        content: The generated text content.
-        model: The model that generated the response.
-        usage: Token usage information (prompt, completion, total).
-        finish_reason: Why the model stopped (stop, length, tool_calls, etc.).
-        raw: The raw response from the provider (for debugging).
-    """
-
-    content: str
-    model: str | None = None
-    usage: dict[str, int] | None = None
-    finish_reason: str | None = None
-    raw: Any = None
-
-
-class Adapter(ABC):
-    """Abstract base class for provider adapters.
-
-    Adapters are responsible for:
-    - Translating ThoughtFlow's message format to provider-specific format
-    - Making API calls to the provider
-    - Translating responses back to ThoughtFlow's format
-    - Handling provider-specific errors and retries
-
-    Subclasses must implement:
-    - `complete()`: Synchronous completion
-    - `complete_async()`: Asynchronous completion (optional)
-    - `get_capabilities()`: Report adapter capabilities
-    """
-
-    def __init__(self, config: AdapterConfig | None = None, **kwargs: Any) -> None:
-        """Initialize the adapter.
-
-        Args:
-            config: Adapter configuration object.
-            **kwargs: Shorthand for config fields (api_key, base_url, etc.)
-        """
-        if config is None:
-            config = AdapterConfig(**kwargs)
-        self.config = config
-
-    @abstractmethod
-    def complete(
-        self,
-        messages: MessageList,
-        params: dict[str, Any] | None = None,
-    ) -> AdapterResponse:
-        """Generate a completion for the given messages.
-
-        Args:
-            messages: List of message dicts.
-            params: Optional parameters (model, temperature, max_tokens, etc.)
-
-        Returns:
-            AdapterResponse with the generated content.
-
-        Raises:
-            NotImplementedError: Subclasses must implement this method.
-        """
-        raise NotImplementedError
-
-    async def complete_async(
-        self,
-        messages: MessageList,
-        params: dict[str, Any] | None = None,
-    ) -> AdapterResponse:
-        """Async version of complete().
-
-        Default implementation calls the sync version.
-        Override for true async support.
-
-        Args:
-            messages: List of message dicts.
-            params: Optional parameters.
-
-        Returns:
-            AdapterResponse with the generated content.
-        """
-        # Default: fall back to sync
-        return self.complete(messages, params)
-
-    def get_capabilities(self) -> dict[str, Any]:
-        """Get the capabilities of this adapter.
-
-        Returns:
-            Dict describing what this adapter supports:
-            - streaming: bool
-            - tool_calling: bool
-            - vision: bool
-            - json_mode: bool
-            - etc.
-        """
-        return {
-            "streaming": False,
-            "tool_calling": False,
-            "vision": False,
-            "json_mode": False,
-        }

thoughtflow/adapters/local.py

@@ -1,133 +0,0 @@
-"""
-Local model adapter for ThoughtFlow.
-
-Provides integration with locally-running models via Ollama, LM Studio,
-or other local inference servers.
-
-Requires: pip install thoughtflow[local]
-"""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any
-
-from thoughtflow.adapters.base import Adapter, AdapterConfig, AdapterResponse
-
-if TYPE_CHECKING:
-    from thoughtflow.message import MessageList
-
-
-class LocalAdapter(Adapter):
-    """Adapter for locally-running models.
-
-    Supports Ollama, LM Studio, and other OpenAI-compatible local servers.
-
-    Example:
-        >>> # Using Ollama
-        >>> adapter = LocalAdapter(base_url="http://localhost:11434/v1")
-        >>> response = adapter.complete([
-        ...     {"role": "user", "content": "Hello!"}
-        ... ], params={"model": "llama3"})
-
-        >>> # Using LM Studio
-        >>> adapter = LocalAdapter(base_url="http://localhost:1234/v1")
-
-    Attributes:
-        config: Adapter configuration.
-        client: HTTP client for making requests.
-    """
-
-    DEFAULT_BASE_URL = "http://localhost:11434/v1"
-    DEFAULT_MODEL = "llama3"
-
-    def __init__(
-        self,
-        base_url: str | None = None,
-        config: AdapterConfig | None = None,
-        **kwargs: Any,
-    ) -> None:
-        """Initialize the local adapter.
-
-        Args:
-            base_url: URL of the local inference server.
-            config: Full adapter configuration.
-            **kwargs: Additional config options.
-        """
-        if config is None:
-            config = AdapterConfig(
-                base_url=base_url or self.DEFAULT_BASE_URL,
-                **kwargs,
-            )
-        super().__init__(config)
-        self._client = None
-
-    @property
-    def client(self) -> Any:
-        """Lazy-load the HTTP client.
-
-        Returns:
-            Ollama client or httpx client instance.
-
-        Raises:
-            ImportError: If required packages are not installed.
-        """
-        if self._client is None:
-            # Try Ollama first, fall back to generic OpenAI-compatible client
-            try:
-                from ollama import Client
-
-                self._client = Client(host=self.config.base_url)
-            except ImportError:
-                # Fall back to using OpenAI client with custom base_url
-                try:
-                    from openai import OpenAI
-
-                    self._client = OpenAI(
-                        base_url=self.config.base_url,
-                        api_key="not-needed",  # Local servers often don't need keys
-                    )
-                except ImportError as e:
-                    raise ImportError(
-                        "No local model client available. "
-                        "Install with: pip install thoughtflow[local] or thoughtflow[openai]"
-                    ) from e
-        return self._client
-
-    def complete(
-        self,
-        messages: MessageList,
-        params: dict[str, Any] | None = None,
-    ) -> AdapterResponse:
-        """Generate a completion using a local model.
-
-        Args:
-            messages: List of message dicts.
-            params: Optional parameters (model, temperature, etc.)
-
-        Returns:
-            AdapterResponse with the generated content.
-
-        Raises:
-            NotImplementedError: This is a placeholder implementation.
-        """
-        # TODO: Implement actual local model call
-        raise NotImplementedError(
-            "LocalAdapter.complete() is not yet implemented. "
-            "This is a placeholder for the ThoughtFlow alpha release."
-        )
-
-    def get_capabilities(self) -> dict[str, Any]:
-        """Get local adapter capabilities.
-
-        Note: Capabilities depend on the specific model being used.
-
-        Returns:
-            Dict of supported features.
-        """
-        return {
-            "streaming": True,
-            "tool_calling": False,  # Depends on model
-            "vision": False,  # Depends on model
-            "json_mode": False,
-            "seed": True,
-        }

thoughtflow/adapters/openai.py

@@ -1,118 +0,0 @@
-"""
-OpenAI adapter for ThoughtFlow.
-
-Provides integration with OpenAI's API (GPT-4, GPT-3.5, etc.)
-
-Requires: pip install thoughtflow[openai]
-"""
-
-from __future__ import annotations
-
-from typing import TYPE_CHECKING, Any
-
-from thoughtflow.adapters.base import Adapter, AdapterConfig, AdapterResponse
-
-if TYPE_CHECKING:
-    from thoughtflow.message import MessageList
-
-
-class OpenAIAdapter(Adapter):
-    """Adapter for OpenAI's API.
-
-    Supports GPT-4, GPT-3.5-turbo, and other OpenAI models.
-
-    Example:
-        >>> adapter = OpenAIAdapter(api_key="sk-...")
-        >>> response = adapter.complete([
-        ...     {"role": "user", "content": "Hello!"}
-        ... ])
-        >>> print(response.content)
-
-    Attributes:
-        config: Adapter configuration.
-        client: OpenAI client instance (created lazily).
-    """
-
-    DEFAULT_MODEL = "gpt-4o"
-
-    def __init__(
-        self,
-        api_key: str | None = None,
-        config: AdapterConfig | None = None,
-        **kwargs: Any,
-    ) -> None:
-        """Initialize the OpenAI adapter.
-
-        Args:
-            api_key: OpenAI API key. Can also be set via OPENAI_API_KEY env var.
-            config: Full adapter configuration.
-            **kwargs: Additional config options.
-        """
-        if config is None:
-            config = AdapterConfig(api_key=api_key, **kwargs)
-        super().__init__(config)
-        self._client = None
-
-    @property
-    def client(self) -> Any:
-        """Lazy-load the OpenAI client.
-
-        Returns:
-            OpenAI client instance.
-
-        Raises:
-            ImportError: If openai package is not installed.
-        """
-        if self._client is None:
-            try:
-                from openai import OpenAI
-            except ImportError as e:
-                raise ImportError(
-                    "OpenAI package not installed. "
-                    "Install with: pip install thoughtflow[openai]"
-                ) from e
-
-            self._client = OpenAI(
-                api_key=self.config.api_key,
-                base_url=self.config.base_url,
-                timeout=self.config.timeout,
-                max_retries=self.config.max_retries,
-            )
-        return self._client
-
-    def complete(
-        self,
-        messages: MessageList,
-        params: dict[str, Any] | None = None,
-    ) -> AdapterResponse:
-        """Generate a completion using OpenAI's API.
-
-        Args:
-            messages: List of message dicts.
-            params: Optional parameters (model, temperature, max_tokens, etc.)
-
-        Returns:
-            AdapterResponse with the generated content.
-
-        Raises:
-            NotImplementedError: This is a placeholder implementation.
-        """
-        # TODO: Implement actual OpenAI API call
-        raise NotImplementedError(
-            "OpenAIAdapter.complete() is not yet implemented. "
-            "This is a placeholder for the ThoughtFlow alpha release."
-        )
-
-    def get_capabilities(self) -> dict[str, Any]:
-        """Get OpenAI adapter capabilities.
-
-        Returns:
-            Dict of supported features.
-        """
-        return {
-            "streaming": True,
-            "tool_calling": True,
-            "vision": True,
-            "json_mode": True,
-            "seed": True,
-        }

thoughtflow-0.0.2.dist-info/RECORD

@@ -1,26 +0,0 @@
-thoughtflow/__init__.py,sha256=Jc_g5TDgnMFq3vNI5IBO8Xaja-f-KtjmW9NatIkUtYI,1375
-thoughtflow/_util.py,sha256=64QWe9TV3reyhmnlZDO_c3AtntHY6AFXe4MyqpJ20hs,2804
-thoughtflow/agent.py,sha256=yRL3OA1anQ6r_TUj8ncy0ZT5GF0G0rYaZxdV_YdpMig,4290
-thoughtflow/message.py,sha256=5hR2Zs3tDRYLtYuuArqmJ4CgBDTUhjHj_RQhCN7tRrg,3800
-thoughtflow/py.typed,sha256=Y3QpSe9qtWcL1vKplcWdRY0cn5071TLJQWBO0QbxTm8,84
-thoughtflow/adapters/__init__.py,sha256=OmGEgr08B7kwsSydINBQzsW5S_YDrzhLII05F1aqdak,1235
-thoughtflow/adapters/anthropic.py,sha256=IS-viYzbgde0em5cPiKkn8yQ6oHvkvBKL5_4JIBywG8,3500
-thoughtflow/adapters/base.py,sha256=vZE3M84AiPWSaGJIEKjkfB-FEgEswtBahNuHC_yBuhs,4102
-thoughtflow/adapters/local.py,sha256=XsCRtZ2HhLjXIOj-Du_RwLLgEOwGDVjvnQpze97wM1w,4037
-thoughtflow/adapters/openai.py,sha256=RcE5Le__j8P_UQf3dF8WMTW1Ie7zTNYgBUOWK7r1Tcc,3287
-thoughtflow/eval/__init__.py,sha256=WiXk5IarMdgQV-mCpWVq_ZwCq6iC6pAKwl9wbZsmmNA,866
-thoughtflow/eval/harness.py,sha256=DH8EGajfxIGsb9HLk7g-hnQM0t1C90VAk7bOPLK9OBQ,5505
-thoughtflow/eval/replay.py,sha256=-osU4BbjVdThLeM1bygCss7sqqHHvg9I43XEvVZkNd8,4011
-thoughtflow/memory/__init__.py,sha256=jwakjf3Rfi4Rk9HfadNHy6WGJ3VNG9GI3gSZO5Ebe5I,691
-thoughtflow/memory/base.py,sha256=WjnrJYT_b72BX3M6DontoVNhNW-SGVDbR2bAtyxy1-Q,4224
-thoughtflow/tools/__init__.py,sha256=1bDivRtNS2rGDForiLMOGKjStBeZAWFH8wylAN3Ihjk,648
-thoughtflow/tools/base.py,sha256=VYRFDhzG912HFUR6W82kykm_FU-r4xg4aEzHBDN_b8M,4069
-thoughtflow/tools/registry.py,sha256=ERKStxvh_UkfLg7GebVFaifSuudFYAfYXbnxr7lC5o0,3335
-thoughtflow/trace/__init__.py,sha256=fQSpJJyYdtaI_L_QAD4NqvYA6yXS5xCJXxS5-rVUpoM,891
-thoughtflow/trace/events.py,sha256=jJtVzs2xSLb43CAW6_CqgBVGgM0gBJ1x-_xmQjwUGkw,4647
-thoughtflow/trace/schema.py,sha256=teyUJ3gV80ZgsU8oCYJmku_f-SDULKtvqqLjvp1eQ_E,3180
-thoughtflow/trace/session.py,sha256=ZYKMGe3t98A7LujG-nSuRQo83BvzqhZGKFXHZZU0amw,4225
-thoughtflow-0.0.2.dist-info/METADATA,sha256=50ieenI8zDoK1IuHmNU1Tpa4ginxmUUuY7DQ5hw_Hck,7548
-thoughtflow-0.0.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-thoughtflow-0.0.2.dist-info/licenses/LICENSE,sha256=Z__Z0xyty_n2lxI7UNvfqkgemXIP0_UliF5sZN8GsPw,1073
-thoughtflow-0.0.2.dist-info/RECORD,,