autobots-devtools-shared-lib 0.10.0__tar.gz → 0.10.0b1__tar.gz

{autobots_devtools_shared_lib-0.10.0 → autobots_devtools_shared_lib-0.10.0b1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autobots-devtools-shared-lib
-Version: 0.10.0
+Version: 0.10.0b1
 Summary: Shared library functions to be used for all autobots projects
 License: MIT
 Author: Pralhad
@@ -12,11 +12,13 @@ Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Requires-Dist: chainlit (>=2.9.6)
+Requires-Dist: deepagents (==0.6.12)
 Requires-Dist: fastapi (>=0.115.0)
 Requires-Dist: jsonschema (>=4.26.0)
-Requires-Dist: langchain (>=1.0.0)
-Requires-Dist: langchain-anthropic (>=1.4.0)
-Requires-Dist: langchain-google-genai (>=4.2.0)
+Requires-Dist: langchain (>=1.3.11,<2.0.0)
+Requires-Dist: langchain-anthropic (>=1.4.7,<2.0.0)
+Requires-Dist: langchain-core (>=1.4.8,<2.0.0)
+Requires-Dist: langchain-google-genai (>=4.2.5,<5.0.0)
 Requires-Dist: langfuse (>=3.12.1)
 Requires-Dist: openevals (>=0.1.0)
 Requires-Dist: opentelemetry-api (>=1.30.0,<2.0.0)

{autobots_devtools_shared_lib-0.10.0 → autobots_devtools_shared_lib-0.10.0b1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "autobots-devtools-shared-lib"
-version = "0.10.0"
+version = "0.10.0b1"
 description = "Shared library functions to be used for all autobots projects"
 readme = "README.md"
 authors = [
@@ -12,9 +12,11 @@ dependencies = [
     "chainlit>=2.9.6",
     "referencing>=0.37.0",
     "jsonschema>=4.26.0",
-    "langchain>=1.0.0",
-    "langchain-anthropic>=1.4.0",
-    "langchain-google-genai>=4.2.0",
+    "langchain>=1.3.11,<2.0.0",
+    "langchain-core>=1.4.8,<2.0.0",
+    "langchain-anthropic>=1.4.7,<2.0.0",
+    "langchain-google-genai>=4.2.5,<5.0.0",
+    "deepagents==0.6.12",
     "langfuse>=3.12.1",
     "pydantic-settings>=2.10.1",
     "python-dotenv>=1.1.1",

{autobots_devtools_shared_lib-0.10.0 → autobots_devtools_shared_lib-0.10.0b1}/src/autobots_devtools_shared_lib/dynagent/__init__.py

@@ -10,6 +10,7 @@ from autobots_devtools_shared_lib.common.utils.format_utils import output_format
 from autobots_devtools_shared_lib.dynagent.agents.agent_config_utils import get_batch_enabled_agents
 from autobots_devtools_shared_lib.dynagent.agents.agent_meta import AgentMeta
 from autobots_devtools_shared_lib.dynagent.agents.base_agent import create_base_agent
+from autobots_devtools_shared_lib.dynagent.agents.base_deepagent import create_base_deepagent
 from autobots_devtools_shared_lib.dynagent.agents.batch import (
     BatchResult,
     RecordResult,
@@ -17,7 +18,9 @@ from autobots_devtools_shared_lib.dynagent.agents.batch import (
 )
 from autobots_devtools_shared_lib.dynagent.agents.invocation_utils import (
     ainvoke_agent,
+    ainvoke_deepagent,
     invoke_agent,
+    invoke_deepagent,
 )
 from autobots_devtools_shared_lib.dynagent.config.dynagent_settings import (
     DynagentSettings,
@@ -26,22 +29,27 @@ from autobots_devtools_shared_lib.dynagent.config.dynagent_settings import (
     set_dynagent_settings,
 )
 from autobots_devtools_shared_lib.dynagent.llm.llm import lm
+from autobots_devtools_shared_lib.dynagent.models.deep_state import DynaDeepAgent
 from autobots_devtools_shared_lib.dynagent.models.state import Dynagent
 from autobots_devtools_shared_lib.dynagent.tools.tool_registry import register_usecase_tools
 
 __all__ = [
     "AgentMeta",
     "BatchResult",
+    "DynaDeepAgent",
     "Dynagent",
     "DynagentSettings",
     "LLMProvider",
     "RecordResult",
     "ainvoke_agent",
+    "ainvoke_deepagent",
     "batch_invoker",
     "create_base_agent",
+    "create_base_deepagent",
     "get_batch_enabled_agents",
     "get_dynagent_settings",
     "invoke_agent",
+    "invoke_deepagent",
     "lm",
     "make_context_tools",
     "output_format_converter",

{autobots_devtools_shared_lib-0.10.0 → autobots_devtools_shared_lib-0.10.0b1}/src/autobots_devtools_shared_lib/dynagent/agents/agent_config_utils.py

@@ -2,6 +2,8 @@
 # ABOUTME: Reads agents.yaml and provides typed accessors for prompts, tools, schemas.
 
 import json
+import os
+import re
 from dataclasses import dataclass, field
 from pathlib import Path
 from typing import Any
@@ -27,11 +29,37 @@ __all__ = [
     "get_resolved_input_schema_map",
     "get_resolved_output_schema_map",
     "get_tool_map",
+    "interpolate_env",
     "load_agents_config",
     "load_prompt",
     "load_schema",
 ]
 
+_ENV_VAR_PATTERN = re.compile(r"\$\{(\w+)\}")
+
+
+def interpolate_env(value: Any) -> Any:
+    """Recursively expand ${VAR} from os.environ in config values.
+
+    Fails fast on undefined variables so misconfigured domains surface at
+    startup instead of at first tool call.
+    """
+    if isinstance(value, str):
+
+        def _sub(match: re.Match[str]) -> str:
+            var = match.group(1)
+            if var not in os.environ:
+                msg = f"Config references undefined environment variable '${{{var}}}'"
+                raise ValueError(msg)
+            return os.environ[var]
+
+        return _ENV_VAR_PATTERN.sub(_sub, value)
+    if isinstance(value, dict):
+        return {key: interpolate_env(item) for key, item in value.items()}
+    if isinstance(value, list):
+        return [interpolate_env(item) for item in value]
+    return value
+
 
 @dataclass
 class AgentConfig:
@@ -128,10 +156,11 @@ def load_agents_config() -> dict[str, AgentConfig]:
     if _GLOBAL_AGENT_CONFIG:
         return _GLOBAL_AGENT_CONFIG
     config_dir = get_config_dir()
-    config_path = Path(config_dir) / "agents.yaml"
+    config_path = Path(config_dir) / get_dynagent_settings().agents_config_filename
 
     with open(config_path) as f:  # noqa: PTH123
         data = yaml.safe_load(f)
+    data = interpolate_env(data or {})
 
     agents = {}
     for agent_id, agent_data in data.get("agents", {}).items():

autobots_devtools_shared_lib-0.10.0b1/src/autobots_devtools_shared_lib/dynagent/agents/base_deepagent.py

@@ -0,0 +1,91 @@
+# ABOUTME: Factory for the dynagent deep-agent engine.
+# ABOUTME: Wraps deepagents' create_deep_agent, mirroring create_base_agent's role.
+
+import json
+from collections import defaultdict
+from collections.abc import Sequence
+from typing import Any
+
+from deepagents import DeepAgentState, SubAgent, create_deep_agent
+from langgraph.checkpoint.memory import InMemorySaver
+from langgraph.graph.state import CompiledStateGraph
+
+from autobots_devtools_shared_lib.common.observability import get_agent_logger
+from autobots_devtools_shared_lib.dynagent.agents.agent_config_utils import get_default_agent
+from autobots_devtools_shared_lib.dynagent.agents.agent_meta import AgentMeta
+from autobots_devtools_shared_lib.dynagent.llm.llm import lm
+from autobots_devtools_shared_lib.dynagent.models.deep_state import DynaDeepAgent
+
+logger = get_agent_logger(__name__)
+
+
+def _resolve_system_prompt(
+    meta: AgentMeta, agent_name: str, prompt_values: dict[str, Any] | None
+) -> str:
+    """Build the static system prompt: raw prompt + one-time format_map substitution.
+
+    Retains dynagent's placeholder templating (e.g. {language} -> java) but resolves
+    it once at build time, since the deep engine uses a static system_prompt.
+    """
+    raw_prompt = meta.prompt_map.get(agent_name, "")
+    input_schemas = meta.input_schema_map.get(agent_name, {})
+    input_directives = {
+        schema_key: json.dumps(schema, indent=2, sort_keys=True)
+        for schema_key, schema in input_schemas.items()
+    }
+    values = {
+        "input_schemas": input_directives,
+        "output_schema": meta.output_schema_map.get(agent_name, {}) or {},
+        **(prompt_values or {}),
+    }
+    return raw_prompt.format_map(defaultdict(str, values))
+
+
+def create_base_deepagent(
+    checkpointer: Any = None,
+    initial_agent_name: str | None = None,
+    state_schema: type[DeepAgentState] = DynaDeepAgent,
+    prompt_values: dict[str, Any] | None = None,
+    subagents: Sequence[SubAgent] | None = None,
+) -> CompiledStateGraph:
+    """Create the dynagent deep-agent (deepagents-backed) engine.
+
+    Mirrors create_base_agent but delegates the agent loop to deepagents'
+    create_deep_agent, which supplies planning, virtual filesystem, sub-agents,
+    summarization, and prompt caching. The deep engine deliberately does NOT
+    attach inject_agent or our SummarizationMiddleware.
+
+    Args:
+        checkpointer: LangGraph checkpointer. Defaults to InMemorySaver.
+        initial_agent_name: Roster agent to run as the main agent. Defaults to
+            the config's default agent.
+        state_schema: Deep-agent state schema. Defaults to DynaDeepAgent.
+        prompt_values: Placeholder substitution values for the system prompt.
+        subagents: Optional deepagents subagents (phase-2 roster mapping hook).
+
+    Returns:
+        A compiled deep-agent graph.
+    """
+    if checkpointer is None:
+        checkpointer = InMemorySaver()
+
+    meta = AgentMeta.instance()
+
+    if initial_agent_name is None:
+        initial_agent_name = get_default_agent()
+    agent_name = initial_agent_name or "assistant"
+    logger.info(f"create_base_deepagent: main agent = {agent_name}")
+
+    system_prompt = _resolve_system_prompt(meta, agent_name, prompt_values)
+    tools = meta.tool_map.get(agent_name, [])
+    model = lm()
+
+    return create_deep_agent(
+        model=model,
+        tools=tools,
+        system_prompt=system_prompt,
+        state_schema=state_schema,
+        checkpointer=checkpointer,
+        name=agent_name,
+        subagents=list(subagents) if subagents else None,
+    )

{autobots_devtools_shared_lib-0.10.0 → autobots_devtools_shared_lib-0.10.0b1}/src/autobots_devtools_shared_lib/dynagent/agents/invocation_utils.py

@@ -16,6 +16,7 @@ from autobots_devtools_shared_lib.common.observability.tracing import (
     flush_tracing,
     get_langfuse_handler,
 )
+from autobots_devtools_shared_lib.dynagent.models.deep_state import DynaDeepAgent
 from autobots_devtools_shared_lib.dynagent.models.state import Dynagent
 
 logger = get_logger(__name__)
@@ -205,6 +206,75 @@ def invoke_agent(
             flush_tracing()
 
 
+def invoke_deepagent(
+    agent_name: str,
+    input_state: dict[str, Any] | None = None,
+    checkpointer: Any | None = None,
+    config: RunnableConfig | None = None,
+    enable_tracing: bool = True,
+    trace_metadata: TraceMetadata | None = None,
+    state_schema: type[AgentState[ResponseT]] = DynaDeepAgent,
+) -> dict[str, Any]:
+    """Synchronously invoke a deep-agent (deepagents-backed) with observability.
+
+    Mirrors invoke_agent but builds the graph via create_base_deepagent.
+    """
+    from autobots_devtools_shared_lib.dynagent.agents.agent_config_utils import get_agent_list
+
+    valid_agents = get_agent_list()
+    if agent_name not in valid_agents:
+        raise ValueError(f"Unknown agent: {agent_name}. Valid agents: {', '.join(valid_agents)}")
+
+    if input_state is None:
+        input_state = {}
+    if trace_metadata is None:
+        trace_metadata = TraceMetadata.create(app_name=f"{agent_name}-invoke-deep")
+        if "session_id" in input_state:
+            trace_metadata.session_id = input_state["session_id"]
+
+    if "session_id" not in input_state:
+        input_state["session_id"] = trace_metadata.session_id
+    if "agent_name" not in input_state:
+        input_state["agent_name"] = agent_name
+
+    try:
+        with (
+            propagate_attributes(
+                user_id=trace_metadata.user_id,
+                session_id=trace_metadata.session_id,
+                tags=trace_metadata.tags,
+            ),
+            otel_span(f"{trace_metadata.app_name}-{agent_name}") as span,
+        ):
+            if enable_tracing:
+                config = inject_langfuse_handler_into_config(config, _linked_langfuse_handler(span))
+            if span is not None:
+                span.set_attribute("langfuse.session.id", str(trace_metadata.session_id))
+
+            from langgraph.checkpoint.memory import InMemorySaver
+
+            from autobots_devtools_shared_lib.dynagent.agents.base_deepagent import (
+                create_base_deepagent,
+            )
+
+            if checkpointer is None:
+                checkpointer = InMemorySaver()
+
+            agent = create_base_deepagent(
+                checkpointer=checkpointer,
+                state_schema=state_schema,
+                initial_agent_name=agent_name,
+            )
+
+            logger.info(
+                f"Invoking deepagent '{agent_name}' (sync) session_id={trace_metadata.session_id}"
+            )
+            return agent.invoke(input_state, config=config)
+    finally:
+        if enable_tracing:
+            flush_tracing()
+
+
 async def ainvoke_agent(
     agent_name: str,
     input_state: dict[str, Any] | None = None,
@@ -339,3 +409,72 @@ async def ainvoke_agent(
     finally:
         if enable_tracing:
             flush_tracing()
+
+
+async def ainvoke_deepagent(
+    agent_name: str,
+    input_state: dict[str, Any] | None = None,
+    checkpointer: Any | None = None,
+    config: RunnableConfig | None = None,
+    enable_tracing: bool = True,
+    trace_metadata: TraceMetadata | None = None,
+    state_schema: type[AgentState[ResponseT]] = DynaDeepAgent,
+) -> dict[str, Any]:
+    """Asynchronously invoke a deep-agent (deepagents-backed) with observability.
+
+    Mirrors ainvoke_agent but builds the graph via create_base_deepagent.
+    """
+    from autobots_devtools_shared_lib.dynagent.agents.agent_config_utils import get_agent_list
+
+    valid_agents = get_agent_list()
+    if agent_name not in valid_agents:
+        raise ValueError(f"Unknown agent: {agent_name}. Valid agents: {', '.join(valid_agents)}")
+
+    if input_state is None:
+        input_state = {}
+    if trace_metadata is None:
+        trace_metadata = TraceMetadata.create(app_name=f"{agent_name}-ainvoke-deep")
+        if "session_id" in input_state:
+            trace_metadata.session_id = input_state["session_id"]
+
+    if "session_id" not in input_state:
+        input_state["session_id"] = trace_metadata.session_id
+    if "agent_name" not in input_state:
+        input_state["agent_name"] = agent_name
+
+    try:
+        with (
+            propagate_attributes(
+                user_id=trace_metadata.user_id,
+                session_id=trace_metadata.session_id,
+                tags=trace_metadata.tags,
+            ),
+            otel_span(f"{trace_metadata.app_name}-{agent_name}") as span,
+        ):
+            if enable_tracing:
+                config = inject_langfuse_handler_into_config(config, _linked_langfuse_handler(span))
+            if span is not None:
+                span.set_attribute("langfuse.session.id", str(trace_metadata.session_id))
+
+            from langgraph.checkpoint.memory import InMemorySaver
+
+            from autobots_devtools_shared_lib.dynagent.agents.base_deepagent import (
+                create_base_deepagent,
+            )
+
+            if checkpointer is None:
+                checkpointer = InMemorySaver()
+
+            agent = create_base_deepagent(
+                checkpointer=checkpointer,
+                state_schema=state_schema,
+                initial_agent_name=agent_name,
+            )
+
+            logger.info(
+                f"Invoking deepagent '{agent_name}' (async) session_id={trace_metadata.session_id}"
+            )
+            return await agent.ainvoke(input_state, config=config)
+    finally:
+        if enable_tracing:
+            flush_tracing()

{autobots_devtools_shared_lib-0.10.0 → autobots_devtools_shared_lib-0.10.0b1}/src/autobots_devtools_shared_lib/dynagent/config/dynagent_settings.py

@@ -47,6 +47,12 @@ class DynagentSettings(BaseSettings):
         default=Path("configs"),
         description="Base directory for agent configuration files",
     )
+    # Filename of the agent roster config within the config dir (env: AGENTS_CONFIG_FILENAME).
+    # Deep-agent domains set this to "deep-agents.yaml".
+    agents_config_filename: str = Field(
+        default="agents.yaml",
+        description="Agent roster config filename within the config dir",
+    )
 
     # Langfuse observability settings
     langfuse_public_key: str = Field(default="", description="Langfuse public key")

autobots_devtools_shared_lib-0.10.0b1/src/autobots_devtools_shared_lib/dynagent/models/deep_state.py

@@ -0,0 +1,18 @@
+# ABOUTME: State schema for the dynagent deep-agent engine.
+# ABOUTME: Extends deepagents' DeepAgentState with routing/identity keys.
+
+from typing import NotRequired
+
+from deepagents import DeepAgentState
+
+
+class DynaDeepAgent(DeepAgentState):
+    """Deep-agent state carrying routing keys and optional user identity.
+
+    Mirrors Dynagent's identity keys, but on the deepagents base so it keeps
+    deepagents' messages delta reducer and todo/file state channels.
+    """
+
+    agent_name: NotRequired[str]
+    session_id: NotRequired[str]
+    user_name: NotRequired[str]