aip-agents-binary 0.5.24__py3-none-any.whl → 0.5.25b1__py3-none-any.whl

aip_agents/examples/demo_memory_recall.pyi

@@ -0,0 +1,58 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from datetime import datetime
+
+class MemoryTestResult:
+    """Container for test scenario results."""
+    JUDGE_SUCCESS_THRESHOLD: float
+    MEMORY_DISPLAY_LIMIT: int
+    scenario_name: Incomplete
+    query: Incomplete
+    response: Incomplete
+    memory_fetched: Incomplete
+    error: Incomplete
+    success: Incomplete
+    judge_verdict: Incomplete
+    judge_score: Incomplete
+    def __init__(self, scenario_name: str, query: str, response: str = None, memory_fetched: str = None, error: str = None) -> None:
+        """Initialize a memory test result.
+
+        Args:
+            scenario_name: Name of the test scenario.
+            query: The input query for the scenario.
+            response: The agent's response (optional).
+            memory_fetched: The raw memory retrieved from the tool (optional).
+            error: Any error message (optional).
+        """
+    def set_success_from_judge(self, verdict: str, score: float | None):
+        '''Set success using judge verdict and confidence score.
+
+        Success criteria: (verdict == "grounded" or verdict == "general_knowledge") and
+        score >= JUDGE_SUCCESS_THRESHOLD.
+
+        Args:
+            verdict (str): The judge\'s verdict ("grounded", "hallucination", or "general_knowledge").
+            score (float | None): The confidence score (0.0 to 1.0).
+        '''
+
+def print_test_summary(results: list[MemoryTestResult], start_time: datetime):
+    """Print a clean summary of all test results.
+
+    Args:
+        results (list[MemoryTestResult]): List of test results to summarize.
+        start_time (datetime): The start time of the tests.
+    """
+async def evaluate_with_judge(judge_agent: LangGraphAgent, query: str, response: str, memory_fetched: str = None) -> tuple[str | None, float | None]:
+    '''Evaluate if the response is grounded in memory using the judge agent.
+
+    Args:
+        judge_agent (LangGraphAgent): The judge agent to use for evaluation.
+        query (str): The original user query.
+        response (str): The agent\'s response to evaluate.
+        memory_fetched (str, optional): The memory that was retrieved. Defaults to None.
+
+    Returns:
+        tuple[str | None, float | None]: Tuple of (verdict, score) where verdict is "grounded", "hallucination", or "general_knowledge", and score is a confidence score (0.0-1.0).
+    '''
+async def run_all_scenarios() -> None:
+    """Run all memory recall test scenarios with a single reused agent and show clean summary."""

aip_agents/examples/hello_world_a2a_google_adk_client.pyi

@@ -0,0 +1,9 @@
+from _typeshed import Incomplete
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+
+def main() -> None:
+    """Main function demonstrating the General Assistant agent with A2A capabilities."""

aip_agents/examples/hello_world_a2a_google_adk_client_agent.pyi

@@ -0,0 +1,9 @@
+from _typeshed import Incomplete
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+
+def main() -> None:
+    """Main function demonstrating the General Assistant agent with A2A capabilities."""

aip_agents/examples/hello_world_a2a_google_adk_client_streaming.pyi

@@ -0,0 +1,9 @@
+from _typeshed import Incomplete
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+
+async def main():
+    """Main function demonstrating the General Assistant agent with streaming A2A capabilities."""

aip_agents/examples/hello_world_a2a_google_adk_server.pyi

@@ -0,0 +1,15 @@
+from _typeshed import Incomplete
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.examples.tools.adk_weather_tool import weather_tool as weather_tool
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+
+def main(host: str, port: int):
+    """Runs the Google ADK Weather A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_a2a_langchain_client.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+def main() -> None:
+    """Main function demonstrating the General Assistant agent with A2A capabilities."""

aip_agents/examples/hello_world_a2a_langchain_client_agent.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+def main() -> None:
+    """Main function demonstrating the General Assistant agent with A2A capabilities."""

aip_agents/examples/hello_world_a2a_langchain_client_lm_invoker.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+def main() -> None:
+    """Main function demonstrating the General Assistant agent with A2A capabilities."""

aip_agents/examples/hello_world_a2a_langchain_client_streaming.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+async def main() -> None:
+    """Main function demonstrating the General Assistant agent with streaming A2A capabilities."""

aip_agents/examples/hello_world_a2a_langchain_reference_client_streaming.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+async def main() -> None:
+    """Main function demonstrating streaming A2A client for the reference server."""

aip_agents/examples/hello_world_a2a_langchain_reference_server.pyi

@@ -0,0 +1,15 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.examples.tools import google_serper_tool as google_serper_tool, mock_retrieval_tool as mock_retrieval_tool, time_tool as time_tool
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+
+def main(host: str, port: int):
+    """Runs the LangChain Mock Retrieval and Google Search A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_a2a_langchain_server.pyi

