agstack 1.20.0__tar.gz → 1.21.1__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agstack
-Version: 1.20.0
+Version: 1.21.1
 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.1}/agstack/llm/flow/agent.py

@@ -245,13 +245,13 @@ class Agent:
                     context.add_message(
                         self.name,
                         "tool",
-                        content=json.dumps({"error": error_msg}),
+                        content=json.dumps({"error": error_msg}, ensure_ascii=False),
                         tool_call_id=tool_call["id"],
                     )
                     # AG-UI: TOOL_CALL_RESULT (错误)
                     yield event.tool_call_result(
                         tool_call_id=tool_call["id"],
-                        content=json.dumps({"error": error_msg}),
+                        content=json.dumps({"error": error_msg}, ensure_ascii=False),
                     )
                     continue
 
@@ -261,12 +261,36 @@ 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})
+                    json.dumps(result.result, ensure_ascii=False)
+                    if result.success
+                    else json.dumps({"error": result.error}, ensure_ascii=False)
                 )
                 context.add_message(
                     self.name,

{agstack-1.20.0 → agstack-1.21.1}/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:
         """异步执行工具（包含计时、摘要生成、结果格式化、可观测性记录）"""
@@ -78,9 +93,17 @@ class Tool:
             try:
                 result.content = self.result_formatter(result)
             except Exception:
-                result.content = json.dumps(result.result) if result.success else json.dumps({"error": result.error})
+                result.content = (
+                    json.dumps(result.result, ensure_ascii=False)
+                    if result.success
+                    else json.dumps({"error": result.error}, ensure_ascii=False)
+                )
         else:
-            result.content = json.dumps(result.result) if result.success else json.dumps({"error": result.error})
+            result.content = (
+                json.dumps(result.result, ensure_ascii=False)
+                if result.success
+                else json.dumps({"error": result.error}, ensure_ascii=False)
+            )
 
         # 生成面向用户的摘要
         if self.summary_fn:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agstack
-Version: 1.20.0
+Version: 1.21.1
 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.1}/pyproject.toml

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