gohumanloop 0.0.7__py3-none-any.whl → 0.0.9__py3-none-any.whl

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/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/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.dist-info → gohumanloop-0.0.9.dist-info}/METADATA

@@ -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.dist-info → gohumanloop-0.0.9.dist-info}/RECORD

@@ -1,7 +1,7 @@
-gohumanloop/__init__.py,sha256=oJqVOtRRDHNxwxZ2Blw7ycBRwcTBMTURUCx-XcL2YJ0,1969
+gohumanloop/__init__.py,sha256=KiY2ncM6OQvkBYcz5rsbob_GuV8hQHOARA-EsxAylEU,2134
 gohumanloop/__main__.py,sha256=zdGKN92H9SgwZfL4xLqPkE1YaiRcHhVg_GqC-H1VurA,75
-gohumanloop/adapters/__init__.py,sha256=GTEonjk1NogjtUVtgiLWciWR_e9-PbAlZfQUdA8paik,390
-gohumanloop/adapters/base_adapter.py,sha256=LTnjVnownYqJCQQeD3V53STEOvIm9n9cNYPaENULMJQ,32244
+gohumanloop/adapters/__init__.py,sha256=_XqJ6eaUBLJJJyjfBQJykBZ4X9HvC3VYOVTn2KnBlqo,484
+gohumanloop/adapters/base_adapter.py,sha256=Eokhz6fsCcxqq_X0damHQJ2BfGqEUnx2ZQv9gDcpOhU,32605
 gohumanloop/adapters/langgraph_adapter.py,sha256=AHJv_b6g8xjeq_9X2cGiW76pSGlfgCGBUvjrZQcbR9s,11621
 gohumanloop/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 gohumanloop/cli/main.py,sha256=Txjk31MlkiX9zeHZfFEXEu0s2IBESY8sxrxBEzZKk2U,767
@@ -23,9 +23,9 @@ gohumanloop/utils/__init__.py,sha256=l0e3lnOVrt6HwaxidNGFXORX4awCKemhJZ_t3k-5u-s
 gohumanloop/utils/context_formatter.py,sha256=sAWrKJpxmsHga6gsyBwFBlAsHW8bjR1hkaGhk1PoE1M,2064
 gohumanloop/utils/threadsafedict.py,sha256=9uyewnwmvS3u1fCx3SK0YWFxHMcyIwlye1Ev7WW7WHA,9588
 gohumanloop/utils/utils.py,sha256=-bti65OaVh5dlvc5BIgiTw6dqxmqdKnOQHE0V-LKjek,2107
-gohumanloop-0.0.7.dist-info/licenses/LICENSE,sha256=-U5tuCcSpndQwSKWtZbFbazb-_AtZcZL2kQgHbSLg-M,1064
-gohumanloop-0.0.7.dist-info/METADATA,sha256=3TYk0bxxF9ynRetWwdi_IOlmjb30W1ZI4yTxzpv69WI,11216
-gohumanloop-0.0.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-gohumanloop-0.0.7.dist-info/entry_points.txt,sha256=wM6jqRRD8bQXkvIduRVCuAJIlbyWg_F5EDXo5OZ_PwY,88
-gohumanloop-0.0.7.dist-info/top_level.txt,sha256=LvOXBqS6Mspmcuqp81uz0Vjx_m_YI0w06DOPCiI1BfY,12
-gohumanloop-0.0.7.dist-info/RECORD,,
+gohumanloop-0.0.9.dist-info/licenses/LICENSE,sha256=-U5tuCcSpndQwSKWtZbFbazb-_AtZcZL2kQgHbSLg-M,1064
+gohumanloop-0.0.9.dist-info/METADATA,sha256=E9DyAVAdkVPxP0K465Jrm4eq44AEXKe-riSCDN-67zM,11427
+gohumanloop-0.0.9.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+gohumanloop-0.0.9.dist-info/entry_points.txt,sha256=wM6jqRRD8bQXkvIduRVCuAJIlbyWg_F5EDXo5OZ_PwY,88
+gohumanloop-0.0.9.dist-info/top_level.txt,sha256=LvOXBqS6Mspmcuqp81uz0Vjx_m_YI0w06DOPCiI1BfY,12
+gohumanloop-0.0.9.dist-info/RECORD,,