langchain-agentx-python 1.1.3__tar.gz → 1.1.5__tar.gz

{langchain-agentx-python-1.1.3/langchain_agentx_python.egg-info → langchain-agentx-python-1.1.5}/PKG-INFO

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

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/langchain_agentx/__init__.py

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

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/langchain_agentx/task_runtime/store/file_store.py

@@ -22,15 +22,15 @@ task_runtime/store/file_store.py — Task Runtime 文件持久化存储（CC 风
 
 from __future__ import annotations
 
-import fcntl
 import json
 import os
 import sys
 import time
 
-# Windows 专用模块
 if sys.platform == "win32":
     import msvcrt  # noqa: F401 (仅 Windows 使用)
+else:
+    import fcntl  # noqa: F401 (Unix 文件锁)
 from dataclasses import asdict
 from pathlib import Path
 from threading import RLock
@@ -363,13 +363,13 @@ def _lock_file(file_obj, shared: bool = False) -> None:
         shared: 是否为共享锁（读锁）
     """
     if sys.platform == "win32":
-        # Windows: 使用 msvcrt.locking
-        # 注意：Windows 不支持共享锁，总是独占锁
+        # Windows 字节范围锁：须在锁定位置解锁；读写后 seek 回 0
+        file_obj.seek(0)
         try:
             msvcrt.locking(file_obj.fileno(), msvcrt.LK_NBLCK, 1)
-        except (OSError, IOError):
-            # 文件已被锁定，等待重试
+        except OSError:
             time.sleep(0.01)
+            file_obj.seek(0)
             msvcrt.locking(file_obj.fileno(), msvcrt.LK_NBLCK, 1)
     else:
         # Unix: 使用 fcntl
@@ -384,8 +384,11 @@ def _unlock_file(file_obj) -> None:
         file_obj: 文件对象
     """
     if sys.platform == "win32":
-        # Windows: 使用 msvcrt.locking
-        msvcrt.locking(file_obj.fileno(), msvcrt.LK_UNLCK, 1)
+        file_obj.seek(0)
+        try:
+            msvcrt.locking(file_obj.fileno(), msvcrt.LK_UNLCK, 1)
+        except OSError:
+            pass
     else:
         # Unix: 使用 fcntl
         fcntl.flock(file_obj.fileno(), fcntl.LOCK_UN)

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/langchain_agentx/task_runtime/tasklist/__init__.py

