"""一次 agent run 结束后执行的轻量 task 动作。

这类动作不能在工具调用当下执行：例如重命名当前 working_dir 会让本轮 executor
缓存的 cwd、system prompt 路径和宿主工具 base_dir 同时失效。工具只在这里登记
意图，由 web run worker 在 agent.run 正常结束、run_status 退出 running 后落地。

动作只活在当前进程内，不是持久任务队列。服务在 run 收尾前退出时请求自然丢失，
但不会留下 DB / FS 半更新状态；用户下次可重新发起。
"""
from __future__ import annotations

from dataclasses import dataclass


@dataclass
class DeferredTaskActions:
    """当前 run 已登记、等待 worker 收尾执行的动作。"""

    rename_working_dir_to: str = ""