langchain-agentx-python 1.2.1__py3-none-any.whl → 1.2.2__py3-none-any.whl

langchain_agentx/__init__.py

@@ -11,7 +11,7 @@ from langchain_agentx import create_loop_agent
 ```
 """
 
-__version__ = "1.2.1"
+__version__ = "1.2.2"
 
 from .loop import (  # noqa: F401
     create_loop_agent,

langchain_agentx/tools/bash/backend.py

@@ -249,6 +249,9 @@ class BackgroundTask:
     pid: int
     """后台进程 PID。"""
 
+    command: str = ""
+    """原始命令（用于终态语义解析；亦持久化至 task_dir/command.txt）。"""
+
     sandboxed: bool = False
     """后台任务是否在沙箱模式下执行。"""
 
@@ -365,6 +368,7 @@ class LocalTmpdirSandboxBackend:
             task_id=task.task_id,
             output_path=task.output_path,
             pid=task.pid,
+            command=request.command,
             sandboxed=True,
             sandbox_temp_dir=temp_dir,
         )
@@ -1556,12 +1560,17 @@ class BashBackend:
         with open(pid_path, "w") as f:
             f.write(str(proc.pid))
 
+        command_path = os.path.join(task_dir, "command.txt")
+        with open(command_path, "w", encoding="utf-8") as f:
+            f.write(command)
+
         output_file.close()
 
         return BackgroundTask(
             task_id=task_id,
             output_path=output_path,
             pid=proc.pid,
+            command=command,
         )
 
     def get_background_status(self, task: BackgroundTask) -> BackgroundTaskStatus:
@@ -1619,23 +1628,25 @@ class BashBackend:
         )
 
     @staticmethod
-    def build_foreground_snapshot(result: ExecuteResult) -> BashTaskSnapshot:
+    def build_foreground_snapshot(
+        result: ExecuteResult,
+        *,
+        terminal_status: str,
+    ) -> BashTaskSnapshot:
+        """构建 foreground 快照；终态由 semantics.resolve_terminal_task_status 决定。"""
         t0 = time.time()
         sm = BashTaskStateMachine(task_id="foreground", task_mode="foreground")
         sm.created_ts = t0
         sm.transition_to("running")
         sm.started_ts = time.time()
-        if result.interrupted:
-            sm.transition_to("interrupted")
-        elif result.exit_code == 0:
-            sm.transition_to("completed")
-        else:
-            sm.transition_to("failed")
+        sm.transition_to(terminal_status)
         sm.ended_ts = time.time()
         sm.exit_code = result.exit_code
         return sm.to_snapshot()
 
     def build_background_snapshot(self, task: BackgroundTask) -> BashTaskSnapshot:
+        from .semantics import resolve_background_terminal_status
+
         status = self.get_background_status(task)
         sm = BashTaskStateMachine(task_id=task.task_id, task_mode="background")
         sm.created_ts = time.time()
@@ -1647,17 +1658,36 @@ class BashBackend:
         if status.running:
             return sm.to_snapshot()
         sm.ended_ts = time.time()
-        if status.exit_code == -2:
-            sm.transition_to("cancelled")
-        elif status.exit_code == 0:
-            sm.transition_to("completed")
-        elif status.exit_code is None:
-            sm.transition_to("interrupted")
-        else:
-            sm.transition_to("failed")
+        command = task.command or self._read_persisted_background_command(task)
+        stdout = self._read_background_output_text(task.output_path)
+        terminal_status = resolve_background_terminal_status(
+            exit_code=status.exit_code,
+            command=command,
+            stdout=stdout,
+        )
+        sm.transition_to(terminal_status)
         sm.exit_code = status.exit_code
         return sm.to_snapshot()
 
+    @staticmethod
+    def _read_persisted_background_command(task: BackgroundTask) -> str:
+        command_path = os.path.join(os.path.dirname(task.output_path), "command.txt")
+        try:
+            with open(command_path, encoding="utf-8") as f:
+                return f.read().strip()
+        except OSError:
+            return ""
+
+    @staticmethod
+    def _read_background_output_text(output_path: str) -> str:
+        if not os.path.exists(output_path):
+            return ""
+        try:
+            with open(output_path, encoding="utf-8", errors="replace") as f:
+                return f.read()
+        except OSError:
+            return ""
+
     def cancel_background_task(self, task: BackgroundTask) -> bool:
         """
         取消后台任务：发信号终止进程，并标记为 cancelled（exit_code 文件写 -2）。

langchain_agentx/tools/bash/result_presenter.py

@@ -143,16 +143,10 @@ class BashResultPresenter:
             )
 
         summary = description_text or f"Ran: {command[:60]}"
-        # 构建 payload：合并 stdout 和 stderr（与 CC mapToolResultToToolResultBlockParam 对齐）
         stdout_text = result.stdout or ""
         stderr_text = result.stderr or ""
-        if stdout_text and stderr_text:
-            payload = f"{stdout_text}\n{stderr_text}"
-        elif stderr_text:
-            payload = stderr_text
-        else:
-            payload = stdout_text or "(No output)"
-        hints = self._build_hints(result)
+        payload, skip_interpretation_hint = self._resolve_foreground_payload(result)
+        hints = self._build_hints(result, skip_interpretation=skip_interpretation_hint)
         if result.output_truncated and result.overflow_file:
             import os
 
@@ -200,14 +194,7 @@ class BashResultPresenter:
             tool_name=tool_name,
             summary=summary,
             payload=payload,
-            blocks=[
-                ToolContentBlock(
-                    type="status",
-                    text=f"task:{result.task_status}",
-                    meta={"task_mode": result.task_mode, "task_exit_code": result.task_exit_code},
-                ),
-                ToolContentBlock(type="text", text=payload),
-            ],
+            blocks=[ToolContentBlock(type="text", text=payload)],
             hints=hints or None,
             meta=self._attach_observability({
                 "exit_code": result.exit_code,
@@ -316,10 +303,36 @@ class BashResultPresenter:
             meta=self._attach_observability({"exit_code": result.exit_code, "command": command}, result),
         )
 
-    def _build_hints(self, result: BashToolOutput) -> list[ToolHint]:
-        hints: list[ToolHint] = []
+    def _resolve_foreground_payload(self, result: BashToolOutput) -> tuple[str, bool]:
+        """
+        CC BashToolResultMessage：空输出时优先展示 returnCodeInterpretation。
 
+        Returns:
+            (payload, skip_interpretation_hint) — payload 已含 interpretation 时不再重复 hint。
+        """
+        stdout_text = result.stdout or ""
+        stderr_text = result.stderr or ""
+        if stdout_text.strip() or stderr_text.strip():
+            if stdout_text and stderr_text:
+                return f"{stdout_text}\n{stderr_text}", False
+            if stderr_text:
+                return stderr_text, False
+            return stdout_text, False
         if result.return_code_interpretation:
+            return result.return_code_interpretation, True
+        if result.no_output_expected:
+            return "Done", False
+        return "(No output)", False
+
+    def _build_hints(
+        self,
+        result: BashToolOutput,
+        *,
+        skip_interpretation: bool = False,
+    ) -> list[ToolHint]:
+        hints: list[ToolHint] = []
+
+        if result.return_code_interpretation and not skip_interpretation:
             hints.append(ToolHint(message=result.return_code_interpretation))
 
         if result.destructive_warning:

langchain_agentx/tools/bash/semantics.py

@@ -17,7 +17,8 @@ from __future__ import annotations
 import re
 from dataclasses import dataclass
 
-# tree/find/ls 在 Windows Git Bash 等环境常不可用（exit 127）；CC 引导用 Glob 专用工具。
+# tree/find/ls 在 Windows Git Bash 等环境常不可用（exit 127）。
+# SDK 扩展（相对 CC DEFAULT_SEMANTIC 硬失败）：软成功 + Glob hint，便于跨平台引导。
 _FILE_LISTING_COMMANDS = re.compile(r"^(?:tree|find|ls)\b")
 _FILE_LISTING_EXIT_127_HINT = (
     "Command not found (exit 127). "
@@ -86,6 +87,46 @@ class CommandResult:
     message: str | None = None
 
 
+def resolve_terminal_task_status(
+    *,
+    interrupted: bool,
+    exit_code: int,
+    semantic: CommandResult,
+) -> str:
+    """
+    由 interpret_command_result 派生任务终态（SSOT）。
+
+    对应 CC BashTool.call：interpretCommandResult → throw ShellError 或成功返回；
+    SDK 额外保留 task_status 供 observability，但不得再用 raw exit_code 独立判定。
+    """
+    if interrupted:
+        return "interrupted"
+    if semantic.is_error and exit_code != 0:
+        return "failed"
+    return "completed"
+
+
+def resolve_background_terminal_status(
+    *,
+    exit_code: int | None,
+    command: str,
+    stdout: str = "",
+) -> str:
+    """
+    后台任务终态：cancelled/interrupted 走协议码；其余与 foreground 共用 semantics SSOT。
+    """
+    if exit_code == -2:
+        return "cancelled"
+    if exit_code is None:
+        return "interrupted"
+    semantic = interpret_command_result(command, exit_code, stdout)
+    return resolve_terminal_task_status(
+        interrupted=False,
+        exit_code=exit_code,
+        semantic=semantic,
+    )
+
+
 def interpret_command_result(
     command: str,
     exit_code: int,

langchain_agentx/tools/bash/tool.py

@@ -67,7 +67,7 @@ from .security import (
     detect_infinite_output,
     detect_sleep_block,
 )
-from .semantics import interpret_command_result
+from .semantics import interpret_command_result, resolve_terminal_task_status
 
 
 def _as_bash_input_dict(data: dict[str, Any] | BashToolInput) -> dict[str, Any]:
@@ -728,12 +728,20 @@ class BashRuntimeTool(RuntimeTool):
 
         # 危险命令警告（非阻断）
         destructive_warning = detect_destructive_patterns(command)
-        snapshot = self._backend.build_foreground_snapshot(result)
 
-        # 退出码语义解析
+        # 退出码语义（SSOT：与 CC interpretCommandResult 一致，驱动 ok/error 与 task_status）
         cmd_result = interpret_command_result(
             command, result.exit_code, result.stdout
         )
+        terminal_status = resolve_terminal_task_status(
+            interrupted=result.interrupted,
+            exit_code=result.exit_code,
+            semantic=cmd_result,
+        )
+        snapshot = self._backend.build_foreground_snapshot(
+            result,
+            terminal_status=terminal_status,
+        )
 
         # 真正错误时抛异常（pipeline 捕获 → error envelope）
         if cmd_result.is_error and result.exit_code != 0 and not result.sandbox_violation_message:
@@ -881,6 +889,8 @@ class BashRuntimeTool(RuntimeTool):
             "interrupted": result.interrupted,
             "task_mode": result.task_mode,
             "task_status": result.task_status,
+            "return_code_interpretation": result.return_code_interpretation,
+            "no_output_expected": result.no_output_expected,
         }
 
     def to_auto_classifier_input(self, data: dict[str, Any]) -> str | None:

{langchain_agentx_python-1.2.1.dist-info → langchain_agentx_python-1.2.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: langchain-agentx-python
-Version: 1.2.1
+Version: 1.2.2
 Summary: LangChain/LangGraph-based agent utilities for CodeBaseX.
 Author-email: GoodMood2008 <GoodMood2008@users.noreply.github.com>
 License: Apache License

{langchain_agentx_python-1.2.1.dist-info → langchain_agentx_python-1.2.2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-langchain_agentx/__init__.py,sha256=2slxrsn6pOSUn5oww3M4IxJKjH6UFPL1vfKusoiXytI,1678
+langchain_agentx/__init__.py,sha256=gLxjoC92OvVi3mha5vefLza8Zsq5gQWFey0SROZ93nQ,1678
 langchain_agentx/command/__init__.py,sha256=Ej260S5uFQcmEtGZQG_NH7BYjHoStrpBLtGUsBTxyZk,631
 langchain_agentx/command/allowed_tools.py,sha256=TVA0VM8rm98H-QbLK_GRiX5RhEAZFxKawliMi4kk96A,3359
 langchain_agentx/command/context.py,sha256=DIGOGPBw5UGDBm0WNNJlKx1h_9rCRmcdROv4DT61Qug,731
@@ -477,7 +477,7 @@ langchain_agentx/tools/ask_user_question/validators.py,sha256=gUYuuKJNrExWGvhFlm
 langchain_agentx/tools/bash/__init__.py,sha256=molPHFDylE2wWG_aQx7fb0ciAx3wWpdXzIixTZV5ne4,214
 langchain_agentx/tools/bash/ast_security.py,sha256=-MlvQ559dR3vCactzAEnNAFEJB-QhZDXmDIqpPPpqR0,20874
 langchain_agentx/tools/bash/auto_mode_adapter.py,sha256=7-yb_kGmpytBYkD2Hn5YWPIceo_YN4PatEKj8O7HKsM,4243
-langchain_agentx/tools/bash/backend.py,sha256=_F1KEyEbNP20F9l2jzEFwEtm8KEgke2V4WTb1fETyss,62651
+langchain_agentx/tools/bash/backend.py,sha256=6aTUefDv-z743kmlkVyt7mwtSiSJQFMue7f6FYcsl_I,63767
 langchain_agentx/tools/bash/bash_hardening.py,sha256=KEYKRC7kS_to4mzXuChvCmOIIb4dSUkOb9K1MBDtWDc,29296
 langchain_agentx/tools/bash/bash_runtime_contract.py,sha256=s8vrvMl7405KLGw2hPFbzlzWohm5JX3c9cImMBgqh8I,1511
 langchain_agentx/tools/bash/boundary_check.py,sha256=3B_Epe2NEJtLcNM3anNiCdOJdyNj_B3mOZ0mT_0bnpY,8010
@@ -494,17 +494,17 @@ langchain_agentx/tools/bash/output_utils.py,sha256=WYU2vVOjo9HQKSeQ_z88KxJsrvlFm
 langchain_agentx/tools/bash/path_security.py,sha256=L7zFXoyBDYLtd2bVLIeMg-xuCkSD7-Tt2EKlvKR_ssI,94984
 langchain_agentx/tools/bash/prompt.py,sha256=28WBRLt5G6e-OUildOFbeEyw7eL3iI8T40pEwmWVYxo,12527
 langchain_agentx/tools/bash/read_only_validation.py,sha256=rtNW6nK7sQMzR6LGc420kUd5wE30DnYX8jjuW7hUFWA,24822
-langchain_agentx/tools/bash/result_presenter.py,sha256=bUqpvcP2mo0FfOnI2v3Gu9mQGBATQQrHRL5dDYiv-yU,14420
+langchain_agentx/tools/bash/result_presenter.py,sha256=OkJid40AmrAsRxhY7jSaw_PgRMoIfMcj6BNXaqcryTo,14946
 langchain_agentx/tools/bash/sandbox_decision.py,sha256=T_JaTfPADDcH2mRtrpKTBbIVo2Q6CHkzg_aUXCuDhLQ,4612
 langchain_agentx/tools/bash/security.py,sha256=YM34IUvNMDskoEA-WTG7hiuziY90DAFqQngpntGOtEc,7807
 langchain_agentx/tools/bash/sed_edit_parser.py,sha256=tTDLMj5f5C4nkcf1Ykn9uMKJtEQNm3ejrKQOal2sI9s,7855
 langchain_agentx/tools/bash/sed_validation.py,sha256=HA-zWe8Wo4LbgC9x8ZMQLzkd73i4IFeay0GhNb2qM20,5704
 langchain_agentx/tools/bash/semantic_matrix.py,sha256=rWO31jB2TxOSmCAMYKe3bkQ6YOHU7pCMX0--OABP5kM,3184
-langchain_agentx/tools/bash/semantics.py,sha256=JCewxOYCTGgYUsXXuCrc92ZWcIVyuqJZXTZzmN9xSGk,4602
+langchain_agentx/tools/bash/semantics.py,sha256=pkf4URTulAOVL7m04Rq9JJF7z0J2mTEsGWrjyoY9r6o,5769
 langchain_agentx/tools/bash/shell_locator.py,sha256=AUnCZS8gmZurCs8rL4y0MMOS9UZimfg5rQ5At38mZKU,6296
 langchain_agentx/tools/bash/shell_quoting.py,sha256=K4JLVGwU8VpdQzfQB1o3xsq4HoCKHew1pry8hHChcoA,4498
 langchain_agentx/tools/bash/task_runtime.py,sha256=hikVC9YugtvpLf4nDaPlX_GFem1YQvDRwN0ShRflUYU,3568
-langchain_agentx/tools/bash/tool.py,sha256=U5iMC7ey9mDVWDSpk4cqn_u6fUWDi7A1mjeyiPBdSZU,44480
+langchain_agentx/tools/bash/tool.py,sha256=OWPEyJQdqw2h2Abr9ZzLN0Vk0tS-2gIAGQt58CCXBms,44976
 langchain_agentx/tools/bash/windows_shell_quoting.py,sha256=0RzLnTKyFrJ536QzqPZvSyUcQWN794XRlAq2RdHeKHo,1615
 langchain_agentx/tools/edit/__init__.py,sha256=PiiOHUODUzTRQxxPdE7ZMTjd3vfdzm9LEcn1lpVtg8o,203
 langchain_agentx/tools/edit/backend.py,sha256=JrikYafZDGMQ2JjXRxbnv1VSHVGRUdLmZN__nnqkM9o,3159
@@ -651,8 +651,8 @@ langchain_agentx/workspace/root_grant_manager.py,sha256=W3gy8HTevbERbXqIgRcjzOXO
 langchain_agentx/workspace/tool_boundary.py,sha256=UDwX6swpSLsx9HNkYuuRRiV5o7ZZG_Bru2Yn0c5kNX8,5724
 langchain_agentx/workspace/validators.py,sha256=tQt-6TOcL8Fw7Ig5ebA9S7vGWh1rby920eFW6x8Tk9E,1439
 langchain_agentx/workspace/view.py,sha256=Ip02CZNI-ZjF5k0OYT3q7RUR_auMEw83VJ6rQsaBcYU,4588
-langchain_agentx_python-1.2.1.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-langchain_agentx_python-1.2.1.dist-info/METADATA,sha256=I_uJTiEUapAJ5QTOeOb9Jf40fZPpKNQ4D8zOzO96HMw,24846
-langchain_agentx_python-1.2.1.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
-langchain_agentx_python-1.2.1.dist-info/top_level.txt,sha256=Ge284pniNt8xea0OLk2o9o32GqVpDhOYk20fwE-0xxA,17
-langchain_agentx_python-1.2.1.dist-info/RECORD,,
+langchain_agentx_python-1.2.2.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+langchain_agentx_python-1.2.2.dist-info/METADATA,sha256=SFntj7m8EPCZwMIFq8WVSfPi55YiHnr5WHpCc87QU9M,24846
+langchain_agentx_python-1.2.2.dist-info/WHEEL,sha256=51RkbunBAw4BWsgaQWTpPhg4Diwp3c9P5iaLk67Hdtg,92
+langchain_agentx_python-1.2.2.dist-info/top_level.txt,sha256=Ge284pniNt8xea0OLk2o9o32GqVpDhOYk20fwE-0xxA,17
+langchain_agentx_python-1.2.2.dist-info/RECORD,,