@@ -27,6 +27,8 @@ from .models import (
     TaskUpdateStatus,
 )
 from .path_resolver import (
+    get_highwatermark_path,
+    get_task_list_lock_path,
     get_task_path,
     get_tasks_dir,
     resolve_task_list_id,
@@ -54,6 +56,8 @@ __all__ = [
     "on_tasks_updated",
     "get_tasks_dir",
     "get_task_path",
+    "get_highwatermark_path",
+    "get_task_list_lock_path",
     "resolve_task_list_id",
     "resolve_task_list_paths",
     "sanitize_path_component",

langchain-agentx-python-1.1.5/langchain_agentx/task_runtime/tasklist/config_home_paths.py

@@ -0,0 +1,93 @@
+"""
+task_runtime/tasklist/config_home_paths.py — config home 任务路径解析
+
+职责：
+    按 CC getClaudeConfigHomeDir + getTasksDir 公式解析任务列表物理路径：
+    {config_home}/tasks/{taskListId}/{taskId}.json
+
+链路位置：
+    path_resolver → ConfigHomeTaskPaths → workspace/project_key.resolve_config_home_dir
+
+与 CC 对应：
+    src/utils/envUtils.ts#getClaudeConfigHomeDir
+    src/utils/tasks.ts#getTasksDir / getTaskPath / getHighWaterMarkPath
+
+当前裁剪范围（Phase 7）：
+    - 不含 taskListId 5 级解析（Phase 8）
+    - 不含 /tmp 数据迁移（Phase 7 可选工具未在本模块）
+"""
+
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+from pathlib import Path
+
+from langchain_agentx.workspace import ResolvedAgentStateConfig
+from langchain_agentx.workspace.project_key import resolve_config_home_dir
+from langchain_agentx.workspace.resolver import resolve_agent_home_string
+
+HIGH_WATERMARK_FILE = ".highwatermark"
+TASK_LIST_LOCK_FILE = ".lock"
+
+
+def sanitize_path_component(s: str) -> str:
+    """路径组件安全化（对齐 CC sanitizePathComponent）。"""
+    sanitized = re.sub(r"[^a-zA-Z0-9_-]", "-", s)
+    sanitized = sanitized.strip(". ")
+    if len(sanitized) > 255:
+        sanitized = sanitized[:255]
+    return sanitized or "unnamed"
+
+
+def resolve_config_home(agent_home_segment: str | None = None) -> Path:
+    """解析 config home 目录（对齐 CC getClaudeConfigHomeDir）。
+
+    优先级与 workspace resolver 一致：显式 segment → 环境变量 → 默认 .langchain_agentx。
+    """
+    segment = resolve_agent_home_string(agent_home_segment)
+    return resolve_config_home_dir(segment)
+
+
+def get_config_home(config: ResolvedAgentStateConfig) -> Path:
+    """从已解析工作区配置派生 config home（禁止业务模块自行拼接 Path.home()）。"""
+    return resolve_config_home_dir(config.agent_home_segment)
+
+
+@dataclass(frozen=True, slots=True)
+class ConfigHomeTaskPaths:
+    """config home 下任务列表路径 Facade（OOP 单一职责）。"""
+
+    config_home: Path
+
+    @classmethod
+    def from_agent_home_segment(cls, agent_home_segment: str | None = None) -> ConfigHomeTaskPaths:
+        return cls(config_home=resolve_config_home(agent_home_segment))
+
+    @classmethod
+    def from_workspace_config(cls, config: ResolvedAgentStateConfig) -> ConfigHomeTaskPaths:
+        return cls(config_home=get_config_home(config))
+
+    def tasks_dir(self, task_list_id: str) -> Path:
+        safe_id = sanitize_path_component(task_list_id)
+        return self.config_home / "tasks" / safe_id
+
+    def task_path(self, task_list_id: str, task_id: str) -> Path:
+        safe_task_id = sanitize_path_component(task_id)
+        return self.tasks_dir(task_list_id) / f"{safe_task_id}.json"
+
+    def highwatermark_path(self, task_list_id: str) -> Path:
+        return self.tasks_dir(task_list_id) / HIGH_WATERMARK_FILE
+
+    def task_list_lock_path(self, task_list_id: str) -> Path:
+        return self.tasks_dir(task_list_id) / TASK_LIST_LOCK_FILE
+
+
+__all__ = [
+    "HIGH_WATERMARK_FILE",
+    "TASK_LIST_LOCK_FILE",
+    "ConfigHomeTaskPaths",
+    "get_config_home",
+    "resolve_config_home",
+    "sanitize_path_component",
+]

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/langchain_agentx/task_runtime/tasklist/high_water_mark.py

@@ -22,7 +22,8 @@ from __future__ import annotations
 
 import asyncio
 from pathlib import Path
-from typing import Optional
+
+from .config_home_paths import HIGH_WATERMARK_FILE
 
 
 class HighWaterMarkManager:
@@ -43,8 +44,8 @@ class HighWaterMarkManager:
         self.timeout = timeout
 
     def _get_highwatermark_path(self, tasks_dir: Path) -> Path:
-        """获取高水位文件路径。"""
-        return tasks_dir / ".highwatermark"
+        """获取高水位文件路径（与 path_resolver.get_highwatermark_path 文件名一致）。"""
+        return tasks_dir / HIGH_WATERMARK_FILE
 
     async def read(self, tasks_dir: Path) -> int:
         """读取当前高水位值。
@@ -218,3 +219,9 @@ class HighWaterMarkManager:
         self._write_sync(tasks_dir, next_id)
 
         return next_id
+
+    def maybe_raise_mark_sync(self, tasks_dir: Path, task_id: int) -> None:
+        """若 task_id 高于当前 mark 则提升 mark（对齐 CC deleteTask L400–407）。"""
+        current = self._read_sync(tasks_dir)
+        if task_id > current:
+            self._write_sync(tasks_dir, task_id)

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/langchain_agentx/task_runtime/tasklist/notifier.py

@@ -2,15 +2,17 @@
 task_runtime/tasklist/notifier.py — 任务列表更新通知
 
 职责：
-    提供进程内任务列表变更订阅/广播，对齐 CC notifyTasksUpdated / onTasksUpdated。
+    提供进程内任务列表变更订阅/广播。
 
-链路位置：
-    TaskStore create/update/delete/reset 落盘成功 → notify_tasks_updated()
-    → CLI 可选 on_tasks_updated 加速刷新（不替代 fs.watch）
+链路位置（SDK 设计，与 CC 分层不同）：
+    TaskStore 落盘成功 → notify_tasks_updated()（唯一 emit 源）
+    → CLI on_tasks_updated 回调内调用 TaskListReader.list_tasks() 刷新
+    TaskListReader / paths 只读，不得再次 emit。
 
 当前裁剪范围：
     - 仅同进程通知；跨进程变更靠 CLI 目录 watch / poll
     - listener 异常吞掉，写盘/reset 不受通知失败影响
+    - 单次 store 变更操作只 notify 一次（内部子步骤 suppress）
 """
 
 from __future__ import annotations

langchain-agentx-python-1.1.5/langchain_agentx/task_runtime/tasklist/path_resolver.py

@@ -0,0 +1,80 @@
+"""task_runtime/tasklist/path_resolver.py — 任务列表路径解析（config home）
+
+职责：
+    解析任务存储相关路径，使用 CC config home 两层结构：
+    - 路径安全化（防止目录穿越攻击）
+    - 任务目录 / 单任务文件 / 高水位 / 列表锁路径
+    - task_list_id 多级回退逻辑（Phase 8 扩展）
+
+链路位置：
+    TaskStore → path_resolver → ConfigHomeTaskPaths
+
+与 CC 对应：
+    CC src/utils/tasks.ts 中 getTasksDir、getTaskPath 等。
+
+裁剪范围（Phase 7）：
+    - 路径：{config_home}/tasks/{taskListId}/（无 cwd 项目层级）
+    - Team 模式 taskListId 扩展点预留（Phase 8）
+"""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+from typing import Optional
+
+from langchain_agentx.workspace import ResolvedAgentStateConfig
+
+from .config_home_paths import ConfigHomeTaskPaths, sanitize_path_component
+
+
+def get_tasks_dir(config: ResolvedAgentStateConfig, task_list_id: str) -> Path:
+    """获取任务存储目录：{config_home}/tasks/{sanitize(task_list_id)}/。"""
+    return ConfigHomeTaskPaths.from_workspace_config(config).tasks_dir(task_list_id)
+
+
+def get_task_path(
+    config: ResolvedAgentStateConfig,
+    task_list_id: str,
+    task_id: str,
+) -> Path:
+    """获取单个任务文件路径：{tasks_dir}/{sanitize(task_id)}.json。"""
+    return ConfigHomeTaskPaths.from_workspace_config(config).task_path(task_list_id, task_id)
+
+
+def get_highwatermark_path(config: ResolvedAgentStateConfig, task_list_id: str) -> Path:
+    """获取高水位标记文件路径（对齐 CC getHighWaterMarkPath）。"""
+    return ConfigHomeTaskPaths.from_workspace_config(config).highwatermark_path(task_list_id)
+
+
+def get_task_list_lock_path(config: ResolvedAgentStateConfig, task_list_id: str) -> Path:
+    """获取任务列表锁文件路径（对齐 CC ensureTaskListLockFile）。"""
+    return ConfigHomeTaskPaths.from_workspace_config(config).task_list_lock_path(task_list_id)
+
+
+def resolve_task_list_id(
+    config: ResolvedAgentStateConfig,
+    session_id: Optional[str] = None,
+) -> str:
+    """解析任务列表 ID。
+
+    多级回退逻辑：
+    1. 环境变量 LANGCHAIN_AGENTX_TASK_LIST_ID
+    2. 传入的 session_id
+    3. 默认 "default"
+
+    Args:
+        config: 工作区配置（保留以备 Phase 8 扩展）
+        session_id: 可选的会话 ID
+
+    Returns:
+        解析后的任务列表 ID
+    """
+    env_id = os.getenv("LANGCHAIN_AGENTX_TASK_LIST_ID")
+    if env_id:
+        return env_id
+
+    if session_id:
+        return session_id
+
+    return "default"

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/langchain_agentx/task_runtime/tasklist/paths.py

@@ -9,8 +9,19 @@ task_runtime/tasklist/paths.py — 任务列表路径 Facade（CLI 消费）
     CLI TaskFileReader → resolve_task_list_paths → path_resolver
 
 当前裁剪范围：
-    - 不含 Team / teammate 的 task_list_id 分支（待 TeamCreate 工具）
-    - 不封装 list_tasks；读列表仍用 TaskStoreSync
+    - 不含 Team / teammate 的 task_list_id 分支（Phase 8 搁置）
+    - 不封装 list_tasks；读列表用 TaskListReader 或 TaskStoreSync
+    - 不发送 notify（变更通知仅 tasklist.store.TaskStore emit）
+
+公开 API（CLI）：
+    - ``TaskListReader(config, session_id)`` — 只读 Facade（list_tasks / tasks_dir）
+    - ``resolve_task_list_paths(config, session_id)`` — 路径解析
+    - ``on_tasks_updated(callback)`` — 订阅 Store 触发的进程内刷新
+
+三模式 config home（由 ``agent_home_segment`` 决定）：
+    - ``.langchain_agentx`` → ``~/.langchain_agentx/tasks/{taskListId}/``
+    - ``.cursor`` → ``~/.cursor/tasks/{taskListId}/``
+    - ``.claude`` → ``~/.claude/tasks/{taskListId}/``
 
 CLI 集成示例（禁止硬编码 tasks 路径）::
 

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/langchain_agentx/task_runtime/tasklist/reader.py

@@ -11,6 +11,7 @@ task_runtime/tasklist/reader.py — 任务列表只读 Facade（CLI 消费）
 当前裁剪范围：
     - 只读 facade；写操作仍用 TaskStoreSync 或 RuntimeTool
     - 不含 watch / debounce / UI 隐藏逻辑
+    - 不发送 notify（变更通知仅 TaskStore emit；本类只供 CLI 查询）
 
 CLI 集成示例（推荐入口，禁止硬编码 tasks 路径）::
 

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/langchain_agentx/task_runtime/tasklist/store.py

@@ -12,9 +12,12 @@ task_runtime/tasklist/store.py — 任务存储核心
 
 链路位置：
     TaskListRuntimeTool/TaskGetRuntimeTool → TaskStore → 文件系统
+    变更通知仅由本模块落盘后 emit；TaskListReader 只读查询，不发送 notify。
 
 与 CC 对应：
     CC src/utils/tasks.ts 中 TaskStore 类（863 行核心逻辑）。
+    差异：本工程单次用户操作只 notify 一次；内部 cascade/block 子步骤不重复通知
+    （CC delete 的 cascade updateTask 会多次 notify，CLI 靠 debounce 消化）。
 
 裁剪范围（v1）：
     - 文件锁保护关键操作
@@ -51,9 +54,9 @@ class TaskStore:
 
     管理任务的持久化存储，每个任务对应一个 JSON 文件。
 
-    目录结构：
-        {agent_home_segment}/tasks/{task_list_id}/{task_id}.json
-        {agent_home_segment}/tasks/{task_list_id}/.highwatermark
+    目录结构（Phase 7 config home）：
+        {config_home}/tasks/{task_list_id}/{task_id}.json
+        {config_home}/tasks/{task_list_id}/.highwatermark
     """
 
     def __init__(
@@ -226,13 +229,18 @@ class TaskStore:
         return tasks
 
     async def update_task(
-        self, task_id: str, updates: TaskUpdate
+        self,
+        task_id: str,
+        updates: TaskUpdate,
+        *,
+        notify: bool = True,
     ) -> Optional[Task]:
         """更新任务。
 
         Args:
             task_id: 任务 ID
             updates: 更新数据
+            notify: 是否在落盘成功后触发进程内通知（内部 cascade 传 False）
 
         Returns:
             更新后的任务，任务不存在时返回 None
@@ -280,7 +288,7 @@ class TaskStore:
             updated = await asyncio.to_thread(lambda: with_lock(lock, _update))
         except FileNotFoundError:
             return None
-        if updated is not None:
+        if updated is not None and notify:
             notify_tasks_updated()
         return updated
 
@@ -305,9 +313,13 @@ class TaskStore:
         lock = self._lock_manager.get_list_lock(self._tasks_dir)
 
         def _delete() -> bool:
-            # 更新高水位标记为当前删除的 ID（防止 ID 重用）
-            # 下次创建时会使用 max(hw, file_max) + 1
-            self._hw_manager._write_sync(self._tasks_dir, int(task_id))
+            # 删除前提升高水位（仅当 numericId > currentMark，对齐 CC deleteTask）
+            try:
+                numeric_id = int(task_id)
+            except ValueError:
+                numeric_id = -1
+            if numeric_id >= 0:
+                self._hw_manager.maybe_raise_mark_sync(self._tasks_dir, numeric_id)
 
             # 删除任务文件
             task_path.unlink()
@@ -390,6 +402,7 @@ class TaskStore:
                         blocks=task.blocks,
                         blocked_by=task.blocked_by,
                     ),
+                    notify=False,
                 )
 
     async def block_task(self, from_id: str, to_id: str) -> bool:
@@ -419,9 +432,10 @@ class TaskStore:
         from_task.blocks.append(to_id)
         to_task.blocked_by.append(from_id)
 
-        # 持久化
-        await self.update_task(from_id, TaskUpdate(blocks=from_task.blocks))
-        await self.update_task(to_id, TaskUpdate(blocked_by=to_task.blocked_by))
+        # 持久化（单次 block 只 notify 一次）
+        await self.update_task(from_id, TaskUpdate(blocks=from_task.blocks), notify=False)
+        await self.update_task(to_id, TaskUpdate(blocked_by=to_task.blocked_by), notify=False)
+        notify_tasks_updated()
 
         return True
 
@@ -482,7 +496,10 @@ class TaskStore:
 
             return True, None, task
 
-        return await asyncio.to_thread(lambda: with_lock(lock, _claim))
+        ok, reason, task = await asyncio.to_thread(lambda: with_lock(lock, _claim))
+        if ok:
+            notify_tasks_updated()
+        return ok, reason, task
 
 
 def with_lock(lock, func):

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/langchain_agentx/tool_runtime/policy.py

@@ -626,15 +626,20 @@ class DefaultPolicyEngine(PolicyEngine):
 
         roots = self._read_roots if is_read_only_tool else self._write_roots
         if roots:
-            if not any(self._within_root(real_path, r) for r in roots):
+            if any(self._within_root(real_path, r) for r in roots):
                 return self._with_decision_source(
-                    AuthorizationDecision(
-                        behavior="deny",
-                        message="Permission denied: path is outside the allowed workspace.",
-                        policy_id="read_roots" if is_read_only_tool else "write_roots",
-                    ),
-                    matched_rule="read_roots" if is_read_only_tool else "write_roots",
+                    AuthorizationDecision(behavior="allow"),
+                    matched_rule="roots_allow",
                 )
+            # 对齐 CC：外部路径默认 ask（而非 deny）
+            return self._with_decision_source(
+                AuthorizationDecision(
+                    behavior="ask",
+                    ask_prompt=f"Allow access to {real_path}?\n(This path is outside the allowed workspace.)",
+                    policy_id="read_roots" if is_read_only_tool else "write_roots",
+                ),
+                matched_rule="read_roots" if is_read_only_tool else "write_roots",
+            )
 
         return self._with_decision_source(
             AuthorizationDecision(behavior="allow"),

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/langchain_agentx/tool_runtime/read_permission.py

@@ -96,15 +96,25 @@ class ReadPathAuthorizer:
             )
 
         # CC step 5: write/edit allow ⇒ read allow（在 read_roots 之前）
