aip-agents-binary 0.5.20__py3-none-any.whl → 0.5.22__py3-none-any.whl

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)."""

aip_agents/examples/hello_world_langchain_mcp_sse.pyi

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

aip_agents/examples/hello_world_langchain_mcp_sse_stream.pyi

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

aip_agents/examples/hello_world_langchain_mcp_stdio.pyi

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

aip_agents/examples/hello_world_langchain_mcp_stdio_stream.pyi

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

aip_agents/examples/hello_world_langchain_stream.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_stream_example() -> None:
+    """Demonstrates the LangChainAgent's arun_stream method with async execution."""

aip_agents/examples/hello_world_langchain_stream_lm_invoker.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_stream_example() -> None:
+    """Demonstrates the LangChainAgent's arun_stream method with async execution."""

aip_agents/examples/hello_world_langflow_agent.pyi

@@ -0,0 +1,35 @@
+from aip_agents.agent.langflow_agent import LangflowAgent as LangflowAgent
+from aip_agents.clients.langflow import LangflowApiClient as LangflowApiClient
+
+async def fetch_flow_id() -> tuple[str, str]:
+    """Fetch available flows and return the first flow ID and name."""
+async def create_agent(flow_id: str, flow_name: str) -> LangflowAgent:
+    """Create and configure the Langflow agent.
+
+    Args:
+        flow_id (str): The flow ID to use for the agent.
+        flow_name (str): The name of the flow.
+
+    Returns:
+        LangflowAgent: The configured Langflow agent.
+    """
+async def demonstrate_regular_execution(agent: LangflowAgent) -> None:
+    """Demonstrate regular execution.
+
+    Args:
+        agent (LangflowAgent): The Langflow agent to demonstrate with.
+    """
+async def demonstrate_streaming(agent: LangflowAgent) -> None:
+    """Demonstrate streaming execution.
+
+    Args:
+        agent (LangflowAgent): The Langflow agent to demonstrate with.
+    """
+async def demonstrate_session_management(agent: LangflowAgent) -> None:
+    """Demonstrate session management.
+
+    Args:
+        agent (LangflowAgent): The Langflow agent to demonstrate with.
+    """
+async def main() -> None:
+    """Demonstrate basic Langflow agent usage."""

aip_agents/examples/hello_world_langgraph.pyi

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

aip_agents/examples/{hello_world_langgraph_bosa_twitter.py → hello_world_langgraph_gl_connector_twitter.py}

@@ -1,4 +1,4 @@
-"""Minimal LangGraph agent with bosa support example demonstrating asynchronous run.
+"""Minimal LangGraph agent with GL Connectors support example demonstrating asynchronous run.
 
 Authors:
     Saul Sayers (saul.sayers@gdplabs.id)
@@ -6,22 +6,24 @@ Authors:
 
 import asyncio
 
+from aip_agents.agent import LangGraphAgent
+from aip_agents.tools import GL_CONNECTORS_AUTOMATED_TOOLS
+from dotenv import load_dotenv
 from langchain_openai import ChatOpenAI
 
-from aip_agents.agent import LangGraphAgent
-from aip_agents.tools import BOSA_AUTOMATED_TOOLS
+load_dotenv(override=True)
 
 
-async def langgraph_bosa_example():
+async def langgraph_gl_connector_example():
     """Demonstrates the LangGraphAgent's arun method."""
     model = ChatOpenAI(model="gpt-4.1", temperature=0)
-    agent_name = "BOSAConnectorTwitterAgent"
+    agent_name = "GLConnectorTwitterAgent"
 
     langgraph_agent = LangGraphAgent(
         name=agent_name,
-        instruction="You are a helpful assistant that use BOSA connector to connect with Twitter API.",
+        instruction="You are a helpful assistant that uses GL Connectors to connect with the Twitter API.",
         model=model,
-        tools=BOSA_AUTOMATED_TOOLS["twitter"],
+        tools=GL_CONNECTORS_AUTOMATED_TOOLS["twitter"],
     )
 
     query = "Get 3 tweets about the latest Air India Incident"
@@ -38,4 +40,4 @@ async def langgraph_bosa_example():
 
 
 if __name__ == "__main__":
-    asyncio.run(langgraph_bosa_example())
+    asyncio.run(langgraph_gl_connector_example())

aip_agents/examples/hello_world_langgraph_gl_connector_twitter.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.tools import GL_CONNECTORS_AUTOMATED_TOOLS as GL_CONNECTORS_AUTOMATED_TOOLS
+
+async def langgraph_gl_connector_example() -> None:
+    """Demonstrates the LangGraphAgent's arun method."""