@@ -0,0 +1,15 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.examples.tools.langchain_weather_tool import weather_tool as weather_tool
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+
+def main(host: str, port: int):
+    """Runs the LangChain Weather A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_a2a_langchain_server_lm_invoker.pyi

@@ -0,0 +1,15 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.examples.tools.langchain_weather_tool import weather_tool as weather_tool
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+
+def main(host: str, port: int):
+    """Runs the LangChain Weather A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_a2a_langflow_client.pyi

@@ -0,0 +1,9 @@
+from _typeshed import Incomplete
+from aip_agents.agent.langflow_agent import LangflowAgent as LangflowAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+
+async def main() -> None:
+    """Main function demonstrating the Langflow client with streaming A2A capabilities."""

aip_agents/examples/hello_world_a2a_langflow_server.pyi

@@ -0,0 +1,14 @@
+from _typeshed import Incomplete
+from aip_agents.agent.langflow_agent import LangflowAgent as LangflowAgent
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+
+def main(host: str, port: int):
+    """Runs the Langflow A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_a2a_langgraph_artifact_client.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+async def main() -> None:
+    """Main function demonstrating the General Assistant agent with A2A capabilities."""

aip_agents/examples/hello_world_a2a_langgraph_artifact_client_streaming.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+async def main() -> None:
+    """Main function demonstrating the General Assistant agent with streaming A2A capabilities."""

aip_agents/examples/hello_world_a2a_langgraph_artifact_server.pyi

@@ -0,0 +1,16 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.examples.tools.image_artifact_tool import ImageArtifactTool as ImageArtifactTool
+from aip_agents.examples.tools.table_generator_tool import TableGeneratorTool as TableGeneratorTool
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+
+def main(host: str, port: int):
+    """Runs the LangGraph Artifact Generation A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_a2a_langgraph_client.pyi

@@ -0,0 +1,9 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+
+def main() -> None:
+    """Main function demonstrating the General Assistant agent with A2A capabilities."""

aip_agents/examples/hello_world_a2a_langgraph_client_agent.pyi

@@ -0,0 +1,9 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+
+def main() -> None:
+    """Main function demonstrating the General Assistant agent with A2A capabilities."""

aip_agents/examples/hello_world_a2a_langgraph_client_agent_lm_invoker.pyi

@@ -0,0 +1,2 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig

aip_agents/examples/hello_world_a2a_langgraph_client_streaming.pyi

@@ -0,0 +1,9 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+
+async def main() -> None:
+    """Main function demonstrating the General Assistant agent with streaming A2A capabilities."""

aip_agents/examples/hello_world_a2a_langgraph_client_streaming_lm_invoker.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+async def main() -> None:
+    """Main function demonstrating the General Assistant agent with streaming A2A capabilities."""

aip_agents/examples/hello_world_a2a_langgraph_client_streaming_tool_streaming.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+async def main() -> None:
+    """Main function demonstrating the General Assistant agent with streaming A2A time/weather capabilities."""

aip_agents/examples/hello_world_a2a_langgraph_server.pyi

@@ -0,0 +1,14 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+
+def main(host: str, port: int):
+    """Runs the LangGraph Weather A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_a2a_langgraph_server_lm_invoker.pyi

@@ -0,0 +1,15 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.examples.tools.langchain_weather_tool import weather_tool as weather_tool
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+
+def main(host: str, port: int):
+    """Runs the LangChain Weather A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_a2a_langgraph_server_tool_streaming.pyi

