agstack 1.20.0__tar.gz → 1.21.0__tar.gz

{agstack-1.20.0 → agstack-1.21.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agstack
-Version: 1.20.0
+Version: 1.21.0
 Summary: Production-ready toolkit for building FastAPI and LLM applications
 Author-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>
 Maintainer-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>

{agstack-1.20.0 → agstack-1.21.0}/agstack/llm/flow/agent.py

@@ -261,9 +261,31 @@ class Agent:
                 except json.JSONDecodeError:
                     tool_args = {}
 
+                # 执行前进度事件
+                progress_label = tool.get_progress_label(tool_args)
+                if progress_label:
+                    yield event.custom(
+                        name="skill_progress",
+                        value={
+                            "progressId": tool_call["id"],
+                            "description": progress_label,
+                            "status": "running",
+                        },
+                    )
+
                 # 执行工具（传入 LLM 解析的参数作为 inputs）
                 result = await tool.execute_async(context, tool_args)
 
+                # 执行后进度事件
+                if progress_label:
+                    yield event.custom(
+                        name="skill_progress",
+                        value={
+                            "progressId": tool_call["id"],
+                            "status": "completed" if result.success else "failed",
+                        },
+                    )
+
                 # 使用 result.content 作为 LLM 上下文（Tool 已计算好）
                 result_content = result.content or (
                     json.dumps(result.result) if result.success else json.dumps({"error": result.error})

{agstack-1.20.0 → agstack-1.21.0}/agstack/llm/flow/tool.py

@@ -43,6 +43,7 @@ class Tool:
         category: str | None = None,
         summary_fn: Callable[["ToolResult"], str | None] | None = None,
         result_formatter: Callable[["ToolResult"], str] | None = None,
+        progress_label_fn: Callable[[dict[str, Any]], str] | None = None,
     ):
         """初始化工具
 
@@ -55,6 +56,7 @@ class Tool:
         :param category: 工具分类（retrieval / analysis / action / utility）
         :param summary_fn: 生成面向用户摘要的函数 (ToolResult) -> str | None
         :param result_formatter: 自定义 LLM 内容格式化函数 (ToolResult) -> str
+        :param progress_label_fn: 基于调用参数生成动态进度描述 (args) -> str
         """
         self.name = name
         self.description = description
@@ -65,6 +67,19 @@ class Tool:
         self.category = category
         self.summary_fn = summary_fn
         self.result_formatter = result_formatter
+        self.progress_label_fn = progress_label_fn
+
+    def get_progress_label(self, args: dict[str, Any]) -> str | None:
+        """基于调用参数生成面向用户的动态进度描述
+
+        返回 None 时不发送进度事件。
+        """
+        if self.progress_label_fn:
+            try:
+                return self.progress_label_fn(args)
+            except Exception:
+                pass
+        return self.label
 
     async def execute_async(self, context: "FlowContext", inputs: dict[str, Any] | None = None) -> ToolResult:
         """异步执行工具（包含计时、摘要生成、结果格式化、可观测性记录）"""

{agstack-1.20.0 → agstack-1.21.0}/agstack.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agstack
-Version: 1.20.0
+Version: 1.21.0
 Summary: Production-ready toolkit for building FastAPI and LLM applications
 Author-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>
 Maintainer-email: XtraVisions <gitadmin@xtravisions.com>, Chen Hao <chenhao@xtravisions.com>

{agstack-1.20.0 → agstack-1.21.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "agstack"
-version = "1.20.0"
+version = "1.21.0"
 description = "Production-ready toolkit for building FastAPI and LLM applications"
 readme = "README.md"
 license = "MIT"