aip_agents/examples/hello_world_langgraph_mcp_http.pyi

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

aip_agents/examples/hello_world_langgraph_mcp_http_stream.pyi

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

aip_agents/examples/hello_world_langgraph_mcp_sse.pyi

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

aip_agents/examples/hello_world_langgraph_mcp_sse_stream.pyi

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

aip_agents/examples/hello_world_langgraph_mcp_stdio.pyi

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

aip_agents/examples/hello_world_langgraph_mcp_stdio_stream.pyi

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

aip_agents/examples/hello_world_langgraph_stream.pyi

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

aip_agents/examples/hello_world_langgraph_stream_lm_invoker.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 main() -> None:
+    """Demonstrates the LangChainAgent's arun_stream method with async execution."""

aip_agents/examples/hello_world_model_switch_cli.pyi

@@ -0,0 +1,30 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangChainAgent as LangChainAgent
+from aip_agents.schema.agent import AgentConfig as AgentConfig
+
+DEEPINFRA_URL: str
+MODEL_IDS: Incomplete
+MODEL_CONFIGS: Incomplete
+
+def make_agent(model_id):
+    """Makes an agent with the given model id.
+
+    Args:
+        model_id: The model identifier to use for the agent.
+
+    Returns:
+        LangChainAgent: The configured agent instance.
+    """
+def print_help() -> None:
+    """Prints available commands and their descriptions."""
+def handle_switch_model(current_model):
+    """Handles model switching. Returns (new_model, new_agent).
+
+    Args:
+        current_model: The currently active model identifier.
+
+    Returns:
+        tuple: (new_model, new_agent) where new_model is the selected model ID and new_agent is the configured agent instance.
+    """
+def main() -> None:
+    """Runs the Hello World Model Switch CLI."""

aip_agents/examples/hello_world_multi_agent_adk.pyi

@@ -0,0 +1,6 @@
+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
+from aip_agents.examples.tools.adk_weather_tool import get_weather as get_weather
+
+async def multi_agent_example() -> None:
+    """Demonstrates multi-agent coordination with GoogleADKAgent."""

aip_agents/examples/hello_world_multi_agent_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 main() -> None:
+    """Main function demonstrating the multi-agent setup with LangChainAgent."""

aip_agents/examples/hello_world_multi_agent_langgraph.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.examples.tools.langchain_arithmetic_tools import add_numbers as add_numbers
+
+async def main() -> None:
+    """Main function demonstrating the multi-agent setup with LangGraphAgent."""

aip_agents/examples/hello_world_multi_agent_langgraph_lm_invoker.pyi

@@ -0,0 +1,5 @@
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.examples.tools.langchain_arithmetic_tools import add_numbers as add_numbers
+
+async def main() -> None:
+    """Main function demonstrating the multi-agent setup with Lang."""

aip_agents/examples/hello_world_pii_logger.pyi

@@ -0,0 +1,5 @@
+from _typeshed import Incomplete
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+sensitive_info: str

aip_agents/examples/hello_world_sentry.py

@@ -1,4 +1,4 @@
-"""This is a simple FastAPI app to test Sentry with Open Telemetry from BOSA SDK.
+"""This is a simple FastAPI app to test Sentry with Open Telemetry from GL Connectors SDK.
 
 To run this example, make sure to set the following environment variables:
     SENTRY_DSN
@@ -20,13 +20,12 @@ import threading
 import time
 
 import uvicorn
-from fastapi import FastAPI
-from fastapi.responses import JSONResponse
-from fastapi.staticfiles import StaticFiles
-
 from aip_agents.examples.hello_world_langgraph import langgraph_example
 from aip_agents.sentry import setup_telemetry
 from aip_agents.utils.logger import get_logger
+from fastapi import FastAPI
+from fastapi.responses import JSONResponse
+from fastapi.staticfiles import StaticFiles
 
 logger = get_logger(__name__)
 
@@ -50,7 +49,9 @@ def fetch_endpoints():
             # Because using request.get() will trigger sentry, but the ep name is not saved.
             # Instead of GET /langgraph-hello-world, sentry will save it as GET
             url = f"http://127.0.0.1:8585{ep}"
-            result = subprocess.run(["curl", "-i", url], capture_output=True, text=True, check=False)
+            result = subprocess.run(
+                ["curl", "-i", url], capture_output=True, text=True, check=False
+            )
             logger.info(result.stdout)
         except Exception as e:
             logger.error(f"Error fetching {ep}: {e}")