@@ -0,0 +1,15 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.examples.tools.langgraph_streaming_tool import LangGraphStreamingTool as LangGraphStreamingTool
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+
+def main(host: str, port: int):
+    """Runs the LangGraph Agent Wrapper A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_a2a_mcp_langgraph.pyi

@@ -0,0 +1,48 @@
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+A2A_SERVER_PORT: int
+A2A_AGENT_NAME: str
+MCP_SERVER_PORT: int
+MCP_AGENT_NAME: str
+MODEL_NAME: str
+
+async def create_agent() -> tuple[LangGraphAgent, dict[str, bool]]:
+    """Create and configure the LangGraphAgent with MCP and A2A connections.
+
+    Returns:
+        tuple: (agent, connected_servers) where connected_servers is a dict
+        showing which servers were successfully connected.
+    """
+async def connect_to_mcp_server(agent: LangGraphAgent) -> bool:
+    """Connect to the MCP server and register tools.
+
+    Args:
+        agent: The LangGraphAgent instance to configure.
+
+    Returns:
+        bool: True if connection was successful, False otherwise.
+    """
+async def connect_to_a2a_server(agent: LangGraphAgent) -> bool:
+    """Connect to the A2A server and register agents.
+
+    Args:
+        agent: The LangGraphAgent instance to configure.
+
+    Returns:
+        bool: True if connection was successful, False otherwise.
+    """
+async def test_mcp_weather_tool(agent: LangGraphAgent) -> None:
+    """Test the MCP weather tool if available.
+
+    Args:
+        agent: The configured LangGraphAgent instance.
+    """
+async def test_stock_agent(agent: LangGraphAgent) -> None:
+    """Test the A2A Stock Agent if available.
+
+    Args:
+        agent: The configured LangGraphAgent instance.
+    """
+async def main() -> None:
+    """Main function to run the A2A and MCP integration example."""

aip_agents/examples/hello_world_a2a_three_level_agent_hierarchy_client.pyi

@@ -0,0 +1,48 @@
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+async def main() -> None:
+    """Main function demonstrating the Three-Level Agent Hierarchy client."""
+async def test_research_task(client_agent, coordinator_card) -> None:
+    """Test a research-only task that flows through research specialists and workers.
+
+    Args:
+        client_agent: The client agent to send the query with.
+        coordinator_card: The agent card of the hierarchical coordinator.
+    """
+async def test_content_task(client_agent, coordinator_card) -> None:
+    """Test a content-only task that flows through content specialists and workers.
+
+    Args:
+        client_agent: The client agent to send the query with.
+        coordinator_card: The agent card of the hierarchical coordinator.
+    """
+async def test_complex_task(client_agent, coordinator_card) -> None:
+    """Test a complex task requiring both research and content specialists.
+
+    Args:
+        client_agent: The client agent to send the query with.
+        coordinator_card: The agent card of the hierarchical coordinator.
+    """
+async def test_artifact_generation(client_agent, coordinator_card) -> None:
+    """Test artifact generation across the hierarchy.
+
+    Args:
+        client_agent: The client agent to send the query with.
+        coordinator_card: The agent card of the hierarchical coordinator.
+    """
+def handle_artifacts(result, test_name) -> None:
+    """Handle and display information about artifacts from the result.
+
+    Args:
+        result: The result from the agent containing artifacts.
+        test_name: The name of the test for display purposes.
+    """
+def print_artifact_info(artifact: dict) -> None:
+    """Print information about an artifact.
+
+    Args:
+        artifact: Dictionary containing artifact information.
+    """
+def print_hierarchy_info() -> None:
+    """Print information about the 3-level hierarchy being tested."""

aip_agents/examples/hello_world_a2a_three_level_agent_hierarchy_server.pyi

@@ -0,0 +1,45 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.examples.tools.image_artifact_tool import ImageArtifactTool as ImageArtifactTool
+from aip_agents.examples.tools.table_generator_tool import TableGeneratorTool as TableGeneratorTool
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+
+def create_worker_agents(llm) -> tuple[LangGraphAgent, LangGraphAgent, LangGraphAgent, LangGraphAgent]:
+    """Create Level 3 worker agents that perform atomic operations.
+
+    Args:
+        llm: The language model to use for the worker agents.
+
+    Returns:
+        tuple[LangGraphAgent, LangGraphAgent, LangGraphAgent, LangGraphAgent]: Tuple of (web_search_worker, data_analysis_worker, writing_worker, formatting_worker).
+    """
+def create_specialist_agents(llm, worker_agents) -> tuple[LangGraphAgent, LangGraphAgent]:
+    """Create Level 2 specialist agents that coordinate worker agents.
+
+    Args:
+        llm: The language model to use for the specialist agents.
+        worker_agents: Tuple of worker agents from create_worker_agents function.
+
+    Returns:
+        tuple[LangGraphAgent, LangGraphAgent]: Tuple of (research_specialist, content_specialist).
+    """
+def create_coordinator_agent(llm, specialist_agents) -> LangGraphAgent:
+    """Create Level 1 coordinator agent that orchestrates everything.
+
+    Args:
+        llm: The language model to use for the coordinator agent.
+        specialist_agents: Tuple of specialist agents from create_specialist_agents function.
+
+    Returns:
+        LangGraphAgent: The configured coordinator agent.
+    """
+def main(host: str, port: int):
+    """Runs the Three-Level Agent Hierarchy A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_a2a_with_metadata_langchain_client.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangGraphReactAgent as LangGraphReactAgent
+from aip_agents.schema.agent import A2AClientConfig as A2AClientConfig
+
+async def main() -> None:
+    """Demonstrate RunnableConfig with agent defaults and runtime overrides."""

aip_agents/examples/hello_world_a2a_with_metadata_langchain_server_lm_invoker.pyi

