youngjin-langchain-tools 0.1.3__py3-none-any.whl → 0.2.0__py3-none-any.whl

youngjin_langchain_tools/handlers/streamlit_langgraph_handler.py

@@ -124,13 +124,22 @@ def _parse_error(error: Exception) -> Dict[str, Any]:
 
 @dataclass
 class StreamlitLanggraphHandlerConfig:
-    """Configuration for StreamlitLanggraphHandler."""
+    """Configuration for StreamlitLanggraphHandler.
+
+    Attributes:
+        expand_new_thoughts: 도구 결과 expander를 펼친 상태로 표시할지 여부.
+        collapse_completed_thoughts: 완료 시 status container를 접을지 여부.
+        max_thought_containers: 표시할 최대 사고 과정 수 (초과 시 History로 이동).
+        max_tool_content_length: 도구 결과 최대 표시 문자 수.
+        show_tool_calls: 도구 호출 정보 표시 여부.
+        show_tool_results: 도구 실행 결과 표시 여부.
+    """
 
     expand_new_thoughts: bool = True
-    """Whether to expand the status container to show tool calls."""
+    """Whether to show tool result expanders in expanded state."""
 
     collapse_completed_thoughts: bool = True
-    """Whether to automatically collapse completed thought containers."""
+    """Whether to collapse the status container when agent completes."""
 
     max_thought_containers: int = 4
     """Maximum number of thought containers to show at once.
@@ -257,9 +266,9 @@ class StreamlitLanggraphHandler:
         self._final_response: str = ""
         self._status_container: Any = None
         self._response_placeholder: Any = None
-        self._history_placeholder: Any = None  # Placeholder for history expander
         self._thought_history: List[Dict[str, Any]] = []  # History of old thoughts
         self._current_thoughts: List[Dict[str, Any]] = []  # Current visible thoughts
+        self._thought_counter: int = 0  # Unique ID counter for thoughts
 
     @property
     def config(self) -> StreamlitLanggraphHandlerConfig:
@@ -353,24 +362,23 @@ class StreamlitLanggraphHandler:
         self._final_response = ""
         self._thought_history = []
         self._current_thoughts = []
+        self._thought_counter = 0
 
         # Create UI components
         with self._container:
-            # History expander placeholder (will be shown when needed)
-            self._history_placeholder = st.empty()
             self._status_container = st.status(
                 self._config.thinking_label,
-                expanded=self._config.expand_new_thoughts
+                expanded=True  # Always start expanded during processing
             )
             self._response_placeholder = st.empty()
 
         # Stream from agent with error handling
-        config = config or {}
+        agent_config = config or {}
 
         try:
             for stream_mode, data in agent.stream(
                 input,
-                config=config,
+                config=agent_config,
                 stream_mode=["messages", "updates"]
             ):
                 if stream_mode == "updates":
@@ -378,11 +386,11 @@ class StreamlitLanggraphHandler:
                 elif stream_mode == "messages":
                     yield from self._handle_messages(data)
 
-            # Mark as complete
+            # Mark as complete - collapse based on config
             self._status_container.update(
                 label=self._config.complete_label,
                 state="complete",
-                expanded=False
+                expanded=not self._config.collapse_completed_thoughts
             )
 
         except Exception as e:
@@ -430,58 +438,90 @@ class StreamlitLanggraphHandler:
 
     def _add_thought(self, thought_type: str, data: Dict[str, Any]) -> None:
         """Add a thought and manage history if max_thought_containers exceeded."""
-        import streamlit as st
-
-        thought = {"type": thought_type, "data": data}
+        self._thought_counter += 1
+        thought = {
+            "id": self._thought_counter,
+            "type": thought_type,
+            "data": data
+        }
         self._current_thoughts.append(thought)
 
         # Check if we need to move old thoughts to history
         max_containers = self._config.max_thought_containers
-        if len(self._current_thoughts) > max_containers:
-            # Move oldest thoughts to history
-            while len(self._current_thoughts) > max_containers:
-                old_thought = self._current_thoughts.pop(0)
-                self._thought_history.append(old_thought)
+        while len(self._current_thoughts) > max_containers:
+            old_thought = self._current_thoughts.pop(0)
+            self._thought_history.append(old_thought)
+
+    def _render_thought_item(
+        self,
+        thought: Dict[str, Any],
+        st_module: Any,
+        in_history: bool = False
+    ) -> None:
+        """Render a single thought item.
+
+        Args:
+            thought: The thought dict with id, type, data.
+            st_module: The streamlit module reference.
+            in_history: Whether this thought is in history section.
+        """
+        thought_type = thought["type"]
+        thought_data = thought["data"]
+
+        if thought_type == "tool_call":
+            # Tool call display: 🔧 tool_name: {args}
+            st_module.markdown(
+                f"{self._config.tool_call_emoji} "
+                f"**{thought_data['name']}**: `{thought_data['args']}`"
+            )
+
+        elif thought_type == "tool_result":
+            # Tool result display: ✅ tool_name 완료 + expander
+            tool_name = thought_data['name']
+            content = thought_data['content']
 
-            # Update history expander
-            self._update_history_expander()
+            st_module.markdown(
+                f"{self._config.tool_complete_emoji} "
+                f"**{tool_name}** 완료"
+            )
 
-    def _update_history_expander(self) -> None:
-        """Update the history expander with old thoughts."""
+            # Determine max length and expand state
+            if in_history:
+                max_len = 200
+                should_expand = False  # History items always collapsed
+            else:
+                max_len = self._config.max_tool_content_length
+                should_expand = self._config.expand_new_thoughts
+
+            with st_module.expander(f"📋 {tool_name} 결과 보기", expanded=should_expand):
+                if len(content) > max_len:
+                    st_module.code(content[:max_len] + "\n... (truncated)", language="text")
+                else:
+                    st_module.code(content, language="text")
+
+    def _render_thoughts_in_status(self) -> None:
+        """Render all thoughts (history + current) inside the status container."""
         import streamlit as st
 
-        if not self._thought_history:
-            return
+        with self._status_container:
+            # Render history expander if there are old thoughts
+            if self._thought_history:
+                with st.expander(
+                    f"📜 History ({len(self._thought_history)} items)",
+                    expanded=False
+                ):
+                    for thought in self._thought_history:
+                        self._render_thought_item(thought, st, in_history=True)
 
-        with self._history_placeholder.container():
-            with st.expander(f"📜 History ({len(self._thought_history)} items)", expanded=False):
-                for thought in self._thought_history:
-                    if thought["type"] == "tool_call":
-                        st.markdown(
-                            f"{self._config.tool_call_emoji} "
-                            f"**{thought['data']['name']}**: `{thought['data']['args']}`"
-                        )
-                    elif thought["type"] == "tool_result":
-                        st.markdown(
-                            f"{self._config.tool_complete_emoji} "
-                            f"**{thought['data']['name']}** 완료"
-                        )
-                        content = thought['data']['content']
-                        if len(content) > 200:  # Shorter preview in history
-                            st.code(content[:200] + "\n... (truncated)", language="text")
-                        else:
-                            st.code(content, language="text")
+            # Render current thoughts
+            for thought in self._current_thoughts:
+                self._render_thought_item(thought, st, in_history=False)
 
     def _handle_updates(
         self,
         data: Dict[str, Any]
     ) -> Generator[Dict[str, Any], None, None]:
         """Handle 'updates' stream mode events."""
-        try:
-            import streamlit as st
-        except ImportError:
-            return
-
         for source, update in data.items():
             if not isinstance(update, dict):
                 continue
@@ -490,55 +530,52 @@ class StreamlitLanggraphHandler:
             for msg in messages:
                 # Handle tool calls
                 if hasattr(msg, 'tool_calls') and msg.tool_calls:
-                    if self._config.show_tool_calls:
-                        for tc in msg.tool_calls:
-                            tool_name = tc.get('name', 'tool')
-                            tool_args = tc.get('args', {})
-
-                            # Add to thought tracking
-                            self._add_thought("tool_call", {"name": tool_name, "args": tool_args})
+                    for tc in msg.tool_calls:
+                        tool_name = tc.get('name', 'tool')
+                        tool_args = tc.get('args', {})
+
+                        # Only add to thoughts if show_tool_calls is True
+                        if self._config.show_tool_calls:
+                            self._add_thought(
+                                "tool_call",
+                                {"name": tool_name, "args": tool_args}
+                            )
+                            self._render_thoughts_in_status()
 
-                            with self._status_container:
-                                st.write(
-                                    f"{self._config.tool_call_emoji} "
-                                    f"**{tool_name}**: `{tool_args}`"
-                                )
+                        # Update status label to show current action
+                        self._status_container.update(
+                            label=f"{self._config.tool_call_emoji} {tool_name}...",
+                            state="running"
+                        )
 
-                            yield {
-                                "type": "tool_call",
-                                "data": {"name": tool_name, "args": tool_args}
-                            }
+                        yield {
+                            "type": "tool_call",
+                            "data": {"name": tool_name, "args": tool_args}
+                        }
 
                 # Handle tool results
                 if source == "tools" and hasattr(msg, 'name'):
-                    if self._config.show_tool_results:
-                        tool_name = msg.name
-                        tool_content = str(msg.content) if hasattr(msg, 'content') else ""
-
-                        # Add to thought tracking
-                        self._add_thought("tool_result", {"name": tool_name, "content": tool_content})
-
-                        with self._status_container:
-                            st.write(
-                                f"{self._config.tool_complete_emoji} "
-                                f"**{tool_name}** 완료"
-                            )
-                            # Collapse based on config
-                            expanded = not self._config.collapse_completed_thoughts
-                            with st.expander(f"📋 {tool_name} 결과 보기", expanded=expanded):
-                                if len(tool_content) > self._config.max_tool_content_length:
-                                    st.code(
-                                        tool_content[:self._config.max_tool_content_length]
-                                        + "\n... (truncated)",
-                                        language="text"
-                                    )
-                                else:
-                                    st.code(tool_content, language="text")
+                    tool_name = msg.name
+                    tool_content = str(msg.content) if hasattr(msg, 'content') else ""
 
-                        yield {
-                            "type": "tool_result",
-                            "data": {"name": tool_name, "content": tool_content}
-                        }
+                    # Only add to thoughts if show_tool_results is True
+                    if self._config.show_tool_results:
+                        self._add_thought(
+                            "tool_result",
+                            {"name": tool_name, "content": tool_content}
+                        )
+                        self._render_thoughts_in_status()
+
+                    # Update status to show thinking again
+                    self._status_container.update(
+                        label=self._config.thinking_label,
+                        state="running"
+                    )
+
+                    yield {
+                        "type": "tool_result",
+                        "data": {"name": tool_name, "content": tool_content}
+                    }
 
     def _handle_messages(
         self,

{youngjin_langchain_tools-0.1.3.dist-info → youngjin_langchain_tools-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: youngjin-langchain-tools
-Version: 0.1.3
+Version: 0.2.0
 Summary: LangGraph utilities for Streamlit - StreamlitLanggraphHandler and more
 Project-URL: Homepage, https://github.com/yourusername/youngjin-langchain-tools
 Project-URL: Documentation, https://github.com/yourusername/youngjin-langchain-tools#readme

{youngjin_langchain_tools-0.1.3.dist-info → youngjin_langchain_tools-0.2.0.dist-info}/RECORD

@@ -1,9 +1,9 @@
 youngjin_langchain_tools/__init__.py,sha256=S5GJtbYymhDuGtTibEG61Li9UvwvoFtnKm4mxjWNgnU,1310
 youngjin_langchain_tools/handlers/__init__.py,sha256=-vGk-m1fqOipJSe02ogcScE0K3pdVwO9A_EqBovPRxo,397
-youngjin_langchain_tools/handlers/streamlit_langgraph_handler.py,sha256=TDWjcgthh9eFPnufELbo4gzjUCCSYro6fUSRpwSXYuY,21540
+youngjin_langchain_tools/handlers/streamlit_langgraph_handler.py,sha256=O2_B5I7E0OWqh1JdS014aGw_smQsCpT7NykxcH16Ql8,22599
 youngjin_langchain_tools/utils/__init__.py,sha256=LgSd7Gz2n5WgIhxaKHqpmQVUaBUDT_TTTw63hzoWGgM,272
 youngjin_langchain_tools/utils/config.py,sha256=hHvdxsn5ZFWRJvR6N7ODy94JbCkeJocsS58hmvxoK5I,1640
-youngjin_langchain_tools-0.1.3.dist-info/METADATA,sha256=0hGrXQcNkFakDVdfvVdk14CXuciF7f5GR_RXP0QjM10,6959
-youngjin_langchain_tools-0.1.3.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-youngjin_langchain_tools-0.1.3.dist-info/licenses/LICENSE,sha256=fENUlkDDxJEn5c0u8mhVcz5ek-rTg2L4Kby1tMNchI8,11342
-youngjin_langchain_tools-0.1.3.dist-info/RECORD,,
+youngjin_langchain_tools-0.2.0.dist-info/METADATA,sha256=3zKlWZoqhkSKRxhFV89VL08pgwtfYxZgORGKWZM3N4Q,6959
+youngjin_langchain_tools-0.2.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+youngjin_langchain_tools-0.2.0.dist-info/licenses/LICENSE,sha256=fENUlkDDxJEn5c0u8mhVcz5ek-rTg2L4Kby1tMNchI8,11342
+youngjin_langchain_tools-0.2.0.dist-info/RECORD,,