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

thoughtflow/__init__.py

@@ -7,25 +7,54 @@ Core Philosophy:
     - Portability: Works across OpenAI, Anthropic, local models, serverless
     - Deterministic testing: Record/replay workflows, stable sessions
 
+Core Primitives:
+    - LLM: Multi-provider interface for language model calls
+    - MEMORY: Event-sourced state container (messages, logs, reflections, variables)
+    - THOUGHT: Unit of cognition (Prompt + Context + LLM + Parsing + Validation)
+    - ACTION: External operation wrapper with consistent logging
+
 Basic Usage:
-    >>> from thoughtflow import Agent
-    >>> from thoughtflow.adapters import OpenAIAdapter
+    >>> from thoughtflow import LLM, MEMORY, THOUGHT
+    >>>
+    >>> llm = LLM("openai:gpt-4o", key="your-api-key")
+    >>> memory = MEMORY()
+    >>> memory.add_msg("user", "Hello!")
     >>>
-    >>> adapter = OpenAIAdapter(api_key="...")
-    >>> agent = Agent(adapter)
-    >>> response = agent.call([
-    ...     {"role": "user", "content": "Hello!"}
-    ... ])
+    >>> thought = THOUGHT(
+    ...     name="respond",
+    ...     llm=llm,
+    ...     prompt="Respond to the user message: {last_user_msg}"
+    ... )
+    >>> memory = thought(memory)
+    >>> result = memory.get_var("respond_result")
 """
 
 from __future__ import annotations
 
-# Core exports
-from thoughtflow.agent import Agent
+# Core primitives
+from thoughtflow.llm import LLM
+from thoughtflow.memory.base import MEMORY
+from thoughtflow.thought import THOUGHT
+from thoughtflow.action import ACTION
+
+# Utilities
+from thoughtflow._util import (
+    EventStamp,
+    event_stamp,
+    hashify,
+    construct_prompt,
+    construct_msgs,
+    valid_extract,
+    ValidExtractError,
+)
+
+# Deprecated (for backward compatibility)
+from thoughtflow.agent import Agent, TracedAgent
+
+# Keep message types for potential utility
 from thoughtflow.message import Message, MessageList
 
-# Submodule access
-from thoughtflow import adapters
+# Submodule access (keep tools, trace, eval for advanced usage)
 from thoughtflow import tools
 from thoughtflow import memory
 from thoughtflow import trace
@@ -41,12 +70,26 @@ except Exception:
 
 # Public API
 __all__ = [
-    # Core
-    "Agent",
+    # Core Primitives
+    "LLM",
+    "MEMORY",
+    "THOUGHT",
+    "ACTION",
+    # Utilities
+    "EventStamp",
+    "event_stamp",
+    "hashify",
+    "construct_prompt",
+    "construct_msgs",
+    "valid_extract",
+    "ValidExtractError",
+    # Types
     "Message",
     "MessageList",
+    # Deprecated
+    "Agent",
+    "TracedAgent",
     # Submodules
-    "adapters",
     "tools",
     "memory",
     "trace",