Merge pull request #26 from shareAI-lab/feat/sdk-positioning-and-graceful-shutdown

refactor: simplify codebase by consolidating snapshot functionality

Author: CrazyBoyM

README.md

@@ -145,12 +145,12 @@ On crash: Resume from last safe breakpoint, auto-seal incomplete tool calls
 ### 3. Fork & Trajectory Exploration
 
 ```typescript
-// Create a checkpoint at current state
-const checkpointId = await agent.checkpoint('before-decision');
+// Create a snapshot at current state
+const snapshotId = await agent.snapshot('before-decision');
 
 // Fork to explore different paths
-const explorerA = await agent.fork(checkpointId);
-const explorerB = await agent.fork(checkpointId);
+const explorerA = await agent.fork(snapshotId);
+const explorerB = await agent.fork(snapshotId);
 
 await explorerA.chat('Try approach A');
 await explorerB.chat('Try approach B');

docs/ROADMAP.md

@@ -17,7 +17,7 @@
 | Multi-provider | Stable | Anthropic, OpenAI, Gemini, DeepSeek, Qwen, GLM... |
 | Tool System | Stable | Built-in + MCP protocol |
 | AgentPool | Stable | Up to 50 agents per process |
-| Checkpointer | Stable | Memory, File, Redis implementations |
+| Snapshot/Fork | Stable | Explore different agent trajectories |
 | Context Compression | Stable | Automatic history management |
 | Hook System | Stable | Pre/post model and tool hooks |