-        # write_roots 为空表示写不限制，不得据此放宽 Read（开发模式仍靠 read_roots）
+        # 对齐 CC：无条件继承写权限的 allow/ask 决策（移除 write_roots 非空检查）
         write_decision = self._authorize_destructive_path(real_path)
-        if write_decision.behavior == "allow" and self._config.write_roots:
+        if write_decision.behavior == "allow":
             return self._with_decision_source(
                 AuthorizationDecision(
                     behavior="allow",
                     policy_id="write_implies_read",
                     message="Read allowed because write access is permitted for this path.",
-                    metadata={"implied_from": "write_roots"},
+                    metadata={"implied_from": "write_decision"},
+                ),
+                matched_rule="write_implies_read",
+            )
+        if write_decision.behavior == "ask":
+            return self._with_decision_source(
+                AuthorizationDecision(
+                    behavior="ask",
+                    ask_prompt=write_decision.ask_prompt,
+                    policy_id="write_implies_read",
+                    metadata={"implied_from": "write_decision"},
                 ),
                 matched_rule="write_implies_read",
             )

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5/langchain_agentx_python.egg-info}/PKG-INFO

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

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/langchain_agentx_python.egg-info/SOURCES.txt

@@ -287,6 +287,7 @@ langchain_agentx/task_runtime/store/__init__.py
 langchain_agentx/task_runtime/store/file_store.py
 langchain_agentx/task_runtime/store/in_memory.py
 langchain_agentx/task_runtime/tasklist/__init__.py
+langchain_agentx/task_runtime/tasklist/config_home_paths.py
 langchain_agentx/task_runtime/tasklist/high_water_mark.py
 langchain_agentx/task_runtime/tasklist/lock.py
 langchain_agentx/task_runtime/tasklist/models.py

{langchain-agentx-python-1.1.3 → langchain-agentx-python-1.1.5}/pyproject.toml

@@ -4,7 +4,7 @@
 
  [project]
  name = "langchain-agentx-python"
