aip-agents-binary 0.5.25b8__py3-none-any.whl → 0.6.0__py3-none-any.whl

aip_agents/utils/sse_chunk_transformer.pyi

@@ -0,0 +1,166 @@
+from _typeshed import Incomplete
+from aip_agents.schema.a2a import A2AEvent
+from collections.abc import AsyncGenerator
+from enum import StrEnum
+from typing import Any
+
+__all__ = ['SSEChunkTransformer', 'TaskState', 'ChunkStatus', 'ChunkReason', 'ChunkFieldKeys']
+
+class TaskState(StrEnum):
+    """Task state values for SSE chunks."""
+    WORKING: str
+    COMPLETED: str
+    FAILED: str
+
+class ChunkStatus(StrEnum):
+    """Status values for SSE chunks."""
+    SUCCESS: str
+    ERROR: str
+
+class ChunkReason(StrEnum):
+    """Reason codes for special chunk states."""
+    EMPTY_PAYLOAD: str
+
+class ChunkFieldKeys(StrEnum):
+    """Field name constants for SSE chunk structure."""
+    STATUS: str
+    TASK_STATE: str
+    CONTENT: str
+    EVENT_TYPE: str
+    FINAL: str
+    METADATA: str
+    TIMESTAMP: str
+    TASK_ID: str
+    CONTEXT_ID: str
+    ARTIFACTS: str
+    REASON: str
+
+class SSEChunkTransformer:
+    '''Transforms A2AEvent stream to SSE-compatible output.
+
+    This class converts events from arun_a2a_stream into the normalized dict format
+    matching A2AConnector.astream_to_agent output.
+
+    Lifecycle:
+        Single-stream instance. Must NOT be reused across concurrent streams.
+        Each arun_sse_stream call creates a fresh instance.
+
+    Attributes:
+        task_id: Optional task identifier for the stream.
+        context_id: Optional context identifier for the stream.
+
+    Example:
+        >>> transformer = SSEChunkTransformer(task_id="task-123")
+        >>> async for chunk in transformer.transform_stream(agent.arun_a2a_stream("query")):
+        ...     print(chunk)
+    '''
+    task_id: Incomplete
+    context_id: Incomplete
+    def __init__(self, task_id: str | None = None, context_id: str | None = None, pii_mapping: dict[str, str] | None = None) -> None:
+        """Initialize the transformer with optional task and context IDs.
+
+        Args:
+            task_id: Optional task identifier for the stream.
+            context_id: Optional context identifier for the stream.
+            pii_mapping: Optional PII mapping to inject into each chunk's metadata.
+        """
+    @staticmethod
+    def normalize_metadata_enums(data: Any) -> Any:
+        """Recursively convert enum keys/values to their string values.
+
+        This is a pure normalization utility that converts any enum instances
+        (MetadataFieldKeys, Kind, Status, etc.) to their .value strings.
+
+        Args:
+            data: Dict, list, or value that may contain enum keys/values.
+
+        Returns:
+            Normalized data with all enums converted to their .value strings.
+        """
+    @staticmethod
+    def normalize_event_type_value(event_type: Any) -> str | None:
+        """Convert A2AStreamEventType enum to string.
+
+        Args:
+            event_type: Event type (enum, string, or None).
+
+        Returns:
+            String value of the event type, or None if invalid.
+        """
+    @staticmethod
+    def create_artifact_hash(artifact: dict[str, Any]) -> str:
+        """Create a stable hash for artifact deduplication.
+
+        Uses name, content_type, mime_type, and file_data for hashing,
+        excluding artifact_id which may be randomly generated.
+
+        Args:
+            artifact: Artifact dict with name, content_type, mime_type, and optionally file_data.
+
+        Returns:
+            SHA256 hexdigest hash string for deduplication.
+        """
+    @staticmethod
+    def extract_tool_outputs(tool_calls: list[dict[str, Any]]) -> list[str]:
+        """Extract human-readable output strings from tool calls.
+
+        Args:
+            tool_calls: List of tool call dictionaries.
+
+        Returns:
+            List of human-readable output strings.
+        """
+    @staticmethod
+    def format_tool_output(output: Any, tool_name: str) -> str:
+        """Format a single tool output for display.
+
+        Args:
+            output: The tool output to format.
+            tool_name: The name of the tool.
+
+        Returns:
+            The formatted output string.
+        """
+    @staticmethod
+    def apply_hitl_content_override(content: str | None, event_type_str: str, metadata: dict[str, Any]) -> str | None:
+        """Apply HITL content override when HITL is active and tool results are available.
+
+        This method overrides the content with human-readable tool output when HITL
+        is active, matching A2AConnector behavior.
+
+        Args:
+            content: The original content/status message.
+            event_type_str: The type of event being processed (normalized string).
+            metadata: The metadata dictionary containing tool_info and hitl flag.
+
+        Returns:
+            The original content or human-readable tool output if HITL is active.
+        """
+    def transform_event(self, event: A2AEvent) -> dict[str, Any]:
+        """Transform a single A2AEvent to SSE chunk format.
+
+        Converts the A2AEvent structure to the normalized SSE chunk format,
+        relocating fields like tool_info and thinking_and_activity_info into
+        metadata, and normalizing enum values to strings.
+
+        Args:
+            event: Single A2AEvent dict from arun_a2a_stream.
+
+        Returns:
+            SSEChunk dict with normalized structure.
+        """
+    async def transform_stream(self, stream: AsyncGenerator[A2AEvent, None]) -> AsyncGenerator[dict[str, Any], None]:
+        """Transform A2AEvent stream to SSE-compatible chunks.
+
+        Wraps the input stream and transforms each event, handling artifact
+        deduplication and time tracking across the stream.
+
+        Args:
+            stream: Async generator yielding A2AEvent dicts.
+
+        Yields:
+            SSEChunk dicts with normalized structure.
+
+        Raises:
+            Exceptions from underlying stream propagate to caller.
+        """

