script-build-and-framework-tmp/agent/agent/trace/__init__.py

"""
Trace module - 执行追踪与计划管理

包含：
- Trace, Goal, Message 数据模型
- TraceStore 存储接口和实现
- goal 工具（计划管理）
- Context 压缩
- REST/WebSocket API
"""

from .models import Trace, Message
from .goal_models import Goal, GoalTree, GoalStatus, GoalType, GoalStats
from .attachments import AttachmentRef
from .protocols import TraceAttachmentStore, TraceStore
from .store import FileSystemTraceStore
from .trace_id import generate_trace_id, generate_sub_trace_id, parse_parent_trace_id
from .tree_dump import StepTreeDumper, dump_json, dump_markdown, dump_tree

__all__ = [
    # Models
    "Trace",
    "Message",
    "Goal",
    "GoalTree",
    "GoalStatus",
    "GoalType",
    "GoalStats",
    # Store
    "TraceStore",
    "TraceAttachmentStore",
    "AttachmentRef",
    "FileSystemTraceStore",
    # Utils
    "generate_trace_id",
    "generate_sub_trace_id",
    "parse_parent_trace_id",
    # Debug helpers (kept for the documented compatibility import)
    "StepTreeDumper",
    "dump_tree",
    "dump_json",
    "dump_markdown",
]