@@ -0,0 +1,15 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangGraphReactAgent as LangGraphReactAgent
+from aip_agents.examples.hello_world_a2a_langchain_server import SERVER_AGENT_NAME as SERVER_AGENT_NAME
+from aip_agents.examples.tools.langchain_currency_exchange_tool import CurrencyExchangeTool as CurrencyExchangeTool
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+
+def main(host: str, port: int):
+    """Runs the LangChain Currency Exchange A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_google_adk.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.examples.tools.adk_arithmetic_tools import sum_numbers as sum_numbers
+
+async def google_adk_example() -> None:
+    """Demonstrates the GoogleADKAgent's arun method."""

aip_agents/examples/hello_world_google_adk_mcp_http.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.examples.mcp_configs.configs import mcp_config_http as mcp_config_http
+
+async def main() -> None:
+    """Demonstrates the GoogleADKAgent with MCP tools via Streamable HTTP transport."""

aip_agents/examples/hello_world_google_adk_mcp_http_stream.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.examples.mcp_configs.configs import mcp_config_http as mcp_config_http
+
+async def main() -> None:
+    """Demonstrates the GoogleADKAgent with MCP tools via Streamable HTTP transport and streaming."""

aip_agents/examples/hello_world_google_adk_mcp_sse.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.examples.mcp_configs.configs import mcp_config_sse as mcp_config_sse
+
+async def main() -> None:
+    """Demonstrates the GoogleADKAgent with MCP tools via SSE transport."""

aip_agents/examples/hello_world_google_adk_mcp_sse_stream.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.examples.mcp_configs.configs import mcp_config_sse as mcp_config_sse
+
+async def main() -> None:
+    """Demonstrates the GoogleADKAgent with MCP tools via SSE transport and streaming."""

aip_agents/examples/hello_world_google_adk_mcp_stdio.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.examples.mcp_configs.configs import mcp_config_stdio as mcp_config_stdio
+
+async def main() -> None:
+    """Demonstrates the GoogleADKAgent with MCP tools via stdio transport."""

aip_agents/examples/hello_world_google_adk_mcp_stdio_stream.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.examples.mcp_configs.configs import mcp_config_stdio as mcp_config_stdio
+
+async def main() -> None:
+    """Demonstrates the GoogleADKAgent with MCP tools via stdio transport and streaming."""

aip_agents/examples/hello_world_google_adk_stream.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent.google_adk_agent import GoogleADKAgent as GoogleADKAgent
+from aip_agents.examples.tools.adk_arithmetic_tools import add_numbers as add_numbers
+
+async def google_adk_example_stream() -> None:
+    """Demonstrates the GoogleADKAgent's arun_stream method."""

aip_agents/examples/hello_world_langchain.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.examples.tools.langchain_arithmetic_tools import add_numbers as add_numbers
+
+async def langchain_example() -> None:
+    """Demonstrates the LangChainAgent's arun method."""

aip_agents/examples/hello_world_langchain_lm_invoker.pyi

@@ -0,0 +1,2 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.examples.tools.langchain_weather_tool import weather_tool as weather_tool

aip_agents/examples/hello_world_langchain_mcp_http.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.examples.mcp_configs.configs import mcp_config_http as mcp_config_http
+
+async def main() -> None:
+    """Demonstrates the LangChainAgent with MCP tools via Streamable HTTP transport."""

aip_agents/examples/hello_world_langchain_mcp_http_interactive.pyi

@@ -0,0 +1,16 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.utils.env_loader import load_local_env as load_local_env
+
+def print_help() -> None:
+    """Prints available commands and their descriptions."""
+def build_mcp_config_from_env() -> dict:
+    """Construct MCP configuration from environment variables.
+
+    Returns:
+        dict: MCP configuration dictionary.
+
+    Raises:
+        RuntimeError: If required environment variables are missing.
+    """
+async def main() -> None:
+    """Runs the interactive LangChainAgent with MCP tools via Streamable HTTP transport."""

aip_agents/examples/hello_world_langchain_mcp_http_stream.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.examples.mcp_configs.configs import mcp_config_http as mcp_config_http
+
+async def main() -> None:
+    """Demonstrates the LangChainAgent with MCP tools via Streamable HTTP transport and streaming capabilities."""

aip_agents/examples/hello_world_langchain_mcp_multi_server.pyi

@@ -0,0 +1,18 @@
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.examples.mcp_configs.configs import mcp_tool_whitelisting_demo as mcp_tool_whitelisting_demo
+from aip_agents.schema.a2a import A2AStreamEventType as A2AStreamEventType
+from aip_agents.utils.logger import logger_manager as logger_manager
+
+async def process_query(agent, query: str, is_allowed: bool = True) -> bool:
+    """Process a single query and report if tools were called.
+
+    Args:
+        agent: The LangChain agent to run.
+        query: The query to process.
+        is_allowed: Whether this query should use allowed tools.
+
+    Returns:
+        True if at least one tool was called while processing the query, False otherwise.
+    """
+async def main() -> None:
+    """Demo allowed_tools filtering with 3 MCP servers (STDIO, SSE, HTTP)."""