aip_agents/utils/step_limit_manager.pyi

@@ -0,0 +1,112 @@
+from _typeshed import Incomplete
+from aip_agents.schema.step_limit import MaxDelegationDepthExceededError as MaxDelegationDepthExceededError, MaxStepsExceededError as MaxStepsExceededError, StepLimitConfig as StepLimitConfig, StepLimitErrorResponse as StepLimitErrorResponse, StepLimitErrorType as StepLimitErrorType
+from dataclasses import dataclass, field
+from typing import Any
+
+@dataclass
+class StepExecutionContext:
+    """Runtime context for tracking step execution and delegation depth.
+
+    Attributes:
+        current_step: Current step number (0-indexed).
+        delegation_depth: Current depth in delegation chain (0 for root agent).
+        remaining_step_budget: Steps remaining before limit is hit.
+        delegation_chain: List of agent names in the delegation chain.
+    """
+    current_step: int = ...
+    delegation_depth: int = ...
+    remaining_step_budget: int | None = ...
+    delegation_chain: list[str] = field(default_factory=list)
+
+class StepLimitManager:
+    """Manages step and delegation limit enforcement during agent execution.
+
+    This manager integrates with LangGraph's existing step mechanisms and adds
+    delegation depth tracking and budget propagation.
+
+    Attributes:
+        config: Step limit configuration.
+        context: Current execution context.
+    """
+    config: Incomplete
+    context: Incomplete
+    def __init__(self, config: StepLimitConfig | None = None, initial_delegation_depth: int = 0, parent_step_budget: int | None = None) -> None:
+        """Initialize step limit manager.
+
+        Args:
+            config: Optional step limit configuration. Uses defaults if None.
+            initial_delegation_depth: Starting delegation depth (from parent).
+            parent_step_budget: Remaining step budget inherited from parent agent.
+        """
+    def check_step_limit(self, agent_name: str = 'agent', count: int = 1) -> None:
+        """Check if taking 'count' steps would exceed limit.
+
+        Args:
+            agent_name: Name of the agent to identify in error message.
+            count: Number of steps to check (useful for parallel tool batches).
+
+        Raises:
+            MaxStepsExceededError: If max_steps limit is exceeded.
+        """
+    def check_delegation_depth(self, target_agent_name: str) -> None:
+        """Check if delegation to target agent would exceed depth limit.
+
+        Args:
+            target_agent_name: Name of the agent to delegate to.
+
+        Raises:
+            MaxDelegationDepthExceededError: If delegation depth limit exceeded.
+        """
+    def increment_step(self, count: int = 1) -> None:
+        """Increment step counter and update remaining budget.
+
+        Args:
+            count: Number of steps to consume (defaults to 1).
+        """
+    def get_child_budget(self, child_max_steps: int | None = None) -> int:
+        """Calculate step budget to allocate to child agent.
+
+        Algorithm:
+        1. If remaining_step_budget is None (root with no limit), use config.max_steps - 1
+        2. If remaining_step_budget <= 1, return 0 (no budget left for child)
+        3. Calculate child_budget = remaining_step_budget - 1 (reserve 1 for parent)
+        4. If child has own max_steps config, return min(child_budget, child.max_steps)
+        5. Otherwise return child_budget
+
+        Args:
+            child_max_steps: Optional child agent's own max_steps limit.
+
+        Returns:
+            Step budget for child agent, accounting for parent's continuation.
+            Returns 0 if no budget available for child.
+
+        Edge Cases:
+            - remaining=1: Returns 0 (parent needs the last step)
+            - remaining=None: Uses config.max_steps - 1
+            - child has own limit: Returns min(calculated_budget, child_limit)
+        """
+    def add_to_delegation_chain(self, agent_name: str) -> None:
+        """Add agent to delegation chain for tracking.
+
+        Args:
+            agent_name: Name of the agent being delegated to.
+        """
+    @classmethod
+    def from_state(cls, state: dict[str, Any], config: StepLimitConfig | None = None) -> StepLimitManager:
+        """Create manager from LangGraph state.
+
+        Args:
+            state: LangGraph agent state containing remaining_steps, etc.
+            config: Optional step limit configuration.
+
+        Returns:
+            Initialized step limit manager.
+        """
+    def set_context(self) -> None:
+        """Set context variables for downstream consumption (e.g. by delegation tools)."""
+    def to_state_update(self) -> dict[str, Any]:
+        """Convert current context to LangGraph state update.
+
+        Returns:
+            Dictionary of state fields to update.
+        """

