gohumanloop 0.0.7__tar.gz → 0.0.9__tar.gz

{gohumanloop-0.0.7 → gohumanloop-0.0.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gohumanloop
-Version: 0.0.7
+Version: 0.0.9
 Summary: Perfecting AI workflows with human intelligence
 Author-email: gohumanloop authors <baird0917@163.com>
 Project-URL: repository, https://github.com/ptonlix/gohumanloop
@@ -33,7 +33,7 @@ Dynamic: license-file
 **GoHumanLoop**: A Python library empowering AI agents to dynamically request human input (approval/feedback/conversation) at critical stages. Core features:
 
 - `Human-in-the-loop control`: Lets AI agent systems pause and escalate decisions, enhancing safety and trust.
-- `Multi-channel integration`: Supports Terminal, Email, API, and frameworks like LangGraph/CrewAI (soon).
+- `Multi-channel integration`: Supports Terminal, Email, API, and frameworks like LangGraph/CrewAI/...(soon)
 - `Flexible workflows`: Combines automated reasoning with human oversight for reliable AI operations.
 
 Ensures responsible AI deployment by bridging autonomous agents and human judgment.
@@ -59,9 +59,10 @@ Ensures responsible AI deployment by bridging autonomous agents and human judgme
 
 ## 🎹 Getting Started
 
-To get started, check out the following example or jump straight into one of the [Examples](./examples/):
+To get started, check out the following example or jump straight into one of the [Examples Repo](https://github.com/ptonlix/gohumanloop-examples):
 
-- 🦜⛓️ [LangGraph](./examples/langgraph/)
+- 🦜⛓️ [LangGraph](https://github.com/ptonlix/gohumanloop-examples/tree/main/LangGraph)
+- 🚣‍ [CrewAI](https://github.com/ptonlix/gohumanloop-examples/tree/main/CrewAI)
 
 ### Installation
 
@@ -206,7 +207,7 @@ Perform `human-in-the-loop` interaction by entering:
 
 🚀🚀🚀 Completed successfully ~
 
-➡️ Check out more examples in the [Examples Directory](./examples/) and we look foward to your contributions!
+➡️ Check out more examples in the [Examples Repository](https://github.com/ptonlix/gohumanloop-examples) and we look foward to your contributions!
 
 ## 🎵 Why GoHumanloop?
 

{gohumanloop-0.0.7 → gohumanloop-0.0.9}/README.md

@@ -8,7 +8,7 @@
 **GoHumanLoop**: A Python library empowering AI agents to dynamically request human input (approval/feedback/conversation) at critical stages. Core features:
 
 - `Human-in-the-loop control`: Lets AI agent systems pause and escalate decisions, enhancing safety and trust.
-- `Multi-channel integration`: Supports Terminal, Email, API, and frameworks like LangGraph/CrewAI (soon).
+- `Multi-channel integration`: Supports Terminal, Email, API, and frameworks like LangGraph/CrewAI/...(soon)
 - `Flexible workflows`: Combines automated reasoning with human oversight for reliable AI operations.
 
 Ensures responsible AI deployment by bridging autonomous agents and human judgment.
@@ -34,9 +34,10 @@ Ensures responsible AI deployment by bridging autonomous agents and human judgme
 
 ## 🎹 Getting Started
 
-To get started, check out the following example or jump straight into one of the [Examples](./examples/):
+To get started, check out the following example or jump straight into one of the [Examples Repo](https://github.com/ptonlix/gohumanloop-examples):
 
-- 🦜⛓️ [LangGraph](./examples/langgraph/)
+- 🦜⛓️ [LangGraph](https://github.com/ptonlix/gohumanloop-examples/tree/main/LangGraph)
+- 🚣‍ [CrewAI](https://github.com/ptonlix/gohumanloop-examples/tree/main/CrewAI)
 
 ### Installation
 
@@ -181,7 +182,7 @@ Perform `human-in-the-loop` interaction by entering:
 
 🚀🚀🚀 Completed successfully ~
 
-➡️ Check out more examples in the [Examples Directory](./examples/) and we look foward to your contributions!
+➡️ Check out more examples in the [Examples Repository](https://github.com/ptonlix/gohumanloop-examples) and we look foward to your contributions!
 
 ## 🎵 Why GoHumanloop?
 

{gohumanloop-0.0.7 → gohumanloop-0.0.9}/gohumanloop/__init__.py

@@ -17,6 +17,8 @@ from gohumanloop.providers.terminal_provider import TerminalProvider
 
 from gohumanloop.utils import run_async_safely, get_secret_from_env
 
+from gohumanloop.adapters import HumanloopAdapter, AgentOpsHumanLoopCallback
+
 # Conditionally import EmailProvider
 try:
     from gohumanloop.providers.email_provider import EmailProvider  # noqa: F401
@@ -60,6 +62,9 @@ __all__ = [
     "APIProvider",
     "GoHumanLoopProvider",
     "TerminalProvider",
+    # Adapter Implementations
+    "HumanloopAdapter",
+    "AgentOpsHumanLoopCallback",
     # Utility Functions
     "run_async_safely",
     "get_secret_from_env",

{gohumanloop-0.0.7 → gohumanloop-0.0.9}/gohumanloop/adapters/__init__.py

@@ -1,5 +1,8 @@
-from .langgraph_adapter import (
+from .base_adapter import (
     HumanloopAdapter,
+    AgentOpsHumanLoopCallback,
+)
+from .langgraph_adapter import (
     LangGraphHumanLoopCallback,
     default_langgraph_callback_factory,
     interrupt,
@@ -9,6 +12,7 @@ from .langgraph_adapter import (
 
 __all__ = [
     "HumanloopAdapter",
+    "AgentOpsHumanLoopCallback",
     "LangGraphHumanLoopCallback",
     "default_langgraph_callback_factory",
     "interrupt",

{gohumanloop-0.0.7 → gohumanloop-0.0.9}/gohumanloop/adapters/base_adapter.py

@@ -708,36 +708,42 @@ class AgentOpsHumanLoopCallback(HumanLoopCallback):
     It records events, tracks metrics, and provides observability for human-agent interactions.
     """
 
-    import importlib.util
-
-    if importlib.util.find_spec("agentops") is not None:
-        from agentops.sdk import session, agent, operation, task  # type: ignore
-    else:
-        logger.debug(
-            "AgentOps package not installed. AgentOps features disabled. Please pip install agentops"
-        )
-
     def __init__(self, session_tags: Optional[List[str]] = None) -> None:
-        """Initialize the AgentOps human loop callback.
-
-        Args:
-            session_tags: Optional tags for AgentOps session tracking
-        """
         self.session_tags = session_tags or ["gohumanloop"]
+        self._operation = None
+        self._initialize_agentops()
 
+    def _initialize_agentops(self) -> None:
+        """Initialize AgentOps if available, otherwise fall back gracefully."""
         try:
-            import agentops  # type: ignore
+            import importlib.util
+
+            if importlib.util.find_spec("agentops"):
+                from agentops.sdk import operation  # type: ignore
+                import agentops  # type: ignore
 
-            agentops.init(tags=self.session_tags)
+                self._operation = operation
+                agentops.init(tags=self.session_tags)
+            else:
+                raise ImportError(
+                    "AgentOps package not installed. Features disabled. "
+                    "Please install with: pip install agentops"
+                )
         except Exception as e:
-            logger.warning(f"Failed to initialize AgentOps: {str(e)}")
+            logger.warning(f"AgentOps initialization failed: {e}")
+
+    @property
+    def operation_decorator(self) -> Callable:
+        """Return the appropriate decorator based on AgentOps availability."""
+        return self._operation if self._operation is not None else lambda f: f
 
-    @operation
     async def async_on_humanloop_request(
         self, provider: HumanLoopProvider, request: HumanLoopRequest
     ) -> Any:
         """Handle human loop start events."""
-        try:
+
+        @self.operation_decorator
+        async def callback_humanloop_request() -> Any:
             # Create event data
             event_data = {
                 "event_type": "gohumanloop_request",
@@ -752,10 +758,9 @@ class AgentOpsHumanLoopCallback(HumanLoopCallback):
                 "created_at": request.created_at,
             }
             return event_data
-        except (ImportError, Exception) as e:
-            logger.warning(f"Failed to record AgentOps event: {str(e)}")
 
-    @operation
+        return await callback_humanloop_request()
+
     async def async_on_humanloop_update(
         self, provider: HumanLoopProvider, result: HumanLoopResult
     ) -> Any:
@@ -765,7 +770,9 @@ class AgentOpsHumanLoopCallback(HumanLoopCallback):
             provider: The human loop provider instance
             result: The human loop result containing status and response
         """
-        try:
+
+        @self.operation_decorator
+        async def callback_humanloop_update() -> Any:
             # Create event data
             event_data = {
                 "event_type": "gohumanloop_update",
@@ -782,10 +789,9 @@ class AgentOpsHumanLoopCallback(HumanLoopCallback):
             }
 
             return event_data
-        except Exception as e:
-            logger.warning(f"Failed to record AgentOps event: {str(e)}")
 
-    @operation
+        return await callback_humanloop_update()
+
     async def async_on_humanloop_timeout(
         self, provider: HumanLoopProvider, result: HumanLoopResult
     ) -> Any:
@@ -794,7 +800,9 @@ class AgentOpsHumanLoopCallback(HumanLoopCallback):
         Args:
             provider: The human loop provider instance
         """
-        try:
+
+        @self.operation_decorator
+        async def callback_humanloop_timeout() -> Any:
             # Create error event
             error_data = {
                 "event_type": "gohumanloop_timeout",
@@ -811,10 +819,9 @@ class AgentOpsHumanLoopCallback(HumanLoopCallback):
             }
 
             return error_data
-        except Exception as e:
-            logger.warning(f"Failed to record AgentOps timeout event: {str(e)}")
 
-    @operation
+        return await callback_humanloop_timeout()
+
     async def async_on_humanloop_error(
         self, provider: HumanLoopProvider, error: Exception
     ) -> Any:
@@ -824,7 +831,9 @@ class AgentOpsHumanLoopCallback(HumanLoopCallback):
             provider: The human loop provider instance
             error: The exception that occurred
         """
-        try:
+
+        @self.operation_decorator
+        async def callback_humanloop_error() -> Any:
             # Create error event
             error_data = {
                 "event_type": "gohumanloop_error",
@@ -834,5 +843,5 @@ class AgentOpsHumanLoopCallback(HumanLoopCallback):
 
             # Record the error event
             return error_data
-        except Exception as e:
-            logger.warning(f"Failed to record AgentOps error event: {str(e)}")
+
+        return await callback_humanloop_error()

{gohumanloop-0.0.7 → gohumanloop-0.0.9}/gohumanloop.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gohumanloop
-Version: 0.0.7
+Version: 0.0.9
 Summary: Perfecting AI workflows with human intelligence
 Author-email: gohumanloop authors <baird0917@163.com>
 Project-URL: repository, https://github.com/ptonlix/gohumanloop
@@ -33,7 +33,7 @@ Dynamic: license-file
 **GoHumanLoop**: A Python library empowering AI agents to dynamically request human input (approval/feedback/conversation) at critical stages. Core features:
 
 - `Human-in-the-loop control`: Lets AI agent systems pause and escalate decisions, enhancing safety and trust.
-- `Multi-channel integration`: Supports Terminal, Email, API, and frameworks like LangGraph/CrewAI (soon).
+- `Multi-channel integration`: Supports Terminal, Email, API, and frameworks like LangGraph/CrewAI/...(soon)
 - `Flexible workflows`: Combines automated reasoning with human oversight for reliable AI operations.
 
 Ensures responsible AI deployment by bridging autonomous agents and human judgment.
@@ -59,9 +59,10 @@ Ensures responsible AI deployment by bridging autonomous agents and human judgme
 
 ## 🎹 Getting Started
 
-To get started, check out the following example or jump straight into one of the [Examples](./examples/):
+To get started, check out the following example or jump straight into one of the [Examples Repo](https://github.com/ptonlix/gohumanloop-examples):
 
-- 🦜⛓️ [LangGraph](./examples/langgraph/)
+- 🦜⛓️ [LangGraph](https://github.com/ptonlix/gohumanloop-examples/tree/main/LangGraph)
+- 🚣‍ [CrewAI](https://github.com/ptonlix/gohumanloop-examples/tree/main/CrewAI)
 
 ### Installation
 
@@ -206,7 +207,7 @@ Perform `human-in-the-loop` interaction by entering:
 
 🚀🚀🚀 Completed successfully ~
 
-➡️ Check out more examples in the [Examples Directory](./examples/) and we look foward to your contributions!
+➡️ Check out more examples in the [Examples Repository](https://github.com/ptonlix/gohumanloop-examples) and we look foward to your contributions!
 
 ## 🎵 Why GoHumanloop?
 

{gohumanloop-0.0.7 → gohumanloop-0.0.9}/pyproject.toml

@@ -3,7 +3,7 @@ authors = [
     {name = "gohumanloop authors", email = "baird0917@163.com"},
 ]
 name = "gohumanloop"
-version = "0.0.7"
+version = "0.0.9"
 description = "Perfecting AI workflows with human intelligence"
 readme = "README.md"
 requires-python = ">=3.10"