glaip-sdk 0.6.16__py3-none-any.whl → 0.6.18__py3-none-any.whl

glaip_sdk/client/run_rendering.py

@@ -30,6 +30,7 @@ from glaip_sdk.utils.rendering.renderer import (
 from glaip_sdk.utils.rendering.state import TranscriptBuffer
 
 NO_AGENT_RESPONSE_FALLBACK = "No agent response received."
+_FINAL_EVENT_TYPES = {"final_response", "error", "step_limit_exceeded"}
 
 
 def _coerce_to_string(value: Any) -> str:
@@ -156,6 +157,9 @@ class AgentRunRenderingManager:
 
                 if controller and getattr(controller, "enabled", False):
                     controller.poll(renderer)
+                parsed_event = self._parse_event(event)
+                if parsed_event and self._is_final_event(parsed_event):
+                    break
         finally:
             if controller and getattr(controller, "enabled", False):
                 controller.on_stream_complete()
@@ -225,6 +229,8 @@ class AgentRunRenderingManager:
 
                 if controller and getattr(controller, "enabled", False):
                     controller.poll(renderer)
+                if parsed_event and self._is_final_event(parsed_event):
+                    break
         finally:
             if controller and getattr(controller, "enabled", False):
                 controller.on_stream_complete()
@@ -379,9 +385,19 @@ class AgentRunRenderingManager:
         if content:
             content_str = str(content)
             if not content_str.startswith("Artifact received:"):
-                if content_str != last_rendered_content:
+                kind = self._get_event_kind(ev)
+                # Skip accumulating content for status updates and agent steps
+                if kind in ("agent_step", "status_update"):
+                    renderer.on_event(ev)
+                    return final_text, stats_usage
+
+                if self._is_token_event(ev):
                     renderer.on_event(ev)
-                final_text = content_str
+                    final_text = f"{final_text}{content_str}"
+                else:
+                    if content_str != last_rendered_content:
+                        renderer.on_event(ev)
+                    final_text = content_str
         else:
             renderer.on_event(ev)
         return final_text, stats_usage
@@ -402,6 +418,33 @@ class AgentRunRenderingManager:
         event_type = ev.get("event_type")
         return str(event_type) if event_type else None
 
+    def _is_token_event(self, ev: dict[str, Any]) -> bool:
+        """Return True when the event represents token streaming output.
+
+        Args:
+            ev: Parsed event dictionary.
+
+        Returns:
+            True when the event is a token chunk, otherwise False.
+        """
+        metadata = ev.get("metadata") or {}
+        kind = metadata.get("kind")
+        return str(kind).lower() == "token"
+
+    def _is_final_event(self, ev: dict[str, Any]) -> bool:
+        """Return True when the event marks stream termination.
+
+        Args:
+            ev: Parsed event dictionary.
+
+        Returns:
+            True when the event is terminal, otherwise False.
+        """
+        if ev.get("is_final") is True or ev.get("final") is True:
+            return True
+        kind = self._get_event_kind(ev)
+        return kind in _FINAL_EVENT_TYPES
+
     def _extract_content_string(self, event: dict[str, Any]) -> str | None:
         """Extract textual content from a parsed event.
 
@@ -494,7 +537,9 @@ class AgentRunRenderingManager:
         if handled is not None:
             return handled
 
-        if ev.get("content"):
+        # Only accumulate content for actual content events, not status updates or agent steps
+        # Status updates (agent_step) should be rendered but not accumulated in final_text
+        if ev.get("content") and kind not in ("agent_step", "status_update"):
             final_text = self._handle_content_event(ev, final_text)
 
         return final_text, stats_usage
@@ -540,6 +585,8 @@ class AgentRunRenderingManager:
         """
         content = ev.get("content", "")
         if not content.startswith("Artifact received:"):
+            if self._is_token_event(ev):
+                return f"{final_text}{content}"
             return content
         return final_text
 

glaip_sdk/hitl/__init__.py

@@ -0,0 +1,15 @@
+"""Human-in-the-Loop (HITL) utilities for glaip-sdk.
+
+This package provides utilities for HITL approval workflows in both local
+and remote agent execution modes.
+
+For local development, LocalPromptHandler is automatically injected when
+agent_config.hitl_enabled is True. No manual setup required.
+
+Authors:
+    Putu Ravindra Wiguna (putu.r.wiguna@gdplabs.id)
+"""
+
+from glaip_sdk.hitl.local import LocalPromptHandler, PauseResumeCallback
+
+__all__ = ["LocalPromptHandler", "PauseResumeCallback"]

glaip_sdk/hitl/local.py

@@ -0,0 +1,151 @@
+"""Local HITL prompt handler with interactive console support.
+
+Author:
+    Putu Ravindra Wiguna (putu.r.wiguna@gdplabs.id)
+"""
+
+import os
+from typing import Any
+
+try:
+    from aip_agents.agent.hitl.prompt.base import BasePromptHandler
+    from aip_agents.schema.hitl import ApprovalDecision, ApprovalDecisionType, ApprovalRequest
+except ImportError as e:
+    raise ImportError("aip_agents is required for local HITL. Install with: pip install 'glaip-sdk[local]'") from e
+
+from rich.console import Console
+from rich.prompt import Prompt
+
+
+class LocalPromptHandler(BasePromptHandler):
+    """Local HITL prompt handler with interactive console prompts.
+
+    Experimental local HITL implementation with known limitations:
+    - Timeouts are not enforced (interactive prompts wait indefinitely)
+    - Relies on private renderer methods for pause/resume
+    - Only supports interactive terminal environments
+
+    The key insight from Rich documentation is that Live must be stopped before
+    using Prompt/input(), otherwise the input won't render properly.
+
+    Environment variables:
+        GLAIP_HITL_AUTO_APPROVE: Set to "true" (case-insensitive) to auto-approve
+            all requests without user interaction. Useful for integration tests and CI.
+    """
+
+    def __init__(self, *, pause_resume_callback: Any | None = None) -> None:
+        """Initialize the prompt handler.
+
+        Args:
+            pause_resume_callback: Optional callable with pause() and resume() methods
+                to control the live renderer during prompts. This is needed because
+                Rich Live interferes with Prompt/input().
+        """
+        super().__init__()
+        self._pause_resume = pause_resume_callback
+        self._console = Console()
+
+    async def prompt_for_decision(
+        self,
+        request: ApprovalRequest,
+        timeout_seconds: int,
+        context_keys: list[str] | None = None,
+    ) -> ApprovalDecision:
+        """Prompt for approval decision with live renderer pause/resume.
+
+        Supports auto-approval via GLAIP_HITL_AUTO_APPROVE environment variable
+        for integration testing and CI environments. Set to "true" (case-insensitive) to enable.
+        """
+        _ = (timeout_seconds, context_keys)  # Suppress unused parameter warnings.
+
+        # Check for auto-approve mode (for integration tests/CI)
+        auto_approve = os.getenv("GLAIP_HITL_AUTO_APPROVE", "").lower() == "true"
+
+        if auto_approve:
+            # Auto-approve without user interaction
+            return ApprovalDecision(
+                request_id=request.request_id,
+                decision=ApprovalDecisionType.APPROVED,
+                operator_input="auto-approved",
+            )
+
+        # Pause the live renderer if callback is available
+        if self._pause_resume:
+            self._pause_resume.pause()
+
+        try:
+            # POC/MVP: Show what we're approving (still auto-approve for now)
+            self._print_request_info(request)
+
+            # POC/MVP: For testing, we can do actual input here
+            # Uncomment to enable real prompting:
+            response = Prompt.ask(
+                "\n[yellow]Approve this tool call?[/yellow] [dim](y/n/s)[/dim]",
+                console=self._console,
+                default="y",
+            )
+            response = response.lower().strip()
+
+            if response in ("y", "yes"):
+                decision = ApprovalDecisionType.APPROVED
+            elif response in ("n", "no"):
+                decision = ApprovalDecisionType.REJECTED
+            else:
+                decision = ApprovalDecisionType.SKIPPED
+
+            return ApprovalDecision(
+                request_id=request.request_id,
+                decision=decision,
+                operator_input=response if decision != ApprovalDecisionType.SKIPPED else None,
+            )
+        finally:
+            # Always resume the live renderer
+            if self._pause_resume:
+                self._pause_resume.resume()
+
+    def _print_request_info(self, request: ApprovalRequest) -> None:
+        """Print the approval request information."""
+        self._console.print()
+        self._console.rule("[yellow]HITL Approval Request[/yellow]", style="yellow")
+
+        tool_name = request.tool_name or "unknown"
+        self._console.print(f"[cyan]Tool:[/cyan] {tool_name}")
+
+        if hasattr(request, "arguments_preview") and request.arguments_preview:
+            self._console.print(f"[cyan]Arguments:[/cyan] {request.arguments_preview}")
+
+        if request.context:
+            self._console.print(f"[dim]Context: {request.context}[/dim]")
+
+
+class PauseResumeCallback:
+    """Simple callback object for pausing/resuming the live renderer.
+
+    This allows the LocalPromptHandler to control the renderer without
+    directly coupling to the renderer implementation.
+    """
+
+    def __init__(self) -> None:
+        """Initialize the callback."""
+        self._renderer: Any | None = None
+
+    def set_renderer(self, renderer: Any) -> None:
+        """Set the renderer instance.
+
+        Args:
+            renderer: RichStreamRenderer instance with pause_live() and resume_live() methods.
+        """
+        self._renderer = renderer
+
+    def pause(self) -> None:
+        """Pause the live renderer before prompting."""
+        if self._renderer and hasattr(self._renderer, "_shutdown_live"):
+            self._renderer._shutdown_live()
+
+    def resume(self) -> None:
+        """Resume the live renderer after prompting."""
+        if self._renderer and hasattr(self._renderer, "_ensure_live"):
+            self._renderer._ensure_live()
+
+
+__all__ = ["LocalPromptHandler", "PauseResumeCallback"]

glaip_sdk/runner/langgraph.py

@@ -19,18 +19,21 @@ from __future__ import annotations
 
 import asyncio
 import inspect
-from dataclasses import dataclass
 import logging
+from dataclasses import dataclass
 from typing import TYPE_CHECKING, Any
 
+from aip_agents.agent.hitl.manager import ApprovalManager  # noqa: PLC0415
 from gllm_core.utils import LoggerManager
 
+from glaip_sdk.client.run_rendering import AgentRunRenderingManager
+from glaip_sdk.hitl import LocalPromptHandler, PauseResumeCallback
 from glaip_sdk.runner.base import BaseRunner
 from glaip_sdk.runner.deps import (
     check_local_runtime_available,
     get_local_runtime_missing_message,
 )
-from glaip_sdk.client.run_rendering import AgentRunRenderingManager
+from glaip_sdk.utils.tool_storage_provider import build_tool_output_manager
 
 if TYPE_CHECKING:
     from langchain_core.messages import BaseMessage
@@ -251,8 +254,13 @@ class LangGraphRunner(BaseRunner):
         if swallow_aip_logs:
             _swallow_aip_logs()
 
+        # POC/MVP: Create pause/resume callback for interactive HITL input
+        pause_resume_callback = PauseResumeCallback()
+
         # Build the local LangGraphReactAgent from the glaip_sdk Agent
-        local_agent = self.build_langgraph_agent(agent, runtime_config=runtime_config)
+        local_agent = self.build_langgraph_agent(
+            agent, runtime_config=runtime_config, pause_resume_callback=pause_resume_callback
+        )
 
         # Convert chat history to LangChain messages for the agent
         langchain_messages = _convert_chat_history_to_messages(chat_history)
@@ -267,6 +275,10 @@ class LangGraphRunner(BaseRunner):
         # Use shared render manager for unified processing
         render_manager = AgentRunRenderingManager(logger)
         renderer = render_manager.create_renderer(kwargs.get("renderer"), verbose=verbose)
+
+        # POC/MVP: Set renderer on callback so LocalPromptHandler can pause/resume Live
+        pause_resume_callback.set_renderer(renderer)
+
         meta = render_manager.build_initial_metadata(agent.name, message, kwargs)
         render_manager.start_renderer(renderer, meta)
 
@@ -305,6 +317,9 @@ class LangGraphRunner(BaseRunner):
         self,
         agent: Agent,
         runtime_config: dict[str, Any] | None = None,
+        shared_tool_output_manager: Any | None = None,
+        *,
+        pause_resume_callback: Any | None = None,
     ) -> Any:
         """Build a LangGraphReactAgent from a glaip_sdk Agent definition.
 
@@ -312,6 +327,10 @@ class LangGraphRunner(BaseRunner):
             agent: The glaip_sdk Agent to convert.
             runtime_config: Optional runtime configuration with tool_configs,
                 mcp_configs, agent_config, and agent-specific overrides.
+            shared_tool_output_manager: Optional ToolOutputManager to reuse across
+                agents with tool_output_sharing enabled.
+            pause_resume_callback: Optional callback used to pause/resume the renderer
+                during interactive HITL prompts.
 
         Returns:
             A configured LangGraphReactAgent instance.
@@ -333,9 +352,6 @@ class LangGraphRunner(BaseRunner):
             adapter = LangChainToolAdapter()
             langchain_tools = adapter.adapt_tools(agent.tools)
 
-        # Build sub-agents recursively
-        sub_agent_instances = self._build_sub_agents(agent.agents, runtime_config)
-
         # Normalize runtime config: merge global and agent-specific configs
         normalized_config = self._normalize_runtime_config(runtime_config, agent)
 
@@ -349,6 +365,19 @@ class LangGraphRunner(BaseRunner):
         merged_agent_config = self._merge_agent_config(agent, normalized_config)
         agent_config_params, agent_config_kwargs = self._apply_agent_config(merged_agent_config)
 
+        tool_output_manager = self._resolve_tool_output_manager(
+            agent,
+            merged_agent_config,
+            shared_tool_output_manager,
+        )
+
+        # Build sub-agents recursively, sharing tool output manager when enabled.
+        sub_agent_instances = self._build_sub_agents(
+            agent.agents,
+            runtime_config,
+            shared_tool_output_manager=tool_output_manager,
+        )
+
         # Build the LangGraphReactAgent with tools, sub-agents, and configs
         local_agent = LangGraphReactAgent(
             name=agent.name,
@@ -358,6 +387,7 @@ class LangGraphRunner(BaseRunner):
             tools=langchain_tools,
             agents=sub_agent_instances if sub_agent_instances else None,
             tool_configs=tool_configs if tool_configs else None,
+            tool_output_manager=tool_output_manager,
             **agent_config_params,
             **agent_config_kwargs,
         )
@@ -365,6 +395,11 @@ class LangGraphRunner(BaseRunner):
         # Add MCP servers if configured
         self._add_mcp_servers(local_agent, agent, mcp_configs)
 
+        # Inject local HITL manager only if hitl_enabled is True (master switch).
+        # This matches remote behavior: hitl_enabled gates the HITL plumbing.
+        # Tool-level HITL configs are only enforced when hitl_enabled=True.
+        self._inject_hitl_manager(local_agent, merged_agent_config, agent.name, pause_resume_callback)
+
         logger.debug(
             "Built local LangGraphReactAgent for agent '%s' with %d tools, %d sub-agents, and %d MCPs",
             agent.name,
@@ -374,16 +409,60 @@ class LangGraphRunner(BaseRunner):
         )
         return local_agent
 
+    def _resolve_tool_output_manager(
+        self,
+        agent: Agent,
+        merged_agent_config: dict[str, Any],
+        shared_tool_output_manager: Any | None,
+    ) -> Any | None:
+        """Resolve tool output manager for local agent execution."""
+        tool_output_sharing_enabled = merged_agent_config.get("tool_output_sharing", False)
+        if not tool_output_sharing_enabled:
+            return None
+        if shared_tool_output_manager is not None:
+            return shared_tool_output_manager
+        return build_tool_output_manager(agent.name, merged_agent_config)
+
+    def _inject_hitl_manager(
+        self,
+        local_agent: Any,
+        merged_agent_config: dict[str, Any],
+        agent_name: str,
+        pause_resume_callback: Any | None,
+    ) -> None:
+        """Inject HITL manager when enabled, mirroring remote gating behavior."""
+        hitl_enabled = merged_agent_config.get("hitl_enabled", False)
+        if hitl_enabled:
+            try:
+                local_agent.hitl_manager = ApprovalManager(
+                    prompt_handler=LocalPromptHandler(pause_resume_callback=pause_resume_callback)
+                )
+                # Store callback reference for setting renderer later
+                if pause_resume_callback:
+                    local_agent._pause_resume_callback = pause_resume_callback
+                logger.debug("HITL manager injected for agent '%s' (hitl_enabled=True)", agent_name)
+            except ImportError as e:
+                # Missing dependencies - fail fast
+                raise ImportError("Local HITL requires aip_agents. Install with: pip install 'glaip-sdk[local]'") from e
+            except Exception as e:
+                # Other errors during HITL setup - fail fast
+                raise RuntimeError(f"Failed to initialize HITL manager for agent '{agent_name}'") from e
+        else:
+            logger.debug("HITL manager not injected for agent '%s' (hitl_enabled=False)", agent_name)
+
     def _build_sub_agents(
         self,
         sub_agents: list[Any] | None,
         runtime_config: dict[str, Any] | None,
+        shared_tool_output_manager: Any | None = None,
     ) -> list[Any]:
         """Build sub-agent instances recursively.
 
         Args:
             sub_agents: List of sub-agent definitions.
             runtime_config: Runtime config to pass to sub-agents.