aip_agents/utils/token_usage_helper.pyi

@@ -0,0 +1,60 @@
+from langchain_core.messages.ai import AIMessage, UsageMetadata
+from langchain_core.messages.tool import ToolMessage as ToolMessage
+from langgraph.types import Command
+from typing import Any
+
+USAGE_METADATA_KEY: str
+TOTAL_USAGE_KEY: str
+STEP_USAGE_KEY: str
+
+def add_usage_metadata(cur_accumulated_token_usage: UsageMetadata | None, new_token_usage: UsageMetadata | None) -> UsageMetadata | None:
+    """Reducer function to accumulate UsageMetadata across agent runs.
+
+    Args:
+        cur_accumulated_token_usage: The current accumulated token usage metadata.
+        new_token_usage: New token usage metadata to add.
+
+    Returns:
+        Accumulated usage metadata or None if both inputs are None.
+    """
+def extract_and_update_token_usage_from_ai_message(ai_message: AIMessage) -> dict[str, Any]:
+    """Extract token usage from AI message and prepare state update.
+
+    Args:
+        ai_message: The AI message containing usage metadata.
+
+    Returns:
+        Dictionary with accumulated_usage_metadata update if usage metadata is available.
+    """
+def extract_token_usage_from_tool_output(tool_output: Any) -> UsageMetadata | None:
+    """Extract token usage from various tool output formats.
+
+    Supports multiple tool output formats:
+    1. Dictionary with 'usage_metadata' field
+    2. Command with 'usage_metadata' attribute
+    3. Any object with 'usage_metadata' attribute
+
+    Args:
+        tool_output: The output from a tool execution.
+
+    Returns:
+        UsageMetadata if found, None otherwise.
+    """
+def extract_token_usage_from_command(command: Command) -> UsageMetadata | None:
+    """Extract token usage from Command object.
+
+    Args:
+        command: The Command object to extract token usage from.
+
+    Returns:
+        UsageMetadata if found, None otherwise.
+    """
+def extract_token_usage_from_agent_response(agent_response: dict[str, Any]) -> UsageMetadata | None:
+    """Extract accumulated token usage from agent response.
+
+    Args:
+        agent_response: The agent response to extract token usage from.
+
+    Returns:
+        UsageMetadata if found, None otherwise.
+    """

