agstack 1.12.0__tar.gz → 1.13.0__tar.gz

{agstack-1.12.0 → agstack-1.13.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agstack
-Version: 1.12.0
+Version: 1.13.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.12.0 → agstack-1.13.0}/agstack/llm/flow/nodes/__init__.py

@@ -5,6 +5,7 @@
 from .agent_node import AgentNodeHandler
 from .base import NodeHandler
 from .detect_node import DetectNodeHandler
+from .echo_node import EchoNodeHandler
 from .llm_chat_node import LLMChatNodeHandler
 from .llm_embed_node import LLMEmbedNodeHandler
 from .llm_rerank_node import LLMRerankNodeHandler
@@ -23,6 +24,7 @@ builtin_handlers: list[NodeHandler] = [
     LLMEmbedNodeHandler(),
     LLMRerankNodeHandler(),
     DetectNodeHandler(),
+    EchoNodeHandler(),
     SwitchNodeHandler(),
     SubflowNodeHandler(),
 ]

agstack-1.13.0/agstack/llm/flow/nodes/echo_node.py

@@ -0,0 +1,54 @@
+#  Copyright (c) 2020-2026 XtraVisions, All rights reserved.
+
+"""Echo 节点 — 将 context 中的文本作为 TEXT_MESSAGE 事件流式输出（不调用 LLM）"""
+
+from typing import TYPE_CHECKING, Any, AsyncIterator
+from uuid import uuid4
+
+from agstack.llm.flow import event
+from agstack.llm.flow.nodes.base import NodeHandler
+
+
+if TYPE_CHECKING:
+    from agstack.llm.flow.context import FlowContext
+
+
+class EchoNodeHandler(NodeHandler):
+    """Echo 节点：从 context 读取文本并流式输出为 TEXT_MESSAGE 事件
+
+    用于将内部 agent 的结果展示给用户，不产生额外 LLM 调用。
+    """
+
+    node_type = "echo"
+
+    async def execute(self, node: dict, context: "FlowContext") -> Any:
+        config = node.get("config", {})
+        resolved = self.resolve_inputs(config, context)
+        content = resolved.get("content", "")
+        if isinstance(content, dict):
+            content = content.get("result", "")
+        return {"result": content}
+
+    async def stream(self, node: dict, context: "FlowContext", node_id: str) -> AsyncIterator[dict[str, Any]]:
+        config = node.get("config", {})
+        step_name = self.get_step_name(node, node_id)
+
+        yield event.step_started(step_name=step_name)
+
+        resolved = self.resolve_inputs(config, context)
+        content = resolved.get("content", "")
+        if isinstance(content, dict):
+            content = content.get("result", "")
+
+        if content:
+            msg_id = context.message_id or str(uuid4())
+            yield event.text_message_start(message_id=msg_id, role="assistant")
+
+            chunk_size = 80
+            for i in range(0, len(content), chunk_size):
+                yield event.text_message_content(message_id=msg_id, delta=content[i : i + chunk_size])
+
+            yield event.text_message_end(message_id=msg_id)
+
+        context.set_output(node_id, {"result": content})
+        yield event.step_finished(step_name=step_name)

{agstack-1.12.0 → agstack-1.13.0}/agstack.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agstack
-Version: 1.12.0
+Version: 1.13.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.12.0 → agstack-1.13.0}/agstack.egg-info/SOURCES.txt

@@ -47,6 +47,7 @@ agstack/llm/flow/nodes/__init__.py
 agstack/llm/flow/nodes/agent_node.py
 agstack/llm/flow/nodes/base.py
 agstack/llm/flow/nodes/detect_node.py
+agstack/llm/flow/nodes/echo_node.py
 agstack/llm/flow/nodes/llm_chat_node.py
 agstack/llm/flow/nodes/llm_embed_node.py
 agstack/llm/flow/nodes/llm_rerank_node.py

{agstack-1.12.0 → agstack-1.13.0}/pyproject.toml

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