- version = "1.1.3"
+ version = "1.1.5"
  description = "LangChain/LangGraph-based agent utilities for CodeBaseX."
  readme = "README.md"
  requires-python = ">=3.11"

langchain-agentx-python-1.1.3/langchain_agentx/task_runtime/tasklist/path_resolver.py

@@ -1,130 +0,0 @@
-"""task_runtime/tasklist/path_resolver.py — 任务列表路径解析（CC 风格）
-
-职责：
-    解析任务存储相关路径，使用 CC 风格临时目录：
-    - 路径安全化（防止目录穿越攻击）
-    - 任务目录路径解析
-    - 单个任务文件路径解析
-    - task_list_id 多级回退逻辑
-
-链路位置：
-    TaskStore → path_resolver → ClaudeTempPaths
-
-与 CC 对应：
-    CC src/utils/task/diskOutput.ts 中 getTasksDir、getTaskPath 等。
-
-裁剪范围（v1）：
-    - 优先级：环境变量 > session_id
-    - Team 模式扩展点预留（v1 不实现）
-    - 跨平台路径分隔符处理
-    - 使用 CC 风格临时目录（/tmp/claude-{uid}/...）
-"""
-
-from __future__ import annotations
-
-import os
-import re
-from pathlib import Path
-from typing import Optional
-
-from langchain_agentx.utils import (
-    ClaudeTempPaths,
-    sanitize_path,
-    task_output_dir,
-)
-from langchain_agentx.workspace import ResolvedAgentStateConfig
-
-
-def get_tasks_dir(config: ResolvedAgentStateConfig, task_list_id: str) -> Path:
-    """获取任务存储目录路径（CC 风格）。
-
-    使用 CC 风格的临时目录结构：
-    - Linux: /tmp/claude-{uid}/{sanitized-cwd}/{task_list_id}/tasks/
-    - Windows: {TEMP}/claude/{sanitized-cwd}/{task_list_id}/tasks/
-
-    Args:
-        config: 工作区配置
-        task_list_id: 任务列表 ID（即 session_id）
-
-    Returns:
-        任务目录路径
-    """
-    # 使用 config.workspace_root 作为 cwd
-    cwd = config.workspace_root
-    # task_list_id 即 session_id
-    session_id = task_list_id
-    return task_output_dir(cwd, session_id)
-
-
-def get_task_path(
-    config: ResolvedAgentStateConfig,
-    task_list_id: str,
-    task_id: str,
-) -> Path:
-    """获取单个任务文件路径（CC 风格）。
-
-    Args:
-        config: 工作区配置
-        task_list_id: 任务列表 ID
-        task_id: 任务 ID
-
-    Returns:
-        任务文件路径，如 {tasks_dir}/{task_id}.json
-    """
-    tasks_dir = get_tasks_dir(config, task_list_id)
-    safe_id = sanitize_path_component(task_id)
-    return tasks_dir / f"{safe_id}.json"
-
-
-def sanitize_path_component(s: str) -> str:
-    """路径组件安全化。
-
-    移除或替换可能导致目录穿越攻击的字符。
-
-    对应 CC sanitizePath 函数（简化版）。
-
-    Args:
-        s: 原始字符串
-
-    Returns:
-        安全化后的字符串
-    """
-    # 移除路径分隔符和特殊字符
-    sanitized = re.sub(r'[<>:"/\\|?*\x00-\x1f]', '_', s)
-    # 移除开尾点和空格
-    sanitized = sanitized.strip('. ')
-    # 限制长度
-    if len(sanitized) > 255:
-        sanitized = sanitized[:255]
-    return sanitized or "unnamed"
-
-
-def resolve_task_list_id(
-    config: ResolvedAgentStateConfig,
-    session_id: Optional[str] = None,
-) -> str:
-    """解析任务列表 ID。
-
-    多级回退逻辑：
-    1. 环境变量 LANGCHAIN_AGENTX_TASK_LIST_ID
-    2. 传入的 session_id
-    3. 默认 "default"
-
-    Args:
-        config: 工作区配置（保留以备将来扩展）
-        session_id: 可选的会话 ID
-
-    Returns:
-        解析后的任务列表 ID
-    """
-    # 1. 环境变量优先
-    env_id = os.getenv("LANGCHAIN_AGENTX_TASK_LIST_ID")
-    if env_id:
-        return env_id
-
-    # 2. 传入的 session_id
-    if session_id:
-        return session_id
-
-    # 3. 默认值
-    return "default"