{aip_agents_binary-0.5.25b8.dist-info → aip_agents_binary-0.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aip-agents-binary
-Version: 0.5.25b8
+Version: 0.6.0
 Summary: A library for managing agents in Gen AI applications.
 Author-email: Raymond Christopher <raymond.christopher@gdplabs.id>
 Requires-Python: <3.13,>=3.11
@@ -21,22 +21,12 @@ Requires-Dist: langchain<0.4.0,>=0.3.0
 Requires-Dist: langchain-openai<0.4.0,>=0.3.17
 Requires-Dist: langchain-mcp-adapters<0.1.0,>=0.0.10
 Requires-Dist: langchain-experimental<0.4.0,>=0.3.4
-Requires-Dist: langgraph<0.3.0,>=0.2.16
+Requires-Dist: langgraph<0.7.0,>=0.6.0
 Requires-Dist: minio<8.0.0,>=7.2.20
 Requires-Dist: pydantic<3.0.0,>=2.11.7
 Requires-Dist: python-dotenv<2.0.0,>=1.1.0
 Requires-Dist: requests<3.0.0,>=2.32.4
 Requires-Dist: uvicorn<0.35.0,>=0.34.3
-Provides-Extra: dev
-Requires-Dist: coverage<8.0.0,>=7.4.4; extra == "dev"
-Requires-Dist: mypy<2.0.0,>=1.15.0; extra == "dev"
-Requires-Dist: pre-commit<4.0.0,>=3.7.0; extra == "dev"
-Requires-Dist: pytest<9.0.0,>=8.1.1; extra == "dev"
-Requires-Dist: pytest-asyncio<0.24.0,>=0.23.6; extra == "dev"
-Requires-Dist: pytest-cov<6.0.0,>=5.0.0; extra == "dev"
-Requires-Dist: pytest-xdist>=3.8.0; extra == "dev"
-Requires-Dist: ruff<0.7.0,>=0.6.7; extra == "dev"
-Requires-Dist: pillow<12.0.0,>=11.3.0; extra == "dev"
 Provides-Extra: memory
 Requires-Dist: gllm-memory-binary[mem0ai]<0.2.0,>=0.1.1; extra == "memory"
 Provides-Extra: privacy
@@ -55,6 +45,17 @@ Requires-Dist: unidecode<2.0.0,>=1.3.0; extra == "local"
 Requires-Dist: gllm-docproc-binary[docx,pdf,xlsx]<0.8.0,>=0.7.21; extra == "local"
 Requires-Dist: gllm-multimodal-binary==0.2.0.post1; extra == "local"
 Requires-Dist: bosa-connectors-binary<0.4.0,>=0.3.1; extra == "local"
+Provides-Extra: dev
+Requires-Dist: coverage<8.0.0,>=7.4.4; extra == "dev"
+Requires-Dist: mypy<2.0.0,>=1.15.0; extra == "dev"
+Requires-Dist: nest-asyncio<2.0.0,>=1.6.0; extra == "dev"
+Requires-Dist: pre-commit<4.0.0,>=3.7.0; extra == "dev"
+Requires-Dist: pytest<9.0.0,>=8.1.1; extra == "dev"
+Requires-Dist: pytest-asyncio<0.24.0,>=0.23.6; extra == "dev"
+Requires-Dist: pytest-cov<6.0.0,>=5.0.0; extra == "dev"
+Requires-Dist: pytest-xdist>=3.8.0; extra == "dev"
+Requires-Dist: ruff<0.7.0,>=0.6.7; extra == "dev"
+Requires-Dist: pillow<12.0.0,>=11.3.0; extra == "dev"
 
 # AIP Agents
 
@@ -73,13 +74,13 @@ You can use `aip-agents` directly for local execution, or let `glaip-sdk` manage
 ### Prerequisites
 - Python 3.11 - 3.12 - [Install here](https://www.python.org/downloads/)
 - Pip (if using Pip) - [Install here](https://pip.pypa.io/en/stable/installation/)
-- uv (if using uv) - [Install here](https://docs.astral.sh/uv/)
+- Poetry 1.8.1+ (if using Poetry) - [Install here](https://python-poetry.org/docs/#installation)
 - Git (if using Git) - [Install here](https://git-scm.com/downloads)
 - For git installation:
   - Access to the [GDP Labs SDK repository](https://github.com/GDP-ADMIN/glaip-sdk)
 
 ### 1. Installation from the GDP Labs registry
-This package is published to the internal GDP Labs registry. Ensure your uv/pip config includes the registry:
+This package is published to the internal GDP Labs registry. Ensure your pip/Poetry config includes the registry:
 `https://glsdk.gdplabs.id/gen-ai-internal/simple/`.
 
 #### Using pip
@@ -87,15 +88,15 @@ This package is published to the internal GDP Labs registry. Ensure your uv/pip
 pip install aip-agents
 ```
 
-#### Using uv
+#### Using Poetry
 ```bash
-uv pip install aip-agents
+poetry add aip-agents
 ```
 
 ### 2. Development Installation (Git)
 For development purposes, you can install directly from the Git repository:
 ```bash
-uv pip install "git+ssh://git@github.com/GDP-ADMIN/glaip-sdk.git#subdirectory=python/aip-agents"
+poetry add "git+ssh://git@github.com/GDP-ADMIN/glaip-sdk.git#subdirectory=python/aip-agents"
 ```
 
 ### 3. Recommended: install via glaip-sdk for local mode
@@ -112,19 +113,21 @@ pip install "aip-agents[privacy]"
 
 ## Managing Dependencies
 1. Go to the `aip-agents` module root, e.g. `cd python/aip-agents`.
-2. Run `uv sync --extra dev` to install the `aip-agents` requirements.
-3. Run `uv lock` if you change any dependency versions in `pyproject.toml`.
+2. Run `poetry shell` to create a virtual environment.
+3. Run `poetry install` to install the `aip-agents` requirements (Poetry will generate a local lock file for you if needed; the repository ignores it).
+4. Run `poetry update` if you change any dependency versions in `pyproject.toml`.
 
 ## Contributing
 Please refer to this [Python Style Guide](https://docs.google.com/document/d/1uRggCrHnVfDPBnG641FyQBwUwLoFw0kTzNqRm92vUwM/edit?usp=sharing)
 to get information about code style, documentation standard, and SCA that you need to use when contributing to this project
 
 1. Activate `pre-commit` hooks using `pre-commit install`
-2. Run `uv sync --extra dev` to install the `aip-agents` requirements.
-3. Run `which python` to get the path to be referenced at Visual Studio Code interpreter path (`Ctrl`+`Shift`+`P` or `Cmd`+`Shift`+`P`)
-4. Try running the unit test to see if it's working:
+2. Run `poetry shell` to create a virtual environment.
+3. Run `poetry install` to install the `aip-agents` requirements (this will also create a local lock file that stays local).
+4. Run `which python` to get the path to be referenced at Visual Studio Code interpreter path (`Ctrl`+`Shift`+`P` or `Cmd`+`Shift`+`P`)
+5. Try running the unit test to see if it's working:
 ```bash
-uv run pytest -s tests/unit_tests/
+poetry run pytest -s tests/unit_tests/
 ```
 
 ## Hello World Examples
@@ -225,57 +228,57 @@ For STDIO, SSE, and HTTP transports using local servers, open a terminal in the
 - For STDIO:
 
 ```bash
-uv run python aip_agents/examples/mcp_servers/mcp_server_stdio.py
+poetry run python aip_agents/examples/mcp_servers/mcp_server_stdio.py
 ```
 
 - For SSE:
 
 ```bash
-uv run python aip_agents/examples/mcp_servers/mcp_server_sse.py
+poetry run python aip_agents/examples/mcp_servers/mcp_server_sse.py
 ```
 
 - For HTTP:
 
 ```bash
-uv run python aip_agents/examples/mcp_servers/mcp_server_http.py
+poetry run python aip_agents/examples/mcp_servers/mcp_server_http.py
 ```
 
 Note: Start the appropriate server before running the client examples for that transport.
 
 ### Running Examples
 
-All examples are run from the library root using `uv run python aip_agents/examples/<file>.py`. Examples support OpenAI for LangGraph/LangChain and Google ADK where specified.
+All examples are run from the library root using `poetry run python aip_agents/examples/<file>.py`. Examples support OpenAI for LangGraph/LangChain and Google ADK where specified.
 
 #### LangChain Examples
 
 ##### STDIO Transport
 - Non-Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langchain_mcp_stdio.py
+poetry run python aip_agents/examples/hello_world_langchain_mcp_stdio.py
 ```
 - Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langchain_mcp_stdio_stream.py
+poetry run python aip_agents/examples/hello_world_langchain_mcp_stdio_stream.py
 ```
 
 ##### SSE Transport
 - Non-Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langchain_mcp_sse.py
+poetry run python aip_agents/examples/hello_world_langchain_mcp_sse.py
 ```
 - Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langchain_mcp_sse_stream.py
+poetry run python aip_agents/examples/hello_world_langchain_mcp_sse_stream.py
 ```
 
 ##### HTTP Transport
 - Non-Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langchain_mcp_http.py
+poetry run python aip_agents/examples/hello_world_langchain_mcp_http.py
 ```
 - Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langchain_mcp_http_stream.py
+poetry run python aip_agents/examples/hello_world_langchain_mcp_http_stream.py
 ```
 
 #### Google ADK Examples
@@ -283,31 +286,31 @@ uv run python aip_agents/examples/hello_world_langchain_mcp_http_stream.py
 ##### STDIO Transport
 - Non-Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_google_adk_mcp_stdio.py
+poetry run python aip_agents/examples/hello_world_google_adk_mcp_stdio.py
 ```
 - Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_google_adk_mcp_stdio_stream.py
+poetry run python aip_agents/examples/hello_world_google_adk_mcp_stdio_stream.py
 ```
 
 ##### SSE Transport
 - Non-Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_google_adk_mcp_sse.py
+poetry run python aip_agents/examples/hello_world_google_adk_mcp_sse.py
 ```
 - Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_google_adk_mcp_sse_stream.py
+poetry run python aip_agents/examples/hello_world_google_adk_mcp_sse_stream.py
 ```
 
 ##### HTTP Transport
 - Non-Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_google_adk_mcp_http.py
+poetry run python aip_agents/examples/hello_world_google_adk_mcp_http.py
 ```
 - Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_google_adk_mcp_http_stream.py
+poetry run python aip_agents/examples/hello_world_google_adk_mcp_http_stream.py
 ```
 
 #### LangGraph Examples (OpenAI)
@@ -315,31 +318,31 @@ uv run python aip_agents/examples/hello_world_google_adk_mcp_http_stream.py
 ##### STDIO Transport
 - Non-Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langgraph_mcp_stdio.py
+poetry run python aip_agents/examples/hello_world_langgraph_mcp_stdio.py
 ```
 - Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langgraph_mcp_stdio_stream.py
+poetry run python aip_agents/examples/hello_world_langgraph_mcp_stdio_stream.py
 ```
 
 ##### SSE Transport
 - Non-Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langgraph_mcp_sse.py
+poetry run python aip_agents/examples/hello_world_langgraph_mcp_sse.py
 ```
 - Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langgraph_mcp_sse_stream.py
+poetry run python aip_agents/examples/hello_world_langgraph_mcp_sse_stream.py
 ```
 
 ##### HTTP Transport
 - Non-Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langgraph_mcp_http.py
+poetry run python aip_agents/examples/hello_world_langgraph_mcp_http.py
 ```
 - Streaming:
 ```bash
-uv run python aip_agents/examples/hello_world_langgraph_mcp_http_stream.py
+poetry run python aip_agents/examples/hello_world_langgraph_mcp_http_stream.py
 ```
 
 ### Multi-Server Example
@@ -355,13 +358,13 @@ npx @playwright/mcp@latest --headless --port 8931
 2. In another terminal, start the Name Generator SSE server:
 
 ```bash
-uv run python aip_agents/examples/mcp_servers/mcp_name.py
+poetry run python aip_agents/examples/mcp_servers/mcp_name.py
 ```
 
 3. Run the multi-server client example:
 
 ```bash
-uv run python aip_agents/examples/hello_world_langchain_mcp_multi_server.py
+poetry run python aip_agents/examples/hello_world_langchain_mcp_multi_server.py
 ```
 **3. Running Individual A2A Examples:**
 
@@ -477,7 +480,7 @@ The library supports Mem0 as a memory backend for long-term conversation recall.
 Use the coordinator example with memory enabled:
 
 ```bash
-uv run python aip_agents/examples/hello_world_a2a_mem0_coordinator_server.py
+poetry run python aip_agents/examples/hello_world_a2a_mem0_coordinator_server.py
 ```
 
 In client: