chuk-mcp-vfs

Instructions

Implementation Reference

• src/chuk_mcp_vfs/checkpoint_tools.py:78-94 (handler)

  The core handler function for the checkpoint_delete tool. It calls the CheckpointManager to delete the specified checkpoint and returns a CheckpointRestoreResponse indicating success.

  async def checkpoint_delete(self, checkpoint_id: str) -> CheckpointRestoreResponse:
      """
      Delete a checkpoint.
  
      Args:
          checkpoint_id: Checkpoint ID to delete
  
      Returns:
          Response with success status
      """
      await self.checkpoint_manager.delete_checkpoint(checkpoint_id)
  
      return CheckpointRestoreResponse(
          success=True,
          checkpoint_id=checkpoint_id,
          restored_at=datetime.now(UTC),
      )

• src/chuk_mcp_vfs/server.py:170-173 (registration)

  The registration of the checkpoint_delete tool in the MCP server using the @server.tool decorator. This thin wrapper delegates to the CheckpointTools instance method.

  @server.tool
  async def checkpoint_delete(checkpoint_id: str):
      """Delete a checkpoint."""
      return await checkpoint_tools_instance.checkpoint_delete(checkpoint_id)

• src/chuk_mcp_vfs/models.py:310-315 (schema)

  Pydantic model for the output response of the checkpoint_delete tool (reused from checkpoint restore response). Defines success status, checkpoint ID, and restore timestamp.

  class CheckpointRestoreResponse(BaseModel):
      """Response from checkpoint restore"""
  
      success: bool
      checkpoint_id: str
      restored_at: datetime