:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
from abc import ABC
from typing import Generic
from django.conf import settings
from langchain_core.runnables import RunnableConfig
from posthog.models import Team, User
from posthog.sync import database_sync_to_async
from ee.hogai.context import AssistantContextManager
from ee.hogai.core.context import set_node_path
from ee.hogai.core.mixins import AssistantContextMixin, AssistantDispatcherMixin
from ee.hogai.utils.types.base import NodePath, PartialStateType, StateType
class BaseAgentExecutable(Generic[StateType, PartialStateType], AssistantContextMixin, AssistantDispatcherMixin, ABC):
"""Core assistant node with execution logic only."""
_config: RunnableConfig | None = None
_context_manager: AssistantContextManager | None = None
_node_path: tuple[NodePath, ...]
def __init__(self, team: Team, user: User, node_path: tuple[NodePath, ...]):
self._team = team
self._user = user
self._node_path = node_path
async def __call__(self, state: StateType, config: RunnableConfig) -> PartialStateType | None:
"""
Run the assistant node.
"""
# Reset the context manager on a new run
self._context_manager = None
self._dispatcher = None
self._config = config
return await self._execute(state, config)
def run(self, state: StateType, config: RunnableConfig) -> PartialStateType | None:
"""DEPRECATED. Use `arun` instead."""
raise NotImplementedError
async def arun(self, state: StateType, config: RunnableConfig) -> PartialStateType | None:
raise NotImplementedError
@property
def context_manager(self) -> AssistantContextManager:
if self._context_manager is None:
if self._config is None:
# Only allow default config in test environments
if settings.TEST:
config = RunnableConfig(configurable={})
else:
raise ValueError("Config is required to create AssistantContextManager")
else:
config = self._config
self._context_manager = AssistantContextManager(self._team, self._user, config)
return self._context_manager
@property
def node_name(self) -> str:
config_name: str | None = None
if self._config and (metadata := self._config.get("metadata")):
config_name = metadata.get("langgraph_node")
if config_name is not None:
config_name = str(config_name)
return config_name or self.__class__.__name__
@property
def node_path(self) -> tuple[NodePath, ...]:
return (*self._node_path, NodePath(name=self.node_name))
async def _execute(self, state: StateType, config: RunnableConfig) -> PartialStateType | None:
try:
return await self._arun_with_context(state, config)
except NotImplementedError:
pass
return await database_sync_to_async(self._run_with_context, thread_sensitive=False)(state, config)
def _run_with_context(self, state: StateType, config: RunnableConfig) -> PartialStateType | None:
with set_node_path(self.node_path):
return self.run(state, config)
async def _arun_with_context(self, state: StateType, config: RunnableConfig) -> PartialStateType | None:
with set_node_path(self.node_path):
return await self.arun(state, config)