@@ -63,7 +64,7 @@ def create_app() -> FastAPI:
         FastAPI: The configured FastAPI application.
     """
     app = FastAPI(
-        title="Bosa SDK - Sentry with Open Telemetry",
+        title="GL Connectors SDK - Sentry with Open Telemetry",
         description="This is a simple FastAPI app to test Sentry with Open Telemetry.",
         version="0.0.1",
         docs_url=None,

aip_agents/examples/hello_world_sentry.pyi

@@ -0,0 +1,21 @@
+from _typeshed import Incomplete
+from aip_agents.examples.hello_world_langgraph import langgraph_example as langgraph_example
+from aip_agents.sentry import setup_telemetry as setup_telemetry
+from aip_agents.utils.logger import get_logger as get_logger
+from fastapi import FastAPI
+
+logger: Incomplete
+BASE_URL: str
+SENTRY_ENVIRONMENT: Incomplete
+USE_OPENTELEMETRY: Incomplete
+
+def fetch_endpoints() -> None:
+    """Fetch all endpoints from the server."""
+def create_app() -> FastAPI:
+    """Create and configure the FastAPI application.
+
+    Returns:
+        FastAPI: The configured FastAPI application.
+    """
+def run_server() -> None:
+    """Run the FastAPI server."""

aip_agents/examples/hello_world_step_limits.pyi

@@ -0,0 +1,17 @@
+from aip_agents.agent import LangGraphReactAgent as LangGraphReactAgent
+from aip_agents.examples.tools.langchain_arithmetic_tools import add_numbers as add_numbers
+from aip_agents.schema.step_limit import MaxStepsExceededError as MaxStepsExceededError, StepLimitConfig as StepLimitConfig
+from aip_agents.utils.step_limit_manager import StepLimitManager as StepLimitManager
+
+def print_config_validation(config: StepLimitConfig | None, context: str):
+    """Print step limit configuration validation."""
+async def test_case_1_success_no_limits() -> None:
+    """Test Case 1: Success - High limits, no warnings."""
+async def test_case_2_parallel_tool_batch_accounting() -> None:
+    """Test Case 2: Demonstrate that parallel tool batches consume multiple steps."""
+async def test_case_3_step_limit_exceeded() -> None:
+    """Test Case 3: Step Limit Exceeded - Only 2 steps allowed."""
+async def test_case_4_delegation_depth_exceeded() -> None:
+    """Test Case 4: Delegation Depth Exceeded - Zero depth."""
+async def main() -> None:
+    """Run all test cases."""

aip_agents/examples/hello_world_stock_a2a_server.pyi

@@ -0,0 +1,17 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangGraphAgent as LangGraphAgent
+from aip_agents.examples.tools.stock_tools import StockNewsInput as StockNewsInput, StockPriceInput as StockPriceInput, get_stock_news as get_stock_news, get_stock_price as get_stock_price
+from aip_agents.utils.logger import get_logger as get_logger
+from langchain_core.tools import BaseTool as BaseTool
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+stock_tools: list[BaseTool]
+
+def main(host: str, port: int):
+    """Runs the StockAgent A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """

aip_agents/examples/hello_world_tool_output_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 tool output management with data visualization."""

aip_agents/examples/hello_world_tool_output_server.pyi

@@ -0,0 +1,19 @@
+from _typeshed import Incomplete
+from aip_agents.agent import LangGraphReactAgent as LangGraphReactAgent
+from aip_agents.examples.tools.data_generator_tool import DataGeneratorTool as DataGeneratorTool
+from aip_agents.examples.tools.data_visualization_tool import DataVisualizerTool as DataVisualizerTool
+from aip_agents.storage.clients.minio_client import MinioConfig as MinioConfig, MinioObjectStorage as MinioObjectStorage
+from aip_agents.storage.providers.object_storage import ObjectStorageProvider as ObjectStorageProvider
+from aip_agents.utils.langgraph.tool_output_management import ToolOutputConfig as ToolOutputConfig, ToolOutputManager as ToolOutputManager
+from aip_agents.utils.logger import get_logger as get_logger
+
+logger: Incomplete
+SERVER_AGENT_NAME: str
+
+def main(host: str, port: int):
+    """Run the Data Visualization A2A server.
+
+    Args:
+        host (str): Host to bind the server to.
+        port (int): Port to bind the server to.
+    """