D-Mail and Context Checkpoints

D-Mail and Context Checkpoints are components of the kimi-cli tool that provide a checkpoint-based time-travel system for managing conversation state in agent-driven command-line sessions. This system addresses the challenge of maintaining and manipulating conversational context, allowing agents to revert to earlier points in a session and inject new information at those moments. The primary purpose is to help the agent proactively manage its context window by condensing or revising conversation history, especially when handling irrelevant or redundant messages such as large file reads or failed operations.

The system operates through two main features: automatic context checkpoints and the D-Mail mechanism. Context checkpoints are created automatically at the start of each agent step before any interaction with a language model occurs. jsonl file, marked distinctly from regular conversation messages. The Context class manages checkpoint IDs and ensures accurate restoration from disk by scanning existing checkpoint records.

D-Mail, inspired by the concept from Steins;Gate, enables the agent to trigger a reversion to a specific checkpoint and inject new context at that point in the conversation. When the SendDMail tool is available, checkpoints can also insert visible system messages into the conversation history, making valid time-travel targets explicit for the agent. This feature allows agents to reference checkpoint IDs directly when composing D-Mail messages.

The reversion process uses a method that rewrites the conversation history file, preserving only the records up to the selected checkpoint and discarding subsequent history. It includes file rotation to prevent data loss, selective rebuilding of the conversation log, and internal state synchronization to ensure consistency. These capabilities are designed for agent session management within the kimi-cli environment, supporting workflows that require flexible control over conversational context and state.