使能checkpoint能力，当前仅stm，可扩展

.gitignore

@@ -8,6 +8,7 @@ examples/**/workspace/
 workspace/
 .cursorrules
 agentscope/
+openjiuwen/
 
 # Environment variables and secrets
 .env

dare_framework/agent/react_agent.py

@@ -278,7 +278,8 @@ async def _execute_basic(
                 print(f"[{self.name}] 工具调用: {name} | id={tool_call_id or '-'} | args={params_preview}", flush=True)
 
                 try:
-                    result = await gateway.invoke(name, envelope=envelope, **params)
+                    # 关键修复：将当前 Context 传递给 ToolGateway，使工具能看到 config/workspace_dir
+                    result = await gateway.invoke(name, envelope=envelope, context=self._context, **params)
                 except Exception as exc:
                     await self._emit_transport_error(
                         transport=transport,

dare_framework/checkpoint/__init__.py

@@ -1,36 +1,22 @@
-"""Checkpoint domain facade."""
+"""checkpoint - AgentState checkpoint 门面（当前仅包含 STM）。
 
-from dare_framework.checkpoint.interfaces import (
-    ICheckpointContributor,
-    ICheckpointSaveRestore,
-    ICheckpointStore,
-)
-from dare_framework.checkpoint.types import (
-    CheckpointContext,
-    CheckpointScope,
-    ScopePresets,
-)
-from dare_framework.checkpoint.factory import create_default_save_restore
-from dare_framework.checkpoint._internal.memory_store import MemoryCheckpointStore
-from dare_framework.checkpoint._internal.save_restore import DefaultCheckpointSaveRestore
-from dare_framework.checkpoint._internal.contributors.stm_contributor import StmContributor
-from dare_framework.checkpoint._internal.contributors.workspace_git_contributor import (
-    WorkspaceGitContributor,
-)
-from dare_framework.checkpoint._internal.contributors.session_contributor import (
-    SessionStateContributor,
-    SessionContextContributor,
-)
+当前版本：
+- 定义通用 `AgentState` 抽象（目前只有 `stm` 字段）；
+- 提供可配置后端的 agent_state checkpoint 管理器（默认使用文件持久化 backend="file"）；
+
+后续可以在不破坏接口形状的前提下，为 `AgentState` 增加更多字段。
+"""
 
+from dare_framework.checkpoint.kernel import (
+    AgentState,
+    AgentStateCheckpoint,
+    AgentStateCheckpointer,
+    CheckpointId,
+)
 
 __all__ = [
-    "ICheckpointContributor",
-    "ICheckpointSaveRestore",
-    "ICheckpointStore",
-    "CheckpointContext",
-    "CheckpointScope",
-    "ScopePresets",
-    "MemoryCheckpointStore",
-    "DefaultCheckpointSaveRestore",
-    "create_default_save_restore",
+    "CheckpointId",
+    "AgentState",
+    "AgentStateCheckpoint",
+    "AgentStateCheckpointer",
 ]