+            shared_tool_output_manager: Optional ToolOutputManager to reuse across
+                agents with tool_output_sharing enabled.
 
         Returns:
             List of built sub-agent instances.
@@ -397,7 +476,13 @@ class LangGraphRunner(BaseRunner):
         sub_agent_instances = []
         for sub_agent in sub_agents:
             self._validate_sub_agent_for_local_mode(sub_agent)
-            sub_agent_instances.append(self.build_langgraph_agent(sub_agent, runtime_config))
+            sub_agent_instances.append(
+                self.build_langgraph_agent(
+                    sub_agent,
+                    runtime_config,
+                    shared_tool_output_manager=shared_tool_output_manager,
+                )
+            )
         return sub_agent_instances
 
     def _add_mcp_servers(
@@ -644,6 +729,9 @@ class LangGraphRunner(BaseRunner):
         if "planning" in agent_config:
             direct_params["planning"] = agent_config["planning"]
 
+        if "enable_a2a_token_streaming" in agent_config:
+            direct_params["enable_a2a_token_streaming"] = agent_config["enable_a2a_token_streaming"]
+
         # Kwargs parameters (passed through **kwargs to BaseAgent)
         if "enable_pii" in agent_config:
             kwargs_params["enable_pii"] = agent_config["enable_pii"]

glaip_sdk/utils/rendering/renderer/base.py

@@ -8,6 +8,7 @@ from __future__ import annotations
 
 import json
 import logging
+import sys
 from datetime import datetime, timezone
 from time import monotonic
 from typing import Any
@@ -349,6 +350,9 @@ class RichStreamRenderer(TranscriptModeMixin):
             self._handle_status_event(ev)
         elif kind == "content":
             self._handle_content_event(content)
+        elif kind == "token":
+            # Token events should stream content incrementally with immediate console output
+            self._handle_token_event(content)
         elif kind == "final_response":
             self._handle_final_response_event(content, metadata)
         elif kind in {"agent_step", "agent_thinking_step"}:
@@ -368,6 +372,31 @@ class RichStreamRenderer(TranscriptModeMixin):
             self.state.append_transcript_text(content)
             self._ensure_live()
 
+    def _handle_token_event(self, content: str) -> None:
+        """Handle token streaming events - print immediately for real-time streaming."""
+        if content:
+            self.state.append_transcript_text(content)
+            # Print token content directly to stdout for immediate visibility when not verbose
+            # This bypasses Rich's Live display which has refresh rate limitations
+            if not self.verbose:
+                try:
+                    # Mark that we're streaming tokens directly to prevent Live display from starting
+                    self._streaming_tokens_directly = True
+                    # Stop Live display if active to prevent it from intercepting stdout
+                    # and causing each token to appear on a new line
+                    if self.live is not None:
+                        self._stop_live_display()
+                    # Write directly to stdout - tokens will stream on the same line
+                    # since we're bypassing Rich's console which adds newlines
+                    sys.stdout.write(content)
+                    sys.stdout.flush()
+                except Exception:
+                    # Fallback to live display if direct write fails
+                    self._ensure_live()
+            else:
+                # In verbose mode, use normal live display (debug panels handle the output)
+                self._ensure_live()
+
     def _handle_final_response_event(self, content: str, metadata: dict[str, Any]) -> None:
         """Handle final response events."""
         if content:
@@ -521,6 +550,18 @@ class RichStreamRenderer(TranscriptModeMixin):
         if getattr(self, "_transcript_mode_enabled", False):
             return
 
+        # When verbose=False and tokens were streamed directly, skip final panel
+        # The user's script will print the final result, avoiding duplication
+        if not self.verbose and getattr(self, "_streaming_tokens_directly", False):
+            # Add a newline after streaming tokens for clean separation
+            try:
+                sys.stdout.write("\n")
+                sys.stdout.flush()
+            except Exception:
+                pass
+            self.state.printed_final_output = True
+            return
+
         if self.verbose:
             panel = build_final_panel(
                 self.state,
@@ -597,6 +638,19 @@ class RichStreamRenderer(TranscriptModeMixin):
 
     def _finalize_display(self) -> None:
         """Finalize live display and render final output."""
+        # When verbose=False and tokens were streamed directly, skip live display updates
+        # to avoid showing duplicate final result
+        if not self.verbose and getattr(self, "_streaming_tokens_directly", False):
+            # Just add a newline after streaming tokens for clean separation
+            try:
+                sys.stdout.write("\n")
+                sys.stdout.flush()
+            except Exception:
+                pass
+            self._stop_live_display()
+            self.state.printed_final_output = True
+            return
+
         # Final refresh
         self._ensure_live()
 
@@ -629,6 +683,10 @@ class RichStreamRenderer(TranscriptModeMixin):
         """Ensure live display is updated."""
         if getattr(self, "_transcript_mode_enabled", False):
             return
+        # When verbose=False, don't start Live display if we're streaming tokens directly
+        # This prevents Live from intercepting stdout and causing tokens to appear on separate lines
+        if not self.verbose and getattr(self, "_streaming_tokens_directly", False):
+            return
         if not self._ensure_live_stack():
             return
 

glaip_sdk/utils/tool_storage_provider.py

@@ -0,0 +1,140 @@
+"""Helpers for local tool output storage setup.
+
+This module bridges agent_config.tool_output_sharing to ToolOutputManager
+for local execution without modifying aip-agents.
+
+Authors:
+    Fachriza Adhiatma (fachriza.d.adhiatma@gdplabs.id)
+"""
+
+from __future__ import annotations
+
+import os
+from typing import Any
+
+from gllm_core.utils import LoggerManager
+
+logger = LoggerManager().get_logger(__name__)
+
+
+def build_tool_output_manager(agent_name: str, agent_config: dict[str, Any]) -> Any | None:
+    """Build a ToolOutputManager for local tool output sharing.
+
+    Args:
+        agent_name: Name of the agent whose tool outputs will be stored.
+        agent_config: Agent configuration that may enable tool output sharing and contain task_id.
+
+    Returns:
+        A ToolOutputManager instance when tool output sharing is enabled and
+        dependencies are available, otherwise ``None``.
+    """
+    tool_output_sharing_enabled = agent_config.get("tool_output_sharing", False)
+    if not tool_output_sharing_enabled:
+        return None
+
+    try:
+        from aip_agents.storage.clients.minio_client import MinioConfig, MinioObjectStorage  # noqa: PLC0415
+        from aip_agents.storage.providers.memory import InMemoryStorageProvider  # noqa: PLC0415
+        from aip_agents.storage.providers.object_storage import ObjectStorageProvider  # noqa: PLC0415
+        from aip_agents.utils.langgraph.tool_output_management import (  # noqa: PLC0415
+            ToolOutputConfig,
+            ToolOutputManager,
+        )
+    except ImportError:
+        logger.warning("Tool output sharing requested but aip-agents is unavailable; skipping.")
+        return None
+
+    task_id = agent_config.get("task_id")
+
+    storage_provider = _build_tool_output_storage_provider(
+        agent_name=agent_name,
+        task_id=task_id,
+        minio_config_cls=MinioConfig,
+        minio_client_cls=MinioObjectStorage,
+        object_storage_provider_cls=ObjectStorageProvider,
+        memory_storage_provider_cls=InMemoryStorageProvider,
+    )
+    tool_output_config = _build_tool_output_config(storage_provider, ToolOutputConfig)
+    return ToolOutputManager(tool_output_config)
+
+
+def _build_tool_output_storage_provider(
+    agent_name: str,
+    task_id: str | None,
+    minio_config_cls: Any,
+    minio_client_cls: Any,
+    object_storage_provider_cls: Any,
+    memory_storage_provider_cls: Any,
+) -> Any:
+    """Create a storage provider for tool output sharing.
+
+    Args:
+        agent_name: Name of the agent whose tool outputs are stored.
+        task_id: Optional task identifier for coordination context.
+        minio_config_cls: Class exposing a ``from_env`` constructor for MinIO config.
+        minio_client_cls: MinIO client class used to talk to the object store.
+        object_storage_provider_cls: Storage provider wrapping the MinIO client.
+        memory_storage_provider_cls: In-memory provider used as a fallback.
+
+    Returns:
+        An instance of ``object_storage_provider_cls`` when MinIO initialization
+        succeeds, otherwise an instance of ``memory_storage_provider_cls``.
+    """
+    try:
+        config_obj = minio_config_cls.from_env()
+        minio_client = minio_client_cls(config=config_obj)
+        prefix = _build_tool_output_prefix(agent_name, task_id)
+        return object_storage_provider_cls(client=minio_client, prefix=prefix, use_json=False)
+    except Exception as exc:
+        logger.warning("Failed to initialize MinIO for tool outputs: %s. Using in-memory storage.", exc)
+        return memory_storage_provider_cls()
+
+
+def _build_tool_output_prefix(agent_name: str, task_id: str | None) -> str:
+    """Build object storage prefix for tool outputs in local mode.
+
+    Args:
+        agent_name: Name of the agent whose outputs are stored.
+        task_id: Optional task identifier for coordination context.
+
+    Returns:
+        Object storage key prefix dedicated to the provided agent.
+    """
+    if task_id:
+        return f"tool-outputs/tasks/{task_id}/agents/{agent_name}/"
+    return f"tool-outputs/agents/{agent_name}/"
+
+
+def _build_tool_output_config(storage_provider: Any, config_cls: Any) -> Any:
+    """Build ToolOutputConfig using env vars, with safe defaults.
+
+    Args:
+        storage_provider: Provider that will persist tool outputs.
+        config_cls: Tool output configuration class to instantiate.
+
+    Returns:
+        A configured ``config_cls`` instance ready for ToolOutputManager use.
+    """
+
+    def safe_int_conversion(env_var: str, default: str) -> int:
+        """Convert an environment variable to int with a fallback default.
+
+        Args:
+            env_var: Environment variable name to read.
+            default: Default string value used when parsing fails.
+
+        Returns:
+            Integer representation of the environment variable or the default.
+        """
+        try:
+            return int(os.getenv(env_var, default))
+        except (ValueError, TypeError):
+            logger.warning("Invalid value for %s, using default: %s", env_var, default)
+            return int(default)
+
+    return config_cls(
+        max_stored_outputs=safe_int_conversion("TOOL_OUTPUT_MAX_STORED", "200"),
+        max_age_minutes=safe_int_conversion("TOOL_OUTPUT_MAX_AGE_MINUTES", str(24 * 60)),
+        cleanup_interval=safe_int_conversion("TOOL_OUTPUT_CLEANUP_INTERVAL", "50"),
+        storage_provider=storage_provider,
+    )

{glaip_sdk-0.6.16.dist-info → glaip_sdk-0.6.18.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: glaip-sdk
-Version: 0.6.16
+Version: 0.6.18
 Summary: Python SDK for GL AIP (GDP Labs AI Agent Package) - Simplified CLI Design
 Author-email: Raymond Christopher <raymond.christopher@gdplabs.id>
 License: MIT
@@ -19,11 +19,11 @@ Requires-Dist: textual>=0.52.0
 Requires-Dist: gllm-core-binary>=0.1.0
 Requires-Dist: langchain-core>=0.3.0
 Requires-Dist: gllm-tools-binary>=0.1.3
-Requires-Dist: aip-agents-binary[local]>=0.5.11
+Requires-Dist: aip-agents-binary[local]>=0.5.13
 Provides-Extra: memory
-Requires-Dist: aip-agents-binary[memory]>=0.5.11; (python_version >= "3.11" and python_version < "3.13") and extra == "memory"
+Requires-Dist: aip-agents-binary[memory]>=0.5.13; (python_version >= "3.11" and python_version < "3.13") and extra == "memory"
 Provides-Extra: privacy
-Requires-Dist: aip-agents-binary[privacy]>=0.5.11; (python_version >= "3.11" and python_version < "3.13") and extra == "privacy"
+Requires-Dist: aip-agents-binary[privacy]>=0.5.13; (python_version >= "3.11" and python_version < "3.13") and extra == "privacy"
 Requires-Dist: en-core-web-sm; extra == "privacy"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
@@ -37,7 +37,7 @@ Requires-Dist: ruff>=0.14.0; extra == "dev"
 
 # GL AIP — GDP Labs AI Agents Package
 
-[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![Python 3.11-3.12](https://img.shields.io/badge/python-3.11--3.12-blue.svg)](https://www.python.org/downloads/)
 [![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
 
 GL stands for **GDP Labs**—GL AIP is our AI Agents Package for building, running, and operating agents.
@@ -56,7 +56,7 @@ pip install --upgrade glaip-sdk
 uv tool install glaip-sdk
 ```
 
-**Requirements**: Python 3.10+
+**Requirements**: Python 3.11 or 3.12
 
 ## 🐍 Hello World - Python SDK
 

{glaip_sdk-0.6.16.dist-info → glaip_sdk-0.6.18.dist-info}/RECORD

@@ -69,11 +69,13 @@ glaip_sdk/client/agents.py,sha256=75uDLN85Smf67rw-jFhlVKyiToicAfcFyJHSvWJkAww,47
 glaip_sdk/client/base.py,sha256=BhNaC2TJJ2jVWRTYmfxD3WjYgAyIuWNz9YURdNXXjJo,18245
 glaip_sdk/client/main.py,sha256=RTREAOgGouYm4lFKkpNBQ9dmxalnBsIpSSaQLWVFSmU,9054
 glaip_sdk/client/mcps.py,sha256=gFRuLOGeh6ieIhR4PeD6yNVT6NhvUMTqPq9iuu1vkAY,13019
-glaip_sdk/client/run_rendering.py,sha256=j0BTDfy13lFX-B4T-Own-NtmqefoRGQ4M5DM6QRkiTs,24109
+glaip_sdk/client/run_rendering.py,sha256=kERp78v50jojsNWHrjNEkbC8sgOpMacaqUdw5YZuK6A,26074
 glaip_sdk/client/shared.py,sha256=esHlsR0LEfL-pFDaWebQjKKOLl09jsRY-2pllBUn4nU,522
 glaip_sdk/client/tools.py,sha256=kK0rBwX1e_5AlGQRjlO6rNz6gDlohhXWdlxN9AwotdE,22585
 glaip_sdk/client/validators.py,sha256=ioF9VCs-LG2yLkaRDd7Hff74lojDZZ0_Q3CiLbdm1RY,8381
 glaip_sdk/config/constants.py,sha256=Y03c6op0e7K0jTQ8bmWXhWAqsnjWxkAhWniq8Z0iEKY,1081
+glaip_sdk/hitl/__init__.py,sha256=sg92Rpu8_vJIGi1ZEhx0-qWa1nGdvfrKyJAxtoDSKzo,494
+glaip_sdk/hitl/local.py,sha256=rzmaRK15BxgRX7cmklUcGQUotMYg8x2Gd9BWf39k6hw,5661
 glaip_sdk/mcps/__init__.py,sha256=4jYrt8K__oxrxexHRcmnRBXt-W_tbJN61H9Kf2lVh4Q,551
 glaip_sdk/mcps/base.py,sha256=jWwHjDF67_mtDGRp9p5SolANjVeB8jt1PSwPBtX876M,11654
 glaip_sdk/models/__init__.py,sha256=-qO4Yr1-fkyaYC9RcT3nYhplDjoXATrIFZr4JrqflHI,2577
@@ -92,7 +94,7 @@ glaip_sdk/registry/tool.py,sha256=rxrVxnO_VwO6E5kccqxxEUC337J9qbKpje-Gwl5a3sY,76
 glaip_sdk/runner/__init__.py,sha256=8RrngoGfpF8x9X27RPdX4gJjch75ZvhtVt_6UV0ULLQ,1615
 glaip_sdk/runner/base.py,sha256=KIjcSAyDCP9_mn2H4rXR5gu1FZlwD9pe0gkTBmr6Yi4,2663
 glaip_sdk/runner/deps.py,sha256=Du3hr2R5RHOYCRAv7RVmx661x-ayVXIeZ8JD7ODirTA,3884
-glaip_sdk/runner/langgraph.py,sha256=97fCY4BwBj-APID3e4qQUUwXLEDbrxTyTqHhN2Z7RcA,28811
+glaip_sdk/runner/langgraph.py,sha256=-3BMJRww3S3dboS3uyR3QrxV-3p-1i2X5ObxdTTGRdg,32955
 glaip_sdk/runner/mcp_adapter/__init__.py,sha256=Rdttfg3N6kg3-DaTCKqaGXKByZyBt0Mwf6FV8s_5kI8,462
 glaip_sdk/runner/mcp_adapter/base_mcp_adapter.py,sha256=ic56fKgb3zgVZZQm3ClWUZi7pE1t4EVq8mOg6AM6hdA,1374
 glaip_sdk/runner/mcp_adapter/langchain_mcp_adapter.py,sha256=b58GuadPz7q7aXoJyTYs0eeJ_oqp-wLR1tcr_5cbV1s,9723
@@ -121,6 +123,7 @@ glaip_sdk/utils/runtime_config.py,sha256=Gl9-CQ4lYZ39vRSgtdfcSU3CXshVDDuTOdSzjvs
 glaip_sdk/utils/serialization.py,sha256=z-qpvWLSBrGK3wbUclcA1UIKLXJedTnMSwPdq-FF4lo,13308
 glaip_sdk/utils/sync.py,sha256=3VKqs1UfNGWSobgRXohBKP7mMMzdUW3SU0bJQ1uxOgw,4872
 glaip_sdk/utils/tool_detection.py,sha256=g410GNug_PhLye8rd9UU-LVFIKq3jHPbmSItEkLxPTc,807
+glaip_sdk/utils/tool_storage_provider.py,sha256=lampwUeWu4Uy8nBG7C4ZT-M6AHoWZS0m67HdLx21VDg,5396
 glaip_sdk/utils/validation.py,sha256=hB_k3lvHdIFUiSwHStrC0Eqnhx0OG2UvwqASeem0HuQ,6859
 glaip_sdk/utils/a2a/__init__.py,sha256=_X8AvDOsHeppo5n7rP5TeisVxlAdkZDTFReBk_9lmxo,876
 glaip_sdk/utils/a2a/event_processor.py,sha256=9Mjvvd4_4VDYeOkAI7_vF7N7_Dn0Kn23ramKyK32b3c,5993
@@ -136,7 +139,7 @@ glaip_sdk/utils/rendering/layout/progress.py,sha256=GhOhUPNQd8-e6JxTJsV76s6wIYht
 glaip_sdk/utils/rendering/layout/summary.py,sha256=K-gkDxwUxF67-4nF20y6hv95QEwRZCQI9Eb4KbA8eQY,2325
 glaip_sdk/utils/rendering/layout/transcript.py,sha256=vbfywtbWCDzLY9B5Vvf4crhomftFq-UEz7zqySiLrD8,19052
 glaip_sdk/utils/rendering/renderer/__init__.py,sha256=lpf0GnNGcPb8gq_hJM6Puflwy3eTigVK9qXP01nWRv0,1754
-glaip_sdk/utils/rendering/renderer/base.py,sha256=YwUz0gS4C55BWEDmwD-gp35Tp_QCryxhld2gV--y8lE,38968
+glaip_sdk/utils/rendering/renderer/base.py,sha256=CpkkwiTmJHi8j2EGBva7WBpVWNte0VoDGgF6UbiJ9J8,41929
 glaip_sdk/utils/rendering/renderer/config.py,sha256=FgSAZpG1g7Atm2MXg0tY0lOEciY90MR-RO6YuGFhp0E,626
 glaip_sdk/utils/rendering/renderer/console.py,sha256=4cLOw4Q1fkHkApuj6dWW8eYpeYdcT0t2SO5MbVt5UTc,1844
 glaip_sdk/utils/rendering/renderer/debug.py,sha256=qyqFXltYzKEqajwlu8QFSBU3P46JzMzIZqurejhx14o,5907
@@ -153,8 +156,8 @@ glaip_sdk/utils/rendering/steps/format.py,sha256=Chnq7OBaj8XMeBntSBxrX5zSmrYeGcO
 glaip_sdk/utils/rendering/steps/manager.py,sha256=BiBmTeQMQhjRMykgICXsXNYh1hGsss-fH9BIGVMWFi0,13194
 glaip_sdk/utils/rendering/viewer/__init__.py,sha256=XrxmE2cMAozqrzo1jtDFm8HqNtvDcYi2mAhXLXn5CjI,457
 glaip_sdk/utils/rendering/viewer/presenter.py,sha256=mlLMTjnyeyPVtsyrAbz1BJu9lFGQSlS-voZ-_Cuugv0,5725
-glaip_sdk-0.6.16.dist-info/METADATA,sha256=ptV29g1-dD8OdhVyX787rSWHuAk2JnfMTZ-wsPEsupU,7700
-glaip_sdk-0.6.16.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-glaip_sdk-0.6.16.dist-info/entry_points.txt,sha256=65vNPUggyYnVGhuw7RhNJ8Fp2jygTcX0yxJBcBY3iLU,48
-glaip_sdk-0.6.16.dist-info/top_level.txt,sha256=td7yXttiYX2s94-4wFhv-5KdT0rSZ-pnJRSire341hw,10
-glaip_sdk-0.6.16.dist-info/RECORD,,
+glaip_sdk-0.6.18.dist-info/METADATA,sha256=cPfNrNuml65FqIP1ZhrAp2AEiiipu3OADHcT345uI6g,7716
+glaip_sdk-0.6.18.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+glaip_sdk-0.6.18.dist-info/entry_points.txt,sha256=65vNPUggyYnVGhuw7RhNJ8Fp2jygTcX0yxJBcBY3iLU,48
+glaip_sdk-0.6.18.dist-info/top_level.txt,sha256=td7yXttiYX2s94-4wFhv-5KdT0rSZ-pnJRSire341hw,10
+glaip_sdk-0.6.18.dist